.NET araçlarını yönetme

  • Makale
  • Okumak için 3 dakika

Bu makale şu şekilde geçerlidir: ✔️ .net Core 2,1 SDK ve sonraki sürümleri

.net aracı, konsol uygulaması içeren özel bir NuGet paketidir. Aşağıdaki yollarla makinenize bir araç yüklenebilir:

  • Genel bir araç olarak.

    Araç ikilileri, PATH ortam değişkenine eklenen bir varsayılan dizine yüklenir. Aracı, konumunu belirtmeden makinedeki herhangi bir dizinden çağırabilirsiniz. Makinedeki tüm dizinler için bir aracın bir sürümü kullanılır.

  • Özel bir konumda (araç yolu aracı olarak da bilinir) genel bir araç olarak.

    Araç ikilileri, belirttiğiniz bir konuma yüklenir. Aracı, yükleme dizininden ya da komut adı ile dizin sağlayarak ya da yolu PATH ortam değişkenine ekleyerek çağırabilirsiniz. Makinedeki tüm dizinler için bir aracın bir sürümü kullanılır.

  • Yerel bir araç olarak (.NET Core SDK 3,0 ve üzeri için geçerlidir).

    Araç ikilileri bir varsayılan dizine yüklenir. Aracı, yükleme dizininden veya alt dizinlerinden herhangi birine çağırabilirsiniz. Farklı dizinler aynı aracın farklı sürümlerini kullanabilir.

    .NET CLı, bir dizine yerel olarak hangi araçların yüklendiğini izlemek için bildirim dosyalarını kullanır. Bildirim dosyası bir kaynak kod deposunun kök dizininde kaydedildiğinde, katılımcı depoyu kopyalayabilir ve bildirim dosyalarında listelenen tüm araçları yükleyen tek bir .NET CLı komutu çağırabilirler.

Önemli

.NET araçları tam güvende çalışır. Yazara güvenmediğiniz müddetçe .NET aracını yüklemeyin.

Araç bulun

Araç bulmak için bazı yollar şunlardır:

Yazarı ve istatistikleri denetleme

.NET araçları tam güvende çalıştırıldıklarından ve genel araçlar PATH ortam değişkenine eklendiğinden, bunlar çok güçlü olabilir. Güvenmediğiniz kişilerden araç indirmeyin.

araç NuGet üzerinde barındırılıyorsa, aracı arayarak yazarı ve istatistikleri kontrol edebilirsiniz.

Küresel bir araç yükler

Bir aracı genel araç olarak yüklemek için, -g --global Aşağıdaki örnekte gösterildiği gibi DotNet aracının Installveya seçeneğini kullanın:

dotnet tool install -g dotnetsay

Çıktı, aşağıdaki örneğe benzer şekilde aracı ve yüklü sürümü çağırmak için kullanılan komutu gösterir:

You can invoke the tool using the following command: dotnetsay
Tool 'dotnetsay' (version '2.1.4') was successfully installed.

Bir araç ikililerinin varsayılan konumu işletim sistemine bağlıdır:

İşletim Sistemi Yol
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

SDK ilk çalıştırıldığında, bu konum kullanıcının yoluna eklenir, bu nedenle genel araçlar araç konumunu belirtmeden herhangi bir dizinden çağrılabilir.

Araç erişimi, makineye genel değil, kullanıcıya özeldir. Genel araç yalnızca aracı yükleyen kullanıcı tarafından kullanılabilir.

Özel bir konuma genel araç yükler

Bir aracı özel bir konuma genel araç olarak yüklemek için, --tool-path Aşağıdaki örneklerde gösterildiği gibi DotNet araç installseçeneğini kullanın.

Windows'da:

dotnet tool install dotnetsay --tool-path c:\dotnet-tools

Linux veya macOS 'ta:

dotnet tool install dotnetsay --tool-path ~/bin

.NET SDK bu konumu otomatik olarak PATH ortam değişkenine eklemez. Bir araç yolu aracını çağırmakiçin aşağıdaki yöntemlerden birini kullanarak komutun kullanılabilir olduğundan emin olmanız gerekir:

  • Yükleme dizinini PATH ortam değişkenine ekleyin.
  • Aracı çağırdığınızda aracın tam yolunu belirtin.
  • Yükleme dizini içinden aracı çağırın.

Yerel bir araç yükler

.NET Core 3,0 SDK ve üzeri için geçerlidir.

Yalnızca yerel erişim için bir araç yüklemek üzere (geçerli dizin ve alt dizinler için), aracın bir araç bildirim dosyasına eklenmesi gerekir. Bir araç bildirim dosyası oluşturmak için şu komutu çalıştırın dotnet new tool-manifest :

dotnet new tool-manifest

Bu komut .config dizin altında DotNet-Tools. JSON adlı bir bildirim dosyası oluşturur. Bildirim dosyasına yerel bir araç eklemek için, DotNet aracı install komutunu kullanın ve --global --tool-path Aşağıdaki örnekte gösterildiği gibi, ve seçeneklerini atlayın:

dotnet tool install dotnetsay

Komut çıktısı, aşağıdaki örneğe benzer şekilde, yeni yüklenen aracın hangi bildirim dosyasına olduğunu gösterir:

You can invoke the tool from this directory using the following command:
dotnet tool run dotnetsay
Tool 'dotnetsay' (version '2.1.4') was successfully installed.
Entry is added to the manifest file /home/name/botsay/.config/dotnet-tools.json.

Aşağıdaki örnekte, iki yerel araç yüklü olan bir bildirim dosyası gösterilmektedir:

{
  "version": 1,
  "isRoot": true,
  "tools": {
    "botsay": {
      "version": "1.0.0",
      "commands": [
        "botsay"
      ]
    },
    "dotnetsay": {
      "version": "2.1.3",
      "commands": [
        "dotnetsay"
      ]
    }
  }
}

Genellikle deponun kök dizinine yerel bir araç eklersiniz. Bildirim dosyasını depoya iade ettikten sonra, depodan kod kullanıma alan geliştiriciler en son bildirim dosyasını alır. Bildirim dosyasında listelenen tüm araçları yüklemek için şu komutu çalıştırırlar dotnet tool restore :

dotnet tool restore

Çıktı hangi araçların geri yüklendiğini gösterir:

Tool 'botsay' (version '1.0.0') was restored. Available commands: botsay
Tool 'dotnetsay' (version '2.1.3') was restored. Available commands: dotnetsay
Restore was successful.

Belirli bir araç sürümünü yükler

Bir aracın yayın öncesi sürümünü veya belirli bir sürümünü yüklemek için, --version Aşağıdaki örnekte gösterildiği gibi seçeneğini kullanarak sürüm numarasını belirtin:

dotnet tool install dotnetsay --version 2.1.3

Tam sürüm numarasını belirtmeden aracın yayın öncesi sürümünü yüklemek için, --version Bu seçeneği kullanın ve aşağıdaki örnekte gösterildiği gibi bir joker karakter sağlayın:

dotnet tool install --global dotnetsay --version "*-rc*"

Araç kullanma

Bir aracı çağırmak için kullandığınız komut, yüklediğiniz paketin adından farklı olabilir. Geçerli Kullanıcı için makinede yüklü olan tüm araçları göstermek için DotNet araç listesi komutunu kullanın:

dotnet tool list

Çıktı, aşağıdaki örneğe benzer şekilde her bir aracın sürümünü ve komutunu gösterir:

Package Id      Version      Commands       Manifest
-------------------------------------------------------------------------------------------
botsay          1.0.0        botsay         /home/name/repository/.config/dotnet-tools.json
dotnetsay       2.1.3        dotnetsay      /home/name/repository/.config/dotnet-tools.json

