می‌توانید هر یک از برنامه‌های افزودنی رسمی Firebase را با استفاده از کنسول Firebase ، Firebase CLI (واسط خط فرمان) یا با استفاده از یک SDK خود تولید شده نصب کنید (و مدیریت کنید ).
اطمینان حاصل کنید که تفاوت در اقدامات پشتیبانی شده برای هر روش نصب را بررسی کنید.
برای نصب یا مدیریت برنامه‌های افزودنی، باید یکی از این نقش‌ها به شما اختصاص داده شود: مالک یا ویرایشگر یا مدیر Firebase .
برای نصب افزونه، پروژه شما باید در طرح Blaze (پرداخت در حین حرکت) باشد. اگرچه هزینه ای برای نصب برنامه افزودنی دریافت نمی شود، ممکن است برای استفاده از سرویس های Firebase یا سرویس های Cloud مانند Cloud Secret Manager هزینه ای دریافت کنید، اگر میزان استفاده شما از سطح رایگان سرویس ها بیشتر شود.
قبل از شروع
اگر قبلاً این کار را نکرده اید، Firebase را به پروژه خود اضافه کنید و پروژه Firebase خود را به طرح Blaze (پرداخت در حین انجام کار) ارتقا دهید.
مرحله 1 : اطلاعات دقیق در مورد یک برنامه افزودنی را مشاهده کنید
این مرحله اختیاری است، اما به شدت توصیه می شود.
قبل از نصب Firebase Extension ، توصیه می‌کنیم اطلاعات دقیق مربوط به افزونه را مرور کنید، از جمله:
- نحوه عملکرد برنامه افزودنی، هرگونه کار پیش از نصب، و جزئیات مربوط به برنامه افزودنی
- اطلاعات شناسایی عمومی و توضیحات
- آیا وظایف برنامه افزودنی به حساب صورتحساب نیاز دارد
- سرویس‌های Google (API) و به نقش‌های مورد نیاز برای عملیات دسترسی داشته باشید
- منابع ایجاد شده برای برنامه افزودنی (مانند توابع)
- توضیحات پارامترهای قابل تنظیم توسط کاربر
برای مشاهده اطلاعات دقیق یک برنامه افزودنی:
افزونه های رسمی Firebase را در Extensions Hub مرور کنید.
روی کارت افزونه کلیک کنید تا:
نمایش اطلاعات دقیق برای برنامه افزودنی.
پیوند کد منبع برنامه افزودنی را در مخزن منبع Firebase Extensions پیدا کنید.
در فهرست برنامه افزودنی ، می توانید این اطلاعات دقیق را در
READMEمشاهده کنید.
مرحله 2 : یک افزونه نصب کنید
در طول فرآیند نصب، از شما خواسته می شود که مشخصات اولیه برنامه افزودنی (مانند API های فعال، منابع ایجاد شده، دسترسی اعطا شده و غیره) را بررسی کنید. از هر گونه الزامات صورتحساب به شما اطلاع داده می‌شود، و همچنین از شما خواسته می‌شود مقادیری را برای پارامترهای قابل تنظیم برنامه افزودنی مشخص کنید.
افزونه های رسمی Firebase را در Extensions Hub مرور کنید.
روی کارت یک برنامه افزودنی کلیک کنید، سپس اطلاعات دقیق برنامه افزودنی را بررسی کنید، که می‌تواند دستورالعمل‌های استفاده خاص و هر کار پیش از نصب را ارائه دهد.
روی Install کلیک کنید، سپس دستورالعمل های روی صفحه را برای نصب برنامه افزودنی دنبال کنید.
مرحله 3 : راه اندازی پس از نصب را کامل کنید
برخی از برنامه‌های افزودنی دارای مراحل لازم یا اختیاری هستند که باید قبل از استفاده از آنها تکمیل کنید. این دستورالعمل ها را در صفحه جزئیات پس از نصب برنامه افزودنی خود در داشبورد Extensions کنسول Firebase پیدا کنید (پیوند خاص داشبورد پس از نصب در ترمینال نمایش داده می شود).
همچنین می‌توانید این دستورالعمل‌ها را در فایل POSTINSTALL.md موجود در فهرست منبع برنامه افزودنی بیابید.
منابع Firebase را ایجاد کنید
اگر برنامه افزودنی را برای استفاده از منابع Firebase (مجموعه‌های Cloud Firestore ، مسیرهای Realtime Database ، سطل‌های Cloud Storage ) که از قبل وجود ندارند، پیکربندی کرده‌اید، قبل از استفاده از برنامه افزودنی، آنها را ایجاد کنید.
کنترل کننده رویداد Eventarc را ایجاد کنید
برخی از برنامه‌های افزودنی زمانی که رویدادهای مهم در حین اجرا اتفاق می‌افتند، در Eventarc منتشر می‌شوند. اگر یک برنامه افزودنی رویدادها را منتشر می کند، و شما رویدادها را در حین نصب فعال کرده اید، می توانید توابعی بنویسید که با منطق سفارشی خود به این رویدادها واکنش نشان می دهند. این می تواند مفید باشد، به عنوان مثال، برای اطلاع دادن به کاربران هنگام تکمیل وظایف طولانی مدت، یا برای پس پردازش خروجی یک تابع برنامه افزودنی.
برای مشاهده فهرستی از رویدادها (در صورت وجود) که منتشر می کند، به مستندات برنامه افزودنی مراجعه کنید. برای مثال، انواع رویدادها را برای اجرای پرداخت‌ها با برنامه افزودنی Stripe ببینید.
سپس، برای اطلاعات در مورد نوشتن کنترل کننده رویداد Eventarc، به محرک های رویداد سفارشی مراجعه کنید.
چند نمونه برنامه افزودنی را نصب کنید
شما می توانید یک افزونه را بیش از یک بار در همان پروژه نصب کنید. هر نمونه نصب شده می تواند پیکربندی سفارشی شده و منابع برنامه افزودنی خود را داشته باشد. شما هر نمونه نصب شده را با استفاده از شناسه نمونه آن شناسایی کرده و به آن ارجاع می دهید که در پروژه شما منحصر به فرد است.
از شما خواسته می شود شناسه نمونه هر نمونه اضافی از برنامه افزودنی را که نصب می کنید تأیید یا ویرایش کنید.
مراحل بعدی
جزئیات و پیکربندی افزونه نصب شده خود را در کنسول Firebase مشاهده کنید.
فعالیت برنامه افزودنی نصب شده خود، از جمله بررسی سلامت، استفاده و گزارش‌های آن را نظارت کنید .
با استفاده از کنسول Firebase ، برنامه افزودنی نصب شده خود را مدیریت کنید . برای افزونه‌های رسمی Firebase ، می‌توانید برنامه افزودنی خود را مجدداً پیکربندی یا حذف نصب کنید، و همچنین برنامه افزودنی خود را به آخرین نسخه به‌روزرسانی کنید.
به عنوان بهترین روش برای همه پروژه ها، مطمئن شوید که هشدارهای بودجه را برای پروژه خود تنظیم کرده اید و داشبورد استفاده و صورتحساب خود را در کنسول Firebase نظارت کنید.