写在前面
关于安卓热修复技术选型可以参考这篇文章,这里主要记录阿里移动热修复的接入流程。
开始接入
移动热修复现有三个版本,这里接入的是Sophix版,各版本差别如下:
各版本热修复差别
1. 添加依赖
repositories {
maven {
url "http://maven.aliyun.com/nexus/content/repositories/releases"
}
}
compile 'com.aliyun.ams:alicloud-android-hotfix:3.2.4'
当你的APP同时使用了其他用到阿里UTDID组件时,会导致UTDID冲突:
Program type already present: com.ta.utdid2.b.a.a
解决方案参见这篇文章
2. 稳健接入
有两种接入方法,快速接入照着文档来就行, 稳健接入需要新建一个SophixStubApplication 集成 SophixApplication ,并配置到Androidmanifest的Application节点中,然后把项目原Application文件配置到SophixStubApplication 中;
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();
}
}
如果你找不到'android.support'包中的Keep,那么为了防止这个内部静态类被混淆,需要在'progurad'中手动指定'RealApplicationStub'不被混淆。
-keepclassmembers class com.my.pkg.MyRealApplication {
public <init>();
}
# 如果不使用android.support.annotation.Keep则需加上此行
# -keep class com.my.pkg.SophixStubApplication$RealApplicationStub
如果配置好后,拉取补丁报code 35,说明SecretMetaData配置的参数不对,仔细对照控制台应用的相关信息修改即可,不能有多余的空格。
3. 生成补丁
patch补丁包生成需要使用到打补丁工具SophixPatchTool。
补丁工具下载地址:
mac
windows
linux
调试工具下载地址:
android
该工具使用非常简单方便,不清楚可以参考官方文档。
4.使用补丁
在打包工具的输出目录里面找到生成的jar(这个jar的名字不能改),将其上传至控制台,流程并不复杂,具体操作参见官方文档
网友评论