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

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