שאלות נפוצות ופתרון בעיות ב-Firebase Studio

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

Firebase Studio כללי

איך מורידים קבצים מ-Firebase Studio?

כדי להוריד את הקבצים כקובץ ZIP:

• לוחצים לחיצה ימנית על ספרייה כלשהי בחלונית Explorer ובוחרים באפשרות Zip and Download (דחיסה והורדה).

כדי להוריד את כל מה שיש בספריית הפרויקט:

1. בוחרים באפשרות File > Open Folder (קובץ > פתיחת תיקייה).

2. מאשרים את ספריית ברירת המחדל /home/user.

3. אחרי שהקבצים נטענים, לוחצים לחיצה ימנית על ספריית העבודה ובוחרים באפשרות כיווץ והורדה. אם משתמשים ב-App Prototyping agent, ספריית העבודה תהיה studio. אם משתמשים בתבנית או בפרויקט שהועלה, זה יהיה שם הפרויקט.

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

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

כדאי לדעת: אפשר גם לייצא ל-GitHub.

קובצי Cookie של צד שלישי לא מופעלים.

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

Chrome

1. פותחים את ההגדרות.
2. פותחים את הכרטיסייה פרטיות ואבטחה.
3. מוודאים שהאפשרות קבלת כל קובצי ה-Cookie מופעלת.
4. פותחים את Firebase Studio.
5. לוחצים על סמל החשיפה בסרגל הכתובות visibility_off כדי לפתוח את החלונית Tracking Protection (הגנה מפני מעקב). מפעילים את ההגדרה קובצי Cookie של צד שלישי כדי לאפשר זמנית שימוש בקובצי Cookie של צד שלישי. הפעולה הזו תפעיל קובצי Cookie ב-Firebase Studio למשך 90 יום.

Safari

1. פותחים את Safari > הגדרות....
2. משביתים את ההגדרות הבאות:
   • מתקדם > חסימה של כל קובצי ה-Cookie
   • פרטיות > מניעת מעקב חוצה-אתרים
3. פותחים את Firebase Studio.

Firefox

לא צריך להפעיל קובצי Cookie של צד שלישי ב-Firefox. פותחים את Firebase Studio.

Opera

1. פותחים את Opera.
2. פותחים את התפריט ולוחצים על הגדרות.
3. עוברים לקטע פרטיות ואבטחה ומרחיבים את האפשרות קובצי Cookie של צד שלישי.
4. בוחרים באפשרות חסימת קובצי Cookie של צד שלישי במצב פרטי או באפשרות אישור השימוש בקובצי Cookie של צד שלישי.
5. פותחים את Firebase Studio.

קשת

1. עוברים לכתובת arc://settings.
2. עוברים לקטע פרטיות ואבטחה ומרחיבים את האפשרות קובצי Cookie של צד שלישי.
3. בוחרים באפשרות חסימת קובצי Cookie של צד שלישי במצב פרטי או באפשרות אישור השימוש בקובצי Cookie של צד שלישי.
4. פותחים את Firebase Studio.

Brave

אין צורך להפעיל קובצי Cookie של צד שלישי ב-Brave. פותחים את Firebase Studio.

למה צריך להפעיל קובצי Cookie של צד שלישי (3P) ב-Firebase Studio?

צריך להפעיל קובצי Cookie של צד שלישי ב-Firebase Studio כי אנחנו מעבדים iframe מדומיין אחד (תת-דומיין של cloudworkstations.dev) בדומיין אחר (studio.firebase.google.com), וקובצי Cookie של צד שלישי מאפשרים תקשורת מאובטחת בין מקורות שונים.

בזמן פתיחת סביבת עבודה, ההודעה לא ניתן להעביר את הבקשה שלך לשרת העורפי. מופיעה ההודעה Couldn't connect to a server on port 80 (לא הייתה אפשרות להתחבר לשרת ביציאה 80).

ממתינים כחמש שניות ומרעננים את הדף.

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

אם Firebase Studio לא מתרענן כמו שצריך (בדרך כלל כתוצאה משינויים משמעותיים או שינויים בקובץ dev.nix של הסביבה), פותחים את לוח הפקודות (Cmd+Shift+P ב-Mac או Ctrl+Shift+P ב-ChromeOS,‏ Windows או Linux) ומריצים את הפקודה Hard Restart. אם הבעיה נמשכת, נסו להריץ את הפקודה Rebuild Environment.

