Kết nối ứng dụng của bạn và bắt đầu tạo nguyên mẫu

Cloud Firestore Cơ sở dữ liệu theo thời gian thực

Trước khi bắt đầu với Firebase Local Emulator Suite, hãy đảm bảo bạn đã tạo một dự án Firebase, thiết lập môi trường phát triển, đồng thời chọn và cài đặt SDK Firebase cho nền tảng của mình theo các chủ đề Bắt đầu sử dụng Firebase cho nền tảng của bạn: Apple, Android hoặc Web.

Tạo nguyên mẫu và kiểm thử

Lưu ý: Trước khi khám phá Bộ công cụ mô phỏng cục bộ của Firebase, bạn nên tìm hiểu về các sản phẩm của Firebase và mô hình phát triển của Firebase. Sau khi đọc phần Bắt đầu cho nền tảng của bạn, hãy tải một ứng dụng khởi động nhanh sẵn sàng chạy xuống nền tảng bạn chọn, sau đó đọc và thực thi mã. Ứng dụng bắt đầu nhanh FriendlyEats là một lựa chọn phù hợp (iOS, Android hoặc Web).

Local Emulator Suite chứa một số trình mô phỏng sản phẩm, như mô tả trong phần Giới thiệu về Firebase Local Emulator Suite. Bạn có thể tạo mẫu và thử nghiệm với từng trình mô phỏng cũng như tổ hợp trình mô phỏng, tuỳ theo ý muốn, tương ứng với những sản phẩm Firebase mà bạn đang sử dụng trong quá trình phát hành công khai.

Cơ sở dữ liệu và trình mô phỏng Cloud Functions là một phần của Local Emulator Suite đầy đủ.

Đối với chủ đề này, để giới thiệu quy trình Local Emulator Suite, giả sử bạn đang làm việc trên một ứng dụng sử dụng sự kết hợp điển hình của các sản phẩm: cơ sở dữ liệu Firebase và các hàm đám mây được kích hoạt bởi các thao tác trên cơ sở dữ liệu đó.

Sau khi bạn chạy dự án Firebase cục bộ, chu kỳ phát triển bằng Local Emulator Suite thường sẽ có 3 bước:

1. Tạo mẫu các tính năng một cách tương tác bằng trình mô phỏng và Emulator Suite UI.

2. Nếu bạn đang sử dụng trình mô phỏng cơ sở dữ liệu hoặc trình mô phỏng Cloud Functions, hãy thực hiện một bước duy nhất để kết nối ứng dụng của bạn với các trình mô phỏng.

3. Tự động hoá các kiểm thử bằng trình mô phỏng và tập lệnh tuỳ chỉnh.

Khởi chạy dự án Firebase cục bộ

Đảm bảo bạn cài đặt CLI hoặc cập nhật lên phiên bản mới nhất của CLI.

curl -sL firebase.tools | bash

Nếu bạn chưa làm việc này, hãy khởi động thư mục làm việc hiện tại dưới dạng một dự án Firebase, làm theo lời nhắc trên màn hình để chỉ định rằng bạn đang sử dụng Cloud Functions và Cloud Firestore hoặc Realtime Database:

firebase init

Thư mục dự án của bạn hiện sẽ chứa các tệp cấu hình Firebase, một tệp định nghĩa Firebase Security Rules cho cơ sở dữ liệu, một thư mục functions chứa mã hàm trên đám mây và các tệp hỗ trợ khác.

Tạo mẫu theo cách tương tác

Local Emulator Suite được thiết kế để giúp bạn nhanh chóng tạo mẫu cho các tính năng mới và giao diện người dùng tích hợp của Suite là một trong những công cụ tạo mẫu hữu ích nhất. Việc này giống như bạn đang chạy bảng điều khiển Firebase cục bộ.

Khi dùng Emulator Suite UI, bạn có thể lặp lại quá trình thiết kế cơ sở dữ liệu, thử các luồng dữ liệu liên quan đến hàm trên đám mây, đánh giá các thay đổi về Quy tắc bảo mật, kiểm tra nhật ký để xác nhận hiệu suất của các dịch vụ phụ trợ, v.v. Sau đó, nếu bạn muốn bắt đầu lại, chỉ cần xoá cơ sở dữ liệu và bắt đầu từ đầu với một ý tưởng thiết kế mới.

Bạn có thể truy cập vào tất cả các tính năng này khi khởi động Local Emulator Suite bằng cách:

