Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Quản lý cài đặt Firebase

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Dịch vụ cài đặt Firebase (FIS) cung cấp ID cài đặt Firebase (FID) cho từng phiên bản đã cài đặt của ứng dụng Firebase. ID cài đặt Firebase được sử dụng nội bộ bởi các dịch vụ Firebase này:

dịch vụ căn cứ hỏa lực Chức năng cài đặt Firebase
Nhắn tin qua đám mây Firebase

Firebase Cloud Messaging sử dụng ID cài đặt Firebase để nhắm mục tiêu các thiết bị để gửi tin nhắn.

Nhắn tin trong ứng dụng Firebase

Nhắn tin trong ứng dụng Firebase sử dụng ID cài đặt Firebase để nhắm mục tiêu các thiết bị để gửi tin nhắn.

Giám sát hiệu suất Firebase

Giám sát hiệu suất sử dụng ID cài đặt Firebase để tính toán số lượng cài đặt Firebase duy nhất truy cập tài nguyên mạng, nhằm đảm bảo rằng các mẫu truy cập đủ ẩn danh. Nó cũng sử dụng ID cài đặt Firebase với Cấu hình từ xa Firebase để quản lý tốc độ báo cáo sự kiện hiệu suất.

Cấu hình từ xa Firebase

Cấu hình từ xa sử dụng ID cài đặt Firebase để chọn các giá trị cấu hình để trả về thiết bị của người dùng cuối.

Máy học căn cứ hỏa lực

Thông tin xác thực được gọi là mã thông báo xác thực cài đặt được Firebase ML sử dụng để xác thực thiết bị khi tương tác với các phiên bản ứng dụng, chẳng hạn như để phân phối mô hình nhà phát triển cho các phiên bản ứng dụng.

Lưu trữ phân đoạn người dùng Firebase

Bộ lưu trữ phân đoạn người dùng Firebase lưu trữ ID cài đặt Firebase cũng như các thuộc tính và phân đoạn có liên quan để cung cấp thông tin nhắm mục tiêu cho các dịch vụ Firebase khác sử dụng chúng.

Thông thường, các dịch vụ Firebase sử dụng dịch vụ cài đặt Firebase mà không yêu cầu nhà phát triển tương tác trực tiếp với API FIS. Tuy nhiên, có những trường hợp nhà phát triển ứng dụng có thể muốn gọi trực tiếp API FIS, chẳng hạn như:

  • Để xóa cài đặt Firebase và dữ liệu được liên kết với cài đặt.
  • Để truy xuất số nhận dạng (ID cài đặt Firebase) nhằm nhắm mục tiêu cài đặt ứng dụng cụ thể.
  • Để truy xuất mã thông báo xác thực cài đặt để xác thực cài đặt Firebase.

Để bắt đầu gọi trực tiếp API FIS, hãy thêm SDK vào ứng dụng của bạn.

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

iOS+

  1. Thêm phần phụ thuộc cho cài đặt Firebase vào Podfile của bạn:
    pod 'FirebaseInstallations'
  2. Chạy pod install và mở tệp .xcworkspace đã tạo.
  3. Nhập mô-đun FirebaseCore trong UIApplicationDelegate của bạn, cũng như bất kỳ mô-đun Firebase nào khác mà ứng dụng ủy quyền của bạn sử dụng. Ví dụ: để sử dụng Cloud Firestore và Xác thực:

    SwiftUI

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

    Nhanh

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Mục tiêu-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  4. Định cấu hình một phiên bản chia sẻ FirebaseApp trong phương thức application(_:didFinishLaunchingWithOptions:) của ứng dụng của bạn:

    SwiftUI

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

    Nhanh

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

    Mục tiêu-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  5. Nếu đang sử dụng SwiftUI, bạn phải tạo một đại biểu ứng dụng và đính kèm nó vào cấu trúc App của mình thông qua UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor . Bạn cũng phải vô hiệu hóa tính năng xoay đại biểu của ứng dụng. Để biết thêm thông tin, hãy xem hướng dẫn SwiftUI .

    SwiftUI

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

Android

Thêm phần phụ thuộc cho SDK Android cài đặt Firebase vào tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là app/build.gradle ):

implementation 'com.google.firebase:firebase-installations:17.1.0'

JavaScript

Tùy thuộc vào cách ứng dụng web của bạn được lưu trữ, cấu hình của bạn có thể được xử lý tự động hoặc bạn có thể cần cập nhật đối tượng cấu hình Firebase của mình.

