Öğretici: .NET CLI kullanarak bir .NET genel aracı yükleme ve kullanma

Bu makale: ✔️ .NET 8 SDK ve sonraki sürümler için geçerlidir

Bu öğreticide genel bir aracın nasıl yükleneceği ve kullanılacağı gösterilmektedir. Kullandığınız araç, bu serinin ilk öğreticisinde oluşturduğunuz araçtır.

Önkoşullar

• Bu serinin ilk öğreticisini tamamlayın.
• .NET 10.0.100 SDK veya üzeri (için dnx) - isteğe bağlı ancak önerilir.

Aracı yüklemeden çalıştırma (önerilen)

.NET 10.0.100'den başlayarak ,NET araçlarını kullanarak dnxkalıcı yükleme olmadan çalıştırabilirsiniz:

1. Aracı doğrudan dnx kullanarak çalıştırın (basitleştirilmiş söz dizimi):

   dnx dotnet-env --add-source ./nupkg
   

   --add-source parametresi, .NET CLI'ya ./nupkg dizinini, araç NuGet.org kullanılabilir olmadığında NuGet paketleri için ek bir kaynak akışı olarak kullanmasını söyler.

Aracı küresel bir araç olarak kullanma (geleneksel kurulum)

Sık kullanım için kalıcı yüklemeyi tercih ediyorsanız:

1. aracı, dotnet-env proje klasöründe dotnet tool install komutunu çalıştırarak paketten yükleyin:

   dotnet tool install --global --add-source ./nupkg dotnet-env
   

   --global parametresi, .NET CLI'ya araç ikili dosyalarını PATH ortam değişkenine otomatik olarak eklenen varsayılan bir konuma yüklemesini söyler.

   --add-source parametresi , .NET CLI'ya NuGet paketleri için ek bir kaynak akışı olarak ./nupkg dizinini geçici olarak kullanmasını söyler. Paketinizin NuGet.org değil yalnızca ./nupkg dizininde bulunduğundan emin olmak için benzersiz bir ad verdiniz.

   Çıkışta aracı çağırmak için kullanılan komut ve yüklü sürüm gösterilir:

   You can invoke the tool using the following command: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

   Uyarı

   Varsayılan olarak yüklenecek .NET ikili dosyalarının mimarisi şu anda çalışan işletim sistemi mimarisini temsil eder. Farklı bir işletim sistemi mimarisi belirtmek için bkz. dotnet tool install, --arch option.

2. Aracı çağırın:

   dotnet-env
   

   Uyarı

   Komut başarısız olursa ortam değişkenini PATH yenilemek için yeni bir terminal açın.

3. dotnet tool uninstall komutunu çalıştırarak aracı kaldırın:

   dotnet tool uninstall -g dotnet-env
   

Aracı özel bir konuma yüklenmiş küresel bir araç olarak kullanın

1. Aracı paketten yükleyin.

   Windows'da:

   dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg dotnet-env
   

   Linux veya macOS'ta:

   dotnet tool install --tool-path ~/bin --add-source ./nupkg dotnet-env
   

   --tool-path parametresi .NET CLI'ya araç ikili dosyalarını belirtilen konuma yüklemesini söyler. Dizin mevcut değilse, sistem tarafından oluşturulur. Dizin, ortam değişkenine PATH otomatik olarak eklenmez.

   Çıkışta aracı çağırmak için kullanılan komut ve yüklü sürüm gösterilir:

   You can invoke the tool using the following command: dotnet-env
   Tool 'dotnet-env' (version '1.0.0') was successfully installed.
   

2. Aracı çağırın:

   Windows'da:

   c:\dotnet-tools\dotnet-env
   

   Linux veya macOS'ta:

   ~/bin/dotnet-env
   

3. dotnet tool uninstall komutunu çalıştırarak aracı kaldırın:

   Windows'da:

   dotnet tool uninstall --tool-path c:\dotnet-tools dotnet-env
   

   Linux veya macOS'ta:

   dotnet tool uninstall --tool-path ~/bin dotnet-env
   

Troubleshoot

Öğreticiyi takip ederken bir hata iletisi alırsanız bkz. .NET aracı kullanım sorunlarını giderme.

Sonraki Adımlar

Bu öğreticide, bir aracı genel araç olarak yüklemiş ve kullanmışsınızdır. Genel araçları yükleme ve kullanma hakkında daha fazla bilgi için bkz. Genel araçları yönetme. Yerel bir araçla aynı aracı yüklemek ve kullanmak için sonraki öğreticiye ilerleyin.

Yerel araçları yükleme ve kullanma