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