Delen via


NuGetCommand@2 - NuGet v2-taak

Gebruik deze taak om NuGet-pakketten te herstellen, in te pakken of te pushen, of een NuGet-opdracht uit te voeren. Deze taak ondersteunt NuGet.org en geverifieerde feeds zoals Azure Artifacts en MyGet. Deze taak maakt ook gebruik van NuGet.exe en werkt met .NET Framework apps. Voor .NET Core- en .NET Standard-apps gebruikt u de taak .NET Core.

Syntax

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

Invoerwaarden

command - Opdracht
string. Vereist. Toegestane waarden: restore, pack, push, custom. Standaardwaarde: restore.

Hiermee geeft u de NuGet-opdracht moet worden uitgevoerd. Gebruik de custom waarde om argumenten toe te voegen of om een andere opdracht te gebruiken.


restoreSolution - Pad naar oplossing, packages.config of project.json
Invoeralias: solution. string. Vereist wanneer command = restore. Standaardwaarde: **/*.sln.

Hiermee geeft u het pad naar de oplossing, packages.configof project.json het bestand dat verwijst naar de pakketten die moeten worden hersteld.


feedsToUse - Te gebruiken feeds
Invoeralias: selectOrConfig. string. Vereist wanneer command = restore. Toegestane waarden: select (Feed(s) die ik hier selecteer), config (Feeds in mijn NuGet.config). Standaardwaarde: select.

Hiermee geeft u een feed van Azure Artifacts en/of NuGet.org voor de taak te gebruiken met de select waarde. U kunt ook een NuGet.config bestand doorvoeren naar uw broncodeopslagplaats en het pad instellen als de waarde met behulp van de config waarde.


vstsFeed - Pakketten uit deze Azure Artifacts/TFS-feed gebruiken
Invoeralias: feedRestore. string. Optioneel. Gebruik wanneer selectOrConfig = select && command = restore.

Hiermee geeft u de geselecteerde feed in de gegenereerde NuGet.config. U moet Pakketbeheer hebben geïnstalleerd en een licentie hebben om hier een feed op te geven.


includeNuGetOrg - Pakketten van NuGet.org gebruiken
boolean. Optioneel. Gebruik wanneer selectOrConfig = select && command = restore. Standaardwaarde: true.

Bevat NuGet.org in de gegenereerde NuGet.config.


nugetConfigPath - Pad naar NuGet.config
string. Optioneel. Gebruik wanneer selectOrConfig = config && command = restore.

Hiermee geeft u het pad naar de NuGet.config in uw opslagplaats waarmee de feeds worden bepaald waaruit pakketten moeten worden hersteld.


externalFeedCredentials - Referenties voor feeds buiten deze organisatie/verzameling
Invoeralias: externalEndpoints. string. Optioneel. Gebruik wanneer selectOrConfig = config && command = restore.

Hiermee geeft u de referenties op die moeten worden gebruikt voor externe registers die zich in de geselecteerde NuGet.configbevinden. Dit is de naam van uw NuGet-serviceverbinding. Voor feeds in deze organisatie of verzameling laat u dit leeg; de referenties van de build worden automatisch gebruikt.


externalFeedCredentials - Referenties voor feeds buiten dit account/deze verzameling
Invoeralias: externalEndpoints. string. Optioneel. Gebruik wanneer selectOrConfig = config && command = restore.

Hiermee geeft u de referenties op die moeten worden gebruikt voor externe registers die zich in de geselecteerde NuGet.configbevinden. Dit is de naam van uw NuGet-serviceverbinding. Voor feeds in dit account of deze verzameling laat u dit leeg; de referenties van de build worden automatisch gebruikt.


noCache - Lokale cache uitschakelen
boolean. Optioneel. Gebruik wanneer command = restore. Standaardwaarde: false.

Hiermee voorkomt u dat NuGet pakketten uit caches van lokale computers gebruikt wanneer deze zijn ingesteld op true.


disableParallelProcessing - Parallelle verwerking uitschakelen
boolean. Optioneel. Gebruik wanneer command = restore. Standaardwaarde: false.

Voorkomt dat NuGet meerdere pakketten in parallelle processen installeert wanneer deze is ingesteld op true.


restoreDirectory - Doelmap
Invoeralias: packagesDirectory. string. Optioneel. Gebruik wanneer command = restore.

Hiermee geeft u de map waarin pakketten zijn geïnstalleerd. Als er geen map is opgegeven, worden pakketten hersteld in een packages/ map naast de geselecteerde oplossing, packages.configof project.json.


verbosityRestore - Uitgebreidheid
string. Optioneel. Gebruik wanneer command = restore. Toegestane waarden: Quiet, Normal, Detailed. Standaardwaarde: Detailed.

Hiermee geeft u de hoeveelheid details op die in de uitvoer wordt weergegeven.


packagesToPush - Pad naar NuGet-pakket(en) om te publiceren
Invoeralias: searchPatternPush. string. Vereist wanneer command = push. Standaardwaarde: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Hiermee geeft u het patroon op dat overeenkomt met of het pad naar nupkg bestanden die moeten worden geüpload. Meerdere patronen kunnen worden gescheiden door een puntkomma.


nuGetFeedType - Locatie van doelfeed
string. Vereist wanneer command = push. Toegestane waarden: internal (Deze organisatie/verzameling), external (externe NuGet-server (inclusief andere accounts/verzamelingen)). Standaardwaarde: internal.

Hiermee geeft u op of de doelfeed een interne feed/verzameling of een externe NuGet-server is.


nuGetFeedType - Locatie van doelfeed
string. Vereist wanneer command = push. Toegestane waarden: internal (Dit account/deze verzameling), external (Externe NuGet-server (inclusief andere accounts/verzamelingen)). Standaardwaarde: internal.

Hiermee geeft u op of de doelfeed een interne feed/verzameling of een externe NuGet-server is.


publishVstsFeed - Doelfeed
Invoeralias: feedPublish. string. Vereist wanneer command = push && nuGetFeedType = internal.

Hiermee geeft u een feed op die wordt gehost in dit account. U moet Azure Artifacts hebben geïnstalleerd en een licentie hebben om hier een feed te selecteren.


publishPackageMetadata - Metagegevens van pijplijn publiceren
boolean. Optioneel. Gebruik wanneer command = push && nuGetFeedType = internal && command = push. Standaardwaarde: true.

Hiermee wijzigt u het versienummer van de subset van gewijzigde pakketten binnen een set voortdurend gepubliceerde pakketten.


allowPackageConflicts - Toestaan dat duplicaten worden overgeslagen
boolean. Optioneel. Gebruik wanneer command = push && nuGetFeedType = internal. Standaardwaarde: false.

Rapporteert een geslaagde taak, zelfs als sommige van uw pakketten zijn geweigerd met 409-conflictfouten.

Deze optie is momenteel alleen beschikbaar in Azure Pipelines en Windows-agents. Als NuGet.exe er een conflict optreedt, mislukt de taak. Deze optie werkt niet en het publiceren mislukt als u zich in een proxyomgeving bevindt.


publishFeedCredentials - NuGet-server
Invoeralias: externalEndpoint. string. Vereist wanneer command = push && nuGetFeedType = external.

Hiermee geeft u de NuGet-serviceverbinding op die de referenties van de externe NuGet-server bevat.


verbosityPush - Uitgebreidheid
string. Optioneel. Gebruik wanneer command = push. Toegestane waarden: Quiet, Normal, Detailed. Standaardwaarde: Detailed.

Hiermee geeft u de hoeveelheid details op die in de uitvoer wordt weergegeven.


packagesToPack - Pad naar csproj of nuspec-bestand(en) om in te pakken
Invoeralias: searchPatternPack. string. Vereist wanneer command = pack. Standaardwaarde: **/*.csproj.

