להבין פרויקטים של Firebase

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

קשר בין פרויקטים, אפליקציות ומוצרים של Firebase

פרויקט Firebase הוא הישות ברמה העליונה של Firebase. בפרויקט, אתה יוצר יישומי Firebase על ידי רישום יישומי Apple, Android או האינטרנט שלך. לאחר הרישום של אפליקציות באמצעות Firebase, אתה יכול להוסיף בערכות הפיתוח Firebase עבור כל מספר של מוצרים Firebase , כמו Analytics, ענן Firestore, ניטור ביצועים, או Config מרחוק.

למד מידע מפורט יותר לגבי התהליך הזה במדריכי תחילת העבודה ( פלטפורמות אפלות | אנדרואיד | אינטרנט | אחדות | C ++ ).

קשר בין פרויקטים של Firebase ל-Google Cloud

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

מאז פרויקט Firebase הוא פרויקט Google Cloud:

הגדרת פרויקט Firebase ורישום אפליקציות

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

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

שם הפרויקט

בעת יצירת פרויקט, אתה שם פרויקט. מזהה זהו השם פנימי בלבד עבור פרויקט של קונסולת Firebase , את Google Cloud Console , ואת Firebase CLI . שם הפרויקט אינו חשוף באף מוצר, שירות או משאב של Firebase או Google Cloud גלויים לציבור; זה פשוט עוזר לך להבחין בקלות רבה יותר בין מספר פרויקטים.

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

מספר הפרויקט

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

קריאות API ומספר הפרויקט

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

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

מצא את מספר הפרויקט

  • קונסולת Firebase: לחץ הגדרות הפרויקט . מספר הפרויקט מוצג בחלונית העליונה.

  • Firebase CLI: הפעלה firebase projects:list . מספר הפרויקט מוצג יחד עם כל הפרויקטים של Firebase המשויכים לחשבון שלך.

  • API REST ניהול Firebase: שיחה projects.list . אם גוף התגובה מכיל את מספר פרויקט FirebaseProject האובייקט.

מזהה הפרויקט

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

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

משאבי Firebase ומזהה הפרויקט

מזהה הפרויקט מוצג במשאבי Firebase גלויים לציבור, לדוגמה:

  • משנה אירוח ברירה - PROJECT_ID .web.app ו PROJECT_ID .firebaseapp.com
  • כתובת האתר מסד ברירת זמן אמת - PROJECT_ID -default-rtdb.firebaseio.com או PROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
  • שם מאגר ברירת ענן אחסון - PROJECT_ID .appspot.com

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

ה-CLI של Firebase ומזהה הפרויקט

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

אתה גם יכול להגדיר פרויקט כינוי לכל פרויקט Firebase כך שאתה לא צריך לזכור את תעודות הזהות הפרויקט.

קריאות API ומזהה הפרויקט

עבור קריאות API רבות, עליך לכלול מזהה ייחודי לפרויקט. למרות APIs רב לקבל מזהה הפרויקט, מומלץ מאוד להשתמש במספר פרויקט לביצוע שיחות API כדי Firebase, גוגל, או שירותי צד שלישי.

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

מצא את מזהה הפרויקט

  • קונסולת Firebase: לחץ הגדרות הפרויקט . מזהה הפרויקט מוצג בחלונית העליונה.

  • Firebase CLI: הפעלה firebase projects:list . מזהה הפרויקט מוצג יחד עם כל הפרויקטים של Firebase המשויכים לחשבון שלך.

  • API REST ניהול Firebase: שיחה projects.list . אם גוף התגובה מכילה מזהה הפרויקט של FirebaseProject האובייקט.

קבצי תצורה ואובייקטים של Firebase

כאשר אתה רושם אפליקציה עם פרויקט Firebase, מסוף Firebase מספק קובץ תצורה של Firebase (אפליקציות Apple/Android) או אובייקט תצורה (אפליקציות אינטרנט) שאתה מוסיף ישירות לספריית האפליקציות המקומית שלך.

  • לגבי אפליקציות אפלות, תוסיף GoogleService-Info.plist קובץ תצורה.
  • במקרה של אפליקציות Android, תוסיף google-services.json קובץ תצורה.
  • עבור אפליקציות אינטרנט, אתה מוסיף אובייקט תצורה של Firebase.

