إضافات Firebase

تساعدك إضافات Firebase على نشر الوظائف إلى تطبيقك بسرعة باستخدام حلول مجمعة مسبقًا.

بعد تثبيت إضافة Firebase، تنفِّذ إضافة Firebase مهمة أو مجموعة مهام محدّدة استجابةً لطلبات HTTPS أو أحداث Cloud Scheduler أو لعرض أحداث من منتجات Firebase الأخرى، مثل Cloud Firestore أو "المراسلة عبر السحابة الإلكترونية من Firebase".

استكشاف مركز الإضافات التعرّف على كيفية تثبيت إضافة الاطّلاع على كيفية إنشاء إضافة خاصة بك

الإمكانات الرئيسية

تقليل الوقت المُستغرق في التطوير والصيانة والنمو

بما أنّ الإضافة هي حل مجمّع، ما عليك سوى تثبيت الإضافة وضبطها.

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

يمكنك استكشاف مركز الإضافات للعثور على حلول مناسبة لتطبيقك أو مشروعك.

تصميم قابل للضبط وقابل لإعادة الاستخدام

يعتبر كل مثيل مثبّت للإضافة فريدًا.

يمكنك تحديد قيم الإعدادات التي تكون فريدة للتطبيق أو المشروع أو حالة الاستخدام. وبناءً على وظيفة الإضافة، يمكن أن تكون هذه القيم أي شيء تقريبًا: مسار Cloud Firestore أو سمات الصورة أو عنوان URL لـ GitHub.

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

الدمج مع منصة Firebase

ويمكن للإضافات أن تملأ الجزء المفقود من البنية الحالية.

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

يمكن للإضافة أيضًا دمج مشروع Firebase مع منتجات Google Cloud Platform الأخرى (مثل BigQuery و"ترجمة Google") أو حتى خدمات تابعة لجهات خارجية (مثل Mailchimp وBit.ly).

لا يقتصر بدء الأحداث على أحداث Firebase، بل يمكن تشغيل إضافة بشكل مباشر من خلال طلب HTTPS أو على فترات زمنية مجدولة.

الأمان وإمكانية الوصول المحدودة

يعمل منطق التطبيق للإضافات في الخلفية باستخدام دوال Google Cloud، وبالتالي يتم عزل الرمز تمامًا عن البرنامج.

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

بدون صيانة

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

لا داعي للقلق أبدًا بشأن بيانات الاعتماد أو ضبط الخادم أو توفير المتطلبات اللازمة للخوادم الجديدة أو إيقاف الخوادم القديمة.

ما هي آلية العمل؟

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

تتم كتابة منطق الإضافة باستخدام وظائف السحابة الإلكترونية لبرنامج Firebase. تحدّد الدوالّ في الإضافة موفّري الأحداث والشروط التي تؤدي إلى التنفيذ (على سبيل المثال، كتابة في Cloud Firestore أو طلب HTTPS أو حدث Cloud Scheduler).

على الرغم من أنّ الإضافات تستخدم الدوال، فإنّ ميزة التفريق الرئيسية بين الإضافات والدوال هي أنّ الإضافة تعتمد على ملف مواصفات extension.yaml الذي يحدّد بشكل صريح ما يلي:

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

يمكنك تثبيت إضافة في مشروع عدة مرات، مع ضبط إعدادات مختلفة لكل مثيل مثبَّت.

عند تثبيت مثيل إضافة، يُنفِّذ Firebase ما يلي:

  1. يطالبك بتحديد قيم الإعداد (المعلمات) المطلوبة ليتم استخدامها في هذه النسخة الافتراضية من الإضافة.
  2. تفعيل واجهات برمجة التطبيقات المدرجة من ملف extension.yaml للمشروع.
  3. تنشئ حساب خدمة جديدًا لاستخدامه في هذا المثيل من الإضافة، وتعيّن له أدوار الوصول المُدرَجة. ينفِّذ مثيل الإضافة رمزه باستخدام إذن الوصول الممنوح لحساب الخدمة هذا.
  4. يوفر الموارد المدرَجة لمثيل الإضافة (مثل دالة).

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

بالإضافة إلى ملف extension.yaml، يتضمّن دليل الإضافة أيضًا ملفات إرشادية مثل "README"، الذي يحتوي على معلومات لمساعدتك في إكمال المزيد من مهام الإعداد أو استخدام الإضافة بشكل عام.

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

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

مسار التنفيذ

البحث عن إضافة

استكشِف الإضافات المتاحة في مركز الإضافات.

تقييم إضافة وتثبيتها وضبطها

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

اضبط الإضافة بحيث يتم تخصيصها لتطبيقك أو مشروعك.

إدارة الإضافة

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

الخطوات اللاحقة