React Native iOS集成Google Maps时遇'RCTConvert+AIRMap.h'文件未找到错误

以下是几个针对性的排查和修复步骤：

1. 核对CocoaPods配置与使用方式 #

• 打开项目根目录的Podfile，确认已正确添加react-native-maps的依赖配置：

  pod 'react-native-maps', path: '../node_modules/react-native-maps'
  

• 执行pod install后，必须打开项目的.xcworkspace文件，而非.xcodeproj文件进行构建，这是容易忽略的关键点。

2. 修正头文件搜索路径的递归属性 #

• 在Xcode中进入项目的Build Settings，找到Header Search Paths选项。确认已添加的$(SRCROOT)/../node_modules/react-native-maps/ios/AirMaps路径被设置为recursive（递归搜索），而非默认的non-recursive。

3. 验证依赖文件的完整性 #

• 直接前往node_modules/react-native-maps/ios/AirMaps目录，确认RCTConvert+AIRMap.h文件是否存在。如果文件缺失：
  1. 删除项目根目录的node_modules文件夹和package-lock.json（或yarn.lock）文件
  2. 重新执行npm install或yarn install安装依赖
  3. 再次执行pod install更新Pods

4. 检查Target的依赖配置 #

• 在Xcode中选择主Target，进入Build Phases：
  • 查看Link Binary With Libraries，确认libAIRMaps.a已被添加，若没有则点击+按钮手动添加
  • 检查Copy Bundle Resources，确保包含react-native-maps相关的资源文件

5. 彻底清理Xcode缓存与派生数据 #

• 执行命令清理Xcode派生数据：

  rm -rf ~/Library/Developer/Xcode/DerivedData
  

• 在Xcode中按下Cmd+Shift+K清理项目，再按Cmd+Option+Shift+K清理构建文件夹，之后重新尝试构建

6. 确认版本兼容性 #

• 检查react-native-maps版本与当前React Native版本是否兼容，可参考react-native-maps的版本适配说明，若版本不匹配，升级或降级react-native-maps至对应兼容版本

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