تثبيت إضافة Firebase

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

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



لتثبيت الإضافات أو إدارتها، يجب أن يكون لديك أحد الأدوار التالية: المالك أو المحرِّر أو مشرف Firebase

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

قبل البدء

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

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

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

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

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

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

  1. يمكنك تصفّح إضافات Firebase الرسمية في Extensions Hub.

  2. انقر على بطاقة إحدى الإضافات لإجراء ما يلي:

    • يمكنك عرض المعلومات التفصيلية عن الإضافة.

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

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

الخطوة 2: تثبيت إضافة

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

  1. يمكنك تصفّح إضافات Firebase الرسمية في Extensions Hub.

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

  3. انقر على تثبيت، ثم اتّبِع التعليمات الظاهرة على الشاشة للتثبيت. الإضافة.

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

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

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

إنشاء موارد Firebase

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

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

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

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

وبعد ذلك، اطّلِع على عوامل تشغيل الأحداث المخصّصة من أجل معلومات حول كتابة معالِجات أحداث Eventarc.

تثبيت مثيلات إضافات متعددة

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

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