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

Bu makale şunlar için geçerlidir: ✔️ .NET Core 2.1 SDK ve sonraki sürümleri

Bu öğreticide, genel bir aracı yükleme ve kullanma hakkında bilgi edinirsiniz. Bu serinin ilk öğreticisinde oluşturduğunuz bir aracı kullanırsınız.

Ö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 microsoft.botsay --add-source ./nupkg microsoft.botsay hello from the bot
   

   parametresi, --add-source araç NuGet.org kullanılabilir olmadığında .NET CLI'ya NuGet paketleri için ek kaynak akışı olarak ./nupkg dizinini 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. microsoft.botsay proje klasöründe dotnet tool install komutunu çalıştırarak paketinden aracı yükleyin:

   dotnet tool install --global --add-source ./nupkg microsoft.botsay
   

   --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 sitesinde 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: botsay
   Tool 'microsoft.botsay' (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:

   botsay hello from the bot
   

   Uyarı

   Bu komut başarısız olursa, PATH'i yenilemek için yeni bir terminal açmanız gerekebilir.

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

   dotnet tool uninstall -g microsoft.botsay
   

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 microsoft.botsay
   

   Linux veya macOS'ta:

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

   --tool-path parametresi .NET CLI'ya araç ikili dosyalarını belirtilen konuma yüklemesini söyler. Dizin mevcut değilse, oluşturulur. Bu dizin PATH ortam değişkenine 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: botsay
   Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
   

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

   Windows'da:

   c:\dotnet-tools\botsay hello from the bot
   

   Linux veya macOS'ta:

   ~/bin/botsay hello from the bot
   

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

   Windows'da:

   dotnet tool uninstall --tool-path c:\dotnet-tools microsoft.botsay
   

   Linux veya macOS'ta:

   dotnet tool uninstall --tool-path ~/bin microsoft.botsay
   

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