연습: MSBuild 사용Walkthrough: Using MSBuild

MSBuild는 Microsoft 및 Visual Studio용 빌드 플랫폼입니다.MSBuild is the build platform for Microsoft and Visual Studio. 이 연습에서는 MSBuild의 구성 요소를 소개하고 MSBuild 프로젝트를 작성, 조작 및 디버깅하는 방법을 보여 줍니다.This walkthrough introduces you to the building blocks of MSBuild and shows you how to write, manipulate, and debug MSBuild projects. 학습 내용은 다음과 같습니다.You will learn about:

  • 프로젝트 파일 만들기 및 조작Creating and manipulating a project file.

  • 빌드 속성을 사용하는 방법How to use build properties

  • 빌드 항목을 사용하는 방법How to use build items.

    Visual Studio 또는 명령 창에서 MSBuild를 실행할 수 있습니다.You can run MSBuild from Visual Studio, or from the Command Window. 이 연습에서는 Visual Studio를 사용하여 MSBuild 프로젝트 파일을 만듭니다.In this walkthrough, you create an MSBuild project file using Visual Studio. Visual Studio에서 프로젝트 파일을 편집한 다음 명령 창을 사용하여 프로젝트를 빌드하고 결과를 검사할 수 있습니다.You edit the project file in Visual Studio, and use a Command Window to build the project and examine the results.

MSBuild 프로젝트 만들기Creating an MSBuild Project

Visual Studio 프로젝트 시스템은 MSBuild를 기반으로 합니다.The Visual Studio project system is based on MSBuild. 따라서 Visual Studio를 사용하여 새 프로젝트 파일을 쉽게 만들 수 있습니다.This makes it easy to create a new project file using Visual Studio. 이 섹션에서는 Visual C# 프로젝트 파일을 만듭니다.In this section, you create a Visual C# project file. 대신 Visual Basic 프로젝트 파일을 만들도록 선택할 수도 있습니다.You can choose to create a Visual Basic project file instead. 이 연습의 컨텍스트에서 두 프로젝트 파일에는 큰 차이가 없습니다.In the context of this walkthrough, the difference between the two project files is minor.

프로젝트 파일을 만들려면To create a project file

  1. Visual Studio를 엽니다.Open Visual Studio.

  2. 파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭합니다.On the File menu, point to New, and then click Project.

  3. 새 프로젝트 대화 상자에서 Visual C# 프로젝트 형식을 선택하고 Windows Forms 응용 프로그램 템플릿을 선택합니다.In the New Project dialog box, select the Visual C# project type, and then select the Windows Forms Application template. 이름 상자에 BuildApp을 입력합니다.In the Name box, type BuildApp. 솔루션의 위치D:\와 같이 입력합니다.Enter a Location for the solution, for example, D:\. 솔루션용 디렉터리 만들기의 기본값(선택된 상태), 소스 제어에 추가의 기본값(선택되지 않은 상태) 및 솔루션 이름의 기본값(BuildApp)을 적용합니다.Accept the defaults for Create directory for solution (selected), Add to Source Control (not selected), and Solution Name (BuildApp).

    확인을 클릭하여 프로젝트 파일을 만듭니다.Click OK to create the project file.

프로젝트 파일 검사Examining the Project File

이전 섹션에서는 Visual Studio를 사용하여 Visual C# 프로젝트 파일을 만들었습니다.In the previous section, you used Visual Studio to create a Visual C# project file. 프로젝트 파일은 BuildApp이라는 프로젝트 노드로 솔루션 탐색기에 표시됩니다.The project file is represented in Solution Explorer by the project node named BuildApp. Visual Studio 코드 편집기를 사용하여 프로젝트 파일을 검사할 수 있습니다.You can use the Visual Studio code editor to examine the project file.

프로젝트 파일을 검사하려면To examine the project file

  1. 솔루션 탐색기에서 프로젝트 노드 BuildApp을 클릭합니다.In Solution Explorer, click the project node BuildApp.

  2. 속성 브라우저에서 프로젝트 파일 속성이 BuildApp.csproj인지 확인합니다.In the Properties browser, notice that the Project File property is BuildApp.csproj. 모든 프로젝트 파일 이름에는 접미사 "proj"가 추가됩니다.All project files are named with the suffix "proj". Visual Basic 프로젝트를 만든 경우 프로젝트 파일 이름은 BuildApp.vbproj가 됩니다.If you had created a Visual Basic project, the project file name would be BuildApp.vbproj.

  3. 프로젝트 노드를 마우스 오른쪽 단추로 클릭하고 프로젝트 언로드를 클릭합니다.Right-click the project node, then click Unload Project.

  4. 프로젝트 노드를 다시 마우스 오른쪽 단추로 클릭하고 BuildApp.csproj 편집을 클릭합니다.Right-click the project node again, then click Edit BuildApp.csproj.

    프로젝트 파일이 코드 편집기에 나타납니다.The project file appears in the code editor.

