Trước khi sử dụng trình mô phỏng Extensions với ứng dụng, hãy đảm bảo rằng bạn nắm rõ quy trình công việc tổng thể của Firebase Local Emulator Suite, đồng thời cài đặt và định cấu hình Local Emulator Suite cũng như xem xét các lệnh CLI của nó.
Hướng dẫn này cũng giả định rằng bạn đã quen thuộc với Firebase Extensions và cách sử dụng chúng trong ứng dụng Firebase.
Tôi có thể làm gì với trình mô phỏng Extensions?
Với trình mô phỏng Extensions, bạn có thể cài đặt và quản lý các tiện ích trong một môi trường cục bộ an toàn và hiểu rõ hơn về khả năng của các tiện ích đó, đồng thời giảm thiểu chi phí thanh toán. Trình mô phỏng chạy các hàm của tiện ích trên máy, bao gồm cả các hàm được kích hoạt bằng sự kiện trong nền bằng cách sử dụng trình mô phỏng cho Cloud Firestore, Realtime Database, Cloud Storage for Firebase, Authentication và Pub/Sub, cũng như các hàm được kích hoạt bằng Eventarc được triển khai trong Cloud Functions phiên bản 2.
Chọn một dự án Firebase
Firebase Local Emulator Suite mô phỏng các sản phẩm cho một dự án Firebase.
Để chọn dự án cần sử dụng, trước khi khởi động trình mô phỏng, trong CLI, hãy chạy firebase use
trong thư mục đang hoạt động. Hoặc bạn có thể truyền cờ --project
đến từng lệnh của trình mô phỏng.
Local Emulator Suite hỗ trợ mô phỏng các dự án Firebase thực và dự án minh hoạ.
Loại dự án | Tính năng | Sử dụng với trình mô phỏng |
---|---|---|
Thực |
Dự án Firebase thực là dự án mà bạn đã tạo và định cấu hình (rất có thể là thông qua bảng điều khiển Firebase). Các dự án thực có tài nguyên trực tiếp, chẳng hạn như các thực thể cơ sở dữ liệu, bộ chứa bộ nhớ, hàm hoặc bất kỳ tài nguyên nào khác mà bạn thiết lập cho dự án Firebase đó. |
Khi làm việc với các dự án Firebase thực, bạn có thể chạy trình mô phỏng cho bất kỳ hoặc tất cả các sản phẩm được hỗ trợ. Đối với mọi sản phẩm mà bạn không mô phỏng, ứng dụng và mã của bạn sẽ tương tác với tài nguyên trực tiếp (phiên bản cơ sở dữ liệu, bộ chứa bộ nhớ, hàm, v.v.). |
Bản trình diễn |
Dự án Firebase minh hoạ không có cấu hình Firebase thực và không có tài nguyên trực tiếp. Những dự án này thường được truy cập thông qua lớp học lập trình hoặc các hướng dẫn khác. Mã dự án của các dự án minh hoạ có tiền tố |
Khi làm việc với các dự án Firebase minh hoạ, ứng dụng và mã của bạn chỉ tương tác với trình mô phỏng. Nếu ứng dụng của bạn cố gắng tương tác với một tài nguyên mà trình mô phỏng không chạy, thì mã đó sẽ không thành công. |
Bạn nên sử dụng các dự án minh hoạ bất cứ khi nào có thể. Các lợi ích bao gồm:
- Dễ thiết lập hơn vì bạn có thể chạy trình mô phỏng mà không cần tạo dự án Firebase
- An toàn hơn vì nếu mã của bạn vô tình gọi các tài nguyên không được mô phỏng (thực tế), thì sẽ không có khả năng thay đổi dữ liệu, mức sử dụng và thông tin thanh toán
- Hỗ trợ tốt hơn khi không có mạng, vì bạn không cần truy cập Internet để tải cấu hình SDK xuống.
Cài đặt và đánh giá tiện ích
Sử dụng trình mô phỏng Extensions để đánh giá xem một tiện ích có đáp ứng nhu cầu của bạn hay không.
Giả sử bạn quan tâm đến tiện ích Email kích hoạt (firestore-send-email
), mặc dù quy trình làm việc sau đây đề cập đến mọi tiện ích. Khi chạy với trình mô phỏng cục bộ,
Email kích hoạt sẽ tự động sử dụng trình mô phỏng Cloud Firestore và
Cloud Functions.
Cách đánh giá cục bộ một phần mở rộng:
Thêm tiện ích đó vào tệp kê khai tiện ích cục bộ. Tệp kê khai tiện ích là một danh sách các thực thể tiện ích và cấu hình của các thực thể đó.
firebase ext:install --local firebase/firestore-send-email
Việc chạy lệnh trên sẽ nhắc bạn định cấu hình phiên bản mới nhất của tiện ích
firebase/firestore-send-email
và lưu cấu hình vào tệp kê khai, nhưng lệnh này sẽ không triển khai cấu hình cho dự án của bạn. Để biết thêm thông tin về vấn đề này, hãy xem phần Quản lý cấu hình tiện ích bằng tệp kê khaiKhởi động Local Emulator Suite như bình thường.
firebase emulators:start
Bây giờ, bằng cách sử dụng thực thể tiện ích firestore-send-email
được liệt kê trong tệp kê khai, Local Emulator Suite sẽ tải mã nguồn của tiện ích đó xuống ~/.cache/firebase/extensions
. Sau khi tải các nguồn xuống, Local Emulator Suite sẽ bắt đầu và bạn có thể kích hoạt bất kỳ hàm nào được kích hoạt ở chế độ nền của tiện ích và kết nối ứng dụng với Local Emulator Suite để kiểm thử việc tích hợp các hàm đó với ứng dụng.
Bạn có thể sử dụng Emulator Suite UI để thêm dữ liệu vào bộ sưu tập tài liệu email và thiết lập các tài nguyên phụ trợ khác theo yêu cầu của tiện ích Email kích hoạt.
Ngoài ra, đối với các môi trường kiểm thử không tương tác như quy trình tích hợp liên tục, bạn có thể viết một tập lệnh kiểm thử để đánh giá tiện ích, trong đó có các bước khác sẽ điền dữ liệu Cloud Firestore cần thiết và kích hoạt các hàm. Sau đó, bạn sẽ gọi Local Emulator Suite để thực thi tập lệnh kiểm thử:
firebase emulators:exec my-test.sh
Sự khác biệt giữa việc kiểm thử bằng trình mô phỏng Extensions và phát hành công khai
Trình mô phỏng Extensions cho phép bạn kiểm thử các tiện ích theo cách phù hợp với trải nghiệm phát hành chính thức. Tuy nhiên, có một số điểm khác biệt so với hành vi trong môi trường phát hành chính thức.
Cloud IAM
Bộ công cụ mô phỏng Firebase không cố gắng sao chép hoặc tuân thủ bất kỳ hành vi nào liên quan đến IAM để chạy. Trình mô phỏng tuân thủ các Quy tắc bảo mật của Firebase được cung cấp, nhưng trong những trường hợp thường sử dụng IAM, chẳng hạn như để đặt tài khoản dịch vụ gọi Hàm trên đám mây và do đó là các quyền, trình mô phỏng không thể định cấu hình và sẽ sử dụng tài khoản có sẵn trên toàn cầu trên máy của nhà phát triển, tương tự như việc chạy trực tiếp tập lệnh cục bộ.
Giới hạn về loại điều kiện kích hoạt
Hiện tại, Firebase Local Emulator Suite chỉ hỗ trợ các hàm được kích hoạt bằng yêu cầu HTTP, trình kích hoạt sự kiện tuỳ chỉnh Eventarc cho tiện ích và các hàm được kích hoạt bằng sự kiện trong nền cho Cloud Firestore, Realtime Database, Cloud Storage for Firebase, Authentication và Pub/Sub. Để đánh giá các tiện ích sử dụng các loại hàm được kích hoạt khác, bạn cần cài đặt tiện ích trong một dự án Firebase thử nghiệm.
Tiếp theo là gì?
- Để xem một bộ video được tuyển chọn và các ví dụ chi tiết về cách thực hiện, hãy tham khảo Danh sách phát hướng dẫn về Trình mô phỏng Firebase.