將您的應用程式連接到即時資料庫模擬器

在將您的應用連接到實時數據庫模擬器之前，請確保您了解 Firebase 本地模擬器套件的整體工作流程，並安裝和配置本地模擬器套件並查看其CLI 命令。

選擇 Firebase 項目

Firebase 本地模擬器套件模擬單個 Firebase 項目的產品。

要選擇要使用的項目，請在啟動模擬器之前，在 CLI 中在工作目錄中運行firebase use 。或者，您可以將--project標誌傳遞給每個模擬器命令。

本地模擬器套件支持模擬真實的Firebase 項目和演示項目。

我們建議您盡可能使用演示項目。好處包括：

• 設置更簡單，因為您無需創建 Firebase 項目即可運行模擬器
• 更強的安全性，因為如果您的代碼意外調用非模擬（生產）資源，則不會發生數據更改、使用和計費
• 更好的離線支持，因為無需訪問互聯網即可下載 SDK 配置。

檢測您的應用程序以與模擬器對話

Android、Apple 平台和 Web SDK

設置應用內配置或測試類以與實時數據庫交互，如下所示。

// 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 無需進行任何額外設置。當實時數據庫和 Cloud Functions 模擬器同時運行時，它們會自動協同工作。

管理 SDK

設置FIREBASE_DATABASE_EMULATOR_HOST環境變量後，Firebase Admin SDK 會自動連接到實時數據庫模擬器：

export FIREBASE_DATABASE_EMULATOR_HOST="127.0.0.1:9000"

如果您的代碼在 Cloud Functions 模擬器內運行，您的項目 ID 和其他配置將在調用initalizeApp時自動設置。

如果您希望 Admin SDK 代碼連接到在另一個環境中運行的共享模擬器，則需要指定使用 Firebase CLI 設置的相同項目 ID 。您可以直接將項目ID傳遞給initializeApp或設置GCLOUD_PROJECT環境變量。

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

export GCLOUD_PROJECT="your-project-id"

在測試之間清除數據庫

要在活動之間刷新實時數據庫，您可以清除數據庫引用。您可以使用此方法作為簡單關閉模擬器進程的替代方法。

// 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命令。有關更多信息，請參閱模擬器命令參考。

可視化安全規則活動

當您完成原型和測試循環時，您可以使用本地仿真器套件提供的可視化工具和報告。

可視化規則評估

當您將安全規則添加到原型時，您可以使用本地模擬器套件工具對其進行調試。

運行一套測試後，您可以訪問測試覆蓋率報告，其中顯示每個規則的評估方式。要獲取報告，請在模擬器運行時查詢模擬器上公開的端點。對於瀏覽器友好的版本，請使用以下 URL：

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

這會將您的規則分解為表達式和子表達式，您可以將鼠標懸停在這些表達式和子表達式上以獲取更多信息，包括執行次數和返回的值。對於此數據的原始 JSON 版本，請在查詢中包含以下 URL：

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

接下來是什麼？

• 如需一組精選視頻和詳細操作示例，請關注Firebase 模擬器培訓播放列表。
• 研究涉及安全規則測試和 Firebase 測試 SDK 的高級用例：測試安全規則（實時數據庫） 。
• 由於觸發函數是與實時數據庫的典型集成，因此請在本地運行函數了解有關 Cloud Functions for Firebase 模擬器的更多信息。