Sdílet prostřednictvím


NuGetCommand@2 – úloha NuGet v2

Pomocí této úlohy můžete obnovit, zabalit nebo nasdílit balíčky NuGet nebo spustit příkaz NuGet. Tato úloha podporuje NuGet.org a ověřené informační kanály, jako jsou Azure Artifacts a MyGet. Tato úloha také používá NuGet.exe a funguje s aplikacemi .NET Framework. Pro aplikace .NET Core a .NET Standard použijte úlohu .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.

Vstupy

command - Příkaz
string. Povinná hodnota. Povolené hodnoty: restore, pack, push, . custom Výchozí hodnota: restore.

Určuje příkaz NuGet, který se má spustit. Hodnotu použijte custom k přidání argumentů nebo k použití jiného příkazu.


restoreSolution - Cesta k řešení, packages.config nebo project.json
Alias vstupu: solution. string. Vyžaduje se, když command = restore. Výchozí hodnota: **/*.sln.

Určuje cestu k řešení nebo project.json souboru, packages.configkterý odkazuje na balíčky, které se mají obnovit.


feedsToUse - Informační kanály, které se mají použít
Alias vstupu: selectOrConfig. string. Vyžaduje se, když command = restore. Povolené hodnoty: select (Informační kanály, které vyberu tady), config (Informační kanály v NuGet.config). Výchozí hodnota: select.

Určuje informační kanál z Azure Artifacts nebo NuGet.org pro úlohu, která se má použít s select hodnotou . Případně můžete soubor potvrdit do úložiště zdrojového NuGet.config kódu a nastavit jeho cestu jako hodnotu pomocí config hodnoty .


vstsFeed - Použití balíčků z tohoto informačního kanálu Azure Artifacts/TFS
Alias vstupu: feedRestore. string. Nepovinný parametr. Použijte, když selectOrConfig = select && command = restore.

Určuje vybraný informační kanál ve vygenerovaném NuGet.configobjektu . Abyste mohli zadat informační kanál, musíte mít nainstalovanou a licencovanou správu balíčků.


includeNuGetOrg - Použití balíčků z NuGet.org
boolean. Nepovinný parametr. Použijte, když selectOrConfig = select && command = restore. Výchozí hodnota: true.

Zahrne NuGet.org ve vygenerovaném NuGet.configsouboru .


nugetConfigPath - Cesta k NuGet.config
string. Nepovinný parametr. Použijte, když selectOrConfig = config && command = restore.

Určuje cestu k NuGet.config úložišti, která určuje informační kanály, ze kterých se mají balíčky obnovit.


externalFeedCredentials - Přihlašovací údaje pro informační kanály mimo tuto organizaci nebo kolekci
Alias vstupu: externalEndpoints. string. Nepovinný parametr. Použijte, když selectOrConfig = config && command = restore.

Určuje přihlašovací údaje, které se mají použít pro externí registry umístěné ve vybraném NuGet.configobjektu . Toto je název vašeho připojení služby NuGet. U informačních kanálů v této organizaci nebo kolekci ponechte toto pole prázdné. přihlašovací údaje sestavení se použijí automaticky.


externalFeedCredentials - Přihlašovací údaje pro informační kanály mimo tento účet nebo kolekci
Alias vstupu: externalEndpoints. string. Nepovinný parametr. Použijte, když selectOrConfig = config && command = restore.

Určuje přihlašovací údaje, které se mají použít pro externí registry umístěné ve vybraném NuGet.configobjektu . Toto je název vašeho připojení služby NuGet. U informačních kanálů v tomto účtu nebo kolekci ponechte toto pole prázdné. přihlašovací údaje sestavení se použijí automaticky.


noCache - Zakázat místní mezipaměť
boolean. Nepovinný parametr. Použijte, když command = restore. Výchozí hodnota: false.

Zabraňuje NuGetu v používání balíčků z mezipamětí místních počítačů, pokud je nastavená hodnota true.


disableParallelProcessing - Zakázání paralelního zpracování
boolean. Nepovinný parametr. Použijte, když command = restore. Výchozí hodnota: false.

Zabraňuje NuGetu v instalaci více balíčků v paralelních procesech, pokud je nastavená na truehodnotu .


restoreDirectory - Cílový adresář
Alias vstupu: packagesDirectory. string. Nepovinný parametr. Použijte, když command = restore.

Určuje složku, ve které jsou balíčky nainstalovány. Pokud není zadána žádná složka, balíčky se obnoví do packages/ složky společně s vybraným řešením, packages.confignebo project.json.


verbosityRestore - Podrobnost
string. Nepovinný parametr. Použijte, když command = restore. Povolené hodnoty: Quiet, Normal, Detailed. Výchozí hodnota: Detailed.

Určuje množství podrobností zobrazených ve výstupu.


packagesToPush - Cesta k balíčkům NuGet k publikování
Alias vstupu: searchPatternPush. string. Vyžaduje se, když command = push. Výchozí hodnota: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.

Určuje vzor, který se má shodovat, nebo cestu k souborům nupkg , které se mají nahrát. Více vzorů lze oddělit středníkem.


nuGetFeedType - Umístění cílového kanálu
string. Vyžaduje se, když command = push. Povolené hodnoty: internal (Tato organizace/kolekce) external (externí server NuGet (včetně jiných účtů/kolekcí)). Výchozí hodnota: internal.

Určuje, jestli je cílový informační kanál interním informačním kanálem nebo kolekcí, nebo externím serverem NuGet.


nuGetFeedType - Umístění cílového kanálu
string. Vyžaduje se, když command = push. Povolené hodnoty: internal (tento účet nebo kolekce), external (externí server NuGet (včetně jiných účtů nebo kolekcí)). Výchozí hodnota: internal.

Určuje, jestli je cílový informační kanál interním informačním kanálem nebo kolekcí, nebo externím serverem NuGet.


publishVstsFeed - Cílový informační kanál
Alias vstupu: feedPublish. string. Vyžaduje se, když command = push && nuGetFeedType = internal.

Určuje informační kanál hostovaný v tomto účtu. Abyste mohli vybrat informační kanál, musíte mít nainstalovanou a licencovanou službu Azure Artifacts.


publishPackageMetadata - Publikování metadat kanálu
boolean. Nepovinný parametr. Použijte, když command = push && nuGetFeedType = internal && command = push. Výchozí hodnota: true.

Změní číslo verze podmnožiny změněných balíčků v rámci sady průběžně publikovaných balíčků.


allowPackageConflicts - Povolit přeskočení duplicit
boolean. Nepovinný parametr. Použijte, když command = push && nuGetFeedType = internal. Výchozí hodnota: false.

Hlásí úspěch úkolu, i když jsou některé z vašich balíčků odmítnuty s chybami 409 Konflikt.

Tato možnost je v současné době dostupná jenom u agentů Azure Pipelines a Windows. Pokud NuGet.exe dojde ke konfliktu, úloha selže. Tato možnost nebude fungovat a publikování selže, pokud jste v prostředí proxy serveru.


publishFeedCredentials - Server NuGet
Vstupní alias: externalEndpoint. string. Vyžaduje se, když command = push && nuGetFeedType = external.

Určuje připojení služby NuGet, které obsahuje přihlašovací údaje externího serveru NuGet.


verbosityPush - Podrobnost
string. Nepovinný parametr. Použijte, když command = push. Povolené hodnoty: Quiet, Normal, Detailed. Výchozí hodnota: Detailed.

Určuje množství podrobností zobrazených ve výstupu.


packagesToPack - Cesta k souborům csproj nebo nuspec k zabalení
Vstupní alias: searchPatternPack. string. Vyžaduje se, když command = pack. Výchozí hodnota: **/*.csproj.

