Aracılığıyla paylaş

dotnet tool install

  • Makale

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

Veri Akışı Adı

dotnet tool install - Belirtilen .NET aracını makinenize yükler.

Özet

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Açıklama

dotnet tool install komutu, makinenize .NET araçlarını yüklemeniz için bir yol sağlar. komutunu kullanmak için aşağıdaki yükleme seçeneklerinden birini belirtin:

  • Varsayılan konuma genel bir araç yüklemek için seçeneğini kullanın --global .
  • Özel bir konuma genel bir araç yüklemek için seçeneğini kullanın --tool-path .
  • Yerel bir araç yüklemek için ve --tool-path seçeneklerini atlar--global.

Yükleme konumları

Genel araçlar

Genel araçlar, veya --global seçeneğini belirttiğinizde varsayılan olarak aşağıdaki dizinlere -g yüklenir:

OS Yol
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Yürütülebilir dosyalar, genel olarak yüklenen her araç için bu klasörlerde oluşturulur, ancak gerçek araç ikili dosyaları eşdüzey .store dizininde iç içe yerleştirilmiştir.

Not

ile dotnet toolbir komut satırı aracı yükledikten sonra Linux'ta araç yalnızca $HOME/.dotnet/tools yoldan yürütülebilir. Aracın herhangi bir dizinden yürütülebilir olmasını sağlamak için ortam değişkenini güncelleştirin PATH . Güncelleştirilmiş PATH ortam değişkenini kabuğunuzda kalıcı hale getirmek için kabuk ayarlarınızı güncelleştirin. için Bashbu dosyadır $HOME/.bashrc .

--tool-path Araçları

Açık araç yollarına sahip araçlar, parametreyi --tool-path işaret etmek üzere belirttiğiniz her yerde depolanır. Bunlar genel araçlarla aynı şekilde depolanır: eşdüzey .store dizindeki gerçek ikili dosyaları içeren yürütülebilir ikili dosya.

Yerel araçlar

Yerel araçlar NuGet genel dizininde depolanır ve bunu olarak ayarladığınız her şey. Her yerel araç için, araçların bu konumda nerede olduğuna işaret eden dolgu dosyaları $HOME/.dotnet/toolResolverCache vardır.

Yerel araçlara başvurular, geçerli dizinin altındaki bir .config dizinindeki dotnet-tools.json dosyasına eklenir. Henüz bir bildirim dosyası yoksa, seçeneğini kullanarak --create-manifest-if-needed veya aşağıdaki komutu çalıştırarak oluşturun:

dotnet new tool-manifest

Daha fazla bilgi için bkz . Yerel araç yükleme.

Bağımsız değişkenler

  • PACKAGE_NAME

    Yüklenecek .NET aracını içeren NuGet paketinin adı/kimliği.

Seçenekler

  • --allow-downgrade

    .NET araç paketini yüklerken veya güncelleştirirken paketin sürüm düşürmesine izin verin. "İstenen x.x.x sürümü var olan x.x.x sürümünden daha düşük" uyarısını gizler.

  • --add-source <SOURCE>

    Yükleme sırasında kullanılacak ek bir NuGet paket kaynağı ekler. Akışlara belirli bir öncelik sırasına göre sıralı olarak değil paralel olarak erişilir. Aynı paket ve sürüm birden çok akıştaysa, en hızlı akış kazanır. Daha fazla bilgi için bkz . NuGet paketi yüklendiğinde ne olur?.

  • --configfile <FILE>

    Kullanılacak NuGet yapılandırma dosyası (nuget.config). Belirtilirse, yalnızca bu dosyadaki ayarlar kullanılır. Belirtilmezse, geçerli dizindeki yapılandırma dosyalarının hiyerarşisi kullanılır. Daha fazla bilgi için bkz . Yaygın NuGet Yapılandırmaları.

  • --create-manifest-if-needed

    Yerel araçlar için geçerlidir. .NET 8 SDK'sı ile başlayarak kullanılabilir. Bir bildirimi bulmak için, arama algoritması dizin ağacında veya dosya içeren dotnet-tools.json bir .config klasörde dotnet-tools.json arama uygular.

    Araç bildirimi bulunamazsa ve --create-manifest-if-needed seçenek false olarak ayarlanırsa hata CannotFindAManifestFile oluşur.

    Araç bildirimi bulunamazsa ve --create-manifest-if-needed seçenek true olarak ayarlanırsa, araç otomatik olarak bir bildirim oluşturur. Bildirim için aşağıdaki gibi bir klasör seçer:

    • Alt klasörü olan .git bir dizini arayarak dizin ağacına gidin. Bir tane bulunursa, bildirimi bu dizinde oluşturun.
    • Önceki adım bir dizin bulamazsa, veya .git dosyası olan .sln bir dizini aramak için dizin ağacına gidin. Bir tane bulunursa, bildirimi bu dizinde oluşturun.
    • Önceki iki adımdan hiçbiri bir dizin bulmazsa, bildirimi geçerli çalışma dizininde oluşturun.

    Bildirimlerin nasıl bulunduğu hakkında daha fazla bilgi için bkz . Yerel araç yükleme.

  • --disable-parallel

    Birden çok projenin paralel olarak geri yüklenmesini önleyin.

  • --framework <FRAMEWORK>

    Aracının yükleneceği hedef çerçeveyi belirtir. Varsayılan olarak, .NET SDK'sı en uygun hedef çerçeveyi seçmeye çalışır.

  • -g|--global

    Yüklemenin kullanıcı genelinde olduğunu belirtir. Seçeneğiyle --tool-path birleştirilemiyor. Hem atlar hem --tool-path de --global yerel bir araç yüklemesini belirtir.

  • -?|-h|--help

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • --ignore-failed-sources

    Paket kaynağı hatalarını uyarı olarak değerlendirin.

  • --interactive

    Komutun durmasına ve kullanıcı girişini veya eylemini beklemesine izin verir. Örneğin, kimlik doğrulamasını tamamlamak için.

  • --local

    Aracı ve yerel araç bildirimini güncelleştirin. Seçenek veya --tool-path seçenek ile --global birleştirilemiyor.

  • --no-cache

    Paketleri ve HTTP isteklerini önbelleğe alma.

  • --prerelease

    Yayın öncesi paketleri dahil edin.

  • --tool-manifest <PATH>

    Bildirim dosyasının yolu.

  • --tool-path <PATH>

    Genel Araç'ın yükleneceği konumu belirtir. PATH mutlak veya göreli olabilir. PATH yoksa, komut bunu oluşturmaya çalışır. Hem atlar hem --tool-path de --global yerel bir araç yüklemesini belirtir.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. Daha fazla bilgi için bkz. LoggerVerbosity.

  • --version <VERSION_NUMBER>

    Yüklenecek aracın sürümü. Varsayılan olarak, en son kararlı paket sürümü yüklenir. Aracın önizleme veya eski sürümlerini yüklemek için bu seçeneği kullanın.

    .NET 8.0'dan başlayarak, --version Major.Minor.Patch listelenmemiş sürümler de dahil olmak üzere belirli bir ana/ikincil/yama sürümünü ifade eder. Bunun yerine belirli bir ana/ikincil sürümün en son sürümünü almak için kullanın --version Major.Minor.*.

Örnekler

  • dotnet tool install -g dotnetsay

    dotnetsay'yi varsayılan konuma genel bir araç olarak yükler.

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

    dotnetsay'yi belirli bir Windows dizinine genel bir araç olarak yükler.

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

    dotnetsay'yi belirli bir Linux/macOS dizinine genel bir araç olarak yükler.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Dotnetsay'nin 2.0.0 sürümünü genel bir araç olarak yükler.

  • dotnet tool install dotnetsay

    geçerli dizin için yerel bir araç olarak dotnetsay yükler.

  • dotnet tool install -g --verbosity minimal

    dotnetsay'yi minimal ayrıntı düzeyine sahip genel bir araç olarak yükler. Genel araç için varsayılan ayrıntı düzeyi sessizdir.

Ayrıca bkz.