Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

להבין פרויקטים של 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 גלוי לציבור. זה פשוט עוזר לך להבחין ביתר קלות בין מספר פרויקטים.

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

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

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

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

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

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

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

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

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

רב שכירות

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

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

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

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