Expo向けPushEngage
PushEngage React Native SDKとExpo開発ビルドを使用して、ExpoアプリでPushEngageを使用します。Expo GoはSDKのネイティブコードを実行できないためサポートされていません。
Expoでできること
ベアReact Nativeと同じAPI
開発ビルドが設定されれば、JavaScript APIはベアReact Nativeプロジェクトと同一になります。
開発ビルドでの完全なプッシュ機能セット
ガイドには、ディープリンク、セグメントと属性、目標追跡、トリガーキャンペーンがサポートされていると記載されており、さらに通知サービス拡張機能を追加するとリッチプッシュ通知も利用できます。
Expoツールは引き続き機能します
プリビルド後も、EAS BuildとEAS Updateによるオーバー・ザ・エア・アップデートを使用できます。
再生成されたプロジェクト用の設定プラグインの例
ネイティブフォルダがビルドごとに再生成される場合、ガイドにはコピーしてApp GroupキーとAndroid通知権限を再適用できるローカルExpo設定プラグインが含まれています。
expo-notificationsからのパス
ガイドでは、Expoの組み込みプッシュサービスを置き換える手順を説明しています。権限リクエストとタップハンドラーを切り替え、PushEngage REST API経由で送信します。
セットアップ方法
- expo-dev-clientと@pushengage/pushengage-react-nativeパッケージをインストールします。
- npx expo prebuild --clean を実行して、iosおよびandroidフォルダを生成します。
- iOSの場合、Xcodeで生成されたワークスペースを開き、プッシュ通知、リモート通知を含むバックグラウンドモード、およびApp Groupsを追加してから、Info.plistにPushEngage_App_Group_Keyを追加します。
- Androidの場合、JitPackリポジトリとGoogle Servicesプラグインを追加し、google-services.jsonをandroid/appに配置し、POST_NOTIFICATIONS権限をマニフェストに追加します。
- npx expo run:ios または npx expo run:android で、またはEAS Build開発プロファイルを使用して開発クライアントをビルドします。
- アプリが登録される前にindex.jsでアプリIDを使用してSDKを初期化し、アプリ内で通知権限をリクエストします。
- EAS Buildで本番ビルドを作成します。
知っておくと便利
- アプリプッシュとReact Native SDKは、無料プランを含むすべてのPushEngageプランに記載されています。目標追跡、カスタムトリガーキャンペーン、アプリ内メッセージには有料プランが必要です。
- ガイドには、Expo SDK 49以降、EAS CLI、iOS用のApple Developerアカウント、Android用のFirebaseプロジェクトが前提条件として記載されています。
- Expo GoはPushEngageを実行できません。シミュレーターはプッシュ通知を受信しないため、物理デバイスで開発ビルドでテストしてください。
- プリビルドはネイティブフォルダをゼロから再生成します。PushEngageの設定が失われないように、iosおよびandroidフォルダをコミットするか、設定プラグインを使用してください。
- プッシュ通知とバックグラウンドモードの機能にはエンタイトルメントが必要なため、設定プラグインだけでは設定できません。ガイドでは、Xcodeで一度設定することを推奨しています。
- PushEngageは独自のExpo設定プラグインを公開していません。ガイドにあるものは、プロジェクトにコピーするための例です。
この接続について
- Expoのサポートは、PushEngageが構築・保守しているPushEngage React Native SDKを通じて提供されます。Expoとの提携ではありません。
- 個別のExpoパッケージはありません。npmから@pushengage/pushengage-react-nativeをインストールします。
- PushEngageのAPIドキュメントでは、Expo開発ビルドは手動のネイティブ設定でサポートされ、ベアReact Nativeが推奨設定であり、Expo Goはサポートされていないと記載されています。
- SDKソースは、MITライセンスの下でawesomemotive/pushengage-react-nativeリポジトリのGitHubで公開されています。
PushEngageパートナーディレクトリ
Expoアプリにプッシュ通知を追加する準備はできましたか?セットアップガイドから始めてください。
PushEngageには無料プランがあるため、料金を支払う前にインストールして最初のキャンペーンを送信できます。