סביבת העבודה שלי לא מגיבה, כל מה שאני רואה זה מסך ריק כשהיא נטענת

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

1. בתפריט Firebase Studio, לוחצים על סמל האפשרויות הנוספות ( more_horiz ) ובוחרים באפשרות איפוס.

2. כשמופיעה בקשה, לוחצים שוב על איפוס.

3. פותחים מחדש את סביבת העבודה.

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

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

‫[Errno 28] No space left on device

יכול להיות שתיתקלו בהודעה הזו אם הדיסק מלא. Firebase Studio בסביבת העבודה הזו אפשר:

• נפח אחסון כולל של 100GiB לחבילות Nix ול-/tmp
• ‫10GB עבור הספרייה /home

בזמן יצירת סביבת עבודה, מוצגת השגיאה אירעה שגיאה פנימית.

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

כמה סביבות עבודה אפשר ליצור?

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

איך שולחים בקשה להוספת תכונה או משוב על בעיה שנתקלתם בה?

אם נתקלתם בבעיה במהלך השימוש ב-Firebase Studio או שיש לכם בקשה לתכונה, אתם יכולים לפנות לתמיכה של Firebase.

השתמשתי בתכונה מסוימת ב-Firebase Studio אבל היא לא מופיעה יותר. למה הוא הוסר?

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

Firebase Studio סביבות עבודה של Code

סביבת העבודה נטענת, אבל האמולטור ריק.

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

Firebase Studio workspaces יש גרסת Flutter שלא תואמת לפרויקט שלי.

אפשר לשדרג או לשנמך את הגרסה של כמעט כל תוכנה שהותקנה מראש בסביבת עבודה, בדיוק כמו במחשב המקומי (באמצעות apt-get או brew). אתם יכולים לשדרג או לשנמך תוכנה בסביבת העבודה, אבל תוכנה שהותקנה לא נשמרת בין סשנים. מומלץ לכלול את כל החבילות הנדרשות בקובץ dev.nix.

אנחנו פועלים לשיפור ניהול הגרסאות של Flutter ב-Firebase Studio.

שיתפתי את כתובת ה-URL של תחנת העבודה שלי עם מישהו, אבל הוא לא יכול לראות אותה.

אפשר לשתף כתובת URL של מרחב עבודה רק עם משתמשים שיש להם גישה למרחב העבודה. משתמשים שאין להם הרשאה יראו שגיאה כשינסו להיכנס לכתובת ה-URL. חשוב לשתף איתם את ה-Workspace באופן מפורש.

כשמשתפים את תחנת העבודה, מה השותפים יכולים לראות?

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

שיתפתי את סביבת העבודה שלי, אבל למה השותף שלי לא יכול לפרסם את האפליקציה או לעקוב אחריה?

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

האם אפשר להשתמש במסגרות שאין להן תבנית ב-Firebase Studio כדי ליצור את האפליקציה?

כן! אתם יכולים להתאים אישית את הסביבה כדי לעבוד עם כמעט כל מסגרת או שפה ב-Firebase Studio.

איזו ספריית יעד צריך לבחור כשמפרסמים אפליקציית Flutter ב-Firebase Hosting?

בוחרים את הספרייה build/web. הספרייה הזו צריכה להכיל את index.html ואת כל הנכסים הסטטיים שנדרשים לעיבוד אפליקציית האינטרנט אחרי שהאפליקציה נוצרה בהצלחה (באמצעות flutter build web).

איך אפשר להגדיר את ה-backend של האפליקציה שלי בסביבת העבודה כדי שה-frontend יוכל לתקשר איתו?

אתם יכולים לפתוח באופן זמני את יציאת ה-TCP שבה שרת הקצה העורפי פועל כדי להקל על פיתוח הקצה הקדמי והקצה העורפי בנפרד, בסביבות עבודה שונות:

1. מפעילים את השרת של הקצה העורפי או של ה-API באופן ידני במסוף, או כחלק מהתצורה של התצוגה המקדימה של קובץ dev.nix או של ה-lifecycle hook של onStart.

2. לוחצים על הסמל Firebase Studio בסרגל הפעילות (בצד ימין כברירת מחדל) כדי לפתוח את החלונית Firebase Studio.

3. 

   מרחיבים את הקטע Backend ports כדי לראות רשימה של שרתים פעילים, כולל מספר היציאה ומזהה התהליך (PID).

