قابلیت های کلیدی

زمان صرف شده برای توسعه، نگهداری و رشد را کاهش دهید	از آنجایی که یک برنامه افزودنی یک راه حل بسته بندی شده است، تنها کاری که انجام می دهید نصب و پیکربندی برنامه افزودنی است. با برنامه‌های افزودنی، زمانی را صرف تحقیق، نوشتن و اشکال‌زدایی کدی نمی‌کنید که عملکردی را پیاده‌سازی می‌کند یا یک کار را برای برنامه یا پروژه شما خودکار می‌کند. مجموعه افزونه های رسمی Firebase را کاوش کنید تا راه حل هایی برای برنامه یا پروژه خود بیابید.
ساخته شده تا قابل تنظیم و استفاده مجدد باشد	هر نمونه نصب شده از یک برنامه افزودنی منحصر به فرد است. شما مقادیر پیکربندی را برای برنامه افزودنی مشخص می‌کنید که برای برنامه، پروژه یا مورد استفاده شما منحصر به فرد است. بسته به کاری که افزونه انجام می دهد، این مقادیر می توانند تقریباً هر چیزی باشند: یک مسیر Cloud Firestore، ابعاد تصویر یا یک URL GitHub. می‌توانید از یک پسوند در پروژه‌های مختلف دوباره استفاده کنید. حتی می توانید چندین نمونه از یک برنامه افزودنی را در یک پروژه نصب کنید. هر نمونه نصب شده می تواند پیکربندی سفارشی خود را داشته باشد.
پلت فرم Firebase را یکپارچه می کند	برنامه های افزودنی می توانند آن قطعه گمشده معماری موجود شما را پر کنند. برنامه‌های افزودنی می‌توانند به رویدادهای تولید شده توسط محصولات Firebase که قبلاً در برنامه خود استفاده می‌کنید پاسخ دهند. تغییر در یک محصول Firebase می تواند یک برنامه افزودنی را برای انجام وظیفه خود تحریک کند، حتی یک کار با استفاده از محصول دیگر. به عنوان مثال، نوشتن یک پایگاه داده بیدرنگ می‌تواند باعث ارسال یک اعلان جدید Firebase Cloud Messaging شود. یک برنامه افزودنی همچنین می‌تواند پروژه Firebase شما را با سایر محصولات Google Cloud Platform (مانند BigQuery و Google Translate) یا حتی خدمات شخص ثالث (مانند Mailchimp و Bit.ly) یکپارچه کند. و رویدادهای راه‌اندازی به رویدادهای Firebase محدود نمی‌شوند. حتی می توانید یک برنامه افزودنی را مستقیماً با درخواست HTTPS یا در یک بازه زمانی برنامه ریزی شده راه اندازی کنید.
امنیت و دسترسی محدود	منطق برنامه برای برنامه‌های افزودنی با استفاده از توابع Google Cloud در پشتیبان اجرا می‌شود، بنابراین کد به طور کامل از مشتری جدا می‌شود. همچنین، خود برنامه‌های افزودنی از بقیه پروژه‌های شما جدا هستند، زیرا به یک برنامه افزودنی نصب‌شده دسترسی محدودی به منابع و داده‌هایی داده می‌شود که به وضوح قبل از نصب فهرست شده‌اند.
تعمیر و نگهداری صفر	یک برنامه افزودنی برای پروژه Firebase خود نصب و پیکربندی کنید. پس از آن، باطن به طور خودکار منابع محاسباتی را برای مطابقت با نیازهای برنامه افزودنی شما افزایش و کاهش می دهد. شما هرگز نگران اعتبارنامه ها، پیکربندی سرور، تهیه سرورهای جدید یا از کار انداختن سرورهای قدیمی نیستید.

چگونه کار می کند؟

در هسته خود، یک افزونه Firebase کدی است که هر زمان که یک رویداد مشخص در برنامه یا پروژه شما رخ دهد ، یک کار را انجام می دهد.

