התקן תוסף Firebase

אתה יכול להתקין ( ולנהל ) כל אחד מהתוספים הרשמיים של Firebase באמצעות מסוף Firebase או Firebase CLI (ממשק שורת פקודה).

הקפד לסקור את ההבדלים בפעולות הנתמכות עבור Firebase CLI ומסוף Firebase.


כדי להתקין או לנהל תוספים, יש להקצות לך אחד מהתפקידים הבאים: בעלים או עורך או Firebase Admin .

כדי להתקין הרחבה, הפרויקט שלך חייב להיות בתוכנית Blaze (שלם כפי שאתה הולך). למרות שאין תשלום עבור התקנת תוסף, ייתכן שתחויב עבור השימוש שלך בשירותי Firebase או בשירותי ענן כגון Cloud Secret Manager , אם השימוש שלך חורג מהרמה החינמית של השירותים.

לפני שאתה מתחיל

  1. אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט שלך .

  2. אם עדיין לא עשית זאת, שדרג את הפרויקט שלך לתוכנית Blaze (שלם כפי שאתה הולך).

  3. התקן או עדכן לגרסה העדכנית ביותר של Firebase CLI.

  4. שים לב למזהה הפרויקט שלך ב-Firebase או לכינוי הפרויקט שהוגדר בעבר.

שלב 1 : הצג מידע מפורט על הרחבה

שלב זה הוא אופציונלי, אך מומלץ בחום.

לפני התקנת תוסף Firebase, אנו ממליצים שתעיין במידע מפורט על התוסף, כולל:

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

כדי להציג מידע מפורט של תוסף:

  1. ודא שהגדרת את הסביבה שלך ובחרת תוסף .

  2. הפעל את פקודת הרחבה-מידע מכל מקום במחשב שלך:

    firebase ext:info publisher-id/extension-id

    הארגומנטים publisher-id ומזהה extension-id נדרשים וניתן למצוא אותם בדף פרטי ההתקנה מראש של התוסף .

שלב 2 : התקן תוסף

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

  1. ודא שהגדרת את הסביבה שלך ובחרת תוסף .

  2. מספריית Firebase המקומית שלך, הפעל את הפקודה extension-install. אם תתבקש, הזן ערכי פרמטר כדי להתאים אישית את מופע ההרחבה.

    firebase ext:install publisher-id/extension-id --project=projectId-or-alias

    הארגומנטים publisher-id ומזהה extension-id נדרשים וניתן למצוא אותם בדף פרטי ההתקנה מראש של התוסף .

    הפעלת פקודה זו מוסיפה מופע הרחבה למניפסט ההרחבות שלך.

  3. לאחר מכן, כדי לפרוס את ההרחבות במניפסט שלך בפרויקט Firebase, הרץ:

    firebase deploy --only extensions --project=projectId-or-alias

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

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

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

צור משאבי Firebase

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

צור מטפלי אירועים של Eventarc

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

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

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

התקן מופעי הרחבות מרובים

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

הצעדים הבאים

  • הצג את הפרטים ואת התצורה של התוסף המותקן שלך במסוף Firebase.

  • עקוב אחר הפעילות של התוסף המותקן שלך, כולל בדיקות של תקינותו, השימוש והיומנים שלו.

  • באמצעות Firebase CLI, נהל את התוסף המותקן שלך. אתה יכול להגדיר מחדש או להסיר את ההתקנה של התוסף שלך, כמו גם לעדכן את התוסף שלך לגרסה העדכנית ביותר.

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

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