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

# リッチプッシュ通知

> iOSのリッチプッシュ通知に必要なNotification Service Extension、App Groups、SDKの設定とテスト手順を説明します。

> [tab] iOS
>
> リッチプッシュ通知は、画像や動画を含むプッシュメッセージを表示し、プッシュ通知の配信指標を収集する機能です。
> iOSでのみ利用できます。FlutterとReact Nativeのアプリでも、iOSターゲットのビルド時には同じ設定が必要です。
>
> > [!NOTE]
> >
> > 必要なSDKバージョン
> >
> > * iOS SDK 1.3.0以降
> > * React Native SDK 3.0.4以降
> > * Flutter SDK 1.2.3以降
>
> ## 1. Notification Service Extensionを設定する
>
> 1. Xcodeでプロジェクトを開きます。FlutterまたはReact Nativeのプロジェクトでは、`ios`フォルダー内の`.xcworkspace`ファイルを選択します。
>
>    ![Xcodeでプロジェクトを開く](https://mintcdn.com/notifly/QWigoXWbDguqzkH4/ko/developer-guide/image/ios_push_extension_open_project_navigator.png?fit=max\&auto=format\&n=QWigoXWbDguqzkH4\&q=85\&s=f7d64b51b5a3189c21d29157d7ebde7f)
>
> 2. Project Navigatorでプロジェクトを選択し、**+**ボタンをクリックして**Notification Service Extension**を追加します。
>
>    ![Notification Service Extensionのターゲットを追加する](https://mintcdn.com/notifly/QWigoXWbDguqzkH4/ko/developer-guide/image/ios_push_extension_create_extension_target.png?fit=max\&auto=format\&n=QWigoXWbDguqzkH4\&q=85\&s=566572364266614aa62fd21b1ad96fcd)
>
> 3. **Product Name**を`NotiflyNotificationExtension`に設定し、**Finish**をクリックします。
>
>    ![Notification Service Extensionに名前を設定する](https://mintcdn.com/notifly/QWigoXWbDguqzkH4/ko/developer-guide/image/ios_generate_push_extension.png?fit=max\&auto=format\&n=QWigoXWbDguqzkH4\&q=85\&s=3847ad7846dc9afab990338371c53c22)
>
> 作成した拡張機能のバージョンが、メインアプリと同じであることを確認します。
>
> ![拡張機能とアプリのバージョンをそろえる](https://mintcdn.com/notifly/QWigoXWbDguqzkH4/ko/developer-guide/image/ios_push_extension_version.png?fit=max\&auto=format\&n=QWigoXWbDguqzkH4\&q=85\&s=1b26e07b5fddc9ca3c2bf3ec3ff9cf36)
>
> 拡張機能のターゲットで、iOSの最小デプロイバージョンを使用するSDKに合わせて設定します。現行のNotifly iOS SDKにはiOS 15.0以降が必要です。
>
> ## 2. App Groupsを設定する
>
> 1. グループIDは`group.notifly.{username}`の形式にします。`username`は、NotiflyコンソールのSDK認証情報で確認できます。
>
> 2. メインアプリのターゲットと拡張機能のターゲットの両方で、**Signing & Capabilities**タブに**App Groups**を追加します。両方に同じグループ名`group.notifly.{username}`を設定します。
>
>    ![メインアプリと拡張機能のApp Groupを設定する](https://mintcdn.com/notifly/0_mniRtlC78csfem/images/i18n/en/developer-guide/ios/ios-push-extension-app-group1.png?fit=max\&auto=format\&n=0_mniRtlC78csfem\&q=85\&s=a32c02a390c48642394d43593bd7585f)
>
> ## 3. SDKを追加する
>
> > [tab] CocoaPods
> >
> > 拡張機能のターゲットに、Notifly SDKを静的ライブラリとしてインストールします。
> >
> > ```swift theme={null}
> > target 'NotiflyNotificationExtension' do
> >   use_frameworks! :linkage => :static
> >   pod 'notifly_sdk_push_extension'
> > end
> > ```
>
> > [tab] Swift Package Manager
> >
> > 選択したSDKパッケージが、拡張機能用のライブラリプロダクトとして`notifly_sdk_push_extension`を提供していることを確認します。提供していない場合は、CocoaPodsの手順に従ってください。
> >
> > 1. Xcodeでプロジェクトを開き、**TARGETS** → `NotiflyNotificationExtension`を選択します。
> >
> > 2. 利用できる場合は、**General** → **Frameworks, Libraries, and Embedded Content**で`notifly_sdk_push_extension`を追加します。
>
> ## 4. 拡張機能のコードを追加する
>
> `NotiflyNotificationExtension/NotificationService.swift`に次のコードを追加します。
>
> > [!NOTE]
> >
> > Notiflyコンソールで**設定 > 製品とプロジェクト情報**を開きます。`PROJECT_ID`は**プロジェクト情報**の**プロジェクトID**、`USERNAME`は**SDK認証情報**の**ユーザー名**で確認できます。
>
> > [tab] 既存のExtensionがない場合
> >
> > ```swift theme={null}
> > import notifly_sdk_push_extension
> >
> > class NotificationService: NotiflyNotificationServiceExtension {
> >     override init() {
> >         super.init()
> >         self.register(projectId: "{YOUR_PROJECT_ID}", username: "{YOUR_USERNAME}")
> >     }
> > }
> >
> > ```
>
> > [tab] 既存のExtensionがある場合
> >
> > ```swift theme={null}
> > import UserNotifications
> > import notifly_sdk_push_extension
> >
> > class NotificationService: NotiflyNotificationServiceExtension {
> >     override init() {
> >         super.init()
> >         self.register(projectId: "{YOUR_PROJECT_ID}", username: "{YOUR_USERNAME}")
> >     }
> >
> >     override func didReceive(_ request: UNNotificationRequest,
> >                              withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
> >         super.didReceive(request, withContentHandler: contentHandler)
> >         /* 既存のコードをここに追加します。 */
> >     }
> >
> >     override func serviceExtensionTimeWillExpire() {
> >         super.serviceExtensionTimeWillExpire()
> >         /* 既存のコードをここに追加します。 */
> >     }
> > }
> >
> > ```
>
> ## 5. 動作をテストする
>
> [連携をテストする](https://docs.notifly.tech/ja/integration-test.md)の手順に従ってテストします。
>
> 1. 画像付きプッシュ通知をテストします。
>
>    画像付きのプッシュ通知を送信し、端末に画像が表示されることを確認します。
>
> 2. 端末の受信記録を確認します。
>
>    テスト通知を送信し、Notiflyコンソールで対象ユーザーのプロフィールを開きます。メッセージ履歴に**기기 푸시 수신 성공**（端末でのプッシュ通知受信成功）が記録されていることを確認します。
>
>    ![ユーザープロフィールでプッシュ通知の受信記録を確認する](https://mintcdn.com/notifly/DHduOkdsm1-HMvmh/images/i18n/ja/developer-guide/ios/ios-push-delivered.png?fit=max\&auto=format\&n=DHduOkdsm1-HMvmh\&q=85\&s=c871db7d0c03153ee287a2a1b2ea7ba1)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.