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