一、快速接入

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

1. 添加maven仓库地址：

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

2. 添加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'
    ......
}

3. 加入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中

4. AndroidManifest里边使用SophixStubApplication

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

5. 权限申请，外部存储权限用于调式补丁，不影响线上修复

<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. 混淆配置
   开启混淆时，生成修复包要使用旧包的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