ملحوظة
يمكنكم مراجعة المنشورات الأخرى على موقعي الشخصي: https://hbolajraf.net

مقدمة

في هذا الدليل، سنستكشف كيفية إنشاء تطبيق واجهة سطر الأوامر (CLI) باستخدام مكتبة System.CommandLine في C# و.NET. يعمل System.CommandLine على تبسيط عملية إنشاء واجهات سطر أوامر قوية وغنية بالميزات لتطبيقاتك.

المتطلبات الأساسية

قبل البدء، تأكد من تثبيت ما يلي:

• .NET SDK (الإصدار 5.0 أو الأحدث)

الخطوة 1: إنشاء تطبيق وحدة تحكم جديد

dotnet new console -n MyCommandLineApp
cd MyCommandLineApp

الخطوة 2: إضافة حزمة System.CommandLine NuGet

dotnet add package System.CommandLine --version 2.0.0-beta1.21308.1

الخطوة 3: تحديد خيارات سطر الأوامر

في Program.cs، حدد خيارات سطر الأوامر باستخدام System.CommandLine:

using System.CommandLine;
using System.CommandLine.Invocation;

class Program
{
    static int Main(string[] args)
    {
        var rootCommand = new RootCommand
        {
            new Option("--number", "An integer option"),
            new Option("--flag", "A boolean option"),
            new Argument("input", "A required input argument")
        };

        rootCommand.Handler = CommandHandler.Create((number, flag, input) =>
        {
            // Your application logic goes here
            Console.WriteLine($"Number: {number}");
            Console.WriteLine($"Flag: {flag}");
            Console.WriteLine($"Input: {input}");
        });

        return rootCommand.Invoke(args);
    }
}

الخطوة 4: قم بتشغيل تطبيق CLI

dotnet run -- --number 42 --flag true "Hello, CLI!"

استبدل القيم الخاصة بك وشاهد النتيجة.

الخطوة 5: تخصيص نص المساعدة

أضف أوصافًا إلى خياراتك ووسائطك للحصول على نص مساعدة أفضل:

var rootCommand = new RootCommand
{
    new Option("--number", "An integer option"),
    new Option("--flag", "A boolean option"),
    new Argument("input", "A required input argument")
};

rootCommand.Description = "A simple CLI app";
rootCommand.Handler = CommandHandler.Create((number, flag, input) =>
{
    Console.WriteLine($"Number: {number}");
    Console.WriteLine($"Flag: {flag}");
    Console.WriteLine($"Input: {input}");
});

ماذا بعد؟

لقد نجحت في إنشاء تطبيق أساسي لواجهة سطر الأوامر (CLI) باستخدام مكتبة System.CommandLine في C# و.NET. قم بتخصيص وتوسيع التطبيق بناءً على متطلباتك المحددة.
لمزيد من المعلومات، راجع الوثائق الرسمية: System.CommandLine GitHub