Android Bugly 熱修復 快速接入
介紹
1、Bugly目前採用
2、Bugly已經搭建了管理後臺,對每個版本補丁進行管理。
3、實現自動下載補丁包、合成、並應用補丁。接入Bugly
1、新增外掛依賴,工程根目錄下“build.gradle”檔案中新增:
buildscript {
repositories {
jcenter()
}
dependencies {
// tinker gradle外掛
classpath ('com.tencent.tinker:tinker-patch-gradle-plugin:1.7.5')
// tinkersupport外掛
classpath "com.tencent.bugly:tinker-support:latest.release"
}
}
dependencies {
// 多dex配置
compile "com.android.support:multidex:1.0.1"
compile 'com.tencent.bugly:crashreport_upgrade:latest.release'//其中latest.release指代最新版本號,也可以指定明確的版本號,例如1.2.0
}
2、整合SDK gradle配置
在app module的“build.gradle”檔案中新增(示例配置):
3、在app module的“build.gradle”檔案中新增
apply plugin: 'com.tencent.bugly.tinker-support'
tinkerSupport {
// 開啟tinker-support外掛,預設值true
enable = true
// 是否編譯完成後,歸檔apk到指定目錄,預設值false
autoBackupApk = false
// 指定歸檔目錄,預設值當前module的子目錄tinker
// backupApkDir = 'tinker'
// 是否啟用覆蓋tinkerPatch配置功能,預設值false
// 開啟後tinkerPatch配置不生效,即無需新增tinkerPatch
overrideTinkerPatchConfiguration = true
// 編譯補丁包時,必需指定基線版本的apk,預設值為空
// 如果為空,則表示不是進行補丁包的編譯
// @{link tinkerPatch.oldApk }
baseApk = "YOUR_OLD_APK"
// 對應tinker外掛applyMapping
baseApkProguardMapping = "YOUR_OLD_APK_PROGUARD_FILE"
// 對應tinker外掛applyResourceMapping
baseApkResourceMapping = "YOUR_OLD_APK_RES_MAPPING"
tinkerId = "YOUR_TINKER_ID"
}
4、自定義Application
public class SampleApplication extends TinkerApplication {
public SampleApplication() {
super(ShareConstants.TINKER_ENABLE_ALL, "xxx.xxx.SampleApplicationLike",
"com.tencent.tinker.loader.TinkerLoader", false);
}
}
將定義的Application 配置進AndroidManifest.
5、自定義ApplicationLike
注:此自定義的ApplicationLike 就是前面第四部Application 建構函式中”xxx.xxx.SampleApplicationLike”
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, Resources[] resources,
ClassLoader[] classLoader, AssetManager[] assetManager) {
super(application, tinkerFlags, tinkerLoadVerifyFlag, applicationStartElapsedTime,
applicationStartMillisTime, tinkerResultIntent, resources, classLoader,
assetManager);
}
@Override
public void onCreate() {
super.onCreate();
// 這裡實現SDK初始化,appId替換成你的在Bugly平臺申請的appId
Bugly.init(getApplication(), "appid", true);
}
@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);
}
}
注: 以前所有在Application的實現必須要全部拷貝到這裡,在onCreate方法呼叫SDK的初始化方法,在onBaseContextAttached中呼叫Beta.installTinker(this);。
6、配置相關
許可權配置
<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"/>
Activity配置
<activity
android:name="com.tencent.bugly.beta.ui.BetaActivity"
android:theme="@android:style/Theme.Translucent" />
配置FileProvider(Android N之後配置)
<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}請替換為您的包名,例如com.bugly.upgrade.demo。這裡要注意一下,FileProvider類是在support-v4包中的,檢查你的工程是否引入該類庫。
在res目錄新建xml資料夾,建立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下載的檔案可能存在的路徑,一定要按照上面格式配置,不然可能會出現錯誤。
混淆配置
為了避免混淆SDK,在Proguard混淆檔案中增加以下配置:
-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}
如果你使用了support-v4包,你還需要配置以下混淆規則:
-keep class android.support.**{*;}
- 使用
1、編譯基準包
執行assembleRelease編譯生成基準包:
這個會在build/outputs/bakApk路徑下生成每次編譯的基準包、混淆配置檔案、資源Id檔案,如下圖所示:
啟動apk,上報聯網資料
我們每次冷啟動都會請求補丁策略,會上報當前版本號和tinkerId,這樣我們後臺就能將這個唯一的tinkerId對應到一個版本,大家測試的時候可以開啟logcat檢視我們的日誌,如下圖所示:
以上 是 基準包 也就是我們正常上線的包, 如果 遇到bug 需要釋出補丁包 需要單獨打出pacth 包。
修復完程式碼 執行構建補丁包的task
生成的補丁包在build/outputs/patch目錄下:
上傳補丁包到平臺
以下是官方地址以及文件: