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 uygulamalarıyla çalışır. .NET Core ve .NET Standard uygulamaları için .NET Core görevini kullanın.
Sözdizimi
# 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. Select from the dropdown or enter [project name/]feed name.
#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 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ş
command
-
Komut
string
. Gerekli. İzin verilen değerler: restore
, pack
, push
, custom
. Varsayılan değer: restore
.
Çalıştırılacak NuGet komutunu belirtir. Bağımsız değişken eklemek veya farklı bir komut kullanmak için custom
değerini kullanın.
Çözüm yolu, packages.configveya project.json
Giriş diğer adı: solution
.
string
.
command = restore
gerekir. Varsayılan değer: **/*.sln
.
Geri yüklenecek paketlere başvuran çözüm, packages.config
veya project.json
dosyasının yolunu belirtir.
kullanmak için
Giriş diğer adı: selectOrConfig
.
string
.
command = restore
gerekir. İzin verilen değerler: select
(Burada seçtiğim akışlar), config
(NuGet.configakışlarım). Varsayılan değer: select
.
Görevin select
değeriyle kullanılması için Azure Artifacts'ten ve/veya NuGet.org bir akışı belirtir. Alternatif olarak, kaynak kod deponuza bir NuGet.config
dosyası işleyebilir ve config
değerini kullanarak yolunu değer olarak ayarlayabilirsiniz.
vstsFeed
-
Bu Azure Artifacts/TFS akışındaki paketleri kullanın. Açılan listeden seçin veya [proje adı/]akış adı girin.
Giriş diğer adı: feedRestore
.
string
. Opsiyonel.
selectOrConfig = select && command = restore
olduğunda kullanın.
Oluşturulan NuGet.config
seçili akışı belirtir. Burada bir akış belirtmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir.
vstsFeed
-
Bu Azure Artifacts/TFS akışındaki paketleri kullan
Giriş diğer adı: feedRestore
.
string
. Opsiyonel.
selectOrConfig = select && command = restore
olduğunda kullanın.
Oluşturulan NuGet.config
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
. Opsiyonel.
selectOrConfig = select && command = restore
olduğunda kullanın. Varsayılan değer: true
.
Oluşturulan NuGet.config
NuGet.org içerir.
NuGet.config yolunu
string
. Opsiyonel.
selectOrConfig = config && command = restore
olduğunda kullanın.
Deponuzda paketlerin geri yükleneceği akışları belirleyen NuGet.config
yolunu belirtir.
Bu kuruluş/koleksiyon dışındaki akışlar için kimlik bilgilerini
Giriş diğer adı: externalEndpoints
.
string
. Opsiyonel.
selectOrConfig = config && command = restore
olduğunda kullanın.
Seçili NuGet.config
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.
Bu hesap/koleksiyon dışındaki akışlar için kimlik bilgilerini
Giriş diğer adı: externalEndpoints
.
string
. Opsiyonel.
selectOrConfig = config && command = restore
olduğunda kullanın.
Seçili NuGet.config
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 önbellek devre dışı bırak
boolean
. Opsiyonel.
command = restore
olduğunda kullanın. Varsayılan değer: false
.
true
olarak ayarlandığında NuGet'in yerel makine önbelleklerinden gelen paketleri kullanmasını engeller.
disableParallelProcessing
-
Paralel işlemeyi devre dışı bırakma
boolean
. Opsiyonel.
command = restore
olduğunda kullanın. Varsayılan değer: false
.
true
olarak ayarlandığında NuGet'in paralel işlemlerde birden çok paket yüklemesini engeller.
hedef dizin
Giriş diğer adı: packagesDirectory
.
string
. Opsiyonel.
command = restore
olduğunda kullanın.
Paketlerin yüklendiği klasörü belirtir. Hiçbir klasör belirtilmezse paketler seçili çözümle birlikte packages/
klasörüne geri yüklenir, packages.config
veya project.json
.
verbosityRestore
-
Ayrıntı
string
. Opsiyonel.
command = restore
olduğunda kullanın. İzin verilen değerler: Quiet
, Normal
, Detailed
. Varsayılan değer: Detailed
.
Çıktıda görüntülenen ayrıntı miktarını belirtir.
yayımlamak için NuGet paketlerinin yolunu
Giriş diğer adı: searchPatternPush
.
string
.
command = push
gerekir. Varsayılan değer: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg
.
Eşleştirilecek deseni veya karşıya yüklenecek nupkg
dosyalarının yolunu belirtir. Birden çok desen noktalı virgülle ayrılabilir.
nuGetFeedType
-
Hedef akış konumu
string
.
command = push
gerekir. İ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
.
command = push
gerekir. İ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.
hedef akışı
Giriş diğer adı: feedPublish
.
string
.
command = push && nuGetFeedType = internal
gerekir.
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
. Opsiyonel.
command = push && nuGetFeedType = internal && command = push
olduğunda kullanın. Varsayılan değer: true
.
Sürekli yayımlanan paketler kümesi içinde değiştirilen paketlerin alt kümesinin sürüm numarasını değiştirir.
allowPackageConflicts
-
Yinelemelerin atlanmasına izin ver
boolean
. Opsiyonel.
command = push && nuGetFeedType = internal
olduğunda kullanın. Varsayılan değer: false
.
Bazı paketleriniz 409 Çakışma hataları ile 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.
NuGet.exe
çakışmayla karşılaşırsa 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.
NuGet sunucusu
Giriş diğer adı: externalEndpoint
.
string
.
command = push && nuGetFeedType = external
gerekir.
Dış NuGet sunucusunun kimlik bilgilerini içeren NuGet hizmet bağlantısını belirtir.
verbosityPush
-
Ayrıntı
string
. Opsiyonel.
command = push
olduğunda kullanın. İzin verilen değerler: Quiet
, Normal
, Detailed
. Varsayılan değer: Detailed
.
Çıktıda görüntülenen ayrıntı miktarını belirtir.
paketlemek için csproj veya nuspec dosyalarının yolunu
Giriş diğer adı: searchPatternPack
.
string
.
command = pack
gerekir. Varsayılan değer: **/*.csproj
.
Görevin paketlenmesi gereken csproj dizinlerini aramak için kullandığı deseni belirtir.
Birden çok deseni noktalı virgülle ayırabilir ve !
önekini ekleyerek negatif bir desen oluşturabilirsiniz. Örnek: **\*.csproj;!**\*.Tests.csproj
.
paketlemek için yapılandırmayı
Giriş diğer adı: configurationToPack
.
string
. Opsiyonel.
command = pack
olduğunda kullanın. Varsayılan değer: $(BuildConfiguration)
.
Csproj dosyası kullanılırken paketlenecek yapılandırmayı belirtir.
Paket klasörü
Giriş diğer adı: outputDir
.
string
. Opsiyonel.
command = pack
olduğunda kullanı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
.
command = pack
gerekir. İ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 includeReferencedProjects
ile kullanılamaz. İzin verilen değerler şunlardır:
-
byPrereleaseNumber
- Tarih ve saatkullanın: Görev, X, Y ve Z değerlerini belirttiğinizX.Y.Z-ci-datetime
olarak biçimlendirilmiş SemVeruyumlu bir sürüm oluşturur. -
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, paketi sürüme eklemek için derleme numarasını kullanır.
Not
Genel'in altında derleme biçimini $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
olarak ayarlayın.
includeReferencedProjects
-
Başvuruda bulunılan projeleri dahil
boolean
. Opsiyonel.
versioningScheme = off && command = pack
olduğunda kullanı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 projenin, projeyle aynı ada sahip karşılık gelen bir nuspec
dosyası varsa, bu 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 kullanarak
versionEnvVar
-
Ortam değişkeni
string
.
versioningScheme = byEnvVar && command = pack
gerekir.
$
, $env
veya %
olmadan değişken adını belirtir.
majorVersion
-
Ana
Giriş diğer adı: requestedMajorVersion
.
string
.
versioningScheme = byPrereleaseNumber && command = pack
gerekir. Varsayılan değer: 1
.
X.Y.Z
minorVersion
-
İkincil
Giriş diğer adı: requestedMinorVersion
.
string
.
versioningScheme = byPrereleaseNumber && command = pack
gerekir. Varsayılan değer: 0
.
X.Y.Z
patchVersion
-
Düzeltme Eki
Giriş diğer adı: requestedPatchVersion
.
string
.
versioningScheme = byPrereleaseNumber && command = pack
gerekir. Varsayılan değer: 0
.
X.Y.Z
packTimezone
-
Saat dilimi
string
. Opsiyonel.
versioningScheme = byPrereleaseNumber && command = pack
olduğunda kullanı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. Barındırılan derleme aracıları kullanıyorsanız tarih ve saat farklı olabileceği için utc
seçmeniz önerilir.
includeSymbols
-
Simge oluşturma paketi
boolean
. Opsiyonel.
command = pack
olduğunda kullanın. Varsayılan değer: false
.
Paketin kaynaklar ve simgeler içerdiğini belirtir. bir .nuspec
dosyasıyla kullanıldığında, bu normal bir NuGet paket dosyası ve karşılık gelen semboller paketini oluşturur.
toolPackage
-
Araç Paketi
boolean
. Opsiyonel.
command = pack
olduğunda kullanın. Varsayılan değer: false
.
Projenin çıkış dosyalarının araç klasöründe olup olmadığını belirler.
buildProperties
-
Ek derleme özellikleri
string
. Opsiyonel.
command = pack
olduğunda kullanın.
.nuspec
dosyasındaki her $token$
oluşumunun verilen değerle değiştirileceği noktalı virgülle ayrılmış token=value çiftlerinin listesini belirtir. Değerler, tırnak işaretleri içindeki dizeler olabilir.
basePath
-
Temel yol
string
. Opsiyonel.
command = pack
olduğunda kullanın.
nuspec
dosyasında tanımlanan dosyaların temel yolunu belirtir.
verbosityPack
-
Ayrıntı
string
. Opsiyonel.
command = pack
olduğunda kullanı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
-
Komutu ve bağımsız değişkenleri
string
.
command = custom
gerekir.
Yürütme için NuGet.exe
geçirilecek komutu ve bağımsız değişkenleri belirtir. NuGet 3.5 veya üzeri kullanılırsa, list
, restore
ve Bu kuruluştaki veya koleksiyondaki Proje Koleksiyonu Derleme Hizmeti'nin erişimi olan herhangi bir akışa karşı publish
gibi kimliği doğrulanmış komutların kimliği otomatik olarak doğrulanır.
Görev denetimi seçenekleri
Tüm görevlerin, 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
Hiç kimse.
Açıklamalar
Önemli
NuGet Kimlik Doğrulaması
NuGet paket bağımlılıklarını yükleyip güncelleştirmek veya 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, Visual Studio Derleme göreviönce bu adımı eklediğinizden emin olun. Ayrıca, bu görevdeki NuGet Paketlerini Geri Yükle
.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.
Bahşiş
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ükleyicisikullanın.
Sürüm oluşturma düzenleri
PrereleaseNumbertarafından
Tarafından EnvVarsürümü, versionEnvVar parametresi tarafından belirtilen ada sahip ortam değişkeninin değerine ayarlanır; örneğin, MyVersion
($yok, yalnızca ortam değişkeni adı). Ortam değişkeninin 1.2.3
veya 1.2.3-beta1
gibi uygun bir SemVer olarak ayarlandığından emin olun.
byBuildNumberBUILD_BUILDNUMBER
ortam değişkenine kaydedilen name
özelliği için belirtilen değerdir). Kullanılan derleme numarasının 1.0.$(Rev:r)
gibi düzgün bir SemVer içerdiğinden emin olun.
byBuildNumberkullanırken, görev derleme numarası dizesinden 1.2.3.4
noktalı sürümü 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 EnvVar kullanabilir ve versionEnvVarBUILD_BUILDNUMBER
olarak ayarlayabilirsiniz.
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 NuGetCommand@2
ile değiştirmeniz gerekir.
restoreMode: restore
ile NuGetInstaller@0
kullanıyorsanız, NuGetCommand@2
kullanırken aşağıdaki girişleri yapılandırın.
Görev girişini NuGetCommand@2 | Değer |
---|---|
command |
restore |
restoreSolution |
.sln dosyasının yolunu belirleme |
restoreMode: install
ile NuGetInstaller@0
kullanıyorsanız, NuGetCommand@2
kullanırken aşağıdaki girişleri yapılandırın.
Görev girişini NuGetCommand@2 | Değer |
---|---|
command |
custom |
arguments |
NuGet CLI'da tam yükleme komutunun nasıl görüneceği. Örneğin, işlem hattınızda nuget install ninject -OutputDirectory c:\proj eşdeğerini çalıştırmak istiyorsanız, arguments parametresi install ninject -OutputDirectory c:\proj olacaktır.
NuGetInstaller@0
nuGetRestoreArgs parametresini kullandıysanız, bu parametreler artık arguments bölümüne de gider. |
NuGetRestore@1
kullanıyorsanız, NuGetCommand@2
kullanırken aşağıdaki girişleri yapılandırın.
Görev girişini NuGetCommand@2 | Değer |
---|---|
command |
restore |
restoreSolution |
.sln dosyasının yolunu belirleme |
NuGetRestore@1
veya NuGetInstaller@0
restore
seçeneğini kullanmaya benzer şekilde, NuGetCommand@2
akışı ayarlamak, select
veya config
arasında karar vermek, NuGet.config
dosyasının yolunu belirtmek ve nuget.org paketlerini kullanmak için girişleri vardır.
Daha fazla bilgi içinaşağıdaki
Örnekler
Geri yüklemek
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)'
İtmek
Not
İşlem hattı yapıtları Pipeline.Workspace
dizinine ve klasik yayın işlem hatları için System.ArtifactsDirectory
dizinine indirilir.
packagesToPush
değer sırasıyla $(Pipeline.Workspace)/**/*.nupkg
veya $(System.ArtifactsDirectory)/**/*.nupkg
olarak ayarlanabilir.
NuGet.config'nizde tanımlanan bir akışa paket gönderme/yayımlama.
# Push a project - task: NuGetCommand@2 inputs: command: 'push' packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg' feedsToUse: 'config' nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
Bir paketi kuruluş kapsamlı akışına gönderme/yayımlama
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-organization-scoped-feed'
Proje kapsamlı bir 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'
Töre
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'
Gereksinim -leri
Gereksinim | Açıklama |
---|---|
İşlem hattı türleri | YAML, Klasik derleme, Klasik sürüm |
Üzerinde çalışır | Agent, DeploymentGroup |
Talepleri | Hiç kimse |
Özellikleri | Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz. |
Komut kısıtlamaları | Herhangi |
Ayarlanabilir değişkenleri | Herhangi |
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 |
Talepleri | Hiç kimse |
Özellikleri | Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz. |
Komut kısıtlamaları | Herhangi |
Ayarlanabilir değişkenleri | Herhangi |
Aracı sürümü | 2.115.0 veya üzeri |
Görev kategorisi | Paket |