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

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

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

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

למד מידע מפורט יותר על תהליך זה במדריך תחילת העבודה עבור הפלטפורמה שלך:
iOS+ | אנדרואיד | אינטרנט | אחדות | C++ | רפרוף .

הבנת ההיררכיה של פרויקטי Firebase

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

  • פרויקט Firebase הוא כמו מיכל עבור כל האפליקציות שלך וכל המשאבים והשירותים שסופקו עבור הפרויקט.

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

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

    • כל האפליקציות של Firebase הרשומות לאותו פרויקט Firebase חולקות את אותם רכיבים עורפיים, כמו Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage ו-Cloud Functions.

    • כל אפליקציות Firebase הרשומות לאותו פרויקט Firebase משויכות לאותו נכס של Google Analytics, כאשר כל אפליקציית Firebase היא זרם נתונים נפרד באותו נכס.

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

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

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

מכיוון שפרויקט Firebase הוא פרויקט של Google Cloud:

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

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

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

אינטראקציה עם פרויקט Firebase

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

קונסולת Firebase

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

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

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

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

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

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

Firebase מציעה גם את Firebase CLI להגדרה וניהול של מוצרי Firebase ספציפיים, כמו Firebase Hosting, Cloud Functions for Firebase ותוספי Firebase.

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

Firebase Management REST API

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

מזהי פרויקט Firebase

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

שם הפרויקט

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

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

מספר הפרויקט

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

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

מזהה הפרויקט

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    תכונת Firebase Hosting multisite תומכת לכל היותר ב-36 אתרים לכל פרויקט.

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