تثبيت إضافة Firebase

يمكنك تثبيت أي من إضافات Firebase الرسمية (وإدارتها) باستخدام وحدة تحكّم Firebase أو واجهة سطر الأوامر (CLI) في Firebase أو باستخدام حزمة تطوير برامج (SDK) تم إنشاؤها تلقائيًا.

احرص على مراجعة الاختلافات في الإجراءات المتوافقة مع كل طريقة تثبيت.



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

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

قبل البدء

إذا لم يسبق لك إجراء ذلك، أضِف Firebase إلى مشروعك ورقِّ مشروعك على Firebase إلى خطة Blaze (الدفع حسب الاستخدام).

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

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

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

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

لعرض معلومات مفصّلة عن إضافة، اتّبِع الخطوات التالية:

  1. تصفُّح إضافات Firebase الرسمية في Extensions Hub

  2. انقر على بطاقة إضافة لتنفيذ ما يلي:

    • عرض المعلومات التفصيلية الخاصة بالإضافة

    • ابحث عن رابط إلى رمز المصدر الخاص بالإضافة في Firebase Extensions مستودع المصدر.

      في دليل الإضافات الخاص بالإضافة، يمكنك الاطّلاع على هذه المعلومات التفصيلية في README.

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

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

  1. تصفُّح إضافات Firebase الرسمية في Extensions Hub

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

  3. انقر على تثبيت، ثم اتّبِع التعليمات الظاهرة على الشاشة لتثبيت الإضافة.

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

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

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

إنشاء موارد Firebase

إذا أعددت الإضافة لاستخدام موارد Firebase (Cloud FirestoreمجموعاتRealtime Database ومساراتCloud Storage وحِزم) غير متوفّرة حاليًا، عليك إنشاؤها قبل استخدام الإضافة.

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

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

راجِع مستندات الإضافة للاطّلاع على قائمة بالأحداث التي تنشرها (إن وُجدت). على سبيل المثال، اطّلِع على أنواع الأحداث الخاصة بإضافة "تشغيل عمليات الدفع باستخدام Stripe".

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

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

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

سيُطلب منك تأكيد أو تعديل معرّف كل نسخة إضافية من الإضافة التي تثبّتها.

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

  • اطّلِع على التفاصيل والإعدادات الخاصة بالإضافة المثبَّتة في وحدة تحكّم Firebase.

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

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

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