Khắc phục sự cố các tùy chọn khởi tạo

Nếu bạn khởi chạy ứng dụng của mình mà không có bộ tùy chọn Firebase hợp lệ thì người dùng mới của ứng dụng sẽ gặp phải sự cố nghiêm trọng.

Tùy chọn Firebase là một tập hợp các tham số mà các dịch vụ yêu cầu để giao tiếp thành công với API máy chủ Firebase và liên kết dữ liệu khách hàng với dự án Firebase và ứng dụng Firebase của bạn. Các dịch vụ Firebase dựa trên các tùy chọn Firebase hợp lệ có sẵn từ thư viện chung/lõi Firebase được tạo trong quá trình khởi tạo Firebase.

Các dịch vụ Firebase khác nhau yêu cầu các tùy chọn Firebase khác nhau để hoạt động bình thường, nhưng tất cả các dịch vụ Firebase đều yêu cầu các tùy chọn Firebase sau:

  • Khóa API - Lưu ý: đây không phải là khóa máy chủ FCM, hãy xem Khóa máy chủ FCM .
    Giá trị mẫu: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO
  • ID dự án - Giá trị mẫu: myapp-project-123 .
  • ID ứng dụng ("AppID") - Mã định danh duy nhất cho ứng dụng của bạn có định dạng tùy thuộc vào nền tảng:
    • Đối với Android: mobilesdk_app_id —Lưu ý: đây không phải là tên gói Android .
      Giá trị mẫu: 1:1234567890:android:321abc456def7890
    • Đối với iOS+: GOOGLE_APP_ID —Lưu ý: đây không phải là ID Apple Bundle .
      Giá trị mẫu: 1:1234567890:ios:321abc456def7890

Khắc phục sự cố ứng dụng Android

Để cải thiện tính bảo mật, SDK Firebase cập nhật vào ngày 27 tháng 2 và sau đó thay thế dịch vụ ID phiên bản Firebase bằng phần phụ thuộc vào API cài đặt Firebase .

Quá trình cài đặt Firebase thực thi sự tồn tại và hợp lệ của khóa API tùy chọn Firebase, ID dự án và ID ứng dụng bắt buộc để liên kết dữ liệu khách hàng với dự án Firebase của bạn. Xem FirebaseOptions để biết thêm thông tin.

Nhắn tin qua đám mây Firebase (FCM) với ID phiên bản Firebase (IID)

Nếu người dùng mới ứng dụng của bạn gặp sự cố với FCM, thì có thể bạn đang khởi chạy Firebase mà không có bộ tùy chọn Firebase bắt buộc.

Ứng dụng của bạn có thể đang sử dụng tệp cấu hình google-services.json không đầy đủ hoặc có lỗi; hoặc ứng dụng của bạn đang khởi chạy Firebase theo chương trình mà không có đầy đủ các tùy chọn Firebase bắt buộc.

Do đó, các dịch vụ Firebase như Firebase Cloud Messaging sẽ gặp trục trặc đối với người dùng cuối đã cài đặt ứng dụng của bạn sau khi ứng dụng được phát hành cùng với SDK Firebase cập nhật. Ngoài ra, việc lặp lại các yêu cầu không thành công đối với Firebase có thể làm chậm trải nghiệm của người dùng cuối đối với ứng dụng của bạn.

Tôi cần phải làm gì?

Để khắc phục sự cố dịch vụ Firebase cho ứng dụng của bạn:

  1. Cập nhật ứng dụng của bạn bằng cách khởi tạo Firebase bằng khóa API hợp lệ của dự án, ID dự án hợp lệ và ID ứng dụng hợp lệ ( mobilesdk_app_id hoặc "Id ứng dụng").
    • Quy trình khởi tạo mặc định bằng tệp cấu hình Firebase : Tải xuống tệp cấu hình google-services.json từ bảng điều khiển Firebase, sau đó thay thế tệp hiện có trong ứng dụng của bạn.
    • Khởi tạo có lập trình bằng cách sử dụng đối tượng FirebaseOptions : Tải xuống tệp cấu hình google-services.json từ bảng điều khiển Firebase để tìm khóa API, ID dự án và ID ứng dụng, sau đó cập nhật các giá trị này trong đối tượng FirebaseOptions trong ứng dụng của bạn.
  2. Phát hành phiên bản mới của ứng dụng của bạn lên Cửa hàng Play.

