Aracılığıyla paylaş


NuGetCommand@2 - NuGet v2 görevi

NuGet paketlerini geri yüklemek, paketlemek veya göndermek ya da bir NuGet komutu çalıştırmak için bu görevi kullanın. Bu görev Azure Artifacts ve MyGet gibi NuGet.org ve kimliği doğrulanmış akışları destekler. Bu görev ayrıca NuGet.exe kullanır ve .NET Framework uygulamalarla çalışır. .NET Core ve .NET Standard uygulamaları için .NET Core görevini kullanın.

Syntax

# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
  inputs:
    command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
    restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to package. Default: $(BuildConfiguration).
    #packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
    #arguments: # string. Required when command = custom. Command and arguments. 
  # Feeds and authentication
    feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts/TFS feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal && command = push. Publish pipeline metadata. Default: true.
    #verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
    #packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
    #includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
    #toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #basePath: # string. Optional. Use when command = pack. Base path. 
    #verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.
# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Package Management and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
  inputs:
    command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
    restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to package. Default: $(BuildConfiguration).
    #packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
    #arguments: # string. Required when command = custom. Command and arguments. 
  # Feeds and authentication
    feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts/TFS feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this account/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
    #packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
    #includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
    #toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #basePath: # string. Optional. Use when command = pack. Base path. 
    #verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.

Girişler

command - Komut
string. Gereklidir. İzin verilen değerler: restore, pack, push, custom. Varsayılan değer: restore.

Çalıştırılacak NuGet komutunu belirtir. custom Bağımsız değişken eklemek veya farklı bir komut kullanmak için değerini kullanın.


