Bugly热修复

一、集成Bugly热修复

第一步:添加插件依赖
工程根目录下“build.gradle”文件中添加:

buildscript {
repositories {
    jcenter()
}
dependencies {
    // tinkersupport插件,其中latest.release指代最新版本号,也可以指定明确的版本号,例如1.0.3
    classpath "com.tencent.bugly:tinker-support:latest.release"
  }
}

注意:当前我们版本需要你指定tinker插件版本为1.7.6,避免因为插件版本的变更导致补丁包的生成的问题。 自SDK 1.2.2版本起无需再配tinker插件的classpath。

第二步:集成SDK
(1)gradle配置
在app module的“build.gradle”文件中添加(示例配置):

   dependencies {
   compile "com.android.support:multidex:1.0.1" // 多dex配置
   compile 'com.tencent.bugly:crashreport_upgrade:latest.release'//其中latest.release指代最新版本号,也可以指定明确的版本号,例如1.2.1
  }

(2) 在app module的“build.gradle”文件中添加:

// 依赖插件脚本
apply from: 'tinker-support.gradle'

(3) 在build.gradle同级目录下创建tinker-support.gradle这个文件

apply plugin: 'com.tencent.bugly.tinker-support'

def bakPath = file("${buildDir}/bakApk/")

def appName = "app-0111-15-18-41"

/**
 * 对于插件各参数的详细解析请参考
 */
tinkerSupport {

// 开启tinker-support插件,默认值true
enable = true

// 指定归档目录,默认值当前module的子目录tinker
autoBackupApkDir = "${bakPath}"

// 是否启用覆盖tinkerPatch配置功能,默认值false
// 开启后tinkerPatch配置不生效,即无需添加tinkerPatch
overrideTinkerPatchConfiguration = true

// 编译补丁包时,必需指定基线版本的apk,默认值为空
// 如果为空,则表示不是进行补丁包的编译
// @{link tinkerPatch.oldApk }
baseApk =  "${bakPath}/${appName}/app-release.apk"

// 对应tinker插件applyMapping
baseApkProguardMapping = "${bakPath}/${appName}/app-release-mapping.txt"

// 对应tinker插件applyResourceMapping
baseApkResourceMapping = "${bakPath}/${appName}/app-release-R.txt"

// 唯一标识当前版本
tinkerId = "1.0.1-base"

// 是否开启代理Application,设置之后无须改造Application,默认为false
enableProxyApplication = false
}

更详细的配置项参考tinker-support配置说明

第三步:初始化SDK

(1) enableProxyApplication = false 的情况-----这是Tinker推荐的接入方式,一定程度上会增加接入成本,但具有更好的兼容性。

自定义Application

public class SampleApplication extends TinkerApplication {
public SampleApplication() {
    super(ShareConstants.TINKER_ENABLE_ALL, "xxx.xxx.SampleApplicationLike",
            "com.tencent.tinker.loader.TinkerLoader", false);
}
}

注意:这个类集成TinkerApplication类,这里面不做任何操作,所有Application的代码都会放到ApplicationLike继承类当中
参数解析
参数1:tinkerFlags 表示Tinker支持的类型 dex only、library only or all suuport,default: TINKER_ENABLE_ALL
参数2:delegateClassName Application代理类 这里填写你自定义的ApplicationLike
参数3:loaderClassName Tinker的加载器,使用默认即可
参数4:tinkerLoadVerifyFlag 加载dex或者lib是否验证md5,默认为false

我们需要您将以前的Applicaton配置为继承TinkerApplication的类:


HJAUYW3N`4P`AOH}IQ3DOGT.png

自定义ApplicationLike------appId替换成你的在Bugly平台申请的appId

