在 Apple 平台上設置 Firebase Cloud Messaging 客戶端應用程序

對於 Apple 客戶端應用程序,您可以通過 Firebase Cloud Messaging APNs 接口接收最多 4000 字節的通知和數據負載。

寫在Objective-C或斯威夫特您的客戶端代碼,我們建議您使用FIRMessaging API 。該快速啟動示例提供了一種用於兩種語言的示例代碼。

Firebase 雲消息傳遞中的方法調配

在兩個關鍵領域的FCM SDK執行方法混寫:映射你的APN令牌到FCM註冊令牌,並在捕獲分析數據下游消息回調處理。誰不喜歡使用交叉混合開發人員可以通過添加標誌禁用它FirebaseAppDelegateProxyEnabled在應用程序的Info.plist文件,並將其設置為NO(布爾值)。指南的相關區域提供了啟用和不啟用方法調配的代碼示例。

將 Firebase 添加到您的 Apple 項目

如果你還沒有,添加火力地堡到Apple項目

上傳您的 APNs 身份驗證密鑰

將您的 APNs 身份驗證密鑰上傳到 Firebase。如果你不已經有一個APN的認證密鑰,確保在創建一個蘋果開發者會員中心

  1. 在火力地堡控制台你的項目中,選擇齒輪圖標,選擇項目設置,然後選擇雲端通訊標籤。

  2. 在根據iOS應用配置的APN認證密鑰,點擊上傳按鈕。

  3. 瀏覽到您保存密鑰的位置,選擇它,然後單擊打開。添加鍵ID為鍵(可在蘋果開發者會員中心),然後單擊上傳

註冊遠程通知

無論是在啟動時,還是在您的應用程序流程中的所需點,註冊您的應用程序以獲取遠程通知。呼叫registerForRemoteNotifications如圖所示:

迅速

if #available(iOS 10.0, *) {
  // For iOS 10 display notification (sent via APNS)
  UNUserNotificationCenter.current().delegate = self

  let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
  UNUserNotificationCenter.current().requestAuthorization(
    options: authOptions,
    completionHandler: { _, _ in }
  )
} else {
  let settings: UIUserNotificationSettings =
    UIUserNotificationSettings(types: [.alert, .badge, .sound], categories: nil)
  application.registerUserNotificationSettings(settings)
}

application.registerForRemoteNotifications()

目標-C

if ([UNUserNotificationCenter class] != nil) {
  // iOS 10 or later
  // For iOS 10 display notification (sent via APNS)
  [UNUserNotificationCenter currentNotificationCenter].delegate = self;
  UNAuthorizationOptions authOptions = UNAuthorizationOptionAlert |
      UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
  [[UNUserNotificationCenter currentNotificationCenter]
      requestAuthorizationWithOptions:authOptions
      completionHandler:^(BOOL granted, NSError * _Nullable error) {
        // ...
      }];
} else {
  // iOS 10 notifications aren't available; fall back to iOS 8-9 notifications.
  UIUserNotificationType allNotificationTypes =
  (UIUserNotificationTypeSound | UIUserNotificationTypeAlert | UIUserNotificationTypeBadge);
  UIUserNotificationSettings *settings =
  [UIUserNotificationSettings settingsForTypes:allNotificationTypes categories:nil];
  [application registerUserNotificationSettings:settings];
}

[application registerForRemoteNotifications];

訪問註冊令牌

默認情況下,FCM SDK 在應用啟動時為客戶端應用實例生成一個註冊令牌。與 APNs 設備令牌類似,此令牌允許您向應用程序的任何特定實例發送有針對性的通知。

以相同的方式,蘋果平台通常遞送上的應用程序起動的令牌裝置的APN,FCM提供通過令牌的登記FIRMessagingDelegatemessaging:didReceiveRegistrationToken:方法。 FCM SDK 在應用程序初始啟動期間以及每當令牌更新或失效時檢索新的或現有的令牌。在所有情況下,FCM SDK調用messaging:didReceiveRegistrationToken:使用有效的令牌。

在以下情況下,註冊令牌可能會更改:

  • 該應用程序已在新設備上恢復
  • 用戶卸載/重新安裝應用程序
  • 用戶清除應用數據。

設置消息代理

