TinkerPatch 基础使用

提到TinkerPatch，相信大家已经很熟悉了。对的，微信的热修复平台，当然除了腾讯推出的热修复平台，对手阿里自然也不能说自己不行啊，也有对应的相关平台，以及美团等。为什么选择Tinker呢，腾讯给出了种种理由，但是坑也不少，特别是在机型上，一会小米系统不能修复，一会oppo、vivo不行，当然原因更多的是手机厂商在系统定制上的一些限制。有机会试试其他平台，选个最优的。
Tinker 平台地址：
http://www.tinkerpatch.com/

关于Tinker的接入可以分为下面步骤：

1. 添加 gradle 插件依赖

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath "com.tinkerpatch.sdk:tinkerpatch-gradle-plugin:1.2.9"
    }
}

2. 添加 TinkerPatch SDK 库的 denpendencies 依赖

    provided("com.tinkerpatch.tinker:tinker-android-anno:1.9.9")
    //tinker的核心库
    compile("com.tinkerpatch.sdk:tinkerpatch-android-sdk:1.2.9")

3. 配置TinkerPatch

   为了方便，将相关配置放置到tinkerpatch.gradle文件中，

apply plugin: 'tinkerpatch-support'

/**
 * TODO: 请按自己的需求修改为适应自己工程的参数
 */
def bakPath = file("${buildDir}/bakApk/")
def baseInfo = "app-1.1.0-1118-00-15-08"
def variantName = "release"

/**
 * 对于插件各参数的详细解析请参考
 * http://tinkerpatch.com/Docs/SDK
 */
tinkerpatchSupport {
    /** 可以在debug的时候关闭 tinkerPatch **/
    /** 当disable tinker的时候需要添加multiDexKeepProguard和proguardFiles,
     这些配置文件本身由tinkerPatch的插件自动添加，当你disable后需要手动添加
     你可以copy本示例中的proguardRules.pro和tinkerMultidexKeep.pro,
     需要你手动修改'tinker.sample.android.app'本示例的包名为你自己的包名, com.xxx前缀的包名不用修改
     **/

    /** 可以在debug的时候关闭 tinkerPatch **/
    tinkerEnable = true
    /** 是否使用一键接入功能  **/
    reflectApplication = true
    /**
     * 是否开启加固模式，只能在APK将要进行加固时使用，否则会patch失败。
     * 如果只在某个渠道使用了加固，可使用多flavors配置
     **/
    protectedApp = false
    /**
     * 实验功能
     * 补丁是否支持新增 Activity (新增Activity的exported属性必须为false)
     **/
    supportComponent = true

    autoBackupApkPath = "${bakPath}"

    appKey = "940f1384c26b9216"

    /** 注意: 若发布新的全量包, appVersion一定要更新 **/
    appVersion = "1.1.0"

    def pathPrefix = "${bakPath}/${baseInfo}/${variantName}/"
    def name = "${project.name}-${variantName}"

    baseApkFile = "${pathPrefix}/${name}.apk"
    baseProguardMappingFile = "${pathPrefix}/${name}-mapping.txt"
    baseResourceRFile = "${pathPrefix}/${name}-R.txt"

    /**
     *  若有编译多flavors需求, 可以参照： https://github.com/TinkerPatch/tinkerpatch-flavors-sample
     *  注意: 除非你不同的flavor代码是不一样的,不然建议采用zip comment或者文件方式生成渠道信息（相关工具：walle 或者 packer-ng）
     **/
}

/**
 * 用于用户在代码中判断tinkerPatch是否被使能
 */
android {
    defaultConfig {
        buildConfigField "boolean", "TINKER_ENABLE", "${tinkerpatchSupport.tinkerEnable}"
    }
}

/**
 * 一般来说,我们无需对下面的参数做任何的修改
 * 对于各参数的详细介绍请参考:
 * https://github.com/Tencent/tinker/wiki/Tinker-%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97
 */
tinkerPatch {
    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
    }
}

具体参数的意义以及赋值，官网都有列出，这里就不展开讲了。当我们编译好该配置文件后，需要在刚刚配置tinker依赖的时候添加

apply from: 'tinkerpatch.gradle'

以引入我们的最tinker的所有配置。

4. Tinker初始化

有了前面的步骤，Tinker相关的配置和依赖就差不多了，下面就需要我们在代码里对其进行初始化，一般在项目的Application 里：

 private ApplicationLike tinkerApplicationLike;

// 我们可以从这里获得Tinker加载过程的信息
        tinkerApplicationLike = TinkerPatchApplicationLike.getTinkerPatchApplicationLike();

        // 初始化TinkerPatch SDK, 更多配置可参照API章节中的,初始化SDK
        TinkerPatch.init(tinkerApplicationLike)
                .reflectPatchLibrary()
                .setPatchRollbackOnScreenOff(true)
                .setPatchRestartOnSrceenOff(true)
                .setFetchPatchIntervalByHours(3);

        // 每隔3个小时(通过setFetchPatchIntervalByHours设置)去访问后台时候有更新,通过handler实现轮训的效果
        TinkerPatch.with().fetchPatchUpdateAndPollWithInterval();

6. 编译打包

ok，到这里我们就可以使用Tinker了，从此不再因为一个字符串而发版了。
运行 assembleRelease task 构建基准包（请在发布前确保更新tinkerpatchSupport中的appVersion），tinkerPatch会基于你填入的autoBackupApkPath自动备份基础包信息到相应的文件夹，包含：apk文件、R.txt文件和mapping.txt文件 （注：mapping.txt是proguard的产物，如果你没有开启proguard则不会有这个文件）
若想发布补丁包， 只需将自动保存下来的文件分别填到tinkerpatchSupport中的baseApkFile、baseProguardMappingFile和baseResourceRFile 参数中；
运行 tinkerPatchRelease task 构建补丁包，补丁包将位于 build/outputs/tinkerPatch下。

关于Tinker的接入就上文所述了，另外，Tinker同样支持多渠道、应用加固等，可在配置文件中进行相关的配置。对于热修复技术，在目前快速迭代更新的环境下，是趋势也是必然的，如果有时间，学习其实现原理，相信在技术能力上，会有很大的提升。