מתקינים תוסף ל-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. לוחצים על התקנה ופועלים לפי ההוראות במסך כדי להתקין את התוסף.

שלב 3: השלמת ההגדרה לאחר ההתקנה

בחלק מהתוספים יש שלבים חובה או אופציונליים שצריך לבצע לפני שמשתמשים בהם. ההוראות האלה מופיעות בדף הפרטים של התוסף אחרי ההתקנה במרכז הבקרה Extensions במסוף Firebase (הקישור הספציפי למרכז הבקרה מוצג במסוף אחרי ההתקנה).

אפשר למצוא את ההוראות האלה גם בקובץ POSTINSTALL.md שכלול בתיקיית המקור של התוסף.

יצירת משאבים ב-Firebase

אם הגדרתם את התוסף כך שישתמש במשאבים של Firebase (Cloud Firestore אוספים, Realtime Database נתיבים, Cloud Storage קטגוריות) שעדיין לא קיימים, צריך ליצור אותם לפני שמשתמשים בתוסף.

יצירת גורמים שמטפלים באירועים ב-Eventarc

חלק מהתוספים מפרסמים ב-Eventarc כשאירועים חשובים מתרחשים במהלך הביצוע. אם תוסף מפרסם אירועים והפעלתם את האירועים במהלך ההתקנה, תוכלו לכתוב פונקציות שיגיבו לאירועים האלה באמצעות לוגיקה מותאמת אישית משלכם. אפשר להשתמש באפשרות הזו, למשל, כדי להודיע למשתמשים כשמשימות ממושכות מסתיימות, או כדי לעבד את הפלט של פונקציית תוסף לאחר מכן.

במסמכי התיעוד של התוסף מופיעה רשימה של האירועים (אם יש כאלה) שהוא מפרסם. לדוגמה, סוגי האירועים של התוסף Run Payments with Stripe.

לאחר מכן, אפשר לעיין במאמר טריגרים של אירועים מותאמים אישית כדי לקבל מידע על כתיבת פונקציות טיפול באירועים ב-Eventarc.

התקנה של כמה מכונות של תוסף

אפשר להתקין את אותו תוסף יותר מפעם אחת באותו פרויקט. לכל מכונה מותקנת יכולה להיות הגדרה מותאמת אישית משלה ומשאבי תוספים משלה. כל מכונה מותקנת מזוהה באמצעות מזהה המכונה שלה, שהוא ייחודי בפרויקט.

תוצג בקשה לאשר או לערוך את מזהה המכונה של כל מכונה נוספת של התוסף שתתקינו.

השלבים הבאים