사용자 지정 가능한 Team Foundation Build 속성
MSBuild 속성은 빌드를 구성하는 데 사용할 수 있는 키/값 쌍입니다. 자세한 내용은 MSBuild 속성을 참조하십시오.
Microsoft.TeamFoundation.Build.targets 파일은 Team Foundation Build에 대해 몇 가지 MSBuild 대상, 작업 및 속성을 정의합니다. TFSBuild.proj 파일에서 이러한 속성을 다음과 같이 수정할 수 있습니다.
Team Foundation Build 작업 및 대상에 값 전달
특정 빌드 작업 재정의
TFSBuld.proj 파일에 대한 자세한 내용은 Team Foundation Build 구성 파일 이해를 참조하십시오.
이 문서에서 다루는 내용
Visual C++ 빌드 사용자 지정
작업 사용자 지정에 사용되는 속성
재정의할 수 있는 속성
다음 표에서는 Team Foundation Build에 대해 정의된 속성을 보여 줍니다. TfsBuild.proj 파일에서 이러한 속성을 재정의하여 빌드 프로세스를 사용자 지정할 수 있습니다. 자세한 내용은 SolutionToBuild 항목 그룹 사용자 지정을 참조하십시오.
Property |
설명 |
|---|---|
BinariesRoot |
빌드 컴퓨터에 있는 이진 파일 폴더의 루트를 가리키도록 하려면 이 속성을 설정합니다. |
CleanCompilationOutputOnly |
CoreClean 대상을 실행하는 동안 소스 디렉터리에서 중간 어셈블리만 삭제하려면 이 속성을 true로 설정합니다. 이 속성을 false로 설정하면 CoreClean 대상을 실행하는 동안 전체 소스 디렉터리가 삭제됩니다. |
CustomizableOutDir |
Team Foundation Build에서 각 솔루션의 OutDir을 설정하지 않게 하려는 경우 이 속성을 true로 설정합니다. TeamBuildOutDir 속성을 사용하여 CustomizableOutDir이 false로 설정된 경우 Team Foundation Build에서 PublishDir에 할당할 값을 검색할 수 있습니다. |
CustomizablePublishDir |
Team Foundation Build에서 각 솔루션의 PublishDir 디렉터리를 설정하지 않게 하려는 경우 이 속성을 true로 설정합니다. CustomizablePublishDir을 false로 설정하는 경우 TeamBuildPublishDir 속성을 사용하여 Team Foundation Build에서 PublishDir에 할당하려고 했던 값을 검색할 수 있습니다. |
CustomPropertiesForBuild |
Team Foundation Build에서 기본 대상(일반적으로 Build)을 호출할 때 사용자 지정 값을 모든 솔루션에 전달하려면 이 속성을 설정합니다. |
CustomPropertiesForClean |
Team Foundation Build에서 Clean 대상을 호출할 때 사용자 지정 값을 모든 솔루션에 전달하려면 이 속성을 설정합니다. |
GetAllowUnmapped |
보류 집합에 매핑되지 않은 파일이 있는 경우 빌드가 실패하도록 하려면 이 속성을 false로 설정합니다(제어된 체크 인 및 개인 빌드의 경우). |
GetAutoMerge |
제어된 체크 인 또는 전용 빌드에서 버전 제어 가져오기 작업 중 충돌이 발생할 경우 빌드가 실패하도록 하려면 이 속성을 false로 설정합니다. |
GetNoCIOption |
제어된 체크인 빌드를 실행할 때 체크 인 설명에서 ***NO_CI*** 문자열의 삽입을 제외하려면 이 속성을 false로 설정합니다. 이 속성을 false로 설정하면 영향을 받는 연속된 통합 빌드가 큐에서 대기하게 됩니다. |
IncrementalBuild |
증분 빌드를 수행하려면 이 속성을 true로 설정합니다. 이 속성은 SkipClean을 true로 설정하고, SkipInitializeWorkspace를 true로 설정하며, ForceGet을 false로 설정하는 편의 속성입니다. |
IncrementalGet |
증분 가져오기를 수행하려면 이 속성을 true로 설정합니다. 이 속성은 CleanCompilationOutputOnly를 true로 설정하고, SkipInitializeWorkspace를 true로 설정하며, ForceGet을 false로 설정하는 편의 속성입니다. |
LabelComment |
Label 작업에 사용되는 주석을 정의하려면 이 속성을 설정합니다. |
LabelName |
Label 작업에 사용되는 이름을 정의하려면 이 레이블 이름을 설정합니다. 기본적으로 이 레이블 이름은 InitializeEndToEndIteration 대상에서 $(BuildNumber)로 설정됩니다. |
OutDir |
빌드 작업 디렉터리에서 출력 파일의 위치를 정의하려면 이 속성을 설정합니다. |
PerformTestImpactAnalysis |
테스트 영향 분석을 사용하지 않으려면 이 속성을 false로 설정합니다. |
PublishTestResults |
테스트 결과 게시를 건너뛰려면 이 속성을 false로 설정합니다. |
SkipClean |
CoreClean 대상을 건너뛰려면 이 속성을 설정합니다. |
SkipDropBuild |
CoreDropBuild 대상을 건너뛰려면 이 속성을 설정합니다. |
SkipGet |
CoreGet 대상을 건너뛰려면 이 속성을 설정합니다. |
SkipGetChangesetsAndUpdateWorkItems |
빌드가 성공한 경우에 변경 집합의 연결 및 작업 항목 업데이트를 건너뛰려면 이 속성을 true로 설정합니다. |
SkipInitializeWorkspace |
CoreInitializeWorkspace 대상을 건너뛰려면 이 속성을 설정합니다. |
SkipInvalidConfigurations |
구성이 잘못되었을 때 경고 대신 오류를 생성하려면 이 속성을 false로 설정합니다. |
SkipLabel |
CoreLabel 대상을 건너뛰려면 이 속성을 설정합니다. |
SkipPostBuild |
관련 변경 집합 및 작업 항목을 수집하는 작업을 건너뛰려면 이 속성을 설정합니다. |
SkipWorkItemCreation |
CoreCreateWorkItem 대상을 건너뛰려면 이 속성을 설정합니다. |
SolutionRoot |
빌드 컴퓨터에 있는 소스 폴더의 루트를 가리키도록 하려면 이 속성을 설정합니다. |
StopOnFirstFailure |
빌드를 실행하는 동안 첫 번째 오류가 발생했을 때 정리, 컴파일 및/또는 테스트를 중지하려면 이 속성을 true로 설정합니다. |
UpdateAssociatedWorkItemsOnBuildBreak |
빌드가 손상된 경우에도 연결된 작업 항목을 업데이트하려면 이 속성을 true로 설정합니다. |
Visual C++ 빌드 사용자 지정
Team Foundation Build에서는 Visual C++ 9.0 프로젝트의 빌드를 사용자 지정할 수도 있습니다. Visual C++ 프로젝트를 빌드하기 위해 다음 속성을 사용하여 MSBuild에서 사용하는 VCBuild 작업에 대해 해당 속성을 설정할 수 있습니다. 자세한 내용은 VCBuild Task을 참조하십시오.
팀 빌드 속성 |
VCBuild 작업 속성 |
설명 |
|---|---|---|
VCBuildAdditionalLibPaths |
AdditionalLibPaths |
LIB 환경 변수 경로가 검색되기 전에 라이브러리 검색을 위한 추가 경로를 지정합니다(LINK.exe에 대한 LIBPATH 옵션에 해당). |
VCBuildAdditionalOptions |
AdditionalOptions |
전용 작업 매개 변수가 없는 추가 명령줄 옵션을 지정합니다. |
VCBuildToolPath |
ToolPath |
VCBuild 작업에서 내부 실행 파일(VCBuild.exe)을 로드할 위치를 지정합니다. |
VCBuildUseEnvironment |
UseEnvironment |
이 속성을 true로 설정하여 PATH, INCLUDE, LIBS 및 LIBPATH에 대한 환경 변수를 사용합니다. 그렇지 않으면 false로 설정합니다. 이 속성은 VCBuild.exe의 /useenv 옵션에 해당합니다. 자세한 내용은 /useenv를 참조하십시오. |
AdditionalVCOverrides |
없음 |
Team Foundation Build에서 생성하고 VCBuild 작업의 Override 속성에서 지정한 VCBuild 작업 시트 파일의 추가 옵션을 지정하려면 이 속성을 사용합니다. |
작업 사용자 지정에 사용되는 속성
Microsoft.TeamFoundation.Build.targets 파일에 있는 각각의 기본 Team Foundation Build 작업에는 작업을 사용자 지정하는 데 사용할 수 있는 속성 집합도 포함되어 있습니다. Team Foundation Build 작업에 대한 자세한 내용은 Team Foundation Build 작업을 참조하십시오. 예를 들어 CreateNewWorkItem 작업은 다음과 같이 정의됩니다.
<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
BuildUri="$(BuildUri)"
BuildNumber="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
Title="$(WorkItemTitle)"
WorkItemFieldValues="$(WorkItemFieldValues)"
WorkItemType="$(WorkItemType)"
ContinueOnError="true" />
빌드가 실패할 경우 만들어지는 작업 항목을 사용자 지정하려면 TFSBuild.proj 파일에서 WorkItemFieldValues를 설정합니다.
참고
다음 예제에서는 Areapath 및 IterationPath 속성도 설정되어 있다고 가정합니다.
<WorkItemFieldValues>Area Path=$(AreaPath);Iteration Path=$(IterationPath);Severity=1;Priority=0;Symptom=build break;Steps To Reproduce=Start the build using Team Build;Source=Development;How Found=Build Break;Assigned To=Active</WorkItemFieldValues>