Catch up on everything we announced at this year's Firebase Summit. Learn more

將您的應用程序連接到實時數據庫模擬器

您的應用程序連接到數據庫的實時仿真器之前,請確保你了解整個火力地堡本地模擬器套房的工作流程,以及您安裝並配置本地仿真器套件和審查其CLI命令

選擇一個 Firebase 項目

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

要選擇項目中使用,啟動模擬器前,在命令行運行firebase use在你的工作目錄。或者,您可以通過--project標誌給每個仿真命令。

當地仿真器套件支持實時火力地堡項目和示範項目的仿真。

項目類型特徵與模擬器一起使用
真實的

一個真正的 Firebase 項目是您創建和配置的(很可能通過 Firebase 控制台)。

真實項目具有實時資源,例如數據庫實例、存儲桶、函數或您為該 Firebase 項目設置的任何其他資源。

在處理真實的 Firebase 項目時,您可以為任何或所有受支持的產品運行模擬器。

因為你不模仿任何產品,您的應用程序和代碼將用資源(數據庫實例,存儲鬥,功能等)進行交互。

演示

一個演示火力地堡項目有沒有真正的火力地堡配置和沒有活的資源。這些項目通常通過代碼實驗室或其他教程訪問。

項目編號為示範項目有demo-前綴。

當演示火力地堡的項目,你的應用程序和用仿真器代碼交互工作。如果您的應用嘗試與模擬器未運行的資源進行交互,則該代碼將失敗。

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

  • 設置更簡單,因為您無需創建 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.
        FirebaseDatabase database = FirebaseDatabase.getInstance();
        database.useEmulator("10.0.2.2", 9000);
迅速
    // In almost all cases the ns (namespace) is your project ID.
let db = Database.database(url:"http://localhost:9000?ns=YOUR_DATABASE_NAMESPACE")

網頁版 9

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

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

網頁版 8

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

無需額外的設置是需要測試雲功能通過實時數據庫事件觸發使用模擬器。當實時數據庫和 Cloud Functions 模擬器同時運行時,它們會自動協同工作。

管理 SDK

當在火力地堡管理軟件開發工具包自動連接到數據庫的實時仿真FIREBASE_DATABASE_EMULATOR_HOST環境變量設置:

export FIREBASE_DATABASE_EMULATOR_HOST="localhost:9000"

如果你的代碼是雲功能中正在運行的仿真項目ID和其他配置將調用時,將自動設定initalizeApp

從任何其他環境連接到實時數據庫模擬器時,您需要指定項目 ID。你可以通過一個項目ID來initializeApp直接或設置GCLOUD_PROJECT環境變量。請注意,您不需要使用真實的 Firebase 項目 ID,實時數據庫模擬器將接受任何項目 ID:

Node.js 管理 SDK
admin.initializeApp({ projectId: "your-project-id" });
環境變量
export GCLOUD_PROJECT="your-project-id"

在測試之間清除數據庫

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

安卓
// With a DatabaseReference, write null to clear the database.
database.getReference().setValue(null);
迅速
// With a DatabaseReference, write nil to clear the database.
    Database.database().reference().setValue(nil);

網頁版 9

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

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

網頁版 8

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

自然地,您的代碼應該使用平台的異步事件處理功能等待確認刷新完成或失敗。

實施了這樣的步驟後,您可以對測試進行排序並觸發您的功能,因為舊數據將在運行之間被清除,並且您正在使用新的基線測試配置。

導入導出數據

數據庫和 Cloud Storage 模擬器允許您從正在運行的模擬器實例導出數據。定義一組基線數據以在您的單元測試或持續集成工作流中使用,然後將其導出以在團隊之間共享。

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>

接下來是什麼?