Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Cài đặt Tiện ích mở rộng 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.

Bạn có thể cài đặt (và quản lý ) bất kỳ tiện ích mở rộng Firebase chính thức nào bằng cách sử dụng bảng điều khiển Firebase hoặc Firebase CLI (giao diện dòng lệnh).

Đảm bảo xem xét sự khác biệt trong các hành động được hỗ trợ cho Firebase CLI và bảng điều khiển Firebase.


Để cài đặt hoặc quản lý tiện ích mở rộng, bạn phải được chỉ định một trong các vai trò sau: Chủ sở hữu hoặc Người chỉnh sửa hoặc Quản trị viên Firebase .

Để cài đặt tiện ích mở rộng, dự án của bạn phải nằm trong gói Blaze (thanh toán khi bạn sử dụng). Mặc dù không tính phí cài đặt tiện ích mở rộng, nhưng bạn có thể bị tính phí cho việc sử dụng dịch vụ Firebase hoặc dịch vụ Đám mây, chẳng hạn như Trình quản lý bí mật của đám mây , nếu mức sử dụng của bạn vượt quá bậc miễn phí của dịch vụ.

Trước khi bắt đầu

Nếu bạn chưa có, hãy thêm Firebase vào dự án của bạn và nâng cấp dự án Firebase của bạn lên gói Blaze (thanh toán khi sử dụng).

Bước 1 : Xem thông tin chi tiết về tiện ích mở rộng

Bước này là tùy chọn, nhưng rất khuyến khích.

Trước khi cài đặt Tiện ích mở rộng Firebase, chúng tôi khuyên bạn nên xem lại thông tin chi tiết về tiện ích mở rộng, bao gồm:

  • Cách thức hoạt động của tiện ích mở rộng, mọi tác vụ cài đặt sẵn và thông tin chi tiết về tiện ích mở rộng
  • Thông tin nhận dạng chung và mô tả
  • Liệu các tác vụ của tiện ích mở rộng có yêu cầu tài khoản thanh toán hay không
  • Các dịch vụ của Google (API) và vai trò truy cập cần thiết cho hoạt động
  • Tài nguyên được tạo cho tiện ích mở rộng (như chức năng)
  • Mô tả các tham số do người dùng cấu hình

Để xem thông tin chi tiết của tiện ích mở rộng:

  1. Duyệt qua các tiện ích mở rộng Firebase chính thức trong Thị trường tiện ích mở rộng .

  2. Nhấp vào thẻ của tiện ích mở rộng để:

Bước 2 : Cài đặt tiện ích mở rộng

Trong quá trình cài đặt, bạn sẽ được nhắc xem lại các thông số kỹ thuật cơ bản cho tiện ích mở rộng (chẳng hạn như API đã bật, tài nguyên đã tạo, quyền truy cập được cấp, v.v.). Bạn sẽ được thông báo về bất kỳ yêu cầu thanh toán nào và bạn cũng sẽ được nhắc chỉ định giá trị cho các tham số có thể định cấu hình của tiện ích mở rộng.

  1. Duyệt qua các tiện ích mở rộng Firebase chính thức trong Thị trường tiện ích mở rộng .

  2. Nhấp vào thẻ của tiện ích mở rộng, sau đó xem lại thông tin chi tiết cho tiện ích mở rộng, tiện ích này có thể cung cấp hướng dẫn sử dụng cụ thể và mọi tác vụ trước khi cài đặt.

  3. Nhấp vào Cài đặt , sau đó làm theo hướng dẫn trên màn hình để cài đặt tiện ích mở rộng.

Bước 3 : Hoàn tất thiết lập sau khi cài đặt

Một số tiện ích mở rộng có các bước bắt buộc hoặc tùy chọn để bạn hoàn thành trước khi sử dụng chúng. Tìm các hướng dẫn này trong trang chi tiết sau khi cài đặt tiện ích mở rộng của bạn trong bảng điều khiển Tiện ích mở rộng của bảng điều khiển Firebase (liên kết cụ thể đến bảng điều khiển được hiển thị trong thiết bị đầu cuối sau khi cài đặt).

Bạn cũng có thể tìm thấy các hướng dẫn này trong tệp POSTINSTALL.md có trong thư mục nguồn của tiện ích mở rộng .

Tạo tài nguyên Firebase

Nếu bạn đã định cấu hình tiện ích mở rộng để sử dụng tài nguyên Firebase (bộ sưu tập Cloud Firestore, đường dẫn Cơ sở dữ liệu thời gian thực, bộ chứa Cloud Storage) chưa tồn tại, hãy tạo chúng trước khi sử dụng tiện ích mở rộng.

Tạo trình xử lý sự kiện Eventarc

