NuGet CLI ile NuGet paketlerini yönetme
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.