يمكنك تثبيت ( وإدارة ) أي من ملحقات Firebase الرسمية باستخدام إما وحدة تحكم Firebase أو Firebase CLI (واجهة سطر الأوامر).
تأكد من مراجعة الاختلافات في الإجراءات المدعومة لوحدة تحكم Firebase CLI و Firebase.
لتثبيت الإضافات أو إدارتها ، يجب أن يتم تعيين أحد هذه الأدوار لك: المالك أو المحرر أو مسؤول Firebase .
لتثبيت ملحق ، يجب أن يكون مشروعك على خطة Blaze (الدفع الفوري). على الرغم من عدم وجود رسوم لتثبيت امتداد ، فقد يتم تحصيل رسوم منك مقابل استخدام خدمات Firebase أو الخدمات السحابية مثل Cloud Secret Manager ، إذا تجاوز استخدامك المستوى المجاني للخدمات.
قبل ان تبدأ
إذا لم تكن قد قمت بذلك بالفعل ، فأضف Firebase إلى مشروعك وقم بترقية مشروع Firebase إلى خطة Blaze (الدفع الفوري).
الخطوة 1 : عرض معلومات مفصلة حول الامتداد
هذه الخطوة اختيارية ، لكنها موصى بها بشدة.
قبل تثبيت إضافة Firebase ، نوصيك بمراجعة المعلومات التفصيلية حول الامتداد ، بما في ذلك:
- كيف يعمل الامتداد وأي مهام قبل التثبيت وتفاصيل حول الامتداد
- معلومات التعريف العامة والوصف
- ما إذا كانت مهام الإضافة تتطلب حساب فوترة أم لا
- خدمات Google (APIs) وأدوار الوصول المطلوبة للتشغيل
- الموارد التي تم إنشاؤها للملحق (مثل الوظائف)
- أوصاف المعلمات التي يمكن للمستخدم تكوينها
لعرض المعلومات التفصيلية للإضافة:
تصفح ملحقات Firebase الرسمية في مركز الإضافات .
انقر فوق بطاقة ملحق من أجل:
اعرض المعلومات التفصيلية للامتداد.
ابحث عن رابط رمز مصدر الإضافة في مستودع مصدر Firebase Extensions .
في دليل امتداد الامتداد ، يمكنك عرض هذه المعلومات التفصيلية في
README
.
الخطوة 2 : قم بتثبيت ملحق
أثناء عملية التثبيت ، ستتم مطالبتك بمراجعة المواصفات الأساسية للملحق (مثل تمكين واجهات برمجة التطبيقات ، والموارد التي تم إنشاؤها ، والوصول الممنوح ، وما إلى ذلك). سيتم إخطارك بأي متطلبات فوترة ، وسيُطلب منك أيضًا تحديد قيم المعلمات القابلة للتكوين للإضافة.
تصفح ملحقات Firebase الرسمية في مركز الإضافات .
انقر فوق بطاقة الامتداد ، ثم راجع المعلومات التفصيلية الخاصة بالامتداد ، والتي يمكنها تقديم إرشادات استخدام محددة وأي مهام قبل التثبيت.
انقر فوق تثبيت ، ثم اتبع التعليمات التي تظهر على الشاشة لتثبيت الامتداد.
الخطوة 3 : إكمال الإعداد بعد التثبيت
تتطلب بعض الإضافات خطوات اختيارية أو مطلوبة لإكمالها قبل استخدامها. ابحث عن هذه الإرشادات في صفحة تفاصيل ما بعد التثبيت الخاصة بإضافتك في لوحة معلومات الإضافات بوحدة تحكم Firebase (يتم عرض الرابط المحدد إلى لوحة التحكم في الجهاز بعد التثبيت).
يمكنك أيضًا العثور على هذه التعليمات في ملف POSTINSTALL.md
المضمن في دليل مصدر الامتداد .
أنشئ موارد Firebase
إذا قمت بتكوين الامتداد لاستخدام موارد Firebase (مجموعات Cloud Firestore ، ومسارات قاعدة بيانات Realtime ، وحاويات التخزين السحابي) غير الموجودة بالفعل ، فقم بإنشائها قبل استخدام الامتداد.
إنشاء معالجات الأحداث Eventarc
تنشر بعض الامتدادات على Eventarc عندما تحدث أحداث مهمة أثناء التنفيذ. إذا نشرت إحدى الإضافات أحداثًا وقمت بتمكين الأحداث أثناء التثبيت ، فيمكنك كتابة الوظائف التي تتفاعل مع هذه الأحداث بمنطقك المخصص. يمكن أن يكون هذا مفيدًا ، على سبيل المثال ، لإعلام المستخدمين عند اكتمال المهام التي تعمل لفترة طويلة ، أو لمعالجة ناتج وظيفة الامتداد لاحقًا.
راجع وثائق الإضافة للحصول على قائمة بالأحداث (إن وجدت) التي تنشرها. على سبيل المثال ، راجع أنواع الأحداث للامتداد Run Payments with Stripe .
بعد ذلك ، راجع مشغلات الأحداث المخصصة للحصول على معلومات حول كتابة معالجات أحداث Eventarc.
تثبيت مثيلات تمديد متعددة
يمكنك تثبيت نفس الامتداد أكثر من مرة في نفس المشروع. يمكن أن يكون لكل مثيل مثبت تكوينه المخصص وموارد الامتداد الخاصة به. يمكنك تحديد كل مثيل مثبت والإشارة إليه باستخدام معرف المثيل الخاص به ، والذي يعتبر فريدًا داخل مشروعك. سيُطلب منك تأكيد أو تعديل معرّف المثيل لكل مثيل إضافي للإضافة التي تثبتها.
الخطوات التالية
اعرض التفاصيل وتكوين الإضافة المثبتة في وحدة تحكم Firebase.
راقب نشاط الإضافة المثبتة ، بما في ذلك عمليات التحقق من صحتها واستخدامها وسجلاتها.
باستخدام وحدة تحكم Firebase ، قم بإدارة الإضافة المثبتة. بالنسبة إلى ملحقات Firebase الرسمية ، يمكنك إعادة تكوين الإضافة أو إلغاء تثبيتها ، وكذلك تحديث الإضافة إلى أحدث إصدار.
كأفضل ممارسة لجميع المشاريع ، تأكد من إعداد تنبيهات الميزانية لمشروعك ومراقبة لوحة معلومات الاستخدام والفوترة في وحدة تحكم Firebase.