Save the date - Google I/O returns May 18-20. Register to get the most out of the digital experience: Build your schedule, reserve space, participate in Q&As, earn Google Developer profile badges, and more. Register now
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

إدارة ملحقات Firebase المثبتة

لتثبيت الإضافات أو إدارتها ، يجب أن يتم تعيين أحد هذه الأدوار لك: المالك أو المحرر أو مشرف Firebase .

سرد ملحقات المشروع المثبتة

يمكنك سرد جميع الملحقات المثبتة في مشروع Firebase وعرض معرّف المثيل لكل إضافة.

قم بتشغيل أمر قائمة الملحقات:

firebase ext:list --project=projectId-or-alias

مراقبة امتداد مثبت

في وحدة تحكم Firebase ، يمكنك مراقبة نشاط أحد الإضافات المثبتة ، بما في ذلك عمليات التحقق من صحتها واستخدامها وسجلاتها.

تعيين تنبيهات الميزانية

يعد تعيين تنبيهات الميزانية ممارسة جيدة بشكل عام ، ولكن قد تكون التنبيهات مهمة بشكل خاص عندما تثق في رمز طرف آخر ليتم تشغيله في مشروعك.

تأكد من إعداد تنبيهات الميزانية لمشروع Firebase الخاص بك.

عرض الوظائف التي تم إنشاؤها بواسطة الامتدادات

  1. انتقل إلى لوحة معلومات الوظائف الخاصة بوحدة تحكم Firebase.

  2. في علامة التبويب Dashboard ، يمكنك عرض الوظائف من Firebase Extensions (جنبًا إلى جنب مع أي وظائف أخرى قمت بنشرها لمشروعك).

    الدوال التي تم إنشاؤها بواسطة الامتدادات لها أسماء ، بالتنسيق: ext- extension-instance-id - functionName

    على سبيل المثال: ext-awesome-task-simplifier-onUserCreate

عرض وظائف جدولة السحابة التي تم إنشاؤها بواسطة الملحقات

  1. افتح صفحة Cloud Scheduler الخاصة بمشروعك في Google Cloud Console.

  2. في قائمة الوظائف ، يمكنك عرض وظائف Cloud Scheduler من Firebase Extensions (جنبًا إلى جنب مع أي وظائف أخرى أنشأتها لمشروعك).

    الوظائف التي تم إنشاؤها بواسطة الامتدادات لها أسماء بالتنسيق: firebase-ext- extension-instance-id - functionName

    على سبيل المثال: firebase-ext-awesome-task-simplifier-doTask

تحقق مما إذا كان الملحق المثبت سليمًا

يمكنك مراجعة جميع الأخطاء من الوظائف (بما في ذلك تلك التي تم إنشاؤها بواسطة Firebase Extensions) في وحدة التحكم.

  1. في علامة التبويب Health في لوحة معلومات الوظائف ، يمكنك عرض نظرة عامة على الأخطاء ومعلومات الأداء لجميع الوظائف في مشروعك.

  2. لعرض المعلومات الخاصة بامتداد معين ، استخدم المرشح الموجود أعلى الصفحة لتحديد وظيفة معينة.

تحقق من عدد مرات تشغيل ملحق مثبت

  1. في علامة التبويب Dashboard في لوحة معلومات الوظائف ، حدد الوظيفة المحددة لـ Firebase Extension التي تريد التحقق منها.

  2. انقر فوق (القائمة ) في أقصى الجانب الأيمن من الإدخال ، ثم حدد إحصائيات الاستخدام التفصيلية .

  3. في Google Cloud Console المعروضة ، يمكنك التعمق في الاستدعاءات المختلفة لوظيفة ما وحتى فحص كود المصدر الخاص بها.

عرض السجلات للحصول على ملحق

إذا كنت تحاول تصحيح أخطاء مشروعك ، أو إرسال تقرير خطأ إلى Firebase ، فمن المفيد عرض سجلات الوظائف التي تعمل في مشروعك.