Hiermee geeft u het patroon op dat de taak gebruikt om te zoeken naar csproj-mappen om in te pakken.

U kunt meerdere patronen scheiden met een puntkomma en u kunt een patroon negatief maken door het voorvoegsel te voorzien van !. Bijvoorbeeld: **\*.csproj;!**\*.Tests.csproj.


configuration - Configuratie naar pakket
Invoeralias: configurationToPack. string. Optioneel. Gebruik wanneer command = pack. Standaardwaarde: $(BuildConfiguration).

Hiermee geeft u de configuratie die moet worden verpakt bij gebruik van een csproj-bestand.


packDestination - Pakketmap
Invoeralias: outputDir. string. Optioneel. Gebruik wanneer command = pack. Standaardwaarde: $(Build.ArtifactStagingDirectory).

Hiermee geeft u de map op waarin de taak pakketten maakt. Als de waarde leeg is, maakt de taak pakketten in de bronhoofdmap.


versioningScheme - Automatisch versiebeheer van pakketten
string. Vereist wanneer command = pack. Toegestane waarden: off, byPrereleaseNumber (Gebruik de datum en tijd), byEnvVar (Gebruik een omgevingsvariabele), byBuildNumber (Gebruik het buildnummer). Standaardwaarde: off.

Past automatisch pakketversiebeheer toe, afhankelijk van de opgegeven waarde. Deze tekenreeks kan niet worden gebruikt met includeReferencedProjects. De toegestane waarden zijn:

  • byPrereleaseNumber - Gebruik de datum en tijd: De taak genereert een SemVer-compatibele versie die is opgemaakt als X.Y.Z-ci-datetime, waarbij u de waarden van X, Y en Z opgeeft.
  • byEnvVar- Een omgevingsvariabele gebruiken: de taak gebruikt een omgevingsvariabele die u opgeeft en bevat het versienummer dat u wilt gebruiken.
  • byBuildNumber - Het buildnummer gebruiken: de taak gebruikt het buildnummer om het pakket te versien.

Notitie

Stel onder Algemeen de build-indeling in op $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


includeReferencedProjects - Projecten waarnaar wordt verwezen opnemen
boolean. Optioneel. Gebruik wanneer versioningScheme = off && command = pack. Standaardwaarde: false.

Bevat projecten waarnaar wordt verwezen als afhankelijkheden of als onderdeel van het pakket. Kan niet worden gebruikt met automatische pakketversiebeheer. Als een project waarnaar wordt verwezen een bijbehorend nuspec bestand heeft met dezelfde naam als het project, wordt dat project waarnaar wordt verwezen toegevoegd als een afhankelijkheid. Anders wordt het project waarnaar wordt verwezen toegevoegd als onderdeel van het pakket. Meer informatie over het gebruik van de opdracht pack voor NuGet CLI om NuGet-pakketten te maken.


versionEnvVar - Omgevingsvariabele
string. Vereist wanneer versioningScheme = byEnvVar && command = pack.

Hiermee geeft u de naam van de variabele op zonder $, $envof %.


majorVersion - Belangrijke
Invoeralias: requestedMajorVersion. string. Vereist wanneer versioningScheme = byPrereleaseNumber && command = pack. Standaardwaarde: 1.

De X in versie X.Y.Z.


minorVersion - Kleine
Invoeralias: requestedMinorVersion. string. Vereist wanneer versioningScheme = byPrereleaseNumber && command = pack. Standaardwaarde: 0.

De Y in versie X.Y.Z.


patchVersion - Patch
Invoeralias: requestedPatchVersion. string. Vereist wanneer versioningScheme = byPrereleaseNumber && command = pack. Standaardwaarde: 0.

De Z in versie X.Y.Z.


packTimezone - Tijdzone
string. Optioneel. Gebruik wanneer versioningScheme = byPrereleaseNumber && command = pack. Toegestane waarden: utc, local (lokale tijd van agent). Standaardwaarde: utc.

