メインコンテンツへスキップ

​
概要

次のガイドは、モバイルアプリでOneSignal SDKを設定するのに役立ちます。Webサイトについては、Webセットアップを参照してください。 モバイルアプリがサポートする各プラットフォームについて、FCM（Android）、APNS（iOS）、HMS（Huawei）、ADM（Amazon）との接続を確立する必要があります。以下のオプションを使用してOneSignalアプリとプラットフォームを構成します。

​
OneSignalアプリとプラットフォームを設定

プッシュ通知の必須セットアップ OneSignalでプッシュ通知の送信を開始するには、まずサポートするすべてのプラットフォーム（Apple（APNs）、Google（FCM）、Huawei（HMS）、Amazon（ADM））でOneSignalアプリを設定する必要があります。
組織がすでにOneSignalアカウントを持っている場合は、管理者ロールへの招待をリクエストしてアプリを設定します。それ以外の場合は、無料アカウントにサインアップして開始してください。
単一のOneSignalアプリで複数のプラットフォーム（iOS、Android、Huawei、Amazon、Web）を管理できます。
1

アプリを作成または選択

  • 既存のアプリにプラットフォームを追加するには、OneSignalダッシュボードでSettings > Push & In-Appに移動します。
  • 新規に開始するには、New App/Websiteをクリックしてプロンプトに従います。

新しいアプリを作成する例

2

プラットフォームをセットアップして有効化

  • アプリと組織の明確で認識可能な名前を選択します。
  • 設定するプラットフォーム（iOS、Androidなど）を選択します。
  • Next: Configure Your Platformをクリックします。

最初のOneSignalアプリ、組織、チャネルをセットアップする例

3

プラットフォーム認証情報を設定

プラットフォームに基づいてプロンプトに従います：認証情報を入力した後、Save & Continueをクリックします。
4

ターゲットSDKを選択

開発プラットフォーム（iOS、Android、React Native、Unityなど）に一致するSDKを選択し、Save & Continueをクリックします。

使用しているSDKを選択してドキュメントに移動

5

SDKをインストールしてApp IDを保存

プラットフォームが設定されると、OneSignal App IDが表示されます。このIDをコピーして保存してください - SDKのインストールと初期化時に必要になります。他のユーザーと共同作業する場合は、Inviteボタンを使用して開発者またはチームメイトを追加し、Doneをクリックしてセットアップを完了します。

App IDを保存して追加のチームメンバーを招待

完了したら、選択したプラットフォームのSDKインストールガイドに従って、OneSignalの統合を完了します。

​
SDKセットアップガイド

Google Android Native
FCMを使用してネイティブAndroidアプリにOneSignalを統合するためのガイド。

iOS Native
AppleのAPNSサービスを使用したネイティブiOS SDKセットアップ。

Huawei Android Native
HMSプッシュサービスを使用したHuaweiデバイス向けの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アプリとの統合ガイド。

​
統合

​
FAQ

​
SDKは必須ですか？

いいえ、ただし強く推奨されています。また、GitHubでオープンソースです。 サーバー側APIのみを使用してOneSignalを統合できますが、SDKを使用すると、特にプラットフォーム間でプッシュ通知を処理するプロセスが簡素化され、合理化されます。

​
SDKなしでできること：

次のAPIを直接使用できます：
アプリ内メッセージを使用する予定がある場合、SDKが必要です。

​
SDKの使用を推奨する理由：

プッシュ通知には、SDKが処理するプラットフォーム固有の要件があります：
  • Android、iOS、Huawei、Webにわたってプッシュトークンを取得
  • サブスクリプションステータスとオプトインのユーザープロンプトを管理
  • クライアントでプッシュ通知を表示および処理
AppleのAPNSとGoogleのFCMは異なるペイロード形式を使用します。OneSignal通知には、SDKが解析してメッセージを正確に表示および追跡するカスタムペイロードが含まれています。 これを手動で維持すると複雑さが増します。詳細については、こちらをご覧ください：Build vs. Buy: What Goes Into Building a Push Notification Platform

​
中国のデバイスはプッシュ通知を受信できますか？

デバイスにGoogle PlayサービスまたはGoogle Play Storeがある場合、FCM（Firebase Cloud Messaging）を通じてプッシュ通知を受信します。 アプリがHuawei AppGalleryからダウンロードされた場合、HMS（Huawei Messaging Service）を通じてプッシュ通知を受信します。Huawei SDKをセットアップする必要があります。 OneSignalは、HMSとFCMの両方をサポートするデバイスにはデフォルトでFCMを使用します。Huawei SDKをセットアップしてFCMよりもHMSを優先することができます。

​
Androidを実行している非HarmonyOS HuaweiデバイスはOneSignalからプッシュを受信できますか？

はい、Androidを実行している非HarmonyOS Huaweiデバイスは、Huawei SDKを引き続き使用できます。