參考:
微信Tinker
Bugly Android熱更新使用指南
有了Bugly幫助我們集成暂筝,那么我們就無需過多去關(guān)心Tinker是如何配置的萤皂,因為其配置太麻煩了揣云。只是在遇到一些特別的問題時梳码,我們不妨去看看微信Tinker的幫助文檔人芽!
第一步:在總工程的build.grade下面添加依賴
buildscript {
repositories {
jcenter()
}
dependencies {
// tinkersupport插件, 其中l(wèi)astest.release指拉取最新版本望几,也可以指定明確版本號,例如1.0.4
classpath "com.tencent.bugly:tinker-support:latest.release"
}
}
第二步:在當(dāng)前Modle的build.grade中集成SDK
dependencies {
compile "com.android.support:multidex:1.0.1" // 多dex配置
compile 'com.tencent.bugly:crashreport_upgrade:latest.release' // 升級SDK
}
并在最上面加入依賴插件腳本
apply from: 'tinker-support.gradle'
這個腳本需要自己在當(dāng)前Model的根目錄下創(chuàng)建萤厅,要和build.grade在同一文件夾
tinker-support.gradle里面的內(nèi)容如下:
apply plugin: 'com.tencent.bugly.tinker-support'
def bakPath = file("${buildDir}/bakApk/")
/**
* 此處填寫每次構(gòu)建生成的基準(zhǔn)包目錄
*/
def baseApkDir = "app-0208-15-10-00"
/**
* 對于插件各參數(shù)的詳細(xì)解析請參考
*/
tinkerSupport {
// 開啟tinker-support插件橄抹,默認(rèn)值true
enable = true
// 指定歸檔目錄,默認(rèn)值當(dāng)前module的子目錄tinker
autoBackupApkDir = "${bakPath}"
// 是否啟用覆蓋tinkerPatch配置功能惕味,默認(rèn)值false
// 開啟后tinkerPatch配置不生效害碾,即無需添加tinkerPatch
overrideTinkerPatchConfiguration = true
// 編譯補(bǔ)丁包時,必需指定基線版本的apk赦拘,默認(rèn)值為空
// 如果為空慌随,則表示不是進(jìn)行補(bǔ)丁包的編譯
// @{link tinkerPatch.oldApk }
baseApk = "${bakPath}/${baseApkDir}/app-release.apk"
// 對應(yīng)tinker插件applyMapping
baseApkProguardMapping = "${bakPath}/${baseApkDir}/app-release-mapping.txt"
// 對應(yīng)tinker插件applyResourceMapping
baseApkResourceMapping = "${bakPath}/${baseApkDir}/app-release-R.txt"
// 構(gòu)建基準(zhǔn)包和補(bǔ)丁包都要指定不同的tinkerId,并且必須保證唯一性
tinkerId = "base-1.0.1"
// 構(gòu)建多渠道補(bǔ)丁時使用
// buildAllFlavorsDir = "${bakPath}/${baseApkDir}"
// 是否開啟反射Application模式
enableProxyApplication = false
}
/**
* 一般來說,我們無需對下面的參數(shù)做任何的修改
* 對于各參數(shù)的詳細(xì)介紹請參考:
* https://github.com/Tencent/tinker/wiki/Tinker-%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97
*/
tinkerPatch {
//oldApk ="${bakPath}/${appName}/app-release.apk"
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
//tinkerId = "1.0.1-base"
//applyMapping = "${bakPath}/${appName}/app-release-mapping.txt" // 可選,設(shè)置mapping文件阁猜,建議保持舊apk的proguard混淆方式
//applyResourceMapping = "${bakPath}/${appName}/app-release-R.txt" // 可選丸逸,設(shè)置R.txt文件,通過舊apk文件保持ResId的分配
}
}
更詳細(xì)的配置項參考tinker-support配置說明
注意這個文件中配置了enableProxyApplication = false
意思就是是否開啟反射Application模式,默認(rèn)為false
這是Tinker推薦的接入方式剃袍,一定程度上會增加接入成本黄刚,但具有更好的兼容性。
第三步:初始化SDK
分兩種情況來進(jìn)行初始化
情況一(推薦):enableProxyApplication = false
需要我們自定義的MyApplication繼承TinkerApplication
public class SampleApplication extends TinkerApplication {
public SampleApplication() {
super(ShareConstants.TINKER_ENABLE_ALL, "xxx.xxx.SampleApplicationLike",
"com.tencent.tinker.loader.TinkerLoader", false);
}
}
注意:這個類集成TinkerApplication類民效,這里面不做任何操作憔维,所有Application的代碼都會放到ApplicationLike繼承類當(dāng)中
四個參數(shù)解析
參數(shù)1:tinkerFlags 表示Tinker支持的類型 dex only、library only or all suuport畏邢,default: TINKER_ENABLE_ALL
參數(shù)2:delegateClassName Application代理類 這里填寫你自定義的ApplicationLike
參數(shù)3:loaderClassName Tinker的加載器业扒,使用默認(rèn)即可
參數(shù)4:tinkerLoadVerifyFlag 加載dex或者lib是否驗證md5,默認(rèn)為false
這里需要重新寫一個ApplicationLike來繼承DefaultApplicationLike
public class SampleApplicationLike extends DefaultApplicationLike {
public static final String TAG = "Tinker.SampleApplicationLike";
public SampleApplicationLike(Application application, int tinkerFlags,
boolean tinkerLoadVerifyFlag, long applicationStartElapsedTime,
long applicationStartMillisTime, Intent tinkerResultIntent) {
super(application, tinkerFlags, tinkerLoadVerifyFlag, applicationStartElapsedTime, applicationStartMillisTime, tinkerResultIntent);
}
@Override
public void onCreate() {
super.onCreate();
// 這里實現(xiàn)SDK初始化舒萎,appId替換成你的在Bugly平臺申請的appId
// 調(diào)試時程储,將第三個參數(shù)改為true
Bugly.init(getApplication(), "900029763", false);
}
@TargetApi(Build.VERSION_CODES.ICE_CREAM_SANDWICH)
@Override
public void onBaseContextAttached(Context base) {
super.onBaseContextAttached(base);
// you must install multiDex whatever tinker is installed!
MultiDex.install(base);
// 安裝tinker
// TinkerManager.installTinker(this); 替換成下面Bugly提供的方法
Beta.installTinker(this);
}
@TargetApi(Build.VERSION_CODES.ICE_CREAM_SANDWICH)
public void registerActivityLifecycleCallback(Application.ActivityLifecycleCallbacks callbacks) {
getApplication().registerActivityLifecycleCallbacks(callbacks);
}
}
注意:這里發(fā)現(xiàn)官方文檔的一個bug,在onCreate中進(jìn)行了Bugly.init(this, "900029763", false);也就是Bugly調(diào)試的初始化,但是里面第一個參數(shù)是要傳入上下文的臂寝,而SampleApplicationLike 只是一個抽象類的實現(xiàn)類章鲤。這段應(yīng)該放在MyApplication的OnCreate()方法中才對,所以這里注釋掉了咆贬!
(其實在這里可以使用getApplication()來獲取上下文替換this,多謝小巫的提醒败徊。)
情況二(簡單):enableProxyApplication = true
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// 這里實現(xiàn)SDK初始化,appId替換成你的在Bugly平臺申請的appId
// 調(diào)試時掏缎,將第三個參數(shù)改為true
Bugly.init(this, "900029763", false);
}
@Override
protected void attachBaseContext(Context base) {
super.attachBaseContext(base);
// you must install multiDex whatever tinker is installed!
MultiDex.install(base);
// 安裝tinker
Beta.installTinker();
}
}
注:無須你改造Application皱蹦,主要是為了降低接入成本,我們插件會動態(tài)替換AndroidMinifest文件中的Application為我們定義好用于反射真實Application的類(需要您接入SDK 1.2.2版本 和 插件版本 1.0.3以上)御毅。
第四步:AndroidManifest.xml的配置
1.權(quán)限配置
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.READ_LOGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
注意:如果你也想使用Bugly升級功能,你必須要進(jìn)行2怜珍、3項的配置端蛆,而如果你只想使用熱更新能力,你只需要配置權(quán)限即可酥泛。
2. Activity配置
<activity
android:name="com.tencent.bugly.beta.ui.BetaActivity"
android:theme="@android:style/Theme.Translucent" />
3. 配置FileProvider
注意:如果您想兼容Android N或者以上的設(shè)備今豆,必須要在AndroidManifest.xml文件中配置FileProvider來訪問共享路徑的文件。如果你使用的第三方庫也配置了同樣的FileProvider柔袁,你需要將第三方庫配置的路徑copy到我們配置的provider_path文件下呆躲。
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.fileProvider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/provider_paths"/>
</provider>
${applicationId}請?zhí)鎿Q為您的包名,例如com.bugly.upgrade.demo捶索。這里要注意一下插掂,F(xiàn)ileProvider類是在support-v4包中的,檢查你的工程是否引入該類庫。
在res目錄新建xml文件夾辅甥,創(chuàng)建provider_paths.xml文件如下:
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<!-- /storage/emulated/0/Download/${applicationId}/.beta/apk-->
<external-path name="beta_external_path" path="Download/"/>
<!--/storage/emulated/0/Android/data/${applicationId}/files/apk/-->
<external-path name="beta_external_files_path" path="Android/data/"/>
</paths>
這里配置的兩個外部存儲路徑是升級SDK下載的文件可能存在的路徑酝润,一定要按照上面格式配置,不然可能會出現(xiàn)錯誤璃弄。
第五步:混淆配置 (沒有混淆的可以忽略)
為了避免混淆SDK要销,在Proguard混淆文件中增加以下配置:
-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}
如果你使用了support-v4包,你還需要配置以下混淆規(guī)則:
-keep class android.support.**{*;}
到這里差不多就結(jié)束了夏块,其實配置真的很繁瑣疏咐,都是Bugly幫我們簡化了很多地方了。
下面就是我們自己去實踐的時間了:
熱更新實踐