nuget.exe CLı kullanarak paketleri yönetme

  • Makale
  • Okumak için 2 dakika

clı aracı, projelerde ve çözümlerinde NuGet paketlerini kolayca güncelleştirmenizi ve geri yüklemenize olanak tanır. bu araç, Windows tüm NuGet yeteneklerini sağlar ve ayrıca Mono altında çalışırken Mac ve Linux özelliklerinin çoğunu sağlar.

nuget.execlı .NET Framework projeniz ve sdk olmayan bir stil projem (örneğin, .NET Standard kitaplıklarını hedefleyen sdk olmayan bir stil projesi) içindir. Öğesine geçirilmiş SDK olmayan bir proje kullanıyorsanız PackageReferencedotnet bunun yerine CLI kullanın. nuget.exeCLI, paket başvuruları için bir nuget.exe dosyası gerektirir.

Not

Çoğu senaryoda, PackageReference için kullanılan SDK olmayan projeler arasında geçiş yapmanızı öneririz ve dotnet CLI yerine CLI kullanabilirsiniz nuget.exe . şu anda C++ ve ASP.NET projeleri için geçiş yoktur.

Bu makalede, en sık kullanılan CLI komutlarının birçoğuna ilişkin temel kullanım gösterilmektedir nuget.exe . Bu komutların çoğu için, komutta bir proje dosyası belirtilmediği takdirde CLı aracı geçerli dizinde bir proje dosyası arar. Komutların ve kullanabileceğiniz bağımsız değişkenlerin tamamı listesi için nuget.exe CLI başvurusunabakın.

Önkoşullar

  • nuget.exenuget.exeadresinden indirerek, bu .exe dosyayı uygun bir klasöre KAYDEDEREK ve bu klasörü PATH ortam değişkeninizden ekleyerek CLI 'yı yükleme.

Paketi yükleme

Install komutu, belirtilen paket kaynaklarını kullanarak bir paketi indirir ve geçerli klasörü varsayılan olarak bir projeye yükler. Yeni paketleri proje kök dizininizde paketler klasörüne yükler.

Önemli

installKomut bir proje dosyasını veya installdeğiştirmez; buna benzer şekilde, restore yalnızca paketleri diske eklemektedir ancak projenin bağımlılıklarını değiştirmez. bir bağımlılık eklemek için, Visual Studio Paket Yöneticisi kullanıcı arabirimi veya konsolundan bir paket ekleyin ya da packages.config değiştirip ya da öğesini çalıştırın restore .

  1. Bir komut satırı açın ve proje dosyanızı içeren dizine geçiş yapın.

  2. paketler klasörüne NuGet paketini yüklemek için aşağıdaki komutu kullanın.

    nuget install <packageID> -OutputDirectory packages

    Newtonsoft.jsonPaketi Newtonsoft.json klasörüne yüklemek için şu komutu kullanın:

    nuget install Newtonsoft.Json -OutputDirectory packages

alternatif olarak, paketler klasörüne mevcut bir dosyayı kullanarak bir NuGet paketini yüklemek için aşağıdaki komutu kullanabilirsiniz packages.config . packages.config Bu, paketi proje bağımlılıklarınızla eklemez, ancak yerel olarak yüklemez.

nuget install packages.config -OutputDirectory packages

Bir paketin belirli bir sürümünü yükler

yükleme komutunu kullandığınızda sürüm belirtilmemişse, NuGet paketin en son sürümünü yükler. Ayrıca, bir NuGet paketinin belirli bir sürümünü de yükleyebilirsiniz:

nuget install <packageID | configFilePath> -Version <version>

Örneğin, paketin sürüm 12.0.1 ' i eklemek için Newtonsoft.json Şu komutu kullanın:

nuget install Newtonsoft.Json -Version 12.0.1

Sınırlamaları ve davranışı hakkında daha fazla bilgi için install bkz. install.

Bir paketi kaldırma

Bir veya daha fazla paketi silmek için, paketler klasöründen kaldırmak istediğiniz paketleri silin.

Paketleri yeniden yüklemek istiyorsanız restore veya install komutunu kullanın.

Paketleri Listele

Liste komutunu kullanarak belirli bir kaynaktaki paketlerin listesini görüntüleyebilirsiniz. -SourceAramayı kısıtlamak için seçeneğini kullanın.

nuget list -Source <source>

Örneğin , paketler klasöründeki paketleri listeleyin.

nuget list -Source C:\Users\username\source\repos\MyProject\packages

Arama terimi kullanırsanız, arama paket, etiket ve paket açıklamalarının adlarını içerir.

nuget list <search term>

Tek bir paketi güncelleştirme

NuGet, install paket sürümünü belirtmediğiniz takdirde komutunu kullandığınızda paketin en son sürümünü yüklüyor.

Tüm paketleri Güncelleştir

Tüm paketleri güncelleştirmek için Güncelleştir komutunu kullanın. Projedeki tüm paketleri (kullanarak packages.config ) en son kullanılabilir sürümlerine güncelleştirir. Çalıştırılmadan önce çalıştırılması önerilir restoreupdate .

nuget update

Paketleri geri yükleme

Paketler klasöründe eksik olan paketleri indiren ve yükleyen restore komutunu kullanın.

PackageReference 'a geçirilen projeler için, bunun yerine paketleri geri yüklemek için MSBuild-t:restore kullanın.

restore yalnızca paketleri diske ekler ancak projenin bağımlılıklarını değiştirmez. Proje bağımlılıklarını geri yüklemek için, öğesini değiştirin packages.config , sonra restore komutunu kullanın.

Diğer nuget.exe CLI komutlarında olduğu gibi, önce bir komut satırını açın ve proje dosyanızı içeren dizine geçiş yapın.

Paketini kullanarak geri yüklemek için restore :

nuget restore MySolution.sln

CLı sürümünü al

Şu komutu çalıştırın:

nuget help

Yardım çıkışının ilk satırı sürümü gösterir. Yukarı kaydırmayı önlemek için nuget help | more bunun yerine kullanın.