Megosztás a következőn keresztül:


NuGetCommand@2 – NuGet v2 feladat

Ezzel a feladatsal visszaállíthatja, csomagolhatja vagy leküldheti a NuGet-csomagokat, vagy futtathat Egy NuGet-parancsot. Ez a feladat támogatja NuGet.org és hitelesített hírcsatornákat, például az Azure Artifactst és a MyGetet. Ez a feladat NuGet.exe is használ, és a .NET-keretrendszer alkalmazásaival is működik. A .NET Core- és a .NET Standard-alkalmazásokhoz használja a .NET Core-feladatot.

Szintaxis

# 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. Select from the dropdown or enter [project name/]feed name. 
    #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 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.

Bemenetek

command - parancs
string. Szükséges. Engedélyezett értékek: restore, pack, push, custom. Alapértelmezett érték: restore.

A futtatandó NuGet-parancsot adja meg. A custom érték használatával argumentumokat adhat hozzá, vagy másik parancsot használhat.


restoreSolution - Megoldás elérési útja, packages.configvagy project.json
Bemeneti alias: solution. string. command = restoreesetén kötelező. Alapértelmezett érték: **/*.sln.

Megadja a visszaállítandó csomagokra hivatkozó megoldás, packages.configvagy project.json fájl elérési útját.


feedsToUse - használni kívánt hírcsatornák
Bemeneti alias: selectOrConfig. string. command = restoreesetén kötelező. Engedélyezett értékek: select (Itt kiválasztom a hírcsatornát), config (A NuGet.confighírcsatornái). Alapértelmezett érték: select.

Megadja az Azure Artifacts és/vagy a NuGet.org hírcsatornáit a tevékenységhez, amelyet a select értékkel szeretne használni. Másik lehetőségként véglegesítheti a NuGet.config fájlt a forráskódtárban, és beállíthatja az elérési útját értékként a config érték használatával.


vstsFeed - Az Azure Artifacts/TFS-hírcsatornából származó csomagok használata. Válasszon a legördülő listából, vagy írja be a [projekt neve/]hírcsatorna nevét.
Bemeneti alias: feedRestore. string. Szabadon választható. Használja a selectOrConfig = select && command = restore.

A létrehozott NuGet.configkijelölt hírcsatornát adja meg. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt adjon meg egy hírcsatornát.


vstsFeed - Az Azure Artifacts/TFS-hírcsatornából származó csomagok használata
Bemeneti alias: feedRestore. string. Szabadon választható. Használja a selectOrConfig = select && command = restore.

A létrehozott NuGet.configkijelölt hírcsatornát adja meg. A csomagkezelésnek telepítve és licencelve kell lennie ahhoz, hogy itt adjon meg egy hírcsatornát.


includeNuGetOrg - Csomagok használata NuGet.org
boolean. Szabadon választható. Használja a selectOrConfig = select && command = restore. Alapértelmezett érték: true.

Tartalmazza a létrehozott NuGet.configNuGet.org.


nugetConfigPath - elérési út a NuGet.config
string. Szabadon választható. Használja a selectOrConfig = config && command = restore.

Megadja a NuGet.config elérési útját az adattárban, amely meghatározza azokat a hírcsatornákat, amelyekből a csomagokat vissza szeretné állítani.


externalFeedCredentials - szervezeten/gyűjteményen kívüli hírcsatornák hitelesítő adatainak
Bemeneti alias: externalEndpoints. string. Szabadon választható. Használja a selectOrConfig = config && command = restore.

A kijelölt NuGet.configtalálható külső regisztrációs adatbázisokhoz használandó hitelesítő adatokat adja meg. Ez a NuGet-szolgáltatáskapcsolat neve. A szervezetben vagy gyűjteményben lévő hírcsatornák esetében hagyja üresen; a rendszer automatikusan használja a build hitelesítő adatait.


externalFeedCredentials - a fiókon/gyűjteményen kívüli hírcsatornák hitelesítő adatainak
Bemeneti alias: externalEndpoints. string. Szabadon választható. Használja a selectOrConfig = config && command = restore.

A kijelölt NuGet.configtalálható külső regisztrációs adatbázisokhoz használandó hitelesítő adatokat adja meg. Ez a NuGet-szolgáltatáskapcsolat neve. Az ebben a fiókban vagy gyűjteményben lévő hírcsatornák esetében hagyja üresen; a rendszer automatikusan használja a build hitelesítő adatait.


noCache - Helyi gyorsítótár- letiltása
boolean. Szabadon választható. Használja a command = restore. Alapértelmezett érték: false.

Megakadályozza, hogy a NuGet a helyi gép gyorsítótáraiból származó csomagokat használjon truebeállításakor.


disableParallelProcessing - Párhuzamos feldolgozás letiltása
boolean. Szabadon választható. Használja a command = restore. Alapértelmezett érték: false.

Megakadályozza, hogy a NuGet több csomagot telepítsen párhuzamos folyamatokba truebeállításakor.


restoreDirectory - Célkönyvtár
Bemeneti alias: packagesDirectory. string. Szabadon választható. Használja a command = restore.

Azt a mappát adja meg, amelyben a csomagok telepítve vannak. Ha nincs megadva mappa, a csomagok a kiválasztott megoldás, packages.configvagy project.jsonmellett egy packages/ mappába kerülnek.


verbosityRestore - részletességi
string. Szabadon választható. Használja a command = restore. Engedélyezett értékek: Quiet, Normal, Detailed. Alapértelmezett érték: Detailed.

Megadja a kimenetben megjelenített részletek mennyiségét.


packagesToPush - NuGet-csomag(ok) elérési útja a közzétételéhez
Bemeneti alias: searchPatternPush. string. command = pushesetén kötelező. Alapértelmezett érték: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Megadja a feltöltendő fájlok nupkg egyező mintáját vagy elérési útját. Több minta is elválasztható pontosvesszővel.


nuGetFeedType - Célcsatorna helye
string. command = pushesetén kötelező. Engedélyezett értékek: internal (Ez a szervezet/gyűjtemény), external (külső NuGet-kiszolgáló (beleértve más fiókokat/gyűjteményeket is)). Alapértelmezett érték: internal.

Megadja, hogy a célcsatorna belső hírcsatorna/gyűjtemény vagy külső NuGet-kiszolgáló-e.


nuGetFeedType - Célcsatorna helye
string. command = pushesetén kötelező. Engedélyezett értékek: internal (Ez a fiók/gyűjtemény), external (külső NuGet-kiszolgáló (beleértve más fiókokat/gyűjteményeket is)). Alapértelmezett érték: internal.

Megadja, hogy a célcsatorna belső hírcsatorna/gyűjtemény vagy külső NuGet-kiszolgáló-e.


publishVstsFeed - Célcsatorna
Bemeneti alias: feedPublish. string. command = push && nuGetFeedType = internalesetén kötelező.

Megadja a fiókban üzemeltetett hírcsatornát. A hírcsatorna kiválasztásához telepítve és licencelve kell lennie az Azure Artifactsnek.


publishPackageMetadata - Folyamat metaadatainak közzététele
boolean. Szabadon választható. Használja a command = push && nuGetFeedType = internal && command = push. Alapértelmezett érték: true.

Módosítja a módosított csomagok részhalmazának verziószámát a folyamatosan közzétett csomagok halmazán belül.


allowPackageConflicts - Ismétlődések kihagyása
boolean. Szabadon választható. Használja a command = push && nuGetFeedType = internal. Alapértelmezett érték: false.

A feladat sikerességét akkor is jelenti, ha egyes csomagok elutasítása 409 ütközési hibával történik.

Ez a lehetőség jelenleg csak az Azure Pipelinesban és a Windows-ügynökökben érhető el. Ha NuGet.exe ütközik, a feladat meghiúsul. Ez a beállítás nem működik, és a közzététel sikertelen lesz, ha proxykörnyezetben van.


publishFeedCredentials - NuGet-kiszolgáló
Bemeneti alias: externalEndpoint. string. command = push && nuGetFeedType = externalesetén kötelező.

Megadja a Külső NuGet-kiszolgáló hitelesítő adatait tartalmazó NuGet-szolgáltatáskapcsolatot.


verbosityPush - részletességi
string. Szabadon választható. Használja a command = push. Engedélyezett értékek: Quiet, Normal, Detailed. Alapértelmezett érték: Detailed.

Megadja a kimenetben megjelenített részletek mennyiségét.


packagesToPack - csproj- vagy nuspec-fájl(ok) elérési útja a
Bemeneti alias: searchPatternPack. string. command = packesetén kötelező. Alapértelmezett érték: **/*.csproj.

Azt a mintát adja meg, amelyet a feladat a csproj-könyvtárak csomagolásához használ.

Több mintát is elválaszthat pontosvesszővel, és negatívvá teheti a mintákat úgy, hogy előtagot ad !. Példa: **\*.csproj;!**\*.Tests.csproj.


configuration - konfiguráció a csomagolásához
Bemeneti alias: configurationToPack. string. Szabadon választható. Használja a command = pack. Alapértelmezett érték: $(BuildConfiguration).

Megadja a csproj-fájl használatakor csomagolni kívánt konfigurációt.


packDestination - Csomag mappa
Bemeneti alias: outputDir. string. Szabadon választható. Használja a command = pack. Alapértelmezett érték: $(Build.ArtifactStagingDirectory).

Megadja azt a mappát, ahol a feladat csomagokat hoz létre. Ha az érték üres, a tevékenység csomagokat hoz létre a forrásgyökernél.


versioningScheme - Csomag automatikus verziószámozási
string. command = packesetén kötelező. Engedélyezett értékek: off, byPrereleaseNumber (Dátum és idő használata), byEnvVar (Környezeti változó használata), byBuildNumber (A buildszám használata). Alapértelmezett érték: off.

A megadott értéktől függően automatikus csomagverziót alkalmaz. Ez a sztring nem használható includeReferencedProjects. Az engedélyezett értékek a következők:

  • byPrereleaseNumber - A dátum és az időhasználata: A feladat létrehoz egy SemVer-kompatibilis verziót X.Y.Z-ci-datetimeformátumban, ahol megadhatja az X, Y és Z értékeket.
  • byEnvVar - Környezeti változó használata: A tevékenység egy ön által megadott környezeti változót használ, amely tartalmazza a használni kívánt verziószámot.
  • byBuildNumber - A buildszám használata: A feladat a buildszámot használja a csomag verziószámához.

