Android热修复应用篇--关于腾讯Bugly的使用

红太狼 2022-09-26 15:57 566阅读 0赞

上篇介绍了 [Android 热修复原理篇及几大方案比较][Android]** 介绍了热修复功能和几个比较火的库,本篇介绍Bugly(目前采用微信**[Tinker][]**的开源方案)的集成及使用方法.**

bugly兼有异常采集上报,全量更新及热更新功能,本文主要关注其热更新模块;话不多说两横一竖直接开干.

首先注册登录bugly平台账号，然后就可以注册新的app，填写相应的信息，就可以得到相应的APP\_ID。这点相信大家很有经验,不用多说.

## 第一步：添加插件依赖 ##

工程根目录下“build.gradle”文件中添加：注意是根目录下,即最外层的build.gradle下!

buildscript {
        repositories {
            jcenter()
        }
        dependencies {
            // tinkersupport插件, 其中lastest.release指拉取最新版本，也可以指定明确版本号，例如1.0.4
            classpath "com.tencent.bugly:tinker-support:latest.release"
        }
    }注意：自tinkersupport 1.0.3版本起无需再配tinker插件的classpath。

**第二步：集成SDK**

gradle配置

在app module的“build.gradle”文件中添加（示例配置）：

dependencies {
    
              compile "com.android.support:multidex:1.0.1" // 多dex配置
              compile 'com.tencent.bugly:crashreport_upgrade:latest.release' // 升级SDK
    }

在app module的“build.gradle”文件中添加：

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

![Image 1][]

tinker-support.gradle内容如下所示（示例配置）：

> 注：您需要在**同级目录下**创建tinker-support.gradle这个文件哦。

apply plugin: 'com.tencent.bugly.tinker-support'
    
    def bakPath = file("${buildDir}/bakApk/")
    
    /** * 此处填写每次构建生成的基准包目录 */
    def baseApkDir = "app-0208-15-10-00"
    
    /** * 对于插件各参数的详细解析请参考 */
    tinkerSupport {
    
        // 开启tinker-support插件，默认值true
        enable = true
    
        // 指定归档目录，默认值当前module的子目录tinker
        autoBackupApkDir = "${bakPath}"
    
        // 是否启用覆盖tinkerPatch配置功能，默认值false
        // 开启后tinkerPatch配置不生效，即无需添加tinkerPatch
        overrideTinkerPatchConfiguration = true
    
        // 编译补丁包时，必需指定基线版本的apk，默认值为空
        // 如果为空，则表示不是进行补丁包的编译
        // @{link tinkerPatch.oldApk }
        baseApk = "${bakPath}/${baseApkDir}/app-release.apk"
    
        // 对应tinker插件applyMapping
        baseApkProguardMapping = "${bakPath}/${baseApkDir}/app-release-mapping.txt"
    
        // 对应tinker插件applyResourceMapping
        baseApkResourceMapping = "${bakPath}/${baseApkDir}/app-release-R.txt"
    
        // 构建基准包和补丁包都要指定不同的tinkerId，并且必须保证唯一性
        tinkerId = "base-1.0.1"
    
        // 构建多渠道补丁时使用
        // buildAllFlavorsDir = "${bakPath}/${baseApkDir}"
    
        // 是否开启反射Application模式
        enableProxyApplication = false
    
    }
    
    /** * 一般来说,我们无需对下面的参数做任何的修改 * 对于各参数的详细介绍请参考: * https://github.com/Tencent/tinker/wiki/Tinker-%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97 */
    tinkerPatch {
        //oldApk ="${bakPath}/${appName}/app-release.apk"
        ignoreWarning = false
        useSign = true
        dex {
            dexMode = "jar"
            pattern = ["classes*.dex"]
            loader = []
        }
        lib {
            pattern = ["lib/*/*.so"]
        }
    
        res {
            pattern = ["res/*", "r/*", "assets/*", "resources.arsc", "AndroidManifest.xml"]
            ignoreChange = []
            largeModSize = 100
        }
    
        packageConfig {
        }
        sevenZip {
            zipArtifact = "com.tencent.mm:SevenZip:1.1.10"
    //        path = "/usr/local/bin/7za"
        }
        buildConfig {
            keepDexApply = false
            //tinkerId = "1.0.1-base"
            //applyMapping = "${bakPath}/${appName}/app-release-mapping.txt" //  可选，设置mapping文件，建议保持旧apk的proguard混淆方式
            //applyResourceMapping = "${bakPath}/${appName}/app-release-R.txt" // 可选，设置R.txt文件，通过旧apk文件保持ResId的分配
        }
    }

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