Ví dụ: nếu phần phụ thuộc của bạn được thêm vào index.html, hãy thêm phần phụ thuộc vào phần tử <head>:

<script src="/__/firebase/9.17.1/firebase-installations.js"></script>

Chớp cánh

  1. Từ thư mục gốc của dự án Flutter của bạn, hãy chạy lệnh sau để cài đặt plugin cài đặt Firebase:

    flutter pub add firebase_app_installations
    
  2. Xây dựng lại dự án của bạn:

    flutter run
    
  3. Nhập plugin cài đặt Firebase:

    import 'package:firebase_app_installations/firebase_app_installations.dart';
    

Xóa cài đặt Firebase

Dữ liệu gắn liền với cài đặt Firebase thường không nhận dạng cá nhân. Tuy nhiên, có thể hữu ích nếu cung cấp cho người dùng tùy chọn quản lý và xóa dữ liệu này.

ID cài đặt Firebase khác nhau đối với mọi cài đặt của mọi ứng dụng; các ứng dụng khác nhau trên cùng một thiết bị có ID cài đặt Firebase khác nhau. ID cài đặt Firebase xác định các lượt cài đặt ứng dụng và dữ liệu được liên kết với các lượt cài đặt ứng dụng đó.

Khi bạn xóa ID cài đặt, dữ liệu được liên kết với ID cài đặt đó sẽ bị xóa khỏi hệ thống đang hoạt động và sao lưu của tất cả các dịch vụ Firebase sử dụng ID cài đặt Firebase để xác định cài đặt trong vòng 180 ngày. Quá trình này được mô tả ở mức cao trong tuyên bố của Google về xóa và lưu giữ .

Trừ khi bạn tắt tất cả các dịch vụ tạo FID trong ứng dụng của mình, FIS sẽ tạo một ID mới trong vòng vài ngày. Firebase coi ID mới tạo là bản cài đặt Firebase mới và không liên kết ID đó với ID hoặc dữ liệu trước đó theo bất kỳ cách nào.

Xóa FID bằng lệnh gọi API ứng dụng khách

Để xóa FID do dịch vụ Firebase tạo, hãy gọi phương thức thích hợp từ SDK cài đặt Firebase:

Nhanh

Installations.installations().delete { error in
  if let error = error {
    print("Error deleting installation: \(error)")
    return
  }
  print("Installation deleted");
}

Mục tiêu-C

[[FIRInstallations installations] deleteWithCompletion:^(NSError *error) {
   if (error != nil) {
     NSLog(@"Error deleting Installation %@", error);
     return;
   }
   NSLog(@"Installation deleted");
}];

Java

FirebaseInstallations.getInstance().delete()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
    @Override
    public void onComplete(@NonNull Task<Void> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation deleted");
        } else {
            Log.e("Installations", "Unable to delete Installation");
        }
    }
});

Kotlin+KTX

FirebaseInstallations.getInstance().delete().addOnCompleteListener { task ->
    if (task.isComplete) {
        Log.d("Installations", "Installation deleted")
    }  else {
        Log.e("Installations", "Unable to delete Installation")
    }
}

JavaScript

await firebase.installations().delete();

Dart

await FirebaseInstallations.instance.delete();

Xóa FID bằng lệnh gọi API máy chủ

Để xóa FID bằng lệnh gọi API máy chủ, hãy thêm SDK quản trị Firebase vào máy chủ của bạn nếu bạn chưa có.

Sau khi SDK được thêm vào, hãy xóa FID thông qua lệnh gọi hàm xóa bằng ngôn ngữ bạn chọn (lưu ý: Ngoại trừ Node.js, các phương thức này phản ánh cách đặt tên ID phiên bản. Tuy nhiên, tất cả chúng thực sự xóa FID khi được gọi với bất kỳ Firebase hiện tại nào SDK).

Node.js

// An FIDsent from a client service SDK
const idToDelete = 'eyJhbGciOiJFUzI1N_iIs5';

admin.installations().deleteInstallation(idToDelete);

Java

// An FID sent from a client service SDK
String idToDelete = "eyJhbGciOiJFUzI1N_iIs5";

FirebaseInstanceId.getInstance().deleteInstanceIdAsync(idToDelete).get();

con trăn

  from firebase_admin import instance_id

  # An FID sent from a client service SDK
  id_to_delete = 'eyJhbGciOiJFUzI1N_iIs5'

  instance_id.delete_instance_id(id_to_delete)

Đi

client, err := app.InstanceId(ctx)
if err != nil {
  log.Fatalln("error initializing client", err)
}

