מתקינים תוסף ל-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.

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

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

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

השלבים הבאים