4. לוחצים על סמל הפיכה לציבורי (מנעול) מימין למספר היציאה.

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

5. לוחצים על הסמל העתקת כתובת URL משמאל למספר היציאה כדי להעתיק את כתובת ה-URL המלאה שלו.

6. עכשיו אפשר להפנות ישירות לכתובת ה-URL הזו (לדוגמה, באמצעות קריאה של fetch) מהחלק הקדמי של האתר.

   הערה: אם חזית האתר שלכם היא דפדפן אינטרנט, יכול להיות שתצטרכו להפעיל תמיכה ב-CORS בקצה העורפי או בשרת ה-API (לדוגמה, באמצעות חבילת cors NPM לאפליקציות Node.js או flask-cors לאפליקציות Python Flask).

סגרתי את כרטיסיית התצוגה המקדימה. איך מחזירים אותו?

פותחים את לוח הפקודות באמצעות Ctrl+Shift+P (או Cmd-Shift-P ב-MacOS), ואז בוחרים באפשרות Firebase Studio: הצגת תצוגה מקדימה של Android או Firebase Studio: הצגת תצוגה מקדימה של אתר.

מה זה Code OSS?

‫Code-Open Source Software (Code-OSS) הוא פרויקט בקוד פתוח שמהווה את שכבת הליבה של VS Code. ‫Code-OSS זמין ב-GitHub במסגרת רישיון MIT רגיל, וזה המקום שבו מיקרוסופט מפתחת את המוצר VS Code.

איך אפשר למנוע שימוש בהשלמות קוד ובהנחיות ל-Gemini כנתוני אימון?

השימוש שלך ב-Firebase Studio כפוף לתנאים ולהגבלות של Google.

עם זאת, חשוב לזכור שהשימוש בתכונות של AI גנרטיבי ב-Firebase Studio כפוף למדיניות בנושא שימוש אסור ב-AI גנרטיבי וGemini API לתנאים ולהגבלות הנוספים (במיוחד לתנאים ולהגבלות הנוספים של Gemini API: שירותים ללא תשלום).

כדי לחסום את השימוש בהנחיות ובתשובות שלכם לאימון מודלים, אל תשתמשו ב-App Prototyping agent ואל תשתמשו ב-Gemini ב-Firebase בתוך Firebase Studio. כדי לחסום את השימוש בקוד שלכם לאימון מודלים, משביתים את השלמת הקוד ואת יצירת האינדקס של הקוד בהגדרות של Firebase Studio.

Gemini

איך אפשר לראות את מכסת הבקשות לדקה של מפתח Gemini API שנוצר באופן אוטומטי?

אפשר לראות את המכסות שמשויכות למפתח ה-API שנוצר באופן אוטומטי בדף מכסות ומגבלות מערכת של Generative Language API במסוף Google Cloud.

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

כמות הנתונים (שמיוצגת כ'טוקנים') בפרויקט גדולה מהמגבלה המקסימלית שהמודל יכול לקבל. כדי לפתור את השגיאה הזו, צריך לשנות את ההגדרה של הקבצים בבסיס הקוד שצריכים להיות מוסתרים מ-Gemini:

1. בסביבת העבודה, עוברים לתצוגה Code.

2. יוצרים קובץ .aiexclude.

3. כדי לצמצם את כמות הנתונים בפרויקט, צריך לכלול קבצים או ספריות ש-Gemini צריך להתעלם מהם. לדוגמה, יכול להיות שתרצו להוסיף את .next/ ואת כל ספריות המשנה. הנתיב צריך להיות יחסי לספרייה שמכילה את הקובץ .aiexclude:

    .next/
   

4. מנסים שוב להשתמש ב-Gemini. אם עדיין מופיעה שגיאה לגבי חריגה ממספר האסימונים המקסימלי, נסו להוסיף קבצים או ספריות גדולים אחרים לקובץ .aiexclude.

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

לא הצלחתי ליצור פרויקט

כשמקצים משאבים כמו מפתח Gemini API או כשפורסים ל-Firebase App Hosting, המערכת מקצה לכם פרויקט באופן אוטומטי, על סמך השם של סביבת העבודה של Firebase Studio.

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

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

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

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

מידע נוסף על Firebase ועל Google Cloud פרויקטים זמין במאמר הסבר על פרויקטים ב-Firebase.

