YukiHookAPI 模块资源注入问题分析与解决方案

问题背景

在使用 YukiHookAPI 进行模块开发时，开发者可能会遇到模块 Activity 注册后无法正常运行的情况。典型表现为：当模块 Activity 通过 registerModuleAppActivities 方法注册到宿主应用后，启动时抛出 IllegalStateException 异常，提示 "This app has been built with an incorrect configuration. Please configure your build for VectorDrawableCompat"。

问题本质

这个问题的根本原因是模块的资源文件（特别是矢量图资源）未能正确注入到宿主应用中。YukiHookAPI 虽然提供了注册模块 Activity 的能力，但模块自身的资源（如布局、图片、矢量图等）需要显式注入到宿主环境才能被正确加载和使用。

技术原理分析

在 Android 应用开发中，每个应用都有自己的资源表和资源 ID 空间。当模块作为独立应用时，它有自己的资源上下文；但当模块作为寄生模块运行在宿主应用中时，需要解决以下关键问题：

1. 资源 ID 冲突：宿主和模块可能使用相同的资源 ID 表示不同的资源
2. 资源上下文隔离：模块需要能够访问自己的资源而不影响宿主
3. 特殊资源处理：如矢量图等需要特殊的兼容性支持

YukiHookAPI 提供了资源注入机制来解决这些问题，但需要开发者正确配置和使用。

解决方案

1. 注入模块资源到宿主

在模块初始化时，必须显式注入模块资源到宿主环境：

onAppLifecycle {
    onCreate {
        // 先注入资源
        injectModuleResources()
        // 再注册Activity
        registerModuleAppActivities(proxy = "com.miui.weather2.PermissionConfirmActivity")
    }
}

2. 配置矢量图兼容性

在模块的 build.gradle 文件中添加矢量图支持配置：

android {
    defaultConfig {
        vectorDrawables.useSupportLibrary = true
    }
}

3. 检查资源使用方式

确保模块中所有资源访问都通过正确的上下文进行：

// 正确方式 - 使用模块的Context
val drawable = moduleContext.getDrawable(R.drawable.module_icon)

// 错误方式 - 直接使用Activity的Context
val drawable = getDrawable(R.drawable.module_icon) // 可能导致资源找不到

最佳实践建议

1. 资源命名前缀：为模块所有资源添加唯一前缀（如 module_），避免与宿主资源冲突
2. 延迟资源加载：在确保资源注入完成后再执行资源相关操作
3. 错误处理：对资源加载添加适当的异常捕获和回退机制
4. 资源验证：在开发阶段添加资源加载的验证逻辑

总结

YukiHookAPI 提供了强大的模块化开发能力，但资源管理是需要特别注意的环节。通过正确注入模块资源、配置矢量图兼容性以及遵循资源访问最佳实践，可以避免大多数资源相关的问题。理解 Android 资源管理机制和 YukiHookAPI 的资源注入原理，有助于开发出更稳定可靠的模块应用。