如何在Swift Playgrounds中安装Google Maps SDK？

哎，我之前也在Swift Playgrounds里折腾过Google Maps SDK，确实和普通iOS项目的玩法不一样，官方的iOS教程那套流程在Playgrounds里根本走不通。结合我踩过的坑，给你几个可行的解决思路：

1. 优先用Swift Package Manager（SPM）导入 #

这是目前在Playgrounds里导入第三方框架最稳定的方式，步骤很简单：

• 打开你的Swift Playground，点击顶部菜单栏的 + 号，选择「Add Package Dependency」
• 在弹出的输入框里填入Google Maps SDK的SPM仓库地址：https://github.com/googlemaps/google-maps-ios-sdk
• 选择一个最新的稳定版本，勾选GoogleMaps包完成导入
• 最后在代码开头加上 import GoogleMaps 就能调用SDK的API了

2. 手动导入框架（应急方案，不推荐） #

如果SPM方式遇到网络问题，你可以试试手动导入，但要注意Playgrounds的沙箱限制：

• 从Google官网下载iOS版Google Maps SDK压缩包，解压后找到GoogleMaps.framework和GoogleMapsCore.framework
• 在Playgrounds左侧的「Files」面板里，把这两个框架直接拖进去
• 代码里导入框架后，可能会遇到权限或兼容性报错，所以这个方法只适合临时测试

3. 关键配置：API Key与权限 #

导入框架后还得确保配置正确，不然还是会报错：

• 在代码最开头先设置你的Google Maps API Key：GMSServices.provideAPIKey("你的API Key")
• 检查你的API Key是否已经启用了「Maps SDK for iOS」权限，并且暂时取消包名限制（Playgrounds的包名是com.apple.dt.playgroundrunner开头的，测试阶段可以先放开限制，后续再调整）

为什么按照iOS教程操作会出错？ #

官方iOS教程里用的是CocoaPods或手动导入到Xcode项目的方式，但Swift Playgrounds并不支持CocoaPods，而且项目结构和普通iOS App完全不同，所以直接照搬肯定会出问题。

如果还是有问题，建议新建一个空白Playground，只写导入框架和初始化地图的最简代码，先验证SDK能不能正常运行，再逐步添加你的业务代码。

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