نظرة عامة

تساعدك إضافات Firebase في توفير الوقت المستغرق في تطوير تطبيقك وصيانته ونموه.

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

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

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

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

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

إضافات Firebase الرسمية

يتم تطوير واختبار إضافات Firebase الرسمية بواسطة خدمات شركاء Firebase وإضافات Firebase. هذه الإضافات موثوقة وآمنة.

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

تصفَّح إضافات Firebase الرسمية في مركز الإضافات.

إضافات شركاء استخدام المنتج قبل إطلاقه

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

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

عرض رمز المصدر لإحدى الإضافات

للعثور على رابط إلى رمز المصدر لإحدى إضافات Firebase الرسمية، انقر على مزيد من المعلومات في بطاقة الإضافة في "مركز الإضافات".

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

محتوى رمز المصدر الخاص بالإضافة

يتضمن دليل المصدر للإضافة ما يلي:

  • extension.yaml file: يحتوي على البيانات الوصفية للإضافة ويحدّد الموارد التي تم إنشاؤها وواجهات Google APIs وأدوار الوصول المطلوبة للعملية وأيّ مَعلمات أعدّها المستخدِم (متغيّرات البيئة) للإضافة.

  • دليل الدوال: يحتوي على ملفات رمز المصدر الخاص بالإضافة.

  • ملف README: يسرد البيانات الوصفية للإضافة (ولكن بتنسيق يمكن للمستخدمين قراءته)، بالإضافة إلى المحتوى الوارد في ملف PREINSTALL.

  • ملف PREINSTALL (ملف PREINSTALL): يصف طريقة عمل الإضافة وأي مهام ضرورية للتثبيت المُسبَق ومتطلبات الضبط وتفاصيل حول الإضافة

  • ملف POSTINSTALL: لوصف تعليمات الاستخدام المحدَّدة وأي متطلبات دمج أخرى

مراجع للإضافة

يحتوي كل مشروع في Firebase على عدة أنواع من "الموارد". ويمكن أن تتضمن موارد المشروع عناصر مثل دوال Cloud المنشورة ومثيلات قاعدة البيانات ومجموعات بيانات Cloud Storage ومهام Cloud Scheduler وبيانات Cloud Secret Manager.

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

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

  • أي عناصر تم إنشاؤها من خلال الإضافة (مثل الصور المخزّنة).

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

باستخدام وحدة تحكُّم Firebase أو واجهة سطر الأوامر في Firebase

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

الإجراء وحدة تحكُّم Firebase واجهة سطر الأوامر في Firebase
عرض معلومات تفصيلية (قبل التثبيت)
تثبيت
عرض الإعدادات (بعد التثبيت)
تعديل الإعدادات
تحديث الإصدار
إلغاء التثبيت

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