Check out what’s new from Firebase at Google I/O 2022. Learn more

ثبِّت ملحق Firebase

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

تأكد من مراجعة الاختلافات في الإجراءات المدعومة لوحدة تحكم Firebase CLI و Firebase.


لتثبيت الإضافات أو إدارتها ، يجب أن يتم تعيين أحد هذه الأدوار لك: المالك أو المحرر أو مسؤول Firebase .

لتثبيت ملحق ، يجب أن يكون مشروعك على خطة Blaze (الدفع الفوري). على الرغم من عدم وجود رسوم لتثبيت امتداد ، فقد يتم تحصيل رسوم منك مقابل استخدام خدمات Firebase أو الخدمات السحابية مثل [Cloud Secret Manager] [Secret-pricing] ، إذا تجاوز استخدامك المستوى المجاني للخدمات.

قبل ان تبدأ

إذا لم تكن قد قمت بذلك بالفعل ، فأضف Firebase إلى مشروعك وقم بترقية مشروع Firebase إلى خطة Blaze (الدفع الفوري).

الخطوة 1 : عرض معلومات مفصلة حول الامتداد

هذه الخطوة اختيارية ، لكنها موصى بها بشدة.

قبل تثبيت إضافة Firebase ، نوصيك بمراجعة المعلومات التفصيلية حول الامتداد ، بما في ذلك:

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

لعرض المعلومات التفصيلية للإضافة:

  1. تصفح ملحقات Firebase الرسمية من المصادر التالية:

  2. انقر فوق بطاقة ملحق من أجل:

    • اعرض المعلومات التفصيلية للامتداد.

    • ابحث عن رابط رمز مصدر الإضافة في مستودع مصدر Firebase Extensions .

      في دليل امتداد الامتداد ، يمكنك عرض هذه المعلومات التفصيلية في الملف README .

الخطوة 2 : قم بتثبيت ملحق

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

  1. تصفح ملحقات Firebase الرسمية من المصادر التالية:

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

  3. انقر فوق تثبيت ، ثم اتبع التعليمات التي تظهر على الشاشة لتثبيت الامتداد.

الخطوة 3 : إكمال الإعداد بعد التثبيت

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

يمكنك أيضًا العثور على هذه التعليمات في ملف POSTINSTALL.md المضمن في دليل مصدر الامتداد .

أنشئ موارد Firebase

إذا قمت بتكوين الامتداد لاستخدام موارد Firebase (مجموعات Cloud Firestore ، ومسارات قاعدة بيانات Realtime ، وحاويات التخزين السحابي) غير الموجودة بالفعل ، فقم بإنشائها قبل استخدام الامتداد.

إنشاء معالجات الأحداث Eventarc

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

راجع وثائق الإضافة للحصول على قائمة بالأحداث (إن وجدت) التي تنشرها.

بعد ذلك ، راجع مشغلات الأحداث المخصصة للحصول على معلومات حول كتابة معالجات أحداث Eventarc.

تثبيت مثيلات تمديد متعددة

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

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

  • اعرض التفاصيل وتكوين الإضافة المثبتة في وحدة تحكم Firebase.

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

  • باستخدام وحدة تحكم Firebase ، قم بإدارة الإضافة المثبتة. بالنسبة إلى ملحقات Firebase الرسمية ، يمكنك إعادة تكوين الإضافة أو إلغاء تثبيتها ، وكذلك تحديث الإضافة إلى أحدث إصدار.

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