대상 및 작업Targets and Tasks

프로젝트 파일은 루트 노드 프로젝트를 포함하는 XML 형식의 파일입니다.Project files are XML-formatted files with the root node Project.

<?xml version="1.0" encoding="utf-8"?>  
<Project ToolsVersion="12.0" DefaultTargets="Build"  xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  

프로젝트 요소에서 xmlns 네임스페이스를 지정해야 합니다.You must specify the xmlns namespace in the Project element.

응용 프로그램 빌드 작업에서는 대상작업 요소를 사용합니다.The work of building an application is done with Target and Task elements.

  • 작업(task)은 작업(work)의 최소 단위(빌드의 "구성 요소")이며,A task is the smallest unit of work, in other words, the "atom" of a build. 입력과 출력을 포함할 수 있는 독립적인 실행 가능 구성 요소입니다.Tasks are independent executable components which may have inputs and outputs. 현재 프로젝트 파일에는 참조되거나 정의된 작업(task)이 없습니다.There are no tasks currently referenced or defined in the project file. 아래 섹션에서 프로젝트 파일에 작업(task)을 추가합니다.You add tasks to the project file in the sections below. 자세한 내용은 작업 항목을 참조하세요.For more information, see the Tasks topic.

  • 대상은 작업의 명명된 순서입니다.A target is a named sequence of tasks. 프로젝트 파일의 끝에는 현재 HTML 주석으로 묶인 두 개의 대상(BeforeBuild 및 AfterBuild)이 있습니다.There are two targets at the end of the project file that are currently enclosed in HTML comments: BeforeBuild and AfterBuild.

    <Target Name="BeforeBuild">  
    </Target>  
    <Target Name="AfterBuild">  
    </Target>  
    

    자세한 내용은 대상 항목을 참조하세요.For more information, see the Targets topic.

    프로젝트 노드에는 빌드할 기본 대상(이 연습의 경우에는 Build)을 선택하는 선택적인 DefaultTargets 특성이 있습니다.The Project node has an optional DefaultTargets attribute that selects the default target to build, in this case Build.

<Project ToolsVersion="12.0" DefaultTargets="Build" ...  

Build 대상은 프로젝트 파일에 정의되어 있지 않으며The Build target is not defined in the project file. 대신 Import 요소를 사용해 Microsoft.CSharp.targets 파일에서 가져옵니다.Instead, it is imported from the file Microsoft.CSharp.targets by using the Import element.

<Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />  

가져온 파일은 참조될 때마다 프로젝트 파일에 실제로 삽입됩니다.Imported files are effectively inserted into the project file wherever they are referenced.

MSBuild는 빌드의 대상을 추적하며 각 대상이 여러 번 빌드되지 않음을 보장합니다.MSBuild keeps track of the targets of a build, and guarantees that each target is built no more than once.

대상 및 작업 추가Adding a Target and a Task

이 섹션에서는 프로젝트 파일에 대상을 추가합니다.Add a target to the project file. 그리고 메시지를 인쇄하는 작업을 대상에 추가합니다.Add a task to the target that prints out a message.

대상 및 작업을 추가하려면To add a target and a task

  1. 프로젝트 파일에서 Import 문 바로 뒤에 다음 줄을 추가합니다.Add these lines to the project file, just after the Import statement:

    <Target Name="HelloWorld">  
    </Target>  
    

    그러면 HelloWorld라는 대상이 생성됩니다.This creates a target named HelloWorld. 프로젝트 파일을 편집하는 동안에는 IntelliSense가 지원됩니다.Notice that you have Intellisense support while editing the project file.

  2. 결과 섹션이 다음과 같아지도록 HelloWorld 대상에 줄을 추가합니다.Add lines to the HelloWorld target, so that the resulting section looks like this:

    <Target Name="HelloWorld">  
      <Message Text="Hello"></Message>  <Message Text="World"></Message>  
    </Target>  
    
  3. 프로젝트 파일을 저장합니다.Save the project file.

    메시지 작업은 MSBuild와 함께 제공되는 여러 작업 중 하나입니다.The Message task is one of the many tasks that ships with MSBuild. 사용 가능한 작업 및 사용법 정보의 전체 목록은 작업 참조를 참조하세요.For a complete list of available tasks and usage information, see Task Reference.

    메시지 작업에서는 Text 특성의 문자열 값을 입력으로 사용하며 출력 장치에 해당 값을 표시합니다.The Message task takes the string value of the Text attribute as input and displays it on the output device. HelloWorld 대상은 메시지 작업을 "Hello"와 "World"를 표시하는 데 각각 한 번씩 두 번 실행합니다.The HelloWorld target executes the Message task twice: first to display "Hello", and then to display "World".

