אפשר להתקין (ולנהל) את כל התוספים הרשמיים של Firebase באמצעות מסוף Firebase, Firebase CLI (ממשק שורת הפקודה) או באמצעות SDK שנוצר באופן אוטומטי.
חשוב לבדוק את ההבדלים בפעולות הנתמכות בכל שיטת התקנה.
כדי להתקין או לנהל תוספים, צריך להיות לכם אחד מהתפקידים הבאים: בעלים או עורך או אדמין ב-Firebase.
כדי להתקין תוסף, הפרויקט צריך להיות בתוכנית Blaze (תשלום לפי שימוש). התקנה של תוסף לא כרוכה בתשלום, אבל יכול להיות שתחויבו על השימוש בשירותי Firebase או בשירותי Cloud כמו Cloud Secret Manager, אם השימוש יחרוג מהשימוש שלכם בשירותים בחינם.
לפני שמתחילים
אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט ושדרגים את הפרויקט ב-Firebase לתוכנית Blaze (תשלום לפי שימוש).
שלב 1: הצגת מידע מפורט על תוסף
השלב הזה אופציונלי, אבל מומלץ מאוד.
לפני התקנת Firebase Extension, מומלץ לעיין במידע מפורט על התוסף, כולל:
- איך התוסף פועל, משימות שצריך לבצע לפני ההתקנה ופרטי התוסף
- תיאור ומידע כללי מזהים
- אם לצורך ביצוע המשימות של התוסף נדרש חשבון לחיוב
- שירותי Google (ממשקי API) ותפקידי גישה הנדרשים לפעולה
- משאבים שנוצרו עבור התוסף (כמו פונקציות)
- תיאורים של פרמטרים שניתנים להגדרה על ידי המשתמש
כדי לראות מידע מפורט של תוסף:
אפשר לעיין בתוספים הרשמיים של Firebase ב-Extensions Hub.
לוחצים על כרטיס של תוסף כדי:
להציג את המידע המפורט של התוסף.
מוצאים את הקישור לקוד המקור של התוסף במאגר המקור Firebase Extensions.
אפשר לראות את המידע המפורט הזה בקובץ
README
בספריית התוספים של התוסף.
שלב 2: מתקינים תוסף
במהלך תהליך ההתקנה, תתבקשו לבדוק את המפרטים הבסיסיים של התוסף (כמו ממשקי API שהופעלו, משאבים שנוצרו, גישה שהוענקה וכו'). תקבלו הודעה על דרישות החיוב, ותתבקשו לציין ערכים לפרמטרים שניתן להגדיר בתוסף.
אפשר לעיין בתוספים הרשמיים של Firebase ב-Extensions Hub.
לוחצים על הכרטיס של התוסף ומעיינים במידע המפורט עליו. יכול להיות שתמצאו בו הוראות שימוש ספציפיות ומשימות שצריך לבצע לפני ההתקנה.
לוחצים על Install (התקנה) ופועלים לפי ההוראות במסך כדי להתקין את התוסף.
שלב 3: השלמת ההגדרה לאחר ההתקנה
בחלק מהתוספים יש שלבים חובה או אופציונליים שצריך לבצע לפני שמשתמשים בהם. ההוראות האלה מופיעות בדף הפרטים של התוסף אחרי ההתקנה במרכז הבקרה Extensions במסוף Firebase (הקישור הספציפי למרכז הבקרה מוצג במסוף אחרי ההתקנה).
אפשר למצוא את ההוראות האלה גם בקובץ POSTINSTALL.md
שכלול בתיקיית המקור של התוסף.
יצירת משאבים ב-Firebase
אם הגדרתם את התוסף כך שישתמש במשאבים של Firebase (Cloud Firestore אוספים, Realtime Database נתיבים, Cloud Storage קטגוריות) שעדיין לא קיימים, צריך ליצור אותם לפני שמשתמשים בתוסף.
יצירת גורמים שמטפלים באירועים ב-Eventarc
תוספים מסוימים מפרסמים ב-Eventarc כשאירועים חשובים מתרחשים במהלך הביצוע. אם תוסף מפרסם אירועים והפעלתם את האירועים במהלך ההתקנה, תוכלו לכתוב פונקציות שיגיבו לאירועים האלה באמצעות לוגיקה מותאמת אישית משלכם. אפשר להשתמש באפשרות הזו, למשל, כדי להודיע למשתמשים כשמשימות ממושכות מסתיימות, או כדי לעבד את הפלט של פונקציית תוסף לאחר מכן.
במסמכי התיעוד של התוסף מופיעה רשימה של האירועים (אם יש כאלה) שהוא מפרסם. לדוגמה, סוגי האירועים של התוסף Run Payments with Stripe.
לאחר מכן, אפשר לעיין במאמר טריגרים של אירועים מותאמים אישית כדי לקבל מידע על כתיבת פונקציות טיפול באירועים ב-Eventarc.
התקנה של כמה מכונות של תוסף
אפשר להתקין את אותו תוסף יותר מפעם אחת באותו פרויקט. לכל מכונה מותקנת יכולים להיות הגדרות אישיות משלה ומשאבי תוספים משלה. כל מכונה מותקנת מזוהה באמצעות מזהה המכונה שלה, שהוא ייחודי בפרויקט.
תוצג בקשה לאשר או לערוך את מזהה המכונה של כל מכונה נוספת של התוסף שתתקינו.
השלבים הבאים
אפשר לראות את הפרטים ואת ההגדרות האישיות של התוסף שמותקן במסוף Firebase.
מעקב אחר הפעילות של התוסף המותקן, כולל בדיקות של התקינות, השימוש והיומנים שלו.
באמצעות מסוף Firebase, אפשר לנהל את התוסף שהותקן. בתוספים רשמיים של Firebase, תוכלו להגדיר מחדש או להסיר את התוסף, וגם לעדכן את התוסף לגרסה העדכנית.
מומלץ להגדיר התראות תקציב לכל הפרויקט ולעקוב אחרי לוח הבקרה 'שימוש וחיובים' במסוף Firebase.