iidToDelete := "eyJhbGciOiJFUzI1N_iIs5"
if err := client.DeleteInstanceId(ctx, iidToDelete); err != nil {
  log.Fatalln("error deleting FID", err)
}

Khi bạn xóa ID cài đặt Firebase bằng lệnh gọi API máy chủ, các dịch vụ Firebase sẽ bắt đầu quá trình xóa dữ liệu được liên kết với ID cài đặt đó, ngừng chấp nhận dữ liệu mới cho ID đó trong vòng 1-2 ngày, sau đó thông báo cho ứng dụng khách rằng ID đã bị xóa. Cho đến khi Firebase thông báo cho ứng dụng khách, một số dịch vụ của ứng dụng vẫn có thể nhắm mục tiêu ID—ví dụ: bản cài đặt Firebase có thể tiếp tục nhận thông báo FCM trong vài giờ.

Nếu bạn muốn xóa ID cài đặt Firebase hiện tại và sử dụng ngay các dịch vụ Firebase bằng ID mới, không liên quan, hãy sử dụng API máy khách để xử lý việc xóa.

Truy xuất số nhận dạng khách hàng

Nếu bạn có yêu cầu xác định các lượt cài đặt cụ thể của ứng dụng, thì bạn có thể làm như vậy bằng cách truy xuất ID cài đặt Firebase. Ví dụ: để thực hiện thử nghiệm trong quá trình phát triển Nhắn tin trong ứng dụng của Firebase, bạn có thể xác định và nhắm mục tiêu thiết bị thử nghiệm chính xác bằng cách sử dụng ID cài đặt Firebase của thiết bị đó.

Để truy xuất ID cài đặt Firebase:

Nhanh

Installations.installations().installationID { (id, error) in
  if let error = error {
    print("Error fetching id: \(error)")
    return
  }
  guard let id = id else { return }
  print("Installation ID: \(id)")
}

Mục tiêu-C

[[FIRInstallations installations] installationIDWithCompletion:^(NSString *identifier, NSError *error) {
  if (error != nil) {
    NSLog(@"Error fetching Installation ID %@", error);
    return;
  }
  NSLog(@"Installation ID: %@", identifier);
}];

Java

FirebaseInstallations.getInstance().getId()
        .addOnCompleteListener(new OnCompleteListener<String>() {
    @Override
    public void onComplete(@NonNull Task<String> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation ID: " + task.getResult());
        } else {
            Log.e("Installations", "Unable to get Installation ID");
        }
    }
});

Kotlin+KTX

FirebaseInstallations.getInstance().id.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        Log.d("Installations", "Installation ID: " + task.result)
    } else {
        Log.e("Installations", "Unable to get Installation ID")
    }
}

JavaScript

const installationId = await firebase.installations().getId();
console.log(installationId);

Dart

String id = await FirebaseInstallations.instance.getId();

Truy xuất mã thông báo xác thực cài đặt

Dịch vụ Firebase có thể xác thực cài đặt Firebase bằng mã thông báo xác thực được truy xuất từ ​​FIS. Ví dụ: khi thiết kế thử nghiệm A/B cho Cấu hình từ xa, bạn có thể xác thực thiết bị thử nghiệm được nhắm mục tiêu bằng mã thông báo xác thực cài đặt.

Mã thông báo xác thực cài đặt là mã thông báo mang thời gian tồn tại ngắn ở định dạng mã thông báo web JSON (JWT) chứa thông tin sau cho cài đặt:

  • ID cài đặt Firebase
  • Dự án liên quan ( projectNumber )
  • ID ứng dụng Firebase được liên kết ( appId )
  • Ngày hết hạn của mã thông báo

Không thể thu hồi mã thông báo xác thực cài đặt và vẫn có hiệu lực cho đến ngày hết hạn. Thời gian tồn tại của mã thông báo mặc định là một tuần.

Để truy xuất mã thông báo xác thực cài đặt:

Nhanh

Installations.installations().authTokenForcingRefresh(true, completion: { (result, error) in
  if let error = error {
    print("Error fetching token: \(error)")
    return
  }
  guard let result = result else { return }
  print("Installation auth token: \(result.authToken)")
})

Mục tiêu-C

[[FIRInstallations installations] authTokenForcingRefresh:true
                                               completion:^(FIRInstallationsAuthTokenResult *result, NSError *error) {
  if (error != nil) {
    NSLog(@"Error fetching Installation token %@", error);
    return;
  }
  NSLog(@"Installation auth token: %@", [result authToken]);
}];

