Trang này được dịch bởi Cloud Translation API.

Gửi tin nhắn thử nghiệm đến một ứng dụng Apple ở chế độ nền

Để bắt đầu sử dụng FCM, hãy xây dựng trường hợp sử dụng đơn giản nhất: gửi một tin nhắn thông báo thử nghiệm từ Trình soạn thông báo sang thiết bị phát triển khi thiết bị chạy trong nền. Trang này liệt kê tất cả các bước để thực hiện điều này, từ thiết lập cho đến xác minh — Báo cáo có thể bao gồm các bước bạn đã hoàn thành nếu bạn đã thiết lập một ứng dụng khách của Apple với giá FCM.

Thêm Firebase vào dự án Apple

Phần này đề cập đến những việc bạn có thể đã hoàn thành nếu bạn đã bật tính năng này các tính năng khác của Firebase cho ứng dụng của bạn. Riêng đối với FCM, bạn sẽ cần tải khoá xác thực APN lên và đăng ký nhận thông báo từ xa.

Điều kiện tiên quyết

Cài đặt như sau:
- Xcode 15.2 trở lên
Hãy đảm bảo dự án của bạn đáp ứng các yêu cầu sau:
- Dự án của bạn phải nhắm đến các phiên bản nền tảng sau trở lên:
  - iOS 13
  - macOS 10.15
  - tvOS 13
  - watchOS 7

Thiết lập thiết bị Apple thực để chạy ứng dụng của bạn, và hoàn thành các công việc sau:
- Lấy Khoá xác thực thông báo đẩy của Apple cho Tài khoản nhà phát triển của Apple.
- Bật thông báo đẩy trong XCode trong App > Chức năng.

Đăng nhập vào Firebase bằng Tài khoản Google.

Nếu bạn chưa có dự án Xcode và chỉ muốn dùng thử Firebase sản phẩm, bạn có thể tải xuống một trong các mẫu bắt đầu nhanh của chúng tôi.

Tạo một dự án Firebase

Trước khi có thể thêm Firebase vào ứng dụng Apple, bạn cần tạo Firebase dự án để kết nối với ứng dụng của bạn. Truy cập/ghé qua Tìm hiểu về các dự án Firebase để tìm hiểu thêm Dự án Firebase.

Tạo dự án Firebase

Trong bảng điều khiển Firebase, hãy nhấp vào Thêm dự án.
- Để thêm tài nguyên Firebase vào một dự án Google Cloud hiện có, hãy nhập tên dự án hoặc chọn tên dự án từ trình đơn thả xuống.
- Để tạo một dự án mới, hãy nhập tên dự án mà bạn muốn. Bạn cũng có thể tuỳ ý chỉnh sửa mã dự án xuất hiện bên dưới tên dự án.
  
  Firebase tạo một mã nhận dạng duy nhất cho dự án Firebase của bạn dựa trên tên bạn đặt. Nếu muốn chỉnh sửa mã dự án này, bạn phải hãy làm ngay bây giờ vì bạn không thể thay đổi tùy chọn này sau khi Firebase cung cấp tài nguyên cho dự án. Truy cập/ghé qua Tìm hiểu về các dự án Firebase để tìm hiểu về cách Firebase sử dụng mã dự án.
Nếu được nhắc, hãy xem xét và chấp nhận các điều khoản của Firebase.
Nhấp vào Tiếp tục.

(Không bắt buộc) Thiết lập Google Analytics cho dự án để có thể để có trải nghiệm tối ưu khi sử dụng bất kỳ sản phẩm Firebase nào sau đây:

Chọn một Tài khoản Google Analytics hoặc tạo tài khoản mới.

Nếu bạn tạo tài khoản mới, hãy chọn Analytics vị trí báo cáo, sau đó chấp nhận chế độ cài đặt cách chia sẻ dữ liệu và điều khoản Google Analytics cho dự án.

Nhấp vào Tạo dự án (hoặc Thêm Firebase, nếu bạn đang sử dụng dự án Google Cloud hiện có).

Firebase tự động cấp tài nguyên cho dự án Firebase của bạn. Thời gian quá trình hoàn tất, bạn sẽ được đưa đến trang tổng quan cho Firebase dự án trong bảng điều khiển Firebase.

Đăng ký ứng dụng của bạn với Firebase