منطق یک برنامه افزودنی با استفاده از Cloud Functions برای Firebase نوشته شده است. توابع موجود در یک برنامه افزودنی، ارائه دهندگان رویداد و شرایطی را که اجرا را آغاز می کنند، تعریف می کنند (به عنوان مثال، نوشتن Cloud Firestore، درخواست HTTPS، یا رویداد Cloud Scheduler).

حتی اگر برنامه‌های افزودنی از توابع استفاده می‌کنند، یک ویژگی کلیدی تمایز بین برنامه‌های افزودنی و توابع این است که یک برنامه افزودنی به یک فایل مشخصات extension.yaml متکی است که به صراحت تعریف می‌کند:

• سرویس‌های Google (API) که افزونه از آنها استفاده خواهد کرد
• نقش‌های دسترسی که برنامه افزودنی برای اجرا به آن نیاز دارد
• منابع ویژه برنامه افزودنی که برنامه افزودنی برای کار کردن به آنها نیاز دارد
• پارامترهای قابل تنظیم برای برنامه افزودنی

شما می توانید یک برنامه افزودنی را چندین بار در یک پروژه نصب کنید که هر نمونه نصب شده دارای پیکربندی متفاوتی است.

هنگامی که یک نمونه از یک برنامه افزودنی را نصب می کنید، Firebase کارهای زیر را انجام می دهد:

1. از شما می خواهد که مقادیر (پارامترهای) پیکربندی مورد نیاز را برای استفاده برای این نمونه از برنامه افزودنی مشخص کنید.
2. API های فهرست شده از فایل extension.yaml را برای پروژه فعال می کند.
3. یک حساب سرویس جدید برای استفاده توسط این نمونه از برنامه افزودنی ایجاد می کند و نقش های دسترسی فهرست شده را به آن اختصاص می دهد. نمونه برنامه افزودنی کد خود را با استفاده از دسترسی اعطا شده به این حساب سرویس اجرا می کند.
4. منابع فهرست شده را برای نمونه برنامه افزودنی (به عنوان مثال، یک تابع) فراهم می کند.

توجه داشته باشید که هر نمونه نصب شده از یک برنامه افزودنی دارای حساب سرویس و منابع جداگانه ای است.

علاوه بر فایل extension.yaml ، دایرکتوری افزونه شامل فایل‌های آموزشی نیز می‌شود، مانند README ، که حاوی اطلاعاتی است که به شما کمک می‌کند تا کارهای پیکربندی بیشتر را تکمیل کنید یا به طور کلی از پسوند استفاده کنید.

پس از نصب، می توانید یک برنامه افزودنی را مجدداً پیکربندی کنید (مقادیر پارامتر جدید را مشخص کنید) و همچنین یک برنامه افزودنی را به نسخه جدیدتر به روز کنید. همچنین می‌توانید در هر زمانی یک برنامه افزودنی را از پروژه خود حذف نصب کنید.

هم Firebase CLI و هم کنسول Firebase به شما امکان نصب، مشاهده و مدیریت برنامه های افزودنی را می دهند.

مسیر پیاده سازی

	یک پسوند پیدا کنید	مجموعه افزونه های رسمی Firebase را در صفحه محصول Firebase Extensions کاوش کنید.
	یک برنامه افزودنی را ارزیابی، نصب و پیکربندی کنید	وقتی افزونه‌ای را پیدا می‌کنید که نیازی را در برنامه یا پروژه شما برطرف می‌کند، می‌توانید برنامه افزودنی را با شبیه‌ساز برنامه‌های افزودنی ارزیابی کنید، سپس آن را از طریق کنسول Firebase یا Firebase CLI نصب کنید. برنامه افزودنی را طوری پیکربندی کنید که برای برنامه یا پروژه شما سفارشی شود.
	پسوند را مدیریت کنید	برنامه افزودنی نصب شده را با استفاده از کنسول Firebase یا Firebase CLI مشاهده و مدیریت کنید.

مراحل بعدی

• مجموعه افزونه های رسمی Firebase را در صفحه محصول Firebase Extensions کاوش کنید.

• با استفاده از کنسول Firebase یا Firebase CLI یک برنامه افزودنی را در پروژه خود نصب کنید.