React Native Permissions 在 Android 混淆打包时的注意事项

在 React Native 开发中，权限管理是一个常见的需求。react-native-permissions 是一个流行的权限管理库，但在 Android 平台使用混淆打包时可能会遇到一些问题。

问题现象

当开发者在 Android 项目中启用混淆（minifyEnabled 设置为 true）时，调用 react-native-permissions 的 request() 方法会导致应用完全崩溃。错误日志显示找不到 RNPermissions 模块，提示 TurboModuleRegistry.getEnforcing(...): 'RNPermissions' could not be found。

问题分析

这个问题通常发生在以下情况：

1. 项目启用了 ProGuard/R8 代码混淆
2. react-native-permissions 的相关类被错误地混淆
3. 模块注册信息在混淆过程中丢失

解决方案

1. 正确配置混淆规则

在项目的 proguard-rules.pro 文件中添加以下规则：

-keepattributes StackMapTable
-dontoptimize
-dontobfuscate

-dontwarn com.zoontek.rnpermissions.**
-keep class com.zoontek.rnpermissions.** { *; }

-keep class com.zoontek.rnpermissions.RNPermissionsPackage

这些规则会：

• 保留必要的类属性
• 禁止对 react-native-permissions 相关类进行混淆
• 忽略相关警告

2. 检查其他依赖冲突

在某些情况下，问题可能并非直接由 react-native-permissions 引起，而是其他依赖（如热更新库）导致的模块注册问题。例如：

• react-native-update 10.3.0 之前的版本可能存在兼容性问题
• 其他热更新或代码推送库可能干扰模块注册

3. 验证 TurboModule 配置

确保项目的 TurboModule 配置正确：

• 检查是否启用了 TurboModule 互操作性
• 验证模块注册流程是否完整

最佳实践

1. 在开发阶段就开启混淆测试，避免后期发现问题
2. 使用最新稳定版本的 react-native-permissions
3. 定期更新相关依赖，特别是热更新类库
4. 在发布前进行全面测试，包括权限请求场景

总结

React Native 项目在 Android 平台启用混淆时，需要特别注意原生模块的保留规则。对于 react-native-permissions 这样的权限管理库，正确的混淆配置是保证功能正常的关键。同时，也要警惕其他依赖可能带来的间接影响，特别是那些涉及原生代码修改的库。

通过合理配置混淆规则和保持依赖更新，开发者可以避免这类问题，确保应用在各种构建配置下都能稳定运行。