你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
将 Android SDK 推送通知迁移到 Firebase Cloud Messaging HTTP v1
本文适用于将 Android SDK 与 Firebase Cloud Messaging (FCM) 推送通知配合使用的呼叫和聊天应用程序。 FCM 以前称为 Google Cloud Messaging (GCM/FCM)。
2023 年 6 月 20 日，Google 宣布弃用使用 FCM 旧版 API 发送消息。 Google 将于 2024 年 6 月停止提供旧版 FCM。 Google 建议从旧版 FCM API 迁移到 FCM HTTP v1。
如果你有新版 Android 应用程序或从未使用过 Google FCM，请参阅使用 FCM v1 注册 Android SDK 推送通知一文。
如果 Android 应用程序使用推送通知功能，请完成以下步骤，将推送通知迁移到 FCM HTTP v1。
1.在 Firebase 控制台中生成私钥
在 Firebase 控制台中打开项目。
打开“项目设置”>“服务帐户”。
选择任何编程语言。
单击“生成新私钥”，下载包含新私钥的 JSON 文件。
找到并打开下载的 JSON 文件。 在下一步中将用到此文件中的值。
2.提供 Google (FCM v1) 的私钥凭据
在 Azure 门户中打开 Azure 通信服务通知中心。
打开“设置”>“Google (FCM v1)”。
在“私钥”、“客户端电子邮件”和“项目 ID”的文本框中输入下载的 JSON 文件中的值。
单击“ 保存”。
3.删除 Google (GCM/FCM) 的旧凭据
在 Azure 门户中打开 Azure 通信服务通知中心。
打开“设置”>“Google (GCM/FCM)”。
清除“API 密钥”文本框。
单击“ 保存”。
4.验证应用程序可以接收推送通知
等待几分钟，以便你在通知中心所做的更改生效。 在此期间，应用程序可能会遇到重复的推送通知或错过的通知。
确保应用程序收到推送通知时不会出现错误。
故障排除
如果应用程序无法接收推送通知，请确保新的 FCM v1 凭据正确。 根据需要重复本文档中的步骤，以在 Firebase 控制台中生成私钥或提供 Google (FCM v1) 的私钥凭据。
如果应用程序仍无法接收推送通知，请通过 Microsoft Azure 帮助 + 支持联系 Azure 通信服务。