Để sử dụng Firebase trong ứng dụng của Apple, bạn cần đăng ký ứng dụng của mình với Dự án Firebase. Việc đăng ký ứng dụng của bạn thường được gọi là "thêm" ứng dụng của bạn đến dự án.

Chuyển đến bảng điều khiển của Firebase.
Ở giữa trang tổng quan về dự án, hãy nhấp vào biểu tượng iOS+ để bắt đầu quy trình thiết lập.

Nếu bạn đã thêm một ứng dụng vào dự án Firebase, hãy nhấp vào Thêm ứng dụng để hiển thị các tuỳ chọn nền tảng.
Nhập mã gói của ứng dụng vào trường mã gói.
Mã nhận dạng gói là gì và bạn tìm thấy mã đó ở đâu?
- Mã gói xác định duy nhất một ứng dụng trong hệ sinh thái của Apple.
- Tìm mã gói của bạn: mở dự án của bạn trong Xcode, chọn ứng dụng cấp cao nhất trong trình điều hướng dự án, sau đó chọn thẻ General (Chung).
  
  Giá trị của trường Mã nhận dạng gói là mã nhận dạng gói (ví dụ: com.yourcompany.yourproject).
- Xin lưu ý rằng giá trị mã nhận dạng gói có phân biệt chữ hoa chữ thường và không được đã thay đổi cho ứng dụng Firebase này sau khi ứng dụng được đăng ký với Dự án Firebase.
Hãy nhớ nhập mã nhận dạng gói mà ứng dụng của bạn đang dùng thực sự đang sử dụng. Giá trị mã nhận dạng gói có phân biệt chữ hoa chữ thường và không được đã thay đổi cho ứng dụng Apple này trong Firebase sau khi được đăng ký với Dự án Firebase.
(Không bắt buộc) Nhập thông tin khác về ứng dụng: Biệt hiệu của ứng dụng và Mã cửa hàng ứng dụng.
Biệt hiệu ứng dụng và Mã cửa hàng ứng dụng được sử dụng trong Firebase?
- Biệt hiệu ứng dụng: Giá trị nhận dạng nội bộ, tiện lợi chỉ hiển thị cho bạn trong bảng điều khiển của Firebase
- Mã cửa hàng ứng dụng: Được Firebase Dynamic Links dùng để chuyển hướng người dùng đến trang của bạn trên App Store và từ Google Analytics đến nhập sự kiện chuyển đổi vào Google Ads. Nếu ứng dụng của bạn chưa có Mã cửa hàng ứng dụng, bạn có thể thêm mã này vào lúc khác trong Dự án phần cài đặt.
Nhấp vào Đăng ký ứng dụng.

Thêm tệp cấu hình Firebase

Nhấp vào Tải GoogleService-Info.plist xuống để nhận Apple Firebase tệp cấu hình nền tảng (GoogleService-Info.plist).
Bạn cần biết gì về tệp cấu hình này?
- Tệp cấu hình Firebase chứa các giá trị nhận dạng duy nhất nhưng không bí mật của dự án của bạn. Để tìm hiểu thêm về tệp cấu hình này, hãy truy cập vào Tìm hiểu về Firebase Dự án.
- Bạn có thể tải cấu hình Firebase xuống tệp bất cứ lúc nào.
- Hãy đảm bảo tên của tệp cấu hình không được nối thêm các ký tự bổ sung, như (2).
Di chuyển tệp cấu hình vào gốc của dự án Xcode. Nếu được nhắc, chọn để thêm tệp cấu hình vào tất cả mục tiêu.

Nếu có nhiều mã gói trong dự án, bạn phải liên kết từng gói Mã nhận dạng của một ứng dụng đã đăng ký trong bảng điều khiển Firebase để mỗi ứng dụng đều có thể có tệp GoogleService-Info.plist riêng.

Thêm Firebase SDK vào ứng dụng của bạn

Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc Firebase.

Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến Tệp > Thêm gói.
Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:

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

Chọn thư viện Firebase Cloud Messaging.
Thêm cờ -ObjC vào mục Cờ trình liên kết khác trong chế độ cài đặt bản dựng của mục tiêu.
Để có trải nghiệm tối ưu với Firebase Cloud Messaging, bạn nên bật Google Analytics trong dự án Firebase và thêm Firebase SDK cho Google Analytics vào ứng dụng của bạn. Bạn có thể hãy chọn thư viện không thu thập IDFA hoặc có thu thập IDFA.
Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải xuống các phần phụ thuộc trong nền.