Khắc phục sự cố ứng dụng Apple

Để cải thiện tính bảo mật, SDK Firebase cập nhật vào ngày 14 tháng 1 và sau đó thay thế dịch vụ ID phiên bản Firebase bằng phần phụ thuộc vào API cài đặt Firebase .

Quá trình cài đặt Firebase thực thi sự tồn tại và hợp lệ của khóa API tùy chọn Firebase, ID dự án và ID ứng dụng bắt buộc để liên kết dữ liệu khách hàng với dự án Firebase của bạn. Xem FIROptions để biết thêm thông tin.

Nhắn tin qua đám mây Firebase (FCM) với ID phiên bản Firebase (IID)

Nếu người dùng mới ứng dụng của bạn gặp sự cố với FCM, thì có thể bạn đang khởi chạy Firebase mà không có bộ tùy chọn Firebase bắt buộc.

Ứng dụng của bạn có thể đang sử dụng tệp cấu hình GoogleService-Info.plist không đầy đủ hoặc không hợp lệ; hoặc ứng dụng của bạn đang khởi chạy Firebase theo chương trình mà không có đầy đủ các tùy chọn Firebase bắt buộc.

Do đó, các dịch vụ Firebase như Firebase Cloud Messaging sẽ gặp trục trặc đối với người dùng cuối đã cài đặt ứng dụng của bạn sau khi ứng dụng được phát hành cùng với SDK Firebase cập nhật. Ngoài ra, việc lặp lại các yêu cầu không thành công đối với Firebase có thể làm chậm trải nghiệm của người dùng cuối đối với ứng dụng của bạn.

Tôi cần phải làm gì?

Để khắc phục sự cố dịch vụ Firebase cho ứng dụng của bạn:

  1. Cập nhật ứng dụng của bạn bằng cách khởi tạo Firebase bằng khóa API hợp lệ của dự án, ID dự án hợp lệ và ID ứng dụng hợp lệ ( GOOGLE_APP_ID hoặc "Id ứng dụng").
    1. Quy trình khởi tạo mặc định bằng tệp cấu hình Firebase : Tải xuống tệp cấu hình GoogleService-Info.plist từ bảng điều khiển Firebase, sau đó thay thế tệp hiện có trong ứng dụng của bạn.
    2. Khởi tạo có lập trình bằng cách sử dụng đối tượng FIROptions : Tải xuống tệp cấu hình GoogleService-Info.plist từ bảng điều khiển Firebase để tìm khóa API, ID dự án và ID ứng dụng, sau đó cập nhật các giá trị này trong đối tượng FIROptions trong ứng dụng của bạn.
  2. Phát hành phiên bản mới của ứng dụng của bạn lên App Store.

Khóa máy chủ FCM

Nếu ứng dụng của bạn đang sử dụng khóa Máy chủ FCM thay vì khóa API đám mây, điều này có thể gây ra lỗ hổng bảo mật trong trường hợp bạn đang sử dụng cùng một khóa Máy chủ FCM để gửi thông báo đẩy qua FCM. Trong trường hợp này, chúng tôi thực sự khuyên bạn nên sửa lại cách máy chủ của bạn xác thực việc gửi yêu cầu tới FCM .

Lưu ý rằng Khóa máy chủ FCM (không giống với khóa API Firebase/Cloud) không được đưa vào ứng dụng vì chúng có thể bị lạm dụng để gửi thông báo đẩy dưới tên dự án của bạn.