Firebase Extension را نصب کنید

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

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

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

همچنین، برای نصب یک افزونه، پروژه خود را باید در فروغ شود (پرداخت به شما به) طرح. شما شارژ خواهد شد مقدار کمی ( به طور معمول حدود 0.01 $ / ماه ) برای منابع فایربیس مورد نیاز این پسوند (حتی اگر آن استفاده نمی شود)، علاوه بر هر گونه اتهام در ارتباط با استفاده از آن.

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

اگر شما در حال حاضر، اضافه فایربیس را به پروژه خود .
اگر شما در حال حاضر، ارتقاء پروژه خود را به آتش سوزان (پرداخت به شما به) طرح.
آخرین نسخه Firebase CLI را نصب یا به روز کنید.
به شناسه پروژه Firebase یا نام مستعار پروژه قبلی پیکربندی شده توجه کنید.
- پروژه ID - اجرای firebase projects:list از هر نقطه بر روی کامپیوتر شما.
- نام مستعار پروژه - اجرای firebase use از دایرکتوری برنامه محلی خود را.
توجه: برای نصب و مدیریت افزونهها با استفاده از دستورات CLI، شما نیاز به استفاده از --project پرچم و با تصویب در هر دو ID پروژه خود را و یا نام مستعار پروژه شما. حال، اگر شما در حال حاضر یک پروژه فایربیس مرتبط با دایرکتوری برنامه های محلی خود را، شما لازم نیست که به تصویب --project پرچم که در حال اجرا دستورات از دایرکتوری برنامه محلی خود را.

مرحله 1: نمایش اطلاعات در مورد فرمت جزئیات

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

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

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

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

اطمینان حاصل کنید که شما راه اندازی محیط زیست خود را و انتخاب فرمت .
دستور extension-info را از هر نقطه در رایانه خود اجرا کنید:
```
firebase ext:info publisher-id/extension-id
```
publisher-id و extension-id استدلال مورد نیاز است و می توان در یافت صفحه جزئیات preinstall افزونه .

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

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

اطمینان حاصل کنید که شما راه اندازی محیط زیست خود را و انتخاب فرمت .
دستور extension-install را اجرا کنید. در صورت درخواست ، مقادیر پارامتر را برای سفارشی سازی نمونه برنامه افزودنی وارد کنید.
```
firebase ext:install publisher-id/extension-id --project=projectId-or-alias
```
publisher-id و extension-id استدلال مورد نیاز است و می توان در یافت صفحه جزئیات preinstall افزونه .
توجه: با نصب و تأمین فرمت ممکن است سیستم 3-5 دقیقه طول می کشد.
در هنگام نصب دستورات ترمینال تعاملی را برای مقادیر پارامتر دور بزنید
1. درست .env فایل (برای مثال، params.env ) که مقادیر پارامتر خود را تعریف می کند. فایل را به صورت محلی ذخیره کنید.
  - اعلام هر پارامتر های آن param ارزش موجود در افزونه extension.yaml فایل .
  - شامل مقادیر همه پارامترها می شود.
  - دنبال dotenv نحو .
  به عنوان مثال، برای ترجمه پسوند متن ، شما می توانید این ایجاد .env فایل:
```
# params.env

LOCATION=us-east1
LANGUAGES=fr,es
COLLECTION_PATH=translations
INPUT_FIELD_NAME=input
OUTPUT_FIELD_NAME=output
```
2. اجرای دستور پسوند نصب با --params پرچم. برای مثال، برای نصب برنامه افزودنی متن ترجمه، دستور زیر را اجرا:
```
firebase ext:install firebase/firestore-translate-text --params=path/to/params.env --project=projectID-or-alias
```
پس از اتمام نصب ، دستورالعمل های استفاده از برنامه افزودنی خود را مرور کنید ، که ممکن است شامل برخی از کارهای مورد نیاز پس از نصب باشد.
- این دستورالعمل ها را در صفحه جزئیات پس از نصب برنامه افزودنی خود در داشبورد برنامه های افزودنی کنسول Firebase بیابید (پیوند خاص داشبورد پس از نصب در ترمینال نمایش داده می شود).
  شما همچنین می توانید این دستورالعمل در پیدا POSTINSTALL.md فایل های موجود در دایرکتوری منبع افزونه .
- در صورت امکان، این دستورالعمل را به شما خواهد گفت که چگونه به امتحان برنامه افزودنی خود را (برای دیدن آن در بخش عمل نگاه).

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

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

مراحل بعدی

مشاهده جزئیات و پیکربندی از فرمت های نصب شده خود را در کنسول فایربیس.
نظارت بر فعالیت از فرمت های نصب شده خود، از جمله چک در سلامت آن، استفاده، و سیاهههای مربوط.
با استفاده از فایربیس CLI، مدیریت افزونه نصب خود را. می توانید برنامه افزودنی خود را مجدداً پیکربندی یا حذف نصب کنید و همچنین برنامه افزودنی خود را به آخرین نسخه به روز کنید.
با استفاده از کنسول فایربیس، مدیریت افزونه نصب خود را. برای افزونه های رسمی Firebase ، می توانید برنامه افزودنی خود را مجدداً پیکربندی یا حذف نصب کنید و همچنین برنامه افزودنی خود را به آخرین نسخه به روز کنید.
به عنوان بهترین عمل برای تمام پروژه های، مطمئن شوید که به راه اندازی هشدار بودجه برای پروژه های شما و نظارت خود را استفاده و داشبورد صدور صورت حساب در کنسول فایربیس.