一、快速接入
1.EMAS创建应用
https://help.aliyun.com/document_detail/169962.htm?spm=a2c4g.11186623.2.3.622a3206IumtXh
不需要用到EMAS统一插件程序读取json文件
2.SDK集成
详情参考：https://help.aliyun.com/document_detail/61082.htm?spm=a2c4g.11186623.2.5.12823206xNdTd4
- 添加maven仓库地址：
repositories {
maven {
url "http://maven.aliyun.com/nexus/content/repositories/releases"
}
}
- 添加gradle坐标版本依赖：
android {
......
defaultConfig {
applicationId "com.xxx.xxx" //包名，EMAS注册应用时也要填写
......
ndk {
//选择要添加的对应cpu类型的.so库。
//热修复支持五种
abiFilters 'arm64-v8a', 'armeabi', 'armeabi-v7a', 'x86', 'x86_64'
}
......
}
......
}
dependencies {
......
compile 'com.aliyun.ams:alicloud-android-hotfix:3.2.18'
......
}
- 加入SophixStubApplication类
package com.qijifeng.hotfix;
import android.app.Application;
import android.content.Context;
import android.util.Log;
import androidx.annotation.Keep;
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;
/**
* 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(MyApplication.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();
}
}
setSecretMetaData设置App ID、App Secret和RSA密钥，可在配置json文件里边找到
SophixManager.getInstance().queryAndLoadNewPatch();不可放在attachBaseContext 中，否则无网络权限，建议放在后面任意时刻，如onCreate中
- AndroidManifest里边使用SophixStubApplication
<application
android:name="com.my.pkg.SophixStubApplication"
... ...>
... ...
- 权限申请，外部存储权限用于调式补丁，不影响线上修复
<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"/>
- 混淆配置
开启混淆时，生成修复包要使用旧包的mapping文件以保证混淆结果一致。
#基线包使用，生成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
-keepclassmembers class com.my.pkg.MyRealApplication {
public <init>();
}
-keep class com.my.pkg.SophixStubApplication$RealApplicationStub
二、创建版本
在控制台创建对应的应用版本，该版本与基线包初始化时setAppVersion所传的版本号对应
https://help.aliyun.com/document_detail/93805.htm?spm=a2c4g.11186623.2.8.730432063VowF9
三、生成补丁
用阿里巴巴提供的工具生成，需要旧包新包：
- 补丁是针对客户端具体某个版本的，补丁和具体版本绑定。
- 针对某个具体版本发布的新补丁，必须包含所有的bugfix，而不能依赖补丁递增修复的方式，因为应用仅可能加载一个补丁。
https://help.aliyun.com/document_detail/53247.htm?spm=a2c4g.11186623.2.9.7fa93206C3bhQi
四、调式补丁
安装调式工具，可以扫码获取补丁，或者应用本地补丁，本地补丁应用需要申请读取外部存储权限，才能让APP读取补丁修复。
https://help.aliyun.com/document_detail/93827.htm?spm=a2c4g.11186623.2.11.b9dc3206zOVQAS
五、发布补丁
https://help.aliyun.com/document_detail/130163.html?spm=a2c4g.11186623.6.561.7ed41d67e7CRXS
