تثبيت إضافة 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 (يتم عرض الرابط المحدّد لملف Extensions لوحة البيانات في المحطة الطرفية بعد التثبيت).

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

إنشاء موارد Firebase

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

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

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

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

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

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

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

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

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