تمرين - تثبيت الحزم

4 دقائق

يُدرك المطورون في Tailwind Traders أنهم على وشك تخصيص موارد ضخمة لتطوير تطبيقات النظام الأساسي لـ Microsoft .NET. ستعرض هذه التطبيقات للمُستخدمين بيانات يُمكن قراءتها، بما في ذلك التواريخ والأوقات والأرقام.

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

عند هذه النقطة، يريد المطورون تثبيت Humanizer، وكتابة بعض معالجات البيانات، وتشغيلها لمعرفة ما إذا كان Humanizer يفي بوعده.

إشعار

تستخدم هذه الوحدة النمطية .NET CLI (واجهة سطر الأوامر) وVisual Studio Code للتطوير المحلي. بعد إكمال هذه الوحدة النمطية، يمكنك تطبيق المفاهيم باستخدام Visual Studio (Windows) أو التطوير المستمر باستخدام Visual Studio Code (Windows وLinux وmacOS).

تستخدم هذه الوحدة النمطية .NET 8.0 SDK. تأكد من تثبيت .NET 8.0 عن طريق تشغيل الأمر التالي في الوحدة الطرفية للأوامر المفضلة لديك:

dotnet --list-sdks

يظهر إخراج مشابه للمثال التالي:

6.0.317 [C:\Program Files\dotnet\sdk]
7.0.401 [C:\Program Files\dotnet\sdk]
8.0.100 [C:\Program Files\dotnet\sdk]

تأكد من إدراج إصدار يبدأ بـ 8. إذا لم يتم سرد أي منها أو لم يتم العثور على الأمر، فقم بتثبيت أحدث .NET 8.0 SDK.

إنشاء عينة مشروع Microsoft .NET

لإعداد مشروع .NET للعمل مع التبعيات، نستخدم Visual Studio Code. يتضمن Visual Studio Code محطة طرفية متكاملة، مما يجعل إنشاء مشروع جديد أمرًا سهلاً. إن لم ترغب باستخدام محرر تعليمات برمجية آخر، يمكنك تشغيل الأوامر في هذه الوحدة في أي وحدة طرفية.

في Visual Studio Code، حدد "File">"Open "Folder.
أنشئ مُجلدًا جديدًا باسم DotNetDependencies في أي موقع تختار، ثم انقر فوق Select Folder.
افتح نافذة الـ terminal المُتضمنة في Visual Studio Code باختيار View>Terminal من القائمة الرئيسية.
في نافذة المحطة الطرفية، انسخ والصق الأمر التالي:
```
dotnet new console -f net8.0
```
ينشئ هذا الأمر ملف Program.cs في المجلد الخاص بك مع برنامج "مرحبًا بالعالم" أساسي مكتوب بالفعل، بجانب ملف مشروع باسم DotNetDependencies.csproj.

الآن، يجب أن تتمكن من الوصول إلى هذه الملفات.
```
-| obj
-| DotNetDependencies.csproj
-| Program.cs
```
في نافذة الوحدة الطرفية، انسخ الأمر التالي وألصقه لتشغيل برنامج "مرحبًا بالعالم".
```
dotnet run
```

تعرض نافذة الوحدة الطرفية عبارة "!Hello World" كإخراج.

لقطة شاشة من Visual Studio Code مع تطبيق وحدة تحكم جديد.

إعداد Visual Studio Code لتصحيح أخطاء NET.

افتح Program.cs. في المرة الأولى التي تفتح بها ملف #C في Visual Studio Code، يُطلب منك تثبيت ملحقات مُوصى بها لـ #C. اختر زر Install في المطالبة.

لقطة شاشة من مطالبة Visual Studio Code للإضافات الموصى بها.

يُثبت Visual Studio Code ملحق #C. يظهر مطالبة أخرى بإضافة الأصول المطلوبة لإنشاء مشروعك وتصحيح أخطائه. حدد نعم.

لقطة شاشة لمطالبة Visual Studio Code بالأصول المطلوبة.

يمكنك إغلاق علامة التبويب Extension: C#‎ للتركيز على التعليمات البرمجية التي تكتبها.

إضافة حزمة NuGet باستخدام أداة NET Core.

افتح Program.cs. يجب أن يبدو مثل هذا:
```
Console.WriteLine("Hello, World!");
```
يتم تشغيل الدالة السابقة في بداية التطبيق وإخراج سلسلة إلى وحدة التحكم. دعونا نُضف Humanizer ونُعالج البيانات ونكتبها في وحدة التحكم.
قم بتثبيت مكتبة Humanizer بتشغيل الأمر التالي:
```
dotnet add package Humanizer --version 2.7.9
```
افتح ملف DotNetDependencies.csproj ثم ابحث عن قسم ItemGroup. الآن، يجب أن يكون لديك إدخال مثل هذا:
```
<ItemGroup>
    <PackageReference Include="Humanizer" Version="2.7.9" />
</ItemGroup>
```
أضف المحتوى التالي في أعلى ملف Program.cs الذي يقوم بتهيئة Humanizer:
```
using Humanizer;
```
يجب أن يبدو ملفك Program.cs مثل هذا:
```
using Humanizer;

Console.WriteLine("Hello, World!");
```

أضف المحتوى التالي إلى الملف Program.cs في الجزء السفلي من الملف ضمن Console.WriteLine("Hello, World!");:

static void HumanizeQuantities()
{
    Console.WriteLine("case".ToQuantity(0));
    Console.WriteLine("case".ToQuantity(1));
    Console.WriteLine("case".ToQuantity(5));
}

static void HumanizeDates()
{
    Console.WriteLine(DateTime.UtcNow.AddHours(-24).Humanize());
    Console.WriteLine(DateTime.UtcNow.AddHours(-2).Humanize());
    Console.WriteLine(TimeSpan.FromDays(1).Humanize());
    Console.WriteLine(TimeSpan.FromDays(16).Humanize());
}

استبدل Console.WriteLine("Hello, World!");بالتعليمة البرمجية التالية:

Console.WriteLine("Quantities:");
HumanizeQuantities();

Console.WriteLine("\nDate/Time Manipulation:");
HumanizeDates();

احفظ الملف (File>Save أو CTRL + S). شغّل التطبيق بتشغيل الأمر التالي في terminal:
```
dotnet run
```
يجب أن تشاهد الإخراج التالي:
```
Quantities:
0 cases
1 case
5 cases

Date/Time Manipulation:
yesterday
2 hours ago
1 day
2 weeks
```

تهانينا. لقد نجحت في تثبيت Humanizer كتبعية ومنطق مكتوب للتعليمات البرمجية للتطبيق لجعل البيانات أكثر قابلية للقراءة من قبل الإنسان. يبدو أن Humanizer يفي بوعده، ومن المرجح أن يسعد Tailwind Traders بهذا التقييم.

الملاحظات

هل كانت هذه الصفحة مفيدة؟