نظرة عامة على ناشر الإضافة

تُنفِّذ إضافة Firebase مهمة معيّنة أو مجموعة من المهام استجابةً لطلبات HTTP أو أحداث التفعيل من منتجات Firebase وGoogle الأخرى، مثل Firebase Cloud Messaging أو Cloud Firestore أو Pub/Sub.

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

بنية الإضافة

يمكنك التفكير في الإضافة على أنها تحتوي على ثلاثة مكونات رئيسية:

  • رمز Cloud Functions في JavaScript أو TypeScript
  • البيانات الوصفية التي تصف إضافة Chrome
  • مستندات لمساعدة المستخدمين في ضبط الإضافة واستخدامها

لتطوير إضافة، عليك تجميع هذه المكوّنات في البنية التالية: 

example-extension
├── functions
│   ├── integration-tests
│   │   ├── extensions
│   │   │   └── example-extension.env
│   │   ├── firebase.json
│   │   └── integration-test.spec.js
│   ├── index.js
│   └── package.json
├── README.md
├── PREINSTALL.md
├── POSTINSTALL.md
├── CHANGELOG.md
├── icon.png
└── extension.yaml
  • يحتوي الدليل functions على رمز Cloud Functions بتنسيق JavaScript أو TypeScript. هذا هو الرمز الذي يؤدي مهام الإضافة في الاستجابة للأحداث التي تم تشغيلها من خلال Firebase وخدمات Google.
  • يحتوي ملف extension.yaml على بيانات وصفية عن إضافتك، مثل عوامل التفعيل وأدوار الوصول في إدارة الهوية وإمكانية الوصول، بالإضافة إلى أي مَعلمات تريد أن يضبطها المستخدم.
  • إنّ ملفات PREINSTALL وPOSTINSTALL وCHANGELOG هي الحد الأدنى من مستندات الامتداد التي يجب أن تتضمّنها. تساعد هذه الملفات المستخدمين على معرفة ووظيفة الإضافة وكيفية استخدامها والتحديثات التي أجريتها. يجب أيضًا توفير رمز لمساعدة المستخدمين في التعرّف على إضافتك. تشير رسالة الأشكال البيانية تعرض وحدة تحكم Firebase وواجهة سطر الأوامر في Firebase ومركز الإضافات محتوى هذه الملفات عند استكشاف المستخدمين لإضافتك وتثبيتها وإدارتها.

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

ما هي المنتجات التي يمكن للإضافة التفاعل معها؟

نظرًا لأن إضافة Firebase تؤدي عملها باستخدام دوال السحابة، يمكنك التفكير عن مسألة عمليات الدمج الممكنة بطريقتين: ما هي المنتجات التي يمكن أن تؤدي إلى ووظائف الإضافة لديّ؟ وبعد تشغيلها، ما هي المنتجات التي يمكن التي تتفاعل معها الدوال؟

عوامل تشغيل الدوال المتوافقة

المشغّلات اليدوية

أولاً، يمكنك تفعيل دالة يدويًا. إضافات Firebase والسحابة الإلكترونية تتيح الدوال طريقتَين لتفعيل الدوال يدويًا:

  • عوامل تشغيل HTTP: نشر دالة إلى نقطة نهاية HTTP
  • الدوالّ القابلة للاستدعاء: يمكنك استدعاء Cloud Functions مباشرةً من رمز عملاء iOS أو Android أو الويب باستخدام حِزم تطوير البرامج (SDK) لعملاء Firebase.

من خلال عرض نقاط نهاية HTTP من الإضافة، من المحتمل أن التكامل مع أي خدمة ويب تتيح الرد التلقائي على الويب باستخدام دوال قابلة للاستدعاء، يمكن للمستخدمين الذين يثبّتون إضافتك استخدام حِزم تطوير البرامج (SDK) لمنصة Firebase كمكتبة عملاء. للوصول إلى واجهة برمجة التطبيقات التي تنفّذها إضافتك.

مشغِّلات خدمة Firebase