Hiermee geeft u de gewenste tijdzone op die wordt gebruikt om de versie van het pakket te produceren. utc Selecteren wordt aanbevolen als u gehoste buildagents gebruikt, omdat de datum en tijd kunnen verschillen.


includeSymbols - Symbolenpakket maken
boolean. Optioneel. Gebruik wanneer command = pack. Standaardwaarde: false.

Hiermee geeft u op dat het pakket bronnen en symbolen bevat. Bij gebruik met een .nuspec bestand wordt hiermee een normaal NuGet-pakketbestand en het bijbehorende symbolenpakket gemaakt.


toolPackage - Hulpprogrammapakket
boolean. Optioneel. Gebruik wanneer command = pack. Standaardwaarde: false.

Bepaalt of de uitvoerbestanden van het project zich in de map van het hulpprogramma moeten bevinden.


buildProperties - Aanvullende build-eigenschappen
string. Optioneel. Gebruik wanneer command = pack.

Hiermee geeft u een lijst met token=waardeparen op, gescheiden door puntkomma's, waarbij elk exemplaar van $token$ in het .nuspec bestand wordt vervangen door de opgegeven waarde. Waarden kunnen tekenreeksen tussen aanhalingstekens zijn.


basePath - Basispad
string. Optioneel. Gebruik wanneer command = pack.

Hiermee geeft u het basispad op van de bestanden die in het nuspec bestand zijn gedefinieerd.


verbosityPack - Uitgebreidheid
string. Optioneel. Gebruik wanneer command = pack. Toegestane waarden: Quiet, Normal, Detailed. Standaardwaarde: Detailed.

Hiermee geeft u de hoeveelheid details op die in de uitvoer wordt weergegeven.


arguments - Opdracht en argumenten
string. Vereist wanneer command = custom.

Hiermee geeft u de opdracht en argumenten die worden doorgegeven voor NuGet.exe uitvoering. Als NuGet 3.5 of hoger wordt gebruikt, worden geverifieerde opdrachten zoals list, restoreen publish op basis van een feed in deze organisatie of verzameling waartoe de Build-service voor projectverzamelingen toegang heeft, automatisch geverifieerd.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Belangrijk

De NuGet-verificatietaak is de nieuwe aanbevolen manier om te verifiëren met Azure Artifacts en andere NuGet-opslagplaatsen. Voor deze taak zijn geen nieuwe functies meer nodig en worden alleen kritieke bugs opgelost.

Gebruik deze taak om NuGet-pakketafhankelijkheden te installeren en bij te werken, of om NuGet-pakketten te verpakken en te publiceren. Maakt gebruik van NuGet.exe en werkt met .NET Framework apps. Voor .NET Core- en .NET Standard-apps gebruikt u de taak .NET Core.

Als uw code afhankelijk is van NuGet-pakketten, moet u deze stap toevoegen voordat u de Visual Studio Build-taak uitvoert. Zorg er ook voor dat u het afgeschafte selectievakje NuGet-pakketten herstellen in die taak uitschakelt.

Als u met .NET Core of .NET Standard werkt, gebruikt u de taak .NET Core , die volledige ondersteuning biedt voor alle pakketscenario's en momenteel wordt ondersteund door dotnet.

Tip

Deze versie van de NuGet-taak maakt standaard gebruik van NuGet 4.1.0. Als u een andere versie van NuGet wilt selecteren, gebruikt u het installatieprogramma van het hulpprogramma.

Versiebeheerschema's

Voor byPrereleaseNumber wordt de versie ingesteld op de waarden die u kiest voor de primaire versie, de secundaire versie en de patch, plus de datum en tijd, in de notatie yyyymmdd-hhmmss.

Voor byEnvVar wordt de versie ingesteld op de waarde van de omgevingsvariabele met de naam die is opgegeven door de parameter versionEnvVar , bijvoorbeeld MyVersion (geen $, alleen de naam van de omgevingsvariabele). Zorg ervoor dat de omgevingsvariabele is ingesteld op een juiste SemVer, zoals 1.2.3 of 1.2.3-beta1.