Java

FirebaseInstallations.getInstance().getToken(/* forceRefresh */true)
        .addOnCompleteListener(new OnCompleteListener<InstallationTokenResult>() {
    @Override
    public void onComplete(@NonNull Task<InstallationTokenResult> task) {
        if (task.isSuccessful() && task.getResult() != null) {
            Log.d("Installations", "Installation auth token: " + task.getResult().getToken());
        } else {
            Log.e("Installations", "Unable to get Installation auth token");
        }
    }
});

Kotlin+KTX

FirebaseInstallations.getInstance().getToken(/* forceRefresh */ true)
    .addOnCompleteListener { task ->
        if (task.isSuccessful) {
            Log.d("Installations", "Installation auth token: " + task.result?.token)
        } else {
            Log.e("Installations", "Unable to get Installation auth token")
        }
    }

JavaScript

const installationToken = await firebase.installations()
    .getToken(/* forceRefresh */ true);
console.log(installationToken);

Dart

String token = await FirebaseInstallations.instance.getToken();

Giám sát vòng đời ID cài đặt Firebase

Trong quá trình hoạt động bình thường của ứng dụng, ID cài đặt Firebase (FID) không yêu cầu giám sát đặc biệt. Tuy nhiên, các ứng dụng truy xuất và sử dụng FID một cách rõ ràng nên thêm logic để giám sát khả năng xóa hoặc xoay FID. Dưới đây là một số trường hợp FID có thể bị xóa hoặc xoay:

  • Gỡ cài đặt hoặc cài đặt lại ứng dụng, chẳng hạn như khi người dùng cuối cài đặt trên một thiết bị mới.
  • Người dùng cuối xóa bộ nhớ cache của ứng dụng hoặc thiết bị.
  • Việc xóa FID được kích hoạt trong phần phụ trợ do ứng dụng không hoạt động (ngưỡng hiện tại cho việc này là 270 ngày không hoạt động).

Khi các ứng dụng gặp phải tình trạng xoay hoặc xóa FID trong các loại trường hợp này, chúng sẽ được gán một FID mới. Ngoài ra, mã thông báo xác thực cài đặt được liên kết với FID đã xóa sẽ bị xóa, bất kể ngày đáo hạn của chính nó và được thay thế bằng mã thông báo xác thực cài đặt mới.

Các ứng dụng có thể theo dõi những thay đổi này và phản hồi tương ứng.

Để giám sát luân chuyển FID:

Nhanh

installationIDObserver = NotificationCenter.default.addObserver(
        forName: .InstallationIDDidChange,
        object: nil,
        queue: nil
) { (notification) in
  // Fetch new Installation ID
  self.fetchInstallationToken()
}

Mục tiêu-C

__weak __auto_type weakSelf = self;
self.installationIDObserver = [[NSNotificationCenter defaultCenter]
        addObserverForName: FIRInstallationIDDidChangeNotification
                    object:nil
                     queue:nil
                usingBlock:^(NSNotification * _Nonnull notification) {
    // Fetch new Installation ID
    [weakSelf fetchInstallationsID];
}];

Một NSNotification có tên NSNotificationName.InstallationIDDidChange được đăng lên NSNotificationCenter mặc định bất cứ khi nào một FID mới được chỉ định.

Android

Máy khách Kotlin và Java nên thêm logic thử lại để phản hồi các lệnh gọi không thành công để truy xuất FID mới.

JavaScript

Ứng dụng web có thể đăng ký hook onIdChange .

Bất cứ khi nào một FID mới được tạo, cuộc gọi lại đã đăng ký sẽ được kích hoạt:

await firebase.installations().onIdChange((newId) => {
  console.log(newId);
  // TODO: Handle new installation ID.
});

Dart

FirebaseInstallations.instance.onIdChange.listen((token) {
  print('FID token: $token');
});

Di chuyển từ ID phiên bản sang cài đặt Firebase

Trước khi giới thiệu các bản cài đặt Firebase, Firebase dựa vào SDK ID phiên bản để nhận dạng các lượt cài đặt ứng dụng. Cài đặt Firebase mang lại lợi thế đáng kể so với ID phiên bản về độ tin cậy, hiệu suất và bảo mật. Các ứng dụng Firebase phụ thuộc vào SDK ID phiên bản sẽ chuyển sang bản cài đặt Firebase.

