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، runrestore، ، test. custompush القيمة الافتراضية: 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وpublishruntest.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-restoreArguments إلى مربع النص.

بالإضافة إلى ذلك، 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 أو أكبر
فئة المهمة البنية