一、集成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的类:
自定义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编译生成基准包:
3、这个会在build/outputs/bakApk路径下生成每次编译的基准包、混淆配置文件、资源Id文件,如下图所示:
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
3、生成的补丁包在build/outputs/patch目录下:
如果你要生成不同编译环境的补丁包,只需要执行Tinker插件生成的task,比如tinkerPatchRelease就能生成release编译环境的补丁包。
补丁版本是怎么匹配到目标版本的,可以双击patch包,我们提供的插件会在tinker生成的patch包基础上插入一个MF文件:
4、上传补丁包到平台
上传补丁包到平台并下发编辑规则
点击发布新补丁,上传前面生成的patch包,我们平台会自动为你匹配到目标版本,你可以选择下发范围(开发设备、全量设备、自定义),填写完备注之后,点击立即下发让补丁生效,这样你就可以在客户端当中收到我们的策略,SDK会自动帮你把补丁包下到本地。
注:我们方案是基于Tinker方案的实现,需要下次启动才能让补丁生效。
over