Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

ثبِّت ملحق Firebase

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

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


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

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

قبل ان تبدأ

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

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

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

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

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

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

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

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

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

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

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

    firebase ext:info publisher-id/extension-id

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

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

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

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

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

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

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

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

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

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

    • إن أمكن ، ستخبرك هذه التعليمات بكيفية اختبار الامتداد الخاص بك (ابحث عن قسم شاهده في العمل ).

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

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

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

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

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

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