react-native-firebase/app iOS端pod安装及run-ios编译报错求助

前置路径说明 #

./ios/Podfile是你在React Native项目根目录下的相对路径写法，和文档里提到的/ios/Podfile是同一个文件，操作时直接打开项目根目录下ios文件夹内的Podfile即可。

问题根因 #

你遇到的是react-native-firebase v15+（对应firebase-ios-sdk v9+）在iOS端的典型配置兼容问题：全局添加use_modular_headers!会强制所有CocoaPods依赖使用模块化头文件规则，破坏React Native核心依赖（React-jsi、YogaKit）的默认编译配置，最终触发C++/Swift源文件编译失败、watchOS扩展点缺失的报错。

分步修复流程 #

• 修正Podfile错误配置
  打开ios/Podfile按如下规则调整：

  1. 删掉之前全局添加的use_modular_headers!配置，该配置不需要添加
  2. 在Podfile最顶部（所有target块、其他配置之前）添加静态框架全局声明：

     $RNFirebaseAsStaticFramework = true
     

  3. 找到项目主target块（和你项目同名的target，格式为target '你的项目名' do），在块内添加静态框架链接配置：

     use_frameworks! :linkage => :static
     

  4. 如果你的Podfile里开启了Flipper，直接把所有Flipper相关的配置块注释掉，use_frameworks!和Flipper目前存在官方已知兼容问题，注释后不影响Firebase功能使用。

• 彻底清理缓存重装Pods依赖
  终端进入ios目录，执行以下命令清理所有旧缓存和残留依赖后重装：

  cd ios
  rm -rf Pods Podfile.lock build
  pod deintegrate
  pod install --repo-update
  

• 调整Xcode编译配置修复编译报错
  用Xcode打开ios/你的项目名.xcworkspace（注意不要打开.xcodeproj后缀的文件），做如下配置调整：

  1. 在Pods项目的target列表中找到React-jsi，切换到Build Settings标签页，找到Preprocessor Macros配置项，删除所有和watchOS相关的宏定义
  2. 在Pods项目的target列表中找到YogaKit，同样在Build Settings里找到Swift Language Version，手动设置为Swift 5
  3. 选中你自己的项目主target，在Build Settings里找到Enable Bitcode，设置为No

• 清理缓存重新构建项目
  回到项目根目录，先清理Metro打包缓存再重新运行iOS构建：

  npx react-native start --reset-cache
  # 新开一个终端窗口，在项目根目录执行
  npx react-native run-ios
  

补充说明：如果执行完以上步骤仍有编译报错，可以先把Xcode DerivedData目录下和你项目相关的缓存文件夹全部删除后再重试。

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