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

Makale
07/27/2023

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

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

Önkoşullar

Bu serinin ilk öğreticisini tamamlayın.

Aracı genel bir araç olarak kullanma

microsoft.botsay project klasöründe dotnet tool install komutunu çalıştırarak aracı paketten 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 kaynak akışı olarak ./nupkg dizinini geçici olarak kullanmasını söyler. Paketinize, Nuget.org sitesinde değil yalnızca ./nupkg dizininde bulunduğundan emin olmak için benzersiz bir ad verdiniz.

Çıkışta aracı ve yüklü sürümü çağırmak için kullanılan komut gösterilir:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```
Not

Yüklenecek .NET ikili dosyalarının mimarisi varsayılan olarak çalışmakta olan işletim sistemi mimarisini temsil eder. Farklı bir işletim sistemi mimarisi belirtmek için bkz. dotnet tool install, --arch option.
Aracı çağırın:
```
botsay hello from the bot
```
Not

Bu komut başarısız olursa, PATH'i yenilemek için yeni bir terminal açmanız gerekebilir.
dotnet tool uninstall komutunu çalıştırarak aracı kaldırın:
```
dotnet tool uninstall -g microsoft.botsay
```

Aracı özel bir konuma yüklenmiş genel bir araç olarak kullanma

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 yoksa oluşturulur. Bu dizin PATH ortam değişkenine otomatik olarak eklenmez.

Çıkışta aracı ve yüklü sürümü çağırmak için kullanılan komut gösterilir:
```
You can invoke the tool using the following command: botsay
Tool 'microsoft.botsay' (version '1.0.0') was successfully installed.
```

Aracı çağırın:

Windows'da:

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

Linux veya macOS'ta:

~/bin/botsay hello from the bot

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

Sorun giderme

Öğ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ükleyip kullandınız. 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 geçin.

Yerel araçları yükleme ve kullanma