本指南适用于将 OneSignal 与通过 Google Play Store 分发的 Android 移动应用集成的开发者。
- 本指南不适用于 Web Push。请参阅 Web push 设置。
- 对于通过华为应用市场分发的华为应用，请参阅 华为：授权 OneSignal。
要求
- 通过 Google Play Store 分发的 Android 应用
- Firebase 账户（免费）
- OneSignal 账户
设置
1. 创建或打开您的 Firebase 项目
转到 Firebase 控制台。- 如果您还没有项目，请点击添加项目并完成设置。
- 如果您已有项目，请选择它。
2. 启用 Firebase Cloud Messaging API v1
3. 生成服务账户 JSON 文件
4. 将您的凭据上传到 OneSignal
将 OneSignal 应用 ID 添加到您的代码中
继续按照移动端 SDK 设置并将此 OneSignal 应用 ID 添加到您的代码中。
您已成功将 OneSignal 应用连接到 Firebase Cloud Messaging (V1)。接下来，完成移动端 SDK 设置或转到移动端推送设置获取平台特定的说明。
常见问题
错误：“此配置适用于不同的 Firebase 项目…”
当上传的 JSON 文件属于不同的 Firebase 项目（即不同的 Sender ID）时会出现此错误。 解决方案：使用原始 Firebase 项目的 JSON 文件。如果无法获得，请联系support@onesignal.com 并提供您的应用 ID。切换项目会重置推送令牌——您的用户必须重新打开应用才能再次接收推送。
我可以更改我的 Sender ID 吗？
不可以。一旦您的应用超过 100 个 Android 用户，Sender ID 就会被锁定，以防止意外使推送令牌失效。 如有必要，请联系support@onesignal.com 并提供您的应用 ID 寻求帮助。
切换到 FCM V1 时需要更新我的代码吗？
不需要应用或 SDK 更改——这只是仪表板更新。切换到 FCM v1 的截止日期是什么时候？
Google 于 2024 年 7 月开始弃用旧版 FCM API。强烈建议迁移。请参阅 Google 的公告。为什么我在 OneSignal 中看不到 Sender ID？
如果您的 Firebase 服务器密钥看起来像AIz...，您可能正在使用过时的 Google Cloud Messaging (GCM) 设置。请创建一个新的 Firebase 项目并上传服务账户 JSON 文件。
如何检查哪些应用仍在使用旧版 API？
使用 查看应用 API 并检查："gcm_key"→ 使用旧版，需要更新"fcm_v1_service_account_json"→ 使用 V1 ✅- 都没有 → 应用不使用 Android push