了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

向後台 Apple 應用程序發送測試消息

要開始使用 FCM,請構建最簡單的用例:當應用程序位於設備後台時,從通知編輯器向開發設備發送測試通知消息。此頁面列出了實現此目的的所有步驟,從設置到驗證 - 如果您已為 FCM設置了 Apple 客戶端應用程序,它可能涵蓋您已經完成的步驟。

將 Firebase 添加到您的 Apple 項目

如果您已經為您的應用啟用了其他 Firebase 功能,本部分將介紹您可能已完成的任務。特別是對於 FCM,您需要上傳 APNs 身份驗證密鑰註冊遠程通知

先決條件

  • 安裝以下內容:

    • Xcode 14.1 或更高版本
  • 確保您的項目滿足以下要求:

    • 您的項目必須針對這些平台版本或更高版本:
      • iOS 11
      • macOS 10.13
      • 電視操作系統12
      • watchOS 6
  • 設置物理 Apple 設備來運行您的應用程序,並完成以下任務:

    • 為您的Apple 開發者帳戶獲取 Apple 推送通知身份驗證密鑰。
    • App > Capability下的 XCode 中啟用推送通知。

如果您還沒有 Xcode 項目而只想嘗試 Firebase 產品,則可以下載我們的快速入門示例之一。

創建 Firebase 項目

在將 Firebase 添加到您的 Apple 應用之前,您需要創建一個 Firebase 項目來連接到您的應用。訪問了解 Firebase 項目以了解有關 Firebase 項目的更多信息。

向 Firebase 註冊您的應用

要在 Apple 應用中使用 Firebase,您需要向 Firebase 項目註冊您的應用。註冊您的應用程序通常稱為將您的應用程序“添加”到您的項目中。

  1. 轉到Firebase 控制台

  2. 在項目概述頁面的中心,單擊iOS+圖標以啟動設置工作流程。

    如果您已將應用添加到 Firebase 項目,請單擊添加應用以顯示平台選項。

  3. 捆綁包 ID字段中輸入應用程序的捆綁包 ID。

  4. (可選)輸入其他應用程序信息:應用程序暱稱應用程序商店 ID

  5. 單擊註冊應用程序

添加 Firebase 配置文件

  1. 單擊“下載 GoogleService-Info.plist”以獲取 Firebase Apple 平台配置文件 ( GoogleService-Info.plist )。

  2. 將配置文件移至 Xcode 項目的根目錄中。如果出現提示,請選擇將配置文件添加到所有目標。

如果您的項目中有多個捆綁包 ID,則必須將每個捆綁包 ID 與 Firebase 控制台中註冊的應用程序關聯,以便每個應用程序都可以擁有自己的GoogleService-Info.plist文件。

將 Firebase SDK 添加到您的應用

使用 Swift Package Manager 安裝和管理 Firebase 依賴項。

  1. 在 Xcode 中,打開應用程序項目,導航至File > Add Packages
  2. 出現提示時,添加 Firebase Apple 平台 SDK 存儲庫:
  3.   https://github.com/firebase/firebase-ios-sdk
  4. 選擇 Firebase 雲消息傳遞庫。
  5. 為了獲得 Firebase Cloud Messaging 的最佳體驗,我們建議在您的 Firebase 項目中啟用 Google Analytics ,並將適用於 Google Analytics 的 Firebase SDK 添加到您的應用中。您可以選擇沒有 IDFA 收集或有 IDFA 收集的庫。
  6. 完成後,Xcode 將自動開始在後台解析並下載您的依賴項。

上傳您的 APNs 身份驗證密鑰

將您的 APNs 身份驗證密鑰上傳到 Firebase。如果您還沒有 APNs 身份驗證密鑰,請確保在Apple 開發者會員中心創建一個。

  1. 在 Firebase 控制台的項目內,選擇齒輪圖標,選擇項目設置,然後選擇雲消息傳遞選項卡。

  2. iOS 應用程序配置下的APNs 身份驗證密鑰中,單擊上傳按鈕。

  3. 瀏覽到保存密鑰的位置,選擇它,然後單擊“打開” 。添加密鑰的密鑰 ID(可在Apple 開發者會員中心獲取)並單擊Upload

在您的應用中初始化 Firebase

您需要將 Firebase 初始化代碼添加到您的應用程序中。導入 Firebase 模塊並配置共享實例,如下所示:

  1. UIApplicationDelegate中導入FirebaseCore模塊,以及應用程序委託使用的任何其他Firebase 模塊。例如,要使用 Cloud Firestore 和身份驗證:

    斯威夫特用戶界面

    import SwiftUI
    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    迅速

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Objective-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. 在應用程序委託的application(_:didFinishLaunchingWithOptions:)方法中配置FirebaseApp共享實例:

    斯威夫特用戶界面

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    迅速

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. 如果您使用 SwiftUI,則必須創建一個應用程序委託並通過UIApplicationDelegateAdaptorNSApplicationDelegateAdaptor將其附加到您的App結構。您還必須禁用應用程序委託調配。有關更多信息,請參閱SwiftUI 說明

    斯威夫特用戶界面

    @main
    struct YourApp: App {
      // register app delegate for Firebase setup
      @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
    
      var body: some Scene {
        WindowGroup {
          NavigationView {
            ContentView()
          }
        }
      }
    }
          

註冊遠程通知

在啟動時或在應用程序流程中的所需位置,註冊您的應用程序以獲取遠程通知。調用registerForRemoteNotifications ,如下所示:

迅速


UNUserNotificationCenter.current().delegate = self

let authOptions: UNAuthorizationOptions = [.alert, .badge, .sound]
UNUserNotificationCenter.current().requestAuthorization(
  options: authOptions,
  completionHandler: { _, _ in }
)

application.registerForRemoteNotifications()

Objective-C


[UNUserNotificationCenter currentNotificationCenter].delegate = self;
UNAuthorizationOptions authOptions = UNAuthorizationOptionAlert |
    UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
[[UNUserNotificationCenter currentNotificationCenter]
    requestAuthorizationWithOptions:authOptions
    completionHandler:^(BOOL granted, NSError * _Nullable error) {
      // ...
    }];

[application registerForRemoteNotifications];

訪問註冊令牌

要將消息發送到特定設備,您需要知道該設備的註冊令牌。由於您需要在通知編輯器的字段中輸入令牌才能完成本教程,因此請確保在檢索令牌後復制令牌或安全地存儲它。

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

與 Apple 平台通常在應用程序啟動時傳遞 APNs 設備令牌的方式相同,FCM 通過FIRMessagingDelegatemessaging:didReceiveRegistrationToken:方法提供註冊令牌。 FCM SDK 在應用程序初始啟動期間以及每當令牌更新或失效時都會檢索新的或現有的令牌。在所有情況下,FCM SDK 都會使用有效令牌調用messaging:didReceiveRegistrationToken:

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

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

設置消息代理

要接收註冊令牌,請實現消息傳遞委託協議並在調用[FIRApp configure]後設置FIRMessagingdelegate屬性。例如,如果您的應用程序委託符合消息傳遞委託協議,您可以將application:didFinishLaunchingWithOptions:上的委託設置為其自身。

迅速

Messaging.messaging().delegate = self

Objective-C

[FIRMessaging messaging].delegate = self;

獲取當前註冊令牌

註冊令牌通過messaging:didReceiveRegistrationToken:方法傳遞。通常每個應用程序使用註冊令牌啟動時都會調用此方法一次。當調用此方法時,是執行以下操作的理想時機:

  • 如果註冊令牌是新的,請將其發送到您的應用程序服務器。
  • 將註冊令牌訂閱主題。僅當新訂閱或用戶重新安裝應用程序的情況下才需要此操作。

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

迅速

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)"
  }
}

Objective-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.
}

Objective-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.
}

或者,您可以偵聽名為kFIRMessagingRegistrationTokenRefreshNotificationNSNotification ,而不是提供委託方法。令牌屬性始終具有當前令牌值。

發送通知消息

  1. 在目標設備上安裝並運行應用程序。在 Apple 設備上,您需要接受接收遠程通知的權限請求。

  2. 確保該應用程序位於設備的後台。

  3. 在 Firebase 控制台中,打開消息傳遞頁面

  4. 如果這是您的第一條消息,請選擇創建您的第一個營銷活動

    1. 選擇Firebase 通知消息,然後選擇創建
  5. 否則,在“營銷活動”選項卡上,選擇“新營銷活動” ,然後選擇“通知”

  6. 輸入消息文本。所有其他字段都是可選的。

  7. 從右側窗格中選擇發送測試消息

  8. 在標記為 添加 FCM 註冊令牌 的字段中,輸入您在本指南上一部分中獲得的註冊令牌。

  9. 選擇測試

選擇“測試”後,目標客戶端設備(應用程序位於後台)應該會收到通知。

要深入了解向您的應用程序發送的消息,請參閱FCM 報告儀表板,該儀表板記錄 Apple 和 Android 設備上發送和打開的消息數,以及 Android 應用程序的“印像數”(用戶看到的通知)數據。

下一步

要超越通知消息並向您的應用添加其他更高級的行為,請參閱: