قم بتثبيت ملحق Firebase

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

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


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

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

قبل ان تبدأ

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

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

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

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

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

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

  1. تصفح ملحقات Firebase الرسمية في مركز الإضافات .

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

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

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

  1. تصفح ملحقات Firebase الرسمية في مركز الإضافات .

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

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

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

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

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

إنشاء موارد Firebase

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

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

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

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

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

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

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

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

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

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

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

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