热更新-Bugly-Tinker使用详解

Bugly热更新是基于Tinker使用的。

为什么使用Bugly呢，因为他目前还没有收费。

费话不多说了，言归正传

使用教程，跟着步骤一步一步教你集成

gradle集成方式

1、添加依赖

compile 'com.tencent.bugly:crashreport_upgrade:1.3.3'//版本号可替换为latest.release表示最新版本

compile 'com.android.support:multidex:1.0.2'//这是谷歌官方提供的分包插件，必须依赖

注意：Bugly的bug跟踪功能同样有。

2、添加Bugly插件

在项目的gradle中添加插件，位置如下：

classpath 'com.tencent.bugly:tinker-support:1.1.0'

3、添加tinker的gradle配置，名称：tinker-support.gradle（名字可自定义），将下面的内容复制粘贴即可，如下：

重要的东西写在前面：下面的bakPath路径可自定义，打正式包或者debug都会在此路径下生成一些信息（自己一看便知）

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

def bakPath = file("D:/Tinker/bakApk/")//这里是配置的路径

/**
 * 此处填写每次构建生成的基准包目录
 */
def baseApkDir = "app-0102-10-00-23"

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

    // 开启tinker-support插件，默认值true
    enable = true
    // tinkerEnable功能开关
    tinkerEnable = true
    // 自动生成tinkerId, 你无须关注tinkerId，默认为false
    autoGenerateTinkerId = true

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

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

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

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

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

    // 构建基准包跟补丁包都要修改tinkerId，主要用于区分
    tinkerId = "1.0.3.18010210-base"

    // 打多渠道补丁时指定目录
    // buildAllFlavorsDir = "${bakPath}/${baseApkDir}"

    // 是否使用加固模式，默认为false
    // isProtectedApp = true

    // 是否采用反射Application的方式集成，无须改造Application
    enableProxyApplication = true

    // 支持新增Activity
    supportHotplugComponent = true

}

/**
 * 一般来说,我们无需对下面的参数做任何的修改
 * 对于各参数的详细介绍请参考:
 * https://github.com/Tencent/tinker/wiki/Tinker-%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97
 */
tinkerPatch {
    tinkerEnable = true
    ignoreWarning = false
    useSign = false
    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 = "D:/Tinker/path"
    }
    buildConfig {
        keepDexApply = false
//      tinkerId = "base-2.0.1"
    }
}

4、将刚刚新建的gradle配置放进主model-app中，如下：

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

5、新建一个补丁的存储路径，待会儿会在manifest中配置，放在model中没试过，试过了再更新，如下：

xml version="1.0" encoding="utf-8"?>
xmlns:android="http://schemas.android.com/apk/res/android">
    
    name="beta_external_path" path="Download/"/>
    
    name="beta_external_files_path" path="Android/data/"/>

6、必不可少的manifest配置，如下：

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

    android:name="android.support.v4.content.FileProvider"
    android:authorities="org.chriszou.redpackthelper.fileProvider"
    android:exported="false"
    android:grantUriPermissions="true">
            android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/provider_paths" />

注意：这一步需要注意fileProvider的 authorities配置，规则为：包名+“.fileProvider”。包名此处可更新为唯一的标识 

7、这是最后一步啦，在Application中初始化Bugly，我是自己封装的Application，需要自己改下继承，比如继承Application，如下：

package org.chris.quick.b;

import android.annotation.TargetApi;
import android.content.Context;
import android.os.StrictMode;
import android.widget.Toast;

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

import org.chris.quick.m.Log;

import java.util.Locale;

/**
 * Created by zoulx on 2017/11/20.
 */

