Android 热修复技术：Andfix 框架原理与源码分析

PatchManager 初始化

PatchManager 负责管理多个补丁文件。其构造函数中会初始化 AndFixManager、补丁目录以及相关的集合容器。

public PatchManager(Context context) {
    mContext = context;
    mAndFixManager = new AndFixManager(mContext);
    mPatchDir = new File(mContext.getFilesDir(), DIR);
    mPatchs = new ConcurrentSkipListSet<Patch>();
    mLoaders = new ConcurrentHashMap<String, ClassLoader>();
}

AndFixManager 初始化

AndFixManager 是核心管理类，主要负责环境检查和签名校验。

public AndFixManager(Context context) {
    mContext = context;
    mSupport = Compat.isSupport();
    if (mSupport) {
        mSecurityChecker = new SecurityChecker(mContext);
        mOptDir = new File(mContext.getFilesDir(), DIR);
        if (!mOptDir.exists() && !mOptDir.mkdirs()) {
            mSupport = false;
            Log.e(TAG, "opt dir create error.");
        }
    }
}

Andfix 源码分析

1. 环境支持性检查

isSupport() 方法决定了当前设备是否支持 Andfix，主要包含三个条件：

1. 系统兼容性：排除阿里云 YunOS 等特定系统。
2. 虚拟机类型：区分 Dalvik 和 ART 虚拟机，注册对应的 Native 方法。
3. SDK 版本：通常支持 Android 2.3 (API 8) 到 7.0 (API 24)。

public static synchronized boolean isSupport() {
    if (isChecked) return isSupport;
    isChecked = true;
    // 判断非 YunOs 且 Setup 成功且 SDK 版本符合
    if (!isYunOS() && AndFix.setup() && isSupportSDKVersion()) {
        isSupport = true;
    }
    if (inBlackList()) {
        isSupport = false;
    }
    return isSupport;
}

2. 签名安全校验

为了防止补丁被篡改，Andfix 会对补丁包进行签名验证。SecurityChecker 获取当前应用的证书信息，并与补丁包中的签名进行比对。

private void init(Context context) {
    PackageManager pm = context.getPackageManager();
    PackageInfo packageInfo = pm.getPackageInfo(context.getPackageName(), PackageManager.GET_SIGNATURES);
    CertificateFactory certFactory = CertificateFactory.getInstance("X.509");
    X509Certificate cert = (X509Certificate) certFactory.generateCertificate(
            new ByteArrayInputStream(packageInfo.signatures[0].toByteArray()));
    mPublicKey = cert.getPublicKey();
}

3. 补丁加载与解析

PatchManager 通过读取 .apatch 文件（本质是 Jar 包）来解析需要修复的类列表。

private void init() throws IOException {
    JarFile jarFile = new JarFile(mFile);
    Manifest manifest = new Manifest(jarFile.getInputStream(jarFile.getJarEntry("META-INF/PATCH.MF")));
    Attributes main = manifest.getMainAttributes();
    // 解析 PATCH-Classes 属性，获取待修复类名列表
    for (Iterator<?> it = main.keySet().iterator(); it.hasNext();) {
        Attributes.Name attrName = (Attributes.Name) it.next();
        if (attrName.toString().endsWith("-Classes")) {
            List<String> strings = Arrays.asList(main.getValue(attrName).split(","));
            mClassesMap.put(name.trim().substring(0, name.length() - 8), strings);
        }
    }
}

4. 核心修复逻辑

修复的核心在于 fixClass 和 replaceMethod。流程如下：

1. 加载修复类：使用自定义 ClassLoader 加载补丁中的 Dex 文件。
2. 反射获取方法：遍历修复类的方法，查找带有 @MethodReplace 注解的方法。
3. 定位目标方法：根据注解信息（类名、方法名、参数类型）获取原应用中的有 Bug 方法对象。
4. Native 替换：调用 Native 层接口，直接修改方法结构体指针。

private void fixClass(Class<?> clazz, ClassLoader classLoader) {
    Method[] methods = clazz.getDeclaredMethods();
    for (Method method : methods) {
        MethodReplace annotation = method.getAnnotation(MethodReplace.class);
        if (annotation != null) {
            replaceMethod(classLoader, annotation.clazz(), annotation.method(), method);
        }
    }
}

5. Native 层实现

由于 Android 4.4 (ART) 前后虚拟机机制不同，Native 层分别实现了 dalvik_replaceMethod 和 art_replaceMethod。

以 Dalvik 为例，它通过 JNI 获取 Java 层的 Method 对象对应的 C++ 结构体 Method*，然后直接覆盖指令集 (insns) 和其他关键属性。

extern void dalvik_replaceMethod(JNIEnv* env, jobject src, jobject dest) {
    // 获取目标类和方法的结构体
    ClassObject* clz = (ClassObject*) dvmDecodeIndirectRef_fnPtr(dvmThreadSelf_fnPtr(), clazz);
    Method* meth = (Method*) env->FromReflectedMethod(src);
    Method* target = (Method*) env->FromReflectedMethod(dest);
    
    // 替换关键属性
    meth->methodIndex = target->methodIndex;
    meth->prototype = target->prototype;
    meth->insns = target->insns;
    meth->nativeFunc = target->nativeFunc;
}

如何生成 Patch 包

Andfix 提供了命令行工具 apkpatch.jar 用于生成补丁包。该工具对比 Release 包和 Fix 包，生成差异化的 .apatch 文件。

java -jar apkpatch.jar -f app-release-fix.apk -t app-release-online.apk -o ./output -k my.keystore -p password -a alias -e storepass

生成的 .apatch 文件内部包含 classes.dex（差异代码）和 META-INF/PATCH.MF（元数据信息）。

注意事项与局限性

在使用 Andfix 时，需注意以下几点以确保稳定性：

1. 方法签名一致性：修复方法与原方法的名称、参数类型必须完全一致，否则无法匹配。
2. 签名校验：补丁包必须使用与原应用相同的签名文件签署，否则校验失败。
3. 类加载器隔离：补丁类需通过独立的 ClassLoader 加载，避免与主应用类冲突。
4. 系统兼容性：虽然支持较广的 Android 版本，但在高版本 Android（如 Android 10+）上可能需要针对 ART 机制做额外适配或考虑其他热修复方案。
5. 内存优化：补丁加载后应确保及时释放不必要的资源，防止内存泄漏。

综上所述，Andfix 通过底层字节码替换实现了高效的热修复能力，理解其源码有助于在实际项目中更好地集成和维护。