android热更新腾讯系Tinker平台接入和使用详细步骤，带你跳过各种暗坑

 

 

背景：因为公司安排的需求是让设备自动更新，更新只需要一行代码，更新后重新打开就成为新的app了。

本博客说明内容分为：接入、使用。

接入步骤：

一、Tinker平台注册账户，新增app、记录appKey，需要填入的版本号跟你app目前版本一致。

  

二、在gradle.properties 文件中写入 tinkerSDK的版本号 ： 

贴上代码：

TINKERPATCH_VERSION=1.2.6

三、在工程的build.gandle 中 dependencies 节点下关联 TinkerPatch 插件：

贴上代码：

classpath ("com.tinkerpatch.sdk:tinkerpatch-gradle-plugin:${TINKERPATCH_VERSION}") { changing = true }

四、在app的build.grandle文件中关联tinkerSDK和关联tinkerpatch.gradle.

apply plugin: 'tinkerpatch-support'

/**
 * TODO: 请按自己的需求修改为适应自己工程的参数
 */
def bakPath = file("${buildDir}/bakApk/")
def baseInfo = "app-1.15-0330-15-55-37"
def variantName = "baidu-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前缀的包名不用修改
     **/
    tinkerEnable = true
    /**
        如果为reflectApplication 为true视为打开，则无须为接入Tinker而改造我们的application。
     **/
    reflectApplication = true
    /**
     * 是否开启加固模式，只能在APK将要进行加固时使用，否则会patch失败。
     * 如果只在某个渠道使用了加固，可使用多flavors配置
     **/
    protectedApp = false
    /**
     * 实验功能
     * 补丁是否支持新增 Activity (新增Activity的exported属性必须为false)
     **/
    supportComponent = true

    autoBackupApkPath = "${bakPath}"

    appKey = "af8218b2c7625788"

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

    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 = true
    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
    }
}

贴入代码：

       1.  app的build.grandle的 dependencies {} 节点中：

 

compile("com.tinkerpatch.sdk:tinkerpatch-android-sdk:${TINKERPATCH_VERSION}") { changing = true }

       2.   app的build.grandle的根目录下： 

 apply from: 'tinkerpatch.gradle'

五、将 tinkerpatch.gradle 文件拷贝至自己的工程目录下的这个位置，并根据自身情况修改内容。

 

六、在项目结构中配置签名

点击确定之后，让他构建完成，此时会在app.build中自动生成签名配置代码，然后进行下图操作。 

七、自己的Application中加入初始化tinker的代码。

贴入代码：

@Override
    public void onCreate() {
        super.onCreate();
        initTinkerPatch();
}
   /**
     * 我们需要确保至少对主进程跟patch进程初始化 TinkerPatch
     */
    private void initTinkerPatch() {
        // 我们可以从这里获得Tinker加载过程的信息
        if (BuildConfig.TINKER_ENABLE) {
          ApplicationLike  tinkerApplicationLike = TinkerPatchApplicationLike.getTinkerPatchApplicationLike();
            // 初始化TinkerPatch SDK
            TinkerPatch.init(
                tinkerApplicationLike
//                new TinkerPatch.Builder(tinkerApplicationLike)
//                    .requestLoader(new OkHttp3Loader())
//                    .build()
            )
                .reflectPatchLibrary()
                .setPatchRollbackOnScreenOff(true)
                .setPatchRestartOnSrceenOff(true)
                .setFetchPatchIntervalByHours(3)
            ;
            // 获取当前的补丁版本
            Log.d(TAG, "Current patch version is " + TinkerPatch.with().getPatchVersion());

            // fetchPatchUpdateAndPollWithInterval 与 fetchPatchUpdate(false)
            // 不同的是，会通过handler的方式去轮询
            TinkerPatch.with().fetchPatchUpdateAndPollWithInterval();
        }
    }

在自己要刷新的地方贴入代码：

//向tinker平台请求刷新差异补丁包
TinkerPatch.with().fetchPatchUpdate(true);

 

八、打开 在AndroidStudio中的右上角gradle。选择自己的渠道，双击assemble，我选中的是百度。

gradle过后，会在app/build下生成bakApk文件夹。里面有个app-开头的文件夹。这个是每次assemble后生成的，此文件夹下有签名过后的基础包。

 九、在测试设备上安装基础包，以及将上图文件夹名称填入后。开始构建tinker的差异补丁包。

十、双击tinkerPatch***Release后，在app/build/outputs/tinkerPatch 文件夹下生成差异补丁包。

十一、将 patch_signed_7zip.apk 上传至平台上。

十二、打开测试设备上安装自己的程序基础包，此时使用更新apk代码

的地方，然后退出程序，重新打开，此时app已经更新啦！！！

可以自己再多测试几遍生成差异补丁包、上传、更新。。。