dotnet aracı yükle (dotnet tool install)

Bu makale şunlar için geçerlidir: ✔️ .NET 6 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] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

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

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--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 --global seçeneklerini atlar--tool-path.

Uyarı

seçeneğiyle --tool-path belirttiğiniz dizinin güvenli olduğundan emin olun. Bu konuma yüklenen araçlar doğrudan yürütülebilir, bu nedenle güvenilmeyen veya paylaşılan bir yol kullanmak güvenlik risklerine neden olabilir.

Yükleme konumları

Genel araçlar

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

işletim sistemi	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.jsondosyasına eklenir. .NET 10'dan başlayarak, henüz bir bildirim dosyası yoksa, otomatik olarak bir bildirim dosyası oluşturulur. Aşağıdaki komutu çalıştırarak el ile de oluşturabilirsiniz:

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.

  .NET 10.0.100 SDK'dan başlayarak, bir .NET aracı yüklemek için ad/kimlik ve ile @ ayrılmış sürümü kullanın.

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.

• --allow-roll-forward

  .NET 9.0 SDK'sı ile başlayarak kullanılabilir. Hedeflenen çalışma zamanı yüklü değilse aracın .NET çalışma zamanının daha yeni bir sürümünü kullanmasına izin verin.

• -a|--arch <ARCHITECTURE>

  Hedef mimariyi belirtir. Bu, sağlanan değerin varsayılan RID ile birleştirildiği Çalışma Zamanı Tanımlayıcısı'nı (RID) ayarlamak için bir kısaltma söz dizimidir. Örneğin, bir win-x64 makinede, belirterek --arch x86 RID değerini olarak win-x86ayarlar. Bu seçeneği kullanırsanız, seçeneğini kullanmayın -r|--runtime . .NET 6 Preview 7 sürümünden itibaren kullanılabilir.

• --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

  .NET 8 SDK'dan başlayarak kullanılabilir.

  Yerel araçlar için geçerlidir. 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çeneği olarak falseCannotFindAManifestFile ayarlanırsa hata oluşur.

  Araç bildirimi bulunamazsa ve --create-manifest-if-needed seçenek (veya belirtilmediğinde .NET 10 ve sonraki sürümlerde) olarak ayarlanırsa true 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 .sln dosyası olan .git 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.

  .NET 10'dan başlayarak, hiçbir araç bildirimi bulunamazsa otomatik olarak bir bildirim oluşturulur. Bu değişiklik , hataya neden olan bir değişiklik olabilir. 'yi geçirerek --create-manifest-if-needed=falsegeri çevirebilirsiniz.

  Uyarı

  İndirilenler klasöründen veya paylaşılan herhangi bir konumdan araç komutlarını çalıştırmayın. CLI, dizin ağacında bir araç bildirimi bulmak için yukarı doğru ilerler ve bu da beklemediğiniz bir bildirim kullanmasına neden olabilir. Her zaman güvenilir, projeye özgü bir dizinden araç komutlarını çalıştırın.

• --disable-parallel

  Birden çok projenin paralel olarak geri yüklenmesini engeller.

• --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 --global de --tool-path yerel bir araç yüklemesini belirtir.

• --source <SOURCE>

  NuGet paketlerinin kaynağını 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 --global seçenek ile --tool-path birleştirilemiyor.

• --no-cache veya --no-http-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 --global de --tool-path yerel bir araç yüklemesini belirtir.

• -v|--verbosity <LEVEL>

  Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , q[uiet], m[inimal], n[ormal]ve d[etailed]değerleridirdiag[nostic]. 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'den 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 -g dotnetsay@2.1.7

  Dotnetsay'nin 2.1.7 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 dotnetsay@2.1.7

  Geçerli dizin için yerel bir araç olarak dotnetsay'nin 2.1.7 sürümünü yükler.

• dotnet tool install -g dotnetsay --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.

• dotnet tool install -g dotnetsay --allow-roll-forward

  Dotnetsay'yi genel bir araç olarak yükler ve hedef çalışma zamanı kullanılamıyorsa daha yeni .NET sürümlerinde çalışmasına izin verir.

Ayrıca bkz.

• .NET araçları
• Öğretici: .NET CLI kullanarak bir .NET genel aracı yükleme ve kullanma
• Öğretici: .NET CLI kullanarak bir .NET yerel aracı yükleme ve kullanma