كيفية القيام بما يلي: استخدام 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 المحلية.

تمكين تسجيل التصحيح

يمكنك تمكين تسجيل تتبع الأخطاء المضمن من إطار عمل Fluid باستخدام الإعداد التالي في وحدة تحكم المستعرض.

localStorage.debug = 'fluid:*'

للحصول على سيناريوهات أكثر تقدما، يمكنك تمرير logger إلى AzureClient. يمكنك هذا من تخصيص سلوك التسجيل. لمزيد من المعلومات حول المسجل أو بيانات تتبع الاستخدام، راجع التسجيل وبيانات تتبع الاستخدام على fluidframework.com.

تشغيل خدمة Azure Fluid Relay محليا

لاستخدام الوضع المحلي ل AzureClient، تحتاج أولا إلى بدء تشغيل خادم محلي. سيؤدي التشغيل npx @fluidframework/azure-local-service@latest من نافذة المحطة الطرفية إلى تشغيل خادم Azure Fluid Relay المحلي. بمجرد بدء تشغيل الخادم، يمكنك تشغيل التطبيق الخاص بك مقابل الخدمة المحلية.