NuGetCommand@2 - مهمة NuGet v2

استخدم هذه المهمة لاستعادة حزم NuGet أو حزمها أو دفعها، أو تشغيل أمر NuGet. تدعم هذه المهمة NuGet.org والموجزات المصادق عليها مثل Azure Artifacts وMyGet. تستخدم هذه المهمة أيضا NuGet.exe وتعمل مع تطبيقات .NET Framework. بالنسبة لتطبيقات .NET Core و.NET Standard، استخدم مهمة .NET Core.

بناء الجملة

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

الإدخالات

command - الامر
string. مطلوب القيم المسموح بها: restore، pack، push، custom. القيمة الافتراضية: restore.

يحدد الأمر NuGet لتشغيله. custom استخدم القيمة لإضافة وسيطات أو لاستخدام أمر مختلف.


restoreSolution - المسار إلى الحل أو packages.config أو project.json
الاسم المستعار للإدخل: solution. string. مطلوب عند command = restore. القيمة الافتراضية: **/*.sln.

يحدد المسار إلى الحل أو packages.configأو project.json الملف الذي يشير إلى الحزم المراد استعادتها.


feedsToUse - موجزات لاستخدامها
الاسم المستعار للإدخل: selectOrConfig. string. مطلوب عند command = restore. القيم المسموح بها: select (الموجزات) التي أختارها هنا)، config (الموجزات في NuGet.config). القيمة الافتراضية: select.

يحدد موجزا من Azure Artifacts و/أو NuGet.org للمهمة لاستخدامها مع select القيمة. بدلا من ذلك، يمكنك تثبيت NuGet.config ملف إلى مستودع التعليمات البرمجية المصدر وتعيين مساره كقيمة config باستخدام القيمة.


vstsFeed - استخدام الحزم من موجز Azure Artifacts/TFS هذا
الاسم المستعار للإدخل: feedRestore. string. ‏‏اختياري. استخدم عندما selectOrConfig = select && command = restore.

يحدد الموجز المحدد في الذي تم NuGet.configإنشاؤه . يجب أن يكون لديك إدارة الحزم مثبتة ومرخصة لتحديد موجز هنا.


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. هذا هو اسم اتصال خدمة NuGet. بالنسبة إلى الموجزات في هذه المؤسسة أو المجموعة، اترك هذا فارغا؛ يتم استخدام بيانات اعتماد البنية تلقائيا.


externalFeedCredentials - بيانات الاعتماد للموجزات خارج هذا الحساب/المجموعة
الاسم المستعار للإدخل: externalEndpoints. string. ‏‏اختياري. استخدم عندما selectOrConfig = config && command = restore.

يحدد بيانات الاعتماد التي يجب استخدامها للسجلات الخارجية الموجودة في المحدد NuGet.config. هذا هو اسم اتصال خدمة NuGet. بالنسبة للموجزات في هذا الحساب أو المجموعة، اترك هذا فارغا؛ يتم استخدام بيانات اعتماد البنية تلقائيا.


noCache - تعطيل ذاكرة التخزين المؤقت المحلية
boolean. ‏‏اختياري. استخدم عندما command = restore. القيمة الافتراضية: false.

يمنع NuGet من استخدام الحزم من ذاكرة التخزين المؤقت للجهاز المحلي عند تعيينه إلى true.


disableParallelProcessing - تعطيل المعالجة المتوازية
boolean. ‏‏اختياري. استخدم عندما command = restore. القيمة الافتراضية: false.

يمنع NuGet من تثبيت حزم متعددة في عمليات متوازية عند تعيينها إلى true.


restoreDirectory - دليل الوجهة
الاسم المستعار للإدخل: packagesDirectory. string. ‏‏اختياري. استخدم عندما command = restore.

يحدد المجلد الذي يتم تثبيت الحزم فيه. إذا لم يتم تحديد أي مجلد، تتم استعادة الحزم إلى packages/ مجلد جنبا إلى جنب مع الحل المحدد، أو packages.configproject.json.


verbosityRestore - الاسهاب
string. ‏‏اختياري. استخدم عندما command = restore. القيم المسموح بها: Quiet، ، NormalDetailed. القيمة الافتراضية: Detailed.

يحدد مقدار التفاصيل المعروضة في الإخراج.


packagesToPush - المسار إلى حزمة (حزم) NuGet للنشر
الاسم المستعار للإدخل: searchPatternPush. string. مطلوب عند command = push. القيمة الافتراضية: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

يحدد النمط المراد مطابقته أو المسار إلى nupkg الملفات التي سيتم تحميلها. يمكن فصل أنماط متعددة بفواصل منقوطة.


nuGetFeedType - موقع موجز الهدف
string. مطلوب عند command = push. القيم المسموح بها: internal (هذه المؤسسة/المجموعة)، external (خادم NuGet الخارجي (بما في ذلك الحسابات/المجموعات الأخرى)). القيمة الافتراضية: internal.

يحدد ما إذا كان الموجز الهدف موجزا/مجموعة داخلية أو خادم NuGet خارجيا.


nuGetFeedType - موقع موجز الهدف
string. مطلوب عند command = push. القيم المسموح بها: internal (هذا الحساب/المجموعة)، external (خادم NuGet الخارجي (بما في ذلك الحسابات/المجموعات الأخرى)). القيمة الافتراضية: internal.

يحدد ما إذا كان الموجز الهدف موجزا/مجموعة داخلية أو خادم NuGet خارجيا.


publishVstsFeed - موجز الهدف
الاسم المستعار للإدخل: feedPublish. string. مطلوب عند command = push && nuGetFeedType = internal.

يحدد موجزا مستضافا في هذا الحساب. يجب أن يكون لديك Azure Artifacts مثبتة ومرخصة لتحديد موجز هنا.


publishPackageMetadata - نشر بيانات تعريف البنية الأساسية لبرنامج ربط العمليات التجارية
boolean. ‏‏اختياري. استخدم عندما command = push && nuGetFeedType = internal && command = push. القيمة الافتراضية: true.

تغيير رقم إصدار المجموعة الفرعية من الحزم التي تم تغييرها ضمن مجموعة من الحزم المنشورة باستمرار.


allowPackageConflicts - السماح بتخطي التكرارات
boolean. ‏‏اختياري. استخدم عندما command = push && nuGetFeedType = internal. القيمة الافتراضية: false.

يبلغ عن نجاح المهمة حتى إذا تم رفض بعض الحزم الخاصة بك مع 409 أخطاء تعارض.

يتوفر هذا الخيار حاليا فقط على Azure Pipelines ووكلاء Windows. إذا NuGet.exe واجهت تعارضا، فستفشل المهمة. لن يعمل هذا الخيار وسيفشل النشر إذا كنت داخل بيئة وكيل.


publishFeedCredentials - خادم NuGet
الاسم المستعار للإدخل: externalEndpoint. string. مطلوب عند command = push && nuGetFeedType = external.

يحدد اتصال خدمة NuGet الذي يحتوي على بيانات اعتماد خادم NuGet الخارجي.


verbosityPush - الاسهاب
string. ‏‏اختياري. استخدم عندما command = push. القيم المسموح بها: Quiet، ، Normal. Detailed القيمة الافتراضية: Detailed.

يحدد مقدار التفاصيل المعروضة في الإخراج.


packagesToPack - المسار إلى ملف (ملفات) csproj أو nuspec للحزم
الاسم المستعار للإدخل: searchPatternPack. string. مطلوب عند command = pack. القيمة الافتراضية: **/*.csproj.

