跳转到主要内容

​
概览

以下指南将帮助您在移动应用程序中设置 OneSignal SDK。对于网站，请参阅网页设置。 对于您的移动应用程序支持的每个平台，您都需要与 FCM（Android）、APNS（iOS）、HMS（华为）和/或 ADM（亚马逊）建立连接。使用下面的选项来配置您的 OneSignal 应用程序和平台。

​
配置您的 OneSignal 应用和平台

推送通知所需设置 要开始使用 OneSignal 发送推送通知，您必须首先为您支持的所有平台配置 OneSignal 应用——Apple (APNs)、Google (FCM)、华为 (HMS) 和/或 Amazon (ADM)。
如果您的组织已有 OneSignal 账户，请要求邀请您为管理员角色以配置应用。否则，请注册免费账户以开始使用。
您可以在单个 OneSignal 应用下管理多个平台（iOS、Android、华为、Amazon、Web）。
1

创建或选择您的应用

  • 要向现有应用添加平台，请在 OneSignal 控制台中转到 设置 > 推送和应用内。
  • 要重新开始，请点击 新应用/网站 并按照提示操作。

示例显示创建新应用。

2

设置并激活平台

  • 为您的应用和组织选择一个清晰且易识别的名称。
  • 选择您要配置的平台（iOS、Android 等）。
  • 点击 下一步：配置您的平台。

设置首个 OneSignal 应用、组织和频道的示例。

3

配置平台凭据

根据您的平台按照提示操作：输入您的凭据后点击 保存并继续。
4

选择目标 SDK

选择与您的开发平台匹配的 SDK（例如，iOS、Android、React Native、Unity），然后点击 保存并继续。

选择您正在使用的 SDK 以导航到文档。

5

安装 SDK 并保存您的应用 ID

配置好您的平台后，将显示您的 OneSignal 应用 ID。复制并保存此 ID——在安装和初始化 SDK 时您将需要它。如果与他人协作，请使用 邀请 按钮添加开发人员或团队成员，然后点击 完成 以完成设置。

保存您的应用 ID 并邀请其他团队成员。

完成后，请遵循您所选平台的 SDK 安装指南以完成 OneSignal 集成。

​
SDK 设置指南

Google Android Native
使用 FCM 将 OneSignal 集成到原生 Android 应用程序中的指南。

iOS Native
使用 Apple 的 APNS 服务的原生 iOS SDK 设置。

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

Unity
基于 Unity 的移动应用的跨平台 SDK 指南。

React Native & Expo
React Native 和 Expo 环境的设置说明。

Cordova
使用旧框架的 Cordova 应用的旧版 SDK 指南。

Ionic & Ionic Capacitor
Ionic 和 Capacitor 混合移动应用的设置。

Flutter
使用 Dart 的 Flutter 应用的 SDK 指南。

.NET MAUI
与 .NET MAUI 应用集成的指南。

​
集成

​
常见问题

​
SDK 是必需的吗？

不必需，但强烈建议——并且在 GitHub 上开源。 您可以仅使用我们的服务器端 API 集成 OneSignal，但使用我们的 SDK 可以简化和简化流程，尤其是在跨平台处理推送通知时。

​
没有 SDK 您可以做什么：

您可以直接使用以下 API：
如果您计划使用应用内消息，需要我们的 SDK。

​
为什么我们建议使用 SDK：

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

​
中国的设备可以接收推送通知吗？

如果设备有 Google Play 服务/商店，它将通过 FCM（Firebase Cloud Messaging）接收推送通知。 如果应用是从华为应用市场下载的，它将通过 HMS（华为消息服务）接收推送通知。您需要设置我们的华为 SDK。 OneSignal 对支持 HMS 和 FCM 的设备默认使用 FCM。您可以设置华为 SDK 以优先使用 HMS 而不是 FCM。

​
非鸿蒙系统的华为 Android 设备可以接收 OneSignal 推送吗？

是的，运行 Android 的非鸿蒙华为设备仍可以使用我们的华为 SDK。
⌘I