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

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

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

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

אם IDX לא מתרענן כמו שצריך (בדרך כלל כתוצאה מפעולות קריאה מחדש משמעותיות או שינויים בקובץ monospace.json), מבצעים Hard אתחול, שזמין בחלונית הפקודות (Cmd+Shift+P ב-Mac או Ctrl+Shift+P ב-ChromeOS, ב-Windows או ב-Linux), בקטגוריה IDX.

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

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

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

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

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

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

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

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

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

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

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

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

איני מכיר את Linux. איך אפשר להיות פרודוקטיביים ב-Project IDX?

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

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

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

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

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

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

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

איך אפשר לשתף בבטחה את סביבת העבודה עם פרטי הכניסה שלי ל-Firebase?

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

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

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

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

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

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

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

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

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

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

1. בפרויקטים עם קצה עורפי של API אפשר להפעיל את שירותי ה-API באופן ידני בטרמינל או להגדיר את פקודת ההפעלה בקובץ monospace.json.

2. פותחים את היציאה שבה פועל שירות ה-API כדי שתהיה גישה לתצוגה המקדימה של ממשק האינטרנט על ידי הרצת הסקריפט הבא bash בטרמינל:

   export port=4000 #dont use restricted ports (8000, 9000-9002)
   export API_SERVICE="https://$port-$WEB_HOST"
   echo $API_SERVICE
   

3. פותחים את API_SERVICE URL שמעל כרטיסייה חדשה בדפדפן. הפעולה הזו מגדירה קובץ cookie נדרש באמצעות זרימת הפניה.

4. החזית של אפליקציית האינטרנט שלכם יכולה עכשיו לגשת לשירות ה-API בנתיב שמוגדר במלואו.

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

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

מה זה Code OSS?

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

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

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

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

נתקלתם בבעיה במהלך השימוש ב-Project IDX? דווחו לנו על באג.

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

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

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

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

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

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