public class SampleApplicationLike extends DefaultApplicationLike {

public static final String TAG = "Tinker.SampleApplicationLike";

public SampleApplicationLike(Application application, int tinkerFlags,
        boolean tinkerLoadVerifyFlag, long applicationStartElapsedTime,
        long applicationStartMillisTime, Intent tinkerResultIntent, Resources[] resources,
        ClassLoader[] classLoader, AssetManager[] assetManager) {
    super(application, tinkerFlags, tinkerLoadVerifyFlag, applicationStartElapsedTime,
            applicationStartMillisTime, tinkerResultIntent, resources, classLoader,
            assetManager);
}


@Override
public void onCreate() {
    super.onCreate();
    // 这里实现SDK初始化,appId替换成你的在Bugly平台申请的appId
    Bugly.init(getApplication(), "900029763", true);
}


@TargetApi(Build.VERSION_CODES.ICE_CREAM_SANDWICH)
@Override
public void onBaseContextAttached(Context base) {
    super.onBaseContextAttached(base);
    // you must install multiDex whatever tinker is installed!
    MultiDex.install(base);

    // 安装tinker
    // TinkerManager.installTinker(this); 替换成下面Bugly提供的方法
    Beta.installTinker(this);
}

@TargetApi(Build.VERSION_CODES.ICE_CREAM_SANDWICH)
public void registerActivityLifecycleCallback(Application.ActivityLifecycleCallbacks callbacks) {
    getApplication().registerActivityLifecycleCallbacks(callbacks);
}

}

注意:tinker需要你开启MultiDex,你需要在dependencies中进行配置compile "com.android.support:multidex:1.0.1"才可以使用MultiDex.install方法; SampleApplicationLike这个类是Application的代理类,以前所有在Application的实现必须要全部拷贝到这里,在onCreate方法调用SDK的初始化方法,在onBaseContextAttached中调用Beta.installTinker(this);。

第四步:AndroidManifest.xml配置

(1) 权限配置

    
    
    
    
    
    
    

二、测试

第一步:编译基准包
1、配置基准包的tinkerId

![W7I)VI82DMBLO1HM_5YUV]5.png](http://upload-images.jianshu.io/upload_images/2129339-98f238f704b834f7.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
tinkerId最好是一个唯一标识,例如git版本号、versionName等等。 如果你要测试热更新,你需要对基线版本进行联网上报。

强调:基线版本配置一个唯一的tinkerId,而这个基线版本能够应用补丁的前提是集成过热更新SDK,
并启动上报过联网,这样我们后台会将这个tinkerId对应到一个目标版本,
例如tinkerId = "bugly_1.0.0" 对应了一个目标版本是1.0.0,基于这个版本打的补丁包就能匹配到目标版本。

2、执行assembleRelease编译生成基准包:

Bugly热修复_第1张图片
0B1`9}TUTZ)U9CN2DYH$LDK.png

3、这个会在build/outputs/bakApk路径下生成每次编译的基准包、混淆配置文件、资源Id文件,如下图所示:

Bugly热修复_第2张图片
12.png

4、上传基线包到bug平台

应用升级---全量更新---发布新升级中上传基准包

![JFNZH]@$X([email protected]](http://upload-images.jianshu.io/upload_images/2129339-703a9f784479180e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

第二步:修复bug
第三步:根据基线版本生成补丁包
1、修改待修复apk路径、mapping文件路径、resId文件路径

![XVKXDL]ZXL8$~6)N)7V0KJT.png](http://upload-images.jianshu.io/upload_images/2129339-cb8752a9958bb9ae.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
2、执行构建补丁包的task

Bugly热修复_第3张图片
11.png

3、生成的补丁包在build/outputs/patch目录下:

Bugly热修复_第4张图片
`_Z7L9GF@8)RV%QEX}WDL}7.png

如果你要生成不同编译环境的补丁包,只需要执行Tinker插件生成的task,比如tinkerPatchRelease就能生成release编译环境的补丁包。

补丁版本是怎么匹配到目标版本的,可以双击patch包,我们提供的插件会在tinker生成的patch包基础上插入一个MF文件:

Bugly热修复_第5张图片
123.png

4、上传补丁包到平台
上传补丁包到平台并下发编辑规则

Bugly热修复_第6张图片
![1479199723899.png](http://upload-images.jianshu.io/upload_images/2129339-b958546c6eb1bd99.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

点击发布新补丁,上传前面生成的patch包,我们平台会自动为你匹配到目标版本,你可以选择下发范围(开发设备、全量设备、自定义),填写完备注之后,点击立即下发让补丁生效,这样你就可以在客户端当中收到我们的策略,SDK会自动帮你把补丁包下到本地。

注:我们方案是基于Tinker方案的实现,需要下次启动才能让补丁生效。

over

你可能感兴趣的:(Bugly热修复)