Một số tiện ích mở rộng xuất bản lên Eventarc khi các sự kiện quan trọng xảy ra trong quá trình thực thi. Nếu tiện ích xuất bản sự kiện và bạn đã bật sự kiện trong khi cài đặt, thì bạn có thể viết các hàm phản ứng với những sự kiện này bằng logic tùy chỉnh của riêng mình. Điều này có thể hữu ích, ví dụ, để thông báo cho người dùng khi hoàn thành các tác vụ dài hạn hoặc để xử lý hậu kỳ đầu ra của chức năng mở rộng.

Xem tài liệu của tiện ích mở rộng để biết danh sách các sự kiện (nếu có) mà tiện ích xuất bản.

Sau đó, xem Trình kích hoạt sự kiện tùy chỉnh để biết thông tin về cách viết trình xử lý sự kiện Eventarc.

Cài đặt nhiều phiên bản tiện ích mở rộng

Bạn có thể cài đặt cùng một tiện ích mở rộng nhiều lần trong cùng một dự án. Mỗi phiên bản được cài đặt có thể có cấu hình tùy chỉnh riêng và tài nguyên tiện ích mở rộng riêng. Bạn xác định và tham chiếu đến từng phiên bản đã cài đặt bằng cách sử dụng ID phiên bản của phiên bản đó, ID này là duy nhất trong dự án của bạn. Bạn sẽ được nhắc xác nhận hoặc chỉnh sửa ID phiên bản của từng phiên bản bổ sung của tiện ích mà bạn cài đặt.

Bước tiếp theo

  • Xem chi tiết và cấu hình của tiện ích mở rộng đã cài đặt của bạn trong bảng điều khiển Firebase.

  • Theo dõi hoạt động của tiện ích mở rộng đã cài đặt của bạn, bao gồm kiểm tra tình trạng, cách sử dụng và nhật ký của tiện ích mở rộng đó.

  • Sử dụng bảng điều khiển Firebase, quản lý tiện ích mở rộng đã cài đặt của bạn. Đối với các tiện ích mở rộng Firebase chính thức, bạn có thể định cấu hình lại hoặc gỡ cài đặt tiện ích mở rộng của mình, cũng như cập nhật tiện ích mở rộng lên phiên bản mới nhất.

  • Là một phương pháp hay nhất cho tất cả các dự án, hãy đảm bảo thiết lập cảnh báo ngân sách cho dự án của bạn và theo dõi bảng điều khiển Sử dụng và thanh toán trong bảng điều khiển Firebase.

,

Bạn có thể cài đặt (và quản lý ) bất kỳ tiện ích mở rộng Firebase chính thức nào bằng cách sử dụng bảng điều khiển Firebase hoặc Firebase CLI (giao diện dòng lệnh).

Đảm bảo xem xét sự khác biệt trong các hành động được hỗ trợ cho Firebase CLI và bảng điều khiển Firebase.


Để cài đặt hoặc quản lý tiện ích mở rộng, bạn phải được chỉ định một trong các vai trò sau: Chủ sở hữu hoặc Người chỉnh sửa hoặc Quản trị viên Firebase .

Để cài đặt tiện ích mở rộng, dự án của bạn phải nằm trong gói Blaze (thanh toán khi bạn sử dụng). Mặc dù không tính phí cài đặt tiện ích mở rộng, nhưng bạn có thể bị tính phí cho việc sử dụng dịch vụ Firebase hoặc dịch vụ Đám mây, chẳng hạn như Trình quản lý bí mật của đám mây , nếu mức sử dụng của bạn vượt quá bậc miễn phí của dịch vụ.

Trước khi bắt đầu

Nếu bạn chưa có, hãy thêm Firebase vào dự án của bạn và nâng cấp dự án Firebase của bạn lên gói Blaze (thanh toán khi sử dụng).

Bước 1 : Xem thông tin chi tiết về tiện ích mở rộng

Bước này là tùy chọn, nhưng rất khuyến khích.

Trước khi cài đặt Tiện ích mở rộng Firebase, chúng tôi khuyên bạn nên xem lại thông tin chi tiết về tiện ích mở rộng, bao gồm:

  • Cách thức hoạt động của tiện ích mở rộng, mọi tác vụ cài đặt sẵn và thông tin chi tiết về tiện ích mở rộng
  • Thông tin nhận dạng chung và mô tả
  • Liệu các tác vụ của tiện ích mở rộng có yêu cầu tài khoản thanh toán hay không
  • Các dịch vụ của Google (API) và vai trò truy cập cần thiết cho hoạt động
  • Tài nguyên được tạo cho tiện ích mở rộng (như chức năng)
  • Mô tả các tham số do người dùng cấu hình

Để xem thông tin chi tiết của tiện ích mở rộng:

  1. Duyệt qua các tiện ích mở rộng Firebase chính thức trong Thị trường tiện ích mở rộng .

  2. Nhấp vào thẻ của tiện ích mở rộng để:

Bước 2 : Cài đặt tiện ích mở rộng

Trong quá trình cài đặt, bạn sẽ được nhắc xem lại các thông số kỹ thuật cơ bản cho tiện ích mở rộng (chẳng hạn như API đã bật, tài nguyên đã tạo, quyền truy cập được cấp, v.v.). Bạn sẽ được thông báo về bất kỳ yêu cầu thanh toán nào và bạn cũng sẽ được nhắc chỉ định giá trị cho các tham số có thể định cấu hình của tiện ích mở rộng.

  1. Duyệt qua các tiện ích mở rộng Firebase chính thức trong Thị trường tiện ích mở rộng .

  2. Nhấp vào thẻ của tiện ích mở rộng, sau đó xem lại thông tin chi tiết cho tiện ích mở rộng, tiện ích này có thể cung cấp hướng dẫn sử dụng cụ thể và mọi tác vụ trước khi cài đặt.

  3. Nhấp vào Cài đặt , sau đó làm theo hướng dẫn trên màn hình để cài đặt tiện ích mở rộng.

Bước 3 : Hoàn tất thiết lập sau khi cài đặt

Một số tiện ích mở rộng có các bước bắt buộc hoặc tùy chọn để bạn hoàn thành trước khi sử dụng chúng. Tìm các hướng dẫn này trong trang chi tiết sau khi cài đặt tiện ích mở rộng của bạn trong bảng điều khiển Tiện ích mở rộng của bảng điều khiển Firebase (liên kết cụ thể đến bảng điều khiển được hiển thị trong thiết bị đầu cuối sau khi cài đặt).

Bạn cũng có thể tìm thấy các hướng dẫn này trong tệp POSTINSTALL.md có trong thư mục nguồn của tiện ích mở rộng .

Tạo tài nguyên Firebase

Nếu bạn đã định cấu hình tiện ích mở rộng để sử dụng tài nguyên Firebase (bộ sưu tập Cloud Firestore, đường dẫn Cơ sở dữ liệu thời gian thực, bộ chứa Cloud Storage) chưa tồn tại, hãy tạo chúng trước khi sử dụng tiện ích mở rộng.

Tạo trình xử lý sự kiện Eventarc

Một số tiện ích mở rộng xuất bản lên Eventarc khi các sự kiện quan trọng xảy ra trong quá trình thực thi. Nếu một tiện ích mở rộng phát hành các sự kiện và bạn đã bật các sự kiện trong khi cài đặt, thì bạn có thể viết các hàm phản ứng với các sự kiện này bằng logic tùy chỉnh của riêng mình. Điều này có thể hữu ích, ví dụ, để thông báo cho người dùng khi hoàn thành các tác vụ dài hạn hoặc để xử lý hậu kỳ đầu ra của chức năng mở rộng.

Xem tài liệu của tiện ích mở rộng để biết danh sách các sự kiện (nếu có) mà tiện ích xuất bản.

Sau đó, xem Trình kích hoạt sự kiện tùy chỉnh để biết thông tin về cách viết trình xử lý sự kiện Eventarc.

Cài đặt nhiều phiên bản tiện ích mở rộng

Bạn có thể cài đặt cùng một tiện ích mở rộng nhiều lần trong cùng một dự án. Mỗi phiên bản được cài đặt có thể có cấu hình tùy chỉnh riêng và tài nguyên tiện ích mở rộng riêng. Bạn xác định và tham chiếu đến từng phiên bản đã cài đặt bằng cách sử dụng ID phiên bản của phiên bản đó, ID này là duy nhất trong dự án của bạn. Bạn sẽ được nhắc xác nhận hoặc chỉnh sửa ID phiên bản của từng phiên bản bổ sung của tiện ích mà bạn cài đặt.

Bước tiếp theo

  • Xem chi tiết và cấu hình của tiện ích mở rộng đã cài đặt của bạn trong bảng điều khiển Firebase.

  • Theo dõi hoạt động của tiện ích mở rộng đã cài đặt của bạn, bao gồm kiểm tra tình trạng, cách sử dụng và nhật ký của tiện ích mở rộng đó.

  • Sử dụng bảng điều khiển Firebase, quản lý tiện ích mở rộng đã cài đặt của bạn. Đối với các tiện ích mở rộng Firebase chính thức, bạn có thể định cấu hình lại hoặc gỡ cài đặt tiện ích mở rộng của mình, cũng như cập nhật tiện ích mở rộng lên phiên bản mới nhất.

  • Là một phương pháp hay nhất cho tất cả các dự án, hãy đảm bảo thiết lập cảnh báo ngân sách cho dự án của bạn và theo dõi bảng điều khiển Sử dụng và thanh toán trong bảng điều khiển Firebase.