Quá trình di chuyển khác nhau dựa trên ứng dụng của bạn:

  • Các ứng dụng không gọi trực tiếp API ID phiên bản có thể di chuyển bằng cách cập nhật các phiên bản SDK của chúng . Hầu hết các ứng dụng Firebase đều thuộc danh mục này.

  • Các ứng dụng thực hiện lệnh gọi API đến ID phiên bản một cách rõ ràng phải cập nhật các phiên bản SDK thực hiện thay đổi mã để thay thế các phương thức ID phiên bản bằng các bản cài đặt Firebase hoặc FCM tương đương. Nếu ứng dụng của bạn sử dụng ID phiên bản để truy xuất mã thông báo đăng ký FCM hoặc sử dụng rõ ràng ID phiên bản để nhắm mục tiêu các phiên bản ứng dụng hoặc cho bất kỳ mục đích nào khác, bạn sẽ cần cập nhật mã ứng dụng của mình.

Hiện tại, FIS tương thích ngược với ID phiên bản Firebase định danh kế thừa. Xóa IID là một phương pháp thay thế để yêu cầu xóa dữ liệu với các SDK Firebase sau:

  • iOS 6.14.0 trở xuống
  • SDK Android trước ngày 27 tháng 2 năm 2020

Điều này có nghĩa là các ứng dụng không bắt buộc phải chuyển sang cài đặt Firebase; tuy nhiên, làm như vậy là rất khuyến khích.

Nâng cấp lên các phiên bản SDK tối thiểu để cài đặt Firebase

Để di chuyển từ ID phiên bản sang cài đặt Firebase, hãy đảm bảo rằng các ứng dụng của bạn sử dụng ít nhất số phiên bản tối thiểu được liệt kê của các SDK Firebase sau:

SDK căn cứ hỏa lực Phiên bản Android tối thiểu Phiên bản iOS tối thiểu
Nhắn tin qua đám mây Firebase v20.3.0 v6.34.0
Cấu hình từ xa v19.2.0 v6.24.0
Google Analytics cho Firebase \ (SDK đo lường) v17.4.4 v6.18.0
Nhắn tin trong ứng dụng v19.0.7 v6.24.0
Giám sát hiệu suất v19.0.8 v6.21.0
Crashlytics v17.2.1 v6.23.0
Bộ dụng cụ ML v22.1.2 v6.28.0

Cập nhật mã gọi API ID phiên bản một cách rõ ràng

Nếu ứng dụng Android hoặc Apple của bạn trực tiếp sử dụng các phương thức SDK ID phiên bản, thì bạn có thể thay thế cách sử dụng đó bằng các phương thức thay thế giống hệt nhau trong SDK cài đặt Firebase hoặc SDK FCM.

Truy xuất số nhận dạng

Các phương thức lấy ID phiên bản được thay thế bằng các phương thức lấy ID cài đặt. Ví dụ:

Trước

Nhanh

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

Mục tiêu-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString * _Nullable token, NSError * _Nullable error) {
   if (error != nil) {
     NSLog(@"Error fetching the remote FCM registration token: %@", error);
   } else {
     NSLog(@"Remote FCM registration token: %@", token);
     NSString* message =
       [NSString stringWithFormat:@"FCM registration token: %@", token];
     self.remoteFCMTokenMessage.text = message;
   }
 }];

Java

FirebaseInstanceId.getInstance().getInstanceId()
        .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
            @Override
            public void onComplete(@NonNull Task<InstanceIdResult> task) {
                Log.d("IID_TOKEN", task.getResult().getToken());
            }
        });

Kotlin+KTX

FirebaseInstanceId.getInstance().instanceId
        .addOnSuccessListener { result ->
            Log.d("IID_TOKEN", result.token)
        }

Sau đó

Nhanh

Installations.installations().installationID { (id, error) in
  if let error = error {
    print("Error fetching id: \(error)")
    return
  }
  guard let id = id else { return }
  print("Installation ID: \(id)")
}

Mục tiêu-C

[[FIRInstallations installations] installationIDWithCompletion:^(NSString *identifier, NSError *error) {
  if (error != nil) {
    NSLog(@"Error fetching Installation ID %@", error);
    return;
  }
  NSLog(@"Installation ID: %@", identifier);
}];

Java

FirebaseInstallations.getInstance().getId()
        .addOnCompleteListener(new OnCompleteListener<String>() {
    @Override
    public void onComplete(@NonNull Task<String> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation ID: " + task.getResult());
        } else {
            Log.e("Installations", "Unable to get Installation ID");
        }
    }
});

Kotlin+KTX

