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

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

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

בזמן פתיחת סביבת עבודה, ההודעה לא ניתן להעביר את הבקשה שלך לשרת העורפי. מופיעה ההודעה לא הייתה אפשרות להתחבר לשרת ביציאה 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.

Firebase Studio workspaces have a Flutter version that is incompatible with my project.

אפשר לשדרג או לשנמך את הגרסה של כמעט כל תוכנה שהותקנה מראש בסביבת עבודה, בדיוק כמו במחשב המקומי (באמצעות 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 שבה שרת הקצה העורפי פועל כדי להקל על פיתוח הקצה הקדמי והקצה העורפי בנפרד, בסביבות עבודה שונות:

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

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

3. 

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

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

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

6. עכשיו אפשר להפנות ישירות לכתובת ה-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 כנתוני אימון?

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

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

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

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

אפשר לראות את המכסות שמשויכות למפתח ה-API שנוצר באופן אוטומטי בדף Generative Language API Quotas and System Limits ב-Google Cloud console.

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

כמות הנתונים (שמיוצגת כ'טוקנים') בפרויקט גדולה מהמגבלה המקסימלית שהמודל יכול לקבל. כדי לפתור את השגיאה הזו, צריך לשנות את ההגדרה של הקבצים בבסיס הקוד שצריכים להיות מוסתרים מ-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. פותחים את הכרטיסייה Source Control.

   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 התצוגה ובוחרים את הענף שרוצים להשתמש בו.

נתקלתי בבעיה בהנחיה של App Prototyping agent לשילוב שירותי Firebase.

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

• קובץ ההגדרות לא עודכן: בהנחיה, צריך לכלול את הערך הספציפי שרוצים לעדכן. הערכים מופיעים בדף הגדרות הפרויקט במסוף Firebase. לדוגמה, אפשר להזין את ההנחיה: "עדכן את measurementId בהגדרות שלי עם G-1234567890".
• האימות לא פועל כשמציגים את האפליקציה בתצוגה מקדימה: יכול להיות שתצטרכו לכלול את כתובת ה-URL של התצוגה המקדימה כדומיין מורשה:
  1. במצב Prototyper, לוחצים על open_in_new פתיחה בחלון חדש.
  2. בחלון התצוגה המקדימה החדש שנפתח, מעתיקים את כתובת ה-URL. שימו לב שכתובת ה-URL צריכה להתחיל ב-6000. אם היא מתחילה ב-9000, צריך לעדכן אותה לפני שממשיכים לשלב הבא.
  3. בדף הגדרות אימות במסוף Firebase, מוסיפים את כתובת ה-URL שהעתקתם בשלב הקודם אל הדומיינים המורשים. הערה: השיטה הזו מאפשרת רק את התצוגה המקדימה שמוצגת כברירת מחדל ב-Prototyper mode. The preview within Code view and the preview pop-out might not allow you to authenticate.
• לא נוצרו כללי אבטחה של Firebase: Gemini יכול לעזור לכם לכתוב כללי אבטחה, אבל עדיין לא יכול להוסיף אותם באופן אוטומטי לפרויקט Firebase שלכם. כדי לפרסם את הכללים, צריך להעתיק אותם אל מסוף Firebase.
• אינטראקציה לא צפויה עם שרת Firebase MCP: אם הגדרתם את שרת Firebase MCP, יכול להיות שתיתקלו בהתנהגות לא צפויה כשמשתמשים ב-Prototyper for Firebase integrations. If this occurs, switch to Code view and prompt Gemini in Firebase to integrate Firebase services.