שאלות נפוצות ופתרון בעיות ב-Firebase Studio
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
Firebase Studio כללי
איך מורידים קבצים מ-Firebase Studio?
כדי להוריד את הקבצים כקובץ ZIP:
לוחצים לחיצה ימנית על ספרייה כלשהי בחלונית Explorer ובוחרים באפשרות Zip and Download (דחיסה והורדה).
כדי להוריד את כל מה שיש בספריית הפרויקט:
בוחרים באפשרות File > Open Folder (קובץ > פתיחת תיקייה).
מאשרים את ספריית /home/user שמוגדרת כברירת מחדל.
אחרי שהקבצים נטענים, לוחצים לחיצה ימנית על ספריית העבודה ובוחרים באפשרות כיווץ והורדה. אם משתמשים ב-App Prototyping agent, ספריית העבודה תהיה studio. אם משתמשים בתבנית או בפרויקט שהועלה, זה יהיה שם הפרויקט.
כשמוצגת בקשה לבנייה מחדש של הסביבה, לוחצים על ביטול.
אחרי שההורדה מסתיימת, פותחים מחדש את ספריית העבודה מהתפריט קובץ כדי לחזור לסביבת העבודה.
קובצי Cookie של צד שלישי לא מופעלים.
לפני שמתחילים, יכול להיות שצריך להפעיל קובצי Cookie של צד שלישי בדפדפן. Firebase Studio כדי לאמת את סביבות העבודה, צריך להשתמש בקובצי Cookie של צד שלישי ברוב הדפדפנים.
לוחצים על סמל החשיפה בסרגל הכתובות visibility_off כדי לפתוח את החלונית Tracking Protection (הגנה מפני מעקב). מפעילים את ההגדרה קובצי Cookie של צד שלישי כדי לאפשר זמנית שימוש בקובצי Cookie של צד שלישי. ההגדרה הזו מאפשרת שימוש בקובצי Cookie ב-Firebase Studio למשך 90 ימים.
בטלפונים ובטאבלטים עם Android:
מקישים על ( more_vert ) אפשרויות נוספות > הגדרות.
פותחים את הגדרות לאתרים > קובצי Cookie של צד שלישי.
לוחצים על סמל החשיפה בסרגל הכתובות visibility_off כדי לפתוח את החלונית Tracking Protection (הגנה מפני מעקב). מפעילים את ההגדרה קובצי Cookie של צד שלישי כדי לאפשר זמנית שימוש בקובצי Cookie של צד שלישי. ההגדרה הזו מאפשרת שימוש בקובצי Cookie ב-Firebase Studio למשך 90 ימים.
באייפון ובאייפד:
פותחים את אפליקציית ההגדרות > אפליקציות > Chrome.
מפעילים את האפשרות Allow Cross-Website Tracking (מתן הרשאה למעקב בין אתרים שונים).
אין צורך להפעיל קובצי 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.
סביבת העבודה שלי לא מגיבה, ומוצג רק מסך ריק כשהיא נטענת
אם סביבת העבודה לא מגיבה, אפשר לנסות להפעיל מחדש את המכונה הווירטואלית. כך עושים את זה:
בתפריט Firebase Studio, לוחצים על סמל האפשרויות הנוספות ( more_horiz ) ובוחרים באפשרות הפעלה מחדש.
כשמופיעה בקשה, לוחצים שוב על הפעלה מחדש.
פותחים מחדש את סביבת העבודה.
במהלך יצירת סביבת עבודה, מופיעה ההודעה אופס...צריך להפעיל מכונה וירטואלית חדשה, וממשק המשתמש נתקע אחרי זה.
Firebase Studio מתחזק מאגר חם של מכונות וירטואליות שמשמשות להקצאת סביבות עבודה לפי דרישה. כשמאגר העובדים מתרוקן, סביבות העבודה מוקצות אחרי שמכונה וירטואלית חדשה מופעלת. התהליך יכול להימשך זמן מה (לפעמים עד חמש דקות), אבל בסופו של דבר הוא מצליח.
[Errno 28] No space left on
device
יכול להיות שתיתקלו בהודעה הזו אם הדיסק מלא. בסביבת העבודה Firebase Studio
יש:
במהלך יצירת מרחב עבודה, קיבלתי את הודעת השגיאה אירעה שגיאה פנימית.
ברוב המקרים של שגיאות פנימיות במהלך הקצאת שטחי עבודה, רענון הדף אחרי דקה בערך אמור לפתור את הבעיה ולאפשר לכם להיכנס לשטח העבודה.
כמה סביבות עבודה אפשר ליצור?
בתוכנית Firebase Studio ללא תשלום, כל משתמש יכול ליצור עד שלושה מרחבי עבודה.
כדי להגדיל את מספר סביבות העבודה שאפשר ליצור עד 10, אפשר להצטרף לתוכנית Google למפתחים.
כדי לשדרג ל-30 סביבות עבודה, צריך להירשם לתוכנית הפרימיום של Google למפתחים.
איך שולחים בקשה להוספת תכונה או משוב על בעיה שנתקלתם בה?
אם נתקלתם בבעיה במהלך השימוש ב-Firebase Studio או שיש לכם בקשה לתכונה, אתם יכולים לפנות לתמיכה של Firebase.
השתמשתי בתכונה מסוימת ב-Firebase Studio אבל היא לא מופיעה יותר. למה הוא הוסר?
חלק מהתכונות ב-Firebase Studio הן ניסיוניות. אנחנו מעריכים את המשוב שלכם ומשתמשים בו באופן פעיל כדי לעדכן את מערך התכונות הנוכחי והמתוכנן שלנו. מדי פעם אנחנו מסירים תכונות שלא עומדות בציפיות שלכם או שלנו. אם יש תכונות שהייתם רוצים לראות בגרסה האידיאלית של Firebase Studio, אתם יכולים לשלוח לנו משוב. אנחנו רוצים לשמוע מכם!
בסביבות העבודה של Firebase Studio יש גרסת Flutter שלא תואמת לפרויקט שלי.
אפשר לשדרג או לשנמך את הגרסה של כמעט כל תוכנה שמותקנת מראש בסביבת עבודה, בדיוק כמו במחשב המקומי (באמצעות apt-get או brew). אפשר לשדרג או לשנמך תוכנה בסביבת העבודה, אבל תוכנה מותקנת לא נשמרת בין סשנים. מומלץ לכלול את כל החבילות הנדרשות בקובץ dev.nix.
אנחנו פועלים לשיפור ניהול הגרסאות של Flutter ב-Firebase Studio.
שיתפתי את כתובת ה-URL של תחנת העבודה שלי עם מישהו, אבל הוא לא יכול לראות אותה.
אפשר לשתף כתובת URL של מרחב עבודה רק עם משתמשים שיש להם גישה למרחב העבודה.
משתמשים שאין להם הרשאה יראו שגיאה כשינסו להיכנס לכתובת ה-URL. חשוב לשתף איתם את ה-Workspace באופן מפורש.
כשאני משתף את תחנת העבודה שלי, מה השותף שלי יכול לראות?
למשתמשים שמתווספים לסביבת העבודה יש גישה מלאה לכל מערכת הקבצים של המכונה הווירטואלית, שעשויה להכיל קבצים רגישים כמו מפתחות פרטיים וטוקנים של גישה שמאוחסנים בדיסק. חשוב לשתף את סביבת העבודה רק עם אנשים שסומכים עליהם. הגישה הזו מאפשרת למשתמשים אחרים לראות את המצב המדויק של סביבת העבודה שלכם, אבל המשמעות היא שהם רואים את כל מה שמופיע בסביבת העבודה.
שיתפתי את סביבת העבודה שלי, אבל למה השותף שלי לא יכול לפרסם את האפליקציה שלי או לעקוב אחרי הביצועים שלה?
יכול להיות שלמשתמשים שנוספו ל-Workspace שלכם אין הרשאה לפרויקט Firebase הבסיסי שמפעיל את התכונות 'סקירה כללית של האפליקציה' ו'מעקב אחרי פרסום'. כדי להעניק להם הרשאה לפרויקט Firebase, אפשר לעיין במאמר בנושא הרשאות וגישה לפרויקטים ב-Firebase
האם אפשר להשתמש במסגרות שאין להן תבנית ב-Firebase Studio כדי ליצור את האפליקציה?
כן! אתם יכולים להתאים אישית את הסביבה כדי לעבוד עם כמעט כל מסגרת או שפה ב-Firebase Studio.
איזו תיקיית יעד צריך לבחור כשמפרסמים אפליקציית Flutter ב-Firebase Hosting?
בוחרים את הספרייה build/web. הספרייה הזו צריכה להכיל את index.html
ואת כל הנכסים הסטטיים שנדרשים לעיבוד אפליקציית האינטרנט אחרי שהאפליקציה נוצרה בהצלחה (באמצעות flutter build web).
איך אפשר להגדיר את ה-Backend של האפליקציה שלי בסביבת העבודה כדי שה-Frontend יוכל לתקשר איתו?
אתם יכולים לפתוח באופן זמני את יציאת ה-TCP שבה שרת הקצה העורפי פועל כדי להקל על פיתוח הקצה הקדמי והקצה העורפי בנפרד, בסביבות עבודה שונות:
מפעילים את השרת של הקצה העורפי או של ה-API באופן ידני במסוף, או כחלק מהגדרת התצוגה המקדימה של קובץ dev.nix או של ווֹקְלִיף מחזור החיים של onStart.
לוחצים על הסמל Firebase Studio בסרגל הפעילות (בצד ימין כברירת מחדל) כדי לפתוח את החלונית Firebase Studio.
מרחיבים את הקטע Backend ports (יציאות של קצה עורפי) כדי לראות רשימה של שרתים פועלים, כולל מספר היציאה ומזהה התהליך (PID).
לוחצים על סמל הפיכה לציבורי (מנעול) מימין למספר היציאה.
לוחצים על סמל העתקת כתובת URL משמאל למספר היציאה כדי להעתיק את כתובת ה-URL המלאה שלו.
עכשיו אפשר להפנות ישירות לכתובת ה-URL הזו (לדוגמה, באמצעות fetchקריאה) מהחלק הקדמי של האתר.
סגרתי את כרטיסיית התצוגה המקדימה. איך מחזירים אותו?
פותחים את לוח הפקודות באמצעות 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 כנתוני אימון?
כדי לחסום את השימוש בהנחיות ובתשובות שלכם לאימון מודלים, אל תשתמשו ב-App Prototyping agent ואל תשתמשו ב-Gemini ב-Firebase בתוך Firebase Studio. כדי לחסום את השימוש בקוד שלכם לאימון מודלים, צריך להשבית את השלמת הקוד ואת יצירת האינדקס של הקוד בהגדרות של Firebase Studio.
Gemini
איך אפשר לראות את מכסת הבקשות לדקה של מפתח Gemini API שנוצר באופן אוטומטי?
אפשר לראות את המכסות שמשויכות למפתח ה-API שנוצר באופן אוטומטי בדף Generative Language API Quotas and System Limits במסוף Google Cloud.
קיבלתי שגיאה לגבי חריגה מהמספר המקסימלי של טוקנים שמותרים
כמות הנתונים (שמיוצגת כ'טוקנים') בפרויקט גדולה מהמגבלה המקסימלית שהמודל יכול לקבל. כדי לפתור את השגיאה הזו, צריך לשנות את ההגדרות של הקבצים בבסיס הקוד שצריכים להיות מוסתרים מ-Gemini:
כדי לצמצם את כמות הנתונים בפרויקט, צריך להוסיף קבצים או ספריות ש-Gemini צריך להתעלם מהם. לדוגמה, יכול להיות שתרצו להוסיף את .next/
ואת כל ספריות המשנה. הנתיב צריך להיות יחסי לספרייה שמכילה את הקובץ .aiexclude:
.next/
מנסים שוב להשתמש ב-Gemini. אם עדיין מופיעה שגיאה לגבי חריגה ממספר האסימונים המקסימלי, נסו להוסיף קבצים או ספריות גדולים אחרים לקובץ .aiexclude.
הסוכן ליצירת אב טיפוס של אפליקציה
לא הצלחתי ליצור פרויקט
כשמקצים משאבים כמו מפתח Gemini API או כשפורסים ב-Firebase App Hosting, המערכת מקצה לכם פרויקט באופן אוטומטי על סמך השם של מרחב העבודה שלכם ב-Firebase Studio.
אם מופיעה השגיאה "יצירת הפרויקט נכשלה":
אם חשבון Google שלכם הוא חלק מארגון, יכול להיות שאין לכם הרשאה ליצור פרויקטים ב-Google Cloud או שהגעתם למכסת הפרויקטים המקסימלית. כדי לקבל עזרה, פנו לאדמין או קראו את המאמר בנושא יצירה וניהול של פרויקטים.
אם חשבון Google שלכם לא משויך לארגון, יכול להיות שהגעתם למכסת הפרויקט Google Cloud. שליחת בקשה להגדלת המכסה.
איך אפשר לגרום ל-App Prototyping agent להוסיף אוטומטית את Cloud Firestore ואת Firebase Authentication לאפליקציה שלי?
מבקשים מ-App Prototyping agent להוסיף מסד נתונים או אימות בזמן העבודה על אפליקציה קיימת. כשמבקשים להוסיף מסד נתונים או אימות, App Prototyping agent מבקש אישור. אם תאשרו, App Prototyping agent יגדיר פרויקט Firebase עם שירותי הקצה העורפי המבוקשים בשבילכם.
למה App Prototyping agent לא מציע לפתור את הבעיה שלי?
הסוכן ליצירת אב טיפוס של אפליקציות מזהה שגיאות ב-Next.js ומציע לתקן אותן. אם מופיעה שגיאה ולא מוצע פתרון, מעתיקים את הטקסט של הבעיה ומדביקים אותו בצ'אט.
כדי לקבל את התוצאות הטובות ביותר, כדאי לספק מידע נוסף על אופי הבעיה, אם יש לך כזה.
לדוגמה, אם מופיעה שגיאת Firebase כמו Property access is undefined
on object. for 'list' @ L6, שמעידה על בעיה בכללים, כדאי להוסיף לשאלה את המילים "Can you help me fix this rules issue?" (תוכל לעזור לי לפתור את הבעיה הזו בכללים?).Cloud FirestoreCloud Firestore
קיבלתי את השגיאה 'פרסום האפליקציה נכשל' אחרי הפרסום
בדרך כלל, שגיאות בפרסום יתועדו ביומני Cloud Build. כדי לנפות באגים ולפתור בעיות שגורמות לפרסום להיכשל:
בדף פרטי האפליקציה (אם הוא ממוזער, לוחצים על פרסום כדי להציג אותו), לוחצים על הצגת פרטים. המסוף App Hosting ייפתח.Firebase
הפעולה הזו תפתח את מסוף Firebase שבו אפשר לראות את יומני ה-build ולאתר את השגיאה.
מעתיקים את השגיאה ומדביקים אותה בצ'אט של App Prototyping agent או של Gemini ב-Firebase בסביבת העבודה, ומבקשים מ-Gemini לתקן אותה.
כדי לוודא שהתיקון פועל, עוברים לתצוגת קוד, פותחים את הטרמינל ומריצים את הפקודה npm
run build. אם מופיעה שגיאה אחרת, נסו שוב. אם מופיע הסמל FirebaseError, כדאי לעיין במאמר למה App Prototyping agent לא מציע לפתור את הבעיה שלי?
אם הבנייה הצליחה, לוחצים על npm run start ופותחים את הקישור ל-localhost שמופיע. לאחר מכן בודקים את הפונקציונליות של האפליקציה. אפשר לבדוק אם יש שגיאות בזמן ריצה במסוף.
אם הכול יפעל כמו שצריך, מריצים את הפקודה Ctrl-C ב-Terminal כדי לעצור את הגרסה שנוצרה לחבילת הייצור שפועלת בסביבת העבודה, ואז מנסים שוב את תהליך הפרסום App Hosting.
אין לי אפשרות לבצע שינויים באמצעות App Prototyping agent
אם App Prototyping agent לא משלים את השינויים המבוקשים בקוד,
חוזר לשלב של תוכנית האפליקציה או מחזיר שוב ושוב שגיאה שאומרת
שהוא נתקל בבעיה:
אם הבעיה נמשכת כשפותחים מחדש את סביבת העבודה, מזינים /clear בצ'אט של App Prototyping agent.
אם הבעיה נמשכת, אפשר לנסות ליצור ענף מגרסה קודמת של האפליקציה:
עוברים לתצוגת Code.
פותחים את הכרטיסייה Source Control.
בתרשים של בקרת המקור, לוחצים לחיצה ימנית על גרסה קודמת > יצירת ענף. מזינים שם לענף.
חזור אל Prototyper mode. If the agent still
doesn't respond or returns an error, try branching from an even earlier
version of your app.
כדי לעבור בין הענפים שיוצרים (או לחזור לענף הראשי), לוחצים על שם הענף בפינה הימנית התחתונה של Code התצוגה ובוחרים את הענף שרוצים להשתמש בו.
נתקלתי בבעיה בהנחיה של App Prototyping agent לשילוב שירותי Firebase.
אנחנו פועלים לשיפור תהליך השילוב של שירותי Firebase באמצעות App Prototyping agent. בינתיים, ריכזנו כאן כמה אתגרים נפוצים וטיפים.
קובץ ההגדרות לא עודכן: בהנחיה, צריך לכלול את הערך הספציפי שרוצים לעדכן. הערכים מופיעים בדף הגדרות הפרויקט במסוף Firebase. לדוגמה, אפשר להזין את ההנחיה: "Update the
measurementId in my config with G-1234567890."
האימות לא פועל כשמציגים את האפליקציה בתצוגה מקדימה: יכול להיות שתצטרכו לכלול את כתובת ה-URL של התצוגה המקדימה כדומיין מורשה:
במצב Prototyper, לוחצים על open_in_newפתיחה בחלון חדש.
בחלון התצוגה המקדימה החדש שנפתח, מעתיקים את כתובת ה-URL. שימו לב שכתובת ה-URL צריכה להתחיל ב-6000. אם היא מתחילה ב-9000, צריך לעדכן אותה לפני שממשיכים לשלב הבא.
בדף הגדרות אימות במסוף Firebase, מוסיפים את כתובת ה-URL שהעתקתם בשלב הקודם אל הדומיינים המורשים.
הערה: השיטה הזו מאפשרת רק את התצוגה המקדימה שמוצגת כברירת מחדל ב-Prototyper mode. The preview within Code
view and the preview pop-out might not allow you to authenticate.
לא נוצרו כללי אבטחה של Firebase: Gemini יכול לעזור לכם לכתוב כללי אבטחה, אבל עדיין לא יכול להוסיף אותם באופן אוטומטי לפרויקט Firebase שלכם. כדי לפרסם את הכללים, צריך להעתיק אותם אל מסוף Firebase.
אינטראקציה לא צפויה עם שרת ה-MCP של Firebase: אם הגדרתם את שרת ה-MCP של Firebase, יכול להיות שתיתקלו בהתנהגות לא צפויה כשאתם משתמשים ב-Prototyper for
Firebase integrations. If this occurs, switch to Code view
and prompt Gemini in Firebase to integrate Firebase services.