FirebaseInstallations.getInstance().id.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        Log.d("Installations", "Installation ID: " + task.result)
    } else {
        Log.e("Installations", "Unable to get Installation ID")
    }
}

Xóa định danh

Các phương pháp xóa ID phiên bản được thay thế bằng các phương pháp xóa ID cài đặt Firebase. Ví dụ:

Trước

Nhanh

InstanceID.instanceID().deleteID { error in
  if let error = error {
    print("Error deleting instance ID: \(error)")
  }
}

Mục tiêu-C

[FIRInstanceID instanceID] deleteIDWithHandler:^(NSError *error) {
  if error != nil {
    NSLog(@"Error deleting instance ID: %@", error);
  }
}];

Android

FirebaseInstanceId.deleteInstanceId();

Sau đó

Nhanh

func delete(completion: @escaping (Error?) -> Void)

Mục tiêu-C

- (void)deleteWithCompletion:(nonnull void (^)(NSError *_Nullable))completion;

Java

FirebaseInstallations.getInstance().delete()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
    @Override
    public void onComplete(@NonNull Task<Void> task) {
        if (task.isSuccessful()) {
            Log.d("Installations", "Installation deleted");
        } else {
            Log.e("Installations", "Unable to delete Installation");
        }
    }
});

Kotlin+KTX

FirebaseInstallations.getInstance().delete().addOnCompleteListener { task ->
    if (task.isComplete) {
        Log.d("Installations", "Installation deleted")
    }  else {
        Log.e("Installations", "Unable to delete Installation")
    }
}

Truy xuất mã thông báo đăng ký FCM

Trước khi giới thiệu Cài đặt Firebase, khách hàng FCM đã truy xuất mã thông báo đăng ký từ ID phiên bản. Giờ đây, SDK FCM cung cấp các phương thức để truy xuất mã thông báo đăng ký.

Trước

Java

FirebaseInstanceId.getInstance().getInstanceId()
        .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
            @Override
            public void onComplete(@NonNull Task<InstanceIdResult> task) {
                if (!task.isSuccessful()) {
                    Log.w(TAG, "getInstanceId failed", task.getException());
                    return;
                }

                // Get new Instance ID token
                String token = task.getResult().getToken();

                // Log and toast
                String msg = getString(R.string.msg_token_fmt, token);
                Log.d(TAG, msg);
                Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
            }
        });

Kotlin+KTX

FirebaseInstanceId.getInstance().instanceId
        .addOnCompleteListener(OnCompleteListener { task ->
            if (!task.isSuccessful) {
                Log.w(TAG, "getInstanceId failed", task.exception)
                return@OnCompleteListener
            }

            // Get new Instance ID token
            val token = task.result?.token

            // Log and toast
            val msg = getString(R.string.msg_token_fmt, token)
            Log.d(TAG, msg)
            Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
        })

Nhanh

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

Mục tiêu-C

[[FIRMessaging messaging] tokenWithCompletion:^(NSString * _Nullable token, NSError * _Nullable error) {
   if (error != nil) {
     NSLog(@"Error fetching the remote FCM registration token: %@", error);
   } else {
     NSLog(@"Remote FCM registration token: %@", token);
     NSString* message =
       [NSString stringWithFormat:@"FCM registration token: %@", token];
     self.remoteFCMTokenMessage.text = message;
   }
 }];

Sau đó

Java

FirebaseMessaging.getInstance().getToken()
    .addOnCompleteListener(new OnCompleteListener<String>() {
        @Override
        public void onComplete(@NonNull Task<String> task) {
          if (!task.isSuccessful()) {
            Log.w(TAG, "Fetching FCM registration token failed", task.getException());
            return;
          }

          // Get new FCM registration token
          String token = task.getResult();

          // Log and toast
          String msg = getString(R.string.msg_token_fmt, token);
          Log.d(TAG, msg);
          Toast.makeText(MainActivity.this, msg, Toast.LENGTH_SHORT).show();
        }
    });

Kotlin+KTX

FirebaseMessaging.getInstance().token.addOnCompleteListener(OnCompleteListener { task ->
    if (!task.isSuccessful) {
        Log.w(TAG, "Fetching FCM registration token failed", task.exception)
        return@OnCompleteListener
    }

    // Get new FCM registration token
    val token = task.result

    // Log and toast
    val msg = getString(R.string.msg_token_fmt, token)
    Log.d(TAG, msg)
    Toast.makeText(baseContext, msg, Toast.LENGTH_SHORT).show()
})

Nhanh

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

Mục tiêu-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;
  }
}];