MSBuildMSBuild

Microsoft Build EngineMicrosoft Build Engine은 응용 프로그램을 빌드하기 위한 플랫폼입니다.The Microsoft Build EngineMicrosoft Build Engine is a platform for building applications. MSBuild라고도 하는 이 엔진은 빌드 플랫폼에서 소프트웨어를 처리하고 빌드하는 방법을 제어하는 프로젝트 파일에 대한 XML 스키마를 제공합니다.This engine, which is also known as MSBuild, provides an XML schema for a project file that controls how the build platform processes and builds software. Visual Studio는 MSBuild를 사용하지만 Visual Studio에 종속되지 않습니다.Visual Studio uses MSBuild, but it doesn't depend on Visual Studio. 프로젝트 또는 솔루션 파일에서 msbuild.exe를 호출하여 Visual Studio가 설치되지 않은 환경에서 제품을 조정하고 빌드할 수 있습니다.By invoking msbuild.exe on your project or solution file, you can orchestrate and build products in environments where Visual Studio isn't installed.

Visual Studio는 MSBuild를 사용하여 관리되는 프로젝트를 로드하고 빌드합니다.Visual Studio uses MSBuild to load and build managed projects. Visual Studio의 프로젝트 파일(.csproj, .vbproj, vcxproj 등)에는 IDE를 사용하여 프로젝트를 빌드할 때 실행되는 MSBuild XML 코드가 들어 있습니다.The project files in Visual Studio (.csproj,.vbproj, vcxproj, and others) contain MSBuild XML code that executes when you build a project by using the IDE. Visual Studio 프로젝트는 필요한 모든 설정을 가져오고 일반적인 개발 작업을 수행하는 프로세스를 빌드하지만 Visual Studio 내에서 또는 XML 편집기를 사용하여 확장하거나 수정할 수 있습니다.Visual Studio projects import all the necessary settings and build processes to do typical development work, but you can extend or modify them from within Visual Studio or by using an XML editor.

C++의 MSBuild에 대한 자세한 내용은 MSBuild (Visual C++)를 참조하세요.For information about MSBuild for C++, see MSBuild (Visual C++).

다음 예제에서는 Visual Studio IDE 대신 MSBuild 명령줄을 사용하여 빌드를 실행할 수 있는 경우를 보여 줍니다.The following examples illustrate when you might run builds by using an MSBuild command line instead of the Visual Studio IDE.

  • Visual Studio가 설치되지 않은 경우.Visual Studio isn't installed.

  • 64비트 버전의 MSBuild를 사용하려는 경우.You want to use the 64-bit version of MSBuild. 이 버전의 MSBuild는 일반적으로 필요하지 않지만 MSBuild에서 더 많은 메모리에 액세스할 수 있도록 합니다.This version of MSBuild is usually unnecessary, but it allows MSBuild to access more memory.

  • 여러 프로세스에서 빌드를 실행하려는 경우.You want to run a build in multiple processes. 그러나 C++ 및 C#으로 작성한 프로젝트에서는 IDE를 사용하여 동일한 결과를 얻을 수 있습니다.However, you can use the IDE to achieve the same result on projects in C++ and C#.

  • 빌드 시스템을 수정하려는 경우.You want to modify the build system. 예를 들어 다음과 같은 작업을 사용하도록 설정할 수 있습니다.For example, you might want to enable the following actions:

    • 컴파일러에 도달하기 전에 파일을 전처리합니다.Preprocess files before they reach the compiler.

    • 빌드 출력을 다른 위치로 복사합니다.Copy the build outputs to a different place.

    • 빌드 출력에서 압축 파일을 만듭니다.Create compressed files from build outputs.

    • 후처리 단계를 수행합니다.Do a post-processing step. 예를 들어 다른 버전으로 어셈블리에 스탬프를 지정할 수 있습니다.For example, you might want to stamp an assembly with a different version.

    Visual Studio IDE에서 코드를 작성하지만 MSBuild를 사용하여 빌드를 실행할 수 있습니다.You can write code in the Visual Studio IDE but run builds by using MSBuild. 또는 개발 컴퓨터의 IDE에서 코드를 빌드하지만 MSBuild 명령줄을 사용하여 여러 개발자로부터 통합된 코드를 빌드할 수 있습니다.As another alternative, you can build code in the IDE on a development computer but use an MSBuild command line to build code that's integrated from multiple developers.

참고

Team Foundation Build를 사용하여 응용 프로그램을 자동으로 컴파일, 테스트 및 배포할 수 있습니다.You can use Team Foundation Build to automatically compile, test, and deploy your application. 개발자가 코드를 체크 인할 때(예: 연속 통합 전략의 일부로) 또는 일정에 따라(예: 야간 빌드 확인 테스트 빌드) 빌드 시스템에서 빌드를 자동으로 실행할 수 있습니다.Your build system can automatically run builds when developers check in code (for example, as part of a Continuous Integration strategy) or according to a schedule (for example, a nightly Build Verification Test build). Team Foundation Build는 MSBuild를 사용하여 코드를 컴파일합니다.Team Foundation Build compiles your code by using MSBuild. 자세한 내용은 응용 프로그램 빌드를 참조하세요.For more information, see Build the application.

이 항목에서는 MSBuild에 대해 간략하게 설명합니다.This topic provides an overview of MSBuild. 입문용 자습서는 연습: MSBuild 사용을 참조하세요.For an introductory tutorial, see Walkthrough: Using MSBuild.

항목 내용In this topic

명령 프롬프트에서 MSBuild 사용Using MSBuild at a Command Prompt

명령 프롬프트에서 MSBuildMSBuild를 실행하려면 적절한 명령줄 옵션과 함께 프로젝트 파일을 MSBuild.exe에 전달합니다.To run MSBuildMSBuild at a command prompt, pass a project file to MSBuild.exe, together with the appropriate command-line options. 명령줄 옵션을 사용하여 속성을 설정하고 특정 대상을 실행하며 빌드 프로세스를 제어하는 다른 옵션을 설정할 수 있습니다.Command-line options let you set properties, execute specific targets, and set other options that control the build process. 예를 들어, 다음 명령줄 구문을 사용하여 MyProj.proj 속성을 Configuration로 설정하여 Debug 파일을 빌드합니다.For example, you would use the following command-line syntax to build the file MyProj.proj with the Configuration property set to Debug.

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

MSBuildMSBuild 명령줄 옵션에 대한 자세한 내용은 명령줄 참조를 참조하세요.For more information about MSBuildMSBuild command-line options, see Command-Line Reference.

중요

프로젝트를 다운로드하기 전에 코드를 신뢰할 수 있는지 확인하십시오.Before you download a project, determine the trustworthiness of the code.

프로젝트 파일Project File

MSBuildMSBuild는 간단하고 확장 가능한 XML 기반 프로젝트 파일 형식을 사용합니다. uses an XML-based project file format that's straightforward and extensible. MSBuildMSBuild 프로젝트 파일 형식을 통해 개발자는 빌드할 항목뿐만 아니라 항목을 다른 운영 체제 및 구성에 대해 빌드하는 방법을 설명합니다.The MSBuildMSBuild project file format lets developers describe the items that are to be built, and also how they are to be built for different operating systems and configurations. 또한 프로젝트 파일 형식을 통해 개발자는 개별 파일로 분해될 수 있는 다시 사용 가능한 빌드 규칙을 작성하여 해당 제품 내의 여러 프로젝트에서 일관성 있는 빌드를 수행할 수 있습니다.In addition, the project file format lets developers author reusable build rules that can be factored into separate files so that builds can be performed consistently across different projects in the product.

다음 단원에서는 MSBuildMSBuild 프로젝트 파일 형식의 몇 가지 기본 요소에 대해 설명합니다.The following sections describe some of the basic elements of the MSBuildMSBuild project file format. 기본 프로젝트 파일을 만드는 방법에 대한 자습서는 연습: 처음부터 새로 MSBuild 프로젝트 파일 만들기를 참조하세요.For a tutorial about how to create a basic project file, see Walkthrough: Creating an MSBuild Project File from Scratch.

속성Properties

속성은 빌드를 구성하는 데 사용될 수 있는 키/값 쌍을 나타냅니다.Properties represent key/value pairs that can be used to configure builds. 속성 이름을 포함하는 요소를 PropertyGroup 요소의 자식으로 만들어 속성을 선언합니다.Properties are declared by creating an element that has the name of the property as a child of a PropertyGroup element. 예를 들어 다음 코드는 값이 BuildDirBuild이라는 속성을 만듭니다.For example, the following code creates a property named BuildDir that has a value of Build.

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

요소에 Condition 특성을 포함하여 속성을 조건부로 정의할 수 있습니다.You can define a property conditionally by placing a Condition attribute in the element. 조건이 true로 확인되지 않으면 조건부 요소의 내용이 무시됩니다.The contents of conditional elements are ignored unless the condition evaluates to true. 다음 예제에서는 Configuration 요소가 아직 정의되지 않은 경우 해당 요소를 정의합니다.In the following example, the Configuration element is defined if it hasn't yet been defined.

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

프로젝트 파일 전체에서 $(PropertyName) 구문을 사용하여 속성을 참조할 수 있습니다.Properties can be referenced throughout the project file by using the syntax $(PropertyName). 예를 들어 $(BuildDir)$(Configuration)을 사용하여 이전 예제의 속성을 참조할 수 있습니다.For example, you can reference the properties in the previous examples by using $(BuildDir) and $(Configuration).

속성에 대한 자세한 내용은 MSBuild 속성을 참조하세요.For more information about properties, see MSBuild Properties.

항목Items

항목은 빌드 시스템에 대한 입력이며, 일반적으로 파일을 나타냅니다.Items are inputs into the build system and typically represent files. 항목은 사용자 정의된 항목 이름에 따라 항목 형식으로 그룹화됩니다.Items are grouped into item types, based on user-defined item names. 이러한 항목 형식은 작업의 매개 변수로 사용될 수 있으며, 이 작업은 개별 항목을 사용하여 빌드 프로세스의 단계를 수행합니다.These item types can be used as parameters for tasks, which use the individual items to perform the steps of the build process.

항목 형식의 이름을 포함하는 요소를 ItemGroup 요소의 자식으로 만들어 프로젝트 파일에서 항목을 선언합니다.Items are declared in the project file by creating an element that has the name of the item type as a child of an ItemGroup element. 예를 들어, 다음 코드는 두 개의 파일을 포함하는 Compile이라는 항목 형식을 만듭니다.For example, the following code creates an item type named Compile, which includes two files.

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

프로젝트 파일 전체에서 @(ItemType) 구문을 사용하여 항목 형식을 참조할 수 있습니다.Item types can be referenced throughout the project file by using the syntax @(ItemType). 예를 들어, 예제의 항목 형식은 @(Compile)을 사용하여 참조됩니다.For example, the item type in the example would be referenced by using @(Compile).

MSBuild에서 요소 및 특성 이름은 대/소문자를 구분합니다.In MSBuild, element and attribute names are case-sensitive. 그러나 속성, 항목 및 메타데이터 이름은 대/소문자를 구분하지 않습니다.However, property, item, and metadata names are not. 다음 예제에서는 항목 형식 Compile, comPile 또는 기타 대/소문자 변형을 만든 후 항목 형식에 값 "one.cs;two.cs"를 지정합니다.The following example creates the item type Compile, comPile, or any other case variation, and gives the item type the value "one.cs;two.cs".

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

항목은 와일드카드 문자를 사용하여 선언될 수 있으며 고급 빌드 시나리오에 대한 추가 메타데이터를 포함할 수 있습니다.Items can be declared by using wildcard characters and may contain additional metadata for more advanced build scenarios. 항목에 대한 자세한 내용은 항목을 참조하세요.For more information about items, see Items.

작업Tasks

작업은 MSBuildMSBuild 프로젝트에서 빌드 작업을 수행하는 데 사용하는 실행 코드 단위입니다.Tasks are units of executable code that MSBuildMSBuild projects use to perform build operations. 예를 들어, 작업은 입력 파일을 컴파일하거나 외부 도구를 실행할 수 있습니다.For example, a task might compile input files or run an external tool. 작업은 다시 사용할 수 있으며 다른 개발자가 다른 프로젝트에서 작업을 공유할 수 있습니다.Tasks can be reused, and they can be shared by different developers in different projects.

작업의 실행 논리는 관리 코드로 작성되며 UsingTask 요소를 사용하여 MSBuildMSBuild에 매핑됩니다.The execution logic of a task is written in managed code and mapped to MSBuildMSBuild by using the UsingTask element. ITask 인터페이스를 구현하는 관리되는 형식을 만들어 자체의 작업을 작성할 수 있습니다.You can write your own task by authoring a managed type that implements the ITask interface. 작업을 작성하는 방법에 대한 자세한 내용은 작업 작성을 참조하세요.For more information about how to write tasks, see Task Writing.

MSBuildMSBuild에는 요구 사항에 맞게 수정할 수 있는 일반 작업이 포함되어 있습니다. includes common tasks that you can modify to suit your requirements. 예를 들어 파일을 복사하는 Copy, 디렉터리를 만드는 MakeDir, Visual C# 소스 코드 파일을 컴파일하는 Csc 등이 있습니다.Examples are Copy, which copies files, MakeDir, which creates directories, and Csc, which compiles Visual C# source code files. 사용할 수 있는 작업 및 사용법 정보에 대한 전체 목록은 작업 참조를 참조하세요.For a list of available tasks together with usage information, see Task Reference.

작업 이름을 포함하는 요소를 Target 요소의 자식으로 만들어 MSBuildMSBuild 프로젝트 파일에서 작업을 실행합니다.A task is executed in an MSBuildMSBuild project file by creating an element that has the name of the task as a child of a Target element. 작업은 일반적으로 요소 특성으로 전달되는 매개 변수를 받아들입니다.Tasks typically accept parameters, which are passed as attributes of the element. MSBuildMSBuild 속성과 항목은 모두 매개 변수로 사용할 수 있습니다.Both MSBuildMSBuild properties and items can be used as parameters. 예를 들어 다음 코드에서는 MakeDir 작업을 호출하고 앞의 예제에서 선언한 BuildDir 속성값을 해당 작업으로 전달합니다.For example, the following code calls the MakeDir task and passes it the value of the BuildDir property that was declared in the earlier example.

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

작업에 대한 자세한 내용은 작업을 참조하세요.For more information about tasks, see Tasks.

대상Targets

대상은 작업을 특정 순서로 그룹화하고 프로젝트 파일의 섹션을 빌드 프로세스의 진입점으로 노출합니다.Targets group tasks together in a particular order and expose sections of the project file as entry points into the build process. 대상은 확장할 수 있고 좀더 쉽게 이해할 수 있도록 종종 논리적 섹션으로 그룹화됩니다.Targets are often grouped into logical sections to increase readability and to allow for expansion. 빌드 단계를 대상으로 나누면 해당 코드 섹션을 각 대상으로 복사하지 않아도 다른 대상에서 빌드 프로세스의 한 부분을 호출할 수 있습니다.Breaking the build steps into targets lets you call one piece of the build process from other targets without copying that section of code into every target. 예를 들어 빌드 프로세스에 대한 몇 개의 진입점에 빌드할 참조가 필요한 경우, 참조를 빌드하는 대상을 만든 다음 필요한 모든 진입점에서 이 대상을 실행할 수 있습니다.For example, if several entry points into the build process require references to be built, you can create a target that builds references and then run that target from every entry point where it's required.

Target 요소를 사용하여 프로젝트 파일에 대상을 선언합니다.Targets are declared in the project file by using the Target element. 예를 들어 다음 코드에서는 Compile이라는 대상을 만듭니다. 이 대상은 앞의 예제에서 선언한 항목 목록을 포함하는 Csc 작업을 호출합니다.For example, the following code creates a target named Compile, which then calls the Csc task that has the item list that was declared in the earlier example.

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

고급 시나리오에서는 대상을 사용하여 서로의 관계를 설명하고 종속성 분석을 수행할 수 있습니다. 종속성 분석을 통해 대상이 최신 상태이면 빌드 프로세스의 전체 섹션을 건너뛸 수 있습니다.In more advanced scenarios, targets can be used to describe relationships among one another and perform dependency analysis so that whole sections of the build process can be skipped if that target is up-to-date. 대상에 대한 자세한 내용은 대상을 참조하세요.For more information about targets, see Targets.

빌드 로그Build Logs

빌드 오류, 경고 및 메시지를 콘솔이나 다른 출력 장치에 기록할 수 있습니다.You can log build errors, warnings, and messages to the console or another output device. 자세한 내용은 빌드 로그 가져오기MSBuild의 로그인을 참조하세요.For more information, see Obtaining Build Logs and Logging in MSBuild.

Visual Studio에서 MSBuild 사용Using MSBuild in Visual Studio

Visual StudioVisual Studio에서는 MSBuildMSBuild 프로젝트 파일 형식을 사용하여 관리되는 프로젝트에 대한 빌드 정보를 저장합니다. uses the MSBuildMSBuild project file format to store build information about managed projects. Visual StudioVisual Studio 인터페이스를 사용하여 추가되거나 변경된 프로젝트 설정은 모든 프로젝트에 대해 생성되는 .proj 파일에 반영됩니다.Project settings that are added or changed by using the Visual StudioVisual Studio interface are reflected in the .proj file that's generated for every project. Visual StudioVisual Studio에서는 관리되는 프로젝트를 로드 및 빌드하기 위해 호스팅된 MSBuildMSBuild 인스턴스를 사용합니다. uses a hosted instance of MSBuildMSBuild to build managed projects. 즉, 관리되는 프로젝트는 Visual StudioVisual Studio 또는 명령 프롬프트(Visual StudioVisual Studio가 설치되지 않은 경우)에서 빌드할 수 있으며 그 결과는 동일합니다.This means that a managed project can be built in Visual StudioVisual Studio or at a command prompt (even if Visual StudioVisual Studio isn't installed), and the results will be identical.

Visual Studio에서 MSBuild를 사용하는 방법에 대한 자습서는 연습: MSBuild 사용을 참조하세요.For a tutorial about how to use MSBuild in Visual Studio, see Walkthrough: Using MSBuild.

멀티 타기팅Multitargeting

Visual Studio를 사용하면 .NET Framework의 여러 버전 중 하나에서 실행되는 응용 프로그램을 컴파일할 수 있습니다.By using Visual Studio, you can compile an application to run on any one of several versions of the .NET Framework. 예를 들어 32비트 플랫폼의 .NET Framework 2.0에서 실행되도록 응용 프로그램을 컴파일하고 동일한 응용 프로그램을 64비트 플랫폼의 .NET Framework 4.5에서 실행되도록 컴파일할 수 있습니다.For example, you can compile an application to run on the .NET Framework 2.0 on a 32-bit platform, and you can compile the same application to run on the .NET Framework 4.5 on a 64-bit platform. 둘 이상의 프레임워크에서 실행 가능하도록 컴파일하는 기능을 다중 대상 지정이라고 합니다.The ability to compile to more than one framework is named multitargeting.

다중 대상 지정에는 다음과 같은 이점이 있습니다.These are some of the benefits of multitargeting:

  • .NET Framework의 이전 버전(예: 2.0, 3.0 및 3.5)을 대상으로 하는 응용 프로그램을 개발할 수 있습니다.You can develop applications that target earlier versions of the .NET Framework, for example, versions 2.0, 3.0, and 3.5.

  • .NET Framework 외에 Silverlight 등의 다른 프레임워크를 대상으로 지정할 수 있습니다.You can target frameworks other than the .NET Framework, for example, Silverlight.

  • 대상 프레임워크의 미리 정의된 하위 집합인 프레임워크 프로필을 대상으로 지정할 수 있습니다.You can target a framework profile, which is a predefined subset of a target framework.

  • 현재 버전의 .NET Framework용 서비스 팩이 릴리스될 경우 해당 서비스 팩을 대상으로 지정할 수 있습니다.If a service pack for the current version of the .NET Framework is released, you could target it.

  • 다중 대상 지정은 대상 프레임워크 및 플랫폼에서 사용 가능한 기능만 응용 프로그램에서 사용되도록 합니다.Multitargeting guarantees that an application uses only the functionality that's available in the target framework and platform.

    자세한 내용은 멀티 타기팅을 참조하세요.For more information, see Multitargeting.

제목Title 설명Description
연습: 처음부터 새로 MSBuild 프로젝트 파일 만들기Walkthrough: Creating an MSBuild Project File from Scratch 텍스트 편집기만을 사용해서 기본 프로젝트 파일을 증분 방식으로 만드는 방법을 보여 줍니다.Shows how to create a basic project file incrementally, by using only a text editor.
연습: MSBuild 사용Walkthrough: Using MSBuild MSBuild의 구성 요소를 소개하고 Visual Studio IDE를 닫지 않고 MSBuild 프로젝트를 작성, 조작 및 디버깅하는 방법을 보여 줍니다.Introduces the building blocks of MSBuild and shows how to write, manipulate, and debug MSBuild projects without closing the Visual Studio IDE.
MSBuild 개념MSBuild Concepts MSBuild의 네 가지 빌딩 블록인 속성, 항목, 대상 및 작업에 대해 설명합니다.Presents the four building blocks of MSBuild: properties, items, targets, and tasks.
항목Items MSBuildMSBuild 파일 형식의 일반 개념과 그러한 모든 개념이 서로 어떻게 연결되는지를 설명합니다.Describes the general concepts behind the MSBuildMSBuild file format and how the pieces fit together.
MSBuild 속성MSBuild Properties 속성 및 속성 컬렉션을 소개합니다.Introduces properties and property collections. 속성은 빌드를 구성하는 데 사용될 수 있는 키/값 쌍입니다.Properties are key/value pairs that can be used to configure builds.
대상Targets 작업을 특정 순서로 그룹화하며 빌드 프로세스의 섹션이 명령줄에서 호출되도록 하는 방법에 대해 설명합니다.Explains how to group tasks together in a particular order and enable sections of the build process to be called on the command line.
작업Tasks MSBuildMSBuild에서 사용할 수 있는 실행 코드 단위를 만들어 원자 빌드 작업을 수행하는 방법을 보여 줍니다.Shows how to create a unit of executable code that can be used by MSBuildMSBuild to perform atomic build operations.
조건Conditions MSBuild 요소에서 Condition 특성을 사용하는 방법에 대해 설명합니다.Discusses how to use the Condition attribute in an MSBuild element.
고급 개념Advanced Concepts 일괄 처리, 변환 수행, 다중 대상 지정 및 기타 고급 기술을 제공합니다.Presents batching, performing transforms, multitargeting, and other advanced techniques.
MSBuild의 로그인Logging in MSBuild 빌드 이벤트, 메시지 및 오류를 기록하는 방법에 대해 설명합니다.Describes how to log build events, messages, and errors.
추가 리소스Additional Resources MSBuild에 대한 자세한 정보를 볼 수 있는 커뮤니티 및 지원 리소스를 나열합니다.Lists community and support resources for more information about MSBuild.

참조Reference

MSBuild 참조MSBuild Reference
참조 정보를 포함하는 항목에 대한 링크입니다.Links to topics that contain reference information.

용어집은 일반적인 MSBuild 용어를 정의합니다.Glossary Defines common MSBuild terms.