VSBuild@1 — zadanie kompilacji programu Visual Studio w wersji 1

Artykuł
03/24/2025

To zadanie służy do kompilowania za pomocą programu MSBuild i ustawiania właściwości wersji programu Visual Studio. Dowiedz się więcej o instalowaniu obrazów programu Visual Studio na platformie Azure.

Składnia

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

Dane wejściowe

solution - Solution
string. To jest wymagane. Wartość domyślna: **\*.sln.

Określa rozwiązanie, które ma być używane przez zadanie w procesie kompilacji.

Jeśli chcesz utworzyć jedno rozwiązanie, kliknij przycisk ... i określ rozwiązanie.

Jeśli chcesz utworzyć wiele rozwiązań, określ kryteria wyszukiwania. Symbol wieloznaczny z jednym folderem (*) i cykliczne symbole wieloznaczne (**). Na przykład **.sln wyszukuje wszystkie pliki .sln we wszystkich podkatalogach.

Upewnij się, że określone rozwiązania są pobierane przez ten potok kompilacji. Na karcie Repozytorium:

Jeśli używasz kontrolera TFVC, upewnij się, że rozwiązanie jest elementem podrzędnym jednego z mapowań na karcie Repozytorium.
Jeśli używasz usługi Git, upewnij się, że projekt lub rozwiązanie znajduje się w repozytorium Git i w gałęzi, którą tworzysz.

Wskazówka

Można również tworzyć pliki projektu MSBuild (.*proj).
Jeśli tworzysz dostosowany plik projektu MSBuild, zalecamy użycie zadania MSBuild zamiast zadania Kompilacja programu Visual Studio.

vsVersion - wersji programu Visual Studio
string. Dozwolone wartości: 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). Wartość domyślna: latest.

Wartość tych danych wejściowych musi być zgodna z wersją programu Visual Studio użytą do utworzenia rozwiązania.

Dodaje argument /p:VisualStudioVersion={numeric_visual_studio_version} do polecenia MSBuild uruchamiane przez kompilację. Jeśli na przykład określisz visual studio 2015, /p:VisualStudioVersion=14.0 zostanie dodany do polecenia MSBuild.

azure Pipelines: jeśli twój zespół chce używać programu Visual Studio z agentami hostowanymi przez firmę Microsoft, wybierz najnowsze jako domyślną pulę kompilacji. Zobacz agentów hostowanych przez firmę Microsoft.

vsVersion - wersji programu Visual Studio
string. Dozwolone wartości: 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). Wartość domyślna: latest.

Wartość tych danych wejściowych musi być zgodna z wersją programu Visual Studio użytą do utworzenia rozwiązania.

msbuildArgs - argumenty MSBuild
string.

Przekazuje dodatkowe argumenty do programu MSBuild. Aby uzyskać informacje na temat składni, zobacz Command-Line Dokumentacja programu MSBuild.

platformy platform -
string.

Określa platformę, którą chcesz skompilować, taką jak Win32, x86, x64lub any cpu.

Wskazówka

Jeśli używasz pliku projektu MSBuild (.*proj) zamiast rozwiązania, określ AnyCPU (bez białych znaków).
Zadeklaruj zmienną kompilacji, taką jak BuildPlatform na karcie Zmienne (wybierając pozycję Zezwalaj w czasie kolejki) i odwołuj się do niej tutaj jako $(BuildPlatform). Dzięki temu można modyfikować platformę podczas kolejkowania kompilacji i włączania kompilowania wielu konfiguracji.

konfiguracji configuration -
string.

Określa konfigurację, którą chcesz skompilować, na przykład debug lub release.

Wskazówka

Zadeklaruj zmienną kompilacji, taką jak BuildConfiguration na karcie Zmienne (wybierając pozycję Zezwalaj w czasie kolejki) i odwołuj się do niej tutaj jako $(BuildConfiguration). Dzięki temu można modyfikować platformę podczas kolejkowania kompilacji i włączania kompilowania wielu konfiguracji.

clean - Czyszczenie
boolean. Wartość domyślna: false.

Jeśli ustawiono wartość false, zadanie wykonuje kompilację przyrostową. To ustawienie może skrócić czas kompilacji, zwłaszcza jeśli baza kodu jest duża. Ta opcja nie ma praktycznego wpływu, chyba że ustawisz również repozytorium Clean na wartość false.

Jeśli ustawiono wartość true, zadanie ponownie kompiluje cały kod w projektach kodu. Jest to odpowiednik argumentu /target:clean MSBuild.

maximumCpuCount - kompilacji równoległej
boolean. Wartość domyślna: false.

Opcjonalny. Jeśli konfiguracja docelowa programu MSBuild jest zgodna z równoległym tworzeniem, możesz sprawdzić te dane wejściowe, aby przekazać przełącznik /m do programu MSBuild (tylko system Windows). Jeśli konfiguracja docelowa nie jest zgodna z równoległym kompilowaniem, sprawdzenie tej opcji może spowodować, że kompilacja spowoduje błędy użycia plików lub sporadyczne lub niespójne błędy kompilacji.

restoreNugetPackages - przywracanie pakietów NuGet
boolean. Wartość domyślna: false.

Te dane wejściowe są przestarzałe. Aby przywrócić pakiety NuGet, przed kompilacją dodaj zadanie Instalatora narzędzi NuGet.

architektury msbuildArchitecture - MSBuild
string. Dozwolone wartości: x86 (MSBuild x86), x64 (MSBuild x64). Wartość domyślna: x86.

Opcjonalny. Dostarcza architekturę (x86 lub x64) programu MSBuild do uruchomienia.

Wskazówka

Ponieważ program Visual Studio działa jako aplikacja 32-bitowa, mogą wystąpić problemy podczas przetwarzania kompilacji przez agenta kompilacji z uruchomioną 64-bitową wersją usługi Team Foundation Build Service. Wybierając pozycję MSBuild x86, możesz rozwiązać te problemy.

logProjectEvents - rejestrowanie szczegółów projektu
boolean. Wartość domyślna: true.

Opcjonalny. Rejestruje szczegóły osi czasu dla każdego projektu.

createLogFile - tworzenie pliku dziennika
boolean. Wartość domyślna: false.

Opcjonalny. Tworzy plik dziennika (tylko system Windows).

logFileVerbosity - pliku dziennika
string. Opcjonalny. Użyj polecenia , gdy createLogFile = true. Dozwolone wartości: quiet, minimal, normal, detailed, diagnostic. Wartość domyślna: normal.

Określa poziom szczegółowości w plikach dziennika.

enableDefaultLogger - włącz domyślny rejestratora
boolean. Wartość domyślna: true.

Jeśli ustawiono wartość true, włącza domyślny rejestrator programu MSBuild.

customVersion - wersja niestandardowa
string.

Ustawia niestandardową wersję programu Visual Studio. Przykłady: 15.0, 16.0, 17.0. Wymagana wersja programu Visual Studio musi być zainstalowana w systemie.

azure Pipelines: jeśli twój zespół chce używać programu Visual Studio 2022 z agentami hostowanymi przez firmę Microsoft, wybierz windows-2022 jako domyślną pulę kompilacji. Aby uzyskać więcej informacji, zobacz agentów hostowanych przez firmę Microsoft.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

Żaden.

Uwagi

Dowiedz się więcej o instalowaniu obrazów programu Visual Studio na platformie Azure.

Ważne

To zadanie jest obsługiwane tylko w przypadku agentów z systemem Windows.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości, które są zgodne z następującymi wymaganiami do uruchamiania zadań korzystających z tego zadania: msbuild, visualstudio
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	1.95.0 lub nowsza
Kategoria zadań	Zbuduj

Udostępnij za pośrednictwem

VSBuild@1 — zadanie kompilacji programu Visual Studio w wersji 1

Składnia

Dane wejściowe

Opcje sterowania zadaniami

Zmienne wyjściowe

Uwagi

Wymagania

Opinia

Dodatkowe zasoby