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

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

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



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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

از شما خواسته می شود شناسه نمونه هر نمونه اضافی از برنامه افزودنی را که نصب می کنید تأیید یا ویرایش کنید.

مراحل بعدی

،

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

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



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

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

قبل از شروع

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

از شما خواسته می شود شناسه نمونه هر نمونه اضافی از برنامه افزودنی را که نصب می کنید تأیید یا ویرایش کنید.

مراحل بعدی

،

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

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



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

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

قبل از شروع

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

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

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

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

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

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

  1. پسوند رسمی Firebase را در Extensions Hub مرور کنید.

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

مرحله 2 : یک پسوند نصب کنید

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

  1. پسوند رسمی Firebase را در Extensions Hub مرور کنید.

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

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

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

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

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

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

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

ایجاد کننده رویداد EventArc را ایجاد کنید

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

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

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

چندین نمونه پسوند را نصب کنید

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

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

مراحل بعدی

،

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

حتماً تفاوتهای مربوط به اقدامات پشتیبانی شده را برای هر روش نصب بررسی کنید.



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

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

قبل از شروع

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

مرحله 1 : اطلاعات دقیق در مورد پسوند را مشاهده کنید

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

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

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

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

  1. پسوند رسمی Firebase را در Extensions Hub مرور کنید.

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

مرحله 2 : یک پسوند نصب کنید

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

  1. پسوند رسمی Firebase را در Extensions Hub مرور کنید.

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

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

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

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

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

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

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

ایجاد کننده رویداد EventArc را ایجاد کنید

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

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

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

چندین نمونه پسوند را نصب کنید

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

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

مراحل بعدی