Jegyzet

Az Általános csoportban állítsa be a build formátumát $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


includeReferencedProjects - Hivatkozott projektek belefoglalása
boolean. Szabadon választható. Használja a versioningScheme = off && command = pack. Alapértelmezett érték: false.

A hivatkozott projekteket függőségként vagy a csomag részeként tartalmazza. A csomag automatikus verziószámozása nem használható. Ha egy hivatkozott projekt rendelkezik a projekt nevével megegyező nevű nuspec fájllal, akkor a hivatkozott projekt függőségként lesz hozzáadva. Ellenkező esetben a hivatkozott projekt a csomag részeként lesz hozzáadva. További információ arról, a NuGet CLI csomagparancsával hozhat létre NuGet-csomagokat.


versionEnvVar - környezeti változó
string. versioningScheme = byEnvVar && command = packesetén kötelező.

Megadja a változó nevét $, $envvagy %nélkül.


majorVersion -
Bemeneti alias: requestedMajorVersion. string. versioningScheme = byPrereleaseNumber && command = packesetén kötelező. Alapértelmezett érték: 1.

A X X.Y.Z .


minorVersion - kisebb
Bemeneti alias: requestedMinorVersion. string. versioningScheme = byPrereleaseNumber && command = packesetén kötelező. Alapértelmezett érték: 0.

A Y X.Y.Z .


patchVersion - patch
Bemeneti alias: requestedPatchVersion. string. versioningScheme = byPrereleaseNumber && command = packesetén kötelező. Alapértelmezett érték: 0.

A Z X.Y.Z .


packTimezone - időzóna
string. Szabadon választható. Használja a versioningScheme = byPrereleaseNumber && command = pack. Engedélyezett értékek: utc, local (ügynök helyi idő szerint). Alapértelmezett érték: utc.

