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

התקנה של כמה מופעים של תוסף

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

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

השלבים הבאים