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.

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

Inputs

command - Parancs
string. Required. 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 álnév: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 álnév: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 álnév:feedRestore . string. Optional. 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 álnév:feedRestore . string. Optional. 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. Optional. 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. Optional. 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 álnév:externalEndpoints . string. Optional. 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.


noCache - Helyi gyorsítótár- letiltása
boolean. Optional. 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. Optional. 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 álnév:packagesDirectory . string. Optional. 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/vagy packages.configmellett egy project.json mappába kerülnek.


verbosityRestore - Bőbeszédűség
string. Optional. 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 álnév: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.


publishVstsFeed - Cél hírcsatorna
Bemeneti álnév: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. Optional. Használja a command = push && nuGetFeedType = internal. 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. Optional. 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 álnév: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 - Bőbeszédűség
string. Optional. 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 álnév: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 álnév:configurationToPack . string. Optional. 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 álnév:outputDir . string. Optional. 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.

Note

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. Optional. 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 - Őrnagy
Bemeneti álnév:requestedMajorVersion . string. versioningScheme = byPrereleaseNumber && command = packesetén kötelező. Alapértelmezett érték: 1.

Az XX.Y.Z.


minorVersion - Kiskorú
Bemeneti álnév:requestedMinorVersion . string. versioningScheme = byPrereleaseNumber && command = packesetén kötelező. Alapértelmezett érték: 0.

Az YX.Y.Z.


patchVersion - Folt
Bemeneti álnév:requestedPatchVersion . string. versioningScheme = byPrereleaseNumber && command = packesetén kötelező. Alapértelmezett érték: 0.

Az ZX.Y.Z.


packTimezone - Időzóna
string. Optional. 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. Optional. 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. Optional. 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. Optional. Használja a command = pack.

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


basePath - Alap elérési út
string. Optional. Használja a command = pack.

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


verbosityPack - Bőbeszédűség
string. Optional. 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

None.

Remarks

Important

Ha Azure-összetevőkkel vagy más NuGet-adattárakkal szeretne hitelesíteni, a NuGetCommand@2 feladat helyett a NuGet Authenticate feladatot kell használnia. A NuGetCommand@2 feladat már nem frissül új funkciókkal, csak a kritikus hibákat javítja ki.

Ezzel a feladattal visszaállíthatja, csomagolhatja vagy leküldheti a NuGet-csomagokat, vagy futtathat NuGet-parancsokat. Ez a feladat NuGet.exe használ, és együttműködik a .NET Framework alkalmazásokkal. Ha .NET Core vagy .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.

Ha a kód a NuGet-csomagoktól függ, és vissza kell állítania ezeket a függőségeket, mielőtt létrehozná a projektet a Visual Studio Build feladatfeladattal , a nugetAuthenticate és a parancssori feladatokkal visszaállíthatja a csomagokat. Helyezze mindkét feladatot a buildelési lépés elé, hogy az összes függőség elérhető legyen a build megkezdése előtt. További részletekért lásd: NuGet-csomagok visszaállítása .

A Visual Studio Build feladatfeladat használatakor hagyja üresen a restoreNugetPackages argumentumot, mivel a "NuGet-csomagok visszaállítása" beállítás elavult a VSBuild@1 feladatban.

Tip

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 az Eszköztelepítőt.

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

A byPrereleaseNumber esetében a verzió a főverzióhoz, az alverzióhoz és a javításhoz kiválasztott értékekre, valamint a dátumra és az időre lesz beállítva a következő formátumban yyyymmdd-hhmmss: .

A byEnvVar esetében a verzió annak a környezeti változónak az értékére lesz beállítva, amelynek neve a versionEnvVar paraméter által megadott, például MyVersion (nem $, 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 byBuildNumber eseté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 byBuildNumber használata esetén a feladat kinyeri a pontozott verziót 1.2.3.4, a 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 úgy szeretné használni, ahogy van, használhatja a byEnvVar parancsot a fent leírtak szerint, és állítsa a versionEnvVar értéket .BUILD_BUILDNUMBER

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 Value
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 Value
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 Value
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óért tekintse meg az alábbi példákat.

Újabb, Ubuntu által üzemeltetett rendszerképek támogatása

Az Ubuntu 24.04-től kezdve a Microsft által üzemeltetett ügynökök nem fognak mono szállítani, amely a NuGetCommand@2hatalmi alapjául szolgáló NuGet-ügyfél futtatásához szükséges. Az Ubuntu-beli feladat felhasználóinak a .NET parancssori felülettel NuGetAuthenticate@1 hosszú távon támogatott platformfüggetlen feladatra kell migrálniuk.

Migrálás a .NET parancssori felületére az Ubuntu-on

A NuGet Authenticate feladat kezeli a hitelesítő adatok beszúrását a szükséges helyekre, hogy az ügyféleszközök folyamatidentitásként hitelesíthetők legyenek. Kérjük, tekintse meg a Példák és megjegyzések szakaszokat, ha többet szeretne megtudni a dotnet használatáról NuGet Authenticate .

Ha dotnet CLI-parancsok nem támogatják a forgatókönyvet, kérjük, jelentse ezt a .NET CLI-csapatnak problémaként. Továbbra is rögzítheti az ügynök rendszerképét az Ubuntu 22.04-vagy korábbi. Az Ubuntu 22.04 támogatása mindaddig folytatódik, amíg az Ubuntu 26.04 általánosan elérhetővé nem válik, legkésőbb 2026-ig.

Miért hibásodik meg a buildelési folyamat, és miért kéri az egyszeri Sign-On (SSO) hitelesítését?

A buildek meghiúsulhatnak, ha a hitelesítő adatok lejártak. A hibák elkerülése érdekében javasoljuk, hogy a NuGet Authenticate feladattal telepítse újra a hitelesítőadat-szolgáltatót, és automatikusan frissítse a hitelesítő adatokat. Ez biztosítja a megszakítás nélküli hozzáférést a folyamat végrehajtása során.

steps:
# Authenticate with NuGet to ensure credentials are refreshed
- task: NuGetAuthenticate@1
# Restore NuGet packages
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    restoreSolution: '**/*.sln'
    feedsToUse: 'select'

Examples

Restore

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

Package

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

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

Átirányítás

Note

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'
    

Custom

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'

Requirements

Requirement Description
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Tovább fut Ügynök, DeploymentGroup
Demands None
Capabilities Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások Any
Beállítható változók Any
Ügynök verzió 2.144.0 vagy újabb
Tevékenység kategória Package
Requirement Description
Folyamattípusok YAML, klasszikus build, klasszikus kiadás
Tovább fut Ügynök, DeploymentGroup
Demands None
Capabilities Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások Any
Beállítható változók Any
Ügynök verzió 2.115.0 vagy újabb
Tevékenység kategória Package