Bạn có thể cài đặt (và quản lý) bất kỳ trong số các tiện ích mở rộng chính thức của Firebase 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).
Hãy nhớ xem lại điểm khác biệt ở các thao tác được hỗ trợ cho bảng điều khiển Firebase CLI và Firebase.
Để 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 một tiện ích, dự án của bạn phải nằm trên Blaze (thanh toán theo hình thức của bạn đi) lên kế hoạch. Mặc dù bạn không mất phí khi cài đặt tiện ích, nhưng có thể bạn tính phí cho việc bạn sử dụng các dịch vụ của Firebase hoặc dịch vụ Cloud, chẳng hạn như Cloud Secret Manager, nếu mức sử dụng của bạn vượt quá giới hạn sử dụng của các dịch vụ miễn phí cấp.
Trước khi bắt đầu
Thêm Firebase vào dự án của bạn rồi nâng cấp nếu bạn chưa thực hiện dự án Firebase của bạn sang gói Blaze (trả tiền theo mức 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, bao gồm:
- Cách hoạt động của tiện ích mở rộng, bất kỳ tác vụ trước khi cài đặt nào 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 nhiệm vụ của tiện ích có yêu cầu phải có tài khoản thanh toán hay không
- Các dịch vụ (API) và vai trò truy cập cần thiết cho hoạt động
- Đã tạo tài nguyên cho tiện ích (như hàm)
- Nội dung mô tả về các thông 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:
Duyệt qua các tiện ích Firebase chính thức trong Extensions Hub.
Nhấp vào thẻ của một tiện ích để:
Hiển thị thông tin chi tiết về tiện ích.
Tìm đường liên kết đến mã nguồn của tiện ích trong Kho lưu trữ nguồn Firebase Extensions.
Trong tiện ích thư mục tiện ích, bạn có thể xem thông tin chi tiết này trong
README
.
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 thông số kỹ thuật cho tiện ích (chẳng hạn như API được bật, tài nguyên đã tạo, đã cấp quyền truy cập, v.v.). Bạn sẽ đượ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.
Duyệt qua các tiện ích Firebase chính thức trong Extensions Hub.
Nhấp vào thẻ của một tiện ích, sau đó xem lại thông tin chi tiết về Tiện ích bổ sung này có thể cung cấp hướng dẫn sử dụng cụ thể và các công việc trước khi cài đặt.
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.
Bước 3: Hoàn tất việc 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 để bạn hoàn tất trước khi sử dụng chúng. Tìm những hướng dẫn này trên trang chi tiết sau khi cài đặt tiện ích của bạn trong 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 hiển thị trong cửa sổ dòng lệnh sau khi cài đặt).
Bạn cũng có thể tìm thấy 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 phần mở rộng này để sử dụng các tài nguyên trên Firebase (Cloud Firestore tập hợp, đường dẫn Realtime Database, nhóm Cloud Storage) chưa tồn tại, hãy tạo chúng 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 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 xuất bản sự kiện và đã bật các sự kiện trong quá trình cài đặt, bạn có thể viết các hàm phản ứng với các sự kiện này theo logic tuỳ chỉnh của riêng bạn. Điều này có thể giúp í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 thành 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 về tiện ích để biết danh sách các sự kiện (nếu có) mà tiện ích đó xuất bản. 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 bài viết Trình kích hoạt sự kiện tùy chỉnh cho 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 phiên bản được cài đặt có thể có cấu hình tuỳ chỉnh riêng cũng như cấu hình tiện ích. 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 mã thực thể. Mã này chỉ có trong dự án của bạn. Bạn sẽ được nhắc xác nhận hoặc chỉnh sửa mã phiên bản của mỗi phiên bản bổ sung của tiện ích bạn cài đặt.
Các bước tiếp theo
Xem chi tiết và cấu hình của tiện ích đã cài đặt trong bảng điều khiển Firebase.
Giám sát hoạt động của tiện ích bạn đã cài đặt, bao gồm cả việc kiểm tra tình trạng, mức sử dụng và nhật ký của tiện ích.
Khi sử dụng bảng điều khiển Firebase, quản lý đã cài đặt tiện ích mở rộng. Đối với các tiện ích 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 của bạn, cũng như cập nhật tiện ích lên phiên bản mới nhất .
Phương pháp hay nhất cho tất cả dự án là nhớ thiết lập thông báo về ngân sách cho dự án của mình và theo dõi Việc sử dụng và thanh toán trang tổng quan trong bảng điều khiển Firebase.