YukiHookAPI中ModulePreferenceFragment权限问题的分析与解决

问题背景

在Android模块化开发中，使用YukiHookAPI的ModulePreferenceFragment管理偏好设置(prefs)时，开发者可能会遇到一个棘手的问题：在某些设备上，特别是关闭了debuggable的release版本中，宿主应用无法读取模块创建的偏好设置文件。这个问题会导致模块与宿主之间的数据共享失败，影响功能实现。

问题现象

开发者报告了以下具体现象：

1. 在小米11(Android 12)和小米13(Android 14)设备上
2. 使用LSPosed框架版本1.9.2
3. 当模块以release模式构建时(关闭debuggable)
4. 通过ModulePreferenceFragment创建的prefs文件权限为660(rw-rw----)
5. 宿主应用无法读取这些偏好设置

技术分析

根本原因

问题的根源在于SharedPreferences的创建方式和权限设置。通过分析ModulePreferenceFragment的源码，我们发现：

1. ModulePreferenceFragment在onCreatePreferences方法中首先调用了PreferenceManager.getDefaultSharedPreferences
2. 这个方法内部使用Context.MODE_PRIVATE模式创建SharedPreferences
3. MODE_PRIVATE对应的文件权限是660，其他应用无法读取
4. 虽然后续调用了makeNewXShareReadableIfPossible尝试修改权限，但可能为时已晚

权限模式对比

• MODE_PRIVATE (660): 只有创建应用可以读写
• MODE_WORLD_READABLE (664): 所有应用可读，创建应用可写

在模块化开发中，通常需要宿主能够读取模块的偏好设置，因此需要使用MODE_WORLD_READABLE模式。

解决方案

开发者发现了一个有效的临时解决方案：在调用super.onCreatePreferences之前，手动创建SharedPreferences并指定MODE_WORLD_READABLE模式。

override fun onCreatePreferences(
    savedInstanceState: Bundle?,
    rootKey: String?,
) {
    requireActivity().getSharedPreferences(
        "${activity?.packageName}_preferences",
        Context.MODE_WORLD_READABLE,
    )
    super.onCreatePreferences(savedInstanceState, rootKey)
}

这种方法之所以有效，是因为：

1. 先手动创建了具有正确权限的SharedPreferences文件
2. 后续的super.onCreatePreferences会重用这个已存在的文件
3. 避免了默认的MODE_PRIVATE创建方式

长期修复建议

对于YukiHookAPI的维护者，建议考虑以下修复方案：

1. 修改ModulePreferenceFragment的currentSharedPrefs实现，直接使用MODE_WORLD_READABLE
2. 或者在makeNewXShareReadableIfPossible中更积极地修改文件权限
3. 确保在文件创建时就设置正确的权限，而不是事后修改

开发者注意事项

1. 在模块开发中，如果需要与宿主共享偏好设置，务必确认文件权限
2. 测试时要注意区分debug和release构建，权限行为可能不同
3. 考虑使用ContentProvider等更安全的跨进程数据共享方式替代文件共享

这个问题展示了Android权限系统在模块化开发中的复杂性，开发者需要充分理解文件权限和跨进程通信机制，才能构建稳定可靠的模块化应用。