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

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

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

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

למד מידע מפורט יותר על התהליך הזה במדריכי התחילה ( iOS | אנדרואיד | אינטרנט | אחדות | 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 (אפליקציות iOS / Android) או אובייקט תצורה (אפליקציות אינטרנט) שאתה מוסיף ישירות לספריית האפליקציות המקומית שלך.

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

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

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

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

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

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

    • Firebase אפליקציות ל- iOS: 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 נחשב לציבורי, כולל המזהה הספציפי לפלטפורמה של האפליקציה (מזהה צרור iOS או שם חבילת Android) והערכים הספציפיים לפרויקט Firebase, כמו מפתח ה- API, מזהה הפרויקט, כתובת אתר מסד הנתונים בזמן אמת וכן שם דלי לאחסון ענן. לאור זאת, השימוש 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 מארחת או עדכונים של פונקציות.

ממשק API REST לניהול Firebase

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

רב שכירות

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

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

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

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