當(dāng)前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

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

發(fā)布時間：2023/12/9 编程问答 54 豆豆

生活随笔收集整理的這篇文章主要介紹了手把手教你使用腾讯的热修复框架-Tinker 小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.

TinkerTest

演示如何使用騰訊的熱修復(fù)框架-Tinker

項目地址

Tinker熱更新演示（請star支持）

演示demo下載

Tinker簡介

Tinker是微信官方的Android熱補(bǔ)丁解決方案，它支持動態(tài)下發(fā)代碼、So庫以及資源，讓應(yīng)用能夠在不需要重新安裝的情況下實(shí)現(xiàn)更新。當(dāng)然，你也可以使用Tinker來更新你的插件。

Tinker已知問題

由于原理與系統(tǒng)限制，Tinker有以下已知問題:

Tinker不支持修改AndroidManifest.xml，Tinker不支持新增四大組件(1.9.0支持新增非export的Activity)；
由于Google Play的開發(fā)者條款限制，不建議在GP渠道動態(tài)更新代碼；
在Android N上，補(bǔ)丁對應(yīng)用啟動時間有輕微的影響；
不支持部分三星android-21機(jī)型，加載補(bǔ)丁時會主動拋出"TinkerRuntimeException:checkDexInstall failed"；
對于資源替換，不支持修改remoteView。例如transition動畫，notification icon以及桌面圖標(biāo)。

官方說明請點(diǎn)擊查看.

Tinker接入

添加依賴

在Project的根目錄的build.gradle下添加tinkerpatch插件：

buildscript {...dependencies {...classpath "com.tinkerpatch.sdk:tinkerpatch-gradle-plugin:1.2.13"} }

在module的build.gradle下增加Tinker的依賴。

dependencies {implementation 'com.android.support:multidex:1.0.3'implementation 'com.tinkerpatch.sdk:tinkerpatch-android-sdk:1.2.13' }

配置代碼混淆和打包配置。其中tinkerMultidexKeep.pro和proguard-rules.pro可選填。

