將應用程式連線至即時資料庫模擬器

將應用程式連線至 Realtime Database 模擬器前，請務必瞭解整體 Firebase Local Emulator Suite 工作流程，並安裝及設定 Local Emulator Suite，並查看其 CLI 指令。

選擇 Firebase 專案

Firebase Local Emulator Suite 會模擬單一 Firebase 專案的產品。

如要選取要使用的專案，請在啟動模擬器前，在工作目錄的 CLI 中執行 firebase use。或者，您也可以將 --project 標記傳遞至每個模擬器指令。

Local Emulator Suite 支援模擬「實際」Firebase 專案和示範專案。

建議您盡可能使用示範專案。Meet 具備以下優點：

• 設定更簡單，因為您可以不必建立 Firebase 專案，即可執行模擬器
• 安全性更高，因為如果程式碼不小心叫用未模擬的 (實際) 資源，就不會發生資料變更、使用和帳單問題
• 提供更完善的離線支援功能，因為您不需要連上網際網路即可下載 SDK 設定。

檢測應用程式，讓其與模擬器通訊

Android、Apple 平台和 Web SDK

請按照下列方式設定應用程式內設定或測試類別，以便與 Realtime Database 互動。

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

// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
FirebaseDatabase database = FirebaseDatabase.getInstance();
database.useEmulator("10.0.2.2", 9000);
EmulatorSuite.java

    // In almost all cases the ns (namespace) is your project ID.
let db = Database.database(url:"http://127.0.0.1:9000?ns=YOUR_DATABASE_NAMESPACE")
ViewController.swift

import { getDatabase, connectDatabaseEmulator } from "firebase/database";

const db = getDatabase();
if (location.hostname === "localhost") {
  // Point to the RTDB emulator running on localhost.
  connectDatabaseEmulator(db, "127.0.0.1", 9000);
} 
rtdb_emulator_connect.js

var db = firebase.database();
if (location.hostname === "localhost") {
  // Point to the RTDB emulator running on localhost.
  db.useEmulator("127.0.0.1", 9000);
} 
emulator-suite.js

如要測試由即時資料庫事件觸發的 Cloud Functions，不需要進行額外設定。當 Realtime Database 和 Cloud Functions 模擬器同時執行時，兩者會自動搭配運作。

Admin SDK 秒

設定 FIREBASE_DATABASE_EMULATOR_HOST 環境變數後，Firebase Admin SDK 會自動連線至 Realtime Database 模擬器：

export FIREBASE_DATABASE_EMULATOR_HOST="127.0.0.1:9000"

如果程式碼在 Cloud Functions 模擬器中執行，系統會在呼叫 initializeApp 時自動設定專案 ID 和其他設定。

如果想讓 Admin SDK 程式碼連線至在其他環境中執行的共用模擬器，您需要指定使用 Firebase CLI 設定的相同專案 ID。您可以將專案 ID 直接傳遞至 initializeApp，或是設定 GCLOUD_PROJECT 環境變數。

admin.initializeApp({ projectId: "your-project-id" });

export GCLOUD_PROJECT="your-project-id"

在測試之間清除資料庫

如要在活動之間刷新 Realtime Database，您可以清除資料庫參照。您可以使用這個方法，而非單純關閉模擬器程序。

// With a DatabaseReference, write null to clear the database.
database.reference.setValue(null)
EmulatorSuite.kt

// With a DatabaseReference, write null to clear the database.
database.getReference().setValue(null);
EmulatorSuite.java

// With a DatabaseReference, write nil to clear the database.
    Database.database().reference().setValue(nil);

import { getDatabase, ref, set } from "firebase/database";

// With a database Reference, write null to clear the database.
const db = getDatabase();
set(ref(db), null);
rtdb_emulator_flush.js

// With a database Reference, write null to clear the database.
firebase.database().ref().set(null);
emulator-suite.js

當然，您的程式碼應等待確認是否已使用平台的非同步事件處理功能完成或失敗。

完成上述步驟後，您就可以將測試排序並觸發函式，不必擔心舊資料會在執行期間清除，且使用新的基準測試設定。

匯入及匯出資料

資料庫和 Cloud Storage for Firebase 模擬器可讓您從執行中的模擬器執行個體匯出資料。定義要在單元測試或持續整合工作流程中使用的基準資料集，然後匯出並在團隊中分享。

firebase emulators:export ./dir

在測試中，在模擬器啟動時匯入基準資料。

firebase emulators:start --import=./dir

您可以指示模擬器在關機時匯出資料，方法是指定匯出路徑，或者直接使用傳遞至 --import 標記的路徑。

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

這些資料匯入和匯出選項也適用於 firebase emulators:exec 指令。詳情請參閱模擬器指令參考資料。

以視覺化方式查看安全性規則活動

在進行原型設計和測試迴圈時，您可以使用 Local Emulator Suite 提供的圖像化工具和報表。

以圖表呈現規則評估結果

在原型設計中加入安全性規則後，您可以使用 Local Emulator Suite 工具進行偵錯。

執行一系列測試後，您可以存取測試涵蓋率報表，瞭解每項規則的評估方式。如要取得報表，請在模擬器執行時查詢公開的端點。如需適用於瀏覽器的版本，請使用下列網址：

http://localhost:9000/.inspect/coverage?ns=<database_name>

這會將規則分解為運算式和子運算式，您可以將滑鼠游標懸停在運算式上，取得更多資訊，包括執行次數和傳回的值。如要取得這項資料的原始 JSON 版本，請在查詢中加入下列網址：

http://localhost:9000/.inspect/coverage.json?ns=<database_name>

後續步驟

• 如需精選影片和詳細操作說明範例，請參閱 Firebase 模擬器訓練播放清單。
• 探索涉及安全性規則測試和 Firebase Test SDK 的進階用途：測試安全性規則 (即時資料庫)。
• 由於觸發的函式是與 Realtime Database 的常見整合，因此如要進一步瞭解 Cloud Functions for Firebase 模擬器，請參閱在本機執行函式一文。