Khắc phục sự cố về tuỳ chọn khởi chạy

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

Tùy chọn Firebase là tập hợp các thông số mà 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 ứng dụng với dự án Firebase và ứng dụng Firebase của bạn. Các dịch vụ Firebase dựa vào các tùy chọn Firebase hợp lệ có sẵn từ thư viện chính/thư viện chung của Firebase được tạo trong quá trình khởi chạy Firebase.

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

  • Khoá API – Lưu ý: đây không phải là khoá máy chủ FCM, hãy xem Khoá máy chủ FCM.
    Giá trị mẫu: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO
  • Mã dự án – Giá trị mẫu: myapp-project-123.
  • Mã ứng dụng ("AppID") – Giá trị nhận dạng duy nhất cho ứng dụng của bạn có định dạng phụ 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à mã nhận dạng gói Apple.
      Giá trị mẫu: 1:1234567890:ios:321abc456def7890

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

Để tăng cường bảo mật, Firebase SDK sẽ cập nhật vào ngày 27 tháng 2 và sau đó thay thế dịch vụ mã phiên bản Firebase bằng phần phụ thuộc trên API cài đặt Firebase.

Firebase lượt cài đặt thực thi sự tồn tại và hiệu lực của Firebase bắt buộc khoá API, Mã dự án và Mã ứng dụng để liên kết với ứng dụng với dự án Firebase của bạn. Xem FirebaseOptions để tìm hiểu thêm của bạn.

Giải pháp gửi thông báo qua đám mây của Firebase (FCM) với mã phiên bản Firebase (IID)

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

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

Do đó, các dịch vụ của Firebase như Giải pháp gửi thông báo qua đám mây của Firebase sẽ gặp sự 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 phiên bản Firebase SDK. Ngoài ra, việc gửi nhiều yêu cầu không thành công đến Firebase có thể làm chậm tốc độ trải nghiệm người dùng cuối của ứng dụng.

Việc bạn cần làm

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

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

Khắc phục sự cố với ứng dụng của Apple

Để tăng cường bảo mật, Firebase SDK sẽ cập nhật vào ngày 14 tháng 1 sau đó thay thế dịch vụ mã phiên bản Firebase bằng phần phụ thuộc trên API cài đặt Firebase.

Firebase lượt cài đặt thực thi sự tồn tại và hiệu lực của Firebase bắt buộc khoá API, Mã dự án và Mã ứng dụng để liên kết với ứng dụng với dự án Firebase của bạn. Xem FIROptions để tìm hiểu thêm của bạn.

Giải pháp gửi thông báo qua đám mây của Firebase (FCM) với mã phiên bản Firebase (IID)

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

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

Do đó, các dịch vụ Firebase như Firebase Cloud Messaging sẽ gặp sự 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 thông qua Firebase được cập nhật SDK. Ngoài ra, việc gửi nhiều yêu cầu không thành công gửi tới Firebase có thể làm chậm quá trình trải nghiệm người dùng của ứng dụng.

Việc bạn cần làm

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

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

Khoá máy chủ FCM

Nếu ứng dụng của bạn đang sử dụng khoá máy chủ FCM thay vì một Cloud API. Việc 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 khoá Máy chủ FCM để gửi thông báo đẩy qua FCM. Trong trường hợp này, bạn nên sửa đổi cách máy chủ của mình xác thực gửi yêu cầu đến FCM.

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