动态功能模块卸载后残留？如何彻底删除无用代码与资源

阿华AIGC实验室

2026-5-12

解决动态模块卸载后残留的问题

首先，我得先拆解下你遇到的核心矛盾：明明调用deferredUninstall收到了成功回调，重启后模块却还显示已安装。结合你的模块配置（开启了dist:fusing="true"）和操作流程，下面是几个针对性的排查和解决方向：

1. 确认延迟卸载的真正执行条件

deferredUninstall的机制是标记模块为待卸载状态，直到应用进程完全终止并重启后才会执行实际卸载。这里的“重启”不是指应用从后台切回前台，而是要确保应用进程被彻底杀死：

手动在系统应用管理中强制停止应用，再重新打开
或者用命令行强制杀进程：adb shell am force-stop <你的应用包名>
如果只是普通退出再打开，系统可能会保留进程快照，导致卸载操作没真正触发。

2. 刷新SplitInstallManager的状态缓存

有时候SplitInstallManager会缓存已安装模块的状态，导致查询结果不准确。你可以在应用启动时主动刷新状态，确保拿到最新数据：

val splitInstallManager = SplitInstallManagerFactory.create(context)
splitInstallManager.refreshInstalledModules()
    .addOnSuccessListener {
        val installedModules = splitInstallManager.installedModules
        // 在这里更新你的模块状态逻辑或UI展示
    }

3. 处理开启fusing的模块残留

你的模块配置了<dist:fusing dist:include="true" />，这个配置允许模块被融合到base APK中（安装后系统可能会将其代码/资源合并到base包以优化性能），这会增加卸载残留的概率：

检查base模块中是否有静态引用extend模块的类或资源：如果有直接依赖（而非动态加载），系统可能会认为模块仍需保留
若不需要融合特性，可以暂时把dist:fusing="false"测试卸载是否正常；如果必须开启fusing，要确保动态加载逻辑完全解耦，避免硬编码引用

4. 清理应用的缓存与数据

系统可能会缓存动态模块的资源或安装信息，手动清理可以强制清除这些残留：

进入系统设置 → 应用管理 → 找到你的应用 → 存储 → 清理缓存 + 清理数据
注意：清理数据会删除用户的应用数据，建议在测试环境中操作。

5. 排查卸载回调的实际含义

虽然你收到了SuccessListener回调，但deferredUninstall的成功仅表示系统已接受卸载请求并标记了待卸载状态，不代表卸载操作已经完成。可以在CompleteListener中打印详细状态，确认请求的最终执行结果：

splitInstallManager.deferredUninstall(listOf("extend"))
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d("SplitInstall", "卸载请求已标记，等待进程重启执行")
        } else {
            val exception = task.exception
            Log.e("SplitInstall", "卸载请求失败: ${exception?.message}")
        }
    }