פתרון בעיות בפרויקט IDX & שאלות נפוצות

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

כשפותחים סביבת עבודה, מופיעה ההודעה Unable to forward your request to backend. לא ניתן היה להתחבר לשרת ביציאה 80.

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

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

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

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

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

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

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

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

ב-IDX יש מגבלה של סביבת עבודה אחת לכל משתמש. אם יש לכם פרופיל מפתח ב-Google, תוכלו ליצור עד חמש סביבות עבודה. כדי ליצור פרופיל פיתוח של Google ישירות מ-IDX אחרי שמגיעים למגבלה של סביבת העבודה, לוחצים על Complete Setup בהתראה שמוצגת בלוח הבקרה של התבנית.

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

אנחנו פועלים באופן פעיל לשיפור האמינות של המהדמנים מבוססי הענן שלנו. אם הרענון של הדף לא פותר את הבעיה, אפשר לדווח על הבעיה.

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

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

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

מה ההבדל בין Project IDX לבין Google Cloud Workstations?

פיתחנו את IDX על בסיס תחנות העבודה של Google Cloud שזמינות לכלל המשתמשים (Cloud Workstations). Cloud Workstations הוא חבילת שירותי תשתית שמתמקדת בזמינות, באבטחה ובאמינות של תחנות העבודה של המפתחים.

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

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

כדי להפעיל את IDX, צריך להפעיל קובצי cookie של צד שלישי כי אנחנו מעבדים IFRAME מדומיין אחד (דומיין משנה של cloudworkstations.dev) בדומיין אחר (idx.google.com), וקובצי cookie של צד שלישי מאפשרים תקשורת מאובטחת בין מקורות שונים.

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

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

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

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

האם אפשר להשתמש ב-IDX כדי ליצור אפליקציה עם frameworks שאין להם תבנית ב-IDX?

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

האם אפשר לייבא את המאגר מ-GitLab או ממאגרים של Cloud Source?

בשלב הזה אנחנו תומכים בייבוא פרויקטים מ-GitHub, מ-GitLab ומ-Bitbucket. אם אתם רוצים שנוסיף תמיכה למארחים נוספים של Git, תוכלו לשלוח בקשה להוספת תכונה.

בינתיים, תוכלו ליצור סביבת עבודה חדשה מתבנית קיימת ולהריץ את git clone עם כל מארח Git שמבוסס על https או ssh במסוף, כמו שאתם עושים בדרך כלל במכונה המקומית.

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

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

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

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

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

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

3. 

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

4. לוחצים על הסמל Make Public (מנעול) שמשמאל למספר היציאה.

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

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

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

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

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

פותחים את לוח הפקודות (Cmd+Shift+P ב-Mac או Ctrl+Shift+P ב-ChromeOS, ב-Windows או ב-Linux) ובוחרים באפשרות Project IDX: Show Android Preview או Project IDX: Show Web Preview.

מה זה Code OSS?

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

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

אם אתם לא רוצים שההנחיות של Gemini Chat ישמשו כנתוני אימון לשיפור Gemini ב-IDX, אל תשתמשו בעוזר הדיגיטלי בצ'אט והשביתו את השלמת הקוד בהגדרות של סביבת העבודה. אפשר גם להשבית את העזרה כשעובדים עם קובצי .aiexclude ספציפיים על ידי הוספת הקובץ למאגר.

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

אם נתקלתם בבעיה בזמן השימוש ב-Project IDX, אתם יכולים לשאול שאלה בפורום או לדווח על באג.

אם יש תכונה שאתם רוצים להוסיף ל-IDX, או תכונה קיימת שאתם רוצים להרחיב, תוכלו לשלוח בקשה להוספת תכונה.

איך אפשר לבדוק אם Gemini ב-IDX זמין במדינה או באזור שלי?

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

השתמשתי בתכונה מסוימת ב-Project IDX אבל לא הצלחתי למצוא אותה. למה הוא הוסר?

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