ثبِّت ملحق Firebase

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

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

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

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

قبل ان تبدأ

1. إذا لم تكن قد قمت بذلك بالفعل ، فأضف Firebase إلى مشروعك .

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

3. قم بتثبيت أو تحديث أحدث إصدار من Firebase CLI.

4. دوِّن إما معرّف مشروع Firebase أو الاسم المستعار للمشروع الذي تمت تهيئته مسبقًا.

   • معرف المشروع - تشغيل firebase projects:list من أي مكان على جهاز الكمبيوتر الخاص بك.
   • الاسم المستعار للمشروع - قم بتشغيل firebase use من دليل التطبيق المحلي.

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

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

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

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

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

1. تأكد من إعداد بيئتك وتحديد امتداد .

2. قم بتشغيل الأمر extension-info من أي مكان على جهاز الكمبيوتر الخاص بك:

   firebase ext:info publisher-id/extension-id

   وسيطات publisher-id extension-id مطلوبة ويمكن العثور عليها في صفحة تفاصيل التثبيت المسبق للإضافة .

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

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

1. تأكد من إعداد بيئتك وتحديد امتداد .

2. من دليل Firebase المحلي ، قم بتشغيل أمر تثبيت الإضافات. إذا طُلب منك ، أدخل قيم المعلمات لتخصيص مثيل الملحق.

   firebase ext:install publisher-id/extension-id --project=projectId-or-alias

   وسيطات publisher-id extension-id مطلوبة ويمكن العثور عليها في صفحة تفاصيل التثبيت المسبق للإضافة .

   يؤدي تشغيل هذا الأمر إلى إضافة مثيل ملحق لبيان ملحقاتك .

3. بعد ذلك ، لنشر الامتدادات في البيان الخاص بك على مشروع Firebase ، قم بتشغيل:

   firebase deploy --only extensions --project=projectId-or-alias

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

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

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

أنشئ موارد Firebase

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

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

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

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

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

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

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

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

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

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

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

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

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