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.

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

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

řešení solution -
string. Povinné. 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 (**). Například **.sln hledá 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ým mapováním na kartě Úložiště.
• Pokud používáte Git, ujistěte se, že se projekt nebo řešení nachází v úložišti Git a ve větvi, kterou vytváříte.

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í vašeho řešení.

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

azure Pipelines: Pokud váš tým chce používat Visual Studio s agenty hostovanými Microsoftem, vyberte jako výchozí fond sestavení nejnovější windows. Viz agenty hostované Microsoftem.

vsVersion - verze sady Visual Studio
string. Povolené hodnoty: latest, 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í vašeho řešení.

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

azure Pipelines: Pokud váš tým chce používat Visual Studio s agenty hostovanými Microsoftem, vyberte jako výchozí fond sestavení nejnovější windows. Viz agenty hostované Microsoftem.

msbuildArgs - argumenty nástroje MSBuild
string.

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

platformy platform -
string.

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

konfigurace configuration -
string.

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

clean - Clean
boolean. Výchozí hodnota: false.

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

Pokud je nastavena hodnota true, úloha znovu sestaví veškerý kód v projektech kódu. Je to ekvivalent argumentu /target:clean nástroje MSBuild.

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

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

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

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

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

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

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

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

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

Volitelný. Vytvoří soubor protokolu (jenom Windows).

logFileVerbosity - podrobností souboru protokolu
string. Volitelný. Používá se při 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ího nástroje
boolean. Výchozí hodnota: true.

Pokud je nastavena na true, povolí výchozí protokolovací nástroj pro NÁSTROJ MSBuild.

vlastní verze
string.

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

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

Žádné.