1、enableProxyApplication = true

---

Bugly将通过反射的方式针对项目中自定义的Application动态生成新的Application，下图是源码中的AndroidManifest.xml和编译好的apk中的AndroidManifest.xml：

既然将enableProxyApplication的值设置为true，那接下来的重点就是完成Bugly的初始化工作了。需要在自定义的Application的onCreate()中进行Bugly的配置，在attachBaseContext()中进行Bugly的安装：

public class MyApplication extends Application {

private Context mContext;

@Override

public void onCreate() {

super.onCreate();

mContext = getApplicationContext();

// 这里实现SDK初始化，appId替换成你的在Bugly平台申请的appId

// 调试时，将第三个参数改为true

configTinker();

}

@Override

protected void attachBaseContext(Context base) {

super.attachBaseContext(base);

// you must install multiDex whatever tinker is installed!

MultiDex.install(mContext);

// 安装tinker

// 此接口仅用于反射Application方式接入。

Beta.installTinker();

}

}

注意：

1. Bugly的安装必须在attachBaseContext()方法中，否则将无法从Bugly服务器获取最新补丁。

2. tinker需要你开启MultiDex,你需要在dependencies中进行配置compile "com.android.support:multidex:1.0.1"才可以使用MultiDex.install方法。

最后在清单文件中，声明使用我们自定义的Application即可：

<application

android:name=“com.lqr.MyApplication”

…>

2、enableProxyApplication = false

---

这是Bugly推荐的方式，稳定性有保障（因为第1种方式使用的是反射，可能会存在不稳定的因素），它需要对Application进行改造，首先就是继承TinkerApplication，然后在默认的构造函数中，将第2个参数修改为你项目中的ApplicationLike继承类的全限定名称：

