Bạn có thể cài đặt (và quản lý) bất kỳ tiện ích Firebase chính thức bằng cách sử dụng bảng điều khiển của Firebase hoặc CLI Firebase (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 nếu bạn chưa thêm.
Nâng cấp dự án của bạn lên Blaze nếu bạn chưa thực hiện (thanh toán theo hình thức của bạn) đi) lên kế hoạch.
Cài đặt hoặc cập nhật lên phiên bản mới nhất của Giao diện dòng lệnh (CLI) của Firebase.
Ghi lại mã dự án Firebase hoặc mã dự án đã định cấu hình trước đó bí danh dự án.
- Mã dự án – Chạy
firebase projects:listtừ bất cứ đâu trên máy tính của bạn. - Bí danh dự án – Chạy
firebase usetrong thư mục ứng dụng cục bộ của bạn.
- Mã dự án – Chạy
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 Tiện ích Firebase, 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:
Hãy đảm bảo rằng bạn thiết lập môi trường và đã chọn một phần mở rộng.
Chạy lệnh mở rộng thông tin từ bất cứ đâu trên máy tính của bạn:
firebase ext:info publisher-id/extension-id
publisher-idvàextension-idđối số là bắt buộc và có thể được tìm thấy trên trang chi tiết cài đặt trước của 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 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.
Hãy đảm bảo rằng bạn thiết lập môi trường và đã chọn một phần mở rộng.
Trong thư mục Firebase cục bộ, hãy chạy lệnh cài đặt tiện ích. Nếu được nhắc, hãy nhập các giá trị thông số để tuỳ chỉnh bản sao của tiện ích.
firebase ext:install publisher-id/extension-id --project=projectId-or-alias
publisher-idvàextension-idđối số là bắt buộc và có thể được tìm thấy trên trang chi tiết cài đặt trước của tiện ích.Việc chạy lệnh này sẽ thêm một phiên bản tiện ích vào tệp kê khai của tiện ích.
Sau đó, để triển khai các tiện ích trong tệp kê khai lên Firebase dự án, chạy:
firebase deploy --only extensions --project=projectId-or-alias
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 Tiện ích trong bảng điều khiển của 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 tiện ích để sử dụng các tài nguyên của Firebase (Cloud Firestore tập hợp, đường dẫn Cơ sở dữ liệu theo thời gian thực, bộ chứa trong 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 của 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 dùng Firebase CLI, quản lý đã cài đặt tiện ích mở rộng. Bạn cũng có thể định cấu hình lại hoặc gỡ cài đặt tiện ích của mình khi cập nhật tiện ích lên phiên bản mới nhất.
Bằng cách sử dụng bảng điều khiển của 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 của Firebase.