M1 Mac React Native集成react-native-maps时Podfile报map方法未定义错误

你遇到的undefined method 'map' for nil:NilClass报错，核心原因是Podfile中仅声明了react-native-google-maps子依赖，缺失react-native-maps核心依赖声明，导致CocoaPods解析依赖树时异常。按照以下步骤操作即可解决问题，完成iOS端地图功能集成：

1. 清理现有缓存避免兼容干扰 #

先进入项目的ios目录，依次执行以下命令清理旧的依赖缓存：

pod deintegrate
rm Podfile.lock
rm -rf ~/Library/Caches/CocoaPods
rm -rf ~/Library/Developer/Xcode/DerivedData/*

2. 修正Podfile配置 #

替换你之前添加的两行react-native-maps相关代码，使用完整配置：

# react-native-maps 核心依赖声明
rn_maps_path = '../node_modules/react-native-maps'
pod 'react-native-maps', :path => rn_maps_path

# 仅当你需要使用Google地图服务时添加以下三行，只用苹果原生MapKit则不用添加
pod 'react-native-google-maps', :path => rn_maps_path
pod 'GoogleMaps', '7.4.0'
pod 'Google-Maps-iOS-Utils', '4.2.2'

# 在已有的post_install代码块中插入以下兼容配置
post_install do |installer|
  installer.pods_project.targets.each do |target|
    # 解决Google Maps编译冲突
    if target.name == 'react-native-google-maps'
      target.build_configurations.each do |config|
        config.build_settings['CLANG_ENABLE_MODULES'] = 'No'
      end
    end
    if target.name == "Google-Maps-iOS-Utils"
      target.build_configurations.each do |config|
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
      end
    end
    # 原有其他post_install配置保留即可
  end
end

3. 重新安装依赖 #

配置完成后，在ios目录执行以下命令重新安装Pod依赖：
pod install --repo-update
依赖安装完成后，关闭Xcode，双击打开项目下的.xcworkspace文件重新运行项目即可。

额外配置说明 #

• 若使用Google地图服务，需要在Xcode项目的AppDelegate文件中添加初始化代码：
  1. 头部导入头文件@import GoogleMaps;
  2. 在didFinishLaunchingWithOptions方法内添加[GMSServices provideAPIKey:@"你自己申请的Google地图API密钥"];
• 仅使用苹果原生地图的用户不需要添加Google相关依赖和初始化代码，集成完核心依赖后直接调用react-native-maps的组件即可正常使用。

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