Tải khoá xác thực APN lên

Tải khoá xác thực APN của bạn lên Firebase. Nếu chưa có khoá xác thực APN hãy nhớ tạo một khoá trong Trung tâm thành viên dành cho nhà phát triển của Apple.

Bên trong dự án của bạn trong bảng điều khiển Firebase, hãy chọn biểu tượng bánh răng, chọn Project Settings (Cài đặt dự án), sau đó chọn Thẻ Giải pháp gửi thông báo qua đám mây.
Trong khoá xác thực AAPN ở phần Cấu hình ứng dụng iOS, nhấp vào nút Tải lên .
Duyệt tới vị trí bạn đã lưu khoá của mình, chọn khoá đó rồi nhấp vào Mở. Thêm mã khoá cho khoá (có trong Trung tâm thành viên dành cho nhà phát triển của Apple) rồi nhấp vào Tải lên.

Khởi chạy Firebase trong ứng dụng của bạn

Bạn cần thêm mã khởi chạy Firebase vào ứng dụng của mình. Nhập mô-đun Firebase và định cấu hình một bản sao dùng chung như sau:

Nhập mô-đun FirebaseCore trong UIApplicationDelegate cũng như bất kỳ tên nào khác Các mô-đun Firebase mà người được uỷ quyền sử dụng. Ví dụ: để sử dụng Cloud Firestore và 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;
// ...

Định cấu hình một FirebaseApp thực thể dùng chung trong Phương thức application(_:didFinishLaunchingWithOptions:):

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