Megadja a csomag verziójának előállításához használt kívánt időzónát. A utc kiválasztása ajánlott, ha üzemeltetett buildügynököket használ, mivel a dátum és az idő eltérhet.


includeSymbols - Szimbólumok létrehozása csomag
boolean. Szabadon választható. Használja a command = pack. Alapértelmezett érték: false.

Megadja, hogy a csomag forrásokat és szimbólumokat tartalmaz-e. Ha .nuspec fájllal használja, ez létrehoz egy normál NuGet-csomagfájlt és a megfelelő szimbólumcsomagot.


toolPackage - eszközcsomag
boolean. Szabadon választható. Használja a command = pack. Alapértelmezett érték: false.

Meghatározza, hogy a projekt kimeneti fájljainak az eszközmappában kell-e lenniük.


buildProperties - További buildtulajdonságok
string. Szabadon választható. Használja a command = pack.

Pontosvesszővel elválasztott token=érték párok listáját adja meg, ahol a .nuspec fájlban lévő $token$ minden előfordulása a megadott értékre lesz lecserélve. Az értékek idézőjelekben sztringek lehetnek.


basePath - Alapútvonal
string. Szabadon választható. Használja a command = pack.

A nuspec fájlban definiált fájlok alap elérési útját adja meg.


verbosityPack - részletességi
string. Szabadon választható. Használja a command = pack. Engedélyezett értékek: Quiet, Normal, Detailed. Alapértelmezett érték: Detailed.

Megadja a kimenetben megjelenített részletek mennyiségét.


arguments - parancsok és argumentumok
string. command = customesetén kötelező.

Megadja a végrehajtáshoz NuGet.exe átadott parancsokat és argumentumokat. Ha NuGet 3.5-ös vagy újabb verziót használ, a rendszer automatikusan hitelesíti az olyan hitelesített parancsokat, mint a list, a restoreés a publish a szervezet vagy gyűjtemény bármely olyan hírcsatornáján, amelyhez a Project Collection Build Service rendelkezik hozzáféréssel.


Tevékenységvezérlési beállítások

Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlők és gyakori feladattulajdonságok.

Kimeneti változók

Egyik sem.

Megjegyzések

Fontos

A NuGet-hitelesítés feladat az Azure Artifacts és más NuGet-tárházakkal való hitelesítés új ajánlott módja. Ez a feladat már nem vesz igénybe új funkciókat, és csak a kritikus hibákat kezeli.

Ezzel a feladatgal telepítheti és frissítheti a NuGet-csomag függőségeit, vagy csomagolhatja és teheti közzé a NuGet-csomagokat. NuGet.exe használ, és a .NET-keretrendszeralkalmazásokkal dolgozik. A .NET Core- és a .NET Standard-alkalmazásokhoz használja a .NET Core-feladatot.

Ha a kód a NuGet-csomagoktól függ, mindenképpen adja hozzá ezt a lépést a Visual Studio buildelési feladat. Ügyeljen arra is, hogy törölje az elavult NuGet-csomagok visszaállítása jelölőnégyzet jelölését.

Ha a .NET Core vagy a .NET Standard használatával dolgozik, használja a .NET Core feladatot, amely teljes mértékben támogatja az összes csomagforgatókönyvet, és jelenleg a dotnet támogatja.

Borravaló

A NuGet-feladat ezen verziója alapértelmezés szerint a NuGet 4.1.0-s verzióját használja. A NuGet másik verziójának kiválasztásához használja a Tool Installer.

Verziószámozási sémák

A byPrereleaseNumberesetén a verzió a főverzióhoz, az alverzióhoz és a javításhoz választott értékekre, valamint a dátumra és időre lesz beállítva yyyymmdd-hhmmssformátumban.

A byEnvVaresetében a verzió a versionEnvVar paraméter által megadott nevű környezeti változó értékére lesz állítva, például MyVersion (nincs $, csak a környezeti változó neve). Győződjön meg arról, hogy a környezeti változó megfelelő SemVer értékre van állítva, például 1.2.3 vagy 1.2.3-beta1.

