הסבר על פרויקטים ב-Firebase

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

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

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

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

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

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

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

מסוף Firebase

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

<span class=מסוף Firebase – מסך סקירה כללית של הפרויקט" class="attempt-right screenshot" style="max-width: calc((100% - 40px)/1.75);">

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

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

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

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

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

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

API בארכיטקטורת REST לניהול Firebase

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

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

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

שם הפרויקט

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

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

מספר הפרויקט

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

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

מזהה הפרויקט

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

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

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

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

אתם תמיד יכולים לקבל את קובץ התצורה או האובייקט של Firebase ב-Firebase.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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