דף זה תורגם על ידי Cloud Translation API.
Switch to English

קביעת תצורה של קוד Visual Studio

קוד Visual Studio (VSCode) הוא עורך קוד חינמי, הפועל במערכות ההפעלה macOS, Linux ו- Windows. יש לו תמיכת כלים מהודרת שתומכת בפיתוח Python & C ++, ניפוי חזותי, שילוב עם git ותכונות מעניינות רבות נוספות. בשל קלות השימוש וניהול ההרחבות, הוא עורך מצוין לפיתוח TensorFlow IO. עם זאת, יש צורך במאמץ מסוים בכדי להגדירו כראוי. מכיוון שתצורת VSCode מאוד גמישה, היא מאפשרת למפתחים לקמפל פרוייקט באמצעות bazel ולהריץ את הקוד תחת ניפוי פאגים של Python ו- C ++. הגדרת כלי הבסיס עשויה להיות שונה על פי מערכות ההפעלה, אך גישת התצורה צריכה להיות דומה.

הרחבות

להתקנת הרחבה לחץ על סמל תצוגת התוספים (הרחבות) בסרגל הצד, או השתמש בקיצור הדרך Ctrl + Shift + X. ואז צור למילת המפתח בהמשך.

הידור פרויקטים

TensorFlow IO מורכב באמצעות פקודת build bazel:

bazel build -s --verbose_failures --compilation_mode dbg //tensorflow_io/...

ראה קובץ README של הפרויקט לקבלת פרטים על אופן הגדרת סביבת הפיתוח באובונטו. --compilation_mode דגל dbg כאן מציין כי בינארי המיוצר צריך להיות בעל סמלי ניפוי באגים. ברגע שתוכל לקמפל פרויקט משורת הפקודה, תוכל גם להגדיר את VSCode כך שתוכל להפעיל את אותה פקודה.

פתח תצוגה-> פקודת Pallete ( Ctrl + Shift + P ) והתחל להקליד: "משימות: הגדר משימה לבנות". אם אתה עושה זאת בפעם הראשונה, העורך יציע ליצור קובץ Tasks.json. ברגע שיש לך את זה, הדבק את ה- json הבא:

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Build TF.IO (Debug)",
            "type": "shell",
            "command": "bazel build -s --verbose_failures --compilation_mode dbg //tensorflow_io/...",
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": []
        }
    ]
}

עכשיו אתה יכול ללחוץ על Ctrl + Shift + B , ו- VSCode ישתמש בפקודה לעיל כדי לבנות את הפרויקט. הוא משתמש בחלון מסוף משלו, בו ניתן ללחוץ על כל הקישורים. לכן כאשר מתרחשת שגיאת אוסף, אתה פותח את הקובץ המתאים ומנווט לקו פשוט על ידי לחיצה על הקישור בחלון המסוף.

איתור באגים בפרויקטים

ניפוי שגיאות בקוד Python הוא טריוויאלי, עקוב אחר התיעוד הרשמי כדי להבין כיצד להגדיר את התצורה של VSCode כדי לאפשר זאת: https://code.visualstudio.com/docs/python/debugging

עם זאת, איתור באגים ב- C ++ מחייב התקנת GDB במערכת שלך. אם יש לך סקריפט פיתון bq_sample_read.py המשתמש tensorflow-io ומבוצע בדרך כלל באופן הבא:

python3 bq_sample_read.py --gcp_project_id=...

אתה יכול לבצע את זה תחת GDB באמצעות הדברים הבאים:

gdb -ex r --args python3 bq_sample_read.py --gcp_project_id=...

אם היישום מתרסק בשלב קוד C ++, באפשרותך להפעיל backtrace במסוף GDB כדי לקבל את ערימת השגיאה.

ל- VSCode יש גם תמיכה ב- GDB באגים. זה מאפשר להוסיף נקודות מעבר, להתבונן בערכי משתנים ולעבור בקוד בצורה צעד אחר צעד. כדי להוסיף תצורת ניפוי שגיאות לחץ על סמל תצוגת איתור באגים (ניפוי באגים) בסרגל הצד, או השתמש בקיצור הדרך Ctrl + Shift + D. כאן לחץ על החץ הקטן למטה לצד כפתור ההפעלה ובחר "הוסף תצורה ...". כעת הוא launch.json קובץ launch.json , אליו אנא הוסף את התצורה הבאה:

{
    "name": "(gdb) Launch",
    "type": "cppdbg",
    "request": "launch",
    "program": "/usr/bin/python3",
    "args": ["bq_sample_read.py", "--gcp_project_id=..."],
    "stopAtEntry": false,
    "cwd": "${workspaceFolder}",
    "environment": [
        {
            /* path to your bazel-bin folder */
            "name": "TFIO_DATAPATH",
            "value": "/usr/local/google/home/io/bazel-bin"
        },
        {
            /* other env variables to use */
            "name": "GOOGLE_APPLICATION_CREDENTIALS",
            "value": "..."
        }
    ],
    "externalConsole": false,
    "MIMode": "gdb",
    "setupCommands": [
        {
            "description": "Enable pretty-printing for gdb",
            "text": "-enable-pretty-printing",
            "ignoreFailures": true
        }
    ]
}

אם הכל מוגדר כהלכה, אתה אמור להיות מסוגל לבצע הפעלה -> התחל איתור באגים ( F5 ) או הפעל -> הפעל ללא ניפוי באגים ( Ctrl + F5 ). פעולה זו תריץ את הקוד שלך תחת איתור באגים:

איתור באגים ב- VSCode

על מנת לפשט עוד יותר את חווית הבאגים, באפשרותך להגדיר את GDB לדלג על ספריות C ++ רגילות. זה מאפשר לך להתעלם מהקוד שלא אכפת לך ממנו. לשם כך, צור קובץ ~/.gdbinit עם התוכן הבא:

skip -gfi /usr/include/c++/*/*/*
skip -gfi /usr/include/c++/*/*
skip -gfi /usr/include/c++/*

עיצוב קבצים

אתה תמיד יכול לעצב מחדש את קובץ C ++ או Python על ידי לחיצה ימנית -> עיצוב מסמך ( Ctrl + Shift + I ), אך VSCode משתמש במוסכמת סגנון שונה. למרבה המזל, קל לשנות אותו.

לעיצוב פייתון, ראה https://donjayamanne.github.io/pythonVSCodeDocs/docs/formatting/

לצורך עיצוב C ++, בצע את הפעולות הבאות:

  • עבור אל העדפות -> הגדרות
  • חפש "C_Cpp.clang_format_fallbackStyle"
  • שנה את file:setting.json ישירות על ידי הוספת התוכן הבא
"C_Cpp.clang_format_fallbackStyle": "{ BasedOnStyle: Google}"