لتثبيت إضافة، يجب أن يكون مشروعك ضمن خطة Blaze (الدفع حسب الاستخدام). على الرغم من عدم فرض رسوم على تثبيت إضافة، قد يتم تحصيل رسوم منك مقابل استخدام خدمات Firebase أو خدمات السحابة الإلكترونية، مثل Cloud Secret Manager، إذا تجاوز استخدامك الحد المسموح به في المستوى المجاني للخدمات.
قبل البدء
أضِف Firebase إلى مشروعك، في حال لم يسبق لك إجراء ذلك، ثم رقِّ مشروعك على Firebase إلى خطة Blaze (الدفع حسب الاستخدام).
الخطوة 1: عرض معلومات تفصيلية عن إحدى الإضافات
هذه الخطوة اختيارية، ولكن ننصح بها بشدة.
قبل تثبيت Firebase Extension، ننصحك بمراجعة معلومات تفصيلية حول الإضافة، بما في ذلك:
طريقة عمل الإضافة وأي مهام يجب تنفيذها قبل التثبيت وتفاصيل حول الإضافة
معلومات التعريف العامة والوصف
ما إذا كانت مهام الإضافة تتطلّب حساب فوترة
خدمات Google (واجهات برمجة التطبيقات) وأدوار الوصول المطلوبة للتشغيل
في دليل الإضافات الخاص بالإضافة،
يمكنك الاطّلاع على هذه المعلومات التفصيلية في README.
الخطوة 2: تثبيت إضافة
أثناء عملية التثبيت، سيُطلب منك مراجعة المواصفات الأساسية للإضافة (مثل واجهات برمجة التطبيقات المفعَّلة والموارد التي تم إنشاؤها وإذن الوصول الذي تم منحه وما إلى ذلك).
سيتم إعلامك بأي متطلبات للفوترة، وسيُطلب منك أيضًا تحديد قيم للمَعلمات القابلة للإعداد في الإضافة.
انقر على بطاقة إضافة، ثم راجِع المعلومات التفصيلية الخاصة بها، والتي يمكن أن تتضمّن تعليمات استخدام محدّدة وأي مهام يجب تنفيذها قبل التثبيت.
انقر على تثبيت، ثم اتّبِع التعليمات الظاهرة على الشاشة لتثبيت الإضافة.
الخطوة 3: إكمال عملية الإعداد بعد التثبيت
تتضمّن بعض الإضافات خطوات مطلوبة أو اختيارية يجب إكمالها قبل استخدامها. يمكنك العثور على هذه التعليمات في صفحة تفاصيل ما بعد التثبيت الخاصة بالإضافة في لوحة بيانات Extensions ضِمن وحدة تحكّم Firebase (يظهر الرابط المحدّد إلى لوحة البيانات في الجهاز بعد التثبيت).
يمكنك أيضًا العثور على هذه التعليمات في ملف POSTINSTALL.md المضمّن في دليل مصدر الإضافة.
إنشاء موارد Firebase
إذا أعددت الإضافة لاستخدام موارد Firebase (Cloud FirestoreمجموعاتRealtime Database ومساراتCloud Storage وحِزم) غير متوفّرة حاليًا، عليك إنشاؤها قبل استخدام الإضافة.
إنشاء معالِجات أحداث Eventarc
تنشر بعض الإضافات إلى Eventarc
عندما تحدث أحداث مهمة أثناء التنفيذ. إذا كانت إحدى الإضافات تنشر أحداثًا، وفعّلت الأحداث أثناء التثبيت، يمكنك كتابة دوال تتفاعل مع هذه الأحداث باستخدام منطق مخصّص. يمكن أن يكون ذلك مفيدًا، على سبيل المثال، لإعلام المستخدمين عند اكتمال المهام التي تستغرق وقتًا طويلاً، أو لمعالجة ناتج دالة إضافة.
بعد ذلك، اطّلِع على مشغّلات الأحداث المخصّصة للحصول على معلومات حول كتابة معالجات أحداث Eventarc.
تثبيت عدة مثيلات للإضافة
يمكنك تثبيت الإضافة نفسها أكثر من مرة في المشروع نفسه.
يمكن أن تتضمّن كل نسخة مثبّتة إعدادات مخصّصة وموارد إضافية خاصة بها. يمكنك تحديد كل مثيل مثبَّت والإشارة إليه باستخدام معرّف المثيل، وهو معرّف فريد ضمن مشروعك.
سيُطلب منك تأكيد أو تعديل معرّف كل نسخة إضافية من الإضافة التي تثبّتها.
مراقبة نشاط
الإضافة المثبَّتة، بما في ذلك عمليات التحقّق من سلامتها واستخدامها وسجلّاتها
استخدِم Firebase وحدة التحكّم
لإدارة الإضافة المثبَّتة. بالنسبة إلى إضافات Firebase الرسمية، يمكنك إعادة ضبط إعدادات الإضافة أو إلغاء تثبيتها، بالإضافة إلى تحديثها إلى أحدث إصدار.
تاريخ التعديل الأخير: 2025-09-06 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-06 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["\u003cbr /\u003e\n\nYou can install (and [manage](/docs/extensions/manage-installed-extensions)) any\nof the official Firebase extensions using either the Firebase console,\nthe [Firebase CLI](/docs/cli) (command-line interface), or using an\nautogenerated SDK.\n\nMake sure to review the\n[differences](/docs/extensions/overview-use-extensions#console-vs-cli) in the\nsupported actions for each installation method. \nFirebase console Firebase CLI Autogenerated SDK \n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\n| To try out a Firebase Extension for the first time, we recommend that you install the extension in a test or development project.\n\n\u003cbr /\u003e\n\nTo install or manage extensions, you must be assigned one of these roles:\n[Owner or Editor](/docs/projects/iam/roles-basic) or\n[Firebase Admin](/docs/projects/iam/roles-predefined-all-products).\n\nTo install an extension, your project must be on the **Blaze** (pay as you\ngo) plan. Although there is no charge for installing an extension, you might be\ncharged for your use of Firebase services or Cloud services such as\n[Cloud Secret Manager](https://cloud.google.com/secret-manager/pricing), if your usage exceeds the services' free\ntier.\n\nBefore you begin\n\nIf you haven't already, [add Firebase to your project](/docs/guides) and upgrade\nyour Firebase project to the **Blaze** (pay as you go) plan.\n\n**Step 1**: View detailed information about an extension\n\nThis step is optional, but strongly recommended.\n\nBefore installing a Firebase Extension, we recommend that you\nreview detailed information about the extension, including:\n\n- How the extension works, any pre-installation tasks, and details about the extension\n- General identifying information and description\n- Whether the extension's tasks require a billing account\n- Google services (APIs) and [access roles](/docs/extensions/permissions-granted-to-extension) required for operation\n- [Resources](/docs/extensions/overview-use-extensions#resources) created for the extension (like functions)\n- Descriptions of user-configurable parameters\n\n**To view an extension's detailed information:**\n\n1. Browse official Firebase extensions in the [Extensions Hub](https://extensions.dev/extensions).\n\n2. Click an extension's card to:\n\n - Display the detailed information for the extension.\n\n - Find the link to the extension's source code in the\n [Firebase Extensions source repository](https://github.com/firebase/extensions).\n\n In the extension's\n [*extension directory*](/docs/extensions/overview-use-extensions#view-source-code),\n you can view this detailed information in the `README`.\n\n**Step 2**: Install an extension\n\nDuring the installation process, you'll be prompted to review the basic\nspecifications for the extension (such as APIs enabled,\n[resources](/docs/extensions/overview-use-extensions#resources) created,\n[access](/docs/extensions/permissions-granted-to-extension) granted, etc.).\nYou'll be notified of any billing requirements, and you'll also be prompted to\nspecify values for the extension's configurable parameters.\n\n1. Browse official Firebase extensions in the [Extensions Hub](https://extensions.dev/extensions).\n\n2. Click an extension's card, then review the detailed information for the\n extension, which can offer specific usage instructions and any\n pre-installation tasks.\n\n3. Click **Install**, then follow the on-screen instructions to install\n the extension.\n\n | **Note:** Deploying and provisioning an extension may take the system 3-5 minutes.\n\n**Step 3**: Complete post-install setup\n\nSome extensions have required or optional steps for you to complete before using\nthem. Find these instructions in your extension's post-install details page in\nthe Extensions dashboard of the Firebase console (the specific link to\nthe dashboard is displayed in the terminal after installation).\n\nYou can also find these instructions in the `POSTINSTALL.md` file included in\nthe [extension's source directory](/docs/extensions/overview-use-extensions#view-source-code).\n\nCreate Firebase resources\n\nIf you configured the extension to use Firebase resources (Cloud Firestore\ncollections, Realtime Database paths, Cloud Storage buckets) that don't already exist,\ncreate them before using the extension.\n\nCreate Eventarc event handlers\n\nSome extensions publish to [Eventarc](https://cloud.google.com/eventarc)\nwhen important events happen during execution. If an extension publishes events,\nand you enabled events during installation, you can write functions that react\nto these events with your own custom logic. This can be useful, for example, to\nnotify users when long-running tasks complete, or to post-process the output of\nan extension function.\n\nSee the extension's documentation for a list of events (if any) it publishes.\nFor example, see the\n[event types for the Run Payments with Stripe extension](https://github.com/stripe/stripe-firebase-extensions/blob/98c97775d54fb0be4601864b74d2fe5ce24dab83/firestore-stripe-payments/extension.yaml).\n\nThen, see [Custom event triggers](/docs/functions/custom-events#handle-events) for\ninformation on writing Eventarc event handlers.\n| **Important:** Enabling events can result in charges if you exceed the free quota. See [Eventarc pricing](https://cloud.google.com/eventarc/pricing).\n\nInstall multiple extension instances\n\nYou can install the same extension more than once in the same project.\nEach installed instance can have its own customized configuration and its own\nextension resources. You identify and refer to each installed instance using its\n*instance ID*, which is unique within your project.\n\nYou'll\nbe prompted to confirm or edit the instance ID of each additional instance of\nthe extension you install.\n\nNext Steps\n\n- [View the details and the\n configuration](/docs/extensions/manage-installed-extensions?platform=console#view-details-installed-extension)\n of your installed extension in the Firebase console.\n\n- [Monitor the activity](/docs/extensions/manage-installed-extensions#monitor)\n of your installed extension, including checks on its health, usage, and logs.\n\n- Using the Firebase console,\n [manage](/docs/extensions/manage-installed-extensions?platform=console) your\n installed extension. For official Firebase extensions, you can reconfigure\n or uninstall your extension, as well as update your extension to the latest\n version.\n\n- As a best practice for all projects, make sure to set up\n [budget alerts](/docs/projects/billing/avoid-surprise-bills#set-up-budget-alert-emails)\n for your project and monitor your [*Usage and billing*\n dashboard](//console.firebase.google.com/project/_/usage)\n in the Firebase console."]]
