VSBuild@1 - Visual Studio 빌드 v1 작업

이 작업을 사용하여 MSBuild를 빌드하고 Visual Studio 버전 속성을 설정합니다. Azure Visual Studio 이미지를 설치하는 방법에 대해 자세히 알아봅니다.

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

solution - 솔루션
string; 필수 사항입니다. 기본값은 **\*.sln입니다.

빌드 프로세스에서 사용할 작업에 대한 솔루션을 지정합니다.

단일 솔루션을 빌드하려면 ... 단추를 클릭하고 솔루션을 지정합니다.

여러 솔루션을 빌드하려면 검색 조건을 지정합니다. 단일 폴더 와일드카드(*) 및 재귀 와일드카드(**)를 사용할 수 있습니다. 예를 들어 **.sln 모든 하위 디렉터리의 모든 .sln 파일을 검색합니다.

지정한 솔루션이 이 빌드 파이프라인에서 다운로드되었는지 확인합니다. 리포지토리 탭에서 다음을 수행합니다.

• TFVC를 사용하는 경우 솔루션이 리포지토리 탭의 매핑 중 하나의 자식인지 확인합니다.
• Git을 사용하는 경우 프로젝트 또는 솔루션이 Git 리포지토리 및 빌드 중인 분기에 있는지 확인합니다.

Visual Studio 버전vsVersion -
string; 허용되는 값은 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)입니다. 기본값은 latest입니다.

이 입력의 값은 솔루션을 만드는 데 사용되는 Visual Studio 버전과 일치해야 합니다.

빌드에서 실행하는 MSBuild 명령에 /p:VisualStudioVersion={numeric_visual_studio_version} 인수를 추가합니다. 예를 들어 Visual Studio 2015 지정하면 MSBuild 명령에 /p:VisualStudioVersion=14.0 추가됩니다.

azure Pipelines : 팀에서 Microsoft 호스팅 에이전트와 함께 Visual Studio를 사용하려는 경우 windows-latest 기본 빌드 풀로 선택합니다. Microsoft 호스팅 에이전트 참조하세요.

Visual Studio 버전vsVersion -
string; 허용되는 값은 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)입니다. 기본값은 latest입니다.

이 입력의 값은 솔루션을 만드는 데 사용되는 Visual Studio 버전과 일치해야 합니다.

빌드에서 실행하는 MSBuild 명령에 /p:VisualStudioVersion={numeric_visual_studio_version} 인수를 추가합니다. 예를 들어 Visual Studio 2015 지정하면 MSBuild 명령에 /p:VisualStudioVersion=14.0 추가됩니다.

azure Pipelines : 팀에서 Microsoft 호스팅 에이전트와 함께 Visual Studio를 사용하려는 경우 windows-latest 기본 빌드 풀로 선택합니다. Microsoft 호스팅 에이전트 참조하세요.

MSBuild 인수msbuildArgs -
string;

MSBuild에 추가 인수를 전달합니다. 구문은 MSBuild Command-Line 참조 참조하세요.

platform - 플랫폼
string;

빌드하려는 플랫폼(예: Win32, x86, x64또는 any cpu지정합니다.

configuration - 구성
string;

빌드하려는 구성(예: debug 또는 release)을 지정합니다.

clean - 정리
boolean; 기본값은 false입니다.

false설정하면 태스크가 증분 빌드를 수행합니다. 이 설정은 특히 코드베이스가 큰 경우 빌드 시간을 줄일 수 있습니다. 이 옵션은 정리 리포지토리를 false설정하지 않는 한 실제로 효과가 없습니다.

true설정하면 태스크는 코드 프로젝트의 모든 코드를 다시 빌드합니다. 이는 MSBuild /target:clean 인수와 동일합니다.

병렬빌드 maximumCpuCount -
boolean; 기본값은 false입니다.

선택 사항. MSBuild 대상 구성이 빌드와 병렬로 호환되는 경우 이 입력을 확인하여 msBuild에 /m 스위치를 전달할 수 있습니다(Windows에만 해당). 대상 구성이 빌드와 병렬로 호환되지 않는 경우 이 옵션을 선택하면 빌드에서 사용 중인 파일 오류가 발생하거나 간헐적이거나 일관되지 않은 빌드 오류가 발생할 수 있습니다.

NuGet 패키지복원 restoreNugetPackages -
boolean; 기본값은 false입니다.

이 입력은 더 이상 사용되지 않습니다. NuGet 패키지를 복원하려면 빌드 전에 NuGet 도구 설치 관리자 작업을 추가합니다.

MSBuild 아키텍처msbuildArchitecture -
string; 허용되는 값: x86(MSBuild x86), x64(MSBuild x64). 기본값은 x86입니다.

선택 사항. 실행할 MSBuild의 아키텍처(x86 또는 x64)를 제공합니다.

logProjectEvents - 레코드 프로젝트 세부 정보
boolean; 기본값은 true입니다.

선택 사항. 각 프로젝트에 대한 타임라인 세부 정보를 기록합니다.

로그 파일만들기 createLogFile -
boolean; 기본값은 false입니다.

선택 사항. 로그 파일을 만듭니다(Windows에만 해당).

로그 파일 세부 정보 표시logFileVerbosity -
string; 선택 사항. createLogFile = true때 사용합니다. 허용되는 값: quiet, minimal, normal, detailed, diagnostic. 기본값은 normal입니다.

로그 파일의 세부 정보 표시 수준을 지정합니다.

enableDefaultLogger - 기본 로거 사용
boolean; 기본값은 true입니다.

true설정하면 MSBuild에 대한 기본 로거를 사용하도록 설정합니다.

사용자 지정 버전
string;

Visual Studio의 사용자 지정 버전을 설정합니다. 예: 15.0, 16.0, 17.0. 필요한 버전의 Visual Studio를 시스템에 설치해야 합니다.

Azure Pipelines: 팀에서 Microsoft 호스팅 에이전트와 함께 Visual Studio 2022를 사용하려는 경우 기본 빌드 풀로 windows-2022 선택합니다. 자세한 내용은 Microsoft 호스팅 에이전트 참조하세요.

없음.