Kết nối ứng dụng của bạn với Trình mô phỏng Cloud Storage cho Firebase

Trước khi kết nối ứng dụng với trình mô phỏng Cloud Storage for Firebase, hãy đảm bảo rằng bạn hiểu quy trình 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 trình mô phỏng này.

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 duy nhất.

Để chọn dự án cần dùng, trước khi bạn khởi động trình mô phỏng, hãy chạy firebase use trong thư mục làm việc của bạn trong CLI. Hoặc bạn có thể truyền cờ --project đến từng lệnh trình mô phỏng.

Local Emulator Suite hỗ trợ hoạt động mô phỏng các dự án Firebase thực và dự án demo.

Loại dự án Tính năng Sử dụng với trình mô phỏng
Real

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 phiên bản cơ sở dữ liệu, vùng lưu trữ, 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 lưu trữ, 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. Người dùng thường truy cập vào các dự án này thông qua lớp học mã hoặc các hướng dẫn khác.

Mã dự án cho các dự án minh hoạ có tiền tố demo-.

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 các 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 hoạt độ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ễ dàng 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 (sản xuất), thì không có khả năng xảy ra thay đổi dữ liệu, mức sử dụng và việc 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 vào Internet để tải cấu hình SDK xuống.

Đo lường ứng dụng để giao tiếp với trình mô phỏng

Android, các nền tảng của Apple và SDK trên web

Thiết lập cấu hình trong ứng dụng hoặc các lớp kiểm thử để tương tác với trình mô phỏng Cloud Storage for Firebase như sau.

Kotlin
// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
val storage = Firebase.storage
storage.useEmulator("10.0.2.2", 9199)
EmulatorSuite.kt
Java
// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
FirebaseStorage storage = FirebaseStorage.getInstance();
storage.useEmulator("10.0.2.2", 9199);
EmulatorSuite.java
Swift
Storage.storage().useEmulator(withHost: "127.0.0.1", port: 9199)
ViewController.swift

Web

const { getStorage, connectStorageEmulator } = require("firebase/storage");

const storage = getStorage();
if (location.hostname === "localhost") {
  // Point to the Storage emulator running on localhost.
  connectStorageEmulator(storage, "127.0.0.1", 9199);
} 
emulator-suite.js

Web

var storage = firebase.storage();
if (location.hostname === "localhost") {
  // Point to the Storage emulator running on localhost.
  storage.useEmulator("127.0.0.1", 9199);
} 
emulator-suite.js

Bạn không cần thiết lập thêm để kiểm thử các hàm trên đám mây được kích hoạt bởi các sự kiện Cloud Storage for Firebase bằng trình mô phỏng. Khi cả trình mô phỏng Cloud Storage for Firebase và Cloud Functions đều đang chạy, chúng sẽ tự động phối hợp với nhau.

Admin SDK giây

Firebase Admin SDK sẽ tự động kết nối với trình mô phỏng Cloud Storage for Firebase khi bạn đặt biến môi trường FIREBASE_STORAGE_EMULATOR_HOST:

export FIREBASE_STORAGE_EMULATOR_HOST="127.0.0.1:9199"

Xin lưu ý rằng trình mô phỏng Cloud Functions sẽ tự động nhận biết trình mô phỏng Cloud Storage for Firebase, vì vậy, bạn có thể bỏ qua bước này khi kiểm thử các hoạt động tích hợp giữa trình mô phỏng Cloud Functions và Cloud Storage for Firebase. Biến môi trường sẽ tự động được thiết lập cho Admin SDK trong Cloud Storage for Firebase.

Nếu muốn mã Admin SDK kết nối với một trình mô phỏng dùng chung đang chạy trong một môi trường khác, bạn sẽ cần chỉ định cùng một mã dự án mà bạn đã đặt bằng Firebase CLI. Bạn có thể truyền trực tiếp mã dự án đến initializeApp hoặc đặt biến môi trường GCLOUD_PROJECT.

SDK dành cho quản trị viên Node.js
admin.initializeApp({ projectId: "your-project-id" });
Biến môi trường
export GCLOUD_PROJECT="your-project-id"

