NuGet CLI ile NuGet paketlerini yönetme

  • Makale

Visual Studio projelerinde ve çözümlerinde NuGet paketlerini yönetmek için CLI aracını kullanabilirsiniz nuget.exe . Bu makalede, NuGet paketlerini yönetmeye yönelik en yaygın NuGet CLI komutları açıklanmaktadır. Tüm bu komutlar Windows üzerinde çalışır ve çoğu Mac ve Linux üzerinde Mono ile çalışır.

NuGet CLI, .NET Framework ve SDK stili olmayan projelerde (örneğin, .NET Standart kitaplıklarını hedefleyen SDK stili olmayan projeler) üzerinde çalışır. NuGet CLI komutları, paket başvurularını listeleyen bir project packages.config dosyası kullanabilir. Paket başvuruları için packages.config yerine kullanan PackageReference SDK stili olmayan projeler için bunun yerine dotnet CLI kullanın.

Not

packages.config kullanan SDK stili olmayan projelerin çoğunda packages.config dosyasını PackageReference'a geçirmek ve ardından paketleri yönetmek için NuGet CLI yerine dotnet CLI'yi kullanmak en iyisidir. Ancak, C++ veya ASP.NET projelerini geçiremezsiniz.

Komutlarda farklı bir konum belirtmediğiniz sürece, çoğu komut için NuGet CLI aracı geçerli dizini kullanır. NuGet CLI komutlarını çalıştırmak için bir komut satırı açın ve proje dosyanızı içeren dizine geçin.

Komutların ve bağımsız değişkenlerinin tam listesi için bkz . NuGet CLI başvurusu.

Önkoşullar

NuGet CLI'yi nuget.org'dan indirin. nuget.exe dosyasını uygun bir dizine kaydedin ve dizinin PATH ortam değişkeninizde olduğundan emin olun.

Not

Windows için winget aracını veya macOS için Homebrew'i de kullanabilirsiniz.

NuGet CLI sürümünüzü öğrenmek için bir komut satırı açın ve komutunu çalıştırın nuget helpveya yukarı kaydırmak zorunda kalmamak için kullanın nuget help | more. Yardım çıkışındaki ilk satır sürümü gösterir.

Paketi yükleme

NuGet CLI yükleme komutu, belirtilen NuGet paketlerini indirir ve yükler.

Önemli

Komutu install proje dosyasını veya packages.config dosyasını değiştirmez. install ve restore komutları yalnızca diske paket ekler, ancak projelere bağımlılık eklemez. Proje bağımlılıkları eklemek için Visual Studio Paket Yöneticisi kullanıcı arabirimi veya Paket Yöneticisi Konsolu aracılığıyla paketleri ekleyin, ardından veya restorekomutunu çalıştırıninstall.

-OutputDirectory Paketleri belirli bir dizine yüklemek için seçeneğini kullanın. Çıkış dizini belirtmezseniz geçerli install dizini kullanır.

nuget install <packageID | configFilePath> -OutputDirectory <outputDirectory>

Örneğin, paketi paketler alt dizinine yüklemek Newtonsoft.json için aşağıdaki komutu kullanın:

nuget install Newtonsoft.Json -OutputDirectory packages

Yüklenecek paketi belirtmek yerine, geçerli veya başka bir dizinde mevcut packages.config dosyasını belirtebilirsiniz. komutu packages.config install dosyasında listelenen tüm paketleri yükler.

nuget install packages.config

Örneğin, aşağıdaki komut, config alt dizininde packages.config içinde listelenen tüm paketleri packages alt dizinine yükler:

nuget install config\packages.config -OutputDirectory packages

Paketin belirli bir sürümünü yükleme

Farklı install bir sürüm belirtmediğiniz sürece komut bir paketin en son sürümünü yükler. Paketin belirli bir sürümünü yüklemek için şu -Version seçeneği kullanın:

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

Örneğin, paketin 12.0.1 Newtonsoft.json sürümünü yüklemek için şunu kullanın:

nuget install Newtonsoft.Json -Version 12.0.1

Paketleri listeleme

Paket klasörlerinde yüklü paketlerin listesini görüntülemek için list komutunu kullanın. -Source Listeyi kısıtlamak için seçeneğini kullanın.

nuget list -Source <source>

Örneğin, MyProject'in packages alt dizinindeki paketleri listelemek için şunu kullanın:

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

Paket adlarını, etiketlerini veya açıklamalarını aramak için bir arama terimi de kullanabilirsiniz:

nuget list <"search term"> -Source <source>

Tüm paketleri güncelleştirme

Update komutunu kullanarak bir project packages.config dosyasındaki tüm paketleri en son kullanılabilir sürümlerine güncelleştirin. çalıştırmadan önce komutunu çalıştırmak restoreupdateen iyisidir.

nuget update

Paketi kaldırma

Paketi kaldırmak için bu paketi proje klasöründen silin. Paketleri yeniden yüklemek için veya install komutlarını restore kullanın.

Paketleri diskten sildiğinizde proje, packages.config veya NuGet.Config dosyaları güncelleştirilmez. Paketleri kaldırmanın en iyi yolu Visual Studio Paket Yöneticisi kullanıcı arabirimi veya Paket Yöneticisi Konsolu'nu kullanmaktır.

Paketleri geri yükleme

NuGet CLI geri yükleme komutu eksik paketleri indirir ve yükler. Komut, paket başvuruları için PackageReference veya packages.config kullanan projelerde çalışır.

restore gibiinstall, komutu diske yalnızca paketler ekler, ancak proje dosyasını veya packages.config dosyasını değiştirmez. Proje bağımlılıkları eklemek için Visual Studio Paket Yöneticisi kullanıcı arabirimini veya Konsolunu kullanın.

Paketleri geri yüklemek için aşağıdaki komutu çalıştırın:

nuget restore <projectPath>

Komut, restore belirtilen proje yolunda bir çözüm dosyası veya package.config dosyası kullanır.

Örneğin, geçerli dizindeki MySolution.sln tüm paketlerini geri yüklemek için şunu çalıştırın:

nuget restore MySolution.sln

Not

kullanan PackageReferenceSDK stili olmayan projeler için, bunun yerine paketleri geri yüklemek için msbuild -t:restore kullanın.

Daha fazla bilgi için bkz . Paketleri geri yükleme.

Sonraki adımlar