A byBuildNumberesetében a verzió a folyamatfuttatás buildszámával lesz beállítva. Ez a folyamat name tulajdonságához megadott érték, amelyet a rendszer a BUILD_BUILDNUMBER környezeti változóba ment. Győződjön meg arról, hogy a használt buildszám megfelelő SemVer-et tartalmaz, például 1.0.$(Rev:r). A byBuildNumberhasználatakor a feladat kinyeri a pontozott verziót 1.2.3.4a buildszám sztringből, és csak ezt a részt használja. A sztring többi része el lesz ejtve. Ha a buildszámot a fentieknek megfelelően szeretné használni, használhatja a byEnvVar a fent leírtak szerint, és versionEnvVarBUILD_BUILDNUMBERértékre állíthatja.

Migrálás NuGetInstaller@0 vagy NuGetRestore@1

NuGetInstaller@0 és NuGetRestore@1 elavultak, és ezeket a folyamat során NuGetCommand@2kell lecserélnie.

Ha NuGetInstaller@0 használt restoreMode: restore, konfigurálja a következő bemeneteket a NuGetCommand@2használatakor.

NuGetCommand@2 tevékenységbemenet Érték
command restore
restoreSolution A .sln fájl elérési útja

Ha NuGetInstaller@0 használt restoreMode: install, konfigurálja a következő bemeneteket a NuGetCommand@2használatakor.

NuGetCommand@2 tevékenységbemenet Érték
command custom
arguments A Teljes telepítési parancs megjelenése a NuGet PARANCSSORI-ban. Ha például az nuget install ninject -OutputDirectory c:\proj megfelelőt szeretné futtatni a folyamatban, akkor a arguments paraméter install ninject -OutputDirectory c:\projlesz. Ha a NuGetInstaller@0nuGetRestoreArgs paramétert használta, ezek is arguments.

Ha NuGetRestore@1használ, konfigurálja a következő bemeneteket a NuGetCommand@2használatakor.

NuGetCommand@2 tevékenységbemenet Érték
command restore
restoreSolution A .sln fájl elérési útja

A NuGetRestore@1 vagy a NuGetInstaller@0restore beállításhoz hasonlóan NuGetCommand@2 bemenetekkel is rendelkezik a hírcsatorna beállításához, a select vagy configközötti döntéshez, a NuGet.config fájl elérési útjának megadásához, valamint a nuget.org csomagjainak használatához.

További információ: példák.

Példák

Visszaad

Állítsa vissza az összes megoldást egy kijelölt hírcsatornából származó csomagokkal.

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

Csomag

Hozzon létre egy NuGet-csomagot a célmappában.

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

Tol

Jegyzet

A folyamatösszetevők a Pipeline.Workspace könyvtárba, a klasszikus kiadási folyamatok System.ArtifactsDirectory könyvtárába lesznek letöltve. packagesToPush érték beállítható $(Pipeline.Workspace)/**/*.nupkg vagy $(System.ArtifactsDirectory)/**/*.nupkg értékre.

  • Csomag leküldése/közzététele a NuGet.configmeghatározott csatornán.

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
        feedsToUse: 'config'
        nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
    
  • Csomag leküldése/közzététele szervezeti hatókörű hírcsatornán

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-organization-scoped-feed'
    
  • Csomag leküldése/közzététele projekt hatókörű hírcsatornában

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-project/my-project-scoped-feed'
    
  • Csomag leküldése/közzététele NuGet.org

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

Szokás

Futtasson más NuGet-parancsokat az alapértelmezetteken kívül: csomag, leküldés és visszaállítás.

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

Követelmények

Követelmény Leírás
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Futtatás bekapcsolva Ügynök, DeploymentGroup
Követelmények Egyik sem
képességek Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
parancskorlátozások Bármely
Változók beállítása Bármely
Ügynök verziója 2.144.0 vagy újabb
Tevékenységkategória Csomag
Követelmény Leírás
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Futtatás bekapcsolva Ügynök, DeploymentGroup
Követelmények Egyik sem
képességek Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
parancskorlátozások Bármely
Változók beállítása Bármely
Ügynök verziója 2.115.0 vagy újabb
Tevékenységkategória Csomag