腾讯bugly热更新开发

bugly 支持异常上报&＃xff0c;应用升级与热更新&＃xff1b;异常上报与应用升级使用较为简单&＃xff0c;也没有什么难点。

下面看一下热更新&＃xff0c;官网的文档说的虽然非常明白&＃xff0c;但是罗里吧嗦&＃xff0c;看的让人头大。

下面给出一个特别简单的集成与使用方式。

打开下面 bugly 给出的 GitHub 示例&＃xff0c;下面是链接&＃xff1a;

https://github.com/BuglyDevTeam/Bugly-Android-Demo

下载完毕&＃xff0c;会看到有两个 demo &＃xff0c;如下图所示&＃xff1a;

可以看到里面有两个&＃xff1a;官网推荐 BuglyHotfixDemo&＃xff1b;一键接入 BuglyHotfixEasyDemo &＃xff1b;

我们直接打开第二个&＃xff0c;也就是 BuglyHotfixEasyDemo &＃xff0c;这个 demo 是热更新一键接入示例&＃xff0c;后续也不再更新这个&＃xff1b;    

热更新sdk版本至1.3.6, tinker-support版本至1.1.5&＃xff0c;对应tinker版本 1.9.9&＃xff1b;

虽然不再更新这个&＃xff0c;但是作为普通的用户&＃xff0c;目前使用这个是完全够用的。

如果你想使用第一个 demo &＃xff0c;也建议先看第二个&＃xff0c;因为这个非常简单&＃xff0c;看完这个再看第一个会感觉并不复杂。

在接入热更新之前&＃xff0c;我们要去申请 appid 过程很简单&＃xff0c;打开官网登录 qq 账号申请即可&＃xff0c;就不说了&＃xff0c;下面是官网地址&＃xff1a;

https://bugly.qq.com/

下面就看一下如何接入&＃xff0c;我并不是按照官网来的&＃xff0c;因为官网过于复杂&＃xff1b;如果第一次使用建议新建一个 demo &＃xff0c;作为测试使用&＃xff1b;

首先在项目的 build.gradle 中添加下面代码&＃xff1a;

classpath &＃39;com.tencent.bugly:tinker-support:1.1.5&＃39;

如下图&＃xff1a;

在 app 下的 build.gradle 中添加&＃xff1a;


// 依赖插件脚本&＃xff0c;添加在最上面
apply from: &＃39;tinker-support.gradle&＃39;

和

// 远程依赖集成方式&＃xff08;推荐&＃xff09;compile "com.tencent.bugly:crashreport_upgrade:1.3.6"// 指定tinker依赖版本&＃xff08;注&＃xff1a;应用升级1.3.5版本起&＃xff0c;不再内置tinker&＃xff09;compile &＃39;com.tencent.tinker:tinker-android-lib:1.9.9&＃39;

如下图所示&＃xff1a;

和

新建 tinker-support.gradle 与 app 的 build.gradle 同级&＃xff0c;代码如下&＃xff1a;

