使用CocoaPods集成Google Maps时XCFramework构建失败求助

AI 小北

2026-6-24

解决Xcode 15.4 + Google Maps 8.4.0构建时的HeadersPath错误

针对你遇到的HeadersPath不支持的构建错误，可按以下步骤排查解决：

升级CocoaPods版本
这个错误主要是CocoaPods与Xcode 15.4的兼容性问题导致的。先查看当前版本：
```
pod --version
```
升级到最新稳定版：
```
sudo gem install cocoapods
# 若使用Homebrew安装则执行：brew upgrade cocoapods
```
之后执行以下命令重新安装依赖：
```
pod deintegrate
pod install
```
临时修改xcframework的Info.plist（应急方案）
找到对应xcframework的Info.plist文件，比如Pods/GoogleMaps/Base/Frameworks/GoogleMapsBase.xcframework/ios-arm64/GoogleMapsBase.framework/Info.plist，删除其中包含HeadersPath的键值对，保存后重新构建。注意：该操作会在下次pod install时被覆盖，仅作为临时应急手段。
验证SDK与Xcode版本兼容性
Google Maps 8.4.0可能尚未完全适配Xcode 15.4，可尝试降级到8.3.0版本：
修改Podfile中的版本声明：
```
pod 'GoogleMaps', '~> 8.3.0'
```
然后更新依赖：
```
pod update GoogleMaps
```
彻底清理缓存
除了DerivedData，还需清理CocoaPods全局缓存：
```
pod cache clean --all
```
删除项目根目录的Podfile.lock文件后，重新执行pod install。