표준 및 사용자 지정 도구 집합 구성

MSBuild 도구 작업, 대상 및 응용 프로그램 프로젝트를 만드는 데 사용할 수 있는 도구를 포함 합니다.표준 도구 집합에서 MSBuild 포함 되지만 사용자 지정 도구 집합을 만들 수도 있습니다.도구 집합을 지정 하는 방법에 대 한 내용은 참조 하십시오.MSBuild 도구 집합(ToolsVersion)

표준 도구 집합 구성

MSBuild4.5에는 다음과 같은 표준 도구 집합이 포함 되어 있습니다.

ToolsVersion 값을 결정 하는 도구 집합을 사용 하 여 Visual Studio 생성 하는 프로젝트입니다.지정은 ToolsVersion 특성으로는 프로젝트 프로젝트 파일의 요소를 사용 하 여 해당 특성이 재정의할 수 있습니다의 /toolsversion 전환 명령 프롬프트.이 특성,이 스위치를 지정 하는 다른 방법에 대 한 정보는 ToolsVersion을 참조 하십시오 ToolsVersion 설정 재정의.

경우는 ToolsVersion 지정 되지 않은 경우 다음에 키를 정의 된 ToolsVersion.

다음 레지스트리 키 각에 관련 된.NET Framework 버전의 설치 경로 지정 합니다. ToolsVersion.또한 설치 경로 MSBuild.exe 도구 집합 정보를 정의의 위치를 지정 합니다.

하위 도구 집합

이전 테이블의 레지스트리 키에 하위 키가 있으면 Msbuild의 더 많은 도구를 포함 하는 하위 도구 경로 확인을 사용 합니다.다음 하위 키의 예를 들면 다음과 같습니다.

\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSBuild\ToolsVersions\4.0\11.0

VisualStudioVersion 빌드 속성 하위 도구 집합 활성화 여부를 나타냅니다.예를 들어 있는 VisualStudioVersion "11.0" 값 4.5.NET Framework sub 도구 집합을 지정 합니다.자세한 내용은 하위 도구 섹션의 MSBuild 도구 집합(ToolsVersion).

[!참고]

이러한 설정을 변경 하지 않는 것이 좋습니다.그럼에도 불구 하 고 사용자 고유의 설정을 추가 하 고 섹션의 설명에 따라 컴퓨터 전체 사용자 지정 도구 집합 정의 정의할 수 있습니다.

사용자 지정 도구 집합 정의

표준 도구 집합에서 빌드 요구 사항을 충족하지 않는 경우 사용자 지정 도구 집합을 만들 수 있습니다.별도 시스템 구축에 대 한 있어야 합니다 빌드 랩 시나리오를 있을 수 있습니다 예를 들어, Visual C++ 프로젝트입니다.사용자 지정 도구 집합을 사용 하 여 사용자 지정 값을 할당할 수 있는 ToolsVersion 프로젝트를 만들거나 Msbuild.exe를 실행할 때 특성. 이렇게 하 여 사용할 수도 있습니다에서 $(MSBuildToolsPath) .targets 파일을 해당 디렉터리에서 가져올 속성입니다.

Msbuild.exe에 대 한 구성 파일에 사용자 지정 도구 집합을 지정 (또는 호스트에 사용자 지정 도구는 MSBuild 엔진 사용 하는 경우).예를 들어, Msbuild.exe의 구성 파일에 다음과 같은 도구 집합 정의가 포함 될 수 있습니다.

<msbuildToolsets default="3.0">
   <toolset toolsVersion="4.0">
      <property name="MSBuildToolsPath" 
        value="C:\Windows\Microsoft .NET\Framework\v3.0" />
   </toolset>
</msbuildToolsets>

<msbuildToolsets>또한 구성 파일에는 다음과 같이 정의 되어야 합니다.

<configSections>
   <section name="msbuildToolsets"       
       Type="Microsoft.Build.BuildEngine.ToolsetConfigurationSection, 
       Microsoft.Build.Engine, Version=3.5.0.0, Culture=neutral, 
       PublicKeyToken=b03f5f7f11d50a3a"
   </section>
</configSections>

[!참고]

제대로 읽을 수 <configSections> 에서 첫 번째 하위 여야 합니다의 <configuration> 섹션입니다.

ToolsetConfigurationSection은 사용자 지정 구성의 모든 호스트에서 사용할 수 있는 사용자 지정 구성 섹션입니다.사용자 지정 도구 집합을 사용할 경우 다른 작업 없이 호스트는 구성 파일 항목을 제공하기만 하면 빌드 엔진을 초기화할 수 있습니다.레지스트리 항목을 정의하여 MSBuild.exe, Visual Studio 및 모든 MSBuild 호스트에 적용되는 컴퓨터 전체 도구 집합을 지정할 수 있습니다.

[!참고]

구성 파일에 대 한 설정을 정의 하는 경우는 ToolsVersion 레지스트리에서 이미 정의 된, 두 정의 병합 됩니다.구성 파일에서 정의 우선 순위 설정과 레지스트리를 취하 ToolsVersion 는 무시 됩니다.

다음 속성의 값에 관련 된 ToolsVersion 에서 사용 하는 프로젝트입니다.

• $(MSBuildBinPath) 로 설정 되는 ToolsPath 레지스트리 나 구성 파일에 지정 된 값 위치는 ToolsVersion 정의 됩니다.$(MSBuildToolsPath) 설정은 레지스트리 나 구성 파일에 도구 집합의 위치를 지정 합니다.프로젝트 파일에서 $(MSBuildBinPath) 속성이나 $(MSBuildToolsPath) 속성으로 매핑됩니다.

• $(MSBuildToolsPath) 구성 파일에 지정 된 MSBuildToolsPath 속성에서 제공 하는 예약 된 속성입니다.이 속성은 $(MSBuildBinPath)를 대체합니다.그러나 $(MSBuildBinPath)는 호환성을 위해 계속 제공됩니다.

MSBuildToolsPath 속성을 추가하기 위해 사용하는 것과 동일한 구문을 사용하여 구성 파일에 사용자 지정 ToolsVersion별 속성을 추가할 수도 있습니다.이러한 사용자 지정 속성을 프로젝트 파일을 사용할 수 있도록 구성 파일에 지정 된 값의 이름와 같은 이름을 사용 합니다.

참고 항목

개념

MSBuild 도구 집합(ToolsVersion)