如何:使用 AzureClient 進行本機測試
本文會逐步解說在原生模式中設定 AzureClient 的步驟,並用它來在本機測試您的 Fluid 應用程式。
設定及建立 AzureClient
您可以藉由傳遞如下的設定,將 AzureClient 設定為針對本機 Azure Fluid Relay 實例執行。
import { AzureClient, AzureConnectionConfig, LOCAL_MODE_TENANT_ID } from "@fluidframework/azure-client";
import { InsecureTokenProvider } from "@fluidframework/test-client-utils";
const clientProps = {
connection: {
tenantId: LOCAL_MODE_TENANT_ID,
tokenProvider: new InsecureTokenProvider("", { id: "123", name: "Test User" }),
endpoint: "http://localhost:7070",
type: "remote",
},
};
const azureClient = new AzureClient(clientProps);
此範例會使用 InsecureTokenProvider 來產生並簽署 Azure Fluid Relay 服務將接受的驗證權杖。 不過,如其名所示,此實作不安全,不應用於生產環境。 如需 InsecureTokenProvider 的詳細資訊,請參閱 應用程式中 的驗證和授權。
若要在本機執行,請先將端點設定為指向網域,並移植本機 Azure Fluid Relay 服務實例在 ( http://localhost:7070 預設) 執行。 最後一個步驟是將 設定 tenantId
為 LOCAL_MODE_TENANT_ID
。 所有這些設定都會將 AzureClient 設定為使用本機 Azure Fluid Relay 服務。
啟用偵錯記錄
您可以使用瀏覽器主控台中的下列設定,從流體架構啟用內建偵錯記錄。
localStorage.debug = 'fluid:*'
針對更進階的案例,您可以將 傳遞 logger
至 AzureClient。 這可讓您自訂記錄行為。 如需記錄器或遙測的詳細資訊,請參閱 記錄和 fluidframework.com 上的遙測 。
在本機執行 Azure Fluid Relay 服務
若要使用 AzureClient 的原生模式,您必須先啟動本機伺服器。 從終端機視窗執行 npx @fluidframework/azure-local-service@latest
將會啟動 Azure Fluid Relay 本機伺服器。 伺服器啟動之後,您可以對本機服務執行應用程式。