Cài đặt một tiện ích Firebase

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

Hãy nhớ xem lại điểm khác biệt trong các thao tác được hỗ trợ đối với từng phương thức cài đặt.



Để cài đặt hoặc quản lý tiện ích, 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, dự án của bạn phải sử dụng gói Blaze (thanh toán khi sử dụng). Mặc dù không mất phí để cài đặt tiện ích, nhưng bạn có thể phải trả phí khi sử dụng các dịch vụ Firebase hoặc dịch vụ trên đám mây như Trình quản lý bí mật trên đám mây nếu mức sử dụng của bạn vượt quá cấp miễn phí của các dịch vụ này.

Trước khi bắt đầu

Nếu bạn chưa thực hiện, hãy thêm Firebase vào dự án và nâng cấp dự án Firebase lên gói Blaze (trả theo mức sử dụng).

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

Đây là bước không bắt buộc nhưng bạn nên thực hiện.

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

  • Cách hoạt động của tiện ích, mọi tác vụ cài đặt trước và thông tin chi tiết về tiện ích
  • Thông tin nhận dạng chung và nội dung mô tả
  • Liệu các tác vụ của tiện ích 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 để hoạt động
  • Tài nguyên được tạo cho tiện ích (như các hàm)
  • Nội dung mô tả về các tham số mà người dùng có thể định cấu hình

Cách xem thông tin chi tiết về một tiện ích:

  1. Duyệt xem các tiện ích Firebase chính thức trong Extensions Hub.

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

Bước 2: Cài đặt tiện ích

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 của tiện ích (chẳng hạn như các API đã bật, tài nguyên đã tạo, quyền truy cập đã cấp, v.v.). Bạn sẽ nhận được thông báo về mọi yêu cầu thanh toán và bạn cũng sẽ được nhắc chỉ định giá trị cho các thông số có thể định cấu hình của tiện ích.

  1. Duyệt xem các tiện ích Firebase chính thức trong Extensions Hub.

  2. Nhấp vào thẻ của một tiện ích, sau đó xem thông tin chi tiết về tiện ích đó. Thông tin này có thể cung cấp hướng dẫn sử dụng cụ thể và mọi tác vụ cần thực hiện 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 trình bổ trợ.

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

Một số tiện ích có các bước bắt buộc hoặc không bắt buộc mà bạn phải hoàn tất trước khi sử dụng. Bạn có thể tìm thấy các hướng dẫn này trong trang chi tiết sau khi cài đặt tiện ích trên trang tổng quan Extensions của bảng điều khiển Firebase (đường liên kết cụ thể đến trang tổng quan sẽ xuất hiện 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.

Tạo các tài nguyên trên Firebase

Nếu bạn đã định cấu hình tiện ích để sử dụng tài nguyên Firebase (Cloud Firestore bộ sưu tập, đường dẫn Realtime Database, bộ chứa Cloud Storage) không tồn tại, hãy tạo các tài nguyên đó trước khi sử dụng tiện ích.

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

Một số tiện ích phát hành 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 phát hành sự kiện và bạn đã bật sự kiện trong quá trình 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 tuỳ chỉnh của riêng mình. Điều này có thể hữu ích, chẳng hạn như để thông báo cho người dùng khi các tác vụ chạy trong thời gian dài hoàn tất hoặc để xử lý hậu kỳ đầu ra của một hàm mở rộng.

Hãy xem tài liệu của tiện ích để biết danh sách sự kiện (nếu có) mà tiện ích đó phát hành. Ví dụ: hãy xem các loại sự kiện cho tiện ích Chạy thanh toán bằng Stripe.

Sau đó, hãy xem phần Điều kiện kích hoạt sự kiện tuỳ 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

Bạn có thể cài đặt cùng một tiện ích nhiều lần trong cùng một dự án. Mỗi thực thể đã cài đặt có thể có cấu hình tuỳ chỉnh riêng và tài nguyên tiện ích riêng. Bạn xác định và tham chiếu đến từng thực thể đã cài đặt bằng cách sử dụng mã nhận dạng thực thể riêng biệt trong dự án.

Bạn sẽ được nhắc xác nhận hoặc chỉnh sửa mã nhận dạng thực thể của từng thực thể bổ sung của phần mở rộng mà bạn cài đặt.

Các bước tiếp theo