apply plugin: &＃39;com.tencent.bugly.tinker-support&＃39;def bakPath &＃61; file("${buildDir}/bakApk/")/*** 此处填写每次构建生成的基准包目录*/
def baseApkDir &＃61; "app-1119-14-54-04"/*** 对于插件各参数的详细解析请参考*/
tinkerSupport {// 开启tinker-support插件&＃xff0c;默认值trueenable &＃61; true// 自动生成tinkerId, 你无须关注tinkerId&＃xff0c;默认为falseautoGenerateTinkerId &＃61; true// 指定归档目录&＃xff0c;默认值当前module的子目录tinkerautoBackupApkDir &＃61; "${bakPath}"// 是否启用覆盖tinkerPatch配置功能&＃xff0c;默认值false// 开启后tinkerPatch配置不生效&＃xff0c;即无需添加tinkerPatchoverrideTinkerPatchConfiguration &＃61; true//测试baseApk &＃61; "${bakPath}/${baseApkDir}/app-debug.apk"baseApkProguardMapping &＃61; "${bakPath}/${baseApkDir}/app-debug-mapping.txt"baseApkResourceMapping &＃61; "${bakPath}/${baseApkDir}/app-debug-R.txt"//正式
// baseApk &＃61; "${bakPath}/${baseApkDir}/app-release.apk"
// baseApkProguardMapping &＃61; "${bakPath}/${baseApkDir}/app-release-mapping.txt"
// baseApkResourceMapping &＃61; "${bakPath}/${baseApkDir}/app-release-R.txt"// 构建基准包跟补丁包都要修改tinkerId&＃xff0c;主要用于区分
// tinkerId &＃61; "1.0.3-ccc"// 打多渠道补丁时指定目录buildAllFlavorsDir &＃61; "${bakPath}/${baseApkDir}"// 是否使用加固模式&＃xff0c;默认为false// isProtectedApp &＃61; true// 是否采用反射Application的方式集成&＃xff0c;无须改造ApplicationenableProxyApplication &＃61; true// 支持新增ActivitysupportHotplugComponent &＃61; true}/*** 一般来说,我们无需对下面的参数做任何的修改* 对于各参数的详细介绍请参考:* https://github.com/Tencent/tinker/wiki/Tinker-%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97*/
tinkerPatch {tinkerEnable &＃61; trueignoreWarning &＃61; falseuseSign &＃61; falsedex {dexMode &＃61; "jar"pattern &＃61; ["classes*.dex"]loader &＃61; []}lib {pattern &＃61; ["lib/*/*.so"]}res {pattern &＃61; ["res/*", "r/*", "assets/*", "resources.arsc", "AndroidManifest.xml"]ignoreChange &＃61; []largeModSize &＃61; 100}packageConfig {}sevenZip {zipArtifact &＃61; "com.tencent.mm:SevenZip:1.1.10"
// path &＃61; "/usr/local/bin/7za"}buildConfig {keepDexApply &＃61; false
// tinkerId &＃61; "base-2.0.1"}
}


如下图&＃xff0c;作为参考&＃xff1a;

在 tinkerSupport { } 里面有很多参数&＃xff0c;请不要修改&＃xff0c;还有需要看一下里面每个参数的意义&＃xff1b;

这里说明几个比较重要的参数&＃xff1a;

// 自动生成tinkerId, 你无须关注tinkerId&＃xff0c;默认为falseautoGenerateTinkerId &＃61; true

参数 autoGenerateTinkerId &＃61; ture 自动生成 tinkerId&＃xff0c;无需手动填写&＃xff0c;方便了很多&＃xff0c;也是和官网推荐 BuglyHotfixDemo 的一个区别&＃xff1b;

添加这个参数也无需指定 tinkerId &＃61; "1.0.3-ccc" 这个参数&＃xff1b;

正式和测试切换&＃xff1a;

//测试baseApk &＃61; "${bakPath}/${baseApkDir}/app-debug.apk"baseApkProguardMapping &＃61; "${bakPath}/${baseApkDir}/app-debug-mapping.txt"baseApkResourceMapping &＃61; "${bakPath}/${baseApkDir}/app-debug-R.txt"//正式
// baseApk &＃61; "${bakPath}/${baseApkDir}/app-release.apk"
// baseApkProguardMapping &＃61; "${bakPath}/${baseApkDir}/app-release-mapping.txt"
// baseApkResourceMapping &＃61; "${bakPath}/${baseApkDir}/app-release-R.txt"

测试使用 debug &＃xff0c;正式使用 release&＃xff1b;

参数 buildAllFlavorsDir&＃xff0c;配置多渠道打包请打开&＃xff0c;不需要请注释&＃xff0c;最下面要配置多渠道打包&＃xff0c;所有我就打开了&＃xff1b;

// 打多渠道补丁时指定目录buildAllFlavorsDir &＃61; "${bakPath}/${baseApkDir}"

参数 isProtectedApp &＃61; true&＃xff1b;测试千万不要开启&＃xff0c;会引发不必要的 bug &＃xff0c;当应用需要加固时再开启&＃xff1b;

// 是否使用加固模式&＃xff0c;默认为false// isProtectedApp &＃61; true

参数 enableProxyApplication &＃61; true&＃xff0c;无需改造 Application&＃xff1b;

// 是否采用反射Application的方式集成&＃xff0c;无须改造ApplicationenableProxyApplication &＃61; true

新建 MyApplication 加入下面代码&＃xff1a;

public class MyApplication extends Application {&＃64;Overridepublic void onCreate() {super.onCreate();setStrictMode();// 设置是否开启热更新能力&＃xff0c;默认为trueBeta.enableHotfix &＃61; true;// 设置是否自动下载补丁Beta.canAutoDownloadPatch &＃61; true;// 设置是否提示用户重启Beta.canNotifyUserRestart &＃61; false;// 设置是否自动合成补丁Beta.canAutoPatch &＃61; true;/*** 补丁回调接口&＃xff0c;可以监听补丁接收、下载、合成的回调*/Beta.betaPatchListener &＃61; new BetaPatchListener() {&＃64;Overridepublic void onPatchReceived(String patchFileUrl) {//补丁包下载地址为patchFileUrl}&＃64;Overridepublic void onDownloadReceived(long savedLength, long totalLength) {//热修复回调成功}&＃64;Overridepublic void onDownloadSuccess(String patchFilePath) {//热修复下载成功}&＃64;Overridepublic void onDownloadFailure(String msg) {//热修复下载失败}&＃64;Overridepublic void onApplySuccess(String msg) {//补丁包应用成功}&＃64;Overridepublic void onApplyFailure(String msg) {//补丁包应用失败}&＃64;Overridepublic void onPatchRollback() {//补丁回滚}};long start &＃61; System.currentTimeMillis();Bugly.setUserId(this, "falue");Bugly.setUserTag(this, 123456);Bugly.putUserData(this, "key1", "123");Bugly.setAppChannel(this, "bugly");// 这里实现SDK初始化&＃xff0c;appId替换成你的在Bugly平台申请的appId,调试时将第三个参数设置为trueBugly.init(this, "4bf2a8d8eb", true);long end &＃61; System.currentTimeMillis();Log.e("init time--->", end - start &＃43; "ms");
}&＃64;Overrideprotected void attachBaseContext(Context base) {super.attachBaseContext(base);// 热更新必须添加MultiDex.install(base);// 安装tinkerBeta.installTinker();}&＃64;TargetApi(9)protected void setStrictMode() {StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder().permitAll().build());StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder().detectAll().penaltyLog().build());}
}


别忘记在 AndroidManifest.xml 中使用&＃xff1a;

需要注意的是&＃xff0c;下面的代码中要换成你申请的 appId&＃xff1a;

// 这里实现SDK初始化&＃xff0c;appId替换成你的在Bugly平台申请的appId,调试时将第三个参数设置为trueBugly.init(this, "4bf2a8d8eb", true);

AndroidManifest.xml 文件中添加下面代码&＃xff1a;

参考下图&＃xff1a;

加入权限&＃xff1a;

在 xml 中的 provider_paths 加入代码&＃xff0c;没有请创建&＃xff1a;

参考下图&＃xff1a;

MainActivity 中加入代码&＃xff1a;

public class MainActivity extends AppCompatActivity {private Button button; &＃64;Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);button &＃61; (Button) findViewById(R.id.button);button.setOnClickListener(new View.OnClickListener() {&＃64;Overridepublic void onClick(View v) {Toast.makeText(MainActivity.this, "这是存在bug的", Toast.LENGTH_SHORT).show();}});}
}

里面只有一个 button &＃xff1b;

最后加入混淆&＃xff1a;

# Bugly混淆规则
-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}
# tinker
-dontwarn com.tencent.tinker.**
-keep class com.tencent.tinker.** { *; }


