Bugly Android热更新使用指南–》大部分步骤按照文档即可:官方文档
=========================================================================
第一步:添加插件依赖
工程根目录下“build.gradle”文件中添加:
=========================================================================
第二步:集成SDK
gradle配置
在app module的“build.gradle”文件中添加(示例配置):
android {
defaultConfig {
ndk {
//设置支持的SO库架构
abiFilters 'armeabi' //, 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a'
}
}
}
dependencies {
compile "com.android.support:multidex:1.0.1" // 多dex配置
//注释掉原有bugly的仓库
//compile 'com.tencent.bugly:crashreport:latest.release'//其中latest.release指代最新版本号,也可以指定明确的版本号,例如1.3.4
compile 'com.tencent.bugly:crashreport_upgrade:1.3.4'
compile 'com.tencent.bugly:nativecrashreport:3.3.1'
}
在app module的“build.gradle”文件中添加:
// 依赖插件脚本
apply from: 'tinker-support.gradle'
// 多渠道使用walle示例(注:多渠道使用)
apply from: 'multiple-channel.gradle'
tinker-support.gradle内容如下所示(示例配置):
注:您需要在app module的build.gradle同级目录下创建tinker-support.gradle和multiple-channel.gradle这2个文件哦。
tinker-support.gradle中只需要关注这几个即可,其他不用修改:
/**
* 此处填写每次构建生成的基准包目录ps(打补丁时填写基准包的名字日期)
*/
def baseApkDir = "app-0516-22-25-54"
// 构建基准包和补丁包都要指定不同的tinkerId,并且必须保证唯一性ps(打补丁时填写patch-..,基准包base-..)
// tinkerId = "base-1.0.3"
tinkerId = "patch-1.0.3"
// 构建多渠道补丁时使用
buildAllFlavorsDir = "${bakPath}/${baseApkDir}"
// 是否启用加固模式,默认为false.(tinker-spport 1.0.7起支持)ps(360加固时,基准包和补丁包都需要开启此)
isProtectedApp = true
multiple-channel.gradle中的内容不用修改ps(可以修改打出包的名字…)
=========================================================================
第三步:初始化SDK
3.1推荐enableProxyApplication = false 的情况
自定义Application
public class SampleApplication extends TinkerApplication {
public SampleApplication() {
super(ShareConstants.TINKER_ENABLE_ALL, "xxx.xxx.SampleApplicationLike",
"com.tencent.tinker.loader.TinkerLoader", false);
}
}
注意:这个类集成TinkerApplication类,这里面不做任何操作ps (所有Application的代码都会放到ApplicationLike继承类当中)
把SampleApplication 替换到清单文件的app中注册
3.2自定义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);
}
}
=========================================================================
第四步:AndroidManifest.xml配置
在AndroidMainfest.xml中进行以下配置:
- 权限配置
<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" />
- Activity配置
<activity
android:name="com.tencent.bugly.beta.ui.BetaActivity"
android:configChanges="keyboardHidden|orientation|screenSize|locale"
android:theme="@android:style/Theme.Translucent" />
- 配置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下载的文件可能存在的路径,一定要按照上面格式配置,不然可能会出现错误。
=========================================================================
第五步:混淆配置
为了避免混淆SDK,在Proguard混淆文件中增加以下配置:
-dontwarn com.tencent.bugly.**
-keep public class com.tencent.bugly.**{*;}
如果你使用了support-v4包,你还需要配置以下混淆规则:
-keep class android.support.**{*;}
=============================打包=========================================
普通打包
1、编译基准包
配置tinker-support.gradle中基准包的tinkerId
在terminal中执行命令行:gradlew assembleRelease编译生成基准包ps(如果出现无效命令,请百度搜索,然后自己去环境变量配置ANDROID_HOME和path)
这个会在build/outputs/bakApk路径下生成每次编译的基准包、混淆配置文件(前提是你开启混淆才有这文件)、资源Id文件,如下图所示:
::::::重要:::::::
实际应用中,请注意保存线上发布版本的基准apk包、mapping文件、R.txt文件,如果线上版本有bug,就可以借助我们tinker-support插件进行补丁包的生成。
启动apk,上报联网数据
我们每次冷启动都会请求补丁策略,会上报当前版本号和tinkerId,这样我们后台就能将这个唯一的tinkerId对应到一个版本
2、对基线版本的bug修复后
3、根据基线版本生成补丁包
修改待修复apk路径、mapping文件路径、resId文件路径\
然后执行命令:gradlew buildTinkerPatchRelease生成的补丁包在build/outputs/patch目录下:
4、上传补丁包到平台 测试即可(前提是先运行基准包(即bug包)才能上传补丁,前面解释过了)
上传补丁包到平台并下发编辑规则
==============================多渠道打包================================
多渠道打包 ps采用官方推荐的Bugly多渠道热更新解决方案(自己按照文档配置即可)
目前支持的加固打包
需要集成升级SDK版本1.3.0以上版本才支持加固。
经过测试的加固产品:
腾讯乐固
爱加密
梆梆加固
360加固(SDK 1.3.1之后版本支持)
其他产品需要大家进行验证。
1.设置isProtectedApp参数
在tinker-support配置当中设置isProtectedApp = true,表示你要打加固的的apk,这种模式仅仅可以用于加固应用中。
2.将基准包进行加固
如果你的app需要进行加固,你需要将你打出的基准包上传到具体的加固平台进行加固,例如乐固,加固完成之后需要对apk进行重签名:
如360工具:
3.根据未加固的基准包生成补丁包
打patch包的操作跟普通打包方式一致。
注意:这里指定的基线版本是未加固的版本。ps(加固时候,无论打基线包还是补丁包时候都需要开启isProtectedApp)
4.测试验证
测试验证的版本是经过加固并且已经重签名后的apk,安装到测试设备并上报联网,其他操作与普通打包无异。ps(先装基准包再上传补丁)
另外还有一点,执行命令时,由于jcenter()慢,我们把它替换为阿里
repositories {
maven{url 'http://maven.aliyun.com/nexus/content/groups/public/'}
}
—————————————————————over——————————————————-