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

تؤدي إضافة Firebase مهمة محددة أو مجموعة من المهام استجابةً طلبات HTTP أو تشغيل الأحداث من منتجات Firebase وGoogle الأخرى، مثل خدمة "المراسلة عبر السحابة الإلكترونية من Firebase" أو Cloud Firestore أو "النشر/الاشتراك"

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

بنية الإضافة

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

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

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

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 في JavaScript. أو TypeScript. هذا هو الرمز الذي يؤدي مهام الإضافة في الاستجابة للأحداث التي تم تشغيلها من خلال Firebase وخدمات Google.
  • يتضمن ملف extension.yaml بيانات وصفية حول إضافتك، مثل مشغّلاته وأدوار وصول "إدارة الهوية وإمكانية الوصول" (IAM)، بالإضافة إلى أي مَعلمات تريد أن تكون قابل للتهيئة من خلال المستخدم.
  • إنّ الملفات PREINSTALL وPOSTINSTALL وCHANGELOG هي الحدّ الأدنى. الوثائق التي يجب أن تتوفر في الإضافة. تساعد هذه الملفات المستخدمين على معرفة ووظيفة الإضافة وكيفية استخدامها والتحديثات التي أجريتها. إِنْتَ أيضًا رمزًا لمساعدة المستخدمين في التعرّف على الإضافة. تشير رسالة الأشكال البيانية تعرض وحدة تحكم Firebase وواجهة سطر الأوامر في Firebase ومركز الإضافات محتوى هذه الملفات عند استكشاف المستخدمين لإضافتك وتثبيتها وإدارتها.

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

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

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

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

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

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

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

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

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

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

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

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

يمكن أن تتضمّن الإضافة أيضًا وظائف تؤدي إلى إيقاف العديد من التطبيقات غير التابعة لمنصة Firebase. خدمات Google Cloud:

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

متاحة من الدوال

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

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

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

يرشدك الدليل التعليمي البدء إلى الخطوات عملية إنشاء إضافة كاملة واختبارها ونشرها الطريقة الموصى بها لمعرفة كيفية إنشاء نظام.

البدء

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