هذه صفحة لقطة ثنائية اللغة تم حفظها بواسطة المستخدم في 2024-9-18 21:51 لـ https://blogs.mathworks.com/matlab/2023/04/26/do-you-use-visual-studio-code-matlab-is-now-there-too/، مقدمة بدعم ثنائي اللغة من قبل الترجمة الغامرة. تعلم كيفية الحفظ؟

The MATLAB Blog

Practical Advice for People on the Leading Edge

Do you use Visual Studio Code? MATLAB is now there too.
هل تستخدم Visual Studio Code؟ الآن MATLAB 也有了。

Along with many other developers, it was love at first sight for me when I first experienced Visual Studio Code. Highly customisable, easy to use and available for all 3 major operating systems; it took hardly any time at all for me to switch from using a plethora of editors across all my machines to using just two – The MATLAB Editor and Visual Studio Code.
كما هو الحال مع العديد من المطورين الآخرين، كان لدي حب في البداية عندما تجربة لأول مرة Visual Studio Code. مُتخصصة بدرجة عاليه، سهل الاستخدام ومتاح لجميع الأنظمة التشغيل الثلاثة الكبيرة؛ لم يستغرق وقتا طويلا ليتبديل من استخدام مجموعة منедакتات عبر جميع أجهزتي إلى استخدام فقط اثنين - محرر MATLAB وVisual Studio Code.

MathWorks releases MATLAB extension for Visual Studio Code
مطوري MathWorks يطلق توسعة MATLAB لـ Visual Studio Code

For the impatient among you, let’s get straight to the point. MathWorks now support Visual Studio Code and have made the official MATLAB Extension available via the Visual Studio Marketplace. You can also find it on GitHub at https://github.com/mathworks/matlab-extension-for-vscode
للذين يشعرون بالصبر، دعونا نذهب مباشرة إلى النقطة. يدعم MathWorks الآن Visual Studio Code ويقدم ملحق MATLAB الرسمي عبر سوق Visual Studio. يمكنك أيضًا العثور عليه على GitHub في https://github.com/mathworks/matlab-extension-for-vscode
The extension provides a set of functionality that makes it easier to edit and develop MATLAB code in Visual Studio Code. I’ll explore some of this functionality in detail later. We’ve built this as part of a project that aims to meet MATLAB users wherever they are; and a lot of MATLAB users are in Visual Studio Code.
توفّر التمديد مجموعة من�能لية تجعل من الأسهل تحرير وتطوير كود MATLAB في Visual Studio Code. سأكشف عن بعض هذه القدرات بتفصيل في وقت لاحق. لقد قمنا بتطوير هذا كجزء من مشروع يهدف إلى التواجد حيث يجدونه مستخدمو MATLAB؛ وعدد كبير من مستخدمي MATLAB يجدونه في Visual Studio Code.
This is version 1 of an integration that intend to develop further and so we welcome your feedback. If you encounter a technical issue or have an enhancement request, create an issue on GitHub or contact MathWorks at https://www.mathworks.com/support/contact_us.html
هذا هو الإصدار 1 من التكامل الذي نخطط لتطويره بمرور الوقت، لذا نتطلع إلى تلقي آرائكم. إذا واجهتم مشكلة تكنولوجية أو لديكم طلب للتحسين، فقم بإنشاء مشكلة على GitHub أو اتصل بـ MathWorks على الرابط التالي: https://www.mathworks.com/support/contact_us.html
.
With that out of the way, I invite you to settle in and explore some of the details with me.
بعد أن انتهى الأمر، أدعوك للاستقرار وتحليل بعض التفاصيل معي.

Features of the MATLAB extension for VS Code
خصائص التوسيع لـ MATLAB لـ VS Code

The extension has a set of basic features, which work whether or not you have MATLAB installed on your system, and a set of advanced features that require MATLAB.
تمت الإزاحة إلى مجموعة من الميزات الأساسية، والتي تعمل سواء كان لديك MATLAB مثبتًا في نظامك أو لا، ومجموعة من الميزات المتقدمة التي تتطلب MATLAB.

Basic features (MATLAB not required)
خصائص أساسية (لا يتطلب MATLAB)

Everybody gets the following basic features
الجميع يحصل على الميزات الأساسية التالية
  • Syntax highlighting التعزيز النحوي
  • Code snippets الكود المقتطفات
  • Commenting التعليق
  • Code folding 접기 코드
