إضافات 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 في الأساس هي رمز برمجي ينفّذ مهمة مهما كان حدثًا محدّدًا بشكل محدد داخل تطبيقك أو مشروعك.

تتم كتابة منطق الإضافة باستخدام Cloud Functions for 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.

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