- 在阿里云管理控制台创建你的应用,得到
AppKey、AppSecret、RSA - 在你的Androidmanifest.xml文件中添加如下代码
<meta-data
android:name="com.taobao.android.hotfix.IDSECRET"
android:value="你的AppKey" />
<meta-data
android:name="com.taobao.android.hotfix.APPSECRET"
android:value="你的AppSecret" />
<meta-data
android:name="com.taobao.android.hotfix.RSASECRET"
android:value="你的RSA" />
其中RSA建议在下图为止复制
- 根据阿里给出的文档接入(建议直接采用稳健接入方式)
https://help.aliyun.com/document_detail/53240.html?spm=a2c4g.11174283.6.546.ydTSCV
(1)在你的工程级别的gradle下,添加maven仓库
repositories {
maven {
url "http://maven.aliyun.com/nexus/content/repositories/releases"
}
}
(2)在你的主工程下的gradle中添加依赖
compile 'com.aliyun.ams:alicloud-android-hotfix:3.2.4'
如果你的gradle依赖有问题,那么就去下载本地SDK,然后在项目中添加进去,下载地址
https://mhub.console.aliyun.com/?spm=a2c4g.11186623.2.3.OOmSwv#/download
(3)在AndroidManifest.xml中添加如下权限
<! -- 网络权限 -->
<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_EXTERNAL_STORAGE"/>
//备注READ_EXTERNAL_STORAGE权限属于Dangerous Permissions,仅调试工具获取外部补丁需要,不影响线上发布的补丁加载,调试时请自行做好android6.0以上的运行时权限获取。
(4)添加混淆
#基线包使用,生成mapping.txt
-printmapping mapping.txt
#生成的mapping.txt在app/build/outputs/mapping/release路径下,移动到/app路径下
#修复后的项目使用,保证混淆结果一致
#-applymapping mapping.txt
#hotfix
-keep class com.taobao.sophix.**{*;}
-keep class com.ta.utdid2.device.**{*;}
#防止inline
-dontoptimize
(5)复制这个类
package com.my.pkg;
import android.app.Application;
import android.content.Context;
import android.support.annotation.Keep;
import android.util.Log;
import com.taobao.sophix.PatchStatus;
import com.taobao.sophix.SophixApplication;
import com.taobao.sophix.SophixEntry;
import com.taobao.sophix.SophixManager;
import com.taobao.sophix.listener.PatchLoadStatusListener;
import com.my.pkg.MyRealApplication;
/**
* Sophix入口类,专门用于初始化Sophix,不应包含任何业务逻辑。
* 此类必须继承自SophixApplication,onCreate方法不需要实现。
* 此类不应与项目中的其他类有任何互相调用的逻辑,必须完全做到隔离。
* AndroidManifest中设置application为此类,而SophixEntry中设为原先Application类。
* 注意原先Application里不需要再重复初始化Sophix,并且需要避免混淆原先Application类。
* 如有其它自定义改造,请咨询官方后妥善处理。
*/
public class SophixStubApplication extends SophixApplication {
private final String TAG = "SophixStubApplication";
// 此处SophixEntry应指定真正的Application,并且保证RealApplicationStub类名不被混淆。
@Keep
@SophixEntry(MyRealApplication.class)
static class RealApplicationStub {}
@Override
protected void attachBaseContext(Context base) {
super.attachBaseContext(base);
// 如果需要使用MultiDex,需要在此处调用。
// MultiDex.install(this);
initSophix();
}
private void initSophix() {
String appVersion = "0.0.0";
try {
appVersion = this.getPackageManager()
.getPackageInfo(this.getPackageName(), 0)
.versionName;
} catch (Exception e) {
}
final SophixManager instance = SophixManager.getInstance();
instance.setContext(this)
.setAppVersion(appVersion)
.setSecretMetaData(null, null, null)
.setEnableDebug(true)
.setEnableFullLog()
.setPatchLoadStatusStub(new PatchLoadStatusListener() {
@Override
public void onLoad(final int mode, final int code, final String info, final int handlePatchVersion) {
if (code == PatchStatus.CODE_LOAD_SUCCESS) {
Log.i(TAG, "sophix load patch success!");
} else if (code == PatchStatus.CODE_LOAD_RELAUNCH) {
// 如果需要在后台重启,建议此处用SharePreference保存状态。
Log.i(TAG, "sophix preload patch success. restart app to make effect.");
}
}
}).initialize();
}
}
//这里的初始化和[快速接入](https://help.aliyun.com/document_detail/53240.html)中的是一样的,务必放在attachBaseContext中,onCreate不需要自行实现。同时自定义的SophixStubApplication需要继承com.taobao.sophix.SophixApplication。初始化设置选项如有疑问,请参考快速接入中的[接口说明](https://help.aliyun.com/document_detail/53240.html#1.3.2%20%E6%8E%A5%E5%8F%A3%E8%AF%B4%E6%98%8E)。
最重要的一点!!
@Keep
@SophixEntry(MyRealApplication.class)
static class RealApplicationStub {}
把MyRealApplication.class换成你自定义的Application
SophixEntry应指定项目中原先真正的Application(原项目里application的android::name指定的),这里用MyRealApplication指代。并且保证RealApplicationStub类名不被混淆。而SophixStubApplication的类名和包名可以自行取名。
这里的Keep是android.support包中的类,目的是为了防止这个内部静态类的类名被混淆,因为sophix内部会反射获取这个类的SophixEntry。如果项目中没有依赖android.support的话,就需要在progurad里面手动指定RealApplicationStub不被混淆,详见下文。
-keepclassmembers class com.my.pkg.MyRealApplication {
public <init>();
}
# 如果不使用android.support.annotation.Keep则需加上此行
# -keep class com.my.pkg.SophixStubApplication$RealApplicationStub
最后,需要把AndroidManifest里面的application改为这个新增的SophixStubApplication类:
<application
android:name="com.my.pkg.SophixStubApplication"
... ...>
... ...
-
注意事项:
如果运行报错
说明是你的utdid冲突了,赶快检查你项目中引用到阿里系列的包(友盟统计、友盟推送、阿里支付、andfix等等)最后确认只留下一个utdid的引用即可。
- 打包测试
(1)打好2个差异包之后,用测试工具生成sophix-patch.jar包
调试工具地址:http://ams-hotfix-repo.oss-cn-shanghai.aliyuncs.com/hotfix_debug_tool-release.apk
(2)查看你的程序中,目前的版本号是多少,就是你AndroidManifest.xml中的android:versionName="1.0"或者build.gradle中的android:versionName="1.0。
在阿里云管理后台,新建版本1.0
注意:版本号必须完全一致才可以!!!
(3)然后再上传补丁,就是你用工具生成的sophix-patch.jar包
(4)点击下图区域
扫码测试没问题后,发布灰度测试
灰度测试通过后,点击全量发布
至此,OK,欢迎交流