NuGet istemci araçlarını yükleme

  • Makale

Paket yüklemek mi arıyorsunuz? Bkz. NuGet paketlerini yüklemenin yolları.

NuGet ile paket tüketicisi veya oluşturucusu olarak çalışmak için Visual Studio'da komut satırı arabirimi (CLI) araçlarını ve NuGet özelliklerini kullanabilirsiniz. Bu makalede, farklı araçların özellikleri, bunların nasıl yükleneceği ve bunların karşılaştırmalı özellik kullanılabilirliği kısaca özetlenmiştir.

Paketleri kullanmak için NuGet kullanmaya başlamak için aşağıdaki makalelere bakın:

NuGet paketleri oluşturmaya başlamak için şu makalelere bakın:

Araç Açıklama Karşıdan Yükle
dotnet SDK'sı .NET Core ve .NET Standard kitaplıkları için CLI aracı ve .NET Framework'leri hedefleyen sdk stilindeki herhangi bir proje için. Bu CLI aracı .NET Core SDK'sı ile birlikte gelir ve tüm platformlarda temel NuGet özellikleri sağlar. Visual Studio 2017 ve sonraki sürümlerde dotnet CLI, .NET Core ile ilgili tüm iş yükleriyle otomatik olarak yüklenir. .NET Core SDK
nuget.exe .NET Framework kitaplıkları ve .NET Standart kitaplıklarını hedefleyen gibi SDK stili olmayan herhangi bir proje için CLI aracı. Bu CLI aracı, Windows'ta tüm NuGet özelliklerini ve Mono altında çalışırken Mac ve Linux'ta çoğu özelliği sağlar. nuget.exe
Visual Studio Windows'ta NuGet Paket Yöneticisi Visual Studio 2012 ve sonraki sürümlere eklenir. Visual Studio, Paket Yöneticisi kullanıcı arabirimini ve Paket Yöneticisi Konsolunu (Windows üzerinde PowerShell) sağlar. NuGet işlemlerinin çoğunu çalıştırmak için bu araçları kullanabilirsiniz. Visual Studio
Mac için Visual Studio Mac'te, belirli NuGet özellikleri doğrudan yerleşik olarak bulunur. Paket Yöneticisi Konsolu şu anda kullanılamıyor. Diğer özellikler için dotnet SDK'sını veya nuget.exe CLI araçlarını kullanın. Mac için Visual Studio
Visual Studio Code Windows, Mac ve Linux'ta NuGet özellikleri market uzantıları aracılığıyla kullanılabilir veya dotnet SDK veya nuget.exe CLI araçlarını kullanır. Visual Studio Code

Not

Mac için Visual Studio, 31 Ağustos 2024'e kadar kullanımdan kaldırılıyorMicrosoft'un Modern Yaşam Döngüsü İlkesi. Daha fazla bilgi için bkz. Mac için Visual Studio neler oluyor?

MSBuild CLI ayrıca paketleri geri yükler ve oluşturur. MSBuild, NuGet ile çalışmaya yönelik genel amaçlı bir araç değildir. Bu CLI aracı öncelikle derleme sunucularında kullanışlıdır.

Paket Yöneticisi Konsol komutları yalnızca Windows'da Visual Studio'da çalışır ve diğer PowerShell ortamlarında çalışmaz.

Destek ilkesi

Windows için Visual Studio destek ilkesi Visual Studio Ürün Yaşam Döngüsü ve Bakımı bölümünde bulunabilir.

NuGet.exe'in en son sürümü tam olarak desteklenir ve hata düzeltmeleri, güncelleştirmeler ve geliştirmeler için kullanılabilir. NuGet.exe destek ilkesi hakkında daha fazla bilgi için bkz . Microsoft Modern Yaşam Döngüsü İlkesi.

.NET SDK destek ilkesi .NET ve .NET Core Destek İlkesi'nde bulunabilir.

Düzeltme Eki Sürümleri

Visual Studio veya .NET SDK'sının uzun süreli destek (LTS) sürümü için kritik güvenlik düzeltmeleri gerektiğinde, yalnızca NuGet.exe düzeltme eki uygulanmış sürümleri yayınlanacaktır.

Tüm güvenlik hataları MSRC'nin rapor sayfasında Microsoft Güvenlik Yanıt Merkezi'ne (MSRC) bildirilmelidir. Ayrıca NuGet.Client deposundaki güvenlik ilkesine bakın.

listeden NuGet.exe

Destek dışı, kullanım dışı veya güvenlik açığı bulunan NuGet.exe sürümleri tools.json kaldırılır.

Visual Studio

Visual Studio 2017 ve sonraki sürümlerde, Visual Studio yükleyicisi .NET kullanan tüm iş yüklerine sahip NuGet Paket Yöneticisi içerir.

ayrıca Paket Yöneticisi ayrı olarak yükleyebilir veya yüklemenizi doğrulayabilirsiniz. Visual Studio yükleyicisini çalıştırın ve Bağımsız Bileşen > Kodu araçları > NuGet paket yöneticisi altındaki seçenek ayarını denetleyin. Daha fazla bilgi için bkz. NuGet Paket Yöneticisi kullanarak Visual Studio'da paketleri yükleme ve yönetme.

Not

Visual Studio'nun önceki sürümleri için NuGet uzantılarını adresinden https://dist.nuget.org/index.htmlindirebilirsiniz.

CLI araçları

Visual Studio IDE'deki NuGet özelliklerini desteklemek için dotnet CLI veya nuget.exe CLI kullanabilirsiniz. dotnet CLI, .NET Core gibi bazı Visual Studio iş yükleriyle birlikte yüklenir. CLI daha nuget.exe önce açıklandığı gibi ayrı olarak yüklenmelidir. Araçların özellik karşılaştırması için özellik kullanılabilirliği bölümüne bakın.

  • .NET Core veya .NET Standard'ı hedeflemek için dotnet SDK CLI aracını kullanın. Bu CLI, SDK özniteliğini kullanan SDK stili proje biçimi için gereklidir.

  • .NET Framework'e (yalnızca SDK stili olmayan proje) hedeflemek nuget.exe için CLI aracını kullanın. Projeden packages.config PackageReference'a geçirilirse bunun yerine dotnet SDK CLI aracını kullanın.

dotnet SDK'sı

Dotnet SDK,tüm platformlarda (Windows, Mac ve Linux) çalışan ve paketleri yükleme, geri yükleme ve yayımlama gibi temel NuGet özellikleri sağlayan .NET Core 2.0 CLI aracıdır. dotnet CLI, çoğu senaryoda yararlı olan .NET Core proje dosyalarıyla (örneğin .csproj) doğrudan tümleştirme sağlar. Bu CLI ayrıca her platform için doğrudan oluşturulur ve Mono'nun yüklenmesini gerektirmez.

dotnet SDK'sını yükleme

  • Geliştirici bilgisayarlarına .NET Core SDK'sını yükleyin. Visual Studio 2017 ve sonraki sürümlerde dotnet CLI, .NET Core ile ilgili tüm iş yükleriyle otomatik olarak yüklenir.

  • Derleme sunucuları için .NET Core SDK'sını ve araçlarını sürekli tümleştirmede kullanma yönergelerini izleyin.

Dotnet SDK CLI aracıyla temel komutların nasıl kullanılacağını öğrenmek için bkz . Dotnet CLI ile NuGet paketlerini yükleme ve yönetme.

nuget.exe CLI

NuGet CLI, nuget.exeWindows için tüm NuGet özelliklerini sağlayan komut satırı yardımcı programıdır. Bu CLI, bazı sınırlamalarla Mono kullanarak Mac OSX ve Linux üzerinde de çalıştırılabilir.

CLI aracıyla nuget.exe temel komutların nasıl kullanılacağını öğrenmek için bkz . nuget.exe CLI ile NuGet paketlerini yönetme.

nuget.exe yükleme

