Flutter接入google_maps_flutter 1.0.6时iOS地图不显示,指定Google Maps SDK 4.1.0.0安装Pod报错
问题核心原因
google_maps_flutter: ^1.0.6插件的iOS端原生依赖是硬绑定Google Maps iOS SDK 3.9.0的版本区间,在Podfile中手动锁定4.1.0版本会直接触发原生依赖版本校验冲突,这是执行Pod安装、更新报错的根本原因,和网络、源配置无关。- 模拟器环境下地图加载失败的问题,和日志提示的SDK有新版本没有关联,属于该版本插件在iOS场景下的配置兼容问题。
第一步:清除Pod版本冲突
- 删除之前在Podfile中手动添加的、强制指定Google Maps SDK 4.1.0的所有配置,恢复插件默认的依赖解析逻辑
- 执行残留依赖清理命令,清除旧缓存导致的版本冲突:
cd iospod deintegraterm -rf Pods Podfile.lockpod install
执行完成后,依赖会自动匹配插件要求的3.9.0版本SDK,不再出现安装报错。
第二步:解决模拟器地图加载失败的问题
- 检查API Key注入逻辑:该版本插件要求iOS端的Google Maps API Key必须在
AppDelegate的didFinishLaunchingWithOptions生命周期方法中,通过调用GMSServices.provideAPIKey("你的API Key")完成注入;如果仅在Info.plist中添加配置,会导致模拟器环境下地图鉴权失败,出现全白地图加载不出来的情况。 - 配置Apple Silicon模拟器的架构兼容:Google Maps SDK 3.9.0对arm64架构的模拟器原生支持存在缺陷,需要在Podfile的全局
post_install配置块中,为Google Maps相关依赖添加架构排除规则:
配置完成后重新执行post_install do |installer| installer.pods_project.targets.each do |target| flutter_additional_ios_build_settings(target) if target.name.include? "GoogleMaps" target.build_configurations.each do |config| config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64' end end end endpod install,用x86_64架构启动的模拟器即可正常加载地图。 - 忽略日志中的SDK新版本提示:日志输出的“存在4.1.0版本可用”仅为SDK自带的升级提醒,不会影响3.9.0版本的功能运行,无需为了该提示强行升级SDK版本。
升级Google Maps SDK到4.1.0的正确方式
- 不要跨版本手动在Podfile中锁定原生SDK版本,要适配4.1.0版本的Google Maps iOS SDK,需要将
google_maps_flutter插件升级到^2.2.0及以上的版本,这一版本的插件已经默认适配4.x版本的原生SDK,不会出现依赖冲突。 - 配置API Key的访问限制时,需要在Google Cloud控制台将Key的应用平台设置为iOS,无平台限制的Key在模拟器环境下也可能出现加载异常。
内容的提问来源于stack exchange,提问作者Y.A.D
相关产品推荐
相关产品推荐

