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

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

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

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

מידע מפורט יותר על התהליך הזה זמין במדריך לתחילת העבודה בפלטפורמה הרלוונטית:
iOS+‎ | Android | אינטרנט | Unity | C++‎ | Flutter.

הסבר על ההיררכיה של פרויקטים ב-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:enabled בדף IAM & Admin > Labels במסוף Google Cloud. מידע נוסף על התווית הזו זמין בשאלות הנפוצות.

פרויקט ב-Firebase הוא פרויקט ב-Google Cloud, ולכן:

  • אתם יכולים לגשת לפרויקט ולבצע בו פעולות במסוף Firebase, במסוף Google Cloud ובמסוף Google APIs.

  • אתם יכולים לבצע פעולות בפרויקט באמצעות ה-CLI של Firebase, gcloud CLI וכל משאב של Terraform מ-Google.

  • בפרויקט אפשר להשתמש במוצרים ובממשקי API גם של Firebase וגם של Google Cloud.

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

  • החיוב בפרויקט משותף ל-Firebase ול-Google Cloud. אם החיוב מופעל בפרויקט ב-Google Cloud, הפרויקט ב-Firebase יהיה במינוי Blaze בתשלום לפי שימוש של Firebase.

  • מזהים ייחודיים של הפרויקט (כמו מספר הפרויקט ומזהה הפרויקט) משותפים ל-Firebase ול-Google Cloud.

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

  • מחיקת הפרויקט תמחק אותו מ-Firebase ומ-Google Cloud.

  • אם מוחקים או משנים משאב או נתונים בפרויקט, השינוי חל גם ב-Firebase וגם ב-Google Cloud.

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

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

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

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

בנוסף לערכות ה-SDK של המוצרים, אתם יכולים להשתמש ישירות בפרויקט 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 Extensions.

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

Firebase Management REST API

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

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

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

שם הפרויקט

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

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

מספר הפרויקט

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

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

מזהה הפרויקט

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

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

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

  • באפליקציות של אפל, מוסיפים קובץ תצורה של GoogleService-Info.plist.
  • באפליקציות ל-Android, מוסיפים קובץ תצורה של 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 ל-Apple: ‏GOOGLE_APP_ID (ערך לדוגמה: 1:1234567890:ios:321abc456def7890)
      זה לא מזהה חבילה של אפל.
    • אפליקציות Firebase ל-Android: ‏mobilesdk_app_id (ערך לדוגמה: 1:1234567890:android:321abc456def7890)
      זה לא שם חבילה ל-Android או מזהה אפליקציה ל-Android.
    • אפליקציות אינטרנט של Firebase: ‏appId (ערך לדוגמה: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)

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

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

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

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

  • מספר הפרויקטים לכל חשבון Google (כתובת אימייל)

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

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

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

    מידע ולמידה על שיטות מומלצות כלליות להגדרת פרויקטים ב-Firebase

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

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

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

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

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

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

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