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

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

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

איך מעדכנים לגרסה האחרונה של React או Next.js?

נקודת חולשה קריטית בביצוע קוד מרחוק (RCE) משפיעה על אפליקציות שנוצרו באמצעות Next.js ורכיבי שרת React. כדי להגן על האפליקציה והנתונים, צריך לעדכן לגרסה היציבה האחרונה.

1. פותחים את הפרויקט ב-Firebase Studio ועוברים לתצוגה Code.
2. פותחים את הטרמינל (Shift+Ctrl+C) ומריצים את הפקודה npx fix-react2shell-next.
3. פועלים לפי ההנחיות במסוף כדי להמשיך ולהחיל תיקונים.
4. בסיום התהליך, מפרסמים את האפליקציה המעודכנת.

כשפותחים סביבת עבודה, מוצגת ההודעה לא ניתן להעביר את הבקשה שלך לשרת העורפי. מופיעה ההודעההחיבור לשרת ביציאה 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
• ‫10GiB לספרייה /home

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

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

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

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

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

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

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

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

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

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

בסביבות העבודה של Firebase Studio יש גרסת Flutter שלא תואמת לפרויקט שלי.

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

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

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

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

איך מסובבים את המפתח של Gemini API?

כדי להחליף את מפתח Gemini API שמשמש בפרויקט Firebase Studio, צריך ליצור מפתח חדש ב-Google AI Studio ולעדכן אותו ב-Firebase Studio workspace.

1. יצירת מפתח API חדש

   1. עוברים אל הדף Google AI Studio מפתחות API.
   2. לוחצים על Create API key (יצירת מפתח API).
   3. נותנים שם למפתח ה-API ובוחרים את פרויקט Google Cloud הנכון. יכול להיות שתצטרכו לייבא את הפרויקט אם הוא לא מופיע ברשימה.
   4. לוחצים על Create key.
   5. מעתיקים את מפתח ה-API החדש שנוצר.

2. עדכון מפתח ה-API בFirebase Studioפרויקט

   1. פותחים את סביבת העבודה של Firebase Studio.
   2. עוברים לתצוגה Code.
   3. פותחים את הקובץ .env (שנמצא במיקום /home/user/studio/.env).
   4. מחליפים את הערך הישן של GEMINI_API_KEY במפתח החדש שהעתקתם.

3. פריסה מחדש או הפעלה מחדש (אם צריך)

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

4. ביטול התוקף של מפתח ה-API הישן

   • למפתחות שנוצרו אוטומטית על ידי Firebase Studio:
     1. עוברים אל Google AI Studio.
     2. מייבאים את הפרויקט Firebase של סביבת העבודה Firebase Studio אל Google AI Studio.
     3. מאתרים את מפתח ה-API שנוצר אוטומטית מהפרויקט הזה ומוחקים אותו.
   • למפתחות שנוצרו ב-Google AI Studio או במסוף Google Cloud:
     1. עוברים אל Google AI Studio הדף API keys או אל הדף Credentials במסוף Google Cloud.
     2. מאתרים את מפתח ה-API הישן שהחלפתם ומוחקים אותו.

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

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

אם מוצגת השגיאה "Too many projects with this billing account" (יותר מדי פרויקטים עם החשבון הזה לחיוב):

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

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

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

איך אפשר לגרום ל-App Prototyping agent להוסיף אוטומטית את Cloud Firestore ואת Firebase Authentication לאפליקציה שלי?

מבקשים מ-App Prototyping agent להוסיף מסד נתונים או אימות בזמן העבודה על אפליקציה קיימת. כשמבקשים להוסיף מסד נתונים או אימות,‏ App Prototyping agent מבקש אישור. אם תאשרו, App Prototyping agent יגדיר בשבילכם פרויקט Firebase עם שירותי ה-Backend המבוקשים.

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

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

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

לדוגמה, אם מופיעה שגיאה ב-Firebase כמו Property access is undefined on object. for 'list' @ L6, שמעידה על בעיה בכללים, כדאי להוסיף לפני השגיאה את השאלה: "אתה יכול לעזור לי לתקן את הבעיה הזו בכללים?".Cloud FirestoreCloud Firestore

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

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

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

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

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

3. מעתיקים את השגיאה ומדביקים אותה בצ'אט עם App Prototyping agent או Gemini בסביבת העבודה, ומבקשים מ-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. אם הסוכן עדיין לא מגיב או מחזיר שגיאה, נסו להסתעף מגרסה מוקדמת יותר של האפליקציה.

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

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

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

• קובץ התצורה לא עודכן: בהנחיה, צריך לכלול את הערך הספציפי שרוצים לעדכן. אפשר למצוא את הערכים בדף הגדרות הפרויקט במסוף Firebase. לדוגמה, אפשר להזין את ההנחיה: "עדכן את measurementId בהגדרות שלי עם G-1234567890".
• האימות לא פועל כשמציגים את האפליקציה בתצוגה מקדימה: יכול להיות שתצטרכו לכלול את כתובת ה-URL של התצוגה המקדימה כדומיין מורשה:
  1. במצב Prototyper, לוחצים על open_in_new פתיחה בחלון חדש.
  2. בחלון התצוגה המקדימה החדש שנפתח, מעתיקים את כתובת ה-URL. שימו לב שכתובת ה-URL צריכה להתחיל ב-6000. אם היא מתחילה ב-9000, צריך לעדכן אותה לפני שממשיכים לשלב הבא.
  3. בדף הגדרות אימות במסוף Firebase, מוסיפים את כתובת ה-URL שהעתקתם בשלב הקודם אל הדומיינים המורשים. הערה: השיטה הזו מפעילה רק את התצוגה המקדימה שמוצגת כברירת מחדל במצב Prototyper. יכול להיות שלא תהיה אפשרות לבצע אימות בתצוגה המקדימה בתוך Codeהתצוגה ובחלון התצוגה המקדימה המוקפץ.
• לא נוצרו כללי אבטחה של Firebase: Gemini יכול לעזור לכם לכתוב כללי אבטחה, אבל עדיין לא יכול להוסיף אותם באופן אוטומטי לפרויקט Firebase שלכם. כדי לפרסם את הכללים, צריך להעתיק אותם אל מסוף Firebase.
• אינטראקציה לא צפויה עם שרת ה-MCP של Firebase: אם הגדרתם את שרת ה-MCP של Firebase, יכול להיות שתיתקלו בהתנהגות לא צפויה כשמשתמשים ב-Prototyper לשילובים של Firebase. במקרה כזה, צריך לעבור לתצוגה Code ולתת הנחיה ל-Gemini לשלב שירותי Firebase.

איך משנים את סמל האתר של האפליקציה?

אפשר לשנות את הסמל מתוך Firebase Studio:

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

2. אם הוא לא פעיל, לוחצים על Explorer (Ctrl+Shift+E או Cmd+Shift+E ב-Mac) כדי לראות את כל הקבצים.

3. מרחיבים את src, לוחצים לחיצה ימנית על הספרייה app ובוחרים באפשרות העלאה...

4. כשתתבקשו, תצטרכו לעבור אל קובץ favicon.ico ולבחור אותו ממערכת הקבצים המקומית.

5. כשמופיעה בקשה להחליף את קובץ הסמל הקיים, לוחצים על החלפה.

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