يحدد النمط الذي تستخدمه المهمة للبحث عن دلائل csproj لحزمها.

يمكنك فصل أنماط متعددة باستخدام فاصلة منقوطة، ويمكنك جعل النمط سالبا عن طريق بادئه ب !. مثال:**\*.csproj;!**\*.Tests.csproj.


configuration - التكوين للحزمة
الاسم المستعار للإدخل: configurationToPack. string. ‏‏اختياري. استخدم عندما command = pack. القيمة الافتراضية: $(BuildConfiguration).

يحدد التكوين المراد حزمه عند استخدام ملف csproj.


packDestination - مجلد الحزمة
الاسم المستعار للإدخل: outputDir. string. ‏‏اختياري. استخدم عندما command = pack. القيمة الافتراضية: $(Build.ArtifactStagingDirectory).

يحدد المجلد الذي تنشئ فيه المهمة الحزم. إذا كانت القيمة فارغة، تنشئ المهمة حزما في الجذر المصدر.


versioningScheme - تعيين الإصدار التلقائي للحزمة
string. مطلوب عند command = pack. القيم المسموح بها: off، byPrereleaseNumber (استخدم التاريخ والوقت)، byEnvVar (استخدام متغير بيئة)، byBuildNumber (استخدم رقم البناء). القيمة الافتراضية: off.

تطبيق تعيين إصدار الحزمة التلقائي استنادا إلى القيمة المحددة. لا يمكن استخدام هذه السلسلة مع includeReferencedProjects. القيم المسموح بها هي:

  • byPrereleaseNumber - استخدام التاريخ والوقت: ستنشئ المهمة إصدارا متوافقا مع SemVer منسقا ك X.Y.Z-ci-datetime، حيث تحدد قيم X وY وZ.
  • byEnvVar- استخدام متغير بيئة: ستستخدم المهمة متغير بيئة تحدده وتحتوي على رقم الإصدار الذي تريد استخدامه.
  • byBuildNumber - استخدام رقم البناء: ستستخدم المهمة رقم البناء لإصدار الحزمة.

ملاحظة

ضمن عام، قم بتعيين تنسيق البنية ليكون $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


includeReferencedProjects - تضمين المشاريع المشار إليها
boolean. ‏‏اختياري. استخدم عندما versioningScheme = off && command = pack. القيمة الافتراضية: false.

يتضمن المشاريع المشار إليها إما كتبعيات أو كجزء من الحزمة. لا يمكن استخدامه مع تعيين إصدار الحزمة التلقائي. إذا كان المشروع المشار إليه يحتوي على ملف مطابق nuspec له نفس اسم المشروع، تتم إضافة هذا المشروع المشار إليه كتبعية. وإلا، تتم إضافة المشروع المشار إليه كجزء من الحزمة. تعرف على المزيد حول استخدام أمر الحزمة ل NuGet CLI لإنشاء حزم NuGet.


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.


packTimezone - المنطقة الزمنية
string. ‏‏اختياري. استخدم عندما versioningScheme = byPrereleaseNumber && command = pack. القيم المسموح بها: utc، local (التوقيت المحلي للعامل). القيمة الافتراضية: utc.

يحدد المنطقة الزمنية المطلوبة المستخدمة لإنتاج إصدار الحزمة. يوصى بتحديد utc إذا كنت تستخدم عوامل البناء المستضافة، حيث قد يختلف تاريخها ووقتها.


includeSymbols - إنشاء حزمة رموز
boolean. ‏‏اختياري. استخدم عندما command = pack. القيمة الافتراضية: false.

يحدد أن الحزمة تحتوي على مصادر ورموز. عند استخدامه مع .nuspec ملف، يؤدي هذا إلى إنشاء ملف حزمة NuGet عادي وحزمة الرموز المقابلة.


toolPackage - حزمة الأدوات
boolean. ‏‏اختياري. استخدم عندما command = pack. القيمة الافتراضية: false.

تحديد ما إذا كان يجب أن تكون ملفات الإخراج للمشروع في مجلد الأداة.


buildProperties - خصائص بناء إضافية
string. ‏‏اختياري. استخدم عندما command = pack.

يحدد قائمة بأزواج الرمز المميز=القيمة، مفصولة بفواصل منقوطة، حيث سيتم استبدال كل تكرار في $token$.nuspec الملف بالقيمة المحددة. يمكن أن تكون القيم سلاسل بعلامات اقتباس.


basePath - المسار الأساسي
string. ‏‏اختياري. استخدم عندما command = pack.

يحدد المسار الأساسي للملفات المعرفة في nuspec الملف.


verbosityPack - الاسهاب
string. ‏‏اختياري. استخدم عندما command = pack. القيم المسموح بها: Quiet، ، Normal. Detailed القيمة الافتراضية: Detailed.

يحدد مقدار التفاصيل المعروضة في الإخراج.


arguments - الأوامر والوسيطات
string. مطلوب عند command = custom.

يحدد الأمر والوسيطات التي سيتم تمريرها إلى NuGet.exe للتنفيذ. إذا تم استخدام NuGet 3.5 أو أحدث، فستتم مصادقة الأوامر المصادق عليها مثل listو restoreو publish مقابل أي موجز في هذه المؤسسة أو المجموعة التي يمكن لخدمة إنشاء مجموعة المشاريع الوصول إليها تلقائيا.


خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

لا شيء

الملاحظات

هام

مهمة NuGet Authenticate هي الطريقة الموصى بها الجديدة للمصادقة باستخدام Azure Artifacts ومستودعات NuGet الأخرى. لم تعد هذه المهمة تأخذ ميزات جديدة، ويتم معالجة الأخطاء الحرجة فقط.

استخدم هذه المهمة لتثبيت وتحديث تبعيات حزمة NuGet، أو حزم حزم NuGet ونشرها. يستخدم NuGet.exe ويعمل مع تطبيقات .NET Framework. بالنسبة لتطبيقات .NET Core و.NET Standard، استخدم مهمة .NET Core.

إذا كانت التعليمات البرمجية الخاصة بك تعتمد على حزم NuGet، فتأكد من إضافة هذه الخطوة قبل مهمة Visual Studio Build. تأكد أيضا من مسح خانة الاختيار استعادة حزم NuGet المهملة في تلك المهمة.

إذا كنت تعمل مع .NET Core أو .NET Standard، فاستخدم مهمة .NET Core ، التي لديها دعم كامل لجميع سيناريوهات الحزمة وهي مدعومة حاليا من قبل dotnet.

تلميح

يستخدم هذا الإصدار من مهمة NuGet NuGet 4.1.0 بشكل افتراضي. لتحديد إصدار مختلف من NuGet، استخدم Tool Installer.

مخططات تعيين الإصدار

بالنسبة إلى byPrereleaseNumber، سيتم تعيين الإصدار إلى القيم التي تختارها للإصدار الرئيسي والإصدار الثانوي والتصحيح، بالإضافة إلى التاريخ والوقت، بالتنسيق yyyymmdd-hhmmss.

بالنسبة إلى byEnvVar، سيتم تعيين الإصدار إلى قيمة متغير البيئة الذي يحتوي على الاسم المحدد بواسطة المعلمة versionEnvVar ، على سبيل المثال MyVersion (لا $، فقط اسم متغير البيئة). تأكد من تعيين متغير البيئة إلى SemVer مناسب، مثل 1.2.3 أو 1.2.3-beta1.

بالنسبة إلى byBuildNumber، سيتم تعيين الإصدار باستخدام رقم بناء تشغيل البنية الأساسية لبرنامج ربط العمليات التجارية. هذه هي القيمة المحددة لخاصية البنية name الأساسية لبرنامج ربط العمليات التجارية، والتي يتم حفظها في BUILD_BUILDNUMBER متغير البيئة). تأكد من أن رقم البناء المستخدم يحتوي على SemVer مناسب، مثل 1.0.$(Rev:r). عند استخدام byBuildNumber، ستقوم المهمة باستخراج الإصدار المنقط، ، 1.2.3.4من سلسلة رقم البناء، واستخدام هذا الجزء فقط. سيتم إسقاط بقية السلسلة. إذا كنت تريد استخدام رقم البناء كما هو، يمكنك استخدام byEnvVar كما هو موضح أعلاه، وتعيين versionEnvVar إلى BUILD_BUILDNUMBER.

