Trước khi bắt đầu tạo bản minh hoạ và kiểm thử ứng dụng web bằng trình mô phỏng Firebase Hosting, hãy đảm bảo rằng bạn hiểu quy trình làm việc tổng thể của Firebase Local Emulator Suite, cài đặt và định cấu hình Local Emulator Suite cũng như xem lại các lệnh CLI của trình mô phỏng này.
Bạn cũng nên nắm được các tính năng và quy trình triển khai cho Firebase Hosting. Hãy bắt đầu với phần giới thiệu về Firebase Hosting.
Tôi có thể làm gì với trình mô phỏng Firebase Hosting?
Trình mô phỏng Firebase Hosting cung cấp tính năng mô phỏng cục bộ có độ chân thực cao của các dịch vụ Hosting, cung cấp nhiều chức năng có trong Hosting phát hành chính thức. Trình mô phỏng Hosting cho phép bạn:
- Tạo nguyên mẫu cho trang web tĩnh và ứng dụng web mà không phải trả phí lưu trữ hoặc truy cập
- Tạo nguyên mẫu, kiểm thử và gỡ lỗi các hàm HTTPS trước khi triển khai lên trang web lưu trữ
- Kiểm thử trang web và ứng dụng web trong quy trình tích hợp liên tục, được đóng gói trong vùng chứa.
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. Bạn thường truy cập vào các dự án này thông qua các lớp học lập trình hoặc các hướng dẫn khác. Mã dự án cho 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.
Quy trình tạo nguyên mẫu cốt lõi
Nếu đang thực hiện các lần lặp lại nhanh hoặc muốn ứng dụng tương tác với các tài nguyên dự án phụ trợ được mô phỏng, bạn có thể kiểm thử nội dung và cấu hình Hosting cục bộ. Khi kiểm thử cục bộ, Firebase sẽ phân phát ứng dụng web của bạn tại một URL được lưu trữ cục bộ.
(Không bắt buộc) Theo mặc định, ứng dụng được lưu trữ cục bộ sẽ tương tác với các tài nguyên dự án thực, chứ không phải được mô phỏng (hàm, cơ sở dữ liệu, quy tắc, v.v.). Thay vào đó, bạn có thể tuỳ ý kết nối ứng dụng của mình để sử dụng bất kỳ tài nguyên dự án đã mô phỏng nào mà bạn đã định cấu hình. Tìm hiểu thêm: Realtime Database | Cloud Firestore | Cloud Functions
Từ thư mục gốc của dự án cục bộ, hãy chạy lệnh sau:
firebase emulators:start
Mở ứng dụng web của bạn tại URL cục bộ do CLI trả về (thường là
http://localhost:5000).Để cập nhật URL cục bộ bằng các thay đổi, hãy làm mới trình duyệt.
Kiểm thử từ các thiết bị cục bộ khác
Theo mặc định, trình mô phỏng chỉ phản hồi các yêu cầu từ localhost. Điều này có nghĩa là bạn sẽ có thể truy cập vào nội dung được lưu trữ từ trình duyệt web của máy tính nhưng không thể truy cập từ các thiết bị khác trên mạng của bạn. Nếu bạn muốn kiểm thử từ các thiết bị cục bộ khác, hãy định cấu hình firebase.json như sau:
"emulators": {
// ...
"hosting": {
"port": 5000,
"host": "0.0.0.0"
}
}
Tạo mã thông báo xác thực cho quy trình tích hợp liên tục
Nếu quy trình tích hợp liên tục của bạn dựa vào tính năng Lưu trữ Firebase, thì bạn sẽ cần đăng nhập bằng mã thông báo để chạy firebase emulators:exec. Các trình mô phỏng khác không yêu cầu đăng nhập.
Để tạo mã thông báo, hãy chạy firebase login:ci trên môi trường cục bộ; bạn không nên thực hiện việc này từ hệ thống CI. Làm theo hướng dẫn để xác thực.
Bạn chỉ cần thực hiện bước này một lần cho mỗi dự án, vì mã thông báo sẽ có hiệu lực trên các bản dựng. Mã thông báo phải được coi như mật khẩu; hãy đảm bảo rằng mã thông báo đó được giữ bí mật.
Nếu môi trường CI cho phép bạn chỉ định các biến môi trường có thể được sử dụng trong tập lệnh bản dựng, bạn chỉ cần tạo một biến môi trường có tên là FIREBASE_TOKEN, với giá trị là chuỗi mã thông báo truy cập. CLI Firebase sẽ tự động nhận biến môi trường FIREBASE_TOKEN và trình mô phỏng sẽ khởi động đúng cách.
Nếu không còn cách nào khác, bạn chỉ cần đưa mã thông báo vào tập lệnh bản dựng, nhưng hãy đảm bảo rằng các bên không đáng tin cậy không có quyền truy cập. Đối với phương pháp mã hoá cứng này, bạn có thể thêm --token "YOUR_TOKEN_STRING_HERE" vào lệnh firebase emulators:exec.
Bước tiếp theo là gì?
- Chạy hướng dẫn nhanh bằng trình mô phỏng Hosting bằng cách làm theo lớp học lập trình web Firebase.
- Tìm hiểu cách tạo nguyên mẫu cho các hàm HTTPS bằng trình mô phỏng Hosting như mô tả trong Hướng dẫn lưu trữ cho các hàm.
- Để 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.