iOS Swift バージョン 8.x.x を使用する iOS デバイスでよくあるプッシュ通知の問題を回避するには

​

問題

Swift バージョン 8.x.x を使用するデバイスにプッシュ通知が正常に配信されているにもかかわらず、プッシュキャンペーンのインプレッションがトラッキングされない、画像がレンダリングされないなど、プッシュ通知に関するよくある問題が発生しています。

​

解決策

次の手順を実行します。

1. 各構成でプロジェクトのメインターゲットに app_group_id があるか確認する： 構成間で同じ app_group_id を追加することも、異なるものを追加することもできます。
   構成で異なる Bundle Identifier を使用しながら同じ app_group_id を共有している場合、問題が発生する可能性があります。具体的には、Bundle Identifier が異なり app_group_id が同じ 2 つのアプリが同じデバイスにインストールされている場合、Notification Service Extension が失敗することがあります。 これを回避するために、複数の構成で同じ app_group_id を使用できますが、その場合は 1 台のデバイスですべてのアプリを同時にテストすることはできない点に注意してください。
   
2. SDK の初期化時に app_group_id があるか確認する：
   • info.plist を使用して SDK を初期化している場合は、info.plist ファイルの MoEngage キー内に APP_GROUP_ID キーが存在している必要があります。
   • sdkConfig を使用して SDK を初期化している場合は、AppDelegate ファイル内の sdkConfig 変数に APP_GROUP_ID が存在している必要があります。
     info.plist 内の app_group_id：
   sdkConfig 変数内の app_group_id：
   Swift

   var sdkConfig = MOSDKConfig.init(withAppID: "XXXXXXXXXXXXXXXX")
   sdkConfig.moeDataCenter = .data_center_0X
   sdkConfig.appGroupID = "group.com.XXXXXXXXXXXXXXXX"
   
   Objective-C

   MOSDKConfig* sdkConfig = [[MOSDKConfig alloc] initWithAppID: @"XXXXXXXXXXXXXXXX"];
   sdkConfig.moeDataCenter = MODataCenterData_center_0X;
   sdkConfig.appGroupID = @"group.com.XXXXXXXXXXXXXXXX";
   
3. Notification Service Extension ターゲットがあるか確認する：
   • Push Notifications を有効にする：Extension ターゲットの Signing & Capabilities セクションで、必ず Push Notifications を有効にし、AppGroupId を追加してください。
   • 最小デプロイ iOS バージョンを揃える：Notification Service Extension の最小デプロイ iOS バージョンが、メインアプリの iOS バージョンと一致していることを確認します。
   
4. MORichNotification フレームワークを Notification Service Extension ターゲットに統合します。
   Swift

   target 'MoEngageDemo' do
     use_frameworks!
     pod 'MoEngage-iOS-SDK'
   end
   target 'MoEngageNotificationService' do
     use_frameworks! #use use_frameworks only if included in main target as in above scenario
     pod 'MoEngageRichNotification'
   end
   
5. NotificationService.swift ファイルは次のようになります。
   Swift

   import UserNotifications
   import MoEngageRichNotification
    
   class NotificationService: UNNotificationServiceExtension {
    
       var contentHandler: ((UNNotificationContent) - Void)?
       var bestAttemptContent: UNMutableNotificationContent?
    
       override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) - Void) {	
         MORichNotification.setAppGroupID("group.com.XXXXXXXXXXXXXXXX")
         self.contentHandler = contentHandler
         bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
         MORichNotification.handle(richNotificationRequest: request, withContentHandler: contentHandler)
       }
       
       override func serviceExtensionTimeWillExpire() {
           // Called just before the extension will be terminated by the system.
           // Use this as an opportunity to deliver your "best attempt" at modified content, otherwise the original push payload will be used.
           if let contentHandler = contentHandler, let bestAttemptContent =  bestAttemptContent {
               contentHandler(bestAttemptContent)
           }
      
   
6. メインアプリターゲットの Build Phases を確認する：メインアプリターゲットの Build Phases セクションで、Embed App Extensions / Embed Foundation Extensions セクションを見つけます。Copy only when installing オプションのチェックが外れていることを確認します。
7. 構成間で appGroupId を統一する：プロジェクト内のすべてのスキームと構成（例：Debug/Release/QA/UAT）で appGroupId が一致していることを確認します。
8. ビルド構成を揃える：プロジェクトを実行またはアーカイブする際は、メインターゲットと Notification Service Extension ターゲットの Build Configuration が同じスキーム/構成を指していることを確認します。