Her zaman yapılandırmanızı destekleyen aracın en son sürümünü yükleyin.

  • Önerilen en son sürümü adresinden https://dist.nuget.org/win-x86-commandline/latest/nuget.exeindirebilirsiniz.
  • CLI aracı zaten nuget.exe yüklüyse, komutunu nuget update -selfkullanarak aracı en son sürüme güncelleştirebilirsiniz.
  • Eski sürekli tümleştirme sistemleriyle uyumluluk için, önceki bir URL şu https://nuget.org/nuget.exe anda CLI aracının kullanım dışı 2.8.6 sürümünü sağlar.

  1. nuget.org/downloads ziyaret edin ve NuGet sürüm 3.3 veya sonraki bir sürümü indirin.

    • Sürüm 5.0 ve üzeri için .NET Framework sürüm 4.7.2 veya üzeri gerekir.
    • sürüm 4.1.0 ve üzeri, paketleri üzerinde yayımlamak için nuget.orggereklidir.
    • Sürüm 2.8.6 Mono ile uyumlu değildir.

  2. Her indirme doğrudan dosyadır nuget.exe . Tarayıcınıza dosyayı istediğiniz bir klasöre kaydetmesini sağlayın. İndirme dosyası bir yükleyici olmadığından, dosyayı doğrudan tarayıcıdan çalıştırdığınızda hiçbir şey görmezsiniz.

  3. CLI aracını her yerden kullanmak için nuget.exe dosyanın klasör konumunu PATH ortam değişkeninize ekleyin.

Özellik kullanılabilirliği

Aşağıdaki tabloda, desteklenen platformlar için dotnet ve nuget.exe CLI araçlarının kullanılabilir özellikleri karşılaştırmaktadır.

Özellik dotnet CLI nuget CLI (Windows) nuget CLI (Mono) Visual Studio (Windows) Mac için Visual Studio
Arama paketleri ✔ ✔ ✔ ✔ ✔
Paketleri yükleme/kaldırma ✔ ✔ (1) ✔ ✔ ✔
Paketleri güncelleştirme ✔ ✔ ✔ ✔
Paketleri geri yükleme ✔ ✔ ✔ (2) ✔ ✔
Paket akışlarını yönetme (kaynaklar) ✔ ✔ ✔ ✔ ✔
Akışta paketleri yönetme ✔ ✔ ✔
Akışlar için API anahtarlarını ayarlama ✔ ✔
Paket oluşturma (3) ✔ ✔ ✔ (4) ✔
Paketleri yayımlama ✔ ✔ ✔ ✔
Paketleri çoğaltma ✔ ✔
Genel paket ve önbellek klasörlerini yönetme ✔ ✔ ✔
NuGet yapılandırmasını yönetme ✔ ✔ ✔

Özellik notları

  • (1) Proje dosyalarını etkilemez. Bunun yerine dotnet SDK CLI aracını kullanın.
  • (2) Çözüm (.sln) dosyalarıyla packages.config değil, yalnızca dosyayla çalışır.
  • (3) Cli aracılığıyla çeşitli gelişmiş paket özellikleri yalnızca Visual Studio kullanıcı arabirimi araçlarında temsil edildiklerinde kullanılabilir.
  • (4) Dosyalarla .nuspec çalışır ancak proje dosyalarıyla çalışmaz.

Yakında kullanıma sunulacak özellikler

Yaklaşan NuGet özelliklerini önizlemek istiyorsanız, Visual Studio'nun kararlı sürümleriyle yan yana çalışan bir Visual Studio Preview yükleyin. Sorunları bildirmek veya önizlemelerle ilgili fikirleri paylaşmak için NuGet GitHub deposunda bir sorun açın.

Windows üzerinde çalışan geliştiriciler NuGet Paket Gezgini'ni de keşfedebilir. Bu uygulama, NuGet paketlerini görsel olarak keşfetmenize, oluşturmanıza ve düzenlemenize olanak tanıyan açık kaynak tek başına bir araçtır. Paketi yeniden derlemeden bir paket yapısında deneysel değişiklikler yapmak gibi birçok senaryo için yararlıdır.