public class BaseTinkerApplication extends BaseApplication {
    private static final String TAG = "BaseTinkerApplication";
    @Override
    public void onInit() {
        setStrictMode();
    }
    @Override
    public void initBuggly() {
        // 设置是否开启热更新能力，默认为true
        Beta.enableHotfix = true;
        // 设置是否自动下载补丁
        Beta.canAutoDownloadPatch = true;
        // 设置是否提示用户重启
        Beta.canNotifyUserRestart = true;
        // 设置是否自动合成补丁
        Beta.canAutoPatch = true;

        /**
         *  全量升级状态回调
         */
        Beta.upgradeStateListener = new UpgradeStateListener() {
            @Override
            public void onUpgradeFailed(boolean b) {

            }

            @Override
            public void onUpgradeSuccess(boolean b) {

            }

            @Override
            public void onUpgradeNoVersion(boolean b) {
                Toast.makeText(getApplicationContext(), "最新版本", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onUpgrading(boolean b) {
                Toast.makeText(getApplicationContext(), "onUpgrading", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onDownloadCompleted(boolean b) {

            }
        };

        /**
         * 补丁回调接口，可以监听补丁接收、下载、合成的回调
         */
        Beta.betaPatchListener = new BetaPatchListener() {
            @Override
            public void onPatchReceived(String patchFileUrl) {
                Toast.makeText(getApplicationContext(), patchFileUrl, 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 patchFilePath) {
                Toast.makeText(getApplicationContext(), patchFilePath, Toast.LENGTH_SHORT).show();
//                Beta.applyDownloadedPatch();
            }

            @Override
            public void onDownloadFailure(String msg) {
                Toast.makeText(getApplicationContext(), msg, Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onApplySuccess(String msg) {
                Toast.makeText(getApplicationContext(), msg, Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onApplyFailure(String msg) {
                Toast.makeText(getApplicationContext(), msg, Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onPatchRollback() {
                Toast.makeText(getApplicationContext(), "onPatchRollback", Toast.LENGTH_SHORT).show();
            }
        };

        long start = System.currentTimeMillis();
        // 这里实现SDK初始化，appId替换成你的在Bugly平台申请的appId,调试时将第三个参数设置为true
        Bugly.init(this, getBugglyAppId(), true);
        long end = System.currentTimeMillis();
        Log.e("init time--->", end - start + "ms");
    }



    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        //MultiDex.install(base);//此处需要初始化分包，一定要在Bugly之前
        // 安装tinker
        Beta.installTinker();
    }


    @TargetApi(9)
    protected void setStrictMode() {
        StrictMode.setThreadPolicy(new StrictMode.ThreadPolicy.Builder().permitAll().build());
        StrictMode.setVmPolicy(new StrictMode.VmPolicy.Builder().detectAll().penaltyLog().build());
    }
}

注意：将自己的bugly ID填入初始化就可以了，这样子热更新与Bug跟踪都能正常使用

8、最后是混淆忽略啦

# Bugly混淆规则
-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}

# 避免影响升级功能，需要keep住support包的类
-keep class android.support.**{*;}

完成以上8步那么就将Bugly集成完毕了。

-------------------------------------------------------我是分割线----------------------------------------------------------------

集成完了，是不是要使用呢？集成So easy，但是我在使用过程中，遇到坑呀，搞死个人呢。

下面是使用步骤

1、准备有问题的包。

先打个正式包，如果是自己用其他渠道打包，可以忽略这一步，如下：

打完了之后就可以在刚才配置的路径下检查是否有东西哟（三个文件），会根据当前时间生成文件夹，如下：

注意：我是打的正式包，所以是release，如果是debug包，那名称就是debug样子的。

2、修复有问题的包，将刚刚打的包路径"app-0108-12-18-26"，填入bugly配置gradle中，并将tinkerId改为1.0.3.18010120-patch，如下：

注意：如果是Debug方式打的包，需要修改下面的baseApk、baseApkProguardMapping、baseApkResourceMapping的文件名称为路径下面的debug名称即可

    baseApk = "${bakPath}/${baseApkDir}/app-release.apk"
//    baseApk =  "${bakPath}/${baseApkDir}/app-debug.apk"

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

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

3、上面两步都完成了之后，就开始打补丁了。

我们之前是打的正式包，所以这里选择就是正式补丁，不然会报错。如下：

4、补丁打好了，会在build文件夹输出，如下：

4、补丁打好了，那么就剩下最后一步了，将patch_signed_7zip.apk上传至bugly平台即可，去bugly平台上传就行了。

注意：上传时会要求启动基线包，意思就是把刚刚有问题的包，装在手机上面启动一下，一次即可，如果上传还是提示找不到基本包，那就多启动几次就行啦。如果反复试都不行，就得检查环境是否集成成功了。重头再检查一下是否步骤操作完成了。

到此bugly热更新就结束了。

最后附上官方的教程：bugly官方热更新文档