The simplest thing expected of any language extension for Visual Studio Code is syntax highlighting. Below, you can see how a MATLAB class definition appeared in my Visual Studio Code running in Dark Mode, both with (bottom) and without (top) the extension activated.
الترجمة المطلوبة للنص الأصلي إلى اللغة العربية: الشيء البسيط المطلوب من أي تمديد لغة لـ Visual Studio Code هو تكبير الألوان. في الجهة السفلية، يمكنك رؤية كيف ظهر تعريف فئة MATLAB في نسخة Visual Studio Code التي أعمل عليها في مode المظلم، كلاً مع (الأسفل) وبدون (ال위) التمديد مفعل.
Code Snippets in Visual Studio Code are templates for common code patterns such as for-loops, function definitions or conditional blocks. Not only are they convenient time-savers that can reduce the number of keystrokes required as you code but they are also useful if, like me, you switch between programming languages a lot and muddle the syntax for some constructs in your head. The MATLAB extension supports a set of these code snippets and more can be added in the future. Pressing CRTL and Space will bring up the list that you can choose from using either the mouse or keyboard.
القطع البرمجية في Visual Studio Code هي نماذج لأساليب برمجية شائعة مثل حلقات for، تعريف الدوال أو أقسام الشرط. ليس فقط تساعد في توفير الوقت والكлавات التي تُستغرقها أثناء البرمجة، بل أيضًا مفيدة إذا، مثلما أفعل، تغيرت بين لغات البرمجة كثيرًا وتشتتت القواعد النحوية لبعض الأنظمة في رأسك. تدعم إمتداد MATLAB مجموعة من هذه الأسطر البرمجية ويمكن إضافة المزيد في المستقبل. الضغط على CRTL و الفضاء سيعمل على عرض القائمة التي يمكنك اختيارها من خلال الماوس أو لوحة المفاتيح.
code_snippet1.gif
Alternatively, just start typing and use the keyboard to select the relevant snippet
بديلًا، ابدأ في الكتابة واستخدم لوحة المفاتيح لاختيار المقطع المتعلق
code_snippet2.gif
Commenting a line is achieved with CTRL (or Command on Mac) and / after placing the cursor anywhere on the line you wish to comment out. You can also select a section of text and use CTRL and / to comment it all.
التعليق على خط هو محقق من خلال استخدام CTRL (أو Comman على Mac) و/ بعد وضع المزود في أي مكان على الخط الذي ترغب في تعليقه. يمكنك أيضًا تحديد جزء من النص و استخدام CTRL و/ لتعليقه جميعًا.
commenting.gif
The final feature that’s available to everyone is code folding – useful for summarising and navigating large code files
ال特徴 النهائية المتاحة لكل شخص هي تضمين الكود - مفيدة للاستعراض والتنقل في ملفات الكود الكبيرة
coldfolding.gif

Advanced features (MATLAB Install required)
الميزات المتقدمة (تتطلب تثبيت MATLAB)

For those who do have MATLAB R2021a or later installed, there is a lot more available because of the additional infrastructure that MATLAB provides. For example:
للأشخاص الذين لديهم MATLAB R2021a أو ما بعده مثبت، هناك الكثير متاح بسبب البنية التحتية الإضافية التي يوفرها MATLAB. على سبيل المثال:
  • Automatic code completion
    إتمام الكود التلقائي
  • Source code formatting (document formatting)
    تنسيق الكود المصدر (تنسيق المستند)
  • Code navigation تنقل الكود
  • Code analysis, such as continuous code checking and automatic fixes
    تحليل الكود، مثل التحقق المستمر من الكود والتصحيحات التلقائية
My favourite feature is the code analysis – something that I rely on hugely when using the MATLAB Editor. It’s great to have this available in Visual Studio Code too. It gives coding advice as you go. For example, in the example below, I copied and pasted something from some ancient MATLAB code that is no longer recommended.
특징 المفضل لدي هو تحليل الكود - شيء أعتمد عليه كثيرًا عند استخدام محرر MATLAB. من المدهش أن يكون هذا متاحًا أيضًا في Visual Studio Code. يوفر توجيهًا للبرمجة أثناء العمل. على سبيل المثال، في المثال أدناه، قمت بنسخ وصياغة شيء من كود MATLAB القديم الذي لم يعد موصى به.
code_analyze.gif
The code analyzer recognises this and underlines it for me. When I hover over the underline, it tells me why it chose to bring this to my attention and advises what I might be able to do about it.
التحليلатор للكود يدركت هذا ويقوم بتعليقه لي. عندما أمرر فوق التعليق، يخبرني لماذا قرر أن يجذبني إلى انتباهي ويقدم لي ما يمكنني من إجراءه بشأنه.
We can also see code completion in action in the above example. When I start typing rng, it shows me that the function signature is rng(seed,generator). As I continue typing it shows me the possible options for generator.
يمكننا أيضًا رؤية تكملة الكود في العمل في المثال المقدم أعلاه. عندما أبدأ في الكتابة rng، يظهر لي أن сигнатورة الدالة(rng) هي rng(النقطة المبدأية،المحرر).随我继续输入,它向我展示了可能的选项(generator)。
This stuff requires a headless MATLAB to be running in the background. By default, this is launched as soon as the extension starts but this can be controlled via the extension settings. You can even switch it off altogether if you don’t want this functionality
هذا الأداة تتطلب MATLAB بدون رأس يعمل في الخلفية. بالافتراض، يتم تفعيله فور البدء للتوسيع ولكن يمكن التحكم فيه عبر إعدادات التوسيع. يمكنك حتى إيقافهaltogether إذا لم ترغب في�能ية هذا.

What’s missing from this version of the extension?
ما هو 缺失从这个扩展版本?

