نظرة عامة على واجهة المستخدم الخاصة بامتداد VEX VS Code

توفر هذه المقالة نظرة عامة على واجهة المستخدم الخاصة بـ VEX Visual Studio Code Extension. يدعم الامتداد تطوير مشاريع C++ وPython لمنصات VEX IQ (الجيل الثاني)، وEXP، وV5.

تخطيط واجهة المستخدم لامتداد VEX VS Code

تنقسم واجهة مستخدم ملحق VEX Visual Studio Code إلى خمس مناطق رئيسية: شريط النشاط، والشريط الجانبي، والمحرر، ولوحة المحطة الطرفية، وشريط الأدوات.

شريط النشاط

يتضمن شريط النشاط مجموعة من الرموز التي تتيح لنا التبديل بين العروض وتعطينا مؤشرات إضافية خاصة بالسياق لتطوير مشروع VEX.

الرموز الشائعة المستخدمة لتطوير مشروع VEX في VS Code هي:

• أيقونة عرض المستكشف - عند النقر عليها، يتم فتح عرض المستكشف في الشريط الجانبي.
• أيقونة عرض الإضافات - عند النقر عليها، يتم فتح عرض الإضافات في الشريط الجانبي.
• أيقونة عرض VEX - عند النقر عليها، يتم فتح عرض VEX في الشريط الجانبي.

شريط جانبي

يحتوي الشريط الجانبي على وجهات نظر مختلفة تمكننا من استخدام الأدوات المتكاملة داخل VS Code. إن عروض الشريط الجانبي الشائعة المستخدمة لأداء المهام لتطوير مشروع VEX هي عرض الامتداد، عرض VEX، و عرض المستكشف.

عرض الامتداد

يتم عرض الامتداد لتثبيت الامتدادات وإدارتها في VS Code. لتطوير البرامج على منصات VEX IQ (الجيل الثاني)، وEXP، وV5، نحتاج إلى تثبيت ملحق VEX، وملحق C/C++، وملحق Python.

للحصول على تعليمات خطوة بخطوة حول كيفية تثبيت ملحق VEX، ملحق C/C++، و ملحق Python في VS Code، يرجى مراجعة هذه المقالة.

عرض فيكس

يتيح لنا VEX View تطوير المشاريع الخاصة بـ VEX IQ (الجيل الثاني)، وEXP، وV5 في VS Code. هناك ثلاث فئات مدرجة في عرض VEX: إجراءات المشروع، معلومات جهاز VEX، و تعليقات VEX.

• إجراءات المشروع
  تُستخدم الأزرار الموجودة أسفل إجراءات المشروع لإنشاء مشروع VEX جديد أو استيراد مشروع VEXcode موجود.
  للحصول على إرشادات مفصلة حول إنشاء مشروع VEX في VS Code، يُرجى الاطلاع على هذه المقالة لإصدار V5، هذه المقالة لإصدار EXP، و هذه المقالة لإصدار IQ (الجيل الثاني).

• توفر لنا جهاز VEX نظرة VEX المتصل -Brain أو Controller.هذه
  إلى نوع جهاز VEX المتصل وتعرض معلومات Brain والمنفذ
  والبرنامج
  تموالأجهزة

  بالمنافذ الذكية
  VEX Brain. يسمح لنا بالتقاط لقطة شاشة لشاشة VEX Brain، وعرض سجل أحداث VEX Brain، وتعيين اسم الدماغ ورقم الفريق، ومحو برنامج المستخدم من VEX Brain.
  
  عندما يتم توصيل VEX Brain بالكمبيوتر، تُظهر فئة VEX DEVICE INFO ما إذا كان VEX Controller مرتبطًا بـ VEX Brain وتمكننا من تحديث VEXos لـ VEX Brain إذا كان إصدار VEXos الخاص بـ VEX Brain قديمًا.
  
  عندما يتم توصيل VEX Controller بالكمبيوتر، تُظهر فئة VEX DEVICE INFO ما إذا كان VEX Brain مرتبطًا بـ VEX Controller وتمكننا من تحديث VEXos لـ VEX Controller إذا كان إصدار VEXos الخاص بـ VEX Controller قديمًا.
  
  للحصول على وصف شامل لمعلومات الجهاز وكيفية استخدام الميزات الموجودة ضمن VEX DEVICE INFO، يرجى مراجعة هذه المقالة.

• تعليقات VEX
  يمكننا إرسال تعليقات إلى VEX عن طريق كتابة الرسالة في مربع النص أسفل VEX والنقر فوق إرسال
  للحصول على معلومات مفيدة حول استخدام تعليقات VEX في VS Code، يرجى الاطلاع المقالة.
  
  

عرض المستكشف

يتم استخدام View لاستعراض ملفات ومجلدات مشروع VEX وفتحها وإدارتها في VS Code.

محرر

المحرر هو المجال الرئيسي لتحرير الملفات في VS Code. يتيح ملحق VEX VS Code إمكانية Intellisense/Linting لكل من C/C++ وPython في منطقة المحرر لمساعدتنا أثناء تطوير البرنامج.

في منطقة المحرر، يمكننا الوصول إلى معلومات مفيدة حول وظيفة محددة عن طريق تحريك الماوس فوق نص الوظيفة أو باستخدام تعليمات أمر VEX للوصول إلى الوثائق الخاصة بهذه الوظيفة المضمنة في واجهة برمجة التطبيقات (API) الخاصة بلغة C++ وPython.

للحصول على تعليمات مفصلة حول استخدام أمر VEX Help في VS Code، يرجى الاطلاع على هذه المقالة.

لوحة طرفية

