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


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 bạn 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ử

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 nguyên mẫu và kiểm thử bằng các trình mô phỏng riêng lẻ cũng như tổ hợp các trình mô phỏng, tuỳ theo ý bạn, tương ứng với sản phẩm Firebase mà bạn đang sử dụng trong quá trình phát hành chính thức.

Tương tác giữa cơ sở dữ liệu Firebase và trình mô phỏng hàm
Trình mô phỏng cơ sở dữ liệu và 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 công việc Local Emulator Suite, giả sử bạn đang xử lý một ứng dụng sử dụng tổ hợp sản phẩm thông thường: cơ sở dữ liệu Firebase và các hàm trên đá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 khởi 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ính năng nguyên mẫu tương tác với 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 một lần để kết nối ứng dụng với trình mô phỏng.

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

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

Hãy nhớ cài đặt CLI hoặc cập nhật lên phiên bản mới nhất.

curl -sL firebase.tools | bash

Nếu bạn chưa thực hiện việc này, hãy khởi chạy thư mục đang hoạt động dưới dạng 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 FunctionsCloud 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, tệp định nghĩa Firebase Security Rules cho cơ sở dữ liệu, 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 nguyên mẫu theo cách tương tác

Local Emulator Suite được thiết kế để cho phép bạn nhanh chóng tạo nguyên 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 nguyên mẫu hữu ích nhất. Điều này giống như khi bảng điều khiển Firebase chạy cục bộ.

Khi sử dụng Emulator Suite UI, bạn có thể lặp lại thiết kế của một cơ sở dữ liệu, thử các luồng dữ liệu khác nhau liên quan đến các hàm đám mây, đánh giá các thay đổi trong 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à nhiều việc khác. 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 lại bằng một ý tưởng thiết kế mới.

Tất cả đều có sẵn khi bạn khởi động Local Emulator Suite bằng:

firebase emulators:start

Để tạo nguyên 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 cơ sở dữ liệu đó.

  1. Tạo một hàm đám mây được kích hoạt do cơ sở dữ liệu ghi 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 tại 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 của tài liệu thành chữ hoa rồi lưu trữ kết quả trong trường uppercase của tài liệu đó.
  2.   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});
          });
      
  3. Chạy Local Emulator Suite bằng firebase emulators:start. Trình mô phỏng Cloud Functions và cơ sở dữ liệu khởi động, tự động được định cấu hình để tương tác.
  4. Xem giao diện người dùng trên trình duyệt của bạn 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 cuối do CLI Firebase xuất ra. Hãy lưu ý trạng thái của các trình mô phỏng hiện có. Trong trường hợp này, trình mô phỏng Cloud FunctionsCloud Firestore sẽ chạy.
    Hình ảnh của tôi
  5. Trong giao diện người dùng, trên thẻ Firestore > Data (Firestore > 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 tập hợp messages, với trường tên original và giá trị test. Thao tác này sẽ kích hoạt hàm trên đám mây. Hãy quan sát một trường uppercase mới sẽ xuất hiện trong giây lát, được điền sẵn chuỗi "TEST".
    Ảnh của tôi Ảnh của tôi
  6. Trên thẻ 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 được mô phỏng, bao gồm cả tất cả các 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 đó.
  7. Kiểm tra thẻ Logs (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 trên đá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 có đượ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 các bộ kiểm thử.

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

Khi đã tiến triển tốt với việc tạo nguyên mẫu tương tác và đã chuẩn bị xong một thiết kế, bạn có thể thêm mã truy cập cơ sở dữ liệu vào ứng dụng của mình bằng SDK phù 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 hoạt động ghi vào cơ sở dữ liệu chính thức sẽ không kích hoạt các hàm mà bạn đang tạo bản minh hoạ cục bộ.

Để chuyển sang yêu cầu ứng dụng ghi vào cơ sở dữ liệu, bạn cần 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.

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 firestore = Firebase.firestore
firestore.useEmulator("10.0.2.2", 8080)

firestore.firestoreSettings = firestoreSettings {
    isPersistenceEnabled = false
}
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);
Swift
let settings = Firestore.firestore().settings
settings.host = "127.0.0.1:8080"
settings.cacheSettings = MemoryCacheSettings()
settings.isSSLEnabled = false
Firestore.firestore().settings = settings

Web

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

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

Web

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

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

Bây giờ, hãy xem bước cuối cùng trong quy trình làm việc tổng thể. Sau khi tạo nguyên mẫu tính năng trong ứng dụng và tính năng đó có vẻ hứa hẹn trên tất cả các nền tảng, bạn có thể chuyển sang triển khai và kiểm thử lần cuối. Đối với quy trình kiểm thử đơn vị và quy trình công việc CI, bạn có thể khởi động trình mô phỏng, chạy kiểm thử theo tập lệnh 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 đã nắm được quy trình làm việc 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 đó để phát triển ứng dụng phía máy chủ:

Tiếp theo là gì?

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