Android 热更新 Bugly(Tinker)接入

最近腾讯Bugly推出“热更新”服务，从异常上报延伸到应用升级，而它的应用升级中分为“全量更新”和“热更新”两个功能，可以方便有效的管理各个版本。热更新在一个项目中也是比较重要的，项目上线后总会遇到一些问题（Bug）如果每次都需要重新发版本，无疑是不合理的，也加大了成本，而热更新为解决开发者紧急修复线上bug，而无需重新发版让用户无感知就能把问题修复的一项能力。腾讯Bugly提供热更新和弹窗升级服务，选用Tinker热更新框架。一方面因为Tinker经历过微信数亿用户的验证，稳定、兼容性好；另一方面Tinker自研dxdiff算法，性能损耗低，应用成功率高。(你可以理解为封装好的第三方库)同时提供后台设置对app版本进行管理，相比于直接接入Tinker,我个人更推荐直接接入Bugly的应用升级SDK。

第一步：添加插件依赖

在project的“build.gradle”文件中添加

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.1.2'
        // tinkersupport插件，其中latest.release指代最新版本号，也可以指定明确的版本号，例如1.0.3
        classpath "com.tencent.bugly:tinker-support:latest.release"
    }
}

第二步：集成SDK

在app module的“build.gradle”文件中添加

dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:24.2.1'
    compile 'com.android.support:multidex:1.0.1'
    // 多dex配置
    compile 'com.tencent.bugly:crashreport_upgrade:latest.release'
    //其中latest.release指代最新版本号，也可以指定明确的版本号，例如1.2.1
    compile 'com.android.support:support-v4:24.1.1'

}
// 依赖插件脚本
apply from: 'tinker-support.gradle'

接着在同级目录下创建tinker-support.gradle文件(不会创建的看下面的Q3),添加以下内容

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

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

def appName = "app-0207-15-32-09"

/**
 * 对于插件各参数的详细解析请参考
 */
tinkerSupport {

    // 开启tinker-support插件，默认值true
    enable = true

    // 指定归档目录，默认值当前module的子目录tinker
    autoBackupApkDir = "${bakPath}"

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

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

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

    // 对应tinker插件applyResourceMapping
    baseApkResourceMapping = "${bakPath}/${appName}/app-release-R.txt"

    // 唯一标识当前版本 tinkerId最好是一个唯一标识，例如git版本号、versionName等等。 如果你要测试热更新，你需要对基线版本进行联网上报。
    //示例：1.0.1-base  1.0.1-patch
    tinkerId = "1.0.1-base"

    // 是否开启代理Application，设置之后无须改造Application，默认为false
    enableProxyApplication = false
}

第三步：初始化SDK

初次接触Tinker的朋友可能会在Application这里有点困惑，因为程序启动时会加载默认的Application类，这导致Tinker补丁包是无法对它做修改了，Tinker为了使真正的Application实现可以在补丁包中修改，把Appliction类的所有逻辑移动到ApplicationLike代理类中。

情况一：enableProxyApplication = false

自定义Application：

public class SampleApplication extends TinkerApplication {
    public SampleApplication() {
        super(ShareConstants.TINKER_ENABLE_ALL, "xxx.xxx.SampleApplicationLike",
                "com.tencent.tinker.loader.TinkerLoader", false);
    }
}

注意： 这个类集成TinkerApplication类，这里面不做任何操作，所有Application的代码都会放到ApplicationLike继承类当中
参数解析
参数1：tinkerFlags 表示Tinker支持的类型 dex only、library only or all suuport，default: TINKER_ENABLE_ALL
参数2：delegateClassName Application代理类 这里填写你自定义的ApplicationLike
参数3：loaderClassName Tinker的加载器，使用默认即可
参数4：tinkerLoadVerifyFlag 加载dex或者lib是否验证md5，默认为false

自定义ApplicationLike：

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(), "900029763", 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);
    }

}

注意：tinker需要你开启MultiDex,你需要在dependencies中进行配置compile "com.android.support:multidex:1.0.1"才可以使用MultiDex.install方法； SampleApplicationLike这个类是Application的代理类，以前所有在Application的实现必须要全部拷贝到这里，在onCreate方法调用SDK的初始化方法，在onBaseContextAttached中调用Beta.installTinker(this);。

情况二：enableProxyApplication = true

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
        // 这里实现SDK初始化，appId替换成你的在Bugly平台申请的appId
        Bugly.init(this, "900029763", true);
    }

    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);

        // 安装tinker
        Beta.installTinker();
    }

}

统一初始化方法

 Bugly.init(getApplicationContext(), "注册时申请的APPID", false);

第四步：AndroidManifest.xml配置

1.权限配置

<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"/>

注意：如果你也想使用升级功能，你必须要进行2、3项的配置，而如果你只想使用热更新能力，你只需要配置权限即可。

2.Activity配置

<activity
    android:name="com.tencent.bugly.beta.ui.BetaActivity"
    android:theme="@android:style/Theme.Translucent" />

3.配置FileProvider（Android N之后配置）

注意：如果您想兼容Android N或者以上的设备，必须要在AndroidManifest.xml文件中配置FileProvider来访问共享路径的文件。

<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，在Proguard混淆文件中增加以下配置：

-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}

如果你使用了support-v4包，你还需要配置以下混淆规则：


-keep class android.support.**{*;}

至此Bugly的热更新便接入完毕，那么怎么使用呢？

热更新使用详解 - Bugly 文档

下面说一下接入过程中遇到的一些问题和大家可能会卡主的地方

Q1:配置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>

这里<provider></provider>要放在<application></application>中， android:resource = "@xml/provider_paths"，先在res那新建资源文件目录xml,再在里面新建provider_paths.xml文件。

Q2:Caused by: com.tencent.tinker.loader.TinkerRuntimeException: Tinker Exception:createDelegate failed

好像许多人运行后会出现这个Exception，我就是多了个“空格”，把它去掉就行了，也就是说大家看一下是不是这个ApplicationLike的路径有问题

Q3:tinker-support.gradle

官方接入文档说要在app：module的build.gradle文件同级目录下新建一个tinker-support.gradle文件，我表示不会在Android studio新建,有谁知道的记得告诉我。我是直接在外面文档那里复制build.gradle文件然后把文件名改成tinker-support.gradle,进去在把内容改一下Android studio就会显示出来。附上目录：C:\Users\admin\Desktop\Buglyincrementalupdate\app

总结

1.无论是Bugly的热更新还是Tinker，两个所做的都是“偷偷”的修改Bug,用户并不知道应用已修改过，并不是我们所想象的增量更新。

2.如果你决定用这个的话每次发版本的时候一定要记住基线包是哪一个还有这个基线包的tinkerid,否则有可能达不到你要的效果。

3.如果在开发过程你不想在bakapk文件夹中，生成一堆apk那么你就要在app:moudle的build.gradle文件中把插件的依赖注释掉，我本来以为把enable改为false就是行了，可是该能之后运行回报tinkerid为null。

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

Demo下载