> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Extension Integrator Tool への移行

> Flutter アプリで、手動での iOS 通知拡張機能のセットアップから MoEngage Extension Integrator Tool に移行します。

このガイドのすべての手順は Xcode で実行します。先に進む前に、Xcode で `ios/Runner.xcworkspace` を起動して iOS プロジェクトを開いてください。

既存の手動実装から Integrator Tool に移行するには、以下の手順に従ってください。

### ステップ 1: 前提条件

先に進む前に、以下が揃っていることを確認してください。

* Extension Integrator Tool を利用するには、MoEngage Flutter SDK バージョン [10.6.0](/docs/ja/release-notes/sdks/flutter#core-10-6-0) 以上を使用していることを確認してください。
* **SDK の初期化:** [ファイルベースの初期化](/docs/ja/developer-guide/flutter-sdk/sdk-integration/sdk-initialization/file-based-initialization)を使用して MoEngage SDK を初期化します。
  * **App Group の設定:** `sdkConfig.appGroupID` で使用している `AppGroupName` キー（例: `group.com.organization.app`）を指定します。
* 統合が完了すると、コード署名のためにキーチェーンへのアクセスを求められる場合があります。**常に許可** をクリックしてください。
  <Frame>
    <img src="https://mintcdn.com/moengage/X586_MHJ15DsSG1z/images/keychain.png?fit=max&auto=format&n=X586_MHJ15DsSG1z&q=85&s=bba38a4dc7160d9ee9eafc785c9dc5ba" alt="キーチェーン" title="キーチェーン" style={{ width:"48%" }} className="mr-auto" width="1040" height="404" data-path="images/keychain.png" />
  </Frame>

### ステップ 2: MoEngageRichNotification の統合

次のいずれかのプッシュ通知機能をサポートする必要がある場合は、`MoEngageRichNotification` を統合します。

* **リッチメディア** — 通知バナーに画像、GIF、動画を表示する
* **リッチプッシュテンプレート** — カルーセルなどのインタラクティブな通知レイアウトをレンダリングする

<Info>
  Content Extension を統合している場合、この手順は必須です。
</Info>

<Tabs>
  <Tab title="Swift Package Manager (SPM)">
    SPM を使用して `MoEngageRichNotification` をインストールするには、次の手順を実行します。

    1. **File > Add Package** に移動します。
    2. リポジトリの URL を入力します。
       * `https://github.com/moengage/apple-sdk.git`
    3. **master** ブランチまたは特定のバージョンを選択し、**Add Package** を選択します。
    4. パッケージのターゲットをアプリケーションに設定します。
  </Tab>

  <Tab title="CocoaPods">
    <Warning>
      **お知らせ** CocoaPods は非推奨になりつつあります。MoEngage では、すべての新規統合に Swift Package Manager を使用することをお勧めします。詳細については、[こちら](/docs/ja/developer-guide/ios-sdk/sdk-integration/basic/sdk-integration)を参照してください。
    </Warning>

    1. アプリターゲット内の `Podfile` に次の行を追加します。

    <Info>
      `moengage_flutter` パッケージには既に `MoEngage-iOS-SDK` が含まれているため、`RichNotification` サブスペックを追加するだけで済みます。
    </Info>

    ```ruby lines wrap theme={null}
    pod 'MoEngage-iOS-SDK/RichNotification'
    ```

    2. pod install を実行します。

    ```ruby lines wrap theme={null}
     pod repo update
     pod install
    ```
  </Tab>
</Tabs>

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

ビルドプロセスにカスタムスクリプトを追加して、拡張機能の設定を自動化します。

1. Xcode でアプリケーションターゲットを選択し、**Build Phases** に移動して **+** をクリックし、**New Run Script Phase** を追加します。

<Frame>
  <img src="https://mintcdn.com/moengage/F4npPBVazsQn0JKX/images/newrunscriptphase.png?fit=max&auto=format&n=F4npPBVazsQn0JKX&q=85&s=4c0db98aafc37139866d3cd48765ef80" alt="New Run Script Phase" title="New Run Script Phase" className="mr-auto" style={{ width:"54%" }} width="1094" height="944" data-path="images/newrunscriptphase.png" />
</Frame>

<Info>
  既にスクリプトフェーズを追加して入力ファイルを設定している場合は、以下の手順 3 で説明するように実行コマンドを更新するだけで済みます。
</Info>

2. **Input Files** セクションに次のパスを追加します。

* `$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)`
* `$(INSTALL_DIR)/$(INFOPLIST_PATH)`

<Frame>
  <img src="https://mintcdn.com/moengage/F4npPBVazsQn0JKX/images/path-1.png?fit=max&auto=format&n=F4npPBVazsQn0JKX&q=85&s=e38b6527f2e8dd128e6d1642f12e32ee" alt="パス 1" title="パス 1" style={{ width:"54%" }} className="mr-auto" width="1096" height="908" data-path="images/path-1.png" />
</Frame>

3. 手順 1 で追加した Run Script Phase のシェルスクリプト入力ボックスに、使用している依存関係マネージャーに応じたコマンドを入力し、`$OPTIONS` を目的の設定に置き換えます。

<Tabs>
  <Tab title="Swift Package Manager (SPM)">
    ```bash Swift Package Manager (SPM) lines wrap theme={null}
    case "$ACTION" in
      install) SPM_ROOT="$OBJROOT/../../../../.." ;;   # xcodebuild archive
      *)       SPM_ROOT="$OBJROOT/../.." ;;            # build / run from Xcode
    esac
    "$SPM_ROOT/SourcePackages/artifacts/apple-sdk/moengage-extensions-integration/moengage-extensions-integration.artifactbundle/moengage-extensions-integration/bin/moengage-extensions-integration" $OPTIONS
    ```
  </Tab>

  <Tab title="CocoaPods">
    ```bash CocoaPods lines wrap theme={null}
    ${PODS_ROOT}/MoEngageExtensionsIntegration/moengage-extensions-integration.artifactbundle/moengage-extensions-integration/bin/moengage-extensions-integration $OPTIONS
    ```
  </Tab>
</Tabs>

#### 利用可能なオプション

`$OPTIONS` を次の 1 つ以上に置き換えます。

| オプション | 説明 |
| :- | :- |
| `--enable-push-notification-templates` | ステップ 2 の Content Extension を使用する場合に必須です。 |
| `--notification-service-extension-name $CUSTOM_SERVICE_EXTENSION_NAME` | Service Extension のカスタム名を設定します。カスタムの Service Extension 実装からこのツールに移行する場合に使用します。（デフォルト: `MoEngageNotificationService`） |
| `--notification-content-extension-name $CUSTOM_CONTENT_EXTENSION_NAME` | Content Extension のカスタム名を設定します。カスタムの Content Extension 実装からこのツールに移行する場合に使用します。（デフォルト: `MoEngageNotificationContent`） |

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

**Frameworks**、**Libraries**、**Embedded Content** セクションに追加されている既存の Service Extension と Content Extension を削除します。

<Frame>
  <img src="https://mintcdn.com/moengage/xuAxu0ab-ChXtexC/images/removeexistingextensions.png?fit=max&auto=format&n=xuAxu0ab-ChXtexC&q=85&s=f788a1e626bf9799cd9f857cc6d7b5aa" alt="既存の拡張機能の削除" title="既存の拡張機能の削除" style={{ width:"62%" }} width="1024" height="705" data-path="images/removeexistingextensions.png" />
</Frame>

<Warning>
  削除しないと、プッシュ配信のインプレッションやリッチプッシュ通知が機能しなくなります。
</Warning>