## 第三步：初始化SDK ##

### enableProxyApplication = false 的情况 ###

> 这是Tinker推荐的接入方式，一定程度上会增加接入成本，但具有更好的兼容性。

集成Bugly升级SDK之后，我们需要按照以下方式自定义ApplicationLike来实现Application的代码（以下是示例）：

自定义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的类：

![配置基准包的tinkerId][tinkerId]

自定义ApplicationLike

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) {
            super(application, tinkerFlags, tinkerLoadVerifyFlag, applicationStartElapsedTime, applicationStartMillisTime, tinkerResultIntent);
        }
    
    
        @Override
        public void onCreate() {
            super.onCreate();
            // 这里实现SDK初始化，appId替换成你的在Bugly平台申请的appId
            // 调试时，将第三个参数改为true
            Bugly.init(getApplication(), "900029763", false);
        }
    
    
        @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);`。

###  ###

--------------------

### enableProxyApplication = true 的情况    ###

public class MyApplication extends Application {
    
        @Override
        public void onCreate() {
            super.onCreate();
            // 这里实现SDK初始化，appId替换成你的在Bugly平台申请的appId
            // 调试时，将第三个参数改为true
            Bugly.init(this, "900029763", false);
        }
    
        @Override
        protected void attachBaseContext(Context base) {
            super.attachBaseContext(base);
            // you must install multiDex whatever tinker is installed!
            MultiDex.install(base);
    
    
            // 安装tinker
            Beta.installTinker();
        }
    
    }

> 注：无须你改造Application，主要是为了降低接入成本，我们插件会动态替换AndroidMinifest文件中的Application为我们定义好用于反射真实Application的类（需要您接入SDK 1.2.2版本 和 插件版本 1.0.3以上）。

## 第四步：AndroidManifest.xml配置 ##

1. 权限配置

<uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.READ_LOGS" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

注意：如果你也想使用升级功能，你必须要进行2、3项的配置，而如果你只想使用热更新能力，你只需要配置权限即可。

2. Activity配置

3. 配置FileProvider

注意：如果您想兼容Android N或者以上的设备，必须要在AndroidManifest.xml文件中配置FileProvider来访问共享路径的文件。如果你使用的第三方库也配置了同样的FileProvider，你需要将第三方库配置的路径copy到我们配置的provider\_path文件下。

$\{applicationId\}请替换为您的包名，例如com.bugly.upgrade.demo。这里要注意一下，FileProvider类是在support-v4包中的，检查你的工程是否引入该类库。

在res目录新建xml文件夹，创建provider\_paths.xml文件如下：

<?xml version="1.0" encoding="utf-8"?>
    <paths xmlns:android="http://schemas.android.com/apk/res/android">
        
        <external-path name="beta_external_path" path="Download/"/>
        
        <external-path name="beta_external_files_path" path="Android/data/"/>
    </paths>

这里配置的两个外部存储路径是升级SDK下载的文件可能存在的路径，一定要按照上面格式配置，不然可能会出现错误。

## 第五步：混淆配置 ##

为了避免混淆SDK，在Proguard混淆文件中增加以下配置：

-dontwarn com.tencent.bugly.**
    -keep public class com.tencent.bugly.**{*;}

如果你使用了support-v4包，你还需要配置以下混淆规则：

-keep class android.support.**{*;}

--------------------

#### 查看Bugly的Logcat日志 ####

> 开启Bugly的Logcat日志需要在初始化时，isDebug参数设为true。
> 
> TAG为**CrashReportInfo**，是Bugly主要操作日志，包括初始化、日志上报信息；
> 
> TAG为**CrashReport**，是Bugly调试日志，若Bugly使用中有问题，可以将该日志信息反馈给客服人员。
> 
> ![Image 1][]

--------------------

# 到此bugly热更新配置已完成,下面来进行具体用法 #

## 完整接入流程 ##

*  打基准包安装并上报联网（注：填写唯一的tinkerId）
 *  对基准包的bug修复（可以是Java代码变更，资源的变更）
 *  修改基准包路径、填写补丁包tinkerId、mapping文件路径、resId文件路径
 *  执行tinkerPatchRelease打Release版本补丁包
 *  选择app/build/outputs/patch目录下的补丁包并上传（注：不要选择tinkerPatch目录下的补丁包，不然上传会有问题）
 *  编辑下发补丁规则，点击立即下发
 *  重启基准包，请求补丁策略（SDK会自动下载补丁并合成）
 *  再次重启基准包，检验补丁应用结果
 *  查看页面，查看激活数据的变化

## 普通打包 ##

### 1、编译基准包 ###

配置基准包的tinkerId

![配置基准包的tinkerId][tinkerId 1]

tinkerId最好是一个唯一标识，例如git版本号、versionName等等。 如果你要测试热更新，你需要对基线版本进行联网上报。

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

执行`assembleRelease`编译生成基准包：

![编译基准包][Snip20170113_4.png_v_20170303160536]

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

![生成的基线版本][Snip20170209_2.png_v_20170303160536]

> 实际应用中，请注意保存线上发布版本的基准apk包、mapping文件、R.txt文件，如果线上版本有bug，就可以借助我们tinker-support插件进行补丁包的生成。

启动apk，上报联网数据

我们每次冷启动都会请求补丁策略，会上报当前版本号和tinkerId，这样我们后台就能将这个唯一的tinkerId对应到一个版本，大家测试的时候可以打开logcat查看我们的日志，如下图所示：

![上报联网数据][Snip20161213_28.png_v_20170303160536]

### 2、对基线版本的bug修复 ###

未修复前

![未修复前][Snip20170113_7.png_v_20170303160536]

这个类有一个会造成空指针的方法。

修复后

![修复后][Snip20170113_8.png_v_20170303160536]

对产生bug的类进行修复，作为补丁下次覆盖基线版本的类。

### 3、根据基线版本生成补丁包 ###

修改待修复apk路径、mapping文件路径、resId文件路径

![配置apk路径、mapping文件路径、resId文件路径][apk_mapping_resId]

执行构建补丁包的task

![执行构建补丁包的task][task]

如果你要生成不同编译环境的补丁包，只需要执行TinkerSupport插件生成的task，比如`buildTinkerPatchRelease`就能生成release编译环境的补丁包。 注：TinkerSupport插件版本低于1.0.4的，需要使用tinkerPatchRelease来生成补丁包 。

生成的补丁包在build/outputs/patch目录下：

![build/outputs/patch][build_outputs_patch]

大家这里可能会有一个疑问，补丁版本是怎么匹配到目标版本的，可以双击patch包，我们提供的插件会在tinker生成的patch包基础上插入一个MF文件：

![tinker-support插件日志][tinker-support 1]

![Yapatch.MF文件][Yapatch.MF]

### 4、上传补丁包到平台 ###

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

![点击发布新补丁][1479199765798.png_v_20170303160536]

![选择文件][1479199723899.png_v_20170303160536]

![编辑规则][Snip20170209_6.png_v_20170303160536]

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

**如何定义开发设备**:接口`Bugly.setIsDevelopmentDevice(getApplicationContext(), true);`，后台就会将你当前设备识别为开发设备，如果设置为false则非开发设备，会根据这个配置进行策略控制。

### 5、测试补丁应用效果 ###

启动app应用patch

![启动app应用patch][app_patch]

如果匹配到目标版本，后台就会下发补丁策略，可以在logcat看到如下日志：(**以CrashReport,info级别过滤**)

![补丁策略下发][Snip20161213_27.png_v_20170303160536]

下载成功之后，我们会立即去合成补丁，可以看到patch合成的日志：

![patch合成日志][patch]

重启app查看效果

![重启app查看效果][app]

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

每次发版都要保留基准包、混淆配置文件、资源Id文件

--------------------

**tinker的一般模式需要Dex的合成，它并不支持加固，一定要使用加固的app可以使用usePreGeneratedPatchDex模式。由于加固会改变apk的dex结构，所以生成补丁包时我们务必要使用加固前的apk。 但是需要注意的是，某些加固工具会将非exported的四大组件的类名替换，对于这部分类即使使用usePreGeneratedPatchDex也无法修改。对于360加固，MainActivity由于被提前加载，也无法修复。大家对于加固的情况，请仔细测试，能否支持与加固的方式有关联。**

**注:热修补技术本待完善中,在实际工程可能会有额外问题出现,比如支持四大组件的代理；直接解压没有修改的Dex时，需要计算是否会被Android N的内联规则可能影响等.请尽量规避这些方面再使用.**

--------------------

<table style="margin:0.667rem 0px; border-collapse:collapse; border:1px solid rgb(187,187,187); color:rgb(0,0,0); font-family:Helvetica,&quot;Hiragino Sans GB&quot;,&quot;Microsoft Yahei&quot;,SimSun,SimHei,arial,sans-serif; font-size:15px; line-height:24px"> 
 <tbody> 
  <tr> 
   <td style="border-collapse:collapse; border:1px solid rgb(187,187,187); word-break:break-all"> <h1 style="margin:1.33rem 0px 0.667rem; padding:0px; font-size:1.4rem">附加:若有多渠道打包或者加固打包需求参考如下,普通打包不必参考:</h1> <h2 style="margin:0px; padding:20px 0px 0px; font-size:20px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 多渠道打包</h2> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> tinker是支持我们打多渠道的，建议大家按照以下步骤进行最佳实践：</p> <h3 style="margin:0px; padding:20px 0px 0px; font-size:18px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 1. 配置productFlavors</h3> <pre style="margin-top:10px; margin-bottom:20px; font-family:Consolas,Menlo,Monaco,&quot;“DejaVu Sans Mono”&quot;,&quot;“Courier New”&quot;,monospace; font-size:14px; padding:10px 15px; border:1px solid rgb(235,235,235); vertical-align:baseline; word-wrap:normal; background-color:rgb(250,250,250); color:rgb(76,76,76)"><code style="font-family:Consolas,Menlo,Monaco,'“DejaVu Sans Mono”','“Courier New”',monospace; font-size:12px; max-width:100%; border:0px; padding:2px 5px; color:rgb(40,40,40); overflow-x:auto; word-wrap:normal; margin:0px; vertical-align:baseline; display:block">android {
 &nbsp; &nbsp;...

&nbsp; &nbsp;<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline; color:rgb(153,153,136); font-style:italic">// 多渠道打包（示例配置）</span>
 &nbsp; &nbsp;productFlavors {
 &nbsp; &nbsp; &nbsp; &nbsp;xiaomi {
 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;applicationId <span style="margin:0px; padding:0px; border:0px; vertical-align:baseline; color:rgb(221,17,68)">'com.tencent.bugly.hotfix.xiaomi'</span>
 &nbsp; &nbsp; &nbsp; &nbsp;}

&nbsp; &nbsp; &nbsp; &nbsp;yyb {
 &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;applicationId <span style="margin:0px; padding:0px; border:0px; vertical-align:baseline; color:rgb(221,17,68)">'com.tencent.bugly.hotfix.yyb'</span>
 &nbsp; &nbsp; &nbsp; &nbsp;}
 &nbsp; &nbsp;}

&nbsp;...

}

</code></pre> <h3 style="margin:0px; padding:20px 0px 0px; font-size:18px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 2. 执行<code style="font-family:Consolas,Menlo,Monaco,'“DejaVu Sans Mono”','“Courier New”',monospace; font-size:13.5px; white-space:pre-wrap; max-width:100%; background-color:rgb(240,240,240); border:0px; padding:2px 5px; overflow-x:auto; word-wrap:break-word; margin:0px; vertical-align:baseline; font-weight:normal">assembleRelease</code>生成基线apk</h3> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> 按照普通打包方式正常配置基线版本的tinkerId，然后执行assembleRelease生成不同渠道的apk，会在工程中build/bakApk/生成如下图所示文件：</p> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> <img alt="生成渠道基线apk" src="https://bugly.qq.com/docs/img/hotfix/android/Snip20161218_8.png?v=20170303160536" style="border:1px solid rgb(235,235,235); max-width:100%; height:auto!important; vertical-align:baseline; margin:0px; padding:8px"></p> <h3 style="margin:0px; padding:20px 0px 0px; font-size:18px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 3. 打渠道补丁包配置</h3> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> <img alt="打渠道补丁包配置" src="https://bugly.qq.com/docs/img/hotfix/android/Snip20170209_12.png?v=20170303160536" style="border:1px solid rgb(235,235,235); max-width:100%; height:auto!important; vertical-align:baseline; margin:0px; padding:8px"></p> <h3 style="margin:0px; padding:20px 0px 0px; font-size:18px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 4.执行<code style="font-family:Consolas,Menlo,Monaco,'“DejaVu Sans Mono”','“Courier New”',monospace; font-size:13.5px; white-space:pre-wrap; max-width:100%; background-color:rgb(240,240,240); border:0px; padding:2px 5px; overflow-x:auto; word-wrap:break-word; margin:0px; vertical-align:baseline; font-weight:normal">buildAllFlavorsTinkerPatchRelease</code>生成所有渠道补丁包</h3> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> 如下图所示：</p> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> <img alt="生成渠道补丁包" src="https://bugly.qq.com/docs/img/hotfix/android/Snip20170209_13.png?v=20170303160536" style="border:1px solid rgb(235,235,235); max-width:100%; height:auto!important; vertical-align:baseline; margin:0px; padding:8px"></p> <h3 style="margin:0px; padding:20px 0px 0px; font-size:18px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 5.测试应用补丁包</h3> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> 与普通打包一致。</p> <h2 style="margin:0px; padding:20px 0px 0px; font-size:20px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 加固打包（仅支持tinker 1.7.5以下）</h2> 
    <blockquote style="margin:10px 0px; border-width:0px 0px 0px 4px; border-left-style:solid; border-left-color:rgb(235,235,235); padding:0px 0px 0px 16px; color:rgb(76,76,76); vertical-align:baseline; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; quotes:none; line-height:1.7; font-size:14px"> 
     <p style="margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline"> tinker的一般模式需要Dex的合成，它并不支持加固，一定要使用加固的app可以使用usePreGeneratedPatchDex模式。由于加固会改变apk的dex结构，所以生成补丁包时我们务必要使用加固前的apk。&nbsp;<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">但是需要注意的是，某些加固工具会将非exported的四大组件的类名替换，对于这部分类即使使用usePreGeneratedPatchDex也无法修改。对于360加固，MainActivity由于被提前加载，也无法修复。大家对于加固的情况，请仔细测试，能否支持与加固的方式有关联</span>。</p> 
    </blockquote> <h3 style="margin:0px; padding:20px 0px 0px; font-size:18px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 1.提前生成dex配置</h3> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> tinker是支持加固模式的，但需要你回退到Qzone方案 ，将usePreGeneratedPatchDex设置为true。</p> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> <img alt="提前生成dex配置" src="https://bugly.qq.com/docs/img/hotfix/android/1480176125332.png?v=20170303160536" style="border:1px solid rgb(235,235,235); max-width:100%; height:auto!important; vertical-align:baseline; margin:0px; padding:8px"></p> 
    <blockquote style="margin:10px 0px; border-width:0px 0px 0px 4px; border-left-style:solid; border-left-color:rgb(235,235,235); padding:0px 0px 0px 16px; color:rgb(76,76,76); vertical-align:baseline; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; quotes:none; line-height:1.7; font-size:14px"> 
     <p style="margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline"> 是否提前生成dex，而非合成的方式。这套方案即<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">回退成Qzone的方案</span>，对于需要使用加固或者多flavor打包(建议使用其他方式生成渠道包)的用户可使用。但是这套方案需要<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">插桩</span>，<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">会造成Dalvik下性能损耗以及Art补丁包可能过大的问题，务必谨慎使用。另外一方面，这种方案在Android N之后可能会产生问题，建议过滤N之后的用户</span>。</p> 
    </blockquote> <h3 style="margin:0px; padding:20px 0px 0px; font-size:18px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 2.将基准包进行加固</h3> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> 如果你的app需要进行加固，你需要将你打出的基准包上传到具体的加固平台进行加固，例如<a href="http://legu.qcloud.com/" style="color:rgb(66,165,245); text-decoration:none; margin:0px; padding:0px; border:0px; vertical-align:baseline; outline:0px" rel="nofollow">乐固</a>，加固完成之后需要对apk进行<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">重签名</span>：</p> <pre style="margin-top:10px; margin-bottom:20px; font-family:Consolas,Menlo,Monaco,&quot;“DejaVu Sans Mono”&quot;,&quot;“Courier New”&quot;,monospace; font-size:14px; padding:10px 15px; border:1px solid rgb(235,235,235); vertical-align:baseline; word-wrap:normal; background-color:rgb(250,250,250); color:rgb(76,76,76)"><code style="font-family:Consolas,Menlo,Monaco,'“DejaVu Sans Mono”','“Courier New”',monospace; font-size:12px; max-width:100%; border:0px; padding:2px 5px; color:rgb(40,40,40); overflow-x:auto; word-wrap:normal; margin:0px; vertical-align:baseline; display:block"><span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">jarsigner -verbose -keystore <span style="margin:0px; padding:0px; border:0px; vertical-align:baseline; color:rgb(0,0,128)">&lt;<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">YOUR_KEYSTORE</span>&gt;</span> -signedjar <span style="margin:0px; padding:0px; border:0px; vertical-align:baseline; color:rgb(0,0,128)">&lt;<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">SIGNED_APK</span>&gt;</span> <span style="margin:0px; padding:0px; border:0px; vertical-align:baseline; color:rgb(0,0,128)">&lt;<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">UNSIGNED_APK</span>&gt;</span> <span style="margin:0px; padding:0px; border:0px; vertical-align:baseline; color:rgb(0,0,128)">&lt;<span style="margin:0px; padding:0px; border:0px; vertical-align:baseline">KEY_ALIAS</span>&gt;</span> </span></code></pre> 
    <blockquote style="margin:10px 0px; border-width:0px 0px 0px 4px; border-left-style:solid; border-left-color:rgb(235,235,235); padding:0px 0px 0px 16px; color:rgb(76,76,76); vertical-align:baseline; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; quotes:none; line-height:1.7; font-size:14px"> 
     <p style="margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline"> 以上命令说明：<br style=""> -verbose：指定生成详细输出<br style=""> -keystore：指定证书存储路径<br style=""> -signedjar：改选项的三个参数分别为签名后的apk包、未签名的apk包、数字证书别名<br style=""> </p> 
    </blockquote> <h3 style="margin:0px; padding:20px 0px 0px; font-size:18px; font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; border:0px; vertical-align:baseline; color:rgb(40,40,40); line-height:2"> 3.根据加固的基准包生成补丁包</h3> <p style="font-family:&quot;Helvetica Neue&quot;,Helvetica,&quot;Segoe UI&quot;,&quot;DejaVu Sans&quot;,Arial,&quot;PingFang SC&quot;,&quot;Hiragino Sans GB&quot;,&quot;Source Han Sans&quot;,&quot;Microsoft Yahei&quot;,&quot;Heiti SC&quot;,sans-serif; font-size:14px; margin-top:10px; margin-bottom:10px; line-height:1.7; padding-top:0px; padding-bottom:0px; border:0px; vertical-align:baseline; color:rgb(76,76,76)"> 打patch包的操作跟普通打包方式一致。</p> </td> 
  </tr> 
 </tbody> 
</table>

**Demo地址:**[**https://github.com/BuglyDevTeam/Bugly-Android-Demo**][https_github.com_BuglyDevTeam_Bugly-Android-Demo]** **

[Android]: http://blog.csdn.net/u011200604/article/details/60143582
[Tinker]: https://github.com/Tencent/tinker/wiki
[Image 1]: 
[tinker-support]: https://bugly.qq.com/docs/utility-tools/plugin-gradle-hotfix/
[tinkerId]: /images/20220708/0f3430f00afd47d3b1df9834fdabd82e.png
[tinkerId 1]: /images/20220708/00af56797b594157a5f80428b9d0fdb0.png
[Snip20170113_4.png_v_20170303160536]: /images/20220708/cb11d3e941c545ac8812894d83904a27.png
[Snip20170209_2.png_v_20170303160536]: /images/20220708/a01d51a7a2984831a0e1aa31d49369cf.png
[Snip20161213_28.png_v_20170303160536]: /images/20220708/ade6e8d9a853455e9edf582988819e77.png
[Snip20170113_7.png_v_20170303160536]: /images/20220708/62904de4ca09454da3f68d06023d9649.png
[Snip20170113_8.png_v_20170303160536]: /images/20220708/900af5b3ae8d4a70836cb3ce13973647.png
[apk_mapping_resId]: /images/20220708/7f00290ae24c4faf9225c08556d84b99.png
[task]: /images/20220708/7d2c10f6cda040d09e6235d2923ae33d.png
[build_outputs_patch]: /images/20220708/8658a8267d614e6783f1fa923c44fa51.png
[tinker-support 1]: /images/20220708/0c487b294bef49bd880e195d1e936f45.png
[Yapatch.MF]: /images/20220708/c9cae949ae8147768636b048dd01a8b7.png
[1479199765798.png_v_20170303160536]: /images/20220708/010505b4ae51414581866414073ab426.png
[1479199723899.png_v_20170303160536]: /images/20220708/146cd5af06194806b919a9f88994da74.png
[Snip20170209_6.png_v_20170303160536]: /images/20220708/deaff2299ac74bd9996d78e6e0dc2b3c.png
[app_patch]: /images/20220708/762c3ea4e92842afa059df2ae20a633d.png
[Snip20161213_27.png_v_20170303160536]: /images/20220708/3dc3d55de768449dbbb2dc16a8e4d2b2.png
[patch]: /images/20220708/dced49a4d52f4f04b3cf0fe608e0f508.png
[app]: /images/20220708/3531a31b49a4465fb6470626d65e9029.png
[https_github.com_BuglyDevTeam_Bugly-Android-Demo]: https://github.com/BuglyDevTeam/Bugly-Android-Demo