בכל עת, אתה יכול לקבל קובץ config Firebase של אפליקציה או אובייקט .

קובץ תצורה או אובייקט של Firebase משייך אפליקציה לפרויקט Firebase ספציפי ולמשאבים שלו (מסדי נתונים, דלי אחסון וכו'). התצורה כוללת "אפשרויות Firebase", שהם פרמטרים הנדרשים על ידי שירותי Firebase ו-Google כדי לתקשר עם ממשקי API של שרת Firebase וכדי לשייך נתוני לקוח לפרויקט Firebase ולאפליקציית Firebase. להלן "אפשרויות Firebase" המינימליות הנדרשות:

  • מפתח API : מחרוזת מוצפנת פשוט השתמשו כשמתקשרים APIs בטוח לא צריך נתונים פרטיים של משתמשים גישה (ערך לדוגמה: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • הפרויקט מזהה : מזהה ייחודי המוגדרים על ידי המשתמש עבור הפרויקט על פני כל Firebase ו- Google Cloud. המזהה הזה עשוי להופיע בכתובות URL או בשמות עבור חלק מהמשאבים של Firebase, אבל בדרך כלל יש להתייחס אליו ככינוי נוחות להפניה לפרויקט. (ערך לדוגמה: myapp-project-123 )

  • מזהה יישום ( "AppID"): המזהה הייחודי האפליקציה Firebase פני כל Firebase עם פורמט פלטפורמה ספציפית:

    • Firebase אפל Apps: GOOGLE_APP_ID (ערך לדוגמה: 1:1234567890:ios:321abc456def7890 )
      זו אינו מזהה חבילה אפלה.
    • Firebase אנדרואיד Apps: mobilesdk_app_id (ערך לדוגמה: 1:1234567890:android:321abc456def7890 )
      זה לא שם החבילה אנדרואיד או מזהה יישום אנדרואיד.
    • Firebase Web Apps: appId (ערך לדוגמה: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c )

התוכן של קובץ התצורה או האובייקט של Firebase נחשב לציבורי, כולל המזהה הספציפי לפלטפורמה של האפליקציה (מזהה חבילה של Apple או שם חבילת אנדרואיד) והערכים הספציפיים לפרויקט Firebase, כמו מפתח API, מזהה פרויקט, כתובת אתר של מסד נתונים בזמן אמת ו שם דלי של Cloud Storage. לאור זאת, השימוש Firebase אבטחה כללים כדי להגן על הנתונים והקבצים ב Database זמן אמת , ענן Firestore , וכן לאחסון בענן .

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

ניהול פרויקט Firebase

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

כלים לניהול פרויקט

קונסולת Firebase

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

קונסולת Firebase - מסך סקירת פרויקטים

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

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

Firebase CLI (כלי שורת פקודה)

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

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

Firebase Management REST API

שימוש ב- API REST ניהול Firebase , אתה יכול לנהל פרויקט Firebase תכנותי. לדוגמה, אתה יכול לרשום אפליקציה תוכניתי עם פרויקט או לפרט את האפליקציות שכבר רשומים ( iOS + | אנדרואיד | האינטרנט ).

שיטות עבודה מומלצות כלליות

הוספת אפליקציות לפרויקט

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

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

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

  • מספר פרויקטים לכל חשבון

    • תוכנית תמחור ניצוץ - מכסת יצירת פרויקטים מוגבלת למספר נמוך יותר של פרויקטים (בדרך כלל בסביבות 5-10).
    • תוכנית תמחור בלעז - מכסת יצירת פרויקטים לחשבון גדלה באופן משמעותי כל עוד חשבון Cloud Billing המשויך נמצא במצב ניהול תקין.

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

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

  • מספר אפליקציות לכל פרויקט

    Firebase מגביל את המספר הכולל של Firebase Apps בתוך פרויקט Firebase ל-30.

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

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

  • מספר אתרי אחסון לכל פרויקט

    Firebase אירוח התכונה של ריבוי אתרים תומך לכל היותר 36 אתרים לכל פרויקט.

ריבוי שכירות

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

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

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

מפעיל את האפליקציה שלך