Android 构建错误：React Native 中的 masked-view 包重复

Android 构建中重复类错误：React Native 中的 masked-view 包冲突

简介

在构建 Android 应用时，你可能会遇到以下错误：

A failure occurred while executing com.android.build.gradle.internal.tasks.DexMergingWorkAction

详细信息可能显示：

Type org.reactnative.maskedview.BuildConfig is defined multiple times: 

原因

此错误通常是由在 React Native 项目中安装了多个具有相同名称的包造成的。通常情况下，这种情况是由不同名称的包依赖于不同的版本同一库引起的。

案例研究：masked-view 包

在这个例子中，错误是由两个 masked-view 包引起的：

"@react-native-community/masked-view": "^0.1.11",
"@react-native-masked-view/masked-view": "^0.2.9",

这些包由你正在使用的其他两个包导入。

解决方法

1. 移除重复的包

最直接的解决方案是移除其中一个 masked-view 包。但这可能需要修改代码中引用该包的地方。

2. 使用 patch-package

patch-package 是一种工具，允许你修改包而不修改其源代码。你可以使用 patch-package 将两个 masked-view 包指向同一版本：

npx patch-package @react-native-community/masked-view @react-native-masked-view/masked-view --global

但要注意，patch-package 不会修改 package.json 文件，因此如果你重新安装这些包，补丁将被覆盖。

3. 创建自定义包

你可以创建一个包含这两个 masked-view 包的新包。然后，你可以从你的项目中移除这两个包，并仅安装自定义包。这将确保所有代码都使用同一版本的 masked-view 包。

为什么 iOS 没有发生此错误？

在 iOS 上，链接器可以处理具有相同名称的多个类。因此，你可以在 iOS 项目中安装多个 masked-view 包，而不会遇到错误。

结论

解决重复类错误的最佳方法取决于具体情况。根据项目需求和复杂程度，你可以选择最适合你的解决方案。

常见问题解答

1. 我应该如何判断哪些包具有相同的名称？

你可以使用 npm 命令 npm ls 来列出项目中安装的所有包，并检查是否有重名的包。

2. 为什么我不能在同一个项目中使用不同版本的同一个包？

不同的版本可能具有不同的 API，这可能会导致兼容性问题。

3. 如果我移除了一个包，我的代码是否会中断？

是的，如果你的代码引用了已删除的包，则会中断。

4. 如何防止将来发生此错误？

在安装新包时，使用版本管理工具（如 npm 或 yarn）并注意包名称。

5. 我在哪里可以找到有关重复类错误的更多信息？

你可以参考 React Native 文档或在线论坛，以获取更多信息和故障排除提示。