以接收註冊標記,實現郵件委託協議並設置FIRMessagingdelegate屬性調用後[FIRApp configure] 。例如,如果您的應用程序委託符合消息委託協議,可以設置委託在application:didFinishLaunchingWithOptions:到自身。

迅速

Messaging.messaging().delegate = self

目標-C

[FIRMessaging messaging].delegate = self;

獲取當前註冊令牌

註冊標記是通過該方法遞送messaging:didReceiveRegistrationToken: 。此方法通常在每個應用程序以註冊令牌開始時調用一次。調用此方法時,是執行以下操作的理想時間:

  • 如果註冊令牌是新的,請將其發送到您的應用程序服務器。
  • 將註冊令牌訂閱到主題。這僅適用於新訂閱或用戶重新安裝應用程序的情況。

您可以直接使用檢索令牌令牌(完成:) 。如果令牌檢索以任何方式失敗,則會提供非空錯誤。

迅速

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching FCM registration token: \(error)")
  } else if let token = token {
    print("FCM registration token: \(token)")
    self.fcmRegTokenMessage.text  = "Remote FCM registration token: \(token)"
  }
}

目標-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString *token, NSError *error) {
  if (error != nil) {
    NSLog(@"Error getting FCM registration token: %@", error);
  } else {
    NSLog(@"FCM registration token: %@", token);
    self.fcmRegTokenMessage.text = token;
  }
}];

您可以隨時使用此方法訪問令牌而不是存儲它。

監控令牌刷新

要在令牌更新時收到通知,請提供符合消息傳遞委託協議的委託。以下示例註冊委託並添加適當的委託方法:

迅速

func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
  print("Firebase registration token: \(String(describing: fcmToken))")

  let dataDict: [String: String] = ["token": fcmToken ?? ""]
  NotificationCenter.default.post(
    name: Notification.Name("FCMToken"),
    object: nil,
    userInfo: dataDict
  )
  // TODO: If necessary send token to application server.
  // Note: This callback is fired at each app startup and whenever a new token is generated.
}

目標-C

- (void)messaging:(FIRMessaging *)messaging didReceiveRegistrationToken:(NSString *)fcmToken {
    NSLog(@"FCM registration token: %@", fcmToken);
    // Notify about received token.
    NSDictionary *dataDict = [NSDictionary dictionaryWithObject:fcmToken forKey:@"token"];
    [[NSNotificationCenter defaultCenter] postNotificationName:
     @"FCMToken" object:nil userInfo:dataDict];
    // TODO: If necessary send token to application server.
    // Note: This callback is fired at each app startup and whenever a new token is generated.
}

或者,你可以聽一個NSNotification命名kFIRMessagingRegistrationTokenRefreshNotification而不是提供一個委託方法。令牌屬性始終具有當前令牌值。

Swizzling 已禁用:映射您的 APNs 令牌和註冊令牌

如果您禁用了方法 swizzling,則需要將您的 APNs 令牌顯式映射到 FCM 註冊令牌。重載的方法didRegisterForRemoteNotificationsWithDeviceToken檢索的APN令牌,然後設置FIRMessagingAPNSToken屬性:

迅速

func application(application: UIApplication,
                 didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
  Messaging.messaging().apnsToken = deviceToken
}

目標-C

// With "FirebaseAppDelegateProxyEnabled": NO
- (void)application:(UIApplication *)application
    didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [FIRMessaging messaging].APNSToken = deviceToken;
}

生成 FCM 註冊令牌後,您可以使用與啟用 swizzling 相同的方法訪問它並偵聽刷新事件。

防止自動初始化

生成 FCM 註冊令牌後,該庫會將標識符和配置數據上傳到 Firebase。如果您想首先從用戶那裡獲得明確的選擇加入,您可以通過禁用 FCM 來防止在配置時生成令牌。要做到這一點,元數據值添加到您Info.plist (不是你的GoogleService-Info.plist ):

FirebaseMessagingAutoInitEnabled = NO

要重新啟用 FCM,您可以進行運行時調用:

迅速

Messaging.messaging().autoInitEnabled = true

目標-C

[FIRMessaging messaging].autoInitEnabled = YES;

一旦設置,此值在應用程序重新啟動後仍然存在。

下一步

設置 Apple 客戶端后,您就可以向應用程序添加消息處理和其他更高級的行為了。有關更多信息,請參閱這些指南: