向后台 Apple 应用发送测试消息

开始使用 FCM 时，您可以构建一个最简单的用例：当应用在设备后台运行时，通过 Notifications Composer 向开发设备发送一条测试通知消息。本页面列出了实现上述目标所需执行的步骤，包括从设置到验证的所有步骤。如果您已针对 FCM 设置了 Apple 客户端应用，您可能已经完成了本页面中的一些步骤。

将 Firebase 添加到您的 Apple 项目中

如果您已经为自己的应用启用了其他 Firebase 功能，那么您可能已经完成了本部分将要介绍的一些任务。您需要专门为 FCM 上传您的 APNs 身份验证密钥并注册接收远程通知。

前提条件

安装以下软件：
- Xcode 14.1 或更高版本
确保您的项目满足以下要求：
- 您的项目的目标平台不得低于以下版本：
  - iOS 11
  - macOS 10.13
  - tvOS 12
  - watchOS 6

设置一台 Apple 实体设备来运行您的应用，然后完成以下任务：
- 获取您的 Apple 开发者帐号的 Apple 推送通知身份验证密钥。
- 在 XCode 中通过 App（应用）> Capabilities（功能）启用推送通知功能。

使用您的 Google 帐号登录 Firebase。

如果您还没有 Xcode 项目，只是想试用某一 Firebase 产品，可以下载一个我们的快速入门示例。

创建 Firebase 项目

您需要先创建一个要关联到您的 Apple 应用的 Firebase 项目，然后才能将 Firebase 添加到该应用。如需详细了解 Firebase 项目，请访问了解 Firebase 项目。

创建 Firebase 项目

在 Firebase 控制台中，点击添加项目。
- 如需将 Firebase 资源添加到现有 Google Cloud 项目，请输入该项目的名称或从下拉菜单中选择该项目。
- 如需创建新项目，请输入要使用的项目名称。您也可以视需要修改项目名称下方显示的项目 ID。
  
  Firebase 会根据您提供的名称，为您的 Firebase 项目生成一个唯一 ID。如果您希望修改此项目 ID，必须立即修改，因为当 Firebase 为项目预配资源后，您将无法进行更改。如需详细了解 Firebase 如何使用项目 ID，请访问了解 Firebase 项目。
如果看到相关提示，请查看并接受 Firebase 条款。
点击继续。

（可选）为您的项目设置 Google Analytics（分析），以便在使用下列 Firebase 产品时能获得最佳体验：

选择现有的 Google Analytics（分析）帐号，或者创建一个新帐号。

如果您选择创建一个新帐号，请选择 Analytics（分析）报告位置，然后接受项目的数据共享设置和 Google Analytics（分析）条款。

点击创建项目（如果使用现有的 Google Cloud 项目，则点击添加 Firebase）。

Firebase 会自动为您的 Firebase 项目预配资源。完成此过程后，您将进入 Firebase 控制台中 Firebase 项目的概览页面。

在 Firebase 中注册您的应用

如需在 Apple 应用中使用 Firebase，您需要在 Firebase 项目中注册您的应用。注册应用的过程通常称为将应用“添加”到项目中。

前往 Firebase 控制台。
在项目概览页面的中心位置，点击 iOS+ 图标，启动设置工作流。

如果您已向 Firebase 项目添加了应用，请点击添加应用以显示平台选项。
在软件包 ID 字段中输入应用的软件包 ID。
什么是软件包 ID，在哪里可以找到它？
- 软件包 ID 是应用在 Apple 生态系统中的唯一标识符。
- 如何找到您的软件包 ID：在 Xcode 中打开您的项目，在项目导航器中选择顶级应用，然后选择 General（常规）标签页。
  
  Bundle Identifier（软件包标识符）字段的值就是软件包 ID（例如 com.yourcompany.yourproject）。
- 请注意，软件包 ID 值区分大小写，此 Firebase 应用在您的 Firebase 项目中注册后，该值便无法更改。
请务必输入您的应用实际使用的软件包 ID。软件包 ID 值区分大小写，并且此 Firebase Apple 应用在您的 Firebase 项目中注册后，该值便无法更改。
（可选）输入其他应用信息：应用别名和 App Store ID。
应用别名和 App Store ID 在 Firebase 中的作用是什么？
- 应用别名：方便内部使用的标识符，只有您能在 Firebase 控制台中看到
- App Store ID：Firebase Dynamic Links 使用该 ID 将用户重定向到 App Store 页面，而 Google Analytics（分析）则用它将转化事件导入 Google Ads。如果您的应用还没有 App Store ID，您可以稍后在项目设置中添加此 ID。
点击注册应用。

添加 Firebase 配置文件

点击下载 GoogleService-Info.plist，获取 Firebase Apple 平台配置文件 (GoogleService-Info.plist)。
关于此配置文件，您需要了解哪些信息？
- 此 Firebase 配置文件包含项目的唯一但非机密的标识符。如需详细了解此配置文件，请访问了解 Firebase 项目。
- 您可以随时再次下载 Firebase 配置文件。
- 请确保该配置文件名未附加其他字符，如 (2)。
将配置文件移至 Xcode 项目的根目录中。如果出现提示，请选择将配置文件添加到所有目标。

如果您的项目中有多个软件包 ID，必须将每个软件包 ID 与 Firebase 控制台中的注册应用相关联，使每个应用都有自己的 GoogleService-Info.plist 文件。

将 Firebase SDK 添加至您的应用

使用 Swift Package Manager 安装和管理 Firebase 依赖项。

在 Xcode 中打开您的应用项目，依次点击 File（文件）> Add Packages（添加软件包）。
出现提示时，添加 Firebase Apple 平台 SDK 代码库：

  https://github.com/firebase/firebase-ios-sdk

选择 Firebase Cloud Messaging 库。
为了获得最佳的 Firebase Cloud Messaging 使用体验，我们建议您在 Firebase 项目中启用 Google Analytics（分析），并将 Firebase SDK for Google Analytics 添加到您的应用中。您可以选择不收集 IDFA 的库，也可以选择收集 IDFA 的库。
完成之后，Xcode 将会自动开始在后台解析和下载您的依赖项。

上传您的 APNs 身份验证密钥

将您的 APNs 身份验证密钥上传到 Firebase。如果您还没有 APNs 身份验证密钥，请务必在 Apple Developer Member Center 内创建一个。

在 Firebase 控制台中，在您的项目内依次选择齿轮图标 > 项目设置 > Cloud Messaging 标签页。
在 iOS 应用配置下的 APNs 身份验证密钥中，点击上传按钮。
转到您保存密钥的位置，选择该密钥，然后点击打开。添加该密钥的 ID（可在 Apple Developer Member Center 中找到），然后点击上传。

在您的应用中初始化 Firebase

您需要为应用添加 Firebase 初始化代码。请按如下所示导入 Firebase 模块并配置一个共享实例：

在 UIApplicationDelegate 中导入 FirebaseCore 模块，以及您的应用委托 (app delegate) 使用的所有其他 Firebase 模块。例如，如需使用 Cloud Firestore 和 Authentication，请添加以下代码：

SwiftUI

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

Swift

import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

Objective-C

@import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...

在应用委托的 application(_:didFinishLaunchingWithOptions:) 方法中配置一个 FirebaseApp 共享实例：

SwiftUI

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

Swift

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

Objective-C

// Use Firebase library to configure APIs
[FIRApp configure];

如果您使用的是 SwiftUI，则必须创建应用委托并通过 UIApplicationDelegateAdaptor 或 NSApplicationDelegateAdaptor 将其附加到 App 结构体。您还必须停用应用委托调配。如需了解详情，请参阅 SwiftUI 说明。

SwiftUI

@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

注册接收远程通知

可在启动时或在应用流程中期望的时间点注册您的应用，以便接收远程通知。调用 registerForRemoteNotifications，如下所示：

注意：SwiftUI 应用应使用 UIApplicationDelegateAdaptor 或 NSApplicationDelegateAdaptor 属性封装容器来提供与相应应用委托协议对应的类型。

Swift

UNUserNotificationCenter.current().delegate = self

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

application.registerForRemoteNotifications()
AppDelegate.swift

Objective-C

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

[application registerForRemoteNotifications];AppDelegate.m

您必须分配 UNUserNotificationCenter 的 delegate 属性和 FIRMessaging 的 delegate 属性。例如，在 iOS 应用中，需在应用委托的 applicationWillFinishLaunchingWithOptions: 或 applicationDidFinishLaunchingWithOptions: 方法中对其进行分配。

获取注册令牌

如需将消息发送到特定的设备，您需要知道该设备的注册令牌。您需要在 Notifications Composer 的相应字段中输入该令牌才能完成本教程，因此请确保在获得令牌后进行复制或将其保存在安全可靠的位置。

默认情况下，启动应用时，FCM SDK 会为客户端应用实例生成注册令牌。与 APNs 设备令牌类似，此令牌也允许您将针对性通知发送到应用的任何特定实例。

与 Apple 平台通常在应用启动时传送 APNs 设备令牌一样，FCM 也会通过 FIRMessagingDelegate 的 messaging:didReceiveRegistrationToken: 方法提供一个注册令牌。FCM SDK 会在应用初次启动期间以及令牌更新或失效时检索新令牌或现有令牌。无论哪种情况，FCM SDK 都会使用一个有效的令牌来调用 messaging:didReceiveRegistrationToken:。

注册令牌可能会在发生下列情况时更改：

应用在新设备上恢复
用户卸载/重新安装应用
用户清除应用数据

设置消息委托

如需接收注册令牌，请实现消息委托协议，并在调用 [FIRApp configure] 后设置 FIRMessaging 的 delegate 属性。例如，如果您的应用委托符合消息委托协议，可以将 application:didFinishLaunchingWithOptions: 上的委托设为其本身。

Swift

Messaging.messaging().delegate = self

Objective-C

[FIRMessaging messaging].delegate = self;

获取当前的注册令牌

注册令牌是通过 messaging:didReceiveRegistrationToken: 方法传送的。系统通常会在应用每次启动时用注册令牌调用此方法一次。调用此方法时，最适合执行以下操作：

如果注册令牌是新的，将其发送到您的应用服务器。
为注册令牌订阅主题。只需针对新订阅或者在用户重新安装了应用时执行此操作。

您可以直接使用 token(completion:) 检索令牌。如果令牌检索失败，系统会给出非 NULL 错误。

Swift

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;
  }
}];

您随时可以使用此方法来访问令牌，而无需存储令牌。

监控令牌刷新

如需在每次令牌更新时获得通知，请提供符合消息委托协议的委托。以下示例注册了此类委托，并添加了合适的委托方法：

Swift

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.
}
AppDelegate.swift

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.
}AppDelegate.m

或者，您也可以监听名为 kFIRMessagingRegistrationTokenRefreshNotification 的 NSNotification，而不提供委托方法。该令牌属性始终具有当前令牌值。

发送通知消息

在目标设备上安装并运行该应用。在 Apple 设备上，您需要接受权限请求，才能收到远程通知。
确保应用在设备的后台运行。
在 Firebase 控制台中，打开“Messaging”（消息功能）页面。
如果这是您的第一条消息，请选择制作首个宣传活动。
1. 选择 Firebase 通知消息，然后选择创建。
否则，请在宣传活动标签页上选择新建宣传活动，然后选择通知。
输入消息内容。所有其他字段都是选填字段。
从右侧窗格中选择发送测试消息。
在标签为添加 FCM 注册令牌的字段中，输入您根据本指南的前一部分获得的注册令牌。
选择测试。

在您选择测试后，目标客户端设备（在后台中运行应用）应该会接收到通知。

如需详细了解发送到应用的消息，请参阅 FCM 报告信息中心。该信息中心会记录在 Apple 和 Android 设备上发送和打开的消息数量，以及 Android 应用的“展示次数”（用户看到的通知条数）数据。

后续步骤

如果除了通知消息之外，您还要向应用添加其他更高级的行为，请参阅以下内容：