React Native执行pod install时现有依赖被移除的原因及解决办法

1. 依赖树重新解析：CocoaPods执行pod install时，会基于Podfile、项目package.json（React Native场景）及本地spec仓库重新计算完整依赖树。若某个依赖不再被任何顶层依赖或组件引用，就会被自动移除。比如你升级的AppAuth、Firebase等依赖，新版本可能不再依赖旧版FirebaseAnalytics、FirebaseAuth，或是新旧版本存在冲突，CocoaPods会移除冲突项以满足新的依赖约束。
2. React Native组件变更：如果package.json中移除了BVLinearGradient这类RN组件，或是该组件新版本不再依赖对应原生pod，pod install会识别并移除相关pod。另外，部分RN组件的自动链接逻辑变更，也可能导致对应pod不再被纳入依赖树。
3. --no-repo-update的隐性影响：这个参数仅禁止更新本地spec仓库，但如果本地已有新版本spec（比如之前更新过），CocoaPods仍会基于这些本地spec解析依赖。若新版本spec的依赖声明和旧版本差异较大，就可能引发部分依赖被替换或移除。

• 显式锁定依赖版本：在Podfile中直接声明需要保留的依赖及其版本，CocoaPods会优先遵循你的指定，不会随意移除。示例：

  # 可放在use_native_modules!前后
  pod 'BVLinearGradient', '~> 2.5.1'
  pod 'FirebaseAnalytics', '~> 6.8.0'
  pod 'FirebaseAuth', '~> 6.6.1'
  

• 检查依赖引用关系：对比执行pod install前后的Podfile.lock文件，查看被移除的依赖是否还被其他组件引用。如果是误删RN组件导致的，重新安装对应组件即可：

  npm install react-native-linear-gradient --save
  # 或使用yarn：yarn add react-native-linear-gradient
  

• 修复版本冲突：如果是版本冲突导致的移除，需调整相关依赖版本。比如在package.json中锁定AppAuth、Firebase的兼容版本，或是在Podfile中用pod 'DependencyName', :modular_headers => true这类参数解决兼容性问题。
• 避免滥用--no-repo-update：除非确认本地spec仓库完全适配当前项目，否则建议先执行pod repo update trunk更新核心spec仓库，再执行pod install，减少因旧spec引发的依赖解析异常。
• 手动保留无引用依赖：若某个pod未被任何RN组件引用但需保留，直接在Podfile中添加该pod声明即可，CocoaPods会将其纳入依赖树。

内容的提问来源于stack exchange，提问作者mahdi souilmi