Version 1 of the extension is focused on providing a feature-rich MATLAB code editing experience in Visual Studio Code. As such, it doesn’t include things such as the ability to execute MATLAB code or debugging support. However, version 1 is just the beginning and these things are on the radar. If there is anything you would like to see, do let us know by creating an issue on GitHub or contact MathWorks at https://www.mathworks.com/support/contact_us.html
النسخة الأولى من الإضافة تركز على تقديم تجربة تحرير كود MATLAB غنية بالوظائف في Visual Studio Code. لذا، لا تشمل القدرة على تنفيذ كود MATLAB أو دعم الترميم. ومع ذلك، هي النهاية الأولى والشيء الذي يجدر به في الاعتبار. إذا كان لديك أي شيء ترغب في رؤيته، فاتصل بنا من خلال إنشاء مشكلة على GitHub أو اتصل بـ MathWorks عبر الرابط التالي: https://www.mathworks.com/support/contact_us.html
.

Pull Requests are welcome
الطلبات المعلقة مُتاحة

The extension’s source code is available on GitHub under the MIT license but you might notice that some of the source code is in the form of .p files that are not human-readable by design. This is because those files make use of internal APIs that we are not ready to expose. Our plan is to create documented versions of those APIs and as we do so, we’ll replace the .p with .m.
الكود المصدر للتوسيع متاح على GitHub تحت رخصة MIT ولكن قد تلاحظ أن بعض الكود المصدر موجود في شكل ملفات .p التي ليست قابلة للقراءة للإنسان بتصميمها. هذا بسبب أن هذه الملفات تستخدم تطبيقات الواجهة الداخلية التي لا نخطط لعرضها. نحن نخطط لخلق نسخ مكتوبة من تلك التطبيقات وعندما نفعل ذلك، سنحلل ملفات .p بملفات .m.
All of this will help us in our aim developing this extension in collaboration with the community. As such, Pull Requests are welcome and details about the process can be found in the Contributing.md file in the GitHub repo.
كل هذا سيساعدنا في هدفنا لتطوير هذا الإ�تداء بالتعاون مع المجتمع. على هذا النحو، تقبل طلبات الانسحاب وتفاصيل العملية يمكن العثور عليها في ملف Contributing.md في مخزن GitHub.

Thank you Xavier Hahn! شكراً لك Xavier Hahn!

While on the subject of community, I’d like to give a shoutout to Xavier Hahn who has been maintaining the most popular MATLAB extension for Visual Studio Code with over half a million installs. Lately, he was unable to devote time to develop it further and some users expressed interest in MathWorks stepping in.
في سياق الحديث عن المجتمع، أود أن أقدم تكريمًا لخوسيه هاين الذي يحافظ على المضافة الأكثر شعبية لـMATLAB لـVisual Studio Code، مع أكثر من Half مليون تثبيت. في الآونة الأخيرة، لم يكن لديه وقت للتركيز على تطويرها بشكل أكبر، وعبر بعض المستخدمين تعبير عن اهتمامهم في تدخل شركة MathWorks.
“Why build something new? Why not just take over Xavier’s project?” I hear you asking. Good question. I asked it too when this project was announced internally, and the answer is that we have chosen to adopt a different architecture. Our extension leverages Microsoft's Language Server Protocol (LSP). This will result in a MATLAB language server that can be reused between IDEs that provide pluggable language support through the LSP interface.
"لماذا بناء شيء جديد؟ لماذا لا نأخذ في الاعتبار مشروع كريستيان؟" أسمعك تسأل. سؤال جيد. سألته أيضا عندما أعلن المشروع داخل الشركة، والجواب هو أننا قررنا اعتماد نشاط معمول به. توسعتنا تستخدم بروتوكول خادم اللغة لشركة ميكروسوفت (LSP). هذا سينتج عن خادم لغة MATLAB يمكن إعادة استخدامه بين بيئات التطوير التي تقدم دعم لغة قابل للتركيب عبر الواجهة لـ LSP.
We’ve been discussing the transition with Xavier, and he decided he would advise his users to migrate to this new extension and would deprecate his project. Thank you, Xavier, for your support and vision over the years. Without the success of his project among MATLAB users, we would have not come to embrace the idea of supporting this very popular IDE.
قدمنا مناقشات حول التحول مع خايمي، وقرر أن يشجع مستخدميه على الانتقال إلى هذه الإمتداد الجديدة وسوف ينخفض من مشروعه. شكراً لك، خايمي، على دعمك ورؤيتك على مر السنين. دون نجاح مشروعك بين مستخدمي MATLAB، لسنا قد وصلنا لاستيعاب فكرة دعم هذا IDE المحبوب جدا.

Over to you إليك

So there we have it. Hot on the heels of our new Jupyter Kernel, we have a new Visual Studio Code Extension. Try it out, let us know what you think and enjoy!
لذا نحن هنا. بعدها من كونرنا لجافا بوك الجديد، لدينا ملحق جديد لـ Visual Studio Code. حاوله، اخبرنا ما تفكيرك وتمتع!
|
  • print

Comments تعليقات

To leave a comment, please click here to sign in to your MathWorks Account or create a new one.
للإضافة إلى تعليق، يرجى النقر هنا للتسجيل في حساب MathWorks أو إنشاء حساب جديد.