Určuje vzor, který úloha používá k hledání adresářů csproj, které se mají zabalit.

Více vzorů můžete oddělit středníkem a vzor můžete vytvořit negativní tak, že ho !předponou předponou . Příklad: **\*.csproj;!**\*.Tests.csproj.


configuration - Konfigurace k zabalení
Vstupní alias: configurationToPack. string. Nepovinný parametr. Použijte, když command = pack. Výchozí hodnota: $(BuildConfiguration).

Určuje konfiguraci, která se má zabalit při použití souboru csproj.


packDestination - Složka balíčku
Vstupní alias: outputDir. string. Nepovinný parametr. Použijte, když command = pack. Výchozí hodnota: $(Build.ArtifactStagingDirectory).

Určuje složku, ve které úloha vytváří balíčky. Pokud je hodnota prázdná, úloha vytvoří balíčky v kořenovém adresáři zdroje.


versioningScheme - Automatická správa verzí balíčků
string. Vyžaduje se, když command = pack. Povolené hodnoty: off, byPrereleaseNumber (Použijte datum a čas), byEnvVar (Použijte proměnnou prostředí), byBuildNumber (Použijte číslo buildu). Výchozí hodnota: off.

Použije automatickou správu verzí balíčků v závislosti na zadané hodnotě. Tento řetězec nelze použít s includeReferencedProjects. Povolené hodnoty jsou následující:

  • byPrereleaseNumber - Použijte datum a čas: Úkol vygeneruje verzi kompatibilní se semVer ve formátu X.Y.Z-ci-datetime, kde zadáte hodnoty X, Y a Z.
  • byEnvVar- Použití proměnné prostředí: Úkol použije proměnnou prostředí, kterou zadáte, a bude obsahovat číslo verze, které chcete použít.
  • byBuildNumber - Použijte číslo sestavení: Úloha použije číslo sestavení k vytvoření verze balíčku.

