iMessage应用内Google Maps的mapView仅显示灰色问题排查求助

Google Maps SDK对iMessage应用没有额外的特殊配置要求，你遇到的仅显示logo的灰屏问题基本都是iMessage扩展和普通iOS App的差异点导致的，可按以下步骤排查：

• 首先检查bundle ID配置：iMessage应用本质是iOS App Extension，拥有独立的bundle identifier，你需要在Google Cloud控制台的API Key限制规则中，同时添加主容器App和iMessage扩展的两个bundle ID，仅绑定主App的ID会导致地图鉴权失败。
• 调整API密钥初始化时序：确认provideAPIKey方法的调用时机，必须早于任何GMSMapView实例的创建操作。iMessage扩展的生命周期和普通iOS App不同，建议将初始化逻辑提前到MSMessagesAppViewController的初始化方法（如initWithCoder:）中执行，避免viewDidLoad时序晚于地图实例化导致鉴权失效。
• 检查依赖集成配置：打开Podfile确认Google Maps SDK的依赖已经同时添加到主App和iMessage扩展的两个target下，仅给主target添加依赖会导致扩展运行时缺失SDK资源文件，出现仅显示Google logo的灰屏问题。
• 验证网络权限与端点可用性：iMessage扩展的网络权限独立校验，可先在扩展中添加测试逻辑验证能否正常访问Google Maps服务端点；同时检查扩展的Info.plist中ATS配置是否符合要求，避免网络请求被拦截。
• 测试SDK版本兼容性：当前使用的Google Maps SDK版本可能存在对iMessage扩展的兼容问题，可尝试升级到最新稳定版SDK，或切换到此前验证过兼容扩展场景的历史版本测试。
• 排查视图渲染问题：给GMSMapView设置明显的背景色并固定宽高约束，确认地图视图本身已被正确添加到视图层级且frame参数正常，排除因视图布局错误导致的渲染异常。

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