メインコンテンツへスキップ
このガイドのすべての手順は Xcode で実行します。先に進む前に iOS プロジェクトを開いてください。CocoaPods を使用している場合は ios/YourApp.xcworkspace、Swift Package Manager を使用している場合は ios/YourApp.xcodeproj を開きます。 既存の手動実装から Integrator Tool に移行するには、以下の手順に従います。

ステップ 1: 前提条件

先に進む前に、以下が整っていることを確認してください。
  • Extension Integrator Tool を利用するには、MoEngage React Native SDK バージョン 12.6.0 以降を使用していることを確認してください。
  • SDK の初期化: ファイルベースの初期化を使用して MoEngage SDK を初期化します。
    • App Group の設定: sdkConfig.appGroupID で使用している AppGroupName キー(例: group.com.organization.app)を指定します。
  • 統合が完了した後、コード署名のためにキーチェーンへのアクセスを求められる場合があります。常に許可 をクリックしてください。
    キーチェーン

ステップ 2: MoEngageRichNotification の統合

以下のいずれかのプッシュ通知機能をサポートする必要がある場合は、MoEngageRichNotification を統合します。
  • リッチメディア — 通知バナーに画像、GIF、動画を表示します
  • リッチプッシュテンプレート — カルーセルなどのインタラクティブな通知レイアウトをレンダリングします
コンテンツ拡張機能を統合している場合、この手順は必須です。
React Native アプリケーションで Swift Package Manager を使用している場合は、このステップをスキップしてください。npx react-native spm を実行すると、react-native-moengage にはすでに MoEngageRichNotification が含まれています。apple-sdk パッケージを別途追加しないでください。そのバージョンがプラグインで使用されているバージョンと異なる場合、Xcode でパッケージの解決に失敗します。MoEngageRichNotification を自分で追加するのは、それをインポートする独自の Notification Service Extension または Content Extension のコードを管理している場合のみです。その場合は、Dependency Rule を Exact Version に設定して https://github.com/moengage/apple-sdk.git を追加します。Xcode の Package Dependencies に表示されている apple-sdk のバージョンを使用し、MoEngage React Native パッケージをアップグレードするたびに更新してください。既存の CocoaPods 統合を SPM に移行するには、CocoaPods から SPM への移行を参照してください。

ステップ 3: Extension Integrator Tool の統合

ビルドプロセスにカスタムスクリプトを追加して、拡張機能の設定を自動化します。
  1. Xcode でアプリケーションのターゲットを選択し、Build Phases に移動して + をクリックし、New Run Script Phase を追加します。
New Run Script Phase
すでにスクリプトフェーズを追加して入力ファイルを設定済みの場合は、以下の手順 3 で説明する実行コマンドを更新するだけで済みます。
  1. Input Files セクションに次のパスを追加します。
  • $(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)
  • $(INSTALL_DIR)/$(INFOPLIST_PATH)
パス 1
  1. 手順 1 で追加した Run Script Phase のシェルスクリプト入力ボックスに、使用している依存関係マネージャーに対応するコマンドを入力し、$OPTIONS を目的の設定に置き換えます。
Swift Package Manager (SPM)

利用可能なオプション

$OPTIONS を次のいずれか 1 つ以上に置き換えます。

ステップ 3: 既存の拡張機能の削除

Frameworks、Libraries、Embedded Content セクションに追加されている既存のサービス拡張機能とコンテンツ拡張機能を削除します。
既存の拡張機能の削除
削除しないと、プッシュ配信のインプレッションとリッチプッシュ通知が機能しなくなります。