Poznámka

V části Obecné nastavte formát sestavení na $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).


includeReferencedProjects - Zahrnout odkazované projekty
boolean. Nepovinný parametr. Použijte, když versioningScheme = off && command = pack. Výchozí hodnota: false.

Zahrnuje odkazované projekty buď jako závislosti, nebo jako součást balíčku. Nelze použít s automatickou správou verzí balíčků. Pokud má odkazovaný projekt odpovídající nuspec soubor, který má stejný název jako projekt, pak se odkazovaný projekt přidá jako závislost. V opačném případě se odkazovaný projekt přidá jako součást balíčku. Přečtěte si další informace o vytváření balíčků NuGet pomocí příkazu pack pro rozhraní příkazového řádku NuGet.


versionEnvVar - Proměnná prostředí
string. Vyžaduje se, když versioningScheme = byEnvVar && command = pack.

Určuje název proměnné bez $, $envnebo %.


majorVersion - Hlavní
Vstupní alias: requestedMajorVersion. string. Vyžaduje se, když versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 1.

Ve X verzi X.Y.Z.


minorVersion - Menší
Vstupní alias: requestedMinorVersion. string. Vyžaduje se, když versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 0.

Ve Y verzi X.Y.Z.


patchVersion - Oprava
Vstupní alias: requestedPatchVersion. string. Vyžaduje se, když versioningScheme = byPrereleaseNumber && command = pack. Výchozí hodnota: 0.

Ve Z verzi X.Y.Z.


packTimezone - Časové pásmo
string. Nepovinný parametr. Použijte, když versioningScheme = byPrereleaseNumber && command = pack. Povolené hodnoty: utc, local (místní čas agenta). Výchozí hodnota: utc.

Určuje požadované časové pásmo použité k vytvoření verze balíčku. utc Výběr se doporučuje, pokud používáte agenty hostovaného sestavení, protože jejich datum a čas se můžou lišit.


includeSymbols - Vytvoření balíčku symbolů
boolean. Nepovinný parametr. Použijte, když command = pack. Výchozí hodnota: false.

Určuje, že balíček obsahuje zdroje a symboly. Při použití se souborem .nuspec se tím vytvoří běžný soubor balíčku NuGet a odpovídající balíček symbolů.


toolPackage - Balíček nástrojů
boolean. Nepovinný parametr. Použijte, když command = pack. Výchozí hodnota: false.

Určuje, jestli se výstupní soubory projektu mají nacházet ve složce nástrojů.


buildProperties - Další vlastnosti sestavení
string. Nepovinný parametr. Použijte, když command = pack.

Určuje seznam párů token=hodnota oddělených středníky, kde každý výskyt $token$.nuspec v souboru bude nahrazen danou hodnotou. Hodnoty můžou být řetězce v uvozovkách.


basePath - Základní cesta
string. Nepovinný parametr. Použijte, když command = pack.

Určuje základní cestu k souborům definovaným nuspec v souboru.


verbosityPack - Podrobnost
string. Nepovinný parametr. Použijte, když command = pack. Povolené hodnoty: Quiet, Normal, Detailed. Výchozí hodnota: Detailed.

Určuje množství podrobností zobrazených ve výstupu.


arguments - Příkazy a argumenty
string. Vyžaduje se, když command = custom.

Určuje příkaz a argumenty, které budou předány ke NuGet.exe spuštění. Pokud se použije NuGet 3.5 nebo novější, ověřené příkazy, jako listjsou , restorea publish u všech informačních kanálů v této organizaci nebo kolekci, ke kterým má služba sestavení kolekce projektů přístup, se automaticky ověří.


Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Důležité

Úloha Ověření NuGet je nový doporučený způsob ověřování pomocí Azure Artifacts a dalších úložišť NuGet. Tato úloha už nepřijímá nové funkce a řeší se jenom kritické chyby.

Tuto úlohu použijte k instalaci a aktualizaci závislostí balíčků NuGet nebo k zabalení a publikování balíčků NuGet. Používá NuGet.exe a funguje s aplikacemi .NET Framework. Pro aplikace .NET Core a .NET Standard použijte úlohu .NET Core.

Pokud váš kód závisí na balíčcích NuGet, nezapomeňte tento krok přidat před úlohu sestavení sady Visual Studio. Nezapomeňte také zrušit zaškrtnutí zastaralého políčka Obnovit balíčky NuGet v této úloze.

Pokud pracujete s .NET Core nebo .NET Standard, použijte úlohu .NET Core , která má plnou podporu pro všechny scénáře balíčků a aktuálně ji podporuje dotnet.

Tip