تُصدر معظم منتجات Firebase أحداثًا يمكن أن تؤدي إلى تشغيل السحابة الإلكترونية للإضافة. الدوال.

  • "إحصاءات Google": تؤدي إلى تفعيل الوظائف عندما تُسجِّل "إحصاءات Google" حدثًا
  • App Distribution: وظائف التفعيل عندما تُطلق أداة App Distribution إشارة هُذار
  • المصادقة: تفعيل الوظائف عندما ينشئ المستخدمون حسابات ويحذفونها
  • Cloud Firestore: تنشيط الدوالّ عند إنشاء الصفحات أو تعديلها أو حذفها
  • التخزين في السحابة الإلكترونية: تفعيل الوظائف عند تحميل العناصر أو أرشفتها أو تم الحذف من المجموعات
  • Crashlytics: تؤدي إلى تفعيل الوظائف عندما يشغّل Crashlytics تنبيهًا
  • مراقبة الأداء: تنشيط الدوالّ عندما تُنشئ ميزة "مراقبة الأداء" تنبيهاً
  • قاعدة بيانات الوقت الفعلي: تؤدي إلى تشغيل الدوال عند إنشاء البيانات أو تحديثها أو محذوف
  • الإعداد عن بُعد: تنشيط الدوالّ عند تعديل مَعلمة
  • Test Lab: تنشيط الدوالّ عند تنشيط Test Lab لتنبيه

مشغِّلات خدمة Google Cloud

يمكن أن تتضمّن الإضافة أيضًا وظائف تؤدي إلى تنشيط العديد من خدمات Google Cloud التي لا تنتمي إلى Firebase:

  • Cloud Pub/Sub: يمكن أن تتضمّن الإضافة وظائف يتم تفعيلها عند posted events to a configurable Pub/Sub topic.
  • Cloud Scheduler: يمكن أن تتضمن الإضافة وظائف تعمل على مجموعة الجدول الزمني
  • Cloud Tasks: يمكن أن تتضمّن الإضافة دوال يمكن وضعها في قائمة الانتظار باستخدام Cloud Tasks. تستخدِم "إضافات Firebase" هذه الميزة للسماح لك، بصفتك مؤلفًا للإضافة، بكتابة دوالّ تستجيب لأحداث "رحلة المستخدِم" للإضافة: التثبيت في مشروع للمرة الأولى والترقية إلى إصدار جديد وإعادة الضبط.
  • Eventarc: يمكن أن تتضمّن الإضافة وظائف يتم تفعيلها عند نشر الأحداث في قناة Eventarc قابلة للضبط. وفي المقابل، يمكن للإضافة نشر أحداثها الخاصة في قناة Eventarc لتتمكّن من منح المستخدمين إمكانية تحديد وظائفهم الخاصة التي يتم تفعيلها من أحداث الإضافة.

الوظائف المتوافقة

بعد تشغيل وظيفة السحابة الإلكترونية للإضافة، يكون النطاق وعمليات الدمج مفتوحة بشكل عام. في ما يلي بعض أبرز ما يمكنك تنفيذه يمكنك القيام به من دالة السحابة:

  • قراءة المحتوى والكتابة إليه والتفاعل معه بأي طريقة أخرى من خلال Firebase أو Google Cloud خدمة تستخدم الدور المتوافق مع "إدارة الهوية وإمكانية الوصول"
  • يمكنك استخدام أي خدمة تابعة لجهة خارجية توفِّر واجهة برمجة تطبيقات للويب.
  • يمكنك استخدام خدماتك المخصَّصة إذا كنت توفّر واجهة برمجة تطبيقات Web API.
  • تشغيل معظم مكتبات JavaScript، بما في ذلك TensorFlow.js وExpress.js وغيرها

كيفية إنشاء إضافة

يرشدك الدليل التعليمي البدء خلال عملية إنشاء إضافة كاملة واختبارها ونشرها، وهو الطريقة المُقترَحة للتعرّف على كيفية إنشاء إضافة.

البدء

بعد الاطّلاع على دليل البدء مرة واحدة، يمكنك الرجوع إلى أدلة المواضيع الفردية التي توضّح كل مهمة من المهام المعنيّة بإنشاء إضافة خاصة بك: