MSBuild

Microsoft Build Engine 응용 프로그램을 구축 하기 위한 플랫폼입니다.MSBuild 라고도 하는이 엔진 컨트롤 빌드 플랫폼 처리 방법과 소프트웨어 빌드 프로젝트 파일에 대해 XML 스키마를 제공 합니다.Visual Studio Msbuild를 사용 하 여 Visual Studio 의존 하지 않습니다. Msbuild.exe에 프로젝트 또는 솔루션 파일을 호출 하 여 조정 하 고 Visual Studio 설치 되지 않은 환경에서에서 제품을 작성할 수 있습니다.

Visual Studio Msbuild를 사용 하 여 로드 하 고 관리 되는 프로젝트를 빌드합니다.프로젝트 파일 (.csproj,.vbproj, vcxproj, 및 기타) Visual Studio는 IDE를 사용 하 여 프로젝트를 빌드할 때 실행 되는 MSBuild XML 코드를 포함 합니다.Visual Studio 프로젝트에서 필요한 모든 설정을 가져오고 빌드 프로세스에서 일반적인 개발 작업을 수행할 수 있지만 확장 하거나 Visual Studio 내에서 또는 XML 편집기를 사용 하 여에서 수정할 수 있습니다.

대신 Visual Studio IDE의 MSBuild 명령줄을 사용 하 여 빌드를 실행할 수 있습니다 하는 경우 다음 예제를 보여 줍니다.

• Visual Studio 설치 되지 않습니다.

• 64 비트 버전의 MSBuild 사용 하려는.Msbuild에서 더 많은 메모리에 액세스할 수 있도록이 버전의 Msbuild는 일반적으로 필요 하지 않습니다.

• 빌드를 여러 프로세스에서 실행 하려는 경우.그러나 IDE의 프로젝트에서 c + +, Visual Studio 2012에서는 C# 시작 동일한 결과 얻기 위해 사용할 수 있습니다.

• 빌드 시스템을 수정 하려는 경우.예를 들어, 다음 동작을 원하는 수 있습니다.

  • 이러한 컴파일러에 도달 하기 전에 파일을 전처리 합니다.

  • 빌드 출력의 다른 위치에 복사 합니다.

  • 압축된 파일에서 빌드 출력을 만듭니다.

  • 후 처리 단계를 수행 합니다.예를 들어, 다른 버전으로 어셈블리 스탬프 하려는 수도 있습니다.

Visual Studio IDE에서 코드를 작성할 수는 있지만 Msbuild를 사용 하 여 빌드를 실행 합니다.다른 방법으로 IDE에서에서 코드를 개발 컴퓨터에 빌드 수 있지만 통합 된 코드에서 여러 개발자가 작성 하는 MSBuild 명령줄을 사용 합니다.

[!참고]

하면 Team Foundation Build 자동으로 컴파일, 테스트 및 응용 프로그램을 배포할 수 있습니다.자동으로 개발자의 코드 (예를 들어, 부분 연속 통합 전략으로) 확인 하는 경우 빌드를 실행 하거나 (예를 들어 야간 빌드 확인 테스트 빌드) 일정에 따라 빌드 시스템이 있습니다.Team Foundation Build Msbuild를 사용 하 여 코드를 컴파일합니다.자세한 내용은 응용 프로그램 빌드을 참조하십시오.

이 항목에서는 MSBuild 개요를 제공합니다.기본 자습서는 연습: MSBuild 사용을 참조하십시오.

항목 내용

• 명령 프롬프트에서 MSBuild 사용

• 프로젝트 파일

  • 속성

  • Items

  • 작업

  • 대상

• 빌드 로그

• Visual Studio에서 MSBuild 사용

• 다중 대상 지정

명령 프롬프트에서 MSBuild 사용

명령 프롬프트에서 MSBuild를 실행하려면 적절한 명령줄 옵션과 함께 프로젝트 파일을 MSBuild.exe에 전달합니다.명령줄 옵션을 사용하여 속성을 설정하고 특정 대상을 실행하며 빌드 프로세스를 제어하는 다른 옵션을 설정할 수 있습니다.예를 들어, 다음 명령줄 구문을 사용하여 Configuration 속성을 Debug로 설정하여 MyProj.proj 파일을 빌드합니다.

MSBuild.exe MyProj.proj /property:Configuration=Debug

MSBuild 명령줄 옵션에 대한 자세한 내용은 MSBuild 명령줄 참조를 참조하십시오. 

보안 정보
프로젝트를 다운로드하기 전에 코드를 신뢰할 수 있는지 확인하십시오.

프로젝트 파일

MSBuild간단 하 고 확장 가능한 XML 기반 프로젝트 파일 형식이 사용 됩니다.MSBuild 프로젝트 파일 형식을 통해 개발자는 빌드할 항목뿐만 아니라 항목을 다른 운영 체제 및 구성에 대해 빌드하는 방법을 설명합니다.또한 프로젝트 파일 형식을 빌드 여러 프로젝트에서 제품에서 일관 되 게 수행할 수 있도록 개별 파일로 분해 될 수 개발자 재사용 가능한 빌드 규칙을 작성 수 있습니다.

다음 단원에서는 몇 가지 기본 요소를 설명의 MSBuild 프로젝트 파일 형식입니다. 기본 프로젝트 파일을 만드는 방법에 대 한 자습서를 참조 하십시오. 연습: 처음부터 새로 MSBuild 프로젝트 파일 만들기.

속성

속성은 빌드를 구성하는 데 사용될 수 있는 키/값 쌍을 나타냅니다.속성 이름을 갖는 요소를 PropertyGroup 요소의 자식으로 만들어 속성을 선언합니다.예를 들어, 다음 코드 라는 속성을 만듭니다 BuildDir 값이 Build.

<PropertyGroup>
    <BuildDir>Build</BuildDir>
</PropertyGroup>

배치 하 여 조건에 따라 속성을 정의할 수는 Condition 요소의 특성입니다.조건이 true로 확인되지 않으면 조건부 요소의 내용이 무시됩니다.다음 예제에서는 Configuration 요소가 아직 정의 되어 있지 않으면 정의 된.

<Configuration  Condition=" '$(Configuration)' == '' ">Debug</Configuration>

프로젝트 파일 전체에서 $(PropertyName) 구문을 사용하여 속성을 참조할 수 있습니다.예를 들어,를 사용 하 여 앞의 예제에서 속성을 참조할 수 있습니다 $(BuildDir) 및 $(Configuration).

속성에 대한 자세한 내용은 MSBuild 속성을 참조하십시오.

Items

항목은 빌드 시스템에 대 한 입력 이며 일반적으로 파일을 나타냅니다.항목은 사용자 정의된 항목 이름에 따라 항목 형식으로 그룹화됩니다.이러한 항목 형식은 작업의 매개 변수로 사용될 수 있으며, 이 작업은 개별 항목을 사용하여 빌드 프로세스의 단계를 수행합니다.

항목은 항목 형식의 이름을 ItemGroup 요소의 자식으로 사용하는 요소를 만들어 프로젝트 파일에 선언됩니다.예를 들어, 다음 코드는 두 개의 파일을 포함하는 Compile이라는 항목 형식을 만듭니다.

<ItemGroup>
    <Compile Include = "file1.cs"/>
    <Compile Include = "file2.cs"/>
</ItemGroup>

프로젝트 파일 전체에서 @(ItemType) 구문을 사용하여 항목 형식을 참조할 수 있습니다.예를 들어, 예제의 항목 형식은 @(Compile)을 사용하여 참조됩니다.

Msbuild에서 요소 및 특성 이름은 대/소문자를 구분 합니다.그러나, 속성, 항목 및 메타 데이터 이름은 되지 않습니다.항목 형식은 다음 예제에서는 Compile, comPile, 또는 다른 대/소문자 변형 값 "one.cs"; 항목 형식을 제공 합니다.

<ItemGroup>
  <Compile Include="one.cs" />
  <comPile Include="two.cs" />
</ItemGroup>

항목은 와일드카드 문자를 사용하여 선언될 수 있으며 고급 빌드 시나리오에 대한 추가 메타데이터를 포함할 수 있습니다.항목에 대한 자세한 내용은 MSBuild 항목을 참조하십시오.

작업

작업은 MSBuild 프로젝트에서 빌드 작업을 수행하는 데 사용하는 실행 코드 단위입니다.예를 들어, 작업은 입력 파일을 컴파일하거나 외부 도구를 실행할 수 있습니다.작업은 다시 사용할 수 있으며 다른 개발자가 다른 프로젝트에서 작업을 공유할 수 있습니다.

작업의 실행 논리는 관리 코드로 작성되며 UsingTask 요소를 사용하여 MSBuild에 매핑됩니다.ITask 인터페이스를 구현하는 관리되는 형식을 만들어 자체의 작업을 작성할 수 있습니다.작업을 작성하는 방법에 대한 자세한 내용은 작업 작성을 참조하십시오.

MSBuild요구 사항에 맞게 수정할 수 있는 일반적인 작업에는 다음이 포함 됩니다.예로 복사, 파일 복사 MakeDir, 디렉터리를 만듭니다 및 Csc, C# 소스 코드 파일을 컴파일합니다.사용할 수 있는 작업 및 사용법 정보에 대한 전체 목록은 MSBuild 작업 참조를 참조하십시오.

작업은 작업 이름을 Target 요소의 자식으로 사용하는 요소를 만들어 MSBuild 프로젝트 파일에서 실행됩니다.작업은 일반적으로 요소 특성으로 전달되는 매개 변수를 받아들입니다.MSBuild 속성과 항목은 모두 매개 변수로 사용할 수 있습니다.예를 들어, 다음 코드에서는 MakeDir 작업을 호출하고 앞의 예제에서 선언한 BuildDir 속성의 값을 해당 작업으로 전달합니다.

<Target Name="MakeBuildDirectory">
    <MakeDir  Directories="$(BuildDir)" />
</Target>

작업에 대한 자세한 내용은 MSBuild 작업을 참조하십시오.

대상

대상은 작업을 특정 순서로 그룹화하고 프로젝트 파일의 섹션을 빌드 프로세스의 진입점으로 노출합니다.대상은 주로 가독성을 증가 하 고 확장에 대 한 논리적 섹션으로 그룹화 됩니다.빌드 단계를 대상으로 나누면 해당 코드 섹션을 각 대상으로 복사하지 않아도 다른 대상에서 빌드 프로세스의 한 부분을 호출할 수 있습니다.예를 들어, 몇 개의 진입점 빌드 프로세스에 빌드된 참조가 필요한 경우, 참조를 빌드하는 대상을 만들고 필수 구문은 모든 진입점에서이 대상을 실행할 수 있습니다.

Target 요소를 사용하여 프로젝트 파일에 대상을 선언합니다.예를 들어, 다음 코드에서는 Compile이라는 대상을 만듭니다. 이 대상은 앞의 예제에서 선언한 항목 목록을 사용하는 Csc 작업을 호출합니다.

<Target Name="Compile">
    <Csc Sources="@(Compile)" />
</Target>

고급 시나리오에서 대상은 서로 간의 관계를 설명 하 고 종속성 분석을 수행 하므로 해당 대상이 최신 상태인 경우 빌드 프로세스의 전체 섹션을 건너뛸 수 있습니다 사용할 수 있습니다.대상에 대한 자세한 내용은 MSBuild 대상을 참조하십시오.

빌드 로그

빌드 오류, 경고 및 메시지를 콘솔 이나 다른 출력 장치에 기록할 수 있습니다.자세한 내용은 MSBuild를 사용하여 빌드 로그 가져오기 및 MSBuild 로그인을 참조하십시오.

Visual Studio에서 MSBuild 사용

Visual Studio에서는 MSBuild 프로젝트 파일 형식을 사용하여 관리되는 프로젝트에 대한 빌드 정보를 저장합니다.프로젝트 설정을 사용 하 여 변경 되거나 추가 된 Visual Studio 인터페이스에 반영 되는. * proj 파일 모든 프로젝트에 대해 생성 됩니다.Visual Studio에서는 관리되는 프로젝트를 로드 및 빌드하기 위해 호스팅된 MSBuild 인스턴스를 사용합니다.이 관리 되는 프로젝트에서 빌드할 수 있음을 의미 Visual Studio 명령 프롬프트 (경우에 Visual Studio 설치 되지 않은), 결과 동일한 됩니다.

Visual Studio에서 MSBuild를 사용하는 방법에 대한 자습서는 연습: MSBuild 사용을 참조하십시오.

다중 대상 지정

Visual Studio를 사용하면 .NET Framework의 여러 버전 중 하나에서 실행되는 응용 프로그램을 컴파일할 수 있습니다.예를 들어,.NET Framework 2.0 32 비트 플랫폼에서 실행 되도록 응용 프로그램을 컴파일할 수 있습니다와 같은.NET Framework 4.5 64 비트 플랫폼에서 실행 되도록 응용 프로그램을 컴파일할 수 있습니다.둘 이상의 프레임워크에서 실행 가능하도록 컴파일하는 기능을 다중 대상 지정이라고 합니다.

다중 대상 지정에는 다음과 같은 이점이 있습니다.

• .NET Framework의 이전 버전(예: 2.0, 3.0 및 3.5)을 대상으로 하는 응용 프로그램을 개발할 수 있습니다.

• 예를 들어, Silverlight는.NET Framework, 다른 프레임 워크를 지정할 수 있습니다.

• 대상 프레임워크의 미리 정의된 하위 집합인 프레임워크 프로필을 대상으로 지정할 수 있습니다.

• .NET Framework 현재 버전에 대 한 서비스 팩이 발표 되는 경우를 대상 수 있습니다.

• 다중 대상 지정 응용 프로그램의 대상 프레임 워크 및 플랫폼에서 사용 가능한 기능만 사용 하도록 보장 합니다.

자세한 내용은 MSBuild 다중 대상 개요을 참조하십시오.

관련 항목

제목	설명
연습: 처음부터 새로 MSBuild 프로젝트 파일 만들기	텍스트 편집기만을 사용해서 기본 프로젝트 파일을 증분 방식으로 만드는 방법을 보여 줍니다.
연습: MSBuild 사용	Msbuild의 빌딩 블록을 소개 하 고 작성, 조작 및 Visual Studio IDE를 닫지 않고 MSBuild 프로젝트를 디버깅 하는 방법을 보여 줍니다.
MSBuild 개념	MSBuild의 네 가지 빌딩 블록인 속성, 항목, 대상 및 작업에 대해 설명합니다.
MSBuild 항목	MSBuild 파일 형식의 일반 개념과 그러한 모든 개념이 서로 어떻게 연결되는지를 설명합니다.
MSBuild 속성	속성 및 속성 컬렉션을 소개합니다.속성은 빌드를 구성하는 데 사용될 수 있는 키/값 쌍입니다.
MSBuild 대상	작업을 특정 순서로 그룹화하며 빌드 프로세스의 섹션이 명령줄에서 호출되도록 하는 방법에 대해 설명합니다.
MSBuild 작업	MSBuild에서 사용할 수 있는 실행 코드 단위를 만들어 원자 빌드 작업을 수행하는 방법을 보여 줍니다.
MSBuild 조건	MSBuild 요소에서 Condition 특성을 사용하는 방법에 대해 설명합니다.
MSBuild 고급 개념	일괄 처리, 변환, 다중 대상 지정, 및 기타 고급 기술을 수행을 제공 합니다.
MSBuild 로그인	빌드 이벤트, 메시지 및 오류를 기록 하는 방법에 설명 합니다.
추가 MSBuild 리소스	MSBuild에 대한 자세한 정보를 볼 수 있는 커뮤니티 및 지원 리소스를 나열합니다.

참조

• MSBuild 참조
  참조 정보를 포함하는 항목에 대한 링크입니다.

• MSBuild 용어
  일반적인 MSBuild 용어를 정의합니다.