Bu örnekte gösterildiği gibi listede yerel araçlar gösterilmektedir. Genel araçları görmek için --global seçeneğini kullanın ve araç yolu araçlarını görmek için --tool-path seçeneğini kullanın.

Küresel bir araç çağır

Genel araçlar için, araç komutunu kendi kendine kullanın. Örneğin, komut dotnetsay veya ise dotnet-doc , bu, komutu çağırmak için kullandığınız şeydir:

dotnetsay
dotnet-doc

Komut önekiyle başlıyorsa dotnet- , aracı çağırmak için alternatif bir yol, dotnet komutunu kullanmak ve araç komut önekini atlamanızı sağlar. Örneğin, komut ise, dotnet-doc aşağıdaki komut aracı çağırır:

dotnet doc

Ancak, aşağıdaki senaryoda dotnet küresel bir araç çağırmak için komutunu kullanamazsınız:

  • Küresel bir araç ve yerel bir araç tarafından önekli aynı komut vardır dotnet- .
  • Genel aracı yerel araç kapsamında olan bir dizinden çağırmak istiyorsunuz.

Bu senaryoda dotnet doc ve dotnet dotnet-doc Yerel Aracı çağırın. Genel aracı çağırmak için, komutu kendi başına kullanın:

dotnet-doc

Araç yolu aracı çağırma

Seçeneği kullanılarak yüklenen küresel bir aracı çağırmak için tool-path , Bu makalede daha önceanlatıldığı gibi komutun kullanılabilir olduğundan emin olun.

Yerel bir araç çağır

Yerel bir aracı çağırmak için, dotnet yükleme dizini içinden komutunu kullanmanız gerekir. dotnet tool run <COMMAND_NAME>Aşağıdaki örneklerde gösterildiği gibi Long formunu () veya kısa biçimi ( dotnet <COMMAND_NAME> ) kullanabilirsiniz:

dotnet tool run dotnetsay
dotnet dotnetsay

Komutun öneki varsa dotnet- , aracı çağırdığınızda öneki dahil edebilir veya atlayabilirsiniz. Örneğin, komut ise dotnet-doc Aşağıdaki örneklerden herhangi biri yerel aracı çağırır:

dotnet tool run dotnet-doc
dotnet dotnet-doc
dotnet doc

Bir aracı güncelleştirme

Bir aracın güncelleştirilmesi, en son kararlı sürümle birlikte kaldırılıp yeniden yüklenmesini içerir. Bir aracı güncelleştirmek için, bu aracı yüklemek için kullandığınız seçenekle DotNet araç Update komutunu kullanın:

dotnet tool update --global <packagename>
dotnet tool update --tool-path <packagename>
dotnet tool update <packagename>

Yerel bir araç için SDK, geçerli dizin ve üst dizinlere bakarak paket KIMLIĞINI içeren ilk bildirim dosyasını bulur. Herhangi bir bildirim dosyasında böyle bir paket KIMLIĞI yoksa, SDK en yakın bildirim dosyasına yeni bir giriş ekler.

Araç kaldırma

Bir aracı, aracı yüklemek için kullandığınız seçenekle DotNet Aracı kaldırma komutunu kullanarak kaldırın:

dotnet tool uninstall --global <packagename>
dotnet tool uninstall --tool-path <packagename>
dotnet tool uninstall <packagename>

Yerel bir araç için SDK, geçerli dizin ve üst dizinlere bakarak paket KIMLIĞINI içeren ilk bildirim dosyasını bulur.

Yardım alın ve sorun giderin

Bir araç yüklenemediğinde veya çalışmazsa, bkz. .NET araç kullanımı sorunlarını giderme. dotnet toolParametresini kullanarak, kullanılabilir komutların ve parametrelerin bir listesini alabilirsiniz --help :

dotnet tool --help

Araç kullanım yönergelerini almak için aşağıdaki komutlardan birini girin veya aracın Web sitesini görüntüleyin:

<command> --help
dotnet <command> --help

Ayrıca bkz.