Android 腾讯Bugly使用（异常上报，全量升级，热更新）

1.0.1腾讯Bugly使用（异常上报，全量升级，热更新）

说明

Bugly全量升级，热更新以及异常上报是一起集成的，还包括运营统计，本文档着重演示热更新功能。

接入步骤

1.在Project的build.gradle中加入依赖

dependencies {
    classpath 'com.android.tools.build:gradle:3.4.0'
    classpath "com.tencent.bugly:tinker-support:1.1.5"
    
    // NOTE: Do not place your application dependencies here; they belong
    // in the individual module build.gradle files
}

2.在app的build.gradle中加入依赖

dependencies {
    implementation "com.android.support:multidex:1.0.3" // 多dex配置
    //注释掉原有bugly的仓库
    //compile 'com.tencent.bugly:crashreport:latest.release'//其中latest.release指代最新版本号，也可以指定明确的版本号，例如1.3.4
    implementation 'com.tencent.bugly:crashreport_upgrade:1.3.9'
    // 指定tinker依赖版本（注：应用升级1.3.5版本起，不再内置tinker）
    implementation 'com.tencent.tinker:tinker-android-lib:1.9.9'
    implementation 'com.tencent.bugly:nativecrashreport:3.6.0.1' //其中latest.release指代最新版本号，也可以指定明确的版本号，例如2.2.0


}

其中必须配置多dex的依赖包“implementation “com.android.support:multidex:1.0.3” ”

3.在app的build.gradle中配置支持的so库架构

defaultConfig {
    ndk {
        //设置支持的SO库架构
        abiFilters 'armeabi' , 'x86'// ,'armeabi-v7a', 'x86_64', 'arm64-v8a'
    }
}

4.在app的build.gradle同级目录创建tinker-support.gradle文件

apply plugin: 'com.tencent.bugly.tinker-support'

def bakPath = file("${buildDir}/bakApk/")

/**
 * 此处填写每次构建生成的基准包目录
 */
def baseApkDir = "app-0425-09-38-27"

/**
 * 对于插件各参数的详细解析请参考，如果没有特殊需求下面的参数都可以不用更改；如果apk需要加固等可以参考具体描述设置参数
 */
tinkerSupport {

    // 开启tinker-support插件，默认值true
    enable = true
    // 指定归档目录，默认值当前module的子目录tinker
    autoBackupApkDir = "${bakPath}"
    //建议设置true,用户就不用再自己管理tinkerId的命名,插件会为每一次构建的base包自动生成唯一的tinkerId，默认命名规则是versionname.versioncode_时间戳
    //具体参考https://github.com/BuglyDevTeam/Bugly-Android-Demo/wiki/Tinker-ID%E8%AF%A5%E6%80%8E%E4%B9%88%E8%AE%BE%E7%BD%AE
    autoGenerateTinkerId = true
    //tinkerId必须保证唯一性，如果两个base包的tinkerid是一样的，并且都联网激活了，那么后续补丁上传到后台的时候会出现匹配错误
    tinkerId = "if autoGenerateTinkerId=true ,no need set here"

    // 是否启用覆盖tinkerPatch配置功能，默认值false
    // 开启后tinkerPatch配置不生效，即无需添加tinkerPatch
    overrideTinkerPatchConfiguration = true

    // 编译补丁包时，必需指定基线版本的apk，默认值为空
    // 如果为空，则表示不是进行补丁包的编译
    // @{link tinkerPatch.oldApk }
    baseApk =  "${bakPath}/${baseApkDir}/app-release.apk"

    // 对应tinker插件applyMapping
    baseApkProguardMapping = "${bakPath}/${baseApkDir}/app-release-mapping.txt"

    // 对应tinker插件applyResourceMapping
    baseApkResourceMapping = "${bakPath}/${baseApkDir}/app-release-R.txt"
    /*baseApk =  "${bakPath}/${baseApkDir}/app-debug.apk"

    // 对应tinker插件applyMapping
    baseApkProguardMapping = "${bakPath}/${baseApkDir}/app-debug-mapping.txt"

    // 对应tinker插件applyResourceMapping
    baseApkResourceMapping = "${bakPath}/${baseApkDir}/app-debug-R.txt"*/

//    buildAllFlavorsDir = "${bakPath}/${baseApkDir}"
    // 是否开启加固模式，默认为false
    isProtectedApp = true

    enableProxyApplication = true

    supportHotplugComponent = true

}