restoreSolution - Çözüm, packages.config veya project.json yolu
Giriş diğer adı: solution. string. olduğunda command = restoregereklidir. Varsayılan değer: **/*.sln.

Geri yüklenecek paketlere başvuran çözüm, packages.configveya project.json dosyanın yolunu belirtir.


feedsToUse - Kullanılacak akışlar
Giriş diğer adı: selectOrConfig. string. olduğunda command = restoregereklidir. İzin verilen değerler: select (Burada seçtiğim akışlar), config (NuGet.config akışlar). Varsayılan değer: select.

Görev için Azure Artifacts'ten ve/veya NuGet.org değeriyle select kullanılacak akışı belirtir. Alternatif olarak, kaynak kod deponuza bir NuGet.config dosya işleyebilir ve değerini kullanarak config yolunu değer olarak ayarlayabilirsiniz.


vstsFeed - Bu Azure Artifacts/TFS akışındaki paketleri kullan
Giriş diğer adı: feedRestore. string. İsteğe bağlı. olduğunda selectOrConfig = select && command = restorekullanın.

Oluşturulan NuGet.configiçinde seçili akışı belirtir. Burada bir akış belirtmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir.


includeNuGetOrg - NuGet.org paketlerini kullanma
boolean. İsteğe bağlı. olduğunda selectOrConfig = select && command = restorekullanın. Varsayılan değer: true.

Oluşturulan NuGet.configöğesine NuGet.org ekler.


nugetConfigPath - NuGet.configyolu
string. İsteğe bağlı. olduğunda selectOrConfig = config && command = restorekullanın.

Deponuzda paketlerin geri yükleneceği akışları belirleyen yolunu NuGet.config belirtir.


externalFeedCredentials - Bu kuruluş/koleksiyon dışındaki akışlar için kimlik bilgileri
Giriş diğer adı: externalEndpoints. string. İsteğe bağlı. olduğunda selectOrConfig = config && command = restorekullanın.

Seçili NuGet.configiçinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgilerini belirtir. Bu, NuGet hizmet bağlantınızın adıdır. Bu kuruluş veya koleksiyondaki akışlar için bunu boş bırakın; derlemenin kimlik bilgileri otomatik olarak kullanılır.


externalFeedCredentials - Bu hesap/koleksiyon dışındaki akışlar için kimlik bilgileri
Giriş diğer adı: externalEndpoints. string. İsteğe bağlı. olduğunda selectOrConfig = config && command = restorekullanın.

Seçili NuGet.configiçinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgilerini belirtir. Bu, NuGet hizmet bağlantınızın adıdır. Bu hesap veya koleksiyondaki akışlar için bunu boş bırakın; derlemenin kimlik bilgileri otomatik olarak kullanılır.


noCache - Yerel önbelleği devre dışı bırakma
boolean. İsteğe bağlı. olduğunda command = restorekullanın. Varsayılan değer: false.

Olarak ayarlandığında trueNuGet'in yerel makine önbelleklerinden gelen paketleri kullanmasını engeller.


disableParallelProcessing - Paralel işlemeyi devre dışı bırakma
boolean. İsteğe bağlı. olduğunda command = restorekullanın. Varsayılan değer: false.

Olarak ayarlandığında NuGet'in paralel işlemlerde birden çok paket yüklemesini trueengeller.


restoreDirectory - Hedef dizin
Giriş diğer adı: packagesDirectory. string. İsteğe bağlı. olduğunda command = restorekullanın.

Paketlerin yüklendiği klasörü belirtir. Hiçbir klasör belirtilmezse, paketler seçilen çözüm packages.configveya project.jsonile birlikte bir packages/ klasöre geri yüklenir.


verbosityRestore - Ayrıntı
string. İsteğe bağlı. olduğunda command = restorekullanın. İzin verilen değerler: Quiet, Normal, Detailed. Varsayılan değer: Detailed.

Çıktıda görüntülenen ayrıntı miktarını belirtir.


packagesToPush - Yayımlayacak NuGet paketlerinin yolu
Giriş diğer adı: searchPatternPush. string. olduğunda command = pushgereklidir. Varsayılan değer: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Eşleştirilecek deseni veya karşıya yüklenecek dosyaların yolunu nupkg belirtir. Birden çok desen noktalı virgülle ayrılabilir.


nuGetFeedType - Hedef akış konumu
string. olduğunda command = pushgereklidir. İzin verilen değerler: internal (Bu kuruluş/koleksiyon), external (Dış NuGet sunucusu (diğer hesaplar/koleksiyonlar dahil)). Varsayılan değer: internal.

Hedef akışın bir iç akış/koleksiyon mu yoksa bir dış NuGet sunucusu mu olduğunu belirtir.


nuGetFeedType - Hedef akış konumu
string. olduğunda command = pushgereklidir. İzin verilen değerler: internal (Bu hesap/koleksiyon), external (Dış NuGet sunucusu (diğer hesaplar/koleksiyonlar dahil)). Varsayılan değer: internal.

Hedef akışın bir iç akış/koleksiyon mu yoksa bir dış NuGet sunucusu mu olduğunu belirtir.


publishVstsFeed - Hedef akış
Giriş diğer adı: feedPublish. string. olduğunda command = push && nuGetFeedType = internalgereklidir.

Bu hesapta barındırılan bir akışı belirtir. Burada bir akış seçmek için Azure Artifacts'in yüklü ve lisanslı olması gerekir.


publishPackageMetadata - İşlem hattı meta verilerini yayımlama
boolean. İsteğe bağlı. olduğunda command = push && nuGetFeedType = internal && command = pushkullanın. Varsayılan değer: true.

Sürekli yayımlanan bir paket kümesi içindeki değiştirilen paketlerin alt kümesinin sürüm numarasını değiştirir.


allowPackageConflicts - Yinelenenlerin atlanması için izin ver
boolean. İsteğe bağlı. olduğunda command = push && nuGetFeedType = internalkullanın. Varsayılan değer: false.

Bazı paketleriniz 409 Çakışma hatalarıyla reddedilmiş olsa bile görevin başarılı olduğunu bildirir.

Bu seçenek şu anda yalnızca Azure Pipelines ve Windows aracılarında kullanılabilir. Çakışmayla karşılaşırsanız NuGet.exe görev başarısız olur. Bu seçenek çalışmaz ve bir ara sunucu ortamındaysanız yayımlama başarısız olur.


publishFeedCredentials - NuGet sunucusu
Giriş diğer adı: externalEndpoint. string. olduğunda command = push && nuGetFeedType = externalgereklidir.

Dış NuGet sunucusunun kimlik bilgilerini içeren NuGet hizmet bağlantısını belirtir.


verbosityPush - Ayrıntı
string. İsteğe bağlı. olduğunda command = pushkullanın. İzin verilen değerler: Quiet, Normal, Detailed. Varsayılan değer: Detailed.

Çıktıda görüntülenen ayrıntı miktarını belirtir.


packagesToPack - Paketlenmesi gereken csproj veya nuspec dosyasının yolu
Giriş diğer adı: searchPatternPack. string. olduğunda command = packgereklidir. Varsayılan değer: **/*.csproj.

Görevin paketlenmek üzere csproj dizinlerini aramak için kullandığı deseni belirtir.

Birden çok deseni noktalı virgülle ayırabilir ve ön ekiyle !ekleyerek negatif bir desen oluşturabilirsiniz. Örnek: **\*.csproj;!**\*.Tests.csproj.


configuration - Pakete yapılandırma
Giriş diğer adı: configurationToPack. string. İsteğe bağlı. olduğunda command = packkullanın. Varsayılan değer: $(BuildConfiguration).

Csproj dosyası kullanılırken pakete eklenecek yapılandırmayı belirtir.


packDestination - Paket klasörü
Giriş diğer adı: outputDir. string. İsteğe bağlı. olduğunda command = packkullanın. Varsayılan değer: $(Build.ArtifactStagingDirectory).

Görevin paketleri oluşturduğu klasörü belirtir. Değer boşsa, görev kaynak kökte paketler oluşturur.


versioningScheme - Otomatik paket sürümü oluşturma
string. olduğunda command = packgereklidir. İzin verilen değerler: off, byPrereleaseNumber (Tarih ve saati kullanın), byEnvVar (Ortam değişkeni kullanın), byBuildNumber (Derleme numarasını kullanın). Varsayılan değer: off.

Belirtilen değere bağlı olarak otomatik paket sürümü oluşturma uygular. Bu dize ile includeReferencedProjectskullanılamaz. İzin verilen değerler şunlardır:

  • byPrereleaseNumber - Tarih ve saati kullanın: Görev olarak X.Y.Z-ci-datetimebiçimlendirilmiş SemVer uyumlu bir sürüm oluşturur ve burada X, Y ve Z değerlerini belirtirsiniz.
  • byEnvVar- Ortam değişkeni kullan: Görev, belirttiğiniz bir ortam değişkeni kullanır ve kullanmak istediğiniz sürüm numarasını içerir.
  • byBuildNumber - Derleme numarasını kullanın: Görev, paketin sürümünü oluşturmak için derleme numarasını kullanır.

Not

Genel'in altında derleme biçimini olarak $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)ayarlayın.


includeReferencedProjects - Başvuruda bulunılan projeleri dahil et
boolean. İsteğe bağlı. olduğunda versioningScheme = off && command = packkullanın. Varsayılan değer: false.

Başvuruda bulunan projeleri bağımlılık olarak veya paketin bir parçası olarak içerir. Otomatik paket sürümü oluşturma ile kullanılamaz. Başvuruda bulunılan bir proje, projeyle aynı ada sahip karşılık gelen nuspec bir dosyaya sahipse, başvuruda bulunılan proje bağımlılık olarak eklenir. Aksi takdirde, başvuruda bulunan proje paketin bir parçası olarak eklenir. NuGet paketleri oluşturmak için NuGet CLI için paket komutunu kullanma hakkında daha fazla bilgi edinin.


versionEnvVar - Ortam değişkeni
string. olduğunda versioningScheme = byEnvVar && command = packgereklidir.

değişken adını , $envveya %olmadan $belirtir.


majorVersion - Büyük
Giriş diğer adı: requestedMajorVersion. string. olduğunda versioningScheme = byPrereleaseNumber && command = packgereklidir. Varsayılan değer: 1.

sürüm XX.Y.Z.


minorVersion - Küçük
Giriş diğer adı: requestedMinorVersion. string. olduğunda versioningScheme = byPrereleaseNumber && command = packgereklidir. Varsayılan değer: 0.

sürüm YX.Y.Z.


patchVersion - Yama
Giriş diğer adı: requestedPatchVersion. string. olduğunda versioningScheme = byPrereleaseNumber && command = packgereklidir. Varsayılan değer: 0.

sürüm ZX.Y.Z.


packTimezone - Saat dilimi
string. İsteğe bağlı. olduğunda versioningScheme = byPrereleaseNumber && command = packkullanın. İzin verilen değerler: utc, local (Aracı yerel saati). Varsayılan değer: utc.

Paketin sürümünü oluşturmak için kullanılan istenen saat dilimini belirtir. utc Tarih ve saat farklı olabileceği için barındırılan derleme aracıları kullanıyorsanız, bu aracıların seçilmesi önerilir.


includeSymbols - Sembol paketi oluşturma
boolean. İsteğe bağlı. olduğunda command = packkullanın. Varsayılan değer: false.

