Bugly之Tinker热更新集成指南

1.热更新概念

简单来说就是用户下载App之后，打开App时遇到的即时更新。

2.热更新原理

热更新就是动态下发代码，它可以使开发者在不发布新版本的情况下，修复 BUG 和发布功能。

Tinker实现热更新的过程就是：通过Base APK 和 New APK中的classes.dex生成一个patch.dex差异包，用户通过下载该差异包达到修复bug的目的。

3.热更新集成步骤

1）官网集成地址

https://bugly.qq.com/docs/user-guide/instruction-manual-android-hotfix/

2）集成注意事项

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

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

/**
 * 此处填写每次构建生成的基准包目录
 */
def baseApkDir = "app-0428-18-07-02"

/**
 * 对于插件各参数的详细解析请参考
 */
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 = "patch-1.0.3"

    // 构建多渠道补丁时使用
    // buildAllFlavorsDir = "${bakPath}/${baseApkDir}"

    // 是否启用加固模式，默认为false.(tinker-spport 1.0.7起支持）
    // isProtectedApp = true

    // 是否开启反射Application模式
    enableProxyApplication = false

    // 是否支持新增非export的Activity（注意：设置为true才能修改AndroidManifest文件）
    supportHotplugComponent = true

}

/**
 * 一般来说,我们无需对下面的参数做任何的修改
 * 对于各参数的详细介绍请参考:
 * 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的分配
    }
}

上面主要更改两个地方：

1. tinker-support.gradle

这里填写每次我们发布Apk时生成的基准包

  def baseApkDir = "app-0428-18-07-02"

// 构建基准包和补丁包都要指定不同的tinkerId，并且必须保证唯一性
tinkerId = "patch-1.0.3"

注意：每次我们发布补丁包时，这两个地方都要进行修改。

2. 如何通过gradle发布版本和生成补丁包

a) 使用installRelease生成apk

    1. 首先我们要在gradle里面配置如下：

signingConfigs {
        debug {
            keyAlias 'yangquantong'
            keyPassword '。。。'
            storeFile file('/Users/Guoqing/Desktop/yqt.jks')
            storePassword '。。。'
        }
        release {
            keyAlias 'yangquantong'
            keyPassword 'petle0601'
            storeFile file('/Users/Guoqing/Desktop/yqt.jks')
            storePassword '。。。'
        }
    }

    2. 生成的apk输出目录

    app--build--bakApk--apk-0428-18-07-01 该目录名称是你生成Apk的当前日期组成而成.

b) 使用tinker-support生成补丁包

    1. 首先要集成tinker插件

    2. 通过gradle找到tinker-support目录（注意不要找到tinker目录下）

    3. 点击buildTinkerPatchRelease等待生成即可。

    

    4. 将生成的补丁包上传至腾讯Bugly

    

    注意：这里上传补丁包可能会报错，原因可能是你打的基线包没有安装在手机上进行运行过，所以需要安装运行下。

    5. 补丁包的下发运行机制

    

3. 多渠道打包Walle

    采用美团开源的“瓦利”实现多渠道打包功能。

    多渠道打包指令及生成渠道包的路径:

    ./gradlew clean assembleReleaseChannels -PchannelList=google,wandou,huawei

    

    注意：关于渠道包热更新问题，采用上面正常生成补丁包的方式即可修复所有渠道包的问题。

4. Bugly平台应用热更新信息展示