DotNetCoreCLI@2 - .NET Core v2 görevi

Bir dotnet uygulaması derleyin, test edin, paketleyin veya yayımlayın ya da özel bir dotnet komutu çalıştırın.

Bir dotnet uygulaması derleyin, test edin, paketleyin veya yayımlayın ya da özel bir dotnet komutu çalıştırın. Paket komutları için Paket Yönetimi ve MyGet gibi NuGet.org ve kimliği doğrulanmış akışları destekler.

Önemli

NuGet Kimlik Doğrulaması görevi, Azure Artifacts ve diğer NuGet depolarıyla kimlik doğrulaması yapmak için önerilen yeni yoldur. restore Bu .NET Core CLI görevinin ve push komutları artık yeni özellikler almaz ve yalnızca kritik hatalar giderilir. Ayrıntılar için açıklamalara bakın.

Syntax

# .NET Core v2
# Build, test, package, or publish a dotnet application, or run a custom dotnet command.
- task: DotNetCoreCLI@2
  inputs:
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish web projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s) or solution(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #restoreArguments: # string. Optional. Use when command = restore. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip published projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project's folder name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.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. 
    #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).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
  # 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 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.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. 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.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #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.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack && command != pack && command != push && command != restore. Working directory.
# .NET Core v2
# Build, test, package, or publish a dotnet application, or run a custom dotnet command.
- task: DotNetCoreCLI@2
  inputs:
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish web projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #restoreArguments: # string. Optional. Use when command = restore. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip published projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project's folder name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.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. 
    #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).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
  # 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 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.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. 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.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #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.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack && command != pack && command != push && command != restore. Working directory.
# .NET Core v2
# Build, test, package, or publish a dotnet application, or run a custom dotnet command.
- task: DotNetCoreCLI@2
  inputs:
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish Web Projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip Published Projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.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. 
    #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).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
  # 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 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.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. 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.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #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.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != pack && command != push && command != restore. Working Directory.
# .NET Core v2
# Build, test, package, or publish a dotnet application, or run a custom dotnet command. For package commands, supports NuGet.org and authenticated feeds like Package Management and MyGet.
- task: DotNetCoreCLI@2
  inputs:
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish Web Projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip Published Projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.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. 
    #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).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
  # 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.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #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.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != pack && command != push && command != restore. Working Directory.

Girişler

command - Komut
string. Gereklidir. İzin verilen değerler: build, push (nuget push), pack, publish, restore, run, test, custom. Varsayılan değer: build.

Çalıştırılacak dotnet komutu. Bağımsız değişken eklemek için belirtin custom veya burada listelenmeyen bir komut kullanın.

Önemli

NuGet Kimlik Doğrulaması görevi, Azure Artifacts ve diğer NuGet depolarıyla kimlik doğrulaması yapmak için önerilen yeni yoldur. restore Bu .NET Core CLI görevinin ve push komutları artık yeni özellikler almaz ve yalnızca kritik hatalar giderilir. Ayrıntılar için açıklamalara bakın.


publishWebProjects - Web projelerini yayımlama
boolean. İsteğe bağlı. when command = publishkullanın. Varsayılan değer: true.

Bu giriş olarak trueprojects ayarlanırsa, özellik değeri atlanır ve görev depodaki web projelerini bulmaya çalışır ve bu projelerde yayımla komutunu çalıştırır. Web projeleri, dizindeki bir web.config dosyanın veya wwwroot klasörün varlığıyla tanımlanır. Bir dosya veya wwwroot klasör olmadığındaweb.config, gibi Microsoft.NET.Sdk.Webbir web SDK'sı kullanan projeler seçilir.


publishWebProjects - Web Projelerini Yayımla
boolean. İsteğe bağlı. when command = publishkullanın. Varsayılan değer: true.

Bu giriş olarak trueprojects ayarlanırsa, özellik değeri atlanır ve görev depodaki web projelerini bulmaya çalışır ve bu projelerde yayımla komutunu çalıştırır. Web projeleri, dizindeki bir web.config dosyanın veya wwwroot klasörün varlığıyla tanımlanır. Bir dosya veya wwwroot klasör olmadığındaweb.config, gibi Microsoft.NET.Sdk.Webbir web SDK'sı kullanan projeler seçilir.


projects - Proje veya çözüm yolu
string. İsteğe bağlı. when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = falsekullanın.

Kullanılacak veya .sln dosyasının .csproj yolu. Joker karakterler kullanabilirsiniz (örneğin **/*.csproj , tüm alt klasörlerdeki tüm .csproj dosyalar için). Daha fazla bilgi için bkz. dosya eşleştirme desenleri başvurusu.

Bu yol, ayardan bağımsız olarak deponun köküne workingDirectory göredir.


projects - Proje yolu
string. İsteğe bağlı. when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = falsekullanın.

Kullanılacak dosya yolu .csproj . Joker karakterler kullanabilirsiniz (örneğin **/*.csproj , tüm alt klasörlerdeki tüm .csproj dosyalar için). Daha fazla bilgi için bkz. dosya eşleştirme desenleri başvurusu.

Bu yol, ayardan bağımsız olarak deponun köküne workingDirectory göredir.


custom - Özel komut
string. olduğunda command = customgereklidir.

Yürütme için geçirilir dotnet.exe komutu. Kullanılabilir komutların tam listesi için dotnet CLI belgelerine bakın.


arguments - Bağımsız değişken
string. İsteğe bağlı. when command = build || command = publish || command = run || command = test || command = customkullanın.

Seçili komutun bağımsız değişkenlerini belirtir. Örneğin, derleme yapılandırması, çıkış klasörü ve çalışma zamanı. Bağımsız değişkenler, seçilen komuta bağlıdır.

Bu giriş şu anda yalnızca , , publish, testrunve custombağımsız değişkenlerini kabul ederbuild. Listelenmeyen bir komut için bağımsız değişkenler eklemek isterseniz kullanın custom.


restoreArguments - Bağımsız değişken
string. İsteğe bağlı. when command = restorekullanın.

Komutuna geçirilecek restore ek bağımsız değişkenleri yazar.


publishTestResults - Test sonuçlarını ve kod kapsamını yayımlama
boolean. İsteğe bağlı. when command = testkullanın. Varsayılan değer: true.

Bu seçeneğin etkinleştirilmesi, içinde $(Agent.TempDirectory)bir test results TRX dosyası oluşturur ve sonuçlar sunucuda yayımlanır.

Bu seçenek komut satırı bağımsız değişkenlerine eklenir --logger trx --results-directory $(Agent.TempDirectory) .

Kod kapsamı, komut satırı bağımsız değişkenlerine seçeneği eklenerek --collect "Code coverage" toplanabilir.


testRunTitle - Test çalıştırması başlığı
string. İsteğe bağlı. when command = testkullanın.

Test çalıştırması için bir ad sağlar.


zipAfterPublish - Yayımlanan projeleri zip ile yayımlama
boolean. İsteğe bağlı. when command = publishkullanın. Varsayılan değer: true.

Bu giriş olarak ayarlanırsa true, yayımla komutu tarafından oluşturulan klasörler daraltılır ve silinir.


zipAfterPublish - Zip Yayımlanan Projeler
boolean. İsteğe bağlı. when command = publishkullanın. Varsayılan değer: true.

Bu giriş olarak ayarlanırsa true, yayımla komutu tarafından oluşturulan klasör daraltılır ve silinir.


modifyOutputPath - Yayımlama yoluna projenin klasör adını ekleme
boolean. İsteğe bağlı. when command = publishkullanın. Varsayılan değer: true.

Bu giriş olarak trueayarlanırsa, çıkış yolu bağımsız değişkenlerde açıkça belirtildiğinde, yayımla komutu tarafından oluşturulan klasörlerin klasör adlarına proje dosya adı ön eki eklenir. Aynı klasöre birden çok proje yayımlamak istiyorsanız bu yararlı olur.


modifyOutputPath - Yayımlama yoluna proje adı ekleme
boolean. İsteğe bağlı. when command = publishkullanın. Varsayılan değer: true.

Bu giriş olarak trueayarlanırsa, çıkış yolu bağımsız değişkenlerde açıkça belirtildiğinde, yayımla komutu tarafından oluşturulan klasörlerin klasör adlarına proje dosya adı ön eki eklenir. Aynı klasöre birden çok proje yayımlamak istiyorsanız bu yararlı olur.


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.

Azure Artifacts'ten ve/veya buradan bir akış seçebilir veya NuGet.org bir nuget.config dosyayı kaynak kod deponuza işleyebilir ve girişi kullanarak nugetConfigPath yolunu ayarlayabilirsiniz.


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

Seçilen akışı oluşturulan NuGet.configiçine ekler. Burada bir akış seçmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir. projectName/feedName proje kapsamlı akışlar için kullanılır. Yalnızca FeedName kuruluş kapsamındaki akışlar için kullanılır. Not: Bu, test komutu için desteklenmez.


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

Seçilen akışı oluşturulan NuGet.configiçine ekler. Burada bir akış seçmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir. projectName/feedName , proje kapsamlı akışlar için kullanılır. Yalnızca FeedName kuruluş kapsamındaki akışlar için kullanılır. Not: Bu, test komutu için desteklenmez.


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

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


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

NuGet.config Deponuzda, paketlerin geri yükleneceği akışları belirten .


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

Seçili NuGet.configiçinde bulunan dış kayıt defterleri için kullanılacak kimlik bilgileri. Bu kuruluştaki/koleksiyondaki akışlar için bu girişi 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ı. when command = restorekullanın. Varsayılan değer: false.

NuGet'in yerel makine önbelleklerindeki paketleri kullanmasını engeller.


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

Paketlerin yüklendiği klasörü belirtir. Hiçbir klasör belirtilmezse paketler varsayılan NuGet paket önbelleğine geri yüklenir.


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

Komutun çıktısında restore 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.

Eşleştirilecek desen veya karşıya yüklenecek dosyaların yolu nupkg . Birden çok desen noktalı virgülle ayrılabilir ve ön ek !olarak ekleyerek deseni negatif yapabilirsiniz. Örnek: **/*.nupkg;!**/*.Tests.nupkg.


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

Hedef akışın iç mi yoksa dış mı olduğunu belirtir.


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

Bu kuruluşta barındırılan bir akışı belirtir. Burada bir akış seçmek için Paket Yönetimi'nin yüklü ve lisanslı olması gerekir.


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

Bu derleme/yayın işlem hattının meta verilerini (#, kaynak kodu bilgilerini çalıştır) paketle ilişkilendirir.


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ı .


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

Aranacak .csproj desen veya .nuspec paketlenmek üzere dosyalar.

Birden çok deseni noktalı virgülle ayırabilir ve ön ekiyle !ekleyerek deseni negatif yapabilirsiniz. Örnek: **/*.csproj;!**/*.Tests.csproj.


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

Bir .csproj dosya kullanılırken, bu giriş pakete eklenecek yapılandırmayı belirtir.


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

Paketlerin oluşturulacağı klasör. Bu klasör boşsa, dosyayla csproj birlikte paketler oluşturulur.


nobuild - Derleme
boolean. İsteğe bağlı. when command = packkullanın. Varsayılan değer: false.

Görevin paketlemeden önce projeyi oluşturacağını belirtir. Bu görev, komutun --no-build parametresine build karşılık gelir.


includesymbols - Simgeleri Dahil Et
boolean. İsteğe bağlı. when command = packkullanın. Varsayılan değer: false.

Simge NuGet paketleri oluşturur. Bu görev komut satırı parametresine --include-symbols karşılık gelir.


includesource - Kaynağı Dahil Et
boolean. İsteğe bağlı. when command = packkullanın. Varsayılan değer: false.

Pakete kaynak kodu ekler. Bu görev komut satırı parametresine --include-source karşılık gelir.


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.

Bu görev, eklenen başvurulan projelerle kullanılamaz. öğesini seçersenizUse the date and time, bu, , Yve Zseçeneklerini belirlediğiniz Xşekilde biçimlendirilmiş X.Y.Z-ci-datetimeSemVer uyumlu bir sürüm oluşturur.

seçerseniz Use an environment variable, bir ortam değişkeni seçmeniz ve kullanmak istediğiniz sürüm numarasını içerdiğinden emin olmanız gerekir.

öğesini seçerseniz Use the build number, paketinizin sürümünü oluşturmak için derleme numarası kullanılır. Not: altında Options, derleme numarası biçimini olarak $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)ayarlayın.


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.

X.Y.ZX sürümündeki.


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

X.Y.ZY sürümündeki.


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

X.Y.ZZ sürümündeki.


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

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


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

Komutun çıktısında pack görüntülenen ayrıntı miktarını belirtir.


workingDirectory - Çalışma dizini
string. İsteğe bağlı. when command != restore && command != push && command != pack && command != pack && command != push && command != restorekullanın.

Betiğin çalıştırıldığı geçerli çalışma dizini. Empty , deponun (derleme) veya yapıtların (yayın) köküdür $(System.DefaultWorkingDirectory).


workingDirectory - Çalışma Dizini
string. İsteğe bağlı. when command != pack && command != push && command != restorekullanın.

Betiğin çalıştırıldığı geçerli çalışma dizini. Empty , deponun (derleme) veya yapıtların (yayın) köküdür $(System.DefaultWorkingDirectory).


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ıyla kimlik doğrulaması yapmak için önerilen yeni yoldur. restore Bu .NET Core CLI görevinin ve push komutları artık yeni özellikler almaz ve yalnızca kritik hatalar giderilir.

Derleme, yayımlama veya test adımı neden paketleri geri yükleyemediğinde?

, publishve dahil olmak üzere buildçoğu dotnet komut örtük restore bir adım test içerir. Önceki adımda kullanılan kimlik bilgileri temizlendiğinden, daha önceki bir adımda başarılı dotnet restore bir şekilde çalıştırmış olsanız bile bu, kimliği doğrulanmış akışlarda başarısız olur.

Bu sorunu çözmek için bayrağını --no-restore metin kutusuna Arguments ekleyin.

Ayrıca, test komut veya vstsFeed bağımsız değişkenlerini tanımaz feedRestore ve örtük restore adım çalıştırıldığında bu şekilde belirtilen akışlar oluşturulan NuGet.config dosyaya dahil edilmeyecektir. Paketleri geri yüklemek için açık dotnet restore bir adımın kullanılması önerilir. restore komutu ve vstsFeed bağımsız değişkenlerine feedRestore saygı gösterir.

Makinemde derleme yaparken hiçbir uyarı olmamasına rağmen neden Paket Kaynağı Eşlemesi ile NU1507 uyarıları alıyorum?

NuGet geri yükleme veya NuGet akışına erişme işlemi gerçekleştiren çeşitli komutlar, Azure yapıtları NuGet akışları için NuGet kimlik doğrulaması ekleyen özel bir geçici NuGet.config dosya oluşturur. Bu işlem, Paket Kaynağı Eşlemesi'nin paketleri kaynaklara eşlemek için kullandığı şemayla çakışıyor ve deponuzdaki dosyadaki NuGet.config Paket Kaynağı Eşleme yapılandırmasını bozuyor. Bu çakışmayı geçici olarak çözmek için NuGet Kimlik Doğrulaması görevini kullanarak kimlik doğrulaması yapabilir ve daha sonra özel komutu kullanarak değişiklik yapmadan NuGet.config istenen dotnet komutunu çağırabilirsiniz.

# Authenticate Azure DevOps NuGet feed
- task: NuGetAuthenticate@1
  displayName: 'Authenticate Azure DevOps NuGet feed'

# Restore project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'restore'

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'build'
    arguments: '--no-restore'

Bir NuGet.config neden iade etmeliyim?

NuGet.config Kaynak denetiminin denetlenmesi, projenizi oluşturmak için gereken önemli bir bilgi parçasının (paketlerinin konumu) kodunuzu kullanıma alan her geliştiricinin kullanımına sunulmasını sağlar.

Ancak, bir geliştirici ekibinin çok çeşitli projelerde çalıştığı durumlarda, her geliştiricinin makinesinde genele NuGet.config bir Azure Artifacts akışı eklemek de mümkündür. Böyle durumlarda, NuGet görevindeki seçeneğinin kullanılması Feeds I select here bu yapılandırmayı çoğaltır.

Sorun giderme

Entity Framework kullanan proje Barındırılan Aracılar üzerinde çalışmayı durdurdu

.NET Core'da Entity Framework (EF) yerleşik yoktur. Yürütmeye başlamadan önce EF'yi yüklemeniz veya gerekli .NET Core SDK sürümüyle projeye eklemeniz global.json gerekir. Bu, EF projesi oluşturmak için doğru SDK'nın kullanılmasını sağlar. Makinede gerekli sürüm yoksa, gerekli sürümü yüklemek için görevi işlem hattınıza ekleyin UseDotNetV2 . Daha fazla bilgi için bkz. Entity Framework Core çalışma zamanını alma.

Örnekler

Derleme örnekleri

Proje oluşturma

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'

Birden Çok Proje Oluşturma

# Build multiple projects
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    projects: |
      src/proj1/proj1.csproj 
      src/proj2/proj2.csproj 
      src/other/other.sln    # Pass a solution instead of a csproj.

Gönderme örnekleri

NuGet paketlerini iç akışa gönderme

# Push non test NuGet packages from a build to internal organization Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    searchPatternPush: '$(Build.ArtifactStagingDirectory)/*.nupkg;!$(Build.ArtifactStagingDirectory)/*.Tests.nupkg'
    feedPublish: 'FabrikamFeed'

NuGet paketlerini dış akışa gönderme

# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    nugetFeedType: 'external'
    externalEndPoint: 'MyNuGetServiceConnection'

Paket örnekleri

NuGetPackage'ı belirli bir çıkış dizinine paketleme

# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'

Sembol Paketi Paketleme

# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    includesymbols: true

Yayımlama örnekleri

Projeleri belirtilen klasöre yayımlama

# Publish projects to specified folder.
- task: DotNetCoreCLI@2
  displayName: 'dotnet publish'
  inputs:
    command: 'publish'
    publishWebProjects: false
    projects: '**/*.csproj'
    arguments: '-o $(Build.ArtifactStagingDirectory)/Output'
    zipAfterPublish: true
    modifyOutputPath: true

Geri yükleme örnekleri

#Restore packages with the .NET Core CLI task
- task: DotNetCoreCLI@2
  displayName: 'dotnet restore'
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    feedRestore: 'projectName/feedName'
    projects: '**/*.csproj'
    includeNuGetOrg: true

Test örnekleri

Deponuzda testleri çalıştırma

# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
  inputs:
    command: 'test'

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Aracı
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.144.0 veya üzeri
Görev kategorisi Yapı
Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Aracı
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 Oluşturma
Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Aracı
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.0.0 veya üzeri
Görev kategorisi Yapı