ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

تكوين كود Visual Studio

Visual Studio هو محرر تعليمات برمجية مجاني يعمل على أنظمة تشغيل macOS و Linux و Windows.

لديها أدوات لطيفة لتطوير Python و C ++ ، مصحح أخطاء بصرية ، تكامل git ، والعديد من الميزات المفيدة. إنه محرر رائع للاستخدام في تطوير TensorFlow IO ، ولكنه يستغرق بعض الجهد لتكوينه بشكل صحيح. تكوين VSCode مرن للغاية ، فهو يسمح بتجميع المشروع باستخدام bazel ، وتشغيل التعليمات البرمجية تحت مصحح أخطاء Python و C ++. هذا الدليل مخصص لنظام التشغيل Linux ، وقد تحتوي أنظمة تشغيل أخرى على تفاصيل معينة ، ولكن يجب أن يكون النهج متشابهًا.

ملحقات

لتثبيت امتداد ، انقر فوق رمز عرض الملحقات (الملحقات) على الشريط الجانبي ، أو استخدم الاختصار Ctrl + Shift + X. ثم ابحث عن الكلمة الرئيسية أدناه.

تجميع المشاريع

يتم تجميع TensorFlow IO باستخدام أمر بناء bazel:

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

راجع ملف README للمشروع للحصول على تفاصيل حول كيفية إعداد بيئة التطوير في Ubuntu. - تشير إشارة dbg --compilation_mode هنا إلى أن الثنائي المنتج يجب أن يحتوي على رموز تصحيح. بمجرد أن تتمكن من ترجمة المشروع من سطر الأوامر ، يمكنك أيضًا تكوين VSCode لتتمكن من استدعاء نفس الأمر.

افتح View-> Command Pallete (Ctrl + Shift + P) وابدأ في الكتابة: "المهام: تكوين مهمة البناء". إذا كنت تفعل ذلك لأول مرة ، سيقترح المحرر إنشاء ملف task.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 سكريبت python يستخدم مكتبة 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 ، أضف التكوين التالي هنا:

 {
    "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 يستخدم نمط نمط مختلف. لحسن الحظ أنه من السهل التغيير.

لتنسيق Python ، راجع https://donjayamanne.github.io/pythonVSCodeDocs/docs/formatting/

لتكوين مُنسق C ++ ، قم بما يلي:

  • Go Preferences -> Settings
  • ابحث عن C_Cpp.clang_format_fallbackStyle
  • قم بتعديل الملف: setting.json مباشرة
  • أضف التالي
 "C_Cpp.clang_format_fallbackStyle": "{ BasedOnStyle: Google}"