Xcode 12.4构建React Native项目报Multiple commands produce错误求助

这类错误在手动关联RN第三方库的iOS流程中非常常见，核心原因是同一个编译产物或资源文件被多个构建环节重复输出到最终App包内，结合你手动配置的场景，按以下顺序排查修复即可：

• 第一步：定位重复的构建条目
  选中主App Target，切换到「Build Phases」面板，依次展开「Copy Bundle Resources」「Compile Sources」「Headers」三个列表，在面板搜索框输入错误提示中提及的重复产物名（通常是.ttf字体文件、静态库产物），删除列表内所有重复的同路径条目——优先删除你手动拖拽添加的条目，保留Pods脚本自动生成的对应条目即可。
• 第二步：修正手动关联的库配置逻辑
  手动关联第三方库时最容易出现的配置错误，就是直接把node_modules下对应库的.xcodeproj文件拖拽到主项目的Frameworks分组下，这会导致嵌套工程的编译输出和主项目聚合的同路径产物重复。正确的手动配置逻辑是：
  • 不要嵌套引入第三方库的Xcode工程文件，要么通过Podfile的本地依赖条目让CocoaPods统一管理编译流程，要么仅将库目录下需要的.m源文件添加到主项目的「Compile Sources」列表，手动配置对应的Header Search Paths
  • 检查「Build Settings」下的「Framework Search Paths」「Library Search Paths」，删除指向同一份静态库的重复路径，不要将整个node_modules目录配置为递归搜索路径，避免扫描到多份版本不一致的同名单态库
• 第三步：清理全链路构建缓存
  按顺序执行以下清理操作，避免旧缓存导致的重复产物判定：
  • 删除iOS目录下的Pods文件夹、Podfile.lock文件，以及Xcode对应的DerivedData缓存目录
  • 重新执行pod install，不要使用pod update拉取和本地手动配置版本不一致的依赖
  • 在Xcode中按住Option键，点击顶部菜单栏「Product」，选择「Clean Build Folder」后重新构建项目
• 第四步：调整字体资源的拷贝逻辑
  react-native-vector-icons的.ttf字体文件是最常见的重复报错源：手动关联时很多人会直接把字体文件拖拽到「Copy Bundle Resources」列表，这会和CocoaPods自动配置的字体拷贝流程冲突。正确做法是：仅在项目的Info.plist中找到「Fonts provided by application」配置项，追加需要使用的字体文件名即可，不需要手动将字体文件加入资源拷贝列表，相关拷贝动作由Pods的统一资源脚本完成。

内容的提问来源于stack exchange，提问作者Haider Abbas