You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

iOS构建报错framework not found GoogleMapsCore问题咨询

iOS构建报错ld: framework not found GoogleMapsCore排查修复方案

按问题出现概率从高到低依次排查操作:

  • 确认项目打开方式正确:如果使用CocoaPods管理依赖,禁止直接打开.xcodeproj后缀的项目文件编译,必须打开项目根目录下的.xcworkspace文件启动项目。
  • 重新安装关联依赖:
    CocoaPods管理的项目在终端执行以下命令:
    # 进入项目根目录,替换为你本地的项目实际路径
    cd your_local_project_path
    # 清理旧的依赖关联配置
    pod deintegrate
    # 更新本地Spec源并重新安装所有依赖
    pod install --repo-update
    
    Swift Package Manager管理的项目,在Xcode顶部菜单依次选择File > Packages > Reset Package Caches,等待依赖重新拉取校验完成即可。
    Carthage管理的项目执行carthage update --platform iOS,完成后重新将编译生成的GoogleMapsCore框架添加到项目链接配置中。
  • 检查框架搜索路径配置:打开项目对应Target的Build Settings,搜索Framework Search Paths,确认GoogleMapsCore框架所在目录已被正确添加,建议将对应路径的搜索模式设为recursive。如果之前配置的是本地绝对路径,项目移动存储目录后会出现路径失效,替换为相对路径即可修复。
  • 检查链接阶段配置:进入Target的Build Phases > Link Binary With Libraries,如果列表里存在标红的GoogleMapsCore无效条目,直接删除即可,依赖重新安装后会自动关联正确的框架文件。
  • 彻底清理构建缓存:
    执行终端命令删除Xcode全局构建缓存:
    rm -rf ~/Library/Developer/Xcode/DerivedData/*
    
    回到Xcode按下快捷键Cmd + Shift + K清理项目临时构建文件,再重新执行构建。
  • 校验SDK版本一致性:如果最近更新过GoogleMaps相关SDK,确认GoogleMaps、GoogleMapsBase、GoogleMapsCore三个关联框架的版本号完全一致,版本不匹配也会触发链接失败,可回退到上一次正常构建时的版本号重新安装依赖。
  • 架构配置校验:如果最近调整过支持的CPU架构或最低系统版本,确认当前使用的GoogleMaps SDK版本支持你配置的架构范围,Debug模式下可暂时将Build Active Architecture Only设为YES,排除模拟器/真机架构不匹配的问题。

内容的提问来源于stack exchange,提问作者Sathesh Kumar

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.29 03:06:20