Nếu đang sử dụng SwiftUI, bạn phải tạo một ứng dụng uỷ quyền và đính kèm nó đến cấu trúc App của bạn thông qua UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor. Bạn cũng phải tắt tính năng uỷ quyền ứng dụng. Để hãy xem hướng dẫn về SwiftUI để biết thêm thông tin.
SwiftUI
```
@main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

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

Đăng ký nhận thông báo từ xa

Khi khởi động hoặc tại thời điểm mong muốn trong quy trình đăng ký của bạn, đăng ký ứng dụng của bạn để nhận thông báo từ xa. Gọi điện registerForRemoteNotifications như minh hoạ:

Lưu ý: Các ứng dụng SwiftUI nên sử dụng UIApplicationDelegateAdaptor hoặc Trình bao bọc thuộc tính NSApplicationDelegateAdaptor để cung cấp một loại tương ứng với giao thức uỷ quyền thích hợp cho ứng dụng.

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

Bạn phải chỉ định Thuộc tính delegate và FIRMessaging delegate. Ví dụ: trong một ứng dụng iOS, hãy gán mã trong applicationWillFinishLaunchingWithOptions: hoặc Phương thức applicationDidFinishLaunchingWithOptions: của uỷ quyền ứng dụng.

Truy cập vào mã thông báo đăng ký

Để gửi tin nhắn đến một thiết bị cụ thể, bạn cần biết thiết bị đó mã thông báo đăng ký. Do bạn cần nhập mã thông báo vào một trường trong Trình soạn thông báo để hoàn thành hướng dẫn này, hãy nhớ sao chép mã thông báo hoặc lưu trữ an toàn sau khi bạn truy xuất.

Theo mặc định, SDK FCM sẽ tạo một mã thông báo đăng ký cho phiên bản ứng dụng khách khi khởi chạy ứng dụng. Tương tự như mã thông báo thiết bị APN, mã thông báo này cho phép bạn gửi thông báo được nhắm đến vào phiên bản cụ thể bất kỳ của ứng dụng.

Tương tự như cách mà các nền tảng của Apple thường cung cấp mã thông báo thiết bị APN khi khởi động ứng dụng, FCM cung cấp mã thông báo đăng ký quaFIRMessagingDelegate messaging:didReceiveRegistrationToken:. SDK FCM truy xuất một mã thông báo mới hoặc hiện có trong quá trình khởi chạy ứng dụng ban đầu và bất cứ khi nào mã thông báo được cập nhật hoặc bị mất hiệu lực. Trong mọi trường hợp, SDK FCM sẽ gọi messaging:didReceiveRegistrationToken: có mã thông báo hợp lệ.

Mã thông báo đăng ký có thể thay đổi khi:

Ứng dụng đó được khôi phục trên một thiết bị mới
Người dùng gỡ cài đặt/cài đặt lại ứng dụng
Người dùng xoá dữ liệu ứng dụng.

Thiết lập tính năng uỷ quyền nhắn tin

Để nhận mã thông báo đăng ký, hãy triển khai tính năng uỷ quyền nhắn tin giao thức và thiết lập thuộc tính delegate của FIRMessaging sau khi gọi [FIRApp configure]. Ví dụ: nếu ứng dụng uỷ quyền của bạn tuân theo phương thức uỷ quyền thông báo giao thức, bạn có thể đặt ủy quyền trên application:didFinishLaunchingWithOptions: cho chính nó.

Swift

Messaging.messaging().delegate = self

Objective-C

[FIRMessaging messaging].delegate = self;

Đang tìm nạp mã thông báo đăng ký hiện tại

Mã thông báo đăng ký được phân phối thông qua phương thức messaging:didReceiveRegistrationToken:. Phương thức này thường được gọi một lần mỗi ứng dụng sẽ bắt đầu bằng mã thông báo đăng ký. Khi phương thức này được gọi, đây là thời điểm lý tưởng để:

Nếu mã thông báo đăng ký là mới, hãy gửi mã đó đến máy chủ ứng dụng của bạn.
Đăng ký mã thông báo đăng ký cho các chủ đề. Điều này chỉ bắt buộc đối với gói thuê bao mới hoặc trong trường hợp người dùng đã cài đặt lại ứng dụng.

Bạn có thể trực tiếp truy xuất mã thông báo bằng cách sử dụng token(complete:). Lỗi không rỗng sẽ được cung cấp nếu truy xuất mã thông báo không thành công theo bất kỳ cách nào.

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

Bạn có thể sử dụng phương thức này bất cứ lúc nào để truy cập mã thông báo thay vì lưu trữ nó.

Giám sát quá trình làm mới mã thông báo

Để được thông báo mỗi khi mã thông báo được cập nhật, hãy cung cấp thực thể đại diện phù hợp vào giao thức uỷ quyền nhắn tin. Ví dụ sau đây đăng ký uỷ quyền và thêm phương thức uỷ quyền thích hợp:

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

Ngoài ra, bạn có thể nghe NSNotification có tên kFIRMessagingRegistrationTokenRefreshNotification thay vì cung cấp phương thức uỷ quyền. Thuộc tính mã thông báo luôn có giá trị mã thông báo hiện tại.

Gửi tin nhắn thông báo

Cài đặt và chạy ứng dụng trên thiết bị mục tiêu. Trên thiết bị Apple, bạn sẽ cần để chấp nhận yêu cầu cấp quyền nhận thông báo từ xa.
Hãy đảm bảo ứng dụng đang chạy trong nền trên thiết bị.
Trong bảng điều khiển Firebase, hãy mở trang Nhắn tin.
Nếu đây là thư đầu tiên của bạn, hãy chọn Tạo chiến dịch.
1. Chọn Tin nhắn thông báo Firebase rồi chọn Tạo.
Nếu không, trên thẻ Chiến dịch, hãy chọn Chiến dịch mới rồi chọn Thông báo.
Nhập nội dung tin nhắn. Tất cả các trường khác là không bắt buộc.
Chọn Gửi tin nhắn thử nghiệm trên ngăn bên phải.
Trong trường có nhãn Add an FCM registration token (Thêm mã thông báo đăng ký FCM), hãy nhập thông tin đăng ký mã thông báo mà bạn đã nhận được ở phần trước của hướng dẫn này.
Chọn Kiểm tra.

Sau khi bạn chọn Kiểm thử, thiết bị khách được nhắm đến (với ứng dụng ở nền) sẽ nhận được thông báo.

Để biết thông tin chi tiết về cách gửi thư đến ứng dụng của bạn, hãy xem Trang tổng quan báo cáo FCM, nơi ghi lại các số thư được gửi và mở trên thiết bị Apple và Android, cùng với dữ liệu về "lượt hiển thị" (thông báo mà người dùng nhìn thấy) đối với ứng dụng Android.

Các bước tiếp theo

Để không chỉ dừng lại ở tin nhắn thông báo và thêm các hành vi khác, nâng cao hơn vào ứng dụng, hãy xem: