VSBuild@1 – úloha sestavení sady Visual Studio v1

Tuto úlohu použijte k sestavení pomocí nástroje MSBuild a nastavení vlastnosti verze sady Visual Studio. Přečtěte si další informace o instalaci imagí sady Visual Studio v Azure.

Syntax

# Visual Studio build v1
# Build with MSBuild and set the Visual Studio version property.
- task: VSBuild@1
  inputs:
    solution: '**\*.sln' # string. Required. Solution. Default: **\*.sln.
    #vsVersion: 'latest' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '11.0'. Visual Studio Version. Default: latest.
    #msbuildArgs: # string. MSBuild Arguments. 
    #platform: # string. Platform. 
    #configuration: # string. Configuration. 
    #clean: false # boolean. Clean. Default: false.
  # Advanced
    #maximumCpuCount: false # boolean. Build in Parallel. Default: false.
    #restoreNugetPackages: false # boolean. Restore NuGet Packages. Default: false.
    #msbuildArchitecture: 'x86' # 'x86' | 'x64'. MSBuild Architecture. Default: x86.
    #logProjectEvents: true # boolean. Record Project Details. Default: true.
    #createLogFile: false # boolean. Create Log File. Default: false.
    #logFileVerbosity: 'normal' # 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic'. Optional. Use when createLogFile = true. Log File Verbosity. Default: normal.
    #enableDefaultLogger: true # boolean. Enable Default Logger. Default: true.
    #customVersion: # string. Custom Version.

Vstupy

solution - Řešení
string. Povinná hodnota. Výchozí hodnota: **\*.sln.

Určuje řešení pro úlohu, která se má použít v procesu sestavení.

Pokud chcete vytvořit jedno řešení, klikněte na tlačítko ... a zadejte řešení.

Pokud chcete vytvořit více řešení, zadejte kritéria hledání. Můžete použít zástupný znak s jednou složkou (*) a rekurzivní zástupné cardy (**). Vyhledá například **.sln všechny soubory .sln ve všech podadresářích.

Ujistěte se, že zadaná řešení jsou stažena tímto kanálem buildu. Na kartě Úložiště:

• Pokud používáte TFVC, ujistěte se, že řešení je podřízené jednomu z mapování na kartě Úložiště.
• Pokud používáte Git, ujistěte se, že se projekt nebo řešení nachází ve vašem úložišti Git a ve větvi, kterou vytváříte.

Tip

• Můžete také vytvořit soubory projektu MSBuild (.*proj).
• Pokud vytváříte přizpůsobený soubor projektu MSBuild, doporučujeme místo úlohy Sestavení sady Visual Studio použít úlohu MSBuild.

vsVersion - Verze sady Visual Studio
string. Povolené hodnoty: latest, 17.0 (Visual Studio 2022), 16.0 (Visual Studio 2019), 15.0 (Visual Studio 2017), 14.0 (Visual Studio 2015), 12.0 (Visual Studio 2013) 11.0 (Visual Studio 2012). Výchozí hodnota: latest.

Hodnota tohoto vstupu se musí shodovat s verzí sady Visual Studio použitou k vytvoření řešení.

/p:VisualStudioVersion={numeric_visual_studio_version} Přidá argument do příkazu MSBuild spuštěného sestavením. Pokud například zadáte Visual Studio 2015, /p:VisualStudioVersion=14.0 přidá se do příkazu MSBuild.

Azure Pipelines: Pokud váš tým chce používat Visual Studio s agenty hostovanými Microsoftem, vyberte windows-latest jako výchozí fond sestavení. Viz Agenti hostovaní Microsoftem.

msbuildArgs - Argumenty nástroje MSBuild
string.

Předá do nástroje MSBuild další argumenty. Syntaxi najdete v referenčních informacích k nástroji MSBuild Command-Line.

platform - Platforma
string.

Určuje platformu, kterou chcete vytvořit, například Win32, x86, x64nebo any cpu.

Tip

• Pokud cílíte na soubor projektu MSBuild (.*proj) místo řešení, zadejte AnyCPU (bez prázdných znaků).
• Deklarujte proměnnou sestavení, například BuildPlatform na kartě Proměnné (vyberte Povolit v čase fronty) a tady na ni odkazujte jako $(BuildPlatform). Tímto způsobem můžete upravit platformu při vytváření fronty sestavení a povolit vytváření více konfigurací.

configuration - Konfigurace
string.

Určuje konfiguraci, kterou chcete sestavit, například debug nebo release.

Tip

Deklarujte proměnnou sestavení, například BuildConfiguration na kartě Proměnné (vyberte Povolit v čase fronty) a tady na ni odkazujte jako $(BuildConfiguration). Tímto způsobem můžete upravit platformu při vytváření fronty sestavení a povolit vytváření více konfigurací.

clean - Čisté
boolean. Výchozí hodnota: false.

Pokud je tato možnost nastavená na false, úkol vytvoří přírůstkové sestavení. Toto nastavení může zkrátit dobu sestavení, zejména pokud je váš základ kódu velký. Tato možnost nemá žádný praktický účinek, pokud také nenastavíte čisté úložiště na falsehodnotu .

Pokud je nastaveno na true, úkol znovu sestaví veškerý kód v projektech kódu. To je ekvivalent k argumentu MSBuild /target:clean .

maximumCpuCount - Paralelní sestavení
boolean. Výchozí hodnota: false.

Nepovinný parametr. Pokud je cílová konfigurace NÁSTROJE MSBuild kompatibilní s paralelním sestavováním, můžete tento vstup zkontrolovat a předat /m přepínač do nástroje MSBuild (pouze Windows). Pokud vaše cílová konfigurace není kompatibilní s paralelním sestavováním, může kontrola této možnosti způsobit, že sestavení způsobí chyby při použití souboru nebo občasná nebo nekonzistentní selhání sestavení.

restoreNugetPackages - Obnovení balíčků NuGet
boolean. Výchozí hodnota: false.

Tento vstup je zastaralý. Pokud chcete obnovit balíčky NuGet, přidejte před sestavení úlohu Instalační program nástrojů NuGet .

msbuildArchitecture - Architektura NÁSTROJE MSBuild
string. Povolené hodnoty: x86 (MSBuild x86), x64 (MSBuild x64). Výchozí hodnota: x86.

Nepovinný parametr. Poskytuje architekturu (x86 nebo x64) nástroje MSBuild ke spuštění.

Tip

Vzhledem k tomu, že Visual Studio běží jako 32bitová aplikace, může dojít k problémům při zpracování sestavení agentem sestavení, který používá 64bitovou verzi služby Team Foundation Build Service. Výběrem nástroje MSBuild x86můžete tyto problémy vyřešit.

logProjectEvents - Záznam podrobností projektu
boolean. Výchozí hodnota: true.

Nepovinný parametr. Zaznamenává podrobnosti časové osy pro každý projekt.

createLogFile - Vytvoření souboru protokolu
boolean. Výchozí hodnota: false.

Nepovinný parametr. Vytvoří soubor protokolu (jenom Windows).

logFileVerbosity - Podrobnosti o souboru protokolu
string. Nepovinný parametr. Použijte, když createLogFile = true. Povolené hodnoty: quiet, minimal, normal, detailed, . diagnostic Výchozí hodnota: normal.

Určuje úroveň podrobností v souborech protokolu.

enableDefaultLogger - Povolit výchozí protokolovací nástroj
boolean. Výchozí hodnota: true.

Pokud je nastavená hodnota true, povolí výchozí protokolovací nástroj pro nástroj MSBuild.

customVersion - Vlastní verze
string.

Nastaví vlastní verzi sady Visual Studio. Příklady: 15.0, 16.0, 17.0. Požadovaná verze sady Visual Studio musí být nainstalovaná v systému.

Azure Pipelines: Pokud váš tým chce používat Visual Studio 2022 s agenty hostovanými Microsoftem, vyberte windows-2022 jako výchozí fond sestavení. Další informace najdete v tématu Agenti hostovaní Microsoftem.

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ích prvků a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Přečtěte si další informace o instalaci imagí sady Visual Studio v Azure.

Důležité

Tato úloha je podporovaná jenom u agentů s Windows.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasický build
Běží na	Agent, DeploymentGroup
Požadavky	Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na spouštění úloh, které používají tuto úlohu: msbuild, visualstudio
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	1.95.0 nebo vyšší
Kategorie úloh	Sestavení