原创

手把手教你使用腾讯的热修复框架-Tinker

版权声明:本文为博主原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://xuexiangjys.blog.csdn.net/article/details/81587055

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.13"

    }
}
  1. 在module的build.gradle下增加Tinker的依赖。
dependencies {
    implementation 'com.android.support:multidex:1.0.3'
    implementation 'com.tinkerpatch.sdk:tinkerpatch-android-sdk:1.2.13'
}
  1. 配置代码混淆和打包配置。其中tinkerMultidexKeep.pro和proguard-rules.pro可选填。
android {
    compileSdkVersion 27

    defaultConfig {
        applicationId "com.xuexiang.tinkertest"
        minSdkVersion 14
        targetSdkVersion 27
        versionCode 1
        versionName "1.0"

        multiDexEnabled true
    }

    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 getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            debuggable true
            minifyEnabled false
        }
    }
    
    //recommend
    dexOptions {
        jumboMode = true
    }
    
    sourceSets {
        main {
            jniLibs.srcDirs = ['libs']
        }
    }
}
  1. 引用tinkerpatch.gradle执行脚本.
apply from: 'tinkerpatch.gradle'
  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, isRelease() 可以判断BuildType是否为Release **/
    tinkerEnable = isRelease()

    /** 是否使用一键接入功能  **/

    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 = 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
    }
    
    /**
	 * 如果只想在Release中打开tinker,可以把tinkerEnable赋值为这个函数的return
	 * @return 是否为release
	 */
	def isRelease() {
	    Gradle gradle = getGradle()
	    String  tskReqStr = gradle.getStartParameter().getTaskRequests().toString()
	
	    Pattern pattern
	    if (tskReqStr.contains("assemble")) {
	        println tskReqStr
	        pattern = Pattern.compile("assemble(\\w*)(Release|Debug)")
	    } else {
	        pattern = Pattern.compile("generate(\\w*)(Release|Debug)")
	    }
	    Matcher matcher = pattern.matcher(tskReqStr)
	
	    if (matcher.find()) {
	        String task = matcher.group(0).toLowerCase()
	        println("[BuildType] Current task: " + task)
	        return task.contains("release")
	    } else {
	        println "[BuildType] NO MATCH FOUND"
	        return true
	    }
	}

}

  1. 最后就是配置Application了。因为我在上面设置reflectApplication = true使用了一键接入功能,所以就不需要进行复杂的配置了,如下:
public class App extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        initTinkerPatch();
    }
    
    /**
     * 我们需要确保至少对主进程跟patch进程初始化 TinkerPatch
     */
    private void initTinkerPatch() {
        if (BuildConfig.TINKER_ENABLE) {
            // 我们可以从这里获得Tinker加载过程的信息
            ApplicationLike tinkerApplicationLike = TinkerPatchApplicationLike.getTinkerPatchApplicationLike();

            // 初始化TinkerPatch SDK, 更多配置可参照API章节中的,初始化SDK
            TinkerPatch.init(tinkerApplicationLike)
                    .reflectPatchLibrary()
                    //向后台获取是否有补丁包更新,默认的访问间隔为3个小时,若参数为true,即每次调用都会真正的访问后台配置
                    //你也可以在用户登录或者APP启动等一些关键路径,使用fetchPatchUpdate(true)强制检查更新
                    .fetchPatchUpdate(false)
                    //设置访问后台补丁包更新配置的时间间隔,默认为3个小时
                    .setFetchPatchIntervalByHours(3)
                    //向后台获得动态配置,默认的访问间隔为3个小时
                    //若参数为true,即每次调用都会真正的访问后台配置
                    .fetchDynamicConfig(new ConfigRequestCallback() {
                        @Override public void onSuccess(HashMap<String, String> hashMap) {
                            Log.e("xuexiang", "参数:" + JsonUtil.toJson(hashMap));

                        }
                        @Override public void onFail(Exception e) { }
                    }, true)
                    //设置访问后台动态配置的时间间隔,默认为3个小时
                    .setFetchDynamicConfigIntervalByHours(3)
                    //设置收到后台回退要求时,锁屏清除补丁,默认是等主进程重启时自动清除
                    .setPatchRollbackOnScreenOff(true)
                    //设置补丁合成成功后,锁屏重启程序,默认是等应用自然重启
                    .setPatchRestartOnSrceenOff(true)
                    .setPatchResultCallback(new ResultCallBack() {
                        @Override
                        public void onPatchResult(PatchResult patchResult) {
                            ToastUtils.toast("补丁修复:" + (patchResult.isSuccess ? "成功" : "失败"));
                        }
                    });

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

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

以上就完成了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传入你补丁包的所在的路径即可完成热更新。

注意事项

1.如果你使用的Java-8,你还需要在项目目录的gradle.properties文件中增加如下配置:

android.enableD8.desugaring= true
android.useDexArchive= true

2.执行热更新后,需要重启程序或者锁屏才能生效!

后续文章

手把手教你使用Tinker Platform进行热修复补丁管理

联系方式


在这里插入图片描述

微信公众号

在这里插入图片描述

文章最后发布于: 2018-08-11 15:20:53
展开阅读全文
0 个人打赏
私信求帮助

没有更多推荐了,返回首页

©️2019 CSDN 皮肤主题: 点我我会动 设计师: 上身试试

分享到微信朋友圈

×

扫一扫,手机浏览