Voor byBuildNumber wordt de versie ingesteld met behulp van het buildnummer van de pijplijnuitvoering. Dit is de waarde die is opgegeven voor de eigenschap van name de pijplijn, die wordt opgeslagen in de BUILD_BUILDNUMBER omgevingsvariabele). Zorg ervoor dat het gebruikte buildnummer de juiste SemVer bevat, zoals 1.0.$(Rev:r). Wanneer u byBuildNumber gebruikt, extraheert de taak de gestippelde versie, 1.2.3.4, uit de buildnummertekenreeks en gebruikt alleen dat gedeelte. De rest van de tekenreeks wordt verwijderd. Als u het buildnummer wilt gebruiken zoals het is, kunt u byEnvVar gebruiken zoals hierboven beschreven en versionEnvVar instellen op BUILD_BUILDNUMBER.

Migreren van NuGetInstaller@0 of NuGetRestore@1

NuGetInstaller@0 en NuGetRestore@1 worden afgeschaft en moet u deze in uw pijplijn NuGetCommand@2vervangen door .

Als u met restoreMode: restoregebruiktNuGetInstaller@0, configureert u de volgende invoer bij het gebruik van NuGetCommand@2.

NuGetCommand@2 taakinvoer Waarde
command restore
restoreSolution Pad naar het .sln-bestand

Als u met restoreMode: installgebruiktNuGetInstaller@0, configureert u de volgende invoer bij het gebruik van NuGetCommand@2.

NuGetCommand@2 taakinvoer Waarde
command custom
arguments Hoe de opdracht voor volledige installatie eruit zou zien in de NuGet CLI. Als u bijvoorbeeld het equivalent van nuget install ninject -OutputDirectory c:\proj in uw pijplijn wilt uitvoeren, is install ninject -OutputDirectory c:\projde arguments parameter . Als u de NuGetInstaller@0nuGetRestoreArgs parameter gebruikt, gaan deze nu ook naar arguments.

Als u de NuGetRestore@1volgende invoer gebruikt, configureert u de volgende invoer wanneer u NuGetCommand@2gebruikt.

NuGetCommand@2 taakinvoer Waarde
command restore
restoreSolution Pad naar het .sln-bestand

Vergelijkbaar met het gebruik van NuGetRestore@1 of de NuGetInstaller@0restore optie, NuGetCommand@2 heeft invoer om de feed in te stellen, te kiezen tussen select of config, het pad naar het NuGet.config bestand op te geven en pakketten van nuget.org te gebruiken.

Zie de volgende voorbeelden voor meer informatie.

Voorbeelden

Herstellen

Herstel al uw oplossingen met pakketten uit een geselecteerde feed.

# 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'

Pakket

Maak een NuGet-pakket in de doelmap.

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

Push

Notitie

Pijplijnartefacten worden gedownload naar de Pipeline.Workspace map en naar de System.ArtifactsDirectory map voor klassieke release-pijplijnen. packagesToPush waarde kan worden ingesteld op $(Pipeline.Workspace)/**/*.nupkg respectievelijk of $(System.ArtifactsDirectory)/**/*.nupkg .

  • Pushen/publiceren van een pakket naar een feed die is gedefinieerd in uw NuGet.config.

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
        feedsToUse: 'config'
        nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
    
  • Een pakket pushen/publiceren naar een feed met organisatiebereik

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-organization-scoped-feed'
    
  • Een pakket pushen/publiceren naar een feed met projectbereik

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-project/my-project-scoped-feed'
    
  • Een pakket pushen/publiceren naar NuGet.org

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

Aangepast telefoonnummer

Voer een andere NuGet-opdracht uit naast de standaardopdrachten: inpakken, pushen en herstellen.

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

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 2.144.0 of hoger
Taakcategorie Pakket
Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 2.115.0 of hoger
Taakcategorie Pakket