تثبيت إضافة Firebase

يمكنك تثبيت (وإدارة) أي إضافات Firebase الرسمية إما باستخدام وحدة تحكم Firebase أو واجهة سطر الأوامر في Firebase (واجهة سطر الأوامر).

تأكد من مراجعة الاختلافات في للإجراءات المتوافقة مع واجهة سطر الأوامر في Firebase ووحدة تحكم Firebase.


لتثبيت الإضافات أو إدارتها، يجب أن يكون لديك أحد الأدوار التالية: المالك أو المحرِّر أو مشرف Firebase

لتثبيت إضافة، يجب أن يكون مشروعك على Blaze (الدفع حسب الاستخدام). الذهاب) الخطة. على الرغم من عدم وجود رسوم مقابل تثبيت إحدى الإضافات، فقد تكون يتم تحصيل رسوم منك مقابل استخدامك لخدمات Firebase أو خدمات السحابة الإلكترونية، مثل Cloud Secret Manager، إذا تجاوز استخدامك للخدمات مجانًا .

قبل البدء

  1. أضِف Firebase إلى مشروعك إذا لم يسبق لك إجراء ذلك.

  2. عليك ترقية مشروعك إلى Blaze إذا لم يسبق لك إجراء ذلك (الدفع حسب الاستخدام). الذهاب) الخطة.

  3. يمكنك تثبيت أحدث إصدار من واجهة سطر الأوامر في Firebase

  4. دوِّن رقم تعريف مشروع Firebase أو الذي تم إعداده مسبقًا. الاسم المستعار للمشروع.

الخطوة 1: عرض معلومات تفصيلية عن إحدى الإضافات

هذه الخطوة اختيارية، ولكننا ننصح بذلك بشدة.

قبل تثبيت إضافة Firebase، ننصحك بما يلي: راجِع المعلومات التفصيلية حول الإضافة، بما في ذلك:

  • آلية عمل الإضافة وأي مهام قبل التثبيت وتفاصيل حول الإضافة
  • معلومات التعريف العامة والوصف
  • ما إذا كانت مهام الإضافة تتطلب حساب فوترة أم لا
  • خدمات Google (واجهات برمجة التطبيقات) أدوار الوصول المطلوبة من أجل عملية
  • تم إنشاء الموارد للإضافة (مثل الدوال)
  • أوصاف المَعلمات التي يمكن للمستخدِم ضبطها

لعرض المعلومات التفصيلية للإضافة:

  1. تأكد من أنك إعداد البيئة أو حدد الإضافة.

  2. شغّل الأمر extension-info من أي مكان على جهاز الكمبيوتر:

    firebase ext:info publisher-id/extension-id

    publisher-id وextension-id تكون الوسائط مطلوبة ويمكن العثور عليها في صفحة تفاصيل التثبيت المسبق للإضافة.

الخطوة 2: تثبيت إضافة

أثناء عملية التثبيت، سيُطلب منك مراجعة الإعدادات المواصفات الخاصة بالإضافة (مثل واجهات برمجة التطبيقات المفعّلة، الموارد منح إذن الوصول، وما إلى ذلك). سيتمّ إعلامك بأي متطلبات للفوترة، كما سيُطلب منك. حدد قيمًا لمعلمات الإضافة القابلة للتهيئة.

  1. تأكد من أنك إعداد البيئة حدد الإضافة.

  2. من دليل Firebase المحلي، شغِّل الأمر extension-install. أدخِل قيم المَعلمات لتخصيص النسخة الافتراضية للإضافة، إذا طُلب منك ذلك.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    publisher-id وextension-id تكون الوسائط مطلوبة ويمكن العثور عليها في صفحة تفاصيل التثبيت المسبق للإضافة.

    يؤدي تشغيل هذا الأمر إلى إضافة مثيل إضافة إلى بيان الإضافات.

  3. بعد ذلك، يمكنك نشر الإضافات في ملف البيان على منصّة Firebase. تشغيل: 

    firebase deploy --only extensions --project=projectId-or-alias

الخطوة 3: إكمال الإعداد بعد التثبيت

تتضمّن بعض الإضافات خطوات مطلوبة أو اختيارية لإكمالها قبل استخدامها معهم. يمكنك العثور على هذه التعليمات في صفحة تفاصيل ما بعد التثبيت الخاصة بإضافتك في لوحة بيانات الإضافات في وحدة تحكم Firebase (الرابط المحدد إلى تُعرض لوحة البيانات في الوحدة الطرفية بعد التثبيت).

يمكنك أيضًا العثور على هذه التعليمات في ملف POSTINSTALL.md ضمن الدليل المصدر للإضافة.

إنشاء موارد Firebase

في حال إعداد الإضافة لاستخدام موارد Firebase (Cloud Firestore ومجموعات البيانات ومسارات قاعدة البيانات في الوقت الفعلي وحزم Cloud Storage) التي لا تكون موجودة من قبل، بإنشائها قبل استخدام الإضافة.

إنشاء معالِجات أحداث Eventarc

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

يمكنك الاطّلاع على مستندات الإضافة للحصول على قائمة بالأحداث التي تنشرها (إن وجدت). على سبيل المثال، راجع أنواع الأحداث لإضافة Run Payments with Stripe.

وبعد ذلك، اطّلِع على عوامل تشغيل الأحداث المخصّصة من أجل معلومات حول كتابة معالِجات أحداث Eventarc.

تثبيت مثيلات إضافات متعددة

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

الخطوات التالية

  • يمكنك عرض التفاصيل الإعدادات للإضافة المثبتة في وحدة تحكُّم Firebase.

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

  • باستخدام واجهة سطر الأوامر في Firebase إدارة . يمكنك أيضًا إعادة ضبط الإضافة أو إلغاء تثبيتها يمكنك تحديث الإضافة إلى أحدث إصدار.

  • باستخدام "وحدة تحكُّم Firebase" إدارة . بالنسبة إلى إضافات Firebase الرسمية، يمكنك إعادة ضبط أو إلغاء تثبيتها، فضلاً عن تحديث الإضافة إلى أحدث إصدار .

  • كأفضل ممارسة لجميع المشروعات، تأكد من إعداد تنبيهات الميزانية لمشروعك ومراقبة الاستخدام والفوترة لوحة البيانات في وحدة تحكُّم Firebase.