當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

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

發布時間：2023/12/9 编程问答 44 豆豆

生活随笔收集整理的這篇文章主要介紹了手把手教你使用腾讯的热修复框架-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接入

添加依賴

在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執行腳本.

apply from: 'tinkerpatch.gradle'

配置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 = 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賦值為這個函數的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了。因為我在上面設置reflectApplication = true使用了一鍵接入功能，所以就不需要進行復雜的配置了，如下:

public class App extends Application {@Overridepublic void onCreate() {super.onCreate();initTinkerPatch();}/*** 我們需要確保至少對主進程跟patch進程初始化 TinkerPatch*/private void initTinkerPatch() {if (BuildConfig.TINKER_ENABLE) {// 我們可以從這里獲得Tinker加載過程的信息ApplicationLike tinkerApplicationLike = TinkerPatchApplicationLike.getTinkerPatchApplicationLike();// 初始化TinkerPatch SDK, 更多配置可參照API章節中的,初始化SDKTinkerPatch.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() {@Overridepublic void onPatchResult(PatchResult patchResult) {ToastUtils.toast("補丁修復:" + (patchResult.isSuccess ? "成功" : "失敗"));}});// 每隔3個小時(通過setFetchPatchIntervalByHours設置)去訪問后臺時候有更新,通過handler實現輪訓的效果TinkerPatch.with().fetchPatchUpdateAndPollWithInterval();}} }

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

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

如何使用Tinker進行熱修復

先隨便在程序中寫一個bug，然后執行./gradlew assembleRelease進行打包。當然你也可以直接在AS右側的Gradle中找到你的應用，并在Tasks->build->assembleRelease找到assembleRelease的任務，雙擊執行任務。

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

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

將bug修復后，執行./gradlew tinkerPatchRelease打補丁包。當然你也可以直接在AS右側的Gradle中找到你的應用，并在Tasks->tinker->tinkerPatchRelease找到tinkerPatchRelease的任務，雙擊執行任務。

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

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

注意事項

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

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

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

后續文章

手把手教你使用Tinker Platform進行熱修復補丁管理

聯系方式

微信公眾號

總結

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

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。