React Native Unistyles 在 Android 上的 libreactnative.so 重复问题解析

问题背景

在使用 React Native Unistyles 库时，部分开发者遇到了 Android 构建过程中的一个常见问题：系统检测到重复的 libreactnative.so 文件。这个问题通常出现在以下环境配置中：

• 使用 Expo 项目
• React Native 版本为 0.76.x
• 未启用新架构（Paper 架构）
• Android 平台构建时

问题现象

构建过程中会出现类似以下错误信息：

Execution failed for task ':app:mergeDebugNativeLibs'
2 files found with path 'lib/arm64-v8a/libreactnative.so'

错误明确指出在构建过程中发现了两个相同的 libreactnative.so 文件，分别来自：

1. Unistyles 库的构建输出目录
2. React Native Android 的缓存目录

技术原因

这个问题的根本原因在于：

1. React Native 0.76.0 开始引入了 libreactnative.so 文件
2. Unistyles 库在构建时也会生成相同的文件
3. Android 构建系统默认不允许存在重复的 native 库文件

解决方案

方案一：修改 Gradle 配置

在 app/build.gradle 文件中添加以下配置：

android {
    packagingOptions {
        jniLibs {
            pickFirsts += ['**/libreactnative.so']
        }
    }
}

这个配置告诉 Gradle 在遇到重复的 libreactnative.so 文件时，选择第一个找到的文件。

方案二：Expo 项目配置

对于 Expo 项目，可以通过修改 app.json 文件来解决问题：

{
  "expo": {
    "plugins": [
      [
        "expo-build-properties",
        {
          "android": {
            "packagingOptions": {
              "pickFirst": ["**/libreactnative.so"]
            }
          }
        }
      ]
    ]
  }
}

修改后需要运行 expo prebuild 命令使配置生效。

注意事项

1. 这个问题主要出现在从新架构降级回旧架构时
2. 清理构建缓存（如 Gradle 缓存）有时可以临时解决问题，但不是根本解决方案
3. 未来版本的 Unistyles 可能会内置解决此问题的配置

最佳实践建议

1. 保持 React Native 和 Unistyles 版本同步更新
2. 在项目升级时，先备份现有配置
3. 考虑统一使用新架构或旧架构，避免频繁切换
4. 对于团队项目，确保所有成员的开发环境配置一致

通过以上解决方案，开发者可以顺利解决 libreactnative.so 文件重复的问题，继续使用 Unistyles 库提供的样式管理功能。