1. 程式人生 > >Android Bugly 熱修復 快速接入

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目錄下:
這裡寫圖片描述

上傳補丁包到平臺
這裡寫圖片描述
這裡寫圖片描述
這裡寫圖片描述

以下是官方地址以及文件: