Android集成阿里热修复(Hotfix)

1.先注册阿里云账号:

https://www.aliyun.com/?spm=5176.12825654.amxosvpfn.2.78342c4arjFnlZ

2.新建应用:

打开控制台 --> 移动研发平台EMAS --> 新建产品 --> 添加应用
在这里插入图片描述

3.下载应用的Android配置备用(不用将json文件复制到AS工程)

(标红框的一会配置会用到)
在这里插入图片描述

在这里插入图片描述

4. AS 开始集成(推荐稳健集成,点击跳转阿里官方文档,标题4的部分 代码文档都有)

(https://help.aliyun.com/document_detail/61082.html?spm=5176.13347446.0.0.4a8657c7BcEwMQ)

(1)gradle远程仓库依赖, 打开项目找到app的build.gradle文件,添加如下配置:

添加maven仓库地址:

repositories {
   maven {
       url "http://maven.aliyun.com/nexus/content/repositories/releases"
   }
}

(2)添加gradle坐标版本依赖:

compile 'com.aliyun.ams:alicloud-android-hotfix:3.2.14'

(3)权限说明:

<! -- 网络权限 -->
<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"/>

(4)配置AndroidManifest文件

在AndroidManifest.xml中间的application节点下添加如下配置:

<meta-data
android:name="com.taobao.android.hotfix.IDSECRET"
android:value="App ID" />  
<meta-data
android:name="com.taobao.android.hotfix.APPSECRET"
android:value="App Secret" />
<meta-data
android:name="com.taobao.android.hotfix.RSASECRET"
android:value="RSA密钥" />

引用的下载的Android配置文件( aliyun-emas-services.json ),3标题图片标红参数

  • App ID: hotfix.idSecret
  • App Secret:emas.appSecret
  • RSA密钥: hotfix.rsaSecre

(5)混淆配置

#基线包使用,生成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.**{*;}
-dontwarn com.alibaba.sdk.android.utils.**
#防止inline
-dontoptimize

(6)创建 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();
    }
}

这其中,关键一点是:

    @Keep
    @SophixEntry(MyRealApplication.class)
    static class RealApplicationStub {
    
    }

SophixEntry应指定项目中原先真正的Application(原项目里application的android::name指定的),这里用MyRealApplication指代。并且保证RealApplicationStub类名不被混淆。而SophixStubApplication的类名和包名可以自行取名。

这里的Keep是android.support包中的类,目的是为了防止这个内部静态类的类名被混淆,因为sophix内部会反射获取这个类的SophixEntry。如果项目中没有依赖android.support的话,就需要在progurad里面手动指定RealApplicationStub不被混淆,详见下文。

然后,在proguard文件里面需要加上下面内容:

-keepclassmembers class com.my.pkg.MyRealApplication {
    public <init>();
}
# 如果不使用android.support.annotation.Keep则需加上此行
# -keep class com.my.pkg.SophixStubApplication$RealApplicationStub

目的是防止真正Application的构造方法被proguard混淆。

然后需要把AndroidManifest里面的application改为这个新增的SophixStubApplication类:

    <application
        android:name="com.my.pkg.SophixStubApplication"
        ... ...>
        ... ...

最后,别忘了在MyRealApplication 中的 onCreate() 方法中加入:

// queryAndLoadNewPatch不可放在attachBaseContext 中,否则无网络权限,建议放在后面任意时刻,如onCreate中
SophixManager.getInstance().queryAndLoadNewPatch();

总结:

1.把此SophixStubApplication入口类添加进项目中,所有Sophix相关初始化放在此类中。并且不应包含开发者的任何业务逻辑代码。
2. 若使用了MultiDex,也应在SophixStubApplication的initSophix之前添加,并且需要记得在原来的Application里面去除MultiDex,避免重复调用导致问题。
3.把RealApplicationStub的SophixEntry注解的内容改为自己原先真正的MyRealApplication类。 混淆文件中确保某些内容不被混淆。
4.AndroidManifest里面的application改为新增的SophixStubApplication入口类。

5.生成补丁

(1)选择新包旧包,可在设置内控制输出路径和签名

在这里插入图片描述

(2)去阿里云后台上传补丁

在这里插入图片描述

猜你喜欢

转载自blog.csdn.net/qq_30297763/article/details/108149838