Nhập và xuất dữ liệu

Trình mô phỏng cơ sở dữ liệu và Cloud Storage for Firebase cho phép bạn xuất dữ liệu từ một phiên bản trình mô phỏng đang chạy. Xác định một tập hợp dữ liệu cơ sở để sử dụng trong các quy trình kiểm thử đơn vị hoặc quy trình tích hợp liên tục, sau đó xuất tập hợp dữ liệu đó để chia sẻ với nhóm.

firebase emulators:export ./dir

Trong các kiểm thử, khi khởi động trình mô phỏng, hãy nhập dữ liệu cơ sở.

firebase emulators:start --import=./dir

Bạn có thể hướng dẫn trình mô phỏng xuất dữ liệu khi tắt, bằng cách chỉ định đường dẫn xuất hoặc chỉ cần sử dụng đường dẫn được truyền đến cờ --import.

firebase emulators:start --import=./dir --export-on-exit

Các lựa chọn nhập và xuất dữ liệu này cũng hoạt động với lệnh firebase emulators:exec. Để biết thêm thông tin, hãy tham khảo thông tin tham khảo về lệnh trong trình mô phỏng.

Sự khác biệt giữa trình mô phỏng Cloud Storage for Firebase và bản phát hành công khai

Để kiểm thử các ứng dụng khách, trình mô phỏng Cloud Storage for Firebase gần như hoàn toàn phù hợp với quy trình sản xuất về diện tích API Firebase. Tất cả các lệnh Firebase đều được kỳ vọng hoạt động giữa các Firebase SDK thông thường (Web, Android và các nền tảng của Apple).

Đối với việc kiểm thử các ứng dụng phía máy chủ, có một số hạn chế. Firebase Admin SDK sử dụng giao diện API Google Cloud và không phải mọi điểm cuối của API này đều được mô phỏng. Theo nguyên tắc chung, mọi thao tác có thể thực hiện từ SDK phía máy khách (tải lên hoặc xoá tệp, nhận và đặt siêu dữ liệu) cũng được triển khai để sử dụng từ SDK dành cho quản trị viên, nhưng mọi thao tác khác đều không được triển khai. Những trường hợp loại trừ đáng chú ý được liệt kê bên dưới.

Khác biệt so với Google Cloud Storage

Sản phẩm Cloud Storage for Firebase (bao gồm cả Trình mô phỏng bộ nhớ) cung cấp một phần chức năng của Google Cloud Storage (GCS) tập trung vào các đối tượng lưu trữ, rất hữu ích cho việc phát triển các ứng dụng Firebase. Cloud Storage for Firebase khác với GCS ở những điểm sau:

  • Cloud Storage for Firebase hiện không hỗ trợ API Bucket để tạo, liệt kê, nhận hoặc xoá các vùng lưu trữ.
  • Từ Google Cloud Storage Objects API, các phương thức sau được hỗ trợ: copy, delete, get, insert, list, patch, rewrite, update.

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. Các trình mô phỏng tuân thủ 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 dùng IAM, chẳng hạn như để đặt tài khoản dịch vụ gọi Cloud Functions 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 một tập lệnh cục bộ.

Thông báo Pub/Sub

Trình mô phỏng Cloud Storage for Firebase không tích hợp với trình mô phỏng Pub/Sub trên đám mây, do đó, không hỗ trợ việc tạo các kênh/thông báo cho các thay đổi về đối tượng lưu trữ. Bạn nên sử dụng trực tiếp các trình kích hoạt Cloud Functions Bộ nhớ.

Siêu dữ liệu ở cấp nhóm

Trình mô phỏng Cloud Storage for Firebase không hỗ trợ bất kỳ cấu hình nào ở cấp nhóm, bao gồm cả lớp lưu trữ, cấu hình CORS ở cấp nhóm, nhãn hoặc chính sách giữ lại. Firebase dự định cải thiện dịch vụ hỗ trợ này theo thời gian.

Bước tiếp theo là gì?