firebase emulators:start

Để tạo mẫu cho ứng dụng giả định của chúng ta, hãy thiết lập và kiểm thử một hàm đám mây cơ bản để sửa đổi các mục nhập văn bản trong cơ sở dữ liệu, đồng thời tạo và điền sẵn cơ sở dữ liệu đó trong Emulator Suite UI để kích hoạt hàm.

1. Tạo một hàm đám mây được kích hoạt bằng cách ghi vào cơ sở dữ liệu bằng cách chỉnh sửa tệp functions/index.js trong thư mục dự án. Thay thế nội dung của tệp hiện có bằng đoạn mã sau. Hàm này theo dõi các thay đổi đối với tài liệu trong tập hợp messages, chuyển đổi nội dung của trường original trong tài liệu thành chữ hoa và lưu trữ kết quả trong trường uppercase của tài liệu đó.

  const functions = require('firebase-functions/v1');

  exports.makeUppercase = functions.firestore.document('/messages/{documentId}')
      .onCreate((snap, context) => {
        const original = snap.data().original;
        console.log('Uppercasing', context.params.documentId, original);
        const uppercase = original.toUpperCase();
        return snap.ref.set({uppercase}, {merge: true});
      });
  

2. Chạy Local Emulator Suite bằng firebase emulators:start. Trình mô phỏng Cloud Functions và cơ sở dữ liệu sẽ khởi động, tự động định cấu hình để tương tác.
3. Xem giao diện người dùng trong trình duyệt tại http://localhost:4000. Cổng 4000 là cổng mặc định cho giao diện người dùng, nhưng hãy kiểm tra thông báo đầu ra của thiết bị đầu cuối do Firebase CLI tạo. Lưu ý trạng thái của các trình mô phỏng có sẵn. Trong trường hợp này, các trình mô phỏng Cloud Functions và Cloud Firestore sẽ chạy.
   Trang chính của giao diện người dùng dựa trên thành phần hiển thị
4. Trong giao diện người dùng, trên thẻ Firestore > Data (Dữ liệu), hãy nhấp vào Start collection (Bắt đầu thu thập) rồi làm theo lời nhắc để tạo một tài liệu mới trong một bộ sưu tập messages, với tên trường là original và giá trị là test. Thao tác này sẽ kích hoạt hàm đám mây của chúng ta. Lưu ý rằng một trường uppercase mới sẽ xuất hiện trong thời gian ngắn, được điền sẵn chuỗi "TEST".
   Xem cách tạo bộ sưu tập Xem thông tin cập nhật từ hàm
5. Trên thẻ Firestore > Requests (Firestore > Yêu cầu), hãy kiểm tra các yêu cầu được gửi đến cơ sở dữ liệu mô phỏng của bạn, bao gồm cả mọi hoạt động đánh giá Firebase Security Rules được thực hiện trong quá trình thực hiện các yêu cầu đó.
6. Kiểm tra thẻ Nhật ký để xác nhận rằng hàm của bạn không gặp lỗi khi cập nhật cơ sở dữ liệu.

Bạn có thể dễ dàng lặp lại giữa mã hàm đám mây và các nội dung chỉnh sửa cơ sở dữ liệu tương tác cho đến khi nhận được luồng dữ liệu mà bạn đang tìm kiếm, mà không cần chạm vào mã truy cập cơ sở dữ liệu trong ứng dụng, biên dịch lại và chạy lại bộ kiểm thử.

Kết nối ứng dụng với trình mô phỏng

Khi đã có nhiều tiến triển trong việc tạo nguyên mẫu tương tác và đã quyết định được một mẫu thiết kế, bạn sẽ sẵn sàng thêm mã truy cập cơ sở dữ liệu vào ứng dụng bằng SDK thích hợp. Bạn sẽ tiếp tục sử dụng thẻ cơ sở dữ liệu và đối với các hàm, thẻ Nhật ký trong Emulator Suite UI để xác nhận rằng hành vi của ứng dụng là chính xác.

Hãy nhớ rằng Local Emulator Suite là một công cụ phát triển cục bộ. Các thao tác ghi vào cơ sở dữ liệu sản xuất sẽ không kích hoạt các hàm mà bạn đang tạo mẫu cục bộ.

Để chuyển sang chế độ cho phép ứng dụng ghi vào cơ sở dữ liệu, bạn cần phải trỏ các lớp kiểm thử hoặc cấu hình trong ứng dụng đến trình mô phỏng Cloud Firestore.

