تمرين - إنشاء تطبيقك وبنائه وتشغيله

مكتمل

تتضمن مجموعة تطوير برامج .NET (SDK) واجهة سطر الأوامر (CLI) التي يمكن الوصول إليها من المحطة الطرفية المتكاملة في Visual Studio Code. أثناء هذا التدريب، يمكنك استخدام أوامر .NET CLI لإنشاء تطبيقات وحدة تحكم جديدة، وبناء التعليمات البرمجية للمشروع الخاص بك، وتشغيل التطبيقات الخاصة بك.

على سبيل المثال، سيقوم أمر .NET CLI التالي بإنشاء تطبيق وحدة تحكم جديد في موقع المجلد المحدد:

dotnet new console -o ./CsharpProjects/TestProject

تتكون بنية أمر CLI من الأجزاء الثلاثة التالية:

• برنامج التشغيل: dotnet في هذا المثال.
• الأمر : new console في هذا المثال.
• وسيطات الأمر: -o ./CsharpProjects/TestProject في هذا المثال.

إشعار

وسيطات الأوامر هي معلمات اختيارية يمكن استخدامها لتوفير معلومات إضافية. يمكن تشغيل الأمر السابق دون تحديد موقع المجلد الاختياري. على سبيل المثال: dotnet new console. في هذه الحالة، سيتم إنشاء تطبيق وحدة التحكم الجديد في موقع المجلد الحالي.

في هذا التمرين، يمكنك استخدام Visual Studio Code لإنشاء مجلد مشروع جديد، وإنشاء تطبيق وحدة تحكم جديد باستخدام أمر CLI، وتخصيص التطبيق في محرر Visual Studio Code، ثم إنشاء تطبيقك وتشغيله.

إنشاء تطبيق وحدة تحكم C# في مجلد محدد

للبدء، يمكنك إنشاء تطبيق وحدة تحكم في موقع مجلد يسهل العثور عليه وإعادة استخدامه.

1. تأكد من فتح Visual Studio Code .

   يمكنك استخدام القائمة Windows لتحديد موقع Visual Studio Code وفتحه.

2. في قائمة Visual Studio Code File ، حدد Open Folder.

   سيتم عرض مربع الحوار فتح مجلد. يمكنك استخدام مربع الحوار فتح مجلد لإنشاء مجلد جديد لمشروع C# الخاص بك.

   إشعار

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

3. في مربع الحوار فتح مجلد ، انتقل إلى مجلد سطح مكتب Windows.

   إذا كان لديك موقع مجلد مختلف حيث تحتفظ بمشاريع التعليمات البرمجية، يمكنك استخدام موقع المجلد هذا بدلا من ذلك. لهذا التدريب، الشيء المهم هو أن يكون لديك موقع يسهل تحديد موقعه وتذكره.

4. في مربع الحوار فتح مجلد ، حدد تحديد مجلد.

   إذا رأيت مربع حوار أمان يسألك عما إذا كنت تثق بالمؤلفين، فحدد نعم.

5. في قائمة Visual Studio Code Terminal ، حدد New Terminal.

   

   لاحظ أن موجه الأوامر في لوحة Terminal يعرض مسار المجلد للمجلد الحالي. على سبيل المثال:

   C:\Users\someuser\Desktop>
   

6. في موجه الأوامر Terminal، لإنشاء تطبيق وحدة تحكم جديد في مجلد محدد، أدخل الأمر التالي:

   dotnet new console -o ./CsharpProjects/TestProject
   

   

   يستخدم أمر .NET CLI هذا قالب برنامج .NET لإنشاء مشروع تطبيق وحدة تحكم C# جديد في موقع المجلد المحدد. ينشئ الأمر مجلدات CsharpProjects وTestProject نيابة عنك، ويستخدم TestProject كاسم لملفك .csproj .

7. في طريقة عرض EXPLORER، قم بتوسيع المجلد CsharpProjects .

   يجب أن تشاهد مجلد TestProject وملفين، ملف برنامج C# المسمى Program.cs وملف مشروع C# يسمى TestProject.csproj. يستخدم الأمر CLI اسم المجلد عند إنشاء ملف المشروع (TestProject.csproj). ملف Program.cs هو الملف الذي يحتوي على التعليمات البرمجية C#‎.

