یک افزونه Firebase نصب کنید

می‌توانید هر یک از افزونه‌های رسمی Firebase را با استفاده از کنسول Firebase یا Firebase CLI (واسط خط فرمان) نصب کنید (و مدیریت کنید ).

مطمئن شوید که تفاوت‌های عملکردهای پشتیبانی‌شده برای Firebase CLI و کنسول Firebase را بررسی کرده‌اید.


برای نصب یا مدیریت برنامه‌های افزودنی، باید یکی از این نقش‌ها به شما اختصاص داده شود: مالک یا ویرایشگر یا مدیر Firebase .

برای نصب افزونه، پروژه شما باید در طرح Blaze (پرداخت در حین حرکت) باشد. اگرچه هزینه ای برای نصب برنامه افزودنی دریافت نمی شود، ممکن است برای استفاده از سرویس های Firebase یا سرویس های Cloud مانند Cloud Secret Manager هزینه ای دریافت کنید، اگر میزان استفاده شما از سطح رایگان سرویس ها بیشتر شود.

قبل از اینکه شروع کنی

اگر قبلاً این کار را نکرده اید، Firebase را به پروژه خود اضافه کنید و پروژه Firebase خود را به طرح Blaze (پرداخت در حین انجام کار) ارتقا دهید.

مرحله 1 : اطلاعات دقیق در مورد یک برنامه افزودنی را مشاهده کنید

این مرحله اختیاری است، اما به شدت توصیه می شود.

قبل از نصب افزونه Firebase، توصیه می‌کنیم اطلاعات دقیق مربوط به افزونه را بررسی کنید، از جمله:

  • نحوه عملکرد برنامه افزودنی، هرگونه کار پیش از نصب، و جزئیات مربوط به برنامه افزودنی
  • اطلاعات شناسایی عمومی و توضیحات
  • آیا وظایف برنامه افزودنی به حساب صورت‌حساب نیاز دارد
  • سرویس‌های Google (API) و به نقش‌های مورد نیاز برای عملیات دسترسی داشته باشید
  • منابع ایجاد شده برای برنامه افزودنی (مانند توابع)
  • توضیحات پارامترهای قابل تنظیم توسط کاربر

برای مشاهده اطلاعات دقیق یک برنامه افزودنی:

  1. افزونه های رسمی Firebase را در Extensions Hub مرور کنید.

  2. روی کارت افزونه کلیک کنید تا:

    • نمایش اطلاعات دقیق برای برنامه افزودنی.

    • پیوند کد منبع برنامه افزودنی را در مخزن منبع Firebase Extensions پیدا کنید.

      در فهرست برنامه افزودنی، می توانید این اطلاعات دقیق را در README مشاهده کنید.

مرحله 2 : یک افزونه نصب کنید

در طول فرآیند نصب، از شما خواسته می شود که مشخصات اولیه برنامه افزودنی (مانند API های فعال، منابع ایجاد شده، دسترسی اعطا شده و غیره) را بررسی کنید. از هر گونه الزامات صورت‌حساب به شما اطلاع داده می‌شود، و همچنین از شما خواسته می‌شود مقادیری را برای پارامترهای قابل تنظیم برنامه افزودنی مشخص کنید.

  1. افزونه های رسمی Firebase را در Extensions Hub مرور کنید.

  2. روی کارت یک برنامه افزودنی کلیک کنید، سپس اطلاعات دقیق برنامه افزودنی را بررسی کنید، که می‌تواند دستورالعمل‌های استفاده خاص و هر کار پیش از نصب را ارائه دهد.

  3. روی Install کلیک کنید، سپس دستورالعمل های روی صفحه را برای نصب برنامه افزودنی دنبال کنید.

مرحله 3 : راه اندازی پس از نصب را کامل کنید

برخی از برنامه‌های افزودنی دارای مراحل لازم یا اختیاری هستند که باید قبل از استفاده از آنها تکمیل کنید. این دستورالعمل‌ها را در صفحه جزئیات پس از نصب برنامه افزودنی خود در داشبورد افزونه‌های کنسول Firebase بیابید (پیوند خاص داشبورد پس از نصب در ترمینال نمایش داده می‌شود).

همچنین می‌توانید این دستورالعمل‌ها را در فایل POSTINSTALL.md موجود در فهرست منبع برنامه افزودنی بیابید.

منابع Firebase را ایجاد کنید

اگر برنامه افزودنی را برای استفاده از منابع Firebase (مجموعه‌های Cloud Firestore، مسیرهای پایگاه داده بی‌درنگ، سطل‌های Cloud Storage) که قبلاً وجود ندارند، پیکربندی کرده‌اید، قبل از استفاده از برنامه افزودنی، آنها را ایجاد کنید.

کنترل کننده رویداد Eventarc را ایجاد کنید

برخی از برنامه‌های افزودنی زمانی که رویدادهای مهم در حین اجرا اتفاق می‌افتند، در Eventarc منتشر می‌شوند. اگر یک برنامه افزودنی رویدادها را منتشر می کند و شما رویدادها را در حین نصب فعال کرده اید، می توانید توابعی بنویسید که با منطق سفارشی خود به این رویدادها واکنش نشان می دهند. این می تواند مفید باشد، به عنوان مثال، برای اطلاع دادن به کاربران هنگام تکمیل وظایف طولانی مدت، یا برای پس پردازش خروجی یک تابع برنامه افزودنی.

برای مشاهده فهرستی از رویدادها (در صورت وجود) که منتشر می کند، به مستندات برنامه افزودنی مراجعه کنید. برای مثال، انواع رویدادها را برای اجرای پرداخت‌ها با برنامه افزودنی Stripe ببینید.

سپس، برای اطلاعات در مورد نوشتن کنترل کننده رویداد Eventarc، به محرک های رویداد سفارشی مراجعه کنید.

چند نمونه برنامه افزودنی را نصب کنید

شما می توانید یک افزونه را بیش از یک بار در همان پروژه نصب کنید. هر نمونه نصب شده می تواند پیکربندی سفارشی شده و منابع برنامه افزودنی خود را داشته باشد. شما هر نمونه نصب شده را با استفاده از شناسه نمونه آن شناسایی کرده و به آن ارجاع می دهید که در پروژه شما منحصر به فرد است. از شما خواسته می شود شناسه نمونه هر نمونه اضافی از برنامه افزودنی را که نصب می کنید تأیید یا ویرایش کنید.

مراحل بعدی