Blog
.NET Core Command-Line Interface
.NET Core komut satırı arabirimi (CLI), paketler oluşturmak, geri yüklemek, .NET uygulamaları oluşturmak, çalıştırmak ve yayınlamak için bir platformlar arası araçtır.
Visual Studio, bir uygulamayı geri yüklemek, oluşturmak ve yayınlamak için bu CLI’yi dahili olarak kullanır. Diğer üst düzey IDE’ler, düzenleyiciler ve araçlar, .NET Core uygulamalarını desteklemek için CLI’yi kullanabilir.
.NET Core CLI, seçilen platformlar için .NET Core SDK ile birlikte yüklenir. Bu yüzden geliştirme makinesine ayrı olarak yüklememize gerek yok. Windows’ta komut istemini açıp dotnet yazıp Enter’a basarak CLI’nin düzgün yüklenip yüklenmediğini doğrulayabiliriz. Aşağıda gösterildiği gibi kullanım ve yardım gösteriyorsa, doğru şekilde kurulmuş demektir.
Komut Yapısı
Aşağıdaki bir komut yapısıdır.
dotnet <komut> <argüman> <seçenek>
Tüm komutlar dotnet adlı sürücü ile başlar. Sürücü, belirtilen komutun yürütülmesini başlatır. Dotnet’ten sonra, belirli bir eylemi gerçekleştirmek için komut (fiil olarak da bilinir) sağlayabiliriz. Her komutu argümanlar ve seçenekler takip edebilir. Aşağıdakiler .NET Core CLI komutlarıdır.
| Basit Komutlar | Tanım |
| new | Belirtilen şablona dayalı olarak yeni bir proje, yapılandırma dosyası veya çözüm oluşturur. |
| restore | Bir projenin bağımlılıklarını ve araçlarını geri yükler. |
| build | Bir proje ve tüm bağımlılıklarını oluşturur. |
| Run | Kaynak kodunu herhangi bir açık derleme veya başlatma komutu olmadan çalıştırır. |
| publish | Uygulamayı ve bağımlılıklarını bir barındırma sistemine dağıtmak için bir klasöre paketler. |
| test | Birim testleri yürütür. |
| vtest | Belirtilen dosyalardan testleri çalıştırır. |
| pack | Kodu bir NuGet paketinde paketler. |
| clean | Bir projenin çıktısını temizler. |
| sln | .NET Core çözüm dosyasını değiştirir. |
| help | Belirtilen komutta yardımı görüntüle |
| store | Belirtilen derlemeleri çalışma zamanı paket deposunda depolar. |
| Proje Değişiklik Komutları | Tanım |
| add package | Bir projeye bir paket referansı ekler. |
| add reference | Projeden projeye (P2P) referanslar ekler. |
| remove package | Projeden paket referansını kaldırır. |
| remove reference | Proje referansını kaldırır |
| list reference | Tüm projeden projeye referansları listeler |
| İleri Komutlar | Tanım |
| nuget delete | Sunucudan bir paketi siler veya listeden çıkarır. |
| nuget locals | Yerel NuGet kaynaklarını temizler veya listeler. |
| nuget push | Bir paketi sunucuya gönderir ve yayınlar. |
| msbuild | Bir proje ve tüm bağımlılıklarını oluşturur. |
| dotnet install script | .NET Core CLI araçlarını ve paylaşılan çalışma zamanını yüklemek için kullanılan komut dosyası. |
Visual Studio kullanmadan komut satırı arabirimini kullanarak .NET Core konsol uygulamasını oluşturalım, geri yükleyelim, derleyelim ve çalıştıralım.
Yeni Proje Oluşturma
Yeni bir .NET Core projesi oluşturmak için yeni komutu ve ardından şablon adı argümanını kullanmamız gerekiyor. CLI kullanarak konsol, sınıf kitaplığı, web, mvc, webapi, razor, açısal, tepki vb. projeler oluşturabiliriz. Yeni bir .NET Core konsol uygulaması oluşturmak için konsol şablonunu kullanın.
Aşağıdaki, geçerli dizinde geçerli diziyle aynı ada sahip yeni konsol projesi oluşturur.
dotnet new console
Aşağıdaki komut, MyConsoleApp adlı yeni bir konsol projesi oluşturur. -n veya –name seçeneği, bir projenin adını türler.
dotnet new console -n MyConsoleApp
Aşağıdaki komut, MyProjects dizinine MyConsoleApp adlı yeni bir konsol uygulaması oluşturur. -o veya –output seçeneği, projenin oluşturulacağı bir çıktı dizini belirtmek için kullanılır.
dotnet new console -n MyConsoleApp -o C:\MyProjects
Bir proje oluşturduktan sonra, bizim durumumuzda C:\MyConsoleApp olan projeye özel komutları uygulamak için komut istemindeki proje dizinlerine gidin.
Paket Referansı Ekleme
Genellikle farklı amaçlar için NuGet paket referansı eklememiz gerekir. Örneğin, Newtonsoft.json paketini konsol projemize eklemek için aşağıdaki komutu uygulayınız.
C:\MyConsoleApp>dotnet add package
Newtonsoft.json
Bu, projemize Newtonsoft.json paketini ekleyecektir. Bunu .csproj dosyasını açarak doğrulayabiliriz.
Paketleri Geri Yükleme
Paketleri geri yüklemek veya mevcut paketleri güncellemek için aşağıdaki gibi restore komutunu kullanabiliriz.
C:\MyConsoleApp>dotnet restore
Projeyi Derleme
Yeni veya mevcut bir projeyi derlemek için C:\MyConsoleApp>dotnet build komutunu uygulayın.
Projeyi Çalıştırma
Konsol projemizi çalıştırmak için aşağıda gösterildiği gibi dotnet run komutunu uygulayınız.
Yardım Alma
Herhangi bir .NET Core CLI komutu için yardım almak istediğimiz komutun sonuna -h veya -help yazarak yardım alabiliriz. Örneğin dotnet new -h, aşağıda gösterildiği gibi yeni komut, argümanlar ve onunla kullanabileceğimiz seçenekler hakkında yardım görüntüler.
Böylece, farklı türlerde .NET Core uygulamaları oluşturmak, paketleri geri yüklemek, derlemek, çalıştırmak ve yayınlamak için .NET Core komut satırı arabirimini kullanabiliriz.
.NET Developer – Yazılım ve Veritabanı Uzmanlığı eğitimimizi detaylı bir şekilde incelemek için tıklayabilirsiniz.
Güncel eğitim takvimimizi görüntülemek için tıklayabilirsiniz.