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

توفر هذه المقالة نظرة عامة على واجهة المستخدم الخاصة بـ VEX Visual Studio Code Extension UI. يدعم الامتداد تطوير مشاريع 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 (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 مرتبطة بـ VEX Brain وتمكننا من تحديث VEXos لـ VEX Brain إذا كان إصدار VEXos الخاص بـ VEX Brain قديمًا.
  
  عندما يتم توصيل VEX Controller بالكمبيوتر، تُظهر فئة VEX DEVICE INFO ما إذا كان VEX Brain مرتبطًا بوحدة تحكم VEX وتمكننا من تحديث VEXos لوحدة تحكم VEX إذا كان إصدار VEXos الخاص بـ VEX Controller قديمًا. للحصول على وصف لمعلومات الجهاز وكيفية استخدام الميزات الموجودة ضمن معلومات
  VEX، يرجى مراجعة
  هذه المقالة.

• تعليقات 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 )
  ملاحظة: إذا تم توصيل وحدة تحكم بالكمبيوتر، ولكن ليس لديها رابط لاسلكي مع Brain، فلن يتم عرض اسم 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 هي:

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

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

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