zoukankan      html  css  js  c++  java
  • 手把手教你使用腾讯的热修复框架-Tinker

    TinkerTest

    演示如何使用腾讯的热修复框架-Tinker

    项目地址

    Tinker热更新演示(请star支持)

    演示demo下载

    Tinker简介

    Tinker是微信官方的Android热补丁解决方案,它支持动态下发代码、So库以及资源,让应用能够在不需要重新安装的情况下实现更新。当然,你也可以使用Tinker来更新你的插件。

    相关链接

    Tinker已知问题

    由于原理与系统限制,Tinker有以下已知问题:

    • Tinker不支持修改AndroidManifest.xml,Tinker不支持新增四大组件(1.9.0支持新增非export的Activity);
    • 由于Google Play的开发者条款限制,不建议在GP渠道动态更新代码;
    • 在Android N上,补丁对应用启动时间有轻微的影响;
    • 不支持部分三星android-21机型,加载补丁时会主动抛出”TinkerRuntimeException:checkDexInstall failed”;
    • 对于资源替换,不支持修改remoteView。例如transition动画,notification icon以及桌面图标。

    官方说明请点击查看.

    Tinker接入

    添加依赖

    1. 在Project的根目录的build.gradle下添加tinkerpatch插件:
    
    buildscript {
        ...
        dependencies {
            ...
            classpath "com.tinkerpatch.sdk:tinkerpatch-gradle-plugin:1.2.8"
        }
    }
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    1. 在module的build.gradle下增加Tinker的依赖。
    dependencies {
        implementation 'com.android.support:multidex:1.0.3'
        //若使用annotation需要单独引用,对于tinker的其他库都无需再引用
        annotationProcessor 'com.tinkerpatch.tinker:tinker-android-anno:1.9.8'
        compileOnly 'com.tinkerpatch.tinker:tinker-android-anno:1.9.8'
        implementation 'com.tinkerpatch.sdk:tinkerpatch-android-sdk:1.2.8'
    }
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    1. 配置代码混淆和打包配置。其中tinkerMultidexKeep.pro和proguardRules.pro可参考我的demo工程。
    android {
        compileSdkVersion 27
    
        defaultConfig {
            applicationId "com.xuexiang.tinkertest"
            minSdkVersion 14
            targetSdkVersion 27
            versionCode 1
            versionName "1.0"
    
            multiDexEnabled true
            multiDexKeepProguard file("tinkerMultidexKeep.pro") //keep specific classes using proguard syntax
    
        }
    
        signingConfigs {
            release {
                //配置你的storekey
                storeFile file(app_release.storeFile)
                storePassword app_release.storePassword
                keyAlias app_release.keyAlias
                keyPassword app_release.keyPassword
            }
        }
    
        buildTypes {
            release {
                minifyEnabled true
                shrinkResources true
                signingConfig signingConfigs.release
                proguardFiles 'proguardRules.pro', getDefaultProguardFile('proguard-android.txt')
            }
            debug {
                debuggable true
                minifyEnabled false
            }
        }
    
        sourceSets {
            main {
                jniLibs.srcDirs = ['libs']
            }
        }
    }
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    • 44
    1. 引用tinkerpatch.gradle执行脚本.
    apply from: 'tinkerpatch.gradle'
    • 1
    1. 配置tinkerpatch.gradle执行脚本.对于脚本的详细说明请参考官方文档

    这里我只想说几个比较关键的配置:

    • bakPath: 这里存放的是每次我们打包生成的apk目录,作为生成补丁包的参考包路径。(一般配置了就不用动了)

    • baseInfo: 这里设置的是,本次打补丁包参照的apk包所在文件夹路径,也就是旧APK的目录。(每次打补丁包的时候,都需要手动去更新)

    • variantName: 设置打补丁包的类型是release还是debug。

    • AppKey: 这是从Tinker Platform上注册获得的应用的appkey。

    • AppVersion: 这也是在Tinker Platform上,每次上传补丁包时都需要填写的应用版本,并且必须是唯一的。

    【注意】:AppKey和AppVersion都是用于Tinker Platform自定发布补丁包所需要的。如果你不使用Tinker Platform来管理你的热更新的话,可以随便设置。

    以下是tinkerpatch.gradle的配置样例:

    apply plugin: 'tinkerpatch-support'
    
    /**
     * TODO: 请按自己的需求修改为适应自己工程的参数
     */
    def bakPath = file("${buildDir}/bakApk/")
    /** 每次在打补丁包的时候,需要更新这里的旧包的位置  **/
    def baseInfo = "app-1.0.0-0810-17-28-31"
    def variantName = "release"
    
    def AppKey = "4c118de195c79b14"
    def AppVersion = "1.0.0"
    
    /**
     * 对于插件各参数的详细解析请参考
     * 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
        /**
         * 是否开启加固模式,只能在APK将要进行加固时使用,否则会patch失败。
         * 如果只在某个渠道使用了加固,可使用多flavors配置
         **/
        protectedApp = false
        /**
         * 实验功能
         * 补丁是否支持新增 Activity (新增Activity的exported属性必须为false)
         **/
        supportComponent = true
    
        /** 在tinkerpatch.com得到的appKey,改成你的应用appKey **/
    
        appKey = "${AppKey}"
    
        /** 注意: 若发布新的全量包, appVersion一定要更新 **/
        appVersion = "${AppVersion}"
    
        autoBackupApkPath = "${bakPath}"
    
        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
        }
    }
    
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25
    • 26
    • 27
    • 28
    • 29
    • 30
    • 31
    • 32
    • 33
    • 34
    • 35
    • 36
    • 37
    • 38
    • 39
    • 40
    • 41
    • 42
    • 43
    • 44
    • 45
    • 46
    • 47
    • 48
    • 49
    • 50
    • 51
    • 52
    • 53
    • 54
    • 55
    • 56
    • 57
    • 58
    • 59
    • 60
    • 61
    • 62
    • 63
    • 64
    • 65
    • 66
    • 67
    • 68
    • 69
    • 70
    • 71
    • 72
    • 73
    • 74
    • 75
    • 76
    • 77
    • 78
    • 79
    • 80
    • 81
    • 82
    • 83
    • 84
    • 85
    • 86
    • 87
    • 88
    • 89
    • 90
    • 91
    • 92
    • 93
    • 94
    • 95
    • 96
    • 97
    • 98
    • 99
    • 100
    • 101
    • 102
    • 103
    • 104
    • 105
    • 106
    1. 最后就是配置Application了。因为我在上面设置reflectApplication = true使用了一键接入功能,所以就不需要进行复杂的配置了,如下:
    public class App extends Application {
    
        @Override
        public void onCreate() {
            super.onCreate();
    
            // 我们可以从这里获得Tinker加载过程的信息
            ApplicationLike tinkerApplicationLike = TinkerPatchApplicationLike.getTinkerPatchApplicationLike();
            // 初始化TinkerPatch SDK, 更多配置可参照API章节中的,初始化SDK
            TinkerPatch.init(tinkerApplicationLike)
                    .reflectPatchLibrary()
                    .setPatchRollbackOnScreenOff(true)
                    .setPatchRestartOnSrceenOff(true)
                    .setPatchResultCallback(new ResultCallBack() {
                        @Override
                        public void onPatchResult(PatchResult patchResult) {
                            ToastUtils.toast("补丁修复:" + (patchResult.isSuccess ? "成功" : "失败"));
                        }
                    })
                    .setFetchPatchIntervalByHours(3);
            // 每隔3个小时(通过setFetchPatchIntervalByHours设置)去访问后台时候有更新,通过handler实现轮训的效果
            TinkerPatch.with().fetchPatchUpdateAndPollWithInterval();
        }
    
    }
    • 1
    • 2
    • 3
    • 4
    • 5
    • 6
    • 7
    • 8
    • 9
    • 10
    • 11
    • 12
    • 13
    • 14
    • 15
    • 16
    • 17
    • 18
    • 19
    • 20
    • 21
    • 22
    • 23
    • 24
    • 25

    更多复杂的配置和高端自定义操作可参见官方文档

    以上就完成了Tinker的接入工作。

    如何使用Tinker进行热修复

    1. 先随便在程序中写一个bug,然后执行./gradlew assembleRelease进行打包。当然你也可以直接在AS右侧的Gradle中找到你的应用,并在Tasks->build->assembleRelease找到assembleRelease的任务,双击执行任务。

    执行完成后,你会在你模块的build->bakApk下看到你打的apk包。

    1. 你将刚才生成apk的那个文件夹的名称设置在之前说的tinkerpatch.gradle中的baseInfo

    2. 将bug修复后,执行./gradlew tinkerPatchRelease打补丁包。当然你也可以直接在AS右侧的Gradle中找到你的应用,并在Tasks->tinker->tinkerPatchRelease找到tinkerPatchRelease的任务,双击执行任务。

    执行完成后,你会在你模块的build->outputs->apk->tinkerPatch->release下看到你需要的补丁包patch_signed_7zip.apk

    1. 最后调用TinkerInstaller.onReceiveUpgradePatch(getApplicationContext(), path);, path传入你补丁包的所在的路径即可完成热更新。

    需要注意的是,执行热更新后,需要重启程序才能生效!

  • 相关阅读:
    前端学习(六):body标签(四)
    前端学习(五):body标签(三)
    前端学习(四):body标签(二)
    前端学习(三):body标签(一)
    volatile的作用以及原理解析
    【转载】synchronized锁的升级过程
    从三个层面解析synchronized原理
    将网页图片转base64打包导出实战和踩坑
    synchronized锁住的到底是什么以及用法作用
    多线程之程序的局部性原理和伪共享问题
  • 原文地址:https://www.cnblogs.com/kekexuanxaun/p/9480308.html
Copyright © 2011-2022 走看看