Firebase Extensions

تساعدك Firebase Extensions في نشر الوظائف في تطبيقك بسرعة باستخدام حلول مُعدّة مسبقًا.

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

استكشاف Extensions Hub كيفية تثبيت إضافة كيفية إنشاء إضافة خاصة بك


الإمكانات الأساسية

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

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

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

يمكنك استكشاف Extensions Hub للعثور على حلول لتطبيقك أو مشروعك.
مصمَّمة لتكون قابلة للإعداد وإعادة الاستخدام

كل نسخة مثبّتة من الإضافة هي نسخة فريدة.

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

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

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

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

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

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

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

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

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

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

كيف تعمل هذه الميزة؟

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

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

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

  • خدمات Google (واجهات برمجة التطبيقات) التي ستستخدمها الإضافة
  • أدوار الوصول التي تتطلّبها الإضافة لتعمل
  • الموارد الخاصة بالإضافة والتي تحتاجها الإضافة لتعمل
  • المَعلمات القابلة للضبط للإضافة

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

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

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

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

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

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

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

مسار التنفيذ

العثور على إضافة

استكشِف الإضافات المتاحة في Extensions Hub.
تقييم إضافة وتثبيتها وضبطها

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

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

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

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