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 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.

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ố 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 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.

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

Android, nền tảng 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+KTX
// 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)

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ử các hàm trên đám mây do các sự kiện Cloud Storage for Firebase kích hoạt bằng trình mô phỏng. Khi cả trình mô phỏng Cloud Storage for FirebaseCloud Functions đều đang chạy, các trình mô phỏng này sẽ tự động hoạt động cùng 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ử tính năng tích hợp giữa trình mô phỏng Cloud FunctionsCloud Storage for Firebase. Biến môi trường sẽ tự động được đặt cho SDK quản trị 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 Firebase CLI. Bạn có thể trực tiếp truyề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 thực thể trình mô phỏng đang chạy. Xác định một tập dữ liệu cơ sở để sử dụng trong các quy trình kiểm thử đơn vị hoặc tích hợp liên tục, sau đó xuất tập dữ liệu đó để chia sẻ với nhóm.

firebase emulators:export ./dir

Trong các thử nghiệm, 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 máy, 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 tuỳ 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 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 chính thức

Để kiểm thử ứng dụng khách, trình mô phỏng Cloud Storage for Firebase sẽ điều chỉnh để phù hợp với môi trường phát hành công khai gần như hoàn hảo liên quan đến khu vực giao diện API Firebase. Theo dự kiến, tất cả các lệnh Firebase sẽ hoạt động giữa các SDK Firebase thông thường (nền tảng Web, Android và Apple).

Đối với việc kiểm thử ứng dụng phía máy chủ, có một số hạn chế. SDK Quản trị Firebase sử dụng giao diện API Google Cloud và không phải tất cả cá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, nhận và đặt siêu dữ liệu) cũng được triển khai để sử dụng từ SDK quản trị, nhưng mọi thao tác khác thì không. Dưới đây là một số trường hợp ngoại lệ đáng chú ý.

Điểm khác biệt 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 tập hợp con chức năng của Google Cloud Storage (GCS) tập trung vào các đối tượng bộ nhớ 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 bộ nhớ.
  • Từ API Đối tượng Google Cloud Storage, 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. 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 trường hợp IAM thường được sử dụng, 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ộ.

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 kênh/thông báo cho các thay đổi đối với đối tượng bộ nhớ. 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 cấp bộ chứa nào, bao gồm cả lớp bộ nhớ, cấu hình CORS cấp bộ chứa, 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ì?