يوفر ملحق VEX VS Code محطتين عند بدء التشغيل، المحطة الطرفية السجلية والمحطة الطرفية التفاعلية. 

• محطة السجل - تعرض محطة السجل مخرجات البناء، وخطأ البناء، ونتائج التنزيل.
  
  

• المحطة الطرفية التفاعلية - تحتوي المحطة الطرفية التفاعلية على وظيفتين - عرض سجلات الطباعة وإرسال ضغطات المفاتيح الخام إلى برنامج المستخدم.
  
  

  

  
  
  ملاحظة: لاستخدام المحطة الطرفية التفاعلية، يجب توصيل الدماغ أو وحدة التحكم بجهاز كمبيوتر يعمل بنظام VEX VS Code Extension.
  ملاحظة: يتم مسح مخرجات المحطة الطرفية التفاعلية افتراضيًا بعد إنشاء برنامج المستخدم وتنزيله.

شريط الأدوات

يتضمن شريط الأدوات مجموعة من الرموز التي توفر لنا طريقة سريعة للتفاعل مع مشاريع توسعة VEX VS Code، وVEX Brains، وVEX Controllers.

ملاحظة: يكون شريط الأدوات نشطًا فقط عندما يكون مشروع VEX صالحًا مفتوحًا في VS Code. 

ملاحظة: مشروع VEX الصالح هو المشروع الذي تم إنشاؤه أو استيراده بواسطة الامتداد. لن يتم اعتبار مشاريع VEXcode أو VEXcode Pro المفتوحة في المحرر مشروع VEX صالحًا وسيتعين استيرادها.

تتضمن الأيقونات الموجودة على شريط الأدوات ما يلي:

• Device Picker - يعرض Device Picker أيقونة جهاز VEX المتصل (أيقونة Brain أو أيقونة Controller )
  ملاحظة: إذا تم توصيل وحدة تحكم بالكمبيوتر، ولكن ليس لديها رابط راديو مع الدماغ، فلن يتم عرض اسم الدماغ بجوار أيقونة وحدة التحكم.

• أيقونة اختيار الفتحة - تسمح لنا أيقونة اختيار الفتحة باختيار الفتحة التي سيقوم ملحق VEX بتنزيلها أو تشغيل برنامج المستخدم عليها من خلال النقر عليها واختيار واحدة من الفتحات الثمانية المتوفرة على VEX Brain من قائمة الاختيار.
• الإصدار & أيقونة التنزيل - إذا تم توصيل جهاز VEX، فسوف تظهر أيقونة التنزيل على شريط. عند النقر فوقه، سيتم بناء المشروع، وإذا نجح، سيتم تنزيله على جهاز VEX المتصل.
• أيقونة التشغيل - عند النقر عليها، تقوم أيقونة التشغيل بتشغيل برنامج المستخدم الذي تم تنزيله في الفتحة المحددة على VEX Brain.
• أيقونة التوقف - عند النقر عليها، أيقونة التوقف تتوقف عن تشغيل برنامج المستخدم على VEX Brain.
• محدد المشروع - يعرض محدد المشروع اسم المشروع المحدد. يتيح لنا رمز محدد المشروع التبديل بين مشاريع VEX عند وجود العديد منها داخل مساحة عن طريق النقر فوقه وتحديد مشروع من قائمة الاختيار.
• Python File Selector (Python Only) - عند تحديد مشروع VEX Python، سيظهر File Selector في شريط الأدوات. يعرض محدد ملف Python اسم ملف Python المحدد. يدعم Python for VEX حاليًا تنزيلات الملفات الفردية فقط.

للحصول على معلومات مفيدة حول كيفية استخدام ميزات شريط الأدوات في VS Code، يرجى مراجعة هذه المقالة.

إعدادات مستخدم VEX

تتيح لنا إعدادات مستخدم VEX تكوين ملحق VEX وفقًا لمتطلباتنا الخاصة. إعدادات المستخدم هي إعدادات عالمية يتم تطبيقها على كل مشروع ملحق VEX VS Code. يمكننا الوصول إلى إعدادات مستخدم VEX من خلال النقر فوق أيقونة الإعدادات في VS Code وتحديد العناصر المقابلة في القوائم.

إعدادات مستخدم VEX لتكوين ملحق VEX VS Code هي:

• مسار سلسلة أدوات CPP - يحدد المسار لسلسلة أدوات CPP.
• تمكين محطة المستخدم- تمكين أو تعطيل الامتداد لفتح وعرض البيانات من منفذ المستخدم.
• إدخالات السجل - يحدد عدد إدخالات السجل التي سيتم تحميلها من VEX Brain.
• نوع بناء المشروع - يحدد كيفية قيام الامتداد ببناء مشروع C++.
• الصفحة الرئيسية للمشروع - تعيين الموقع الافتراضي للمشاريع الجديدة.
• تشغيل بعد التنزيل - يحدد ما إذا كان يجب تشغيل برنامج المستخدم بعد تنزيله إلى VEX Brain.
• نظام استرداد DFU التلقائي - يحدد ما إذا كان يجب على الدماغ الاسترداد التلقائي عند اكتشاف دماغ IQ (الجيل الثاني) أو EXP في وضع DFU.
• تمكين خادم Websocket - تمكين أو تعطيل الامتداد لبدء تشغيل خادم Websocket.
• عنوان مضيف خادم Websocket - يحدد عنوان المضيف لخادم Websocket.
• منفذ خادم Websocket - تعيين رقم منفذ خادم Websocket

للحصول على معلومات مفيدة حول كيفية الوصول إلى إعدادات مستخدم VEX وتعيينها، راجع هذه المقالة.