8. في طريقة عرض EXPLORER، لعرض التعليمات البرمجية C# في لوحة المحرر، حدد Program.cs.

   كما ترى، تطبيق وحدة التحكم الافتراضي هو "مرحبًا بالعالم!" الأيقونة Aha!.

   // See https://aka.ms/new-console-template for more information
   Console.WriteLine("Hello, World!");
   

   يستخدم Console.WriteLine() هذا التطبيق الأسلوب لعرض "Hello, World!" في نافذة وحدة التحكم.

تحديث التطبيق الخاص بك وبنته وتشغيله

في هذه المهمة، يمكنك استخدام طريقة عرض EXPLORER لفتح مجلد مشروع التعليمات البرمجية وتخصيص رسالة "Hello" ثم تشغيل التطبيق الخاص بك.

1. في طريقة عرض Visual Studio Code EXPLORER، انقر بزر الماوس الأيمن فوق المجلد TestProject ، ثم حدد Open in integrated Terminal.

   

   هام

   يظهر موجه الأوامر في لوحة Terminal المتكاملة موقع المجلد حيث سيتم تشغيل الأمر. قبل تشغيل build أمر أو run ، يجب التأكد من أن Terminal مفتوحة لمجلد المشروع.

2. تحقق من أن موجه الأوامر في لوحة Terminal يعرض مسار المجلد التالي:

   C:\Users\someuser\Desktop\CsharpProjects\TestProject>
   

3. في محرر Visual Studio Code، قم بتحديث Console.WriteLine() الأسلوب كما يلي:

   Console.WriteLine("Hello C#!");
   

   في المرة الأولى التي تقوم فيها بتحرير ملف .cs، قد يطالبك Visual Studio Code بإضافة الأصول المفقودة لإنشاء تطبيقك وتصحيحه. إذا رأيت المطالبة، يمكنك تحديد نعم.

4. في القائمة ملف، حدد حفظ.

   تحتاج دائما إلى حفظ تغييرات التعليمات البرمجية إلى الملف. لن يتعرف المحول البرمجي للتعليمات البرمجية على تغييرات التعليمات البرمجية التي أجريتها في المحرر حتى يتم حفظ التعليمات البرمجية.

5. لتحويل بنية تطبيقك برمجيا، أدخل الأمر التالي في موجه الأوامر Terminal:

   dotnet build
   

   

   يبني الأمر dotnet build المشروع وتبعياته في مجموعة من الثنائيات. تبادر الثنائيات بتضمين التعليمات البرمجية للمشروع في ملفات اللغة الوسيطة (IL) مع ملحق .dll. اعتمادا على نوع المشروع وإعداداته، قد يتم أيضا تضمين ملفات أخرى. إذا كنت مهتما، يمكنك العثور على ملف TestProject.dll في طريقة عرض EXPLORER في موقع مجلد مشابه للمسار التالي:

   C:\Users\someuser\Desktop\CsharpProjects\TestProject\bin\Debug\net7.0\

   إشعار

   سيعكس مسار المجلد حسابك ومسار المجلد إلى مجلد TestProject.

6. لتشغيل التطبيق الخاص بك، أدخل الأمر التالي في موجه الأوامر Terminal:

   dotnet run
   

   يقوم dotnet run الأمر بتشغيل التعليمات البرمجية المصدر دون أي أوامر تحويل برمجي أو تشغيل صريحة. يوفر خيارا مناسبا لتشغيل التطبيق الخاص بك من التعليمات البرمجية المصدر مع أمر واحد. إنه مفيد للتطوير التكراري السريع من سطر الأوامر. يعتمد الأمر على أمر إنشاء dotnet لإنشاء التعليمات البرمجية.

7. لاحظ أنه يتم عرض Hello C#‎ في لوحة Terminal على السطر أسفل dotnet run الأمر.

   إذا رأيت "Hello, World!" معروضا، فتأكد من حفظ تغييرات التعليمات البرمجية.

تهانينا، لقد أكملت إعداد Visual Studio Code وإنشاء وتشغيل سطر بسيط من التعليمات البرمجية!