تثبيت إضافة Firebase

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

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



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

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

قبل البدء

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

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

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

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

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

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

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

  2. انقر على بطاقة إحدى الإضافات لإجراء ما يلي:

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

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

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

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

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

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

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

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

إنشاء موارد Firebase

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

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

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

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

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

تثبيت عدّة نُسخ من الإضافة

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

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

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