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

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

選擇 Firebase 專案

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

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

注意： 一般而言，建議您為所有模擬器叫用使用一個專案 ID，這樣 Emulator Suite UI、不同產品模擬器，以及特定模擬器的所有執行中例項，都能在所有情況下正確通訊。事實上，根據預設，Local Emulator Suite 會在偵測到有多個專案 ID 正在使用時發出警告，但您可以覆寫這項行為。如需設定及管理專案 ID 的指引，請參閱安裝和設定指南。

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

專案類型	功能	搭配模擬器使用
真實	真正的 Firebase 專案是您建立及設定的專案 (最有可能是透過 Firebase 控制台)。 實際專案會有即時資源，例如資料庫執行個體、儲存空間桶、函式，或您為該 Firebase 專案設定的任何其他資源。	使用實際的 Firebase 專案時，您可以為任何或所有支援的產品執行模擬器。 對於您未模擬的任何產品，應用程式和程式碼會與實際資源 (資料庫執行個體、儲存空間 bucket、函式等) 互動。
示範	示範 Firebase 專案沒有實際的 Firebase 設定，也沒有實際資源。這些專案通常是透過程式碼研究室或其他教學課程存取。 示範專案的專案 ID 會加上 demo- 前置字串。	使用 Firebase 示範專案時，應用程式和程式碼只會與模擬器互動。如果應用程式嘗試與模擬器未執行的資源互動，該程式碼就會失敗。

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

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

注意： 如果您想模擬跨服務互動，例如資料庫觸發的 Cloud Functions 或依賴 Authentication 的 Rules，請務必確認程式碼 (initializeApp() 等) 中的專案 ID 與 Firebase CLI 使用的專案 ID 相符。

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

Android、Apple 平台和 Web SDK

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

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 database = Firebase.database
database.useEmulator("10.0.2.2", 9000)
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.
FirebaseDatabase database = FirebaseDatabase.getInstance();
database.useEmulator("10.0.2.2", 9000);
EmulatorSuite.java

Swift

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

Web

進一步瞭解樹狀結構可分離模組化 Web API，並升級命名空間 API。

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

Web

進一步瞭解樹狀結構可分離模組化 Web API，並升級命名空間 API。

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 環境變數。

Node.js Admin SDK

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

環境變數

export GCLOUD_PROJECT="your-project-id"

在測試之間清除資料庫

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

注意： 請只在測試設定中加入資料庫沖洗程式的程式碼。請確認不會在正式版程式碼中意外呼叫此方法。

Kotlin+KTX

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

Java

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

Swift

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

Web

進一步瞭解樹狀結構可分離模組化 Web API，並升級命名空間 API。

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

Web

進一步瞭解樹狀結構可分離模組化 Web API，並升級命名空間 API。

// 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 模擬器，請參閱「在本機執行函式」一文。