Lưu ý: Trình mô phỏng Cloud Firestore sẽ xoá nội dung cơ sở dữ liệu khi tắt. Vì bộ nhớ đệm ngoại tuyến của Firestore SDK không tự động bị xoá, nên bạn có thể muốn tắt tính năng duy trì cục bộ trong cấu hình trình mô phỏng để tránh sự khác biệt giữa cơ sở dữ liệu được mô phỏng và bộ nhớ đệm cục bộ; trong Web SDK, tính năng duy trì bị tắt theo mặc định.

Kotlin

// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
val firestore = Firebase.firestore
firestore.useEmulator("10.0.2.2", 8080)

firestore.firestoreSettings = firestoreSettings {
    isPersistenceEnabled = false
}
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.
FirebaseFirestore firestore = FirebaseFirestore.getInstance();
firestore.useEmulator("10.0.2.2", 8080);

FirebaseFirestoreSettings settings = new FirebaseFirestoreSettings.Builder()
        .setPersistenceEnabled(false)
        .build();
firestore.setFirestoreSettings(settings);
EmulatorSuite.java

Swift

let settings = Firestore.firestore().settings
settings.host = "127.0.0.1:8080"
settings.cacheSettings = MemoryCacheSettings()
settings.isSSLEnabled = false
Firestore.firestore().settings = settings
ViewController.swift

Web

import { getFirestore, connectFirestoreEmulator } from "firebase/firestore";

// firebaseApps previously initialized using initializeApp()
const db = getFirestore();
connectFirestoreEmulator(db, '127.0.0.1', 8080);
fs_emulator_connect.js

Web

Tìm hiểu thêm về Web API theo mô-đun có thể loại bỏ các thành phần không dùng đến và lợi thế của API này so với API theo không gian tên.

// Firebase previously initialized using firebase.initializeApp().
var db = firebase.firestore();
if (location.hostname === "localhost") {
  db.useEmulator("127.0.0.1", 8080);
}
emulator-suite.js

Tự động hoá các kiểm thử bằng tập lệnh tuỳ chỉnh

Bây giờ là bước cuối cùng trong quy trình làm việc tổng thể. Sau khi tạo mẫu cho tính năng trong ứng dụng và thấy tính năng này có triển vọng trên tất cả các nền tảng, bạn có thể chuyển sang giai đoạn triển khai và kiểm thử cuối cùng. Đối với quy trình kiểm thử đơn vị và CI, bạn có thể khởi động trình mô phỏng, chạy các kiểm thử theo kịch bản và tắt trình mô phỏng trong một lệnh gọi duy nhất bằng lệnh exec:

firebase emulators:exec "./testdir/test.sh"

Tìm hiểu kỹ hơn về từng trình mô phỏng

Giờ đây, khi đã xem quy trình cơ bản phía máy khách, bạn có thể tiếp tục tìm hiểu thông tin chi tiết về từng trình mô phỏng trong Bộ công cụ, bao gồm cả cách sử dụng các trình mô phỏng này để phát triển ứng dụng phía máy chủ:

• Thêm trình mô phỏng Authentication vào quy trình tạo mẫu
• Tìm hiểu kỹ về các tính năng của trình mô phỏng Realtime Database
• Tìm hiểu kỹ về các tính năng của trình mô phỏng Cloud Storage for Firebase
• Tìm hiểu kỹ về các tính năng của trình mô phỏng Cloud Firestore
• Kết nối ứng dụng của bạn với trình mô phỏng Cloud Functions
• Đánh giá Firebase Extensions trong khi giảm thiểu chi phí thanh toán bằng trình mô phỏng Extensions

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

Hãy nhớ đọc các chủ đề liên quan đến những trình mô phỏng cụ thể được liên kết ở trên. Sau đó:

• Để xem tuyển tập video và ví dụ hướng dẫn chi tiết, hãy theo dõi Danh sách phát về hoạt động đào tạo về Trình mô phỏng Firebase.
• Tìm hiểu các trường hợp sử dụng nâng cao liên quan đến việc kiểm thử Quy tắc bảo mật và Firebase Test SDK: Kiểm thử Quy tắc bảo mật (Cloud Firestore), Kiểm thử Quy tắc bảo mật (Realtime Database) và Kiểm thử Quy tắc bảo mật (Cloud Storage for Firebase).