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 rõ quy trình làm 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 lại 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.

Để chọn dự án cần sử dụng, trước khi khởi động trình mô phỏng, hãy chạy firebase use trong thư mục đang hoạt động của bạn trong CLI. Hoặc bạn có thể truyền cờ --project cho 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 tế và dự án minh hoạ.

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 (thường là thông qua bảng điều khiển Firebase).

Dự án thực tế có các tài nguyên đang hoạt động, chẳng hạn như các phiên bản cơ sở dữ liệu, bộ chứa 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 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 thực tế (thực thể 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 thực tế. Các 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ố 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 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 dự án minh hoạ bất cứ khi nào có thể. Các lợi ích bao gồm:

  • Thiết lập dễ dàng 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 (môi trường thực tế), thì sẽ không có khả năng thay đổi dữ liệu, mức sử dụng và thanh toán
  • Hỗ trợ ngoại tuyến tốt hơn vì không cần truy cập 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, nền tảng của Apple và SDK 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)
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);
Swift
Storage.storage().useEmulator(withHost: "127.0.0.1", port: 9199)
Unity
FirebaseStorage storage = FirebaseStorage.DefaultInstance;
// Connects to the Storage Emulator running on port 9199
storage.UseEmulator("127.0.0.1", 9199);

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);
}

Web

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

Bạn không cần thiết lập thêm để kiểm thử Cloud Functions được kích hoạt bằng 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 hoạt động cùng nhau.

Admin SDK giây

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

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, nên 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ẽ được tự động đặt cho SDK dành cho quản trị viên 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 cần chỉ định cùng một mã dự án mà bạn đã đặt bằng Giao diện dòng lệnh (CLI) của Firebase. Bạn có thể trực tiếp chuyển 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 chương trình 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 tài liệu tham khảo về lệnh của trình mô phỏng.

Sự khác biệt giữa trình mô phỏng Cloud Storage for Firebase và môi trường thực tế

Để thử nghiệm ứ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 môi trường thực tế về mặt diện tích bề mặt API Firebase. Tất cả các lệnh Firebase đều hoạt động giữa các SDK Firebase thông thường (Web, Android và nền tảng Apple).

Có một số hạn chế đối với việc thử nghiệm ứng dụng phía máy chủ. SDK của Firebase dành cho quản trị viên sử dụng nền tảng API Google Cloud và không phải tất cả đ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 ứng dụng (tải lên hoặc xoá tệp, lấy 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 thì không. Các trường hợp loại trừ đáng chú ý được liệt kê bên dưới.

Điểm 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 số 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 ứ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ợ các API Bucket để tạo, liệt kê, lấy hoặc xoá bộ chứa lưu trữ.
  • Trong 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 theo 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 Cloud Functions và do đó là các quyền, thì trình mô phỏng không thể 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 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 Cloud Pub/Sub, do đó không hỗ trợ tạo 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 trình kích hoạt Bộ nhớ Cloud Functions.

Siêu dữ liệu cấp bộ chứa

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

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