DotNetCoreCLI@2 - مهمة .NET Core v2
إنشاء تطبيق dotnet أو اختباره أو حزمه أو نشره، أو تشغيل أمر dotnet مخصص.
إنشاء تطبيق dotnet أو اختباره أو حزمه أو نشره، أو تشغيل أمر dotnet مخصص. بالنسبة لأوامر الحزمة، يدعم NuGet.org والموجزات المصادق عليها مثل إدارة الحزمة وMyGet.
هام
مهمة NuGet Authenticate هي الطريقة الموصى بها الجديدة للمصادقة باستخدام Azure Artifacts ومستودعات NuGet الأخرى. restore
لم تعد أوامر و push
لمهمة .NET Core CLI هذه تأخذ ميزات جديدة ويتم معالجة الأخطاء الهامة فقط. راجع الملاحظات للحصول على التفاصيل.
بناء الجملة
# .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.
الإدخالات
command
- الامر
string
. مطلوب القيم المسموح بها: build
، (دفع nuget)، pack
، publish
، run
restore
، ، test
. custom
push
القيمة الافتراضية: build
.
الأمر dotnet لتشغيله. حدد custom
لإضافة وسيطات أو استخدام أمر غير مدرج هنا.
هام
مهمة NuGet Authenticate هي الطريقة الموصى بها الجديدة للمصادقة باستخدام Azure Artifacts ومستودعات NuGet الأخرى. restore
لم تعد أوامر و push
لمهمة .NET Core CLI هذه تأخذ ميزات جديدة ويتم معالجة الأخطاء الهامة فقط. راجع الملاحظات للحصول على التفاصيل.
publishWebProjects
- نشر مشاريع الويب
boolean
. اختياري. استخدم عندما command = publish
. القيمة الافتراضية: true
.
إذا تم تعيين هذا الإدخال إلى true
، projects
يتم تخطي قيمة الخاصية، وتحاول المهمة العثور على مشاريع الويب في المستودع وتشغيل أمر النشر عليها. يتم تحديد مشاريع الويب من خلال وجود web.config
ملف أو wwwroot
مجلد في الدليل. في حالة عدم وجود web.config
ملف أو wwwroot
مجلد، يتم تحديد المشاريع التي تستخدم SDK ويب، مثل Microsoft.NET.Sdk.Web
، .
publishWebProjects
- نشر مشاريع ويب
boolean
. اختياري. استخدم عندما command = publish
. القيمة الافتراضية: true
.
إذا تم تعيين هذا الإدخال إلى true
، projects
يتم تخطي قيمة الخاصية، وتحاول المهمة العثور على مشاريع الويب في المستودع وتشغيل أمر النشر عليها. يتم تحديد مشاريع الويب من خلال وجود web.config
ملف أو wwwroot
مجلد في الدليل. في حالة عدم وجود web.config
ملف أو wwwroot
مجلد، يتم تحديد المشاريع التي تستخدم SDK ويب، مثل Microsoft.NET.Sdk.Web
، .
projects
- المسار إلى المشروع (المشاريع) أو الحل (الحلول)
string
. اختياري. استخدم عندما command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false
.
المسار إلى .csproj
أو .sln
الملف (الملفات) المراد استخدامها. يمكنك استخدام أحرف البدل (على سبيل المثال **/*.csproj
لجميع .csproj
الملفات في جميع المجلدات الفرعية). لمزيد من المعلومات، راجع مرجع أنماط مطابقة الملف.
هذا المسار مرتبط بجذر المستودع بغض النظر عن workingDirectory
الإعداد.
projects
- المسار إلى المشروع (المشاريع)
string
. اختياري. استخدم عندما command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false
.
المسار إلى الملف (الملفات .csproj
) المراد استخدامه. يمكنك استخدام أحرف البدل (على سبيل المثال **/*.csproj
لجميع .csproj
الملفات في جميع المجلدات الفرعية). لمزيد من المعلومات، راجع مرجع أنماط مطابقة الملف.
هذا المسار مرتبط بجذر المستودع بغض النظر عن workingDirectory
الإعداد.
custom
- أمر مخصص
string
. مطلوب عند command = custom
.
الأمر الذي يجب تمريره إلى dotnet.exe
للتنفيذ. للحصول على قائمة كاملة بالأوامر المتوفرة، راجع وثائق dotnet CLI.
arguments
- الحجج
string
. اختياري. استخدم عندما command = build || command = publish || command = run || command = test || command = custom
.
يحدد الوسيطات للأمر المحدد. على سبيل المثال، تكوين البناء ومجلد الإخراج ووقت التشغيل. تعتمد الوسيطات على الأمر المحدد.
يقبل هذا الإدخال حاليا وسيطات فقط ل build
وpublish
run
test
.custom
إذا كنت ترغب في إضافة وسيطات لأمر غير مدرج، فاستخدم custom
.
restoreArguments
- الحجج
string
. اختياري. استخدم عندما command = restore
.
يكتب الوسيطات الإضافية التي سيتم تمريرها إلى restore
الأمر .
publishTestResults
- نشر نتائج الاختبار وتغطية التعليمات البرمجية
boolean
. اختياري. استخدم عندما command = test
. القيمة الافتراضية: true
.
سيؤدي تمكين هذا الخيار إلى test results
إنشاء ملف TRX في $(Agent.TempDirectory)
، وسيتم نشر النتائج على الخادم.
يقوم هذا الخيار بإلحاق وسيطات --logger trx --results-directory $(Agent.TempDirectory)
سطر الأوامر.
يمكن جمع تغطية التعليمات البرمجية عن طريق إضافة --collect "Code coverage"
الخيار إلى وسيطات سطر الأوامر.
testRunTitle
- عنوان تشغيل الاختبار
string
. اختياري. استخدم عندما command = test
.
يوفر اسما لتشغيل الاختبار.
zipAfterPublish
- مشاريع Zip المنشورة
boolean
. اختياري. استخدم عندما command = publish
. القيمة الافتراضية: true
.
إذا تم تعيين هذا الإدخال إلى true
، فسيتم ضغط المجلدات التي تم إنشاؤها بواسطة أمر النشر وحذفها.
zipAfterPublish
- Zip Published Projects
boolean
. اختياري. استخدم عندما command = publish
. القيمة الافتراضية: true
.
إذا تم تعيين هذا الإدخال إلى true
، فسيتم ضغط المجلد الذي تم إنشاؤه بواسطة أمر النشر وحذفه.
modifyOutputPath
- إضافة اسم مجلد المشروع لنشر المسار
boolean
. اختياري. استخدم عندما command = publish
. القيمة الافتراضية: true
.
إذا تم تعيين هذا الإدخال إلى true
، فسيكون للمجلدات التي تم إنشاؤها بواسطة أمر النشر اسم ملف المشروع مسبوقا بأسماء المجلدات الخاصة بها عند تحديد مسار الإخراج بشكل صريح في الوسيطات. هذا مفيد إذا كنت تريد نشر مشاريع متعددة إلى نفس المجلد.
modifyOutputPath
- إضافة اسم المشروع لنشر المسار
boolean
. اختياري. استخدم عندما command = publish
. القيمة الافتراضية: true
.
إذا تم تعيين هذا الإدخال إلى true
، فسيكون للمجلدات التي تم إنشاؤها بواسطة أمر النشر اسم ملف المشروع مسبوقا بأسماء المجلدات الخاصة بها عند تحديد مسار الإخراج بشكل صريح في الوسيطات. هذا مفيد إذا كنت تريد نشر مشاريع متعددة إلى نفس المجلد.
feedsToUse
- موجزات لاستخدامها
الاسم المستعار للإدخل: selectOrConfig
. string
. مطلوب عند command = restore
. القيم المسموح بها: select
(الموجزات) التي أختارها هنا)، config
(الموجزات في NuGet.config). القيمة الافتراضية: select
.
يمكنك إما تحديد موجز من Azure Artifacts و/أو NuGet.org
هنا، أو يمكنك تثبيت nuget.config
ملف بمستودع التعليمات البرمجية المصدر وتعيين مساره باستخدام nugetConfigPath
الإدخال.
vstsFeed
- استخدام الحزم من موجز Azure Artifacts هذا
الاسم المستعار للإدخل: feedRestore
. string
. اختياري. استخدم عندما selectOrConfig = select && command = restore
.
يتضمن الموجز المحدد في الذي تم NuGet.config
إنشاؤه. يجب أن يكون لديك Package Management مثبتة ومرخصة لتحديد موجز هنا. projectName
/feedName
تستخدم للموجزات ذات نطاق المشروع. يتم استخدام فقط FeedName
للموجزات ذات نطاق المؤسسة. ملاحظة: هذا غير معتمد لأمر الاختبار.
vstsFeed
- استخدام الحزم من موجز Azure Artifacts/TFS هذا
الاسم المستعار للإدخل: feedRestore
. string
. اختياري. استخدم عندما selectOrConfig = select && command = restore
.
يتضمن الموجز المحدد في الذي تم NuGet.config
إنشاؤه. يجب أن يكون لديك Package Management مثبتة ومرخصة لتحديد موجز هنا. projectName
/feedName
تستخدم للموجزات ذات نطاق المشروع. يتم استخدام فقط FeedName
للموجزات ذات نطاق المؤسسة. ملاحظة: هذا غير معتمد لأمر الاختبار.
includeNuGetOrg
- استخدام الحزم من NuGet.org
boolean
. اختياري. استخدم عندما selectOrConfig = select && command = restore
. القيمة الافتراضية: true
.
يتضمن NuGet.org
في الذي تم NuGet.config
إنشاؤه.
nugetConfigPath
- المسار إلى NuGet.config
string
. اختياري. استخدم عندما selectOrConfig = config && command = restore
.
في NuGet.config
المستودع الخاص بك الذي يحدد الموجزات التي يمكن استعادة الحزم منها.
externalFeedCredentials
- بيانات الاعتماد للموجزات خارج هذه المؤسسة/المجموعة
الاسم المستعار للإدخل: externalEndpoints
. string
. اختياري. استخدم عندما selectOrConfig = config && command = restore
.
بيانات الاعتماد التي يجب استخدامها للسجلات الخارجية الموجودة في المحدد NuGet.config
. بالنسبة للموجزات في هذه المؤسسة/المجموعة، اترك هذا الإدخال فارغا؛ يتم استخدام بيانات اعتماد البنية تلقائيا.
noCache
- تعطيل ذاكرة التخزين المؤقت المحلية
boolean
. اختياري. استخدم عندما command = restore
. القيمة الافتراضية: false
.
يمنع NuGet من استخدام الحزم من ذاكرة التخزين المؤقت للجهاز المحلي.
restoreDirectory
- دليل الوجهة
الاسم المستعار للإدخل: packagesDirectory
. string
. اختياري. استخدم عندما command = restore
.
يحدد المجلد الذي تم تثبيت الحزم فيه. إذا لم يتم تحديد مجلد، تتم استعادة الحزم في ذاكرة التخزين المؤقت الافتراضية لحزمة NuGet.
verbosityRestore
- الاسهاب
string
. اختياري. استخدم عندما command = restore
. القيم المسموح بها: -
، Quiet
، Minimal
، Normal
، Detailed
. Diagnostic
القيمة الافتراضية: Detailed
.
يحدد مقدار التفاصيل المعروضة في إخراج restore
الأمر.
packagesToPush
- المسار إلى حزمة (حزم) NuGet للنشر
الاسم المستعار للإدخل: searchPatternPush
. string
. مطلوب عند command = push
. القيمة الافتراضية: $(Build.ArtifactStagingDirectory)/*.nupkg
.
النمط المراد مطابقته أو المسار إلى nupkg
الملفات التي سيتم تحميلها. يمكن فصل أنماط متعددة بواسطة فاصلة منقوطة، ويمكنك جعل النمط سالبا عن طريق بادئته ب !
. مثال:**/*.nupkg;!**/*.Tests.nupkg
.
nuGetFeedType
- موقع موجز الهدف
string
. مطلوب عند command = push
. القيم المسموح بها: internal
(هذه المؤسسة/المجموعة)، external
(خادم NuGet الخارجي (بما في ذلك المؤسسات/المجموعات الأخرى)). القيمة الافتراضية: internal
.
يحدد ما إذا كان الموجز الهدف داخليا أو خارجيا.
publishVstsFeed
- موجز الهدف
الاسم المستعار للإدخل: feedPublish
. string
. مطلوب عند command = push && nuGetFeedType = internal
.
تحديد موجز مستضاف في هذه المؤسسة. يجب أن يكون لديك Package Management مثبتة ومرخصة لتحديد موجز هنا.
publishPackageMetadata
- نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية
boolean
. اختياري. استخدم عندما command = push && nuGetFeedType = internal && command = push
. القيمة الافتراضية: true
.
يربط بيانات تعريف البنية/الإصدار هذه (تشغيل #، معلومات التعليمات البرمجية المصدر) بالحزمة.
publishFeedCredentials
- خادم NuGet
الاسم المستعار للإدخل: externalEndpoint
. string
. مطلوب عند command = push && nuGetFeedType = external
.
اتصال خدمة NuGet الذي يحتوي على بيانات اعتماد خادم NuGet الخارجي.
packagesToPack
- المسار إلى ملف (ملفات) csproj أو nuspec للحزم
الاسم المستعار للإدخل: searchPatternPack
. string
. مطلوب عند command = pack
. القيمة الافتراضية: **/*.csproj
.
النمط للبحث عن .csproj
أو .nuspec
الملفات المراد حزمها.
يمكنك فصل أنماط متعددة باستخدام فاصلة منقوطة، ويمكنك جعل النمط سالبا عن طريق بادئه ب !
. مثال:**/*.csproj;!**/*.Tests.csproj
.
configuration
- التكوين إلى الحزمة
الاسم المستعار للإدخل: configurationToPack
. string
. اختياري. استخدم عندما command = pack
. القيمة الافتراضية: $(BuildConfiguration)
.
عند استخدام .csproj
ملف، يحدد هذا الإدخال التكوين إلى حزمة.
packDirectory
- مجلد الحزمة
الاسم المستعار للإدخل: outputDir
. string
. اختياري. استخدم عندما command = pack
. القيمة الافتراضية: $(Build.ArtifactStagingDirectory)
.
المجلد الذي سيتم إنشاء الحزم فيه. إذا كان هذا المجلد فارغا، فسيتم إنشاء الحزم جنبا إلى جنب مع csproj
الملف.
nobuild
- عدم الإنشاء
boolean
. اختياري. استخدم عندما command = pack
. القيمة الافتراضية: false
.
يحدد أن المهمة لن تنشئ المشروع قبل التعبئة. تتوافق هذه المهمة مع --no-build
معلمة build
الأمر .
includesymbols
- تضمين رموز
boolean
. اختياري. استخدم عندما command = pack
. القيمة الافتراضية: false
.
إنشاء حزم NuGet للرمز. تتوافق هذه المهمة مع معلمة --include-symbols
سطر الأوامر.
includesource
- تضمين المصدر
boolean
. اختياري. استخدم عندما command = pack
. القيمة الافتراضية: false
.
يتضمن التعليمات البرمجية المصدر في الحزمة. تتوافق هذه المهمة مع معلمة --include-source
سطر الأوامر.
versioningScheme
- تعيين الإصدار التلقائي للحزمة
string
. مطلوب عند command = pack
. القيم المسموح بها: off
، byPrereleaseNumber
(استخدم التاريخ والوقت)، byEnvVar
(استخدام متغير بيئة)، byBuildNumber
(استخدم رقم البناء). القيمة الافتراضية: off
.
لا يمكن استخدام هذه المهمة مع المشاريع المشار إليها المضمنة. إذا اخترت Use the date and time
، فسينشئ هذا إصدارا متوافقا مع SemVer منسقا حيث X.Y.Z-ci-datetime
تختار X
و Y
و Z
.
إذا اخترت Use an environment variable
، يجب تحديد متغير بيئة والتأكد من أنه يحتوي على رقم الإصدار الذي تريد استخدامه.
إذا اخترت Use the build number
، فسيستخدم هذا رقم الإصدار لإصدار الحزمة الخاصة بك. ملاحظه: ضمن Options
، قم بتعيين تنسيق رقم البناء إلى $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)
.
versionEnvVar
- متغير البيئة
string
. مطلوب عند versioningScheme = byEnvVar && command = pack
.
يحدد اسم المتغير بدون $
أو $env
أو .%
majorVersion
- الرئيسيه
الاسم المستعار للإدخل: requestedMajorVersion
. string
. مطلوب عند versioningScheme = byPrereleaseNumber && command = pack
. القيمة الافتراضية: 1
.
X
في الإصدار X.Y.Z.
minorVersion
- طفيفه
الاسم المستعار للإدخل: requestedMinorVersion
. string
. مطلوب عند versioningScheme = byPrereleaseNumber && command = pack
. القيمة الافتراضية: 0
.
Y
في الإصدار X.Y.Z.
patchVersion
- التصحيح
الاسم المستعار للإدخل: requestedPatchVersion
. string
. مطلوب عند versioningScheme = byPrereleaseNumber && command = pack
. القيمة الافتراضية: 0
.
Z
في الإصدار X.Y.Z.
buildProperties
- خصائص بناء إضافية
string
. اختياري. استخدم عندما command = pack
.
يحدد قائمة أزواج token = value
، مفصولة بفواصل منقوطة، حيث سيتم استبدال كل تكرار $token$
في .nuspec
الملف بالقيمة المحددة. يمكن أن تكون القيم سلاسل بعلامات اقتباس.
verbosityPack
- الاسهاب
string
. اختياري. استخدم عندما command = pack
. القيم المسموح بها: -
، Quiet
، Minimal
، Normal
، Detailed
، . Diagnostic
القيمة الافتراضية: Detailed
.
يحدد مقدار التفاصيل المعروضة في إخراج pack
الأمر .
workingDirectory
- دليل العمل
string
. اختياري. استخدم عندما command != restore && command != push && command != pack && command != pack && command != push && command != restore
.
دليل العمل الحالي حيث يتم تشغيل البرنامج النصي. Empty
هو جذر المستودع (البناء) أو البيانات الاصطناعية (الإصدار)، وهو $(System.DefaultWorkingDirectory)
.
workingDirectory
- دليل العمل
string
. اختياري. استخدم عندما command != pack && command != push && command != restore
.
دليل العمل الحالي حيث يتم تشغيل البرنامج النصي. Empty
هو جذر المستودع (البناء) أو البيانات الاصطناعية (الإصدار)، وهو $(System.DefaultWorkingDirectory)
.
خيارات التحكم بالمهمة
تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.
متغيرات الإخراج
لا شيء
الملاحظات
هام
مهمة NuGet Authenticate هي الطريقة الموصى بها الجديدة للمصادقة باستخدام Azure Artifacts ومستودعات NuGet الأخرى. restore
لم تعد أوامر و push
لمهمة .NET Core CLI هذه تأخذ ميزات جديدة ويتم معالجة الأخطاء الهامة فقط.
لماذا تفشل خطوة الإنشاء أو النشر أو الاختبار لاستعادة الحزم؟
تتضمن معظم dotnet
الأوامر، بما في ذلك build
و publish
و test
خطوة ضمنية restore
. سيفشل هذا في مقابل الموجزات المصادق عليها، حتى إذا قمت بتشغيل ناجح dotnet restore
في خطوة سابقة، لأن الخطوة السابقة ستكون قد نظفت بيانات الاعتماد التي استخدمتها.
لإصلاح هذه المشكلة، أضف العلامة --no-restore
Arguments
إلى مربع النص.
بالإضافة إلى ذلك، test
لا يتعرف الأمر على feedRestore
الوسيطتين أو vstsFeed
، ولن يتم تضمين الموجزات المحددة بهذه الطريقة في الملف الذي تم NuGet.config
إنشاؤه عند تشغيل الخطوة الضمنية restore
. يوصى باستخدام خطوة صريحة dotnet restore
لاستعادة الحزم. restore
يحترم الأمر الوسيطتين feedRestore
وvstsFeed
.
لماذا أحصل على تحذيرات NU1507 مع تعيين مصدر الحزمة على الرغم من أنه عند الإنشاء على جهازي لا يحتوي على تحذيرات؟
تنشئ الأوامر المختلفة التي تقوم باستعادة NuGet أو الوصول إلى موجز NuGet ملفا مؤقتا NuGet.config
خاصا يضيف مصادقة NuGet لموجزات NuGet الخاصة ب azure artifacts. تتعارض طريقة القيام بذلك مع المخطط الذي يستخدمه تعيين مصدر الحزم لتعيين الحزم إلى المصادر وكسر تكوين Package Source Mappin في NuGet.config
الملف في المستودع الخاص بك.
لحل هذا التعارض، يمكنك استخدام مهمة NuGet Authenticate للمصادقة وبعد ذلك الأمر المخصص لاستدعاء أمر dotnet المطلوب دون NuGet.config
التعديل.
# 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'
لماذا يجب أن أتحقق من NuGet.config؟
NuGet.config
يضمن التحقق من التحكم بالمصادر توفر جزء رئيسي من المعلومات اللازمة لإنشاء مشروعك - موقع حزمه - لكل مطور يتحقق من التعليمات البرمجية الخاصة بك.
ومع ذلك، بالنسبة للحالات التي يعمل فيها فريق من المطورين على مجموعة كبيرة من المشاريع، من الممكن أيضا إضافة موجز Azure Artifacts إلى العمومي NuGet.config
على جهاز كل مطور. في هذه الحالات، يؤدي استخدام Feeds I select here
الخيار في مهمة NuGet إلى نسخ هذا التكوين نسخا متماثلا.
استكشاف الأخطاء وإصلاحها
توقف Project الذي يستخدم Entity Framework عن العمل على Hosted Agents
لا يحتوي .NET Core على Entity Framework (EF) مضمن. سيتعين عليك إما تثبيت EF قبل بدء التنفيذ أو الإضافة global.json
إلى المشروع باستخدام إصدار .NET Core SDK المطلوب. سيضمن ذلك استخدام SDK الصحيح لإنشاء مشروع EF. إذا لم يكن الإصدار المطلوب موجودا على الجهاز، أضف UseDotNetV2
المهمة إلى البنية الأساسية لبرنامج ربط العمليات التجارية لتثبيت الإصدار المطلوب. لمزيد من المعلومات، راجع الحصول على وقت تشغيل Entity Framework Core.
أمثلة
إنشاء أمثلة
إنشاء مشروع
# Build project
- task: DotNetCoreCLI@2
inputs:
command: 'build'
إنشاء مشاريع متعددة
# 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.
أمثلة الدفع
دفع حزم NuGet إلى الموجز الداخلي
# 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 إلى موجز خارجي
# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
inputs:
command: 'push'
nugetFeedType: 'external'
externalEndPoint: 'MyNuGetServiceConnection'
أمثلة الحزمة
حزم NuGetPackage إلى دليل إخراج معين
# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
inputs:
command: 'pack'
outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'
حزم حزمة رمز
# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
inputs:
command: 'pack'
includesymbols: true
نشر الأمثلة
نشر المشاريع إلى مجلد محدد
# 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
استعادة الأمثلة
#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
أمثلة الاختبار
تشغيل الاختبارات في المستودع الخاص بك
# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
inputs:
command: 'test'
المتطلبات
المتطلبات | الوصف |
---|---|
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية | YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي |
يعمل على | عامل |
المطالب | بلا |
القدرات | لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة. |
قيود الأوامر | أي |
متغيرات Settable | أي |
إصدار الوكيل | 2.144.0 أو أحدث |
فئة المهمة | البنية |
المتطلبات | الوصف |
---|---|
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية | YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي |
يعمل على | عامل |
المطالب | بلا |
القدرات | لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة. |
قيود الأوامر | أي |
متغيرات Settable | أي |
إصدار الوكيل | 2.115.0 أو أحدث |
فئة المهمة | البنية |
المتطلبات | الوصف |
---|---|
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية | YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي |
يعمل على | عامل |
المطالب | بلا |
القدرات | لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة. |
قيود الأوامر | أي |
متغيرات Settable | أي |
إصدار الوكيل | 2.0.0 أو أكبر |
فئة المهمة | البنية |