Bugly热更新集成及踩坑

目录

第一步:添加插件依赖

第二步:集成SDK

第三步:初始化SDK

enableProxyApplication = true 的情况

第四步:AndroidManifest.xml配置

第五步:混淆配置

第六步: 在Project Structure中的app中添加签名信息。

第七步 :生成基准包,打包上传。

第八步 :生成patch包,打包上传。

问题汇总:

1、 基线包在版本发现 中总是没有,造成上传patch包失败

3.No such property: variantConfiguration for class: m.android.build.gradle.internal.variant.Applicat

4.打包APK报错Execution failed for task ':app:mergeReleaseResources

5.generation. File was preprocessed as vector drawable support was addedin Android 5.0 (API level 21) See

6.androidX 在AndroidMainfest里面加入provider后编译不通过

7.Caused by: com.tencent.tinker.android.dex.DexException: Unexpected magic: [100, 101, 120, 10, 48, 51, 55, 0]

8.Apk打包时发生Execution failed for task ':app:lintVitalRelease'.

9.tryLoadPatchFiles:patch dir not exist:/data/user/0/com.morse.yindexfix/tinker

首先Bugly注册登陆,新建产品获取App ID, 后面配置信息要用。

第一步:添加插件依赖

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

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        // tinkersupport插件, 其中lastest.release指拉取最新版本,也可以指定明确版本号,例如1.0.4
        classpath "com.tencent.bugly:tinker-support:1.1.5"
    }
}

第二步:集成SDK

gradle配置

在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配置
            //注释掉原有bugly的仓库
        //implementation 'com.tencent.bugly:crashreport:latest.release'//其中latest.release指代最新版本号,也可以    指定明确的版本号,例如1.3.4
            implementation 'com.tencent.bugly:crashreport_upgrade:1.5.0'
        // 指定tinker依赖版本(注:应用升级1.3.5版本起,不再内置tinker)
        implementation 'com.tencent.tinker:tinker-android-lib:1.9.9'
            implementation 'com.tencent.bugly:nativecrashreport:latest.release' //其中latest.release指代最新版本号,也可以指定明确的版
      }

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

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

tinker-support.gradle内容如下所示(示例配置):

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


下面对以上从tinker-support.gradle文件中摘录的比较重要的代码(很多会涉及到参数修改)作以解释:

def bakPath = file("${buildDir}/bakApk/")是基包生成路径
def baseApkDir = "app-0224-16-53-06"是基包文件夹,当你需要基于某个基包生成补丁包时,此参数用于确定你要基于哪个基包生成补丁包
def patchTinkerId="patch_1.0.1_3"和def baseTinkerId="base_1.0.1_3"分别表示基包和补丁包的tinkerId,值要是唯一的,当你需要自定义基包或者patch包的tinkerId时才会用到
autoGenerateTinkerId = true是否自动生成基包和patch包的tinkerId,一般设置为true,即采用系统生成的tinkerId,只有设置为false时,上面的def patchTinkerId和def baseTinkerId赋值的tinkerId才会生效
baseApk = "${bakPath}/${baseApkDir}/app-release.apk",baseApkProguardMapping = "${bakPath}/${baseApkDir}/app-release-mapping.txt"和baseApkResourceMapping = "${bakPath}/${baseApkDir}/app-release-R.txt"分别对应的是生成的基包的apk,Mapping和R文件全路径。

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

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

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

//补丁包的tinkerId
def patchTinkerId="patch_1.0.1_3"
//基包的tinkerId
def baseTinkerId="base_1.0.1_3"

