4. 插件安装与卸载流程对比：RePlugin的APK托管 vs Atlas的Bundle生命周期管理

4.1 系统分层与模块边界

插件安装与卸载是插件化框架的入口与出口，直接影响动态下发、版本控制和资源回收的可靠性。两种方案在分层和职责上存在本质差异：

4.2 组件职责

• RePlugin.Gardener（安装器）： 负责接收下载完成的 APK 文件，调用 PackageInstaller 或通过 adb install 机制将其安装到系统分区。卸载时同样通过系统 API 移除 APK。
• RePlugin.PluginLoader： 监听系统广播（ACTION_PACKAGE_ADDED）感知插件状态变化，触发 Dex 和资源加载。
• Atlas.BundleInstaller： 解析下载的 bundle zip 包，将 Dex 文件写入宿主私有目录，生成 BundleArchive 实例，注册到 BundleManager。
• Atlas.BundleUnInstaller： 从 BundleManager 中移除元数据，回收 ClassLoader 和 AssetManager 引用。

4.3 插件安装流程详解

RePlugin - APK 托管模式

// 核心安装调用 (需在 hook 后的系统上下文中)
RePlugin.install(context, "/data/data/.../plugin.apk");

// 内部调用链
PluginLibraryInternal.install(...)
  → ensurePluginInstalledInternal(Context, String)
  → PackageManager.installPackage(Uri, ...)   // 系统级安装
  → 监听 ACTION_PACKAGE_ADDED 广播
  → PluginManager.preparePlugin(...)           // 准备运行时环境

Atlas - Bundle 生命周期管理

// 安装一个 bundle (从下载到激活)
BundleManager mgr = Atlas.getInstance().getBundleManager();
BundleArchive archive = mgr.installBundle("com.example.plugin", bundleZipFile);

// installBundle 内部流程
1. 解压 bundle.zip → 获取 Dex、so、AndroidManifest
2. 将 Dex 写入 /data/data/.../bundles/com.example.plugin/classes*.dex
3. 生成 BundleArchive 对象，持有 packageName、version、installedPath
4. 创建独立的 BundleClassLoader（parent = host ClassLoader）
5. 反射创建 Bundle Context（自定义 AssetManager + Resources）
6. 回调 onBundleInstalled 到宿主

// 卸载
mgr.uninstallBundle("com.example.plugin");
→ BundleArchive 标记为 UNINSTALLED
→ 解除 ClassLoader 引用
→ 删除私有目录中的 Dex 文件（延迟 GC）

4.4 数据流与控制流

两种方案在数据流向和控制权归属上形成鲜明对比：

• RePlugin 数据流： 插件 APK → 系统 PackageInstaller → 系统/data/app → 广播回调 → 宿主 Loader。控制权归属系统。
• Atlas 数据流： bundle.zip → BundleInstaller → 私有目录 → BundleArchive → BundleManager → loader。控制权完全在宿主进程。

4.5 数据流与控制流关键差异

4.6 选型权衡

4.7 风险点

• RePlugin 安装风险： 系统广播可能延迟或丢失（低内存杀进程时），导致插件状态不一致；Google Play 上架时可能因 hook 被拒。
• Atlas 卸载风险： 卸载后 ClassLoader 引用未完全释放，导致内存泄漏；私有目录残留 Dex 文件，需配合 tempDir 清理策略。
• 版本兼容性： RePlugin 的 APK 托管在 Android 12+ 的 PackageInstaller 改动下几乎失效，必须降级为模拟安装。

4.8 落地步骤

1. RePlugin 安装落地：
   1. 搭建下载通道，确保 APK 完整性校验（MD5/SHA256）。
   2. 调用 RePlugin.install，监听安装结果回调。
   3. 建议降级方案：若系统安装失败，回退到 DexClassLoader 方式（框架内置 fallback）。
2. Atlas 安装落地：
   1. 定义 bundle 元数据（name、version、dependencies）。
   2. 下载 bundle.zip，解压后调用 installBundle。
   3. 使用 BundleArchive.getBundleClassLoader() 加载插件类。

4.9 验收标准