Paketin kaynaklar ve simgeler içerdiğini belirtir. Dosyayla .nuspec kullanıldığında, normal bir NuGet paket dosyası ve karşılık gelen semboller paketi oluşturulur.


toolPackage - Araç Paketi
boolean. İsteğe bağlı. olduğunda command = packkullanın. Varsayılan değer: false.

Projenin çıkış dosyalarının araç klasöründe olup olmadığını belirler.


buildProperties - Ek derleme özellikleri
string. İsteğe bağlı. olduğunda command = packkullanın.

Dosyasındaki her oluşumun verilen değerle değiştirileceği noktalı virgülle ayrılmış token=value çiftlerinin $token$.nuspec listesini belirtir. Değerler, tırnak işaretleri içindeki dizeler olabilir.


basePath - Temel yol
string. İsteğe bağlı. olduğunda command = packkullanın.

Dosyada nuspec tanımlanan dosyaların temel yolunu belirtir.


verbosityPack - Ayrıntı
string. İsteğe bağlı. olduğunda command = packkullanın. İzin verilen değerler: Quiet, Normal, Detailed. Varsayılan değer: Detailed.

Çıktıda görüntülenen ayrıntı miktarını belirtir.


arguments - Komut ve bağımsız değişkenler
string. olduğunda command = customgereklidir.

Yürütme için geçirilecek NuGet.exe komutu ve bağımsız değişkenleri belirtir. NuGet 3.5 veya üzeri kullanılırsa, bu kuruluştaki veya koleksiyondaki Proje Koleksiyonu Derleme Hizmeti'nin erişimi olan herhangi bir akışa karşı , restoreve publish gibi listkimliği doğrulanmış komutlar otomatik olarak doğrulanır.


Görev denetim seçenekleri

Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Yok.

Açıklamalar

Önemli

NuGet Kimlik Doğrulaması görevi, Azure Artifacts ve diğer NuGet depolarında kimlik doğrulaması yapmak için önerilen yeni yoldur. Bu görev artık yeni özellikler almaz ve yalnızca kritik hatalar giderilir.

NuGet paket bağımlılıklarını yüklemek ve güncelleştirmek ya da NuGet paketlerini paketleyip yayımlamak için bu görevi kullanın. NuGet.exe kullanır ve .NET Framework uygulamalarıyla çalışır. .NET Core ve .NET Standard uygulamaları için .NET Core görevini kullanın.

Kodunuz NuGet paketlerine bağlıysa bu adımı Visual Studio Derleme görevinizden önce eklediğinizden emin olun. Ayrıca, bu görevdeki kullanım dışı NuGet Paketlerini Geri Yükle onay kutusunun işaretini kaldırdığından emin olun.

.NET Core veya .NET Standard ile çalışıyorsanız, tüm paket senaryoları için tam desteğe sahip olan ve şu anda dotnet tarafından desteklenen .NET Core görevini kullanın.

İpucu

NuGet görevinin bu sürümü varsayılan olarak NuGet 4.1.0 kullanır. NuGet'in farklı bir sürümünü seçmek için Araç Yükleyicisi'ni kullanın.

Sürüm oluşturma düzenleri

byPrereleaseNumber için, sürüm ana sürüm, ikincil sürüm ve düzeltme eki için seçtiğiniz değerlere, ayrıca biçimindeki yyyymmdd-hhmmsstarih ve saat değerine ayarlanır.

ByEnvVar için, sürüm versionEnvVar parametresi tarafından belirtilen ada sahip ortam değişkeninin değerine ayarlanır; örneğin MyVersion (hayır$, yalnızca ortam değişkeni adı). Ortam değişkeninin veya 1.2.3-beta1gibi uygun bir SemVer olarak 1.2.3 ayarlandığından emin olun.

byBuildNumber için sürüm, işlem hattı çalıştırmasının derleme numarası kullanılarak ayarlanır. Bu, işlem hattının name ortam değişkenine kaydedilen BUILD_BUILDNUMBER özelliği için belirtilen değerdir. Kullanılan derleme numarasının gibi 1.0.$(Rev:r)uygun bir SemVer içerdiğinden emin olun. byBuildNumber kullanırken görev, 1.2.3.4derleme numarası dizesinden noktalı sürümünü ayıklar ve yalnızca bu bölümü kullanır. Dizenin geri kalanı bırakılır. Derleme numarasını olduğu gibi kullanmak istiyorsanız, yukarıda açıklandığı gibi ByEnvVar'ı kullanabilir ve versionEnvVar'ı olarak BUILD_BUILDNUMBERayarlayabilirsiniz.

