如何在Xcode 14.1中通过Swift Package Manager正确安装Mapbox Search？

以下是针对该问题的排查和修复步骤：

1. 确认Package仓库URL正确性 #

确保添加的Mapbox Search仓库URL为官方地址：https://github.com/mapbox/mapbox-search-ios.git

• 进入Xcode项目设置 → Package Dependencies
• 删除现有Mapbox Search条目，重新添加上述URL
• 指定版本时使用精确版本号（如v1.0.0-beta.21），避免模糊版本范围导致解析冲突

2. 验证版本兼容性 #

Mapbox Search部分beta版本对Xcode/Swift版本有要求：

• 查看Mapbox Search发布说明，确认v1.0.0-beta.21是否兼容Xcode 14.1（Swift 5.7）
• 若不兼容，可尝试降级到适配的Search版本，或升级Xcode至14.3及以上版本（SPM稳定性更佳）

3. 清理SPM缓存 #

Xcode的SPM缓存可能引发依赖解析异常：

• 关闭Xcode
• 删除以下路径的缓存文件：
  • ~/Library/Caches/org.swift.swiftpm
  • ~/Library/Developer/Xcode/DerivedData
• 重启项目，等待SPM重新拉取并解析依赖

4. 检查访问令牌权限 #

确保你的Mapbox访问令牌具备search:read权限：

• 在Mapbox官网的令牌管理页面确认权限配置
• 项目Info.plist中已正确配置MGLMapboxAccessToken键及对应令牌值

5. 手动集成备选方案 #

若SPM方式持续失败，可尝试手动集成：

• 从官方发布页面下载对应版本的.xcframework包（包含MapboxSearch.xcframework和MapboxSearchCore.xcframework）
• 将框架拖入项目，在Frameworks, Libraries, and Embedded Content中设置为Embed & Sign

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