대상 빌드Building the Target

Visual Studio 명령 프롬프트에서 MSBuild를 실행하여 위에 정의되어 있는 HelloWorld 대상을 빌드합니다.Run MSBuild from the Visual Studio Command Prompt to build the HelloWorld target defined above. /Target 또는 /t 명령줄 스위치를 사용하여 대상을 선택합니다.Use the /target or /t command line switch to select the target.

참고

이하 섹션에서는 Visual Studio 명령 프롬프트명령 창으로 지칭하겠습니다.We will refer to the Visual Studio Command Prompt as the Command Window in the sections below.

대상을 빌드하려면To build the target

  1. 시작, 모든 프로그램을 차례로 클릭합니다.Click Start, then click All Programs. Visual Studio Tools 폴더에서 Visual Studio 명령 프롬프트를 찾아서 클릭합니다.Locate and click the Visual Studio Command Prompt in the Visual Studio Tools folder.

  2. 명령 창에서 프로젝트 파일을 포함하는 폴더(이 연습의 경우 D:\BuildApp\BuildApp)로 이동합니다.From the command window, navigate to the folder containing the project file, in this case, D:\BuildApp\BuildApp.

  3. 명령 스위치 /t:HelloWorld를 사용하여 msbuild를 실행합니다.Run msbuild with the command switch /t:HelloWorld. 그러면 HelloWorld 대상이 선택 및 빌드됩니다.This selects and builds the HelloWorld target:

    msbuild buildapp.csproj /t:HelloWorld  
    
  4. 명령 창에서 출력을 검사합니다.Examine the output in the Command window. "Hello" 및 "World"의 두 줄이 표시됩니다.You should see the two lines "Hello" and "World":

    Hello  
    World  
    

참고

이 두 줄 대신 The target "HelloWorld" does not exist in the project가 표시되는 경우에는 코드 편집기에서 프로젝트 파일을 저장하지 않은 것일 수 있습니다.If instead you see The target "HelloWorld" does not exist in the project then you probably forgot to save the project file in the code editor. 파일을 저장하고 다시 시도합니다.Save the file and try again.

코드 편집기와 명령 창을 오가면서 프로젝트 파일을 변경하고 결과를 빠르게 확인할 수 있습니다.By alternating between the code editor and the command window, you can change the project file and quickly see the results.

참고

/t 명령 스위치 없이 msbuild를 실행하는 경우 msbuild는 Project 요소의 DefaultTarget 특성에 의해 제공되는 대상(이 연습의 경우에는 "Build")을 빌드합니다.If you run msbuild without the /t command switch, msbuild builds the target given by the DefaultTarget attribute of the Project element, in this case "Build". 그러면 Windows Forms 응용 프로그램 BuildApp.exe가 빌드됩니다.This builds the Windows Forms application BuildApp.exe.

빌드 속성Build Properties

빌드 속성은 빌드를 안내하는 이름-값 쌍입니다.Build properties are name-value pairs that guide the build. 여러 빌드 속성이 프로젝트 파일의 위쪽에 이미 정의되어 있습니다.Several build properties are already defined at the top of the project file:

<PropertyGroup>  
...  
  <ProductVersion>10.0.11107</ProductVersion>  
  <SchemaVersion>2.0</SchemaVersion>  
  <ProjectGuid>{30E3C9D5-FD86-4691-A331-80EA5BA7E571}</ProjectGuid>  
  <OutputType>WinExe</OutputType>  
...  
</PropertyGroup>  

모든 속성은 PropertyGroup 요소의 자식 요소입니다.All properties are child elements of PropertyGroup elements. 속성의 이름은 자식 요소의 이름이며 속성값은 자식 요소의 텍스트 요소입니다.The name of the property is the name of the child element, and the value of the property is the text element of the child element. 예를 들면 다음과 같습니다.For example,

<TargetFrameworkVersion>v12.0</TargetFrameworkVersion>  

위의 코드는 TargetFrameworkVersion이라는 속성을 정의하고 해당 속성에 문자열 값 "v12.0"을 제공합니다.defines the property named TargetFrameworkVersion, giving it the string value "v12.0".

빌드 속성은 언제든지 다시 정의할 수 있습니다.Build properties may be redefined at any time. 조건If

<TargetFrameworkVersion>v3.5</TargetFrameworkVersion>  

위의 코드가 프로젝트 파일 뒷부분이나 프로젝트 파일에서 나중에 가져온 파일에 나오는 경우 TargetFrameworkVersion은 새 값인 "v3.5"를 사용합니다.appears later in the project file, or in a file imported later in the project file, then TargetFrameworkVersion takes the new value "v3.5".

속성값 검사Examining a Property Value

속성값을 가져오려면 다음 구문을 사용합니다. 여기서 PropertyName는 속성의 이름입니다.To get the value of a property, use the following syntax, where PropertyName is the name of the property:

$(PropertyName)  

이 구문을 사용하여 프로젝트 파일의 일부 속성을 검사합니다.Use this syntax to examine some of the properties in the project file.

속성값을 검사하려면To examine a property value

  1. 코드 편집기에서 HelloWorld 대상을 다음 코드로 바꿉니다.From the code editor, replace the HelloWorld target with this code:

    <Target Name="HelloWorld">  
      <Message Text="Configuration is $(Configuration)" />  
      <Message Text="MSBuildToolsPath is $(MSBuildToolsPath)" />  
    </Target>  
    
  2. 프로젝트 파일을 저장합니다.Save the project file.

  3. 명령 창에서 다음 줄을 입력하고 실행합니다.From the Command Window, enter and execute this line:

    msbuild buildapp.csproj /t:HelloWorld  
    
  4. 출력을 검사합니다.Examine the output. 다음과 같은 두 줄이 표시됩니다. 사용 중인 .NET Framework 버전은 이 줄과 다를 수 있습니다.You should see these two lines (your .NET Framework version may differ):

    Configuration is Debug  
    MSBuildToolsPath is C:\Program Files\MSBuild\12.0\bin  
    

참고

이 두 줄이 표시되지 않는 경우에는 코드 편집기에서 프로젝트 파일을 저장하지 않은 것일 수 있습니다.If you don't see these lines then you probably forgot to save the project file in the code editor. 파일을 저장하고 다시 시도합니다.Save the file and try again.

조건부 속성Conditional Properties

Configuration 등의 대다수 속성은 조건부로 정의됩니다. 즉, 속성 요소에 Condition 특성이 나타납니다.Many properties like Configuration are defined conditionally, that is, the Condition attribute appears in the property element. 조건부 속성은 조건이 "true"로 확인되는 경우에만 정의되거나 다시 정의됩니다.Conditional properties are defined or redefined only if the condition evaluates to "true". 정의되지 않은 속성에는 기본값(빈 문자열)이 제공됩니다.Note that undefined properties are given the default value of an empty string. 예를 들면 다음과 같습니다.For example,

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

위의 코드는 "Configuration 속성이 아직 정의되지 않은 경우 정의하고 값으로 'Debug'를 지정한다"는 의미입니다.means "If the Configuration property has not been defined yet, define it and give it the value 'Debug'".

거의 모든 MSBuild 요소는 Condition 특성을 포함할 수 있습니다.Almost all MSBuild elements can have a Condition attribute. Condition 특성을 사용하는 방법에 대한 자세한 내용은 조건을 참조하세요.For more discussion about using the Condition attribute, see Conditions.

예약된 속성Reserved Properties

MSBuild는 몇 개의 속성 이름을 예약하여 프로젝트 파일과 MSBuild 이진 파일에 대한 정보를 저장합니다.MSBuild reserves some property names to store information about the project file and the MSBuild binaries. MSBuildToolsPath는 예약된 속성의 한 예입니다.MSBuildToolsPath is an example of a reserved property. 예약된 속성은 다른 속성과 마찬가지로 $ 표기법을 사용하여 참조됩니다.Reserved properties are referenced with the $ notation like any other property. 자세한 내용은 방법: 프로젝트 파일의 이름 또는 위치 참조MSBuild의 예약된 속성 및 잘 알려진 속성을 참조하세요.For more information, see How to: Reference the Name or Location of the Project File and MSBuild Reserved and Well-Known Properties.

환경 변수Environment Variables

프로젝트 파일의 환경 변수는 빌드 속성과 같은 방식으로 참조할 수 있습니다.You can reference environment variables in project files the same way as build properties. 예를 들어 프로젝트 파일에서 PATH 환경 변수를 사용하려면 $(Path)를 사용합니다.For example, to use the PATH environment variable in your project file, use $(Path). 프로젝트에 환경 변수와 이름이 같은 속성 정의가 포함되어 있으면 프로젝트의 속성이 환경 변수의 값을 재정의합니다.If the project contains a property definition that has the same name as an environment variable, the property in the project overrides the value of the environment variable. 자세한 내용은 방법: 빌드 시 환경 변수 사용을 참조하세요.For more information, see How to: Use Environment Variables in a Build.

명령줄에서 속성 설정Setting Properties from the Command Line

/property 또는 /p 명령줄 스위치를 사용하여 명령줄에서 속성을 정의할 수 있습니다.Properties may be defined on the command line using the /property or /p command line switch. 명령줄에서 수신된 속성값은 프로젝트 파일 및 환경 변수에 설정되어 있는 속성값을 재정의합니다.Property values received from the command line override property values set in the project file and environment variables.

명령줄에서 속성값을 설정하려면To set a property value from the command line

  1. 명령 창에서 다음 줄을 입력하고 실행합니다.From the Command Window, enter and execute this line:

    msbuild buildapp.csproj /t:HelloWorld /p:Configuration=Release  
    
  2. 출력을 검사합니다.Examine the output. 다음 줄이 표시됩니다.You should see this line:

    Configuration is Release.  
    

    MSBuild는 Configuration 속성을 생성하고 "Release" 값을 지정합니다.MSBuild creates the Configuration property and gives it the value "Release".

특수 문자Special Characters

MSBuild 프로젝트 파일에서 특정 문자는 특수한 의미로 사용됩니다.Certain characters have special meaning in MSBuild project files. 이러한 문자의 예로는 세미콜론(;) 및 별표()를 들 수 있습니다.Examples of these characters include semicolons (;) and asterisks (). 프로젝트 파일에서 이러한 특수 문자를 리터럴로 사용하려면 %xx 구문을 사용하여 해당 문자를 지정해야 합니다. 여기서 xx는 문자의 ASCII 16진수 값을 나타냅니다.In order to use these special characters as literals in a project file, they must be specified by using the syntax %xx, where xx represents the ASCII hexadecimal value of the character.

특수 문자를 사용해 Configuration 속성값을 표시하도록 메시지 작업을 변경하면 해당 작업을 보다 쉽게 읽을 수 있습니다.Change the Message task to show the value of the Configuration property with special characters to make it more readable.

메시지 작업에 특수 문자를 사용하려면To use special characters in the Message task

  1. 코드 편집기에서 두 메시지 작업을 모두 다음 줄로 바꿉니다.From the code editor, replace both Message tasks with this line:

    <Message Text="%24(Configuration) is %22$(Configuration)%22" />  
    
  2. 프로젝트 파일을 저장합니다.Save the project file.

  3. 명령 창에서 다음 줄을 입력하고 실행합니다.From the Command Window, enter and execute this line:

    msbuild buildapp.csproj /t:HelloWorld  
    
  4. 출력을 검사합니다.Examine the output. 다음 줄이 표시됩니다.You should see this line:

    $(Configuration) is "Debug"  
    

    자세한 내용은 MSBuild 특수 문자를 참조하세요.For more information, see MSBuild Special Characters.

항목 빌드Build Items

항목은 빌드 시스템에 대한 입력으로 사용되는 정보 부분(일반적으로는 파일 이름)입니다.An item is a piece of information, typically a file name, that is used as an input to the build system. 예를 들어 소스 파일을 나타내는 항목 컬렉션을 Compile이라는 작업으로 전달하여 해당 항목을 어셈블리로 컴파일할 수 있습니다.For example, a collection of items representing source files might be passed to a task named Compile to compile them into an assembly.

모든 항목은 ItemGroup 요소의 자식 요소입니다.All items are child elements of ItemGroup elements. 항목 이름은 자식 요소의 이름이고 항목 값은 자식 요소의 Include 특성 값입니다.The item name is the name of the child element, and the item value is the value of the Include attribute of the child element. 이름이 같은 항목의 값은 해당 이름의 항목 종류로 수집됩니다.The values of items with the same name are collected into item types of that name. 예를 들면 다음과 같습니다.For example,

<ItemGroup>  
    <Compile Include="Program.cs" />  
    <Compile Include="Properties\AssemblyInfo.cs" />  
</ItemGroup>  

위의 코드는 두 항목이 포함된 항목 그룹을 정의합니다.defines an item group containing two items. 항목 종류 Compile에는 "Program.cs" 및 "Properties\AssemblyInfo.cs"의 두 값이 있습니다.The item type Compile has two values: "Program.cs" and "Properties\AssemblyInfo.cs".

다음 코드는 이 두 파일을 모두 세미콜론으로 구분하여 Include 특성 하나에 선언하는 방식으로 같은 항목 종류를 만듭니다.The following code creates the same item type by declaring both files in one Include attribute, separated by a semicolon.

<ItemGroup>  
    <Compile Include="Program.cs;Properties\AssemblyInfo.cs" />  
</ItemGroup>  

자세한 내용은 항목을 참조하세요.For more information, see Items.

참고

파일 경로는 MSBuild 프로젝트 파일을 포함하는 폴더에 대한 상대 경로입니다.File paths are relative to the folder containing the MSBuild project file.

항목 종류 값 검사Examining Item Type Values

항목 종류의 값을 가져오려면 다음 구문을 사용합니다. 여기서 ItemType은 항목 종류의 이름입니다.To get the values of an item type, use the following syntax, where ItemType is the name of the item type:

@(ItemType)  

이 구문을 사용하여 프로젝트 파일에서 Compile 항목 종류를 검사합니다.Use this syntax to examine the Compile item type in the project file.

항목 종류 값을 검사하려면To examine item type values

  1. 코드 편집기에서 HelloWorld 대상 작업을 다음 코드로 바꿉니다.From the code editor, replace the HelloWorld target task with this code:

    <Target Name="HelloWorld">  
      <Message Text="Compile item type contains @(Compile)" />  
    </Target>  
    
  2. 프로젝트 파일을 저장합니다.Save the project file.

  3. 명령 창에서 다음 줄을 입력하고 실행합니다.From the Command Window, enter and execute this line:

    msbuild buildapp.csproj /t:HelloWorld  
    
  4. 출력을 검사합니다.Examine the output. 다음과 같은 긴 줄이 표시됩니다.You should see this long line:

    Compile item type contains Form1.cs;Form1.Designer.cs;Program.cs;Properties\AssemblyInfo.cs;Properties\Resources.Designer.cs;Properties\Settings.Designer.cs  
    

    기본적으로 항목 종류의 값은 세미콜론으로 구분됩니다.The values of an item type are separated with semicolons by default.

    항목 종류의 구분 기호를 변경하려면 다음 구문을 사용합니다. 여기서 ItemType은 항목 종류이고 Separator는 하나 이상의 구분 문자를 포함하는 문자열입니다.To change the separator of an item type, use the following syntax, where ItemType is the item type and Separator is a string of one or more separating characters:

@(ItemType, Separator)  

캐리지 리턴과 줄 바꿈(%0A%0D)을 사용하여 Compile 항목을 한 줄에 하나씩 표시하도록 메시지 작업을 변경합니다.Change the Message task to use carriage returns and line feeds (%0A%0D) to display Compile items one per line.

항목 종류 값을 한 줄에 하나씩 표시하려면To display item type values one per line

  1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉니다.From the code editor, replace the Message task with this line:

    <Message Text="Compile item type contains @(Compile, '%0A%0D')" />  
    
  2. 프로젝트 파일을 저장합니다.Save the project file.

  3. 명령 창에서 다음 줄을 입력하고 실행합니다.From the Command Window, enter and execute this line:

    msbuild buildapp.csproj /t:HelloWorld

  4. 출력을 검사합니다.Examine the output. 다음 줄이 표시됩니다.You should see these lines:

    Compile item type contains Form1.cs  
    Form1.Designer.cs  
    Program.cs  
    Properties\AssemblyInfo.cs  
    Properties\Resources.Designer.cs  
    Properties\Settings.Designer.cs  
    

포함, 제외 및 와일드카드Include, Exclude, and Wildcards

Include 특성에서 와일드카드 "", "**" 및 "?"를 사용하여 항목 종류에 항목을 추가할 수 있습니다.You can use the wildcards "", "**", and "?" with the Include attribute to add items to an item type. 예를 들면 다음과 같습니다.For example,

<Photos Include="images\*.jpeg" />  

위의 코드는 images 폴더에 있는 파일 확장명이 ".jpeg"인 모든 파일을 Photos 항목 종류에 추가합니다. 반면adds all files with the file extension ".jpeg" in the images folder to the Photos item type, while

<Photos Include="images\**.jpeg" />  

위의 코드는 images 폴더 및 모든 하위 폴더에 있는 파일 확장명이 ".jpeg"인 모든 파일을 Photos 항목 종류에 추가합니다.adds all files with the file extension ".jpeg" in the images folder, and all its subfolders, to the Photos item type. 더 많은 예제를 확인하려면 방법: 빌드할 파일 선택을 참조하세요.For more examples, see How to: Select the Files to Build.

선언하는 항목은 항목 종류에 추가됩니다.Notice that as items are declared they are added to the item type. 예를 들면 다음과 같습니다.For example,

<Photos Include="images\*.jpeg" />  
<Photos Include="images\*.gif" />  

위의 코드는 파일 확장명이 ".jpeg" 또는 ".gif"인 images 폴더의 모든 파일을 포함하는 Photo라는 항목 종류를 만듭니다.creates an item type named Photo containing all files in the image folder with a file extension of either ".jpeg" or ".gif". 이 코드는 다음 줄과 동일합니다.This is equivalent to the following line:

<Photos Include="images\*.jpeg;images\*.gif" />  

Exclude 특성을 사용하면 항목 종류에서 특정 항목을 제외할 수 있습니다.You can exclude an item from an item type with the Exclude attribute. 예를 들면 다음과 같습니다.For example,

<Compile Include="*.cs" Exclude="*Designer*">  

위의 코드는 이름에 "Designer"라는 문자열이 포함된 파일을 제외하고 파일 확장명이 ".cs"인 모든 파일을 Compile 항목 종류에 추가합니다.adds all files with the file extension".cs" to the Compile item type, except for files whose names contain the string "Designer". 더 많은 예제를 확인하려면 방법: 빌드에서 파일 제외를 참조하세요.For more examples, see How to: Exclude Files from the Build.

Exclude 특성은 Include 특성과 Exclude 특성을 모두 포함하는 항목 요소에서 Include 특성에 의해 추가된 항목에만 영향을 줍니다.The Exclude attribute only affects the items added by the Include attribute in the item element that contains them both. 예를 들면 다음과 같습니다.For example,

<Compile Include="*.cs" />  
<Compile Include="*.res" Exclude="Form1.cs">  

위의 코드를 실행해도 이전 항목 요소에서 추가된 Form1.cs 파일은 제외되지 않습니다.would not exclude the file Form1.cs, which was added in the preceding item element.

항목을 포함 및 제외하려면To include and exclude items
  1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉니다.From the code editor, replace the Message task with this line:

    <Message Text="XFiles item type contains @(XFiles)" />  
    
  2. Import 요소 바로 뒤에 다음 항목 그룹을 추가합니다.Add this item group just after the Import element:

    <ItemGroup>  
       <XFiles Include="*.cs;properties/*.resx" Exclude="*Designer*" />  
    </ItemGroup>  
    
  3. 프로젝트 파일을 저장합니다.Save the project file.

  4. 명령 창에서 다음 줄을 입력하고 실행합니다.From the Command Window, enter and execute this line:

    msbuild buildapp.csproj /t:HelloWorld  
    
  5. 출력을 검사합니다.Examine the output. 다음 줄이 표시됩니다.You should see this line:

    XFiles item type contains Form1.cs;Program.cs;Properties/Resources.resx  
    

항목 메타데이터Item Metadata

항목은 Include 및 Exclude 특성에서 수집된 정보 외에 메타데이터를 포함할 수 있습니다.Items may contain metadata in addition to the information gathered from the Include and Exclude attributes. 이 메타데이터는 항목 값뿐만이 아니라 항목에 대한 추가 정보를 필요로 하는 작업에서 사용할 수 있습니다.This metadata can be used by tasks that require more information about items than just the item value.

메타데이터의 이름을 항목 자식 요소로 사용하여 요소를 만드는 방법으로 프로젝트 파일에서 항목 메타데이터를 선언합니다.Item metadata is declared in the project file by creating an element with the name of the metadata as a child element of the item. 항목은 메타데이터 값을 포함하지 않을 수도 있고 하나 이상 포함할 수도 있습니다.An item can have zero or more metadata values. 예를 들어 다음 CSFile 항목에는 값이 "Fr"인 Culture 메타데이터가 있습니다.For example, the following CSFile item has Culture metadata with a value of "Fr":

<ItemGroup>  
    <CSFile Include="main.cs">  
        <Culture>Fr</Culture>  
    </CSFile>  
</ItemGroup>  

항목 종류의 메타데이터 값을 가져오려면 다음 구문을 사용합니다. 여기서 ItemType은 항목 종류의 이름이고 MetaDataName은 메타데이터의 이름입니다.To get the metadata value of an item type, use the following syntax, where ItemType is the name of the item type and MetaDataName is the name of the metadata:

%(ItemType.MetaDataName)  

항목 메타데이터를 검사하려면To examine item metadata

  1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉니다.From the code editor, replace the Message task with this line:

    <Message Text="Compile.DependentUpon: %(Compile.DependentUpon)" />  
    
  2. 프로젝트 파일을 저장합니다.Save the project file.

  3. 명령 창에서 다음 줄을 입력하고 실행합니다.From the Command Window, enter and execute this line:

    msbuild buildapp.csproj /t:HelloWorld  
    
  4. 출력을 검사합니다.Examine the output. 다음 줄이 표시됩니다.You should see these lines:

    Compile.DependentUpon:  
    Compile.DependentUpon: Form1.cs  
    Compile.DependentUpon: Resources.resx  
    Compile.DependentUpon: Settings.settings  
    

    위 코드에 나와 있는 것처럼 "Compile.DependentUpon" 구가 여러 번 나타납니다.Notice how the phrase "Compile.DependentUpon" appears several times. 대상 내에서 이 구문이 포함된 메타데이터를 사용하면 "일괄 처리"가 수행됩니다.The use of metadata with this syntax within a target causes "batching". 일괄 처리란 대상 내의 작업이 각각의 고유 메타데이터 값에 대해 한 번씩 실행된다는 의미입니다.Batching means that the tasks within the target are executed once for each unique metadata value. 이 코드는 일반적인 "for loop" 프로그래밍 구문과 동일한 MSBuild 스크립트입니다.This is the MSBuild script equivalent of the common "for loop" programming construct. 자세한 내용은 일괄 처리를 참조하세요.For more information, see Batching.

