نظرة عامة على واجهة مستخدم ملحق 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

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

شريط الأدوات

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

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

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

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

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

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