אפשר להתקין (ולנהל) כל אחד מהתוספים הרשמיים של 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.
לוחצים על כרטיס של תוסף, ואז בודקים את המידע המפורט על התוסף. יכול להיות שיופיעו בו הוראות שימוש ספציפיות ומשימות שצריך לבצע לפני ההתקנה.
לוחצים על התקנה ופועלים לפי ההוראות במסך כדי להתקין את התוסף.
שלב 3: השלמת ההגדרה אחרי ההתקנה
יש תוספים שכוללים שלבים שצריך לבצע לפני שמשתמשים בהם, חלק מהשלבים הם חובה וחלקם אופציונליים. ההוראות האלה מופיעות בדף הפרטים אחרי ההתקנה של התוסף בלוח הבקרה Extensions של מסוף Firebase (הקישור הספציפי ללוח הבקרה מוצג במסוף אחרי ההתקנה).
אפשר למצוא את ההוראות האלה גם בקובץ POSTINSTALL.md
שנכלל בתיקיית המקור של התוסף.
יצירת משאבים ב-Firebase
אם הגדרתם את התוסף כך שישתמש במשאבי Firebase (Cloud Firestore אוספים, Realtime Database נתיבים, Cloud Storage מאגרי מידע) שלא קיימים עדיין, תצטרכו ליצור אותם לפני השימוש בתוסף.
יצירת גורמים שמטפלים באירועים ב-Eventarc
חלק מהתוספים מתפרסמים ב-Eventarc כשמתרחשים אירועים חשובים במהלך ההפעלה. אם תוסף מפרסם אירועים, והפעלתם את האירועים במהלך ההתקנה, תוכלו לכתוב פונקציות שמגיבות לאירועים האלה עם לוגיקה מותאמת אישית משלכם. לדוגמה, אפשר להשתמש בזה כדי להודיע למשתמשים כשמשימות ארוכות מסתיימות, או כדי לבצע עיבוד אחרי הפלט של פונקציית תוסף.
במסמכי התיעוד של התוסף מופיעה רשימה של האירועים שהוא מפרסם (אם יש כאלה). לדוגמה, אפשר לעיין בסוגי האירועים של התוסף Run Payments with Stripe.
אחר כך, כדאי לעיין במאמר טריגרים של אירועים מותאמים אישית כדי לקבל מידע על כתיבת מטפלי אירועים ב-Eventarc.
התקנה של כמה מופעים של תוסף
אפשר להתקין את אותה תוסף יותר מפעם אחת באותו פרויקט. לכל מופע מותקן יכולה להיות תצורה מותאמת אישית משלו ומשאבי תוספים משלו. כדי לזהות כל מופע מותקן ולהתייחס אליו, משתמשים במזהה המופע, שהוא ייחודי בפרויקט.
תוצג בקשה לאשר או לערוך את מזהה המופע של כל מופע נוסף של התוסף שמתקינים.
השלבים הבאים
אפשר לראות את הפרטים ואת ההגדרות של התוסף שהתקנתם במסוף Firebase.
מעקב אחרי הפעילות של התוסף שהתקנתם, כולל בדיקות של התקינות, השימוש והיומנים שלו.
באמצעות מסוף Firebase, אפשר לנהל את התוסף המותקן. בתוספים רשמיים של Firebase, אפשר להגדיר מחדש או להסיר את התוסף, וגם לעדכן אותו לגרסה האחרונה.
מומלץ להגדיר התראות על חריגה מהתקציב בפרויקט ולעקוב אחרי לוח הבקרה Usage and billing במסוף Firebase.