نظرة عامة

تساعدك Firebase Extensions في تقليل الوقت الذي تقضيه في تطوير تطبيقك وصيانته، وتوسيع نطاقه.

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

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

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

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

يمكنك أيضًا تقييم الإضافات قبل تثبيتها على مشروع باستخدام محاكي Extensions، وهو أحد مكوّنات Firebase Local Emulator Suite.

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

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

تصفُّح إضافات Firebase

يمكنك تصفُّح إضافات Firebase في الـ Extensions Hub.

عرض الرمز المصدر لإضافة

للعثور على رابط يؤدي إلى الرمز المصدر لإضافة، انقر على مزيد من المعلومات في بطاقة الإضافة في Extensions Hub.

محتويات الرمز المصدر لإضافة

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

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

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

  • ملف README : يعرض البيانات الوصفية للإضافة (بتنسيق أكثر سهولة للقراءة) بالإضافة إلى المحتوى من ملف PREINSTALL

  • ملف PREINSTALL : يصف طريقة عمل الإضافة وأي مهام ضرورية قبل التثبيت ومتطلبات الإعداد وتفاصيل حول الإضافة

  • ملف POSTINSTALL : يصف تعليمات استخدام محدّدة وأي متطلبات إضافية للتكامل

موارد لإضافة

يحتوي كل مشروع من مشاريع Firebase على عدة أنواع من "الموارد". يمكن أن تتضمّن موارد المشروع أشياء مثل دوال Cloud Functions التي تم نشرها ومثيلات قواعد البيانات، Cloud Storage حِزم Cloud Storage ومهام Cloud Scheduler وبيانات Cloud Secret Manager.

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

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

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

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

استخدام وحدة التحكّم Firebase أو واجهة سطر الأوامر Firebase أو حِزم تطوير البرامج (SDK) التي يتم إنشاؤها تلقائيًا {: #console-vs-cli}

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

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

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