/**
 * 对于插件各参数的详细解析请参考,如果没有特殊需求下面的参数都可以不用更改;如果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是一样的,并且都联网激活了,那么后续补丁上传到后台的时候会出现匹配错误
    //if autoGenerateTinkerId=true ,no need set here
    tinkerId = "${patchTinkerId}"

//    tinkerId = "${baseTinkerId}"


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

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

    enableProxyApplication = false

    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-debug.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-debug-mapping.txt" //  可选,设置mapping文件,建议保持旧apk的proguard混淆方式
        //applyResourceMapping = "${bakPath}/${appName}/app-debug-R.txt" // 可选,设置R.txt文件,通过旧apk文件保持ResId的分配
    }
}

注意将enableProxyApplication = false  改为true。

第三步:初始化SDK

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中添加MyApplication 信息。

第四步: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" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

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来访问共享路径的文件。

  • 配置FileProvider
    如果您想兼容Android N或者以上的设备,必须要在AndroidManifest.xml文件中配置FileProvider来访问共享路径的文件。 这里要注意一下,FileProvider类是在support-v4或androidx包中的,检查你的工程是否引入该类库。
<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="你的应用包名.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.**{*;}

第六步: 在Project Structure中的app中添加签名信息。

这时会在工程的build.gradle android中添加签名 信息。如下所示:

然后在 

buildTypes的release中添加 配置。  signingConfig signingConfigs.release

更改MyApplication中的第二个参数appid为 自己申请的产品appid。Bugl.init(this, "607f148f70", false);

第七步 :生成基准包,打包上传。

build->Generate Signed Bundle or APK

 

会在bakApk目录下生成基准值包。

 先安装到手机并联网!!!

先安装到手机并联网!!!

先安装到手机并联网!!!

要不上传更新包时会提示找不到基准值包,无法发布补丁包。

第八步 :生成patch包,打包上传。

1、修改baseApkDir为要修复的bakApk目录名。

2、更改tinkerId名,一般将base改为patch。

双击 buildTinkerPatchRelease,生成 如右侧的patch包。如下

将pacth_signed_7zip.apk压缩包上传至软件升级,耐心等待5-10分钟。重新打开应用即可发现已更新。

测试的时候,一定要把这个应用彻底关闭后再启动,修改才会生效!

也可参考官方Demo示例:Demo示例

问题汇总:

1、 基线包在版本发现 中总是没有,造成上传patch包失败

       查看appid是否填写错误,是不是按照enableProxyApplication = true 的情况处理的。

      基线版本需要打开联网后后才会上传到bugly。

2、下发 更新失败

      耐心等待5-10分钟后再试试.

       如果是android8.0以上系统,不会自动更新,需要添加 打开允许未知应用安装的权限。

manifest文件中配置权限:

    <uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>

        或者是由于基准包与更新包是否签名不一致

3.No such property: variantConfiguration for class: m.android.build.gradle.internal.variant.Applicat

集成bugly热修复的时候,在app module的“build.gradle”文件中添加:
// 依赖插件脚本

apply from: 'tinker-support.gradle'

sync之后会报错 No such property: variantConfiguration for class: com.android.build.gradle.internal.variant.ApplicationVariantData

原因:是由于我的AS 项目根目录下用的gradle版本是

dependencies {
    classpath "com.android.tools.build:gradle:4.0.1"   
    // tinkersupport插件, 其中lastest.release指拉取最新版本,也可以指定明确版本号,例如1.0.4
    classpath "com.tencent.bugly:tinker-support:latest.release"
}
改成:

dependencies {
        classpath 'com.android.tools.build:gradle:3.4.2'
        // tinkersupport插件, 其中lastest.release指拉取最新版本,也可以指定明确版本号,例如1.0.4
        classpath "com.tencent.bugly:tinker-support:latest.release"
}
gradle-wrapper.properties 文件中:

distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-all.zip
改为:

distributionUrl=https\://services.gradle.org/distributions/gradle-5.5-all.zip
然后再sync即可,这个应该是腾讯bugly sdk的bug了,一直还没修复。
 

4.打包APK报错Execution failed for task ':app:mergeReleaseResources

解决方式:
在app文件夹下的build.gradle中配置下面两个信息,再build->clean project

aaptOptions.cruncherEnabled = false
aaptOptions.useNewCruncher = false

5.generation. File was preprocessed as vector drawable support was added
in Android 5.0 (API level 21) See

故障描述
Can’t process attribute android:fillColor="@android:color/white":
references to other resources are not supported by build-time PNG
generation. File was preprocessed as vector drawable support was added
in Android 5.0 (API level 21) See
http://developer.android.com/tools/help/vector-asset-studio.html for
details.

在解决这个问题之前,先了解下相关资料.

添加多密度矢量图形
Android Studio 包含一个名为 Vector Asset Studio 的工具,可帮助您添加 Material
图标以及将可扩展矢量图形 (SVG) 和 Adobe Photoshop Document (PSD)
文件作为矢量图资源导入到项目中。使用矢量图代替位图可以减小 APK
的尺寸,因为可以针对不同屏幕密度调整同一文件的大小,而不会降低图像质量。对于不支持矢量图的较早版本 Android 系统,Vector
Asset Studio 可在构建时针对每种屏幕密度将矢量图转换为不同大小的位图。

矢量图向后兼容性解决方案


解决方案:
支持库
此技术需要 Android 支持库 23.2 或更高版本、适用于 Gradle 的 Android 插件 2.0
或更高版本,且仅使用矢量图。利用支持库中的 VectorDrawableCompat 类,可实现在 Android 2.1(API 级别
7)及更高版本中支持 VectorDrawable。

在使用 Vector Asset Studio 之前,您必须向 build.gradle 文件添加一条声明:

android {
  defaultConfig {
    vectorDrawables.useSupportLibrary = true
  }
}

参考资料:http://developer.android.google.cn/tools/help/vector-asset-studio.html

6.androidX 在AndroidMainfest里面加入provider后编译不通过

在AndroidMainfest里面写入后点击运行 报错Manifest merger failed with multiple errors, see logs   
解决办法:
定义MineFileProvider继承 FileProvider   然后把上面androidx.core.content.FileProvider  修改为自定义得MineFileProvider再运行就可以编译通过了。

7.Caused by: com.tencent.tinker.android.dex.DexException: Unexpected magic: [100, 101, 120, 10, 48, 51, 55, 0]

这个错误坑了好久,查了官方各种issue,试了N种方法,都不行。 如果你也一直找不到原因,试一下修改minSdkVersion<=20

8.Apk打包时发生Execution failed for task ':app:lintVitalRelease'.

在APK打包时报错Execution failed for task ‘:app:lintVitalRelease’. > Could not resolve all files for configuration '只需在build.gradle中添加lintOptions {
checkReleaseBuilds false
abortOnError false
}即可。


9.tryLoadPatchFiles:patch dir not exist:/data/user/0/com.morse.yindexfix/tinker

网上查资料说在集成的时候,并没有动态配置sd卡读取权限,导致无法读取patch,在代码里动态申请一下权限就ok了。但是在android10和11上仍然不成功,手头没有其它手机,暂时搁置。有解决方案的还望指导下,谢谢

  • 3
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值