NuGet CLI başvurusu

  • Makale

NuGet Komut Satırı Arabirimi (CLI), nuget.exeproje dosyalarında değişiklik yapmadan paketleri yüklemek, oluşturmak, yayımlamak ve yönetmek için NuGet işlevinin tüm kapsamını sağlar.

Herhangi bir komutu kullanmak için bir komut penceresi veya bash kabuğu açın, ardından komutunu ve (pack komutuyla ilgili yardımı görüntülemek için) gibi nuget help pack uygun seçenekleri çalıştırınnuget.

Bu belge, NuGet CLI'nın en son sürümünü yansıtır. Kullandığınız herhangi bir sürümün tam ayrıntıları için istenen komut için komutunu çalıştırın nuget help .

CLI ile nuget.exe temel komutların nasıl kullanılacağını öğrenmek için bkz . nuget.exe CLI kullanarak paketleri yükleme ve kullanma.

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.

İpucu

NuGet CLI'yi Visual Studio'daki Paket Yöneticisi Konsolu'nda kullanılabilir hale getirmek için bkz. Konsolda nuget.exe CLI kullanma.

Kullanılabilirlik

Tam ayrıntılar için bkz . özellik kullanılabilirliği .

  • Tüm komutlar Windows'da kullanılabilir.
  • , ve updateiçin belirtilen packrestoredurumlar dışında tüm komutlar Mono üzerinde çalışan nuget.exe ile çalışır.
  • pack, restore, , delete, localsve push komutları mac ve Linux'ta dotnet CLI aracılığıyla da kullanılabilir.

Komutlar ve uygulanabilirlik

Paket oluşturma, paket tüketimi ve/veya bir paketi konakta yayımlama için kullanılabilir komutlar ve uygulanabilirlik:

Yaygın Komutlar Geçerli Roller NuGet Sürümü Açıklama
pack Oluşturma 2.7+ Bir veya proje dosyasından .nuspec NuGet paketi oluşturur. Mono üzerinde çalışırken, proje dosyasından paket oluşturma desteklenmez.
push Yayımlama Tümünü Paket kaynağında paket yayımlar.
config Tümü Tümü NuGet yapılandırma değerlerini alır veya ayarlar.
help or ? Tümü Tümü Komutla ilgili yardım bilgilerini veya yardımı görüntüler.
locals Tüketim 3.3+ Genel paketlerin, http önbelleğinin ve geçici klasörlerin konumlarını listeler ve bu klasörlerin içeriğini temizler.
restore Tüketim 2.7+ Kullanımdaki paket yönetimi biçimi tarafından başvuruda bulunan tüm paketleri geri yükler. Mono üzerinde çalışırken PackageReference biçimini kullanarak paketlerin geri yüklenmesi desteklenmez.
setapikey Yayımlama, Tüketim Tümünü Bu paket kaynağı erişim için bir anahtar gerektirdiğinde, belirli bir paket kaynağı için bir API anahtarı kaydeder.
spec Oluşturma Tümünü Dosyayı bir .nuspec Visual Studio projesinden oluşturuyorsanız belirteçleri kullanarak bir dosya oluşturur.
İkincil Komutlar Geçerli Roller NuGet Sürümü Açıklama
add Yayımlama 3.3+ Hiyerarşik düzen kullanarak HTTP olmayan bir paket kaynağına paket ekler. HTTP kaynakları için göndermeyi kullanın.
sil Yayımlama Tümünü Paket kaynağından bir paketi kaldırır veya listeden çıkarır.
init Oluşturma 3.3+ Hiyerarşik düzeni kullanarak bir klasördeki paketleri paket kaynağına ekler.
install Tüketim Tümünü Geçerli projeye bir paket yükler, ancak projeleri veya başvuru dosyalarını değiştirmez.
listele Tüketim, belki yayımlama Tümünü Belirli bir kaynaktan gelen paketleri görüntüler.
mirror Yayımlama 3.2+ ile kullanım dışı bırakıldı Bir paketi ve bağımlılıklarını bir kaynaktan hedef depoya yansıtır.
search Tüketim 5.8+ Sağlanan sorgu dizesini kullanarak belirli bir kaynağı arar.
sources Tüketim, Yayımlama Tümünü Yapılandırma dosyalarındaki paket kaynaklarını yönetir.
update Tüketim Tümünü Projenin paketlerini kullanılabilir en son sürümlere Güncelleştirmeler. Mono üzerinde çalışırken desteklenmez.

Farklı komutlar çeşitli Ortam değişkenlerini kullanır.

Geçerli rollere göre NuGet CLI komutları:

Role Komutlar
Tüketim config, , installhelp, , list, locals, restore, search, setapikey, sources,update
Oluşturma config, help, init, pack, , spec
Yayımlama add, config, delete, , help, list, push, setapikey, sources

Örneğin yalnızca paketlerin tüketilmesiyle ilgilenen geliştiricilerin yalnızca NuGet komutlarının alt kümesini anlaması gerekir.

Not

Komut seçeneği adları büyük/küçük harfe duyarlı değildir. Kullanım dışı bırakılan seçenekler ( ile değiştirilir) ve Verbose (ile değiştirilirVerbosityNonInteractive) gibi NoPrompt bu başvuruya dahil değildir.

Localization (Yerelleştirme)

NuGet.exe ilerleme durumu, uyarı ve hata iletileri Visual Studio ile aynı yerel ayarlara çevrilir. NuGet.exe tek bir exe olarak sunulur ve boyutla ilgili dikkat edilmesi gerekenler nedeniyle tüm dillerde yalnızca en yaygın olarak ortaya çıkarılmış iletiler çevrilir.