public class SampleApplication extends TinkerApplication {

public SampleApplication() {

super(ShareConstants.TINKER_ENABLE_ALL, “com.lqr.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”;

private Application mContext;

public SampleApplicationLike(Application application, int tinkerFlags,

boolean tinkerLoadVerifyFlag, long applicationStartElapsedTime,

long applicationStartMillisTime, Intent tinkerResultIntent) {

super(application, tinkerFlags, tinkerLoadVerifyFlag, applicationStartElapsedTime, applicationStartMillisTime, tinkerResultIntent);

}

@Override

public void onCreate() {

super.onCreate();

mContext = getApplication();

configTinker();

}

@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

Beta.installTinker(this);

}

@TargetApi(Build.VERSION_CODES.ICE_CREAM_SANDWICH)

public void registerActivityLifecycleCallback(Application.ActivityLifecycleCallbacks callbacks) {

getApplication().registerActivityLifecycleCallbacks(callbacks);

}

@Override

public void onTerminate() {

super.onTerminate();

Beta.unInit();

}

}

注意：

SampleApplicationLike这个类是Application的代理类，以前所有在Application的实现必须要全部拷贝到这里，在onCreate方法调用SDK的初始化方法，在onBaseContextAttached中调用Beta.installTinker(this)。

最后在清单文件中，声明改造好的Application（注意不是ApplicationLike）：

<application

android:name=“com.lqr.SampleApplication”

…>

3、配置Bugly

---

这是Bugly官方给出的配置，应有尽有，注释也很nice，请仔细看看，对项目的功能拓展与用户体验有帮助：

private void configTinker() {

// 设置是否开启热更新能力，默认为true

Beta.enableHotfix = true;

// 设置是否自动下载补丁，默认为true

Beta.canAutoDownloadPatch = true;

// 设置是否自动合成补丁，默认为true

Beta.canAutoPatch = true;

// 设置是否提示用户重启，默认为false

Beta.canNotifyUserRestart = true;

// 补丁回调接口

Beta.betaPatchListener = new BetaPatchListener() {

@Override

public void onPatchReceived(String patchFile) {

Toast.makeText(mContext, “补丁下载地址” + patchFile, Toast.LENGTH_SHORT).show();

}

@Override

public void onDownloadReceived(long savedLength, long totalLength) {

Toast.makeText(mContext,

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(mContext, “补丁下载成功”, Toast.LENGTH_SHORT).show();

}

@Override

public void onDownloadFailure(String msg) {

Toast.makeText(mContext, “补丁下载失败”, Toast.LENGTH_SHORT).show();

}

@Override

public void onApplySuccess(String msg) {

Toast.makeText(mContext, “补丁应用成功”, Toast.LENGTH_SHORT).show();

}

@Override

public void onApplyFailure(String msg) {

Toast.makeText(mContext, “补丁应用失败”, Toast.LENGTH_SHORT).show();

}

@Override

public void onPatchRollback() {

}

};

// 设置开发设备，默认为false，上传补丁如果下发范围指定为“开发设备”，需要调用此接口来标识开发设备

Bugly.setIsDevelopmentDevice(mContext, false);

// 多渠道需求塞入

// String channel = WalleChannelReader.getChannel(getApplication());

// Bugly.setAppChannel(getApplication(), channel);

// 这里实现SDK初始化，appId替换成你的在Bugly平台申请的appId

Bugly.init(mContext, “e9d0b7f57f”, true);

}

这里就用到了一开始获取到的App ID了，将其传入Bugly.init()方法的第二个参数，切记，用你自己的App ID。

其中如下两个方法很重要：

• Bugly.setIsDevelopmentDevice()

设置当前设备是不是开发设备，这跟Bugly上传补丁包时所选的"下发范围"有关。

• Bugly.init(context, appid, isDebug)

这个方法除了设置App ID外，还可以设置是否输出Log，可以观察到Bugly在App启动时做了哪些联网操作。

六、AndroidManifest.xml

=====================

1、 权限配置

---

2、Activity配置

---

<activity

android:name=“com.tencent.bugly.beta.ui.BetaActivity”

android:configChanges=“keyboardHidden|orientation|screenSize|locale”

android:theme="@android:style/Theme.Translucent"/>

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

如果你使用的第三方库也配置了同样的FileProvider, 可以通过继承FileProvider类来解决合并冲突的问题，示例如下：

<provider

android:name=".utils.BuglyFileProvider"

android:authorities="${applicationId}.fileProvider"

android:exported=“false”

android:grantUriPermissions=“true”

tools:replace=“name,authorities,exported,grantUriPermissions”>

<meta-data

android:name=“android.support.FILE_PROVIDER_PATHS”

android:resource="@xml/provider_paths"

tools:replace=“name,resource”/>

4、升级SDK下载路径配置

---

在res目录新建xml文件夹，创建provider_paths.xml文件如下：

<?xml version="1.0" encoding="utf-8"?>

注：1.3.1及以上版本，可以不用进行以上配置，aar已经在AndroidManifest配置了，并且包含了对应的资源文件。

七、混淆

====

Bugly混淆规则

-dontwarn com.tencent.bugly.**

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

避免影响升级功能，需要keep住support包的类

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

好了，集成完毕，接下来就是制作基准包、补丁包和上传补丁包了。

八、制作基准包

=======

在app编码完成并测试完成后，就是打包上线了，上线前打的包就是基准包啦，下面我们就来制作基准包，分3步：

1. 打开app下的tinker-support.gradle文件。

2. 将带"base"的tinkerId注释解开，并注释掉带"patch"的tinkerId。

3. 双击运行build下的assembleRelease。

通常主Module的名字是"app"，但我这个Demo是"tinker-bugly"，所以你执行第3步时，要根据具体项目找到要制作基准包的主Module。

AS在执行assembleRelease指令时，就是在编译基准包了，当编译完成时，app的build目录下会自动生成基准包文件夹，以时间戳来命名的（也就是说，每次执行assembleRelease指令都会在build目录创建不同的基准包文件夹）。

这3个文件对之后制作补丁包来说是相当重要的，你需要做的就是将这3个文件保存好，可以保存到云盘、Git服务器上等等，但就不要让它就这么放着，因为在你执行clean Project时，app的build目录会被删除，这样基准包及mapping与R文件都会丢失。

到这里，你就可以把它（基准包：tinker-bugly-release.apk）上架到应用市场了。试下Demo：

tip:加固与多渠道打包

---

本篇不涉及具体的加固与多渠道打包。

1、加固

如果你的app需要加固，那就需要在制作基准包之前，将tinker-support.gradle文件的isProtectedApp = true的注释去掉，然后加固，重新签名，最后上架，它对加固平台也有一定的要求。

详情见「Bugly热更新使用范例文档最后：加固打包」部分。

2、多渠道打包

分「gradle配置productFlavors方式」与「多渠道打包工具打多渠道包方式（推荐）」。

详情见「Bugly热更新使用范例文档：多渠道打包」部分。

九、补丁包

=====

现在要动态修复App了，对于代码修复、so库修复、资源文件修复，分别对应Demo中的"say something"、“get string from .so”、“我的头像”，修复过程无非是改代码，替换so文件，替换资源文件，这里就不演示了，直接开始制作补丁包，先将tinker-support.gradle文件打开。

1、基准包命名

---

确保基准包及相关文件的命名与配置文件中的一致：

2、修改baseApkDir与tinkerId

---

1. 修改baseApkDir的值为基准包所有文件夹的名字。

2. 注释掉带"base"的tinkerId，取消带"patch"的tinkerId的注释（多次生成补丁时，记得修改"计数"，区分不同的补丁）。

3、执行编译，生成补丁

---

打开侧边的Gradle标签，找到项目的主Module，双击tinker-support下的buildTinkerPatchRelease指令，生成补丁包。

当编译完成后，在app的build/outputs/patch目录下会在"patch_singed_7zip.apk"文件，它就是补丁包，双击打开它，可以看到其中有一个YAPATCH.MF，里面记录了基准包与补丁包的tinkerId（两者是肯定不同，如果一样则说明配置有问题了）。

十、上传补丁包

=======

1、流程图解

---

首先，点击进入「Bugly产品页面」，或点击“我的产品 ”查看我的产品。

点击你要管理的产品后，依次点击"应用升级"、“热更新”，可以查看到该产品的补丁下发情况（这个产品我还没上传过补丁，故一片空白）。

按下图顺序操作即可上传补丁包：

2、上传失败分析

---

有可能你在上传完补丁包时，页面会提示"未匹配到可应用补丁包的App版本，请确认补丁包的基线版本是否已经发布"。

遇到这种情况请先冷静，首先来说明一件事：Bugly怎么知道基线版本是否已经发布？

通常按我们理解的，基准包发布就是上架到应用市场，但应用市场又不会通知Bugly某某产品已经上架了，对吧。其实，Bugly的上架通知是这样的：当基准包在手机上启动时，Bugly框架就会让App联网通知Bugly的服务器，同时上传当前App的版本号、tinkerId等信息，它这么做的目的有如下两个：

• 标记某个tinkerId的基准包已经被安装到手机上使用了（即发布）。

• 获取该tinkerId的基准包最新的补丁信息。

所以，当出现了"未匹配到可应用补丁包的App版本，请确认补丁包的基线版本是否已经发布"这样的提示时，可以确定，这个基准包的tinkerId等信息没有被上传到Bugly服务器，对此，鄙人将踩过的坑总结起来，摸索出了自己的解决方法，分如下几步：

• 检查App是否能够联网。

• 检查App ID是否正确。

• 结合enableProxyApplication的取值，检查AndroidManifest.xml中声明的Application是否写对。

• 检查Bugly的安装是不是在attachBaseContext()或onBaseContextAttached()方法中完成。

像我就犯过这样的错，明明在tinker-support.gradle文件中设置了enableProxyApplication = true，结果在AndroidManifest.xml中却声明了TinkerApplication的继承类。

所以这里只需要将AndroidManifest.xml中声明我们自定义的Application即可（MyApplication）。

除了联网问题以外，其他的几种情况都需要重新生成基准包。这里再分享一个可以快速确定App是否有上传过版本信息的方法：

3、上传成功

---

先验证下上面的方法，当我把问题解决掉之后，把重新生成的基准包安装到手机上打开（此时Bugly框架会上传App的版本号、tinkerId到服务器），再查看"版本管理"，出现了，版本号为"1.0"（其实就是App的versionName）。

再回头来看看上传补丁，这次又会有什么不同呢？

耶，成功。点击"立即下发"，可以看到现在补丁处于"下发中"状态：

随便来看看用户手中的App是什么反应吧（真正将补丁下发到用户手机上的这段时间可能会有点久，不是立即下发的）：

再回头看看Bugly服务器上的补丁下发情况：

确定App是否有上传过版本信息的方法：

3、上传成功

---

先验证下上面的方法，当我把问题解决掉之后，把重新生成的基准包安装到手机上打开（此时Bugly框架会上传App的版本号、tinkerId到服务器），再查看"版本管理"，出现了，版本号为"1.0"（其实就是App的versionName）。

再回头来看看上传补丁，这次又会有什么不同呢？

耶，成功。点击"立即下发"，可以看到现在补丁处于"下发中"状态：

随便来看看用户手中的App是什么反应吧（真正将补丁下发到用户手机上的这段时间可能会有点久，不是立即下发的）：

再回头看看Bugly服务器上的补丁下发情况：