יצירת החשבון Cloud Billing נכשלה

כשמקצים משאבים כמו פריסה ב-Firebase App Hosting, אפשר לבחור או ליצור חשבון Cloud Billing.

אם מופיעה השגיאה "לא הצלחנו ליצור חשבון Cloud Billing":

• מוודאים שיש לכם הרשאה ליצור חשבונות Cloud Billing. כדאי לבדוק את ההרשאות או לפנות לאדמין לקבלת עזרה.

אם מוצגת השגיאה 'מספר הפרויקטים בחשבון הזה לחיוב גבוה מדי':

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

מידע נוסף על יצירת חשבון Cloud Billing עם חיוב בשירות עצמי

אם אף אחת מהאפשרויות האלה לא פותרת את הבעיה, אפשר לפנות אל Cloud Billing התמיכה.

למה App Prototyping agent לא מציע לפתור את הבעיה שלי?

סוכן יצירת אב טיפוס לאפליקציות מזהה שגיאות ב-Next.js ומציע לתקן אותן. אם מופיעה שגיאה ולא מוצע פתרון, מעתיקים את הטקסט של הבעיה ומדביקים אותו בצ'אט.

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

לדוגמה, אם מופיעה שגיאת Firebase כמו Property access is undefined on object. for 'list' @ L6, שמעידה על בעיה בכללים, כדאי להוסיף לפני השגיאה את השאלה: "Can you help me fix this Cloud Firestore rules issue?"Cloud Firestore

קיבלתי את השגיאה 'פרסום האפליקציה נכשל' אחרי הפרסום

בדרך כלל, שגיאות בפרסום יתועדו ביומני Cloud Build. כדי לנפות באגים ולפתור בעיות שגורמות לפרסום להיכשל:

1. בדף פרטי האפליקציה (אם הוא ממוזער, לוחצים על פרסום כדי להציג אותו), לוחצים על הצגת פרטים. האפשרות App Hosting תיפתח במסוף Firebase.

2. בדף Firebase console App Hosting, לוחצים על View Cloud Build logs.

   הפעולה הזו תפתח את מסוף Firebase שבו אפשר לראות את יומני ה-build ולאתר את השגיאה.

3. מעתיקים את השגיאה ומדביקים אותה ב-App Prototyping agent או בצ'אט עם Gemini ב-Firebase ב-Workspace, ומבקשים מ-Gemini לתקן אותה.

4. כדי לוודא שהתיקון פועל, עוברים לתצוגת קוד, פותחים את הטרמינל ומריצים את הפקודה npm run build. אם מופיעה שגיאה אחרת, נסו שוב. אם מופיע הסמל FirebaseError, כדאי לעיין במאמר למה לא מוצגת האפשרות לפתור את הבעיה שלי?.App Prototyping agent

5. אם הבנייה הצליחה, לוחצים על npm run start ופותחים את הקישור ל-localhost שמופיע, ואז בודקים את הפונקציונליות של האפליקציה. אפשר לבדוק אם יש שגיאות בזמן ריצה במסוף.

6. אם הכול תקין, מריצים את הפקודה Ctrl-C ב-Terminal כדי לעצור את הגרסה שמוכנה להפצה שפועלת בסביבת העבודה, ואז מנסים שוב את תהליך הפרסום App Hosting.

אין לי אפשרות לבצע שינויים באמצעות App Prototyping agent

אם App Prototyping agent לא משלים את השינויים המבוקשים בקוד, חוזר לשלב של תוכנית האפליקציה או מחזיר שוב ושוב שגיאה שאומרת שהייתה בעיה:

1. איפוס ה-VM.

2. אם הבעיה נמשכת כשפותחים מחדש את סביבת העבודה, מזינים /clear בצ'אט App Prototyping agent.

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

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

   1. עוברים לתצוגת Code.

   2. פותחים את הכרטיסייה בקרת מקור.

   3. בתרשים של בקרת המקור, לוחצים לחיצה ימנית על גרסה קודמת > יצירת ענף. מזינים שם לענף.

   4. חזור אל Prototyper mode. If the agent still doesn't respond or returns an error, try branching from an even earlier version of your app.

   5. כדי לעבור בין הענפים שיוצרים (או לחזור לענף הראשי), לוחצים על שם הענף בפינה הימנית התחתונה של Code התצוגה ובוחרים את הענף שרוצים להשתמש בו.