android {compileSdkVersion 27defaultConfig {applicationId "com.xuexiang.tinkertest"minSdkVersion 14targetSdkVersion 27versionCode 1versionName "1.0"multiDexEnabled true}signingConfigs {release {//配置你的storekeystoreFile file(app_release.storeFile)storePassword app_release.storePasswordkeyAlias app_release.keyAliaskeyPassword app_release.keyPassword}}buildTypes {release {minifyEnabled trueshrinkResources truesigningConfig signingConfigs.releaseproguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'}debug {debuggable trueminifyEnabled false}}//recommenddexOptions {jumboMode = true}sourceSets {main {jniLibs.srcDirs = ['libs']}} }

引用tinkerpatch.gradle執(zhí)行腳本.

apply from: 'tinkerpatch.gradle'

配置tinkerpatch.gradle執(zhí)行腳本.對于腳本的詳細(xì)說明請參考官方文檔。

這里我只想說幾個比較關(guān)鍵的配置：

bakPath: 這里存放的是每次我們打包生成的apk目錄，作為生成補(bǔ)丁包的參考包路徑。（一般配置了就不用動了）
baseInfo: 這里設(shè)置的是，本次打補(bǔ)丁包參照的apk包所在文件夾路徑，也就是舊APK的目錄。（每次打補(bǔ)丁包的時候，都需要手動去更新）
variantName: 設(shè)置打補(bǔ)丁包的類型是release還是debug。
AppKey: 這是從Tinker Platform上注冊獲得的應(yīng)用的appkey。
AppVersion: 這也是在Tinker Platform上，每次上傳補(bǔ)丁包時都需要填寫的應(yīng)用版本，并且必須是唯一的。

【注意】：AppKey和AppVersion都是用于Tinker Platform自定發(fā)布補(bǔ)丁包所需要的。如果你不使用Tinker Platform來管理你的熱更新的話，可以隨便設(shè)置。

以下是tinkerpatch.gradle的配置樣例：

apply plugin: 'tinkerpatch-support'/*** TODO: 請按自己的需求修改為適應(yīng)自己工程的參數(shù)*/ def bakPath = file("${buildDir}/bakApk/") /** 每次在打補(bǔ)丁包的時候，需要更新這里的舊包的位置 **/ def baseInfo = "app-1.0.0-0810-17-28-31" def variantName = "release"def AppKey = "4c118de195c79b14" def AppVersion = "1.0.0"/*** 對于插件各參數(shù)的詳細(xì)解析請參考* http://tinkerpatch.com/Docs/SDK*/ tinkerpatchSupport {/** 可以在debug的時候關(guān)閉 tinkerPatch, isRelease() 可以判斷BuildType是否為Release **/tinkerEnable = isRelease()/** 是否使用一鍵接入功能 **/reflectApplication = true/*** 是否開啟加固模式，只能在APK將要進(jìn)行加固時使用，否則會patch失敗。* 如果只在某個渠道使用了加固，可使用多flavors配置**/protectedApp = false/*** 實(shí)驗(yàn)功能* 補(bǔ)丁是否支持新增 Activity (新增Activity的exported屬性必須為false)**/supportComponent = true/** 在tinkerpatch.com得到的appKey,改成你的應(yīng)用appKey **/appKey = "${AppKey}"/** 注意: 若發(fā)布新的全量包, 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或者文件方式生成渠道信息（相關(guān)工具：walle 或者 packer-ng）**/ }/*** 用于用戶在代碼中判斷tinkerPatch是否被使能*/ android {defaultConfig {buildConfigField "boolean", "TINKER_ENABLE", "${tinkerpatchSupport.tinkerEnable}"} }/*** 一般來說,我們無需對下面的參數(shù)做任何的修改* 對于各參數(shù)的詳細(xì)介紹請參考:* https://github.com/Tencent/tinker/wiki/Tinker-%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97*/ tinkerPatch {ignoreWarning = trueuseSign = truedex {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賦值為這個函數(shù)的return* @return 是否為release*/def isRelease() {Gradle gradle = getGradle()String tskReqStr = gradle.getStartParameter().getTaskRequests().toString()Pattern patternif (tskReqStr.contains("assemble")) {println tskReqStrpattern = 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}}}

最后就是配置Application了。因?yàn)槲以谏厦嬖O(shè)置reflectApplication = true使用了一鍵接入功能，所以就不需要進(jìn)行復(fù)雜的配置了，如下:

public class App extends Application {@Overridepublic void onCreate() {super.onCreate();initTinkerPatch();}/*** 我們需要確保至少對主進(jìn)程跟patch進(jìn)程初始化 TinkerPatch*/private void initTinkerPatch() {if (BuildConfig.TINKER_ENABLE) {// 我們可以從這里獲得Tinker加載過程的信息ApplicationLike tinkerApplicationLike = TinkerPatchApplicationLike.getTinkerPatchApplicationLike();// 初始化TinkerPatch SDK, 更多配置可參照API章節(jié)中的,初始化SDKTinkerPatch.init(tinkerApplicationLike).reflectPatchLibrary()//向后臺獲取是否有補(bǔ)丁包更新,默認(rèn)的訪問間隔為3個小時，若參數(shù)為true,即每次調(diào)用都會真正的訪問后臺配置//你也可以在用戶登錄或者APP啟動等一些關(guān)鍵路徑，使用fetchPatchUpdate(true)強(qiáng)制檢查更新.fetchPatchUpdate(false)//設(shè)置訪問后臺補(bǔ)丁包更新配置的時間間隔,默認(rèn)為3個小時.setFetchPatchIntervalByHours(3)//向后臺獲得動態(tài)配置,默認(rèn)的訪問間隔為3個小時//若參數(shù)為true,即每次調(diào)用都會真正的訪問后臺配置.fetchDynamicConfig(new ConfigRequestCallback() {@Override public void onSuccess(HashMap<String, String> hashMap) {Log.e("xuexiang", "參數(shù):" + JsonUtil.toJson(hashMap));}@Override public void onFail(Exception e) { }}, true)//設(shè)置訪問后臺動態(tài)配置的時間間隔,默認(rèn)為3個小時.setFetchDynamicConfigIntervalByHours(3)//設(shè)置收到后臺回退要求時,鎖屏清除補(bǔ)丁,默認(rèn)是等主進(jìn)程重啟時自動清除.setPatchRollbackOnScreenOff(true)//設(shè)置補(bǔ)丁合成成功后,鎖屏重啟程序,默認(rèn)是等應(yīng)用自然重啟.setPatchRestartOnSrceenOff(true).setPatchResultCallback(new ResultCallBack() {@Overridepublic void onPatchResult(PatchResult patchResult) {ToastUtils.toast("補(bǔ)丁修復(fù):" + (patchResult.isSuccess ? "成功" : "失敗"));}});// 每隔3個小時(通過setFetchPatchIntervalByHours設(shè)置)去訪問后臺時候有更新,通過handler實(shí)現(xiàn)輪訓(xùn)的效果TinkerPatch.with().fetchPatchUpdateAndPollWithInterval();}} }

更多復(fù)雜的配置和高端自定義操作可參見官方文檔。

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

如何使用Tinker進(jìn)行熱修復(fù)

先隨便在程序中寫一個bug，然后執(zhí)行./gradlew assembleRelease進(jìn)行打包。當(dāng)然你也可以直接在AS右側(cè)的Gradle中找到你的應(yīng)用，并在Tasks->build->assembleRelease找到assembleRelease的任務(wù)，雙擊執(zhí)行任務(wù)。

執(zhí)行完成后，你會在你模塊的build->bakApk下看到你打的apk包。

你將剛才生成apk的那個文件夾的名稱設(shè)置在之前說的tinkerpatch.gradle中的baseInfo。

將bug修復(fù)后，執(zhí)行./gradlew tinkerPatchRelease打補(bǔ)丁包。當(dāng)然你也可以直接在AS右側(cè)的Gradle中找到你的應(yīng)用，并在Tasks->tinker->tinkerPatchRelease找到tinkerPatchRelease的任務(wù)，雙擊執(zhí)行任務(wù)。

執(zhí)行完成后，你會在你模塊的build->outputs->apk->tinkerPatch->release下看到你需要的補(bǔ)丁包patch_signed_7zip.apk。

最后調(diào)用TinkerInstaller.onReceiveUpgradePatch(getApplicationContext(), path);, path傳入你補(bǔ)丁包的所在的路徑即可完成熱更新。

注意事項

1.如果你使用的Java-8，你還需要在項目目錄的gradle.properties文件中增加如下配置：

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

2.執(zhí)行熱更新后，需要重啟程序或者鎖屏才能生效！

后續(xù)文章

手把手教你使用Tinker Platform進(jìn)行熱修復(fù)補(bǔ)丁管理

聯(lián)系方式

微信公眾號

總結(jié)

以上是生活随笔為你收集整理的手把手教你使用腾讯的热修复框架-Tinker的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。