跳转到主要内容
OneSignal 移动 SDK 在您的 iOS、Android、Huawei 和 Amazon 应用中启用推送通知、应用内消息和 Live Activities。设置分为两个步骤：
  1. 配置平台凭据 — 将您的 FCM、APNs、HMS 或 ADM 凭据连接到 OneSignal
  2. 集成 SDK — 为您的平台安装 OneSignal SDK 并在您的应用中初始化它
对于网站，请参阅 Web SDK 设置。

​
配置平台凭据

每个平台都需要自己的推送凭据。在集成 SDK 之前，请为您的应用支持的每个平台配置凭据。

​
配置您的 OneSignal 应用和平台

使用您支持的平台配置您的 OneSignal 应用——Apple (APNs)、Google (FCM)、华为 (HMS) 和/或 Amazon (ADM)。
如果您的组织已有 OneSignal 账户，请申请加入组织。否则，请注册免费账户以开始使用。
1

创建或选择您的应用

点击 新应用/网站 创建新应用，或在 设置 > 推送和应用内 中向现有应用添加平台。选择您要配置的平台，然后点击 下一步：配置您的平台。
OneSignal 控制台显示包含组织名称、应用名称和频道选择的新应用设置流程
2

配置平台凭据

为您的平台输入凭据：输入您的凭据后点击 保存并继续。
3

保存您的应用 ID 并安装 SDK

您的 应用 ID 显示在最终屏幕上。复制并保存它——初始化 SDK 时需要使用它。选择您的 SDK 平台，然后按照设置指南操作。
OneSignal 控制台显示设置完成后的应用 ID 和团队邀请选项

​
集成 SDK

Android 原生

使用 FCM 将 OneSignal SDK 集成到原生 Android 应用中。

iOS 原生

使用 APNs 将 OneSignal SDK 集成到原生 iOS 应用中。

React Native 和 Expo

适用于 React Native 和 Expo 环境的设置。

Flutter

使用 Dart 的 Flutter 应用的 SDK 设置。

Unity

适用于 Unity 移动应用的跨平台 SDK 设置。

.NET MAUI

将 OneSignal SDK 与 .NET MAUI 应用集成。

华为 Android 原生

使用 HMS 推送服务的华为设备 SDK 设置。

Cordova、Ionic 和 Capacitor

适用于 Cordova、Ionic 和 Capacitor 混合移动应用的设置。

​
其他集成

FlutterFlow

适用于 FlutterFlow 应用的低代码 SDK 设置。

Median.co

Median.co（原 GoNative.io）应用的集成指南。

​
SDK 版本

​
常见问题

​
SDK 是必需的吗？

不需要，但强烈推荐——并且在 GitHub 上开源。您可以仅使用 REST API 集成 OneSignal，但 SDK 能显著简化流程，尤其是在跨平台处理推送通知时。

​
没有 SDK 可以做什么？

您可以直接使用以下 API：
应用内消息和 Live Activities 需要 SDK——它们无法仅通过 API 投递。

​
为什么建议使用 SDK？

推送通知有 SDK 为您处理的平台特定要求，包括：
  • 在 Android、iOS、Huawei 和 Web 上获取推送令牌
  • 管理订阅状态和用户选择加入提示
  • 在客户端显示和处理推送通知
Apple 的 APNs 和 Google 的 FCM 使用不同的负载格式。OneSignal SDK 解析自定义负载以准确显示和跟踪消息。手动维护这些会增加相当大的复杂性。了解更多：构建与购买：构建推送通知平台的要素

​
iOS 和 Android 是否需要单独的 OneSignal 应用？

不需要。一个 OneSignal 应用支持多个平台——iOS、Android、Huawei、Amazon 和 Web。在 设置 > 推送和应用内 中配置每个平台的凭据，它们都共享同一个应用、用户和细分。

​
中国或华为设备能接收推送通知吗？

如果设备有 Google Play 服务，它通过 FCM 接收推送。如果应用是从华为应用市场下载的（包括运行 Android 的非鸿蒙华为设备），它通过 HMS 接收推送——请设置华为 SDK 以启用此功能。OneSignal 对同时支持 HMS 和 FCM 的设备默认使用 FCM。如有需要，您可以优先使用 HMS 而不是 FCM。