Catch up on everthing we announced at this year's Firebase Summit. Learn more

נהל תוספות Firebase מותקנות

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

רשום מופעי הרחבה המותקנים של פרויקט

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

הפעל את הפקודה רשימת הרחבות:

firebase ext:list --project=projectId-or-alias

עקוב אחר מופע הרחבה מותקן

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

הגדר התראות תקציב

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

ודא שהגדרת התראות תקציב לפרויקט Firebase שלך.

הצג פונקציות שנוצרו על ידי הרחבות

  1. עבור אל שלך מחווני פונקציות של קונסולת Firebase.

  2. בלשונית Dashboard, אתה יכול להציג את הפונקציות מ Firebase Extensions (לצד כל פונקציות אחרות, כי אתה כבר פרוסים עבור הפרויקט שלך).

    פונקציות נוצרו על ידי רחבות יש שמות, בפורמט: ext- extension-instance-id - functionName

    לדוגמה: ext-awesome-task-simplifier-onUserCreate

הצג עבודות מתזמן ענן שנוצרו על ידי תוספים

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

  2. ברשימת המשרות, תוכל להציג את עבודות מתזמן הענן מתוספי Firebase (לצד כל עבודות אחרות שיצרת לפרויקט שלך).

    יש משרות שנוצרו על ידי הרחבות שמות בפורמט: firebase-ext- extension-instance-id - functionName

    לדוגמה: firebase-ext-awesome-task-simplifier-doTask

צפה בסודות מנהל הסוד של Cloud Secret שנוצרו על ידי הרחבות

  1. פתח של פרויקט מנהל סוד דף בקונסולת הענן של Google.

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

    סודות נוצר על ידי הרחבות יש שמות בפורמט: ext- extension-instance-id - paramnName

    לדוגמה: ext-awesome-task-simplifier-API_KEY

    סודות מסומנים עם מפתח firebase-extensions-managed . אל תסיר תווית זו אלא אם ברצונך לעצור את Firebase בניהול הסוד.

בדוק אם הרחבה המותקנת תקינה

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

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

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

בדוק באיזו תדירות פועל הרחבה מותקנת

  1. בלשונית Dashboard של שלך מחווני פונקציות , לאתר את הפונקציה הספציפית עבור רחבת Firebase שאתה רוצה לבדוק.

  2. לחץ (באפשרויות הנוספות) שנמצא בפינה השמאלית עליונה בצד של הכניסה, ולאחר מכן בחר את סטטיסטיקת שימוש מפורטת.

  3. במסוף הענן של Google המוצג, תוכל להתעמק בפניות שונות של פונקציה ואף לבדוק את קוד המקור שלה.

הצג את יומני ההרחבה

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

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

עדכן מופע של תוסף מותקן לגרסה העדכנית ביותר

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

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

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

  1. הפעל את הפקודה list-extensions כדי להשיג את מזהה המופע של התוסף:

    firebase ext:list --project=projectId-or-alias
  2. הפעל את הפקודה עדכון הרחבה:

    firebase ext:update extensionInstanceId --project=projectId-or-alias

הגדר מחדש את מופע ההרחבה המותקן

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

  1. הפעל את הפקודה list-extensions כדי להשיג את מזהה המופע של התוסף:

    firebase ext:list --project=projectId-or-alias
  2. הפעל את הפקודה configure configure:

    firebase ext:configure extensionInstanceId --project=projectId-or-alias --params=path/to/envFile

    איפה --params הוא דגל אופציונלי לספק קובץ שמגדיר את ערכי הפרמטרים תצורתם המשתמש ומאפשר לך לעקוף את ההנחיות מסוף אינטראקטיבי עבור ערכים אלה. גדר הערכית שלך .env קובץ שאחרי dotenv התחביר.

  3. אם אתה מתבקש לספק (או שאתה לא לספק .env קובץ), להזין ערכי תצורה כדי להתאים אישית את הסיומת עבור הפרויקט שלך.

הסר התקנת מופע הרחבה

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

  • כל ממצא שנוצר על ידי התוסף (כמו תמונות מאוחסנות).

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

להלן הסרת התקנת הרחבה:

  1. הפעל את הפקודה list-extensions כדי להשיג את מזהה המופע של התוסף:

    firebase ext:list --project=projectId-or-alias
  2. הפעל את הפקודה להסרת התקנה של הרחבה:

    firebase ext:uninstall extensionInstanceId --project=projectId-or-alias