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

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

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

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

 

شريط الأنشطة

يتضمن شريط النشاط مجموعة من الرموز التي تسمح لنا بالتبديل بين العروض وتمنحنا مؤشرات إضافية خاصة بالسياق لتطوير مشروع 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 View تطوير مشاريع لـ VEX IQ الجيل الثاني وEXP وV5 في VS Code. هناك ثلاث فئات مدرجة في عرض VEX: إجراءات المشروع، معلومات جهاز VEX، و تعليقات VEX.

 

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

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

  

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

• ملاحظات VEX
  يمكننا إرسال ملاحظات إلى VEX عن طريق كتابة الرسالة في مربع النص أسفل ملاحظات VEX والنقر على زر إرسال
  للحصول على معلومات مفيدة حول استخدام VEX FEEDBACK في 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.
  ملاحظة: يتم مسح مخرجات المحطة التفاعلية بشكل افتراضي بعد إنشاء برنامج المستخدم وتنزيله.

شريط الأدوات

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

 

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

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

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

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

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

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

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

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

 

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

• قناة وحدة التحكم (وحدة التحكم V5 فقط) - تعيين قناة راديو وحدة التحكم V5 إلى تنزيل أو حفرة. ينطبق هذا الإعداد على رابط الراديو VEXnet فقط.

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

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