Bạn có thể cài đặt (và quản lý) bất kỳ tiện ích Firebase chính thức nào bằng cách sử dụng bảng điều khiển Firebase, CLI Firebase (giao diện dòng lệnh) hoặc bằng cách sử dụng một SDK được tạo tự động.
Hãy nhớ xem xét sự khác biệt về các thao tác được hỗ trợ cho từng phương thức cài đặt.
Để cài đặt hoặc quản lý các 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 sử dụng gói Blaze (trả tiền theo mức dùng). Mặc dù không mất phí khi cài đặt tiện ích, nhưng bạn có thể bị tính phí khi sử dụng các dịch vụ của Firebase hoặc Cloud, chẳng hạn như Cloud Secret Manager, nếu mức sử dụng của bạn vượt quá bậc 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 của bạn lên gói Blaze (trả tiền khi sử dụng).
Bước 1: Xem thông tin chi tiết về một tiện ích
Bước này không bắt buộc nhưng bạn nên thực hiện.
Trước khi cài đặt một Firebase Extension, bạn nên xem thông tin chi tiết về tiện ích, bao gồm:
- Cách hoạt động của tiện ích, mọi việc cần làm trước khi cài đặt 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ụ (API) của Google 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 (chẳng hạn như các hàm)
- Nội dung mô tả về các thông số do người dùng định cấu hình
Cách xem thông tin chi tiết của một tiện ích:
Duyệt xem các tiện ích chính thức của Firebase 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 thư mục tiện ích của tiện ích, bạn có thể xem thông tin chi tiết này trong
README.
Bước 2: Cài đặt một tiện ích
Trong quá trình cài đặt, bạn sẽ được nhắc xem xét các thông số kỹ thuật cơ bản cho tiện ích (chẳng hạn như 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 đối với thông tin thanh toán, đồng thời bạn cũng sẽ được nhắc chỉ định các giá trị cho các thông số có thể định cấu hình của tiện ích.
Duyệt xem các tiện ích chính thức của Firebase trong Extensions Hub.
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 cụ thể về cách sử dụng và mọi việc cần làm 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 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 cần hoàn tất trước khi sử dụng. Bạn có thể xem các hướng dẫn này trên trang thông tin chi tiết sau khi cài đặt của tiện ích 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 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 tài nguyên Firebase
Nếu bạn định cấu hình tiện ích để sử dụng các tài nguyên Firebase (Cloud Firestoretập hợp, Realtime Databaseđường dẫn, Cloud Storagethùng) chưa 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 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 các sự kiện và bạn đã bật các 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 những sự kiện này bằng logic tuỳ chỉnh của riêng mình. Ví dụ: điều này có thể hữu ích khi bạn muốn 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 tiện ích.
Hãy xem tài liệu của 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 Đ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 phiên bản đã 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 phiên bản đã cài đặt bằng mã nhận dạng phiên bản (mã 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 mã nhận dạng 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.
Các bước tiếp theo
Xem thông tin chi tiết và cấu hình của tiện ích đã cài đặt trong bảng điều khiển Firebase.
Theo dõi hoạt động của tiện ích đã 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.
Sử dụng bảng điều khiển Firebase để quản lý tiện ích đã cài đặt. Đối với các tiện ích chính thức của Firebase, bạn có thể định cấu hình lại hoặc gỡ cài đặt tiện ích, cũng như cập nhật tiện ích lên phiên bản mới nhất.
Để đảm bảo tất cả các dự án đều hoạt động hiệu quả, hãy nhớ thiết lập cảnh báo ngân sách cho dự án của bạn và theo dõi mức sử dụng và thông tin thanh toán trên bảng điều khiển trong bảng điều khiển Firebase.