/**
 * 一般来说,我们无需对下面的参数做任何的修改
 * 对于各参数的详细介绍请参考:
 * 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-patch"
        //applyMapping = "${bakPath}/${appName}/app-release-mapping.txt" //  可选，设置mapping文件，建议保持旧apk的proguard混淆方式
        //applyResourceMapping = "${bakPath}/${appName}/app-release-R.txt" // 可选，设置R.txt文件，通过旧apk文件保持ResId的分配
    }
}

重点配置：def baseApkDir = “app-0425-09-38-27”

此处是定义基准包目录，每次打出基准包时都会创建一个新的目录，位于：项目\app\build\bakApk

后期生成热修复补丁都需要将此目录更改为需要修复的基准包目录。

**tinkerId：**由于设置了自动创建tinkerid（autoGenerateTinkerId），所以此处tinkerId不需要自行设置。

---

5.在app的build.gradle配置依赖插件脚本

apply plugin: 'com.android.application'
// 依赖插件脚本
apply from: 'tinker-support.gradle'

6.自定义Application

package com.zeoy92.tinkerdemo;

import android.app.Application;
import android.content.Context;
import android.support.multidex.MultiDex;
import android.widget.Toast;

import com.tencent.bugly.Bugly;
import com.tencent.bugly.beta.Beta;
import com.tencent.bugly.beta.interfaces.BetaPatchListener;

import java.util.Locale;

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        Beta.canAutoDownloadPatch = true;
        Beta.canAutoPatch = true;
        Beta.canNotifyUserRestart = true;
        Beta.betaPatchListener = new BetaPatchListener() {
            @Override
            public void onPatchReceived(String patchFile) {
                Toast.makeText(getApplicationContext(), "补丁下载地址" + patchFile, Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onDownloadReceived(long savedLength, long totalLength) {
                Toast.makeText(getApplicationContext(),
                        String.format(Locale.getDefault(), "%s %d%%",
                                Beta.strNotificationDownloading,
                                (int) (totalLength == 0 ? 0 : savedLength * 100 / totalLength)),
                        Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onDownloadSuccess(String msg) {
                Toast.makeText(getApplicationContext(), "补丁下载成功", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onDownloadFailure(String msg) {
                Toast.makeText(getApplicationContext(), "补丁下载失败", Toast.LENGTH_SHORT).show();

            }

            @Override
            public void onApplySuccess(String msg) {
                Toast.makeText(getApplicationContext(), "补丁应用成功", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onApplyFailure(String msg) {
                Toast.makeText(getApplicationContext(), "补丁应用失败", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onPatchRollback() {
                Toast.makeText(getApplicationContext(), "补丁回滚", Toast.LENGTH_SHORT).show();
            }
        };
        //bugly初始化，第二个参数填写在bugly后台生成的项目id
        Bugly.init(this,"9f3976fc55",false);

    }

    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        MultiDex.install(base);
        Beta.installTinker();


    }

    @Override
    public void onTerminate() {
        super.onTerminate();
        Beta.unInit();
    }
}

7.配置MndroidManifest权限

<!--Bugly权限开始-->
<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.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
<!--Bugly权限结束-->

REQUEST_INSTALL_PACKAGES是全量升级需要的apk安装权限，如果单独只使用热更新则不需要此权限

8.配置MndroidManifest&provider兼容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>

9.注册Bugly基础Activity

<activity
    android:name="com.tencent.bugly.beta.ui.BetaActivity"
    android:configChanges="keyboardHidden|orientation|screenSize|locale"
    android:theme="@android:style/Theme.Translucent" />

10.兼容Android P 网络配置

1.res目录下新建xml文件夹

2.创建network_security_config.xml文件

<?xml version="1.0" encoding="utf-8"?>
<network-security-config xmlns:android="http://schemas.android.com/apk/res/android">
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">android.bugly.qq.com</domain>
    </domain-config>
</network-security-config>

3.AndroidManifest&application标签中设置网络配置

android:networkSecurityConfig="@xml/network_security_config"

11.基本配置完成

---

生成基础包

tinker支持gradle代码，点击侧边gradle图标，找到assembleRelease双击即可生成基准包（用于更新到应用市场或发布等等）

注意：

1.基准包的生成目录位于：项目/app/build/bakApk/app-???-??-??-??目录下，可在run窗口看到详细的地址

（此基准包目录最好做个备份，因为此版本的热更新补丁都是基于此基准包生成的）

2.assembleRelease不一定在ohter目录下面，也可能在build目录下

生成补丁包（热更新包）

1.配置基准包目录

修改tinker-support.gradle中定义的baseApkDir

/**
 * 此处填写每次构建生成的基准包目录
 */
def baseApkDir = "app-0425-09-38-27"

2.生成热更新补丁包

点击侧边gradle图标，找到buildTinkerPatchRelease双击即可生成该基准包对应的补丁包。

3.发布补丁包

Bugly后台-》应用升级-》热更新-》发布新补丁

上传：项目\app\build\outputs\patch\目录下的7zip安装包

4.注意

补丁包上传后，并不是立即生效，分发时间大概是10分钟到30分钟不等。

---

其他注意事项

1.应用加固

1.如果应用需要加固，需要开启tinker-support.gradle中isProtectedApp

例如：

// 是否开启加固模式，默认为false
isProtectedApp = true

直接加固基准包，并对加固后的包签名，加固客户端一般自动签名了，无需手动再签名。

2.生成补丁包时，需要使用未加固的基准包。

2.应用全量升级

1.相对于热更新，需要配置安装apk权限

2.直接调用

Beta.checkUpgrade(true,true);
//Beta.checkUpgrade();

即可检查更新

3.更多高级配置

[Bugly Android 应用升级 SDK 高级配置](https://bugly.qq.com/docs/user-guide/advance-features-android-beta/?v=20180709165613）

4.应用升级也不是实时升级的，发布过后10-30分钟左右下发成功。