AWS Amplify CLI 中 Firebase Cloud Messaging (FCM) API 迁移指南

背景与问题概述

随着 Firebase Cloud Messaging (FCM) 服务的演进，Google 宣布将于 2024 年 6 月 20 日弃用 Cloud Messaging API (Legacy) 版本，所有用户需要迁移至 Firebase Cloud Messaging API (V1) 版本。这一变更对使用 AWS Amplify CLI 集成推送通知功能的开发者产生了直接影响。

技术影响分析

在 AWS Amplify CLI 12.4.0 及更早版本中，文档和实现都是基于 FCM 的 Legacy API。这意味着：

1. 开发者无法在新创建的 FCM 项目中获取 Legacy API 密钥
2. 现有使用 Legacy API 的项目将在截止日期后停止工作
3. Amplify CLI 原本不支持直接使用 FCM V1 的服务账户 JSON 文件

解决方案与更新

AWS Amplify 团队已经发布了 12.12.3 版本，该版本完全支持 FCM V1 API。主要改进包括：

1. 支持直接使用 FCM V1 的服务账户 JSON 文件进行配置
2. 更新了 Android 平台的推送通知设置文档
3. 确保与 SNS 服务的 FCM V1 支持兼容

迁移建议

对于正在使用或计划使用 AWS Amplify 推送通知功能的开发者，建议采取以下步骤：

1. 立即升级到 Amplify CLI 12.12.3 或更高版本
2. 按照新版本文档重新配置 FCM 集成
3. 测试推送通知功能确保正常工作
4. 对于生产环境，建议在截止日期前完成迁移

技术实现要点

新版本的 FCM V1 集成主要变化在于认证方式：

1. 从使用简单的 API 密钥改为使用服务账户 JSON 文件
2. 需要确保服务账户具有正确的 FCM 权限
3. 配置流程更加标准化，与 Firebase 其他服务保持一致

总结

AWS Amplify CLI 已经及时跟进 FCM API 的变更，开发者只需升级到最新版本并按照更新后的文档操作，即可顺利完成迁移。这一更新确保了推送通知功能的持续可用性，同时也为开发者提供了更现代的 API 集成方式。