잘 알려진 메타데이터Well-Known Metadata

항목 목록에 항목을 추가할 때마다 해당 항목에는 몇 가지 잘 알려진 메타데이터가 할당됩니다.Whenever an item is added to an item list, that item is assigned some well-known metadata. 예를 들어 %(Filename)은 모든 항목의 파일 이름을 반환합니다.For example, %(Filename) returns the file name of any item. 잘 알려진 메타데이터의 전체 목록은 잘 알려진 항목 메타데이터를 참조하세요.For a complete list of well-known metadata, see Well-known Item Metadata.

잘 알려진 메타데이터를 검사하려면To examine well-known metadata
  1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉니다.From the code editor, replace the Message task with this line:

    <Message Text="Compile Filename: %(Compile.Filename)" />  
    
  2. 프로젝트 파일을 저장합니다.Save the project file.

  3. 명령 창에서 다음 줄을 입력하고 실행합니다.From the Command Window, enter and execute this line:

    msbuild buildapp.csproj /t:HelloWorld  
    
  4. 출력을 검사합니다.Examine the output. 다음 줄이 표시됩니다.You should see these lines:

    Compile Filename: Form1  
    Compile Filename: Form1.Designer  
    Compile Filename: Program  
    Compile Filename: AssemblyInfo  
    Compile Filename: Resources.Designer  
    Compile Filename: Settings.Designer  
    

    위의 두 예를 비교하면 Compile 항목 종류에서 DependentUpon 메타데이터는 일부 항목에만 포함되어 있지만 잘 알려진 Filename 메타데이터는 모든 항목에 포함되어 있음을 확인할 수 있습니다.By comparing the two examples above, you can see that while not every item in the Compile item type has DependentUpon metadata, all items have the well-known Filename metadata.

메타데이터 변환Metadata Transformations

항목 목록을 새 항목 목록으로 변환할 수 있습니다.Item lists can be transformed into new item lists. 항목 목록을 변환하려면 다음 구문을 사용합니다. 여기서 ItemType은 항목 종류의 이름이고 MetadataName은 메타데이터의 이름입니다.To transform an item list, use the following syntax, where ItemType is the name of the item type and MetadataName is the name of the metadata:

@(ItemType -> '%(MetadataName)')  

예를 들어 @(SourceFiles -> '%(Filename).obj')와 같은 식을 사용하여 소스 파일의 항목 목록을 개체 파일 컬렉션으로 변환할 수 있습니다.For example, an item list of source files can be transformed into a collection of object files using an expression like @(SourceFiles -> '%(Filename).obj'). 자세한 내용은 변환을 참조하세요.For more information, see Transforms.

메타데이터를 사용하여 항목을 변환하려면To transform items using metadata
  1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉니다.From the code editor, replace the Message task with this line:

    <Message Text="Backup files: @(Compile->'%(filename).bak')" />  
    
  2. 프로젝트 파일을 저장합니다.Save the project file.

  3. 명령 창에서 다음 줄을 입력하고 실행합니다.From the Command Window, enter and execute this line:

    msbuild buildapp.csproj /t:HelloWorld  
    
  4. 출력을 검사합니다.Examine the output. 다음 줄이 표시됩니다.You should see this line:

    Backup files: Form1.bak;Form1.Designer.bak;Program.bak;AssemblyInfo.bak;Resources.Designer.bak;Settings.Designer.bak  
    

    이 구문으로 표현되는 메타데이터로 인해 일괄 처리가 수행되지는 않습니다.Notice that metadata expressed in this syntax does not cause batching.

새로운 기능What's Next?

간단한 프로젝트 파일을 단계별로 만드는 방법을 알아보려면 연습: 처음부터 새로 MSBuild 프로젝트 파일 만들기를 진행해 보세요.To learn how to create a simple project file one step at a time, try out the Walkthrough: Creating an MSBuild Project File from Scratch.

참고 항목See Also

MSBuild 개요MSBuild Overview
MSBuild 참조MSBuild Reference