NuGetInstaller@0 veya NuGetRestore@1'dan geçiş

NuGetInstaller@0 ve NuGetRestore@1 kullanım dışıdır ve bunları işlem hattınızda ile NuGetCommand@2değiştirmeniz gerekir.

ile restoreMode: restorekullanıyorsanız NuGetInstaller@0 kullanırken aşağıdaki girişleri NuGetCommand@2yapılandırın.

Görev girişini NuGetCommand@2 Değer
command restore
restoreSolution .sln dosyasının yolunu belirleme

ile restoreMode: installkullanıyorsanız NuGetInstaller@0 kullanırken aşağıdaki girişleri NuGetCommand@2yapılandırın.

Görev girişini NuGetCommand@2 Değer
command custom
arguments Tam yükleme komutunun NuGet CLI'da nasıl görüneceği. Örneğin, işlem hattınızda eşdeğerini nuget install ninject -OutputDirectory c:\proj çalıştırmak istiyorsanız parametresi arguments olacaktır install ninject -OutputDirectory c:\proj. parametresini NuGetInstaller@0nuGetRestoreArgs kullanıyorsanız, bu parametreler de içinde argumentsyer alır.

kullanıyorsanız NuGetRestore@1kullanırken aşağıdaki girişleri NuGetCommand@2yapılandırın.

Görev girişini NuGetCommand@2 Değer
command restore
restoreSolution .sln dosyasının yolunu belirleme

veya NuGetRestore@1NuGetInstaller@0restore seçeneğine benzer şekilde, akışı ayarlamak, NuGetCommand@2 veya configarasında select karar vermek, dosyanın yolunu belirtmek ve nuget.org paketlerini kullanmak için NuGet.config girişleri vardır.

Daha fazla bilgi için aşağıdaki örneklere bakın.

Örnekler

Geri Yükleme

Seçili bir akıştan gelen paketlerle tüm çözümlerinizi geri yükleyin.

# Restore from a project scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-project/my-project-scoped-feed'
    includeNuGetOrg: false
    restoreSolution: '**/*.sln'
# Restore from an organization scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-organization-scoped-feed'
    restoreSolution: '**/*.sln'
# Restore from a feed in a different organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: config
    nugetConfigPath: ./nuget.config
    restoreSolution: '**/*.sln'
    externalFeedCredentials: 'MyServiceConnectionName'
    noCache: true
  continueOnError: true
# Restore from feed(s) set in nuget.config
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'config'
    nugetConfigPath: 'nuget.config'

Paket

Hedef klasörde bir NuGet paketi oluşturun.

# Package a project
- task: NuGetCommand@2
  inputs:
    command: 'pack'
    packagesToPack: '**/*.csproj'
    packDestination: '$(Build.ArtifactStagingDirectory)'

Gönder

Not

İşlem hattı yapıtları dizinine Pipeline.Workspace ve klasik yayın işlem hatlarının dizinine System.ArtifactsDirectory indirilir. packagesToPushdeğeri sırasıyla veya $(System.ArtifactsDirectory)/**/*.nupkg olarak ayarlanabilir$(Pipeline.Workspace)/**/*.nupkg.

  • Paketi NuGet.config tanımlı bir akışa gönderme/yayımlama.

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
        feedsToUse: 'config'
        nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
    
  • Paket gönderme/kuruluş kapsamlı akışına yayımlama

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-organization-scoped-feed'
    
  • Proje kapsamlı akışa paket gönderme/yayımlama

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-project/my-project-scoped-feed'
    
  • Paketi NuGet.org gönderme/yayımlama

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        feedsToUse: 'config'
        includeNugetOrg: 'true'
    

Özel

Varsayılan komutlardan başka herhangi bir NuGet komutunu çalıştırın: paketle, gönder ve geri yükle.

# list local NuGet resources.
- task: NuGetCommand@2
  displayName: 'list locals'
  inputs:
    command: custom
    arguments: 'locals all -list'

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalıştırılır Agent, DeploymentGroup
Talep Hiçbiri
Özellikler Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 2.144.0 veya üzeri
Görev kategorisi Paket
Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talep Hiçbiri
Özellikler Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 2.115.0 veya üzeri
Görev kategorisi Paket