الترحيل من NuGetInstaller@0 أو NuGetRestore@1

NuGetInstaller@0 و NuGetRestore@1 مهملة، ويجب استبدالها في البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك ب NuGetCommand@2.

إذا كنت تستخدم NuGetInstaller@0 مع restoreMode: restore، فكون المدخلات التالية عند استخدام NuGetCommand@2.

إدخال مهمة NuGetCommand@2 القيمة
command restore
restoreSolution مسار ملف .sln

إذا كنت تستخدم NuGetInstaller@0 مع restoreMode: install، فكون المدخلات التالية عند استخدام NuGetCommand@2.

إدخال مهمة NuGetCommand@2 القيمة
command custom
arguments كيف سيبدو أمر التثبيت الكامل في NuGet CLI. على سبيل المثال، إذا كنت تريد تشغيل ما يعادل nuget install ninject -OutputDirectory c:\proj في البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك، فستكون install ninject -OutputDirectory c:\projالمعلمة arguments . إذا كنت تستخدم المعلمة NuGetInstaller@0nuGetRestoreArgs ، فانتقل الآن أيضا إلى arguments.

إذا كنت تستخدم NuGetRestore@1، فكون المدخلات التالية عند استخدام NuGetCommand@2.

إدخال مهمة NuGetCommand@2 القيمة
command restore
restoreSolution مسار ملف .sln

على غرار استخدام NuGetRestore@1 أو NuGetInstaller@0restore الخيار، NuGetCommand@2 يحتوي على مدخلات لتعيين الموجز، وتحديد بين select أو config، وتحديد المسار إلى NuGet.config الملف، واستخدام الحزم من nuget.org.

لمزيد من المعلومات، راجع الأمثلة التالية.

أمثلة

استعادة

استعادة جميع الحلول الخاصة بك مع حزم من موجز محدد.

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

الحزمة

إنشاء حزمة NuGet في المجلد الوجهة.

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

وضع الدفع

ملاحظة

يتم تنزيل البيانات الاصطناعية للبنية الأساسية لبرنامج ربط العمليات التجارية إلى Pipeline.Workspace الدليل، وإلى System.ArtifactsDirectory الدليل لمسارات الإصدار الكلاسيكية. packagesToPush يمكن تعيين القيمة إلى $(Pipeline.Workspace)/**/*.nupkg أو $(System.ArtifactsDirectory)/**/*.nupkg على التوالي.

  • دفع/نشر حزمة إلى موجز محدد في NuGet.config.

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
        feedsToUse: 'config'
        nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
    
  • دفع/نشر حزمة إلى موجز نطاق المؤسسة

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-organization-scoped-feed'
    
  • دفع/نشر حزمة إلى موجز مشروع محدد النطاق

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-project/my-project-scoped-feed'
    
  • دفع/نشر حزمة إلى NuGet.org

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

مخصص

قم بتشغيل أي أمر NuGet آخر إلى جانب الأوامر الافتراضية: الحزمة والدفع والاستعادة.

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

المتطلبات

المتطلبات الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على Agent, DeploymentGroup
المطالب بلا
القدرات لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر أي
متغيرات Settable أي
إصدار الوكيل 2.144.0 أو أحدث
فئة المهمة الحزمة
المتطلبات الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على Agent, DeploymentGroup
المطالب بلا
القدرات لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر أي
متغيرات Settable أي
إصدار الوكيل 2.115.0 أو أحدث
فئة المهمة الحزمة