في علامة التبويب " السجلات" في لوحة معلومات الوظائف ، استخدم عامل التصفية الموجود أعلى الصفحة لتحديد الوظائف التي تم إنشاؤها بواسطة الامتداد الخاص بك.

قم بتحديث ملحق مثبت إلى أحدث إصدار

يمكنك تحديث مثيل مثبت من أحد الإضافات إلى أحدث إصدار تم إصداره. قد ترغب في تحديث مثيل مثبت لأن المثيل قيد التشغيل أو الإعداد بالفعل في الاختبار أو المشروع أو سير عمل التطبيق.

عند تحديث مثيل ، يتم الكتابة فوق كل الموارد والمنطق الخاصين بالامتداد الخاص بالمثيل لاستخدام التعليمات البرمجية المصدر والملفات الخاصة بالإصدار الجديد. لن يتغير معرف مثيل الإضافة وحساب الخدمة.

أثناء عملية التحديث ، سيتم إخطارك بأي تغييرات في الإصدار الجديد ، وستتمكن من تحديد قيم لأي معلمات جديدة.

  1. قم بتشغيل أمر قائمة الامتدادات للحصول على معرف مثيل الملحق:

    firebase ext:list --project=projectId-or-alias
  2. قم بتشغيل أمر تحديث الملحق:

    firebase ext:update extensionInstanceId --project=projectId-or-alias

أعد تكوين ملحق مثبت

يمكنك تغيير قيم المعلمات التي تم تكوينها بواسطة المستخدم لملحق مُثبت. سيتم استخدام هذه القيم الجديدة في أي مشغلات مستقبلية للامتداد ، ولكن لن يتم تغيير جميع القطع الأثرية أو العناصر الهيكلية السابقة التي تم إنشاؤها بواسطة الامتداد (مثل الصور المخزنة أو دلاء التخزين الحالية).

  1. قم بتشغيل أمر قائمة الامتدادات للحصول على معرف مثيل الملحق:

    firebase ext:list --project=projectId-or-alias
  2. قم بتشغيل أمر تكوين الامتداد:

    firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile

    حيث --params هي علامة اختيارية لتوفير ملف يحدد قيم المعلمات القابلة للتكوين بواسطة المستخدم ويسمح لك بتجاوز المطالبات الطرفية التفاعلية لهذه القيم. حدد القيم الخاصة بك في ملف .env يتبع بناء جملة dotenv .

  3. إذا تمت مطالبتك (أو لم تقدم ملف .env ) ، فأدخل قيم التكوين لتخصيص الامتداد لمشروعك.

قم بإلغاء تثبيت ملحق

يمكنك إلغاء تثبيت ملحق من مشروع Firebase الخاص بك. يؤدي هذا الإجراء إلى حذف حساب الخدمة وجميع الموارد (مثل مجموعة الوظائف) التي أنشأها Firebase خصيصًا لهذا المثيل من الامتداد. ومع ذلك ، لا يتم حذف ما يلي:

  • أي قطع أثرية تم إنشاؤها بواسطة الامتداد (مثل الصور المخزنة).

  • أي موارد أخرى في مشروعك ، مثل طبعة قاعدة البيانات أو حاوية التخزين السحابي. حتى إذا تفاعلت الإضافة مع هذه الموارد الأخرى ، فهي ليست خاصة بالامتداد ، لذلك لا يتم حذفها إذا تم إلغاء تثبيت الامتداد.

فيما يلي كيفية إلغاء تثبيت أحد الإضافات:

  1. قم بتشغيل أمر قائمة الامتدادات للحصول على معرف مثيل الملحق:

    firebase ext:list --project=projectId-or-alias
  2. قم بتشغيل الأمر extension-uninstall:

    firebase ext:uninstall extensionInstanceId --project=projectId-or-alias