参考下图&＃xff1a;

多渠道打包配置&＃xff0c;暂时配置三个&＃xff1a;

productFlavors {huawei {// applicationId "com.tencent.bugly.hotfix.huawei"manifestPlaceholders &＃61; [CHANNEL_VALUE: "huawei"]}qihu360 {
// applicationId "com.tencent.bugly.hotfix.qihu360"manifestPlaceholders &＃61; [CHANNEL_VALUE: "qihu360"]}oppo {
// applicationId "com.tencent.bugly.hotfix.oppo"manifestPlaceholders &＃61; [CHANNEL_VALUE: "oppo"]}}

作为参考我给出我的 build.gradle 所有代码&＃xff1a;

apply plugin: &＃39;com.android.application&＃39;// 依赖插件脚本
apply from: &＃39;tinker-support.gradle&＃39;android {compileSdkVersion 26buildToolsVersion &＃39;26.0.2&＃39;defaultConfig {applicationId "com.tencent.bugly.hotfix.easy"minSdkVersion 14targetSdkVersion 26versionCode 3versionName "1.0"flavorDimensions "versionCode"// 开启multidexmultiDexEnabled true}// 签名配置signingConfigs {release {try {storeFile file("./keystore/release.keystore")storePassword "testres"keyAlias "testres"keyPassword "testres"} catch (ex) {throw new InvalidUserDataException(ex.toString())}}debug {storeFile file("./keystore/debug.keystore")}}buildTypes {release {minifyEnabled truesigningConfig signingConfigs.releaseproguardFiles getDefaultProguardFile(&＃39;proguard-android.txt&＃39;), &＃39;proguard-rules.pro&＃39;}debug {debuggable trueminifyEnabled false// signingConfig signingConfigs.debug}}sourceSets {main {jniLibs.srcDirs &＃61; [&＃39;libs&＃39;]}}repositories {flatDir {dirs &＃39;libs&＃39;}}// productFlavors 示例//flavorDimensions "tier"productFlavors {huawei {// applicationId "com.tencent.bugly.hotfix.huawei"manifestPlaceholders &＃61; [CHANNEL_VALUE: "huawei"]}qihu360 {
// applicationId "com.tencent.bugly.hotfix.qihu360"manifestPlaceholders &＃61; [CHANNEL_VALUE: "qihu360"]}oppo {
// applicationId "com.tencent.bugly.hotfix.oppo"manifestPlaceholders &＃61; [CHANNEL_VALUE: "oppo"]}}lintOptions {checkReleaseBuilds falseabortOnError false}
}dependencies {compile fileTree(dir: &＃39;libs&＃39;, include: [&＃39;*.jar&＃39;])compile &＃39;com.android.support:appcompat-v7:26.1.0&＃39;// 多dex配置compile "com.android.support:multidex:1.0.2"// 本地集成aar方式// compile(name: &＃39;bugly_crashreport_upgrade-1.3.6&＃39;, ext: &＃39;aar&＃39;)// 远程依赖集成方式&＃xff08;推荐&＃xff09;compile "com.tencent.bugly:crashreport_upgrade:1.3.6"// 指定tinker依赖版本&＃xff08;注&＃xff1a;应用升级1.3.5版本起&＃xff0c;不再内置tinker&＃xff09;compile &＃39;com.tencent.tinker:tinker-android-lib:1.9.9&＃39;}

上面的签名配置是我从 BuglyHotfixEasyDemo 中直接复制过来的&＃xff1b;

所有配置完毕&＃xff0c;下面就测试打包&＃xff0c;点击右侧 Gradle &＃61;&＃61;> app &＃61;&＃61;> Tasks &＃61;&＃61;> build &＃61;&＃61;>assembleDebug &＃xff0c;如下图&＃xff1a;

打包完毕&＃xff0c;在左侧 app &＃61;&＃61;> bakApk 可以看到躺着三个包&＃xff0c;这就是基准包&＃xff0c;如下图&＃xff1a;

需要注意的是&＃xff1a;一般在正式的情况下&＃xff0c;需要将 bakApk 文件夹里面的内容保存到本地&＃xff0c;方便以后打补丁包使用&＃xff0c;如果不存在了&＃xff0c;直接复制到 bakApk 文件夹下面就可以了。

记住上面的 app-1126-16-12-58&＃xff0c;也就是 bakApk &＃61;&＃61;> app-1126-16-12-58 &＃xff0c;这个是随机生成的&＃xff0c;下面会使用到这个&＃xff1b;

打开 tinker-support.gradle&＃xff0c;找到 baseApkDir 参数&＃xff0c;将里面的内容替换为 app-1126-16-12-58 &＃xff1b;如下图&＃xff1a;

需要注意的是&＃xff1a;你生成的是什么就写什么&＃xff0c;这个是每打一次基准包&＃xff0c;需要填写一次&＃xff0c;打补丁包不需要改变&＃xff1b;

一定要保证该目录下面有对应的包&＃xff0c;这也就是上面为什么让你把基准包保存到本地的原因&＃xff0c;以防丢失&＃xff1b;

为了方便测试&＃xff0c;将 MainActivity 中的提示改为下面&＃xff1a;

Toast.makeText(MainActivity.this, "修复了bug&＃xff0c;以便测试", Toast.LENGTH_SHORT).show();

点击右侧 Gradle &＃61;&＃61;> app &＃61;&＃61;> Tasks &＃61;&＃61;> tinker-support &＃61;&＃61;>buildAllFlavorsTinkerPatchDebug &＃xff0c;如下图&＃xff1a;

等待过后&＃xff0c;补丁包就打完了&＃xff0c;在左侧 app &＃61;&＃61;> outputs &＃61;&＃61;> patch 中可以看到三个补丁包&＃xff0c;如下图&＃xff1a;

上面以 7-zip 结尾就是我们的补丁包了&＃xff0c;也就是 patch_signed_7zip.apk  &＃xff0c;也就是把这个包放到 bugly 官网就可以了&＃xff1b;

下面就可以测试了&＃xff0c;测试的时候需要注意&＃xff1a;一定先将基本包安装到手机上&＃xff0c;保证有网络的情况下打开 app &＃xff0c;让热更新代码走完补丁包才可以上传到 bugly 官网&＃xff0c;否则上传不上去&＃xff1b;

下面将基本包放到手机上面运行&＃xff0c;因为打了三个包&＃xff0c;就拿华为的包测试&＃xff1b;

安装完毕&＃xff0c;点击按钮可以发现&＃xff0c;提示&＃xff1a;这是存在bug的&＃xff1b;与基本包一致&＃xff0c;emmm&＃xff1b;

打开 bugly 官网&＃xff0c;将补丁包上传到官网&＃xff0c;点击应用升级&＃61;&＃61;>热更新&＃61;&＃61;>发布新补丁&＃xff0c;如下图所示&＃xff1a;

不要上传错了&＃xff0c;我们测试的是华为的基本包&＃xff0c;所以补丁包也应该上传华为下面的 patch_signed_7zip.apk &＃xff1b;

上传如果提示&＃xff0c;改包不合法&＃xff0c;那么刷新页面再试一下&＃xff0c;或者重新打开基本包的 app &＃xff1b;因为我也遇到过&＃xff0c;是 bugly 后台的问题&＃xff1b;

上传完毕&＃xff0c;会自动识别版本&＃xff0c;选择全量更新&＃xff0c;写上备注&＃xff0c;然后点击立即下发就可以了&＃xff0c;如下图&＃xff1a;

稍等片刻&＃xff0c;就可以出现了&＃xff0c;如下图&＃xff1a;

我上面有两个&＃xff0c;因为我已经测试过一次了&＃xff0c;如果你们第一次测试&＃xff0c;应该是一个。

热更新官网说是重启 app 就可以修复了&＃xff0c;经过我测试&＃xff0c;大概需要5分钟的时间&＃xff0c;补丁才会生效&＃xff0c;所以不必着急&＃xff1b;

经过几分钟的重启 app &＃xff0c;点击按钮测试&＃xff0c;发现提示语变成了&＃xff1a;修复了bug&＃xff0c;以便测试&＃xff1b;

说明补丁包应用成功了&＃xff0c;打开 bugly 官网&＃xff0c;刷新页面&＃xff0c;可以看到已经下发了一个了&＃xff0c;如下图所示&＃xff1a;

可以看到激活的数量为0&＃xff0c;但我们已经应用成功了&＃xff0c;因为有延迟&＃xff0c;所以再过大概10分钟就可以看到激活量为1了&＃xff0c;所以不用着急&＃xff1b;

看完这个简单集成方式以后&＃xff0c;再看 BuglyHotfixDemo 或者官网文档就会感觉简单多了。

如果你有什么问题&＃xff0c;可以看下面我写的 demo &＃xff0c;或者留言&＃xff1b;

https://github.com/wuqingsen/BuglyDemo

到这里就结束了。

记录一个bug&＃xff0c;测试上没问题&＃xff0c;但是我在正式上面先发成功&＃xff0c;但是激活数量一直为0&＃xff0c;如下图所示&＃xff1a;

解决方法&＃xff0c;在项目的 bulid.gradle 中的配置改为&＃xff1a;

classpath "com.tencent.bugly:tinker-support:latest.release"

就好了&＃xff0c;我之前用的是&＃xff1a;

// classpath &＃39;com.tencent.bugly:tinker-support:1.1.5&＃39; //之前配置classpath "com.tencent.bugly:tinker-support:latest.release" //修改后

做一下记录。