移动 SDK 设置

​

概览

以下指南将帮助您在移动应用程序中设置 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

配置平台凭据

根据您的平台按照提示操作：

• Android：设置 Firebase 凭据
• iOS：p8 令牌（推荐） 或 p12 证书
• Amazon：生成 API 密钥
• 华为：授权 OneSignal

输入您的凭据后点击 保存并继续。

4

选择目标 SDK

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

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

5

安装 SDK 并保存您的应用 ID

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

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

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

---

​

SDK 设置指南

​

集成

• Flutterflow SDK Setup
• Median.co (formerly GoNative.io)

---

​

常见问题

​

SDK 是必需的吗？

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

​

没有 SDK 您可以做什么：

您可以直接使用以下 API：

• Create user
• Create subscription
• Update user
• Update subscription
• Create message
• OSNotification payload

​

为什么我们建议使用 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。