Tato verze úlohy NuGet ve výchozím nastavení používá NuGet 4.1.0. Pokud chcete vybrat jinou verzi NuGetu, použijte Instalační program nástrojů.

Schémata správy verzí

Pro byPrereleaseNumber bude verze nastavena na hodnoty, které zvolíte pro hlavní verzi, podverzi a opravu, plus datum a čas ve formátu yyyymmdd-hhmmss.

Pro byEnvVar bude verze nastavena na hodnotu proměnné prostředí, která má název určený parametrem versionEnvVar , například MyVersion (ne $, pouze název proměnné prostředí). Ujistěte se, že je proměnná prostředí nastavená na správnou hodnotu SemVer, například 1.2.3 nebo 1.2.3-beta1.

Pro byBuildNumber bude verze nastavena pomocí čísla sestavení spuštění kanálu. Jedná se o hodnotu zadanou pro vlastnost kanálu name , která se uloží do BUILD_BUILDNUMBER proměnné prostředí). Ujistěte se, že použité číslo sestavení obsahuje správný semVer, například 1.0.$(Rev:r). Při použití byBuildNumber úloha extrahuje tečkovanou verzi 1.2.3.4, z řetězce čísla sestavení a použije pouze tuto část. Zbytek řetězce se zahodí. Pokud chcete použít číslo sestavení tak, jak je, můžete použít byEnvVar , jak je popsáno výše, a nastavit versionEnvVar na BUILD_BUILDNUMBER.

Migrace z NuGetInstaller@0 nebo NuGetRestore@1

NuGetInstaller@0a NuGetRestore@1 jsou zastaralé a měli byste je ve svém kanálu nahradit .NuGetCommand@2

Pokud jste používali NuGetInstaller@0 s restoreMode: restorenástrojem , při použití NuGetCommand@2nakonfigurujte následující vstupy.

NuGetCommand@2 zadání úkolu Hodnota
command restore
restoreSolution Cesta k souboru .sln

Pokud jste používali NuGetInstaller@0 s restoreMode: installnástrojem , při použití NuGetCommand@2nakonfigurujte následující vstupy.

NuGetCommand@2 zadání úkolu Hodnota
command custom
arguments Jak by vypadal příkaz úplné instalace v rozhraní příkazového řádku NuGet. Pokud například chcete spustit ekvivalent nuget install ninject -OutputDirectory c:\proj ve vašem kanálu, pak arguments by parametr byl install ninject -OutputDirectory c:\proj. Pokud jste používali NuGetInstaller@0nuGetRestoreArgs parametr , tyto parametry teď také přejdou do arguments.

Pokud jste používali NuGetRestore@1, při použití NuGetCommand@2nakonfigurujte následující vstupy.

NuGetCommand@2 zadání úkolu Hodnota
command restore
restoreSolution Cesta k souboru .sln

Podobně jako u možnosti nebo NuGetRestore@1NuGetInstaller@0restoreNuGetCommand@2 má vstupy pro nastavení informačního kanálu, rozhodnout mezi select nebo config, zadat cestu k NuGet.config souboru a použít balíčky z nuget.org.

Další informace najdete v následujících příkladech.

Příklady

Obnovení

Obnovte všechna řešení pomocí balíčků z vybraného informačního kanálu.

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

Balíček

V cílové složce vytvořte balíček NuGet.

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

Push

Poznámka

Artefakty kanálu se stahují do Pipeline.Workspace adresáře a do System.ArtifactsDirectory adresáře pro kanály klasické verze. packagesToPush hodnota může být nastavena na $(Pipeline.Workspace)/**/*.nupkg hodnotu nebo $(System.ArtifactsDirectory)/**/*.nupkg v uvedeném pořadí.

  • Odešlete nebo publikujte balíček do informačního kanálu definovaného v NuGet.config.

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg'
        feedsToUse: 'config'
        nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'
    
  • Nabízení nebo publikování balíčku do informačního kanálu s oborem organizace

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-organization-scoped-feed'
    
  • Vložení nebo publikování balíčku do kanálu s oborem projektu

    # Push a project
    - task: NuGetCommand@2
      inputs:
        command: 'push'
        nuGetFeedType: 'internal'
        publishVstsFeed: 'my-project/my-project-scoped-feed'
    
  • Vložení nebo publikování balíčku do NuGet.org

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

Vlastní

Kromě výchozích příkazů Spusťte všechny další příkazy NuGet: zabalit, nasdílit a obnovit.

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

Požadavky

Požadavek Popis
Typy kanálů YAML, classic build, verze Classic
Spustí se Agent, DeploymentGroup
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.144.0 nebo vyšší
Kategorie úloh Balíček
Požadavek Popis
Typy kanálů YAML, klasický build, klasická verze
Běží na Agent, DeploymentGroup
Požadavky Žádné
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.115.0 nebo vyšší
Kategorie úloh Balíček