bugly热修复集成及遇到的问题

bugly热修复集成

Bugly热修复官方网址点这里

Tinker官方github网址点这里

以下为官方文档的整理，遇到问题的同学可以直接翻到最下面遇到的问题

第一步：添加插件依赖

工程根目录下“build.gradle”文件中添加：

    repositories {

        jcenter()

    }

    dependencies {

        // tinkersupport插件, 其中lastest.release指拉取最新版本，也可以指定明确版本号，例如1.0.4

        classpath "com.tencent.bugly:tinker-support:1.1.2"

    }

}

第二步：集成SDK

gradle配置

1. 在app module的“build.gradle”文件中添加（示例配置）：

android {

        defaultConfig {

          ndk {

            //设置支持的SO库架构

            abiFilters 'armeabi' //, 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a'

          }

        }

      }

      dependencies {

          implementation "com.android.support:multidex:1.0.1" // 多dex配置

          implementation 'com.tencent.bugly:crashreport_upgrade:1.3.5'

          implementation 'com.tencent.tinker:tinker-android-lib:1.9.6'

          implementation 'com.tencent.bugly:nativecrashreport:latest.release' 
      }

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

// 依赖插件脚本

apply from: 'tinker-support.gradle'

3\. tinker-support.gradle内容如下所示（示例配置）：

注：您需要在同级目录下创建tinker-support.gradle这个文件哦。

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

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

def baseApkDir = "app-0208-15-10-00"

/**

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

*/

tinkerSupport {

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

    enable = true

    // 指定归档目录，默认值当前module的子目录tinker

    autoBackupApkDir = "${bakPath}"

    // 是否启用覆盖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"

    // 构建基准包和补丁包都要指定不同的tinkerId，并且必须保证唯一性

    tinkerId = "base-1.0.1"

    // 构建多渠道补丁时使用

    // buildAllFlavorsDir = "${bakPath}/${baseApkDir}"

    // 是否启用加固模式，默认为false.(tinker-spport 1.0.7起支持）

    // isProtectedApp = true

    // 是否开启反射Application模式

    enableProxyApplication = false

    // 是否支持新增非export的Activity（注意：设置为true才能修改AndroidManifest文件）

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

        //applyMapping = "${bakPath}/${appName}/app-release-mapping.txt" //  可选，设置mapping文件，建议保持旧apk的proguard混淆方式

        //applyResourceMapping = "${bakPath}/${appName}/app-release-R.txt" // 可选，设置R.txt文件，通过旧apk文件保持ResId的分配

    }

}

第三步：初始化SDK

1. enableProxyApplication = false 的情况

这是Tinker推荐的接入方式，一定程度上会增加接入成本，但具有更好的兼容性。

集成Bugly升级SDK之后，我们需要按照以下方式自定义ApplicationLike来实现Application的代码（以下是示例）：

自定义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

我们需要您将以前的Applicaton配置为继承TinkerApplication的类：

自定义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) {

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

    }

    @Override

    public void onCreate() {

        super.onCreate();

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

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

        Bugly.init(getApplication(), "900029763", false);

    }

    @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);。

2. enableProxyApplication = true 的情况

public class MyApplication extends Application {

    @Override

    public void onCreate() {

        super.onCreate();

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

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

        Bugly.init(this, "900029763", false);

    }

    @Override

    protected void attachBaseContext(Context base) {

        super.attachBaseContext(base);

        // you must install multiDex whatever tinker is installed!

        MultiDex.install(base);

        // 安装tinker

        Beta.installTinker();

    }

}

注：无须你改造Application，主要是为了降低接入成本，我们插件会动态替换AndroidMinifest文件中的Application为我们定义好用于反射真实Application的类（需要您接入SDK 1.2.2版本 和 插件版本 1.0.3以上）。

第四步：AndroidManifest.xml配置

在AndroidMainfest.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" />

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

注意：如果您想兼容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>

如果你使用的第三方库也配置了同样的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"/>

</provider>

这里要注意一下，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下载的文件可能存在的路径，一定要按照上面格式配置，不然可能会出现错误。

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

第五步：混淆配置

为了避免混淆SDK，在Proguard混淆文件中增加以下配置：

-dontwarn com.tencent.bugly.**

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

# tinker混淆规则

-dontwarn com.tencent.tinker.**

-keep class com.tencent.tinker.** { *; }

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

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

第六步： 注意事项

除了官方的FAQ以外还遇到一下问题：

  • Q： ERROR: Java 8 language support, as requested by 'android.enableD8.des...

    A: gradle.properties中添加

# Project-wide Gradle settings.

# IDE (e.g. Android Studio) users:

# Gradle settings configured through the IDE *will override*

# any settings specified in this file.

# For more details on how to configure your build environment visit

# http://www.gradle.org/docs/current/userguide/build_environment.html

# Specifies the JVM arguments used for the daemon process.

# The setting is particularly useful for tweaking memory settings.

org.gradle.jvmargs=-Xmx1536m

# When configured, Gradle will run in incubating parallel mode.

# This option should only be used with decoupled projects. More details, visit

# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects

# org.gradle.parallel=true

# 添加如下两行可正常编译，有警告不影响运行

android.enableD8.desugaring = true

android.useDexArchive = true

  • Q: IDE 找不到DefaultApplicationLike，报错

    A: import中删除原来的引入，重新导入，由于升级换包名导致的问题

  • Q: 打出的基线版本后，上传bugly的升级补丁报红，找不到对应基线版本

    A：:在tinker-support.gradle中的tinkerid配置的基线版本需要先启动

若还无法解决，则需要检查代码，apk包中的AndroidManifest.xml中最下面的tinker_id是否能对应上，具体生成基线版本和对应补丁以及上传补丁的步骤请参考官方文档说明

  • Q: 补丁包可下载并合并，但重启时候报异常无法启动一直停留在LaunchActivity或HomeActivity：

并报异常java.lang.VerifyError: Verifier rejected class。

A: bugly封装的tinker在tinker-support.gradle中配置enableProxyApplication = false情况下会使用ApplicationLike实现代替原有Application的功能，所以按照官方文档指导，把原来在application中实现的方法全部移动到自己定义的ApplicationLike中，由于涉及到改动太大，所以项目中未采用，使用的是enableProxyApplication = true

  • Q：在小米设备上出现无法下载补丁，Exception in run JobService类似日志

    A: 需要在设置中开启app自启动即可下载补丁

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 216,997评论 6赞 502
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 92,603评论 3赞 392
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 163,359评论 0赞 353
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 58,309评论 1赞 292
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 67,346评论 6赞 390
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 51,258评论 1赞 300
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 40,122评论 3赞 418
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 38,970评论 0赞 275
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 45,403评论 1赞 313
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,596评论 3赞 334
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,769评论 1赞 348
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 35,464评论 5赞 344
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 41,075评论 3赞 327
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,705评论 0赞 22
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,848评论 1赞 269
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 47,831评论 2赞 370
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 44,678评论 2赞 354