다음을 통해 공유

사용자 지정 가능한 Team Foundation Build 속성

  • 아티클

업데이트: 2007년 11월

MSBuild 속성은 빌드를 구성하는 데 사용할 수 있는 키/값 쌍입니다. 자세한 내용은 MSBuild 속성을 참조하십시오.

Microsoft.TeamFoundation.Build.targets 파일은 Team Foundation Build에 대해 몇 가지 MSBuild 대상, 작업 및 속성을 정의합니다. TFSBuild.proj 파일에서 이러한 속성을 다음과 같이 수정할 수 있습니다.

  • Team Foundation Build 작업 및 대상에 값 전달

  • 특정 빌드 작업 재정의

TFSBuld.proj 파일에 대한 자세한 내용은 Team Foundation Build 구성 파일 이해를 참조하십시오.

이 문서에서 다루는 내용

VC++ 빌드 사용자 지정

작업 사용자 지정에 사용되는 속성

재정의할 수 있는 속성

다음 표에서는 Team Foundation Build에 대해 정의된 속성을 보여 줍니다. TfsBuild.proj 파일에서 이러한 속성을 재정의하여 빌드 프로세스를 사용자 지정할 수 있습니다. 자세한 내용은 방법: SolutionToBuild 항목 그룹 사용자 지정을 참조하십시오.

속성

설명

CustomPropertiesForClean

Team Foundation Build에서 Clean 대상을 호출할 때 사용자 지정 값을 모든 솔루션에 전달하려면 이 속성을 설정합니다.

CustomPropertiesForBuild

Team Foundation Build에서 기본 대상(일반적으로 Build)을 호출할 때 사용자 지정 값을 모든 솔루션에 전달하려면 이 속성을 설정합니다.

SkipClean

CoreClean 대상을 건너뛰려면 이 속성을 설정합니다.

IncrementalGet

증분 가져오기를 수행하려면 이 속성을 true로 설정합니다. 이 속성은 CleanCompilationOutputOnly를 true로 설정하고, SkipInitializeWorkspace를 true로 설정하며, ForceGet을 false로 설정하는 편의 속성입니다.

IncrementalBuild

증분 빌드를 수행하려면 이 속성을 true로 설정합니다. 이 속성은 SkipClean을 true로 설정하고, SkipInitializeWorkspace를 true로 설정하며, ForceGet을 false로 설정하는 편의 속성입니다.

CleanCompilationOutputOnly

CoreClean 대상을 실행하는 동안 소스 디렉터리에서 중간 어셈블리만 삭제하려면 이 속성을 true로 설정합니다. 이 속성을 false로 설정하면 CoreClean 대상을 실행하는 동안 전체 소스 디렉터리가 삭제됩니다.

SkipGetChangesetsUpdateWorkItems

빌드가 성공한 경우에 변경 집합의 연결 및 작업 항목 업데이트를 건너뛰려면 이 속성을 true로 설정합니다.

SolutionRoot

빌드 컴퓨터에 있는 소스 폴더의 루트를 가리키도록 하려면 이 속성을 설정합니다.

BinariesRoot

빌드 컴퓨터에 있는 이진 파일 폴더의 루트를 가리키도록 하려면 이 속성을 설정합니다.

LabelComment

Label 작업에 사용되는 주석을 정의하려면 이 속성을 설정합니다.

LabelName

Label 작업에 사용되는 이름을 정의하려면 이 레이블 이름을 설정합니다. 기본적으로 레이블 이름은 InitializeEndToEndIteration 대상에서 $(BuildNumber)로 설정됩니다.

OutDir

빌드 작업 디렉터리에서 출력 파일의 위치를 정의하려면 이 속성을 설정합니다.

UpdateAssociatedWorkItemsOnBuildBreak

빌드가 손상된 경우에도 연결된 작업 항목을 업데이트하려면 이 속성을 true로 설정합니다.

StopOnFirstFailure

빌드를 실행하는 동안 처음 오류가 발생했을 때 정리, 컴파일 및/또는 테스트를 중지하려면 이 속성을 true로 설정합니다.

SkipGet

CoreGet 대상을 건너뛰려면 이 속성을 설정합니다.

SkipLabel

CoreLabel 대상을 건너뛰려면 이 속성을 설정합니다.

SkipInitializeWorkspace

CoreInitializeWorkspace 대상을 건너뛰려면 이 속성을 설정합니다.

SkipInvalidConfigurations

이 속성을 false로 설정하면 잘못된 구성이 나타날 때 경고 대신 오류가 발생합니다.

SkipPostBuild

관련 변경 집합 및 작업 항목을 수집하는 작업을 건너뛰려면 이 속성을 설정합니다.

SkipDropBuild

CoreDropBuild 대상을 건너뛰려면 이 속성을 설정합니다.

SkipWorkItemCreation

CoreCreateWorkItem 대상을 건너뛰려면 이 속성을 설정합니다.

CustomizableOutDir

Team Foundation Build에서 각 솔루션의 OutDir을 설정하지 않게 하려는 경우 이 속성을 true로 설정합니다. CustomizablePublishDir을 false로 설정하는 경우 TeamBuildPublishDir 속성을 사용하여 Team Foundation Build에서 PublishDir에 할당하려고 했던 값을 검색할 수 있습니다.

CustomizablePublishDir

Team Foundation Build에서 각 솔루션의 PublishDir 디렉터리를 설정하지 않게 하려는 경우 이 속성을 true로 설정합니다. CustomizablePublishDir을 false로 설정하는 경우 TeamBuildPublishDir 속성을 사용하여 Team Foundation Build에서 PublishDir에 할당하려고 했던 값을 검색할 수 있습니다.

VC++ 빌드 사용자 지정

Team Foundation Build에서는 Visual C++ 프로젝트의 빌드를 사용자 지정할 수도 있습니다. Visual C++ 프로젝트를 빌드하기 위해 다음 속성을 사용하여 MSBuild에서 사용하는 VCBuild 작업에 대해 해당 속성을 설정할 수 있습니다. 자세한 내용은 VCBuild 작업을 참조하십시오.

팀 빌드 속성

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>

참고 항목

작업

방법: 빌드 시 환경 변수 사용

개념

Team Foundation Build 구성 파일 이해