目录
enableProxyApplication = true 的情况
第六步: 在Project Structure中的app中添加签名信息。
1、 基线包在版本发现 中总是没有,造成上传patch包失败
3.No such property: variantConfiguration for class: m.android.build.gradle.internal.variant.Applicat
4.打包APK报错Execution failed for task ':app:mergeReleaseResources
6.androidX 在AndroidMainfest里面加入provider后编译不通过
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上仍然不成功,手头没有其它手机,暂时搁置。有解决方案的还望指导下,谢谢