You need to enable JavaScript to run this app. Flutter接入google_maps_flutter 1.0.6时iOS地图不显示,指定Google Maps SDK 4.1.0.0安装Pod报错
优惠活动
大模型
产品
解决方案
定价
更多

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 ios
    • pod deintegrate
    • rm -rf Pods Podfile.lock
    • pod 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
    end
    
    配置完成后重新执行pod 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 06:54:09