자습서: MSBuild 사용

MSBuild는 Microsoft 및 Visual Studio용 빌드 플랫폼입니다. 이 자습서에서는 MSBuild의 구성 요소를 소개하고 MSBuild 프로젝트를 작성, 조작 및 디버그하는 방법을 보여 줍니다. 다음 항목에 대해 알아봅니다.

• 프로젝트 파일 만들기 및 조작

• 빌드 속성을 사용하는 방법입니다.

• 빌드 항목을 사용하는 방법.

MSBuild는 Visual Studio 또는 명령 창에서 실행할 수 있습니다. 이 자습서에서는 Visual Studio를 사용하여 MSBuild 프로젝트 파일을 만듭니다. Visual Studio에서 프로젝트 파일을 편집하고 명령 창 사용하여 프로젝트를 빌드하고 결과를 검사합니다.

MSBuild 설치

MSBuild 프로젝트 만들기

Visual Studio 프로젝트 시스템은 MSBuild를 기반으로 합니다. Visual Studio를 사용하여 새 프로젝트 파일을 쉽게 만들 수 있습니다. 이 섹션에서는 C# 프로젝트 파일을 만듭니다. 대신 Visual Basic 프로젝트 파일을 만들도록 선택할 수 있습니다. 본 자습서의 맥락에서 두 프로젝트 파일 간의 차이는 사소합니다.

프로젝트 파일 만들려면

1. Visual Studio를 열고 프로젝트를 만듭니다.

   검색 상자에 winforms입력한 다음 새 Windows Forms 앱(.NET Framework)만듭니다. 표시되는 대화 상자에서 생성선택합니다.

   프로젝트 이름 상자에 BuildApp입력합니다. 솔루션의 위치 입력합니다(예: D:\.)

2. 프로젝트 파일을 만들려면 확인을 클릭하거나 만들기를 클릭하세요.

프로젝트 파일 검사

이전 섹션에서는 Visual Studio를 사용하여 C# 프로젝트 파일을 만들었습니다. 프로젝트 파일은 솔루션 탐색기의 프로젝트 노드인 BuildApp으로 표시됩니다. Visual Studio 코드 편집기를 사용하여 프로젝트 파일을 검사할 수 있습니다.

프로젝트 파일 검사하려면

1. 솔루션 탐색기에서 프로젝트 노드 BuildApp을 클릭합니다.

2. 속성 브라우저에서 프로젝트 파일의 속성은 BuildApp.csproj입니다. 모든 프로젝트 파일의 이름은 접미사로 "proj"이 붙어 있습니다. Visual Basic 프로젝트를 만든 경우 프로젝트 파일 이름은 BuildApp.vbproj .

3. 프로젝트 노드를 다시 마우스 오른쪽 단추로 클릭한 다음 BuildApp.csproj편집을 클릭합니다.

   프로젝트 파일이 코드 편집기에서 나타납니다.

대상 및 작업

프로젝트 파일은 루트 노드 Project있는 XML 형식 파일입니다.

대부분의 .NET 프로젝트에는 Sdk 특성이 있습니다. 이러한 프로젝트를 SDK 스타일 프로젝트라고합니다. SDK를 참조한다는 것은 MSBuild가 해당 SDK에 대한 빌드 인프라를 제공하는 파일 집합을 가져온다는 것을 의미합니다. SDK를 참조하지 않는 경우에도 MSBuild를 사용할 수 있습니다. 모든 SDK 관련 속성과 대상을 자동으로 사용할 수 있는 것은 아닙니다.

<Project Sdk="Microsoft.NET.Sdk">

특수한 용도로 .NET SDK의 다양한 변형이 있습니다. .NET 프로젝트 SDK 설명되어 있습니다.

애플리케이션 빌드 작업은 대상 및 Task 요소를 사용하여 수행됩니다.

• 작업은 빌드의 "원자"라는 가장 작은 작업 단위입니다. 태스크는 입력 및 출력을 가질 수 있는 독립적인 실행 가능 구성 요소입니다. 프로젝트 파일에 현재 참조되거나 정의된 작업이 없습니다. 다음 섹션의 프로젝트 파일에 작업을 추가합니다. 자세한 내용은 작업참조하세요.

• 대상은 명명된 작업 시퀀스입니다. 명명된 작업 시퀀스일 수 있지만, 중요하게는 빌드 또는 수행할 작업을 나타내므로 목표 지향 방식으로 정의해야 합니다. 자세한 내용은 대상을 참조하세요.

기본 대상은 프로젝트 파일에 정의되어 있지 않습니다. 대신 가져온 프로젝트에 지정됩니다. Import 요소는 가져온 프로젝트를 지정합니다. 예를 들어 C# 프로젝트에서는 Microsoft.CSharp.targets 파일에서 기본 대상을 가져옵니다.

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

가져온 파일은 참조되는 모든 위치에 프로젝트 파일에 효과적으로 삽입됩니다.

SDK 스타일 프로젝트에서는 SDK 특성으로 인해 이 파일을 암시적으로 가져오기 때문에 이 가져오기 요소가 표시되지 않습니다.

MSBuild는 빌드의 대상을 추적하고 각 대상이 두 번 이상 빌드되지 않음을 보장합니다.

대상 및 작업 추가

프로젝트 파일에 대상을 추가합니다. 메시지를 인쇄하는 작업을 대상에 추가합니다.

대상 및 작업 추가하려면

1. Import 문 또는 여는 Project 요소 바로 뒤의 프로젝트 파일에 이러한 줄을 추가합니다.

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

   이 코드는 HelloWorld라는 대상을 만듭니다. 프로젝트 파일을 편집하는 동안 IntelliSense가 지원됩니다.

2. 결과 섹션이 다음과 같이 표시되도록 HelloWorld 대상에 줄을 추가합니다.

   <Target Name="HelloWorld">
     <Message Text="Hello"></Message>
     <Message Text="World"></Message>
   </Target>
   

3. 프로젝트 파일을 저장합니다.

Message 작업은 MSBuild와 함께 제공되는 많은 작업 중 하나입니다. 사용 가능한 작업 및 사용량 정보의 전체 목록은 작업 참조참조하세요.

Message 작업은 Text 특성의 문자열 값을 입력으로 사용하여 출력 디바이스에 표시하거나 하나 이상의 로그에 씁니다(해당하는 경우). HelloWorld 대상은 메시지 작업을 두 번 실행합니다. 먼저 "Hello"를 표시한 다음 "World"를 표시합니다.

대상 빌드

Visual Studio에서 이 프로젝트를 빌드하려고 하면 정의한 대상이 빌드되지 않습니다. 그 이유는 Visual Studio가 여전히 가져온 .targets 파일에 있는 기본 대상을 선택하기 때문입니다.

Visual Studio용 개발자 명령 프롬프트 MSBuild를 실행하여 이전에 정의된 HelloWorld 대상을 빌드합니다. -target 또는 -t 명령줄 스위치를 사용하여 대상을 선택합니다.

대상을 빌드하려면

1. 명령 창엽니다.

   작업 표시줄의 검색 상자에서 도구 이름(예: dev 또는 developer command prompt)을 입력하기 시작합니다. 검색 패턴과 일치하는 설치된 앱 목록이 나타납니다.

   파일을 수동으로 찾아야 하는 경우 파일은 {Visual Studio 설치 폴더}\Common7\Tools 폴더에 LaunchDevCmd.bat.

2. 명령 창에서 프로젝트 파일이 포함된 폴더로 이동합니다. 이 경우 D:\BuildApp\BuildApp .

3. msbuild를 명령 스위치 -t:HelloWorld로 실행합니다. 이 명령은 HelloWorld 대상을 선택하고 빌드합니다.

   msbuild buildapp.csproj -t:HelloWorld
   

4. 명령 창출력을 검사합니다. "Hello" 및 "World"라는 두 줄이 표시됩니다.

   Hello
   World
   

코드 편집기와 명령 창을 번갈아 가며 프로젝트 파일을 변경하고 결과를 빠르게 확인할 수 있습니다.

빌드 속성

빌드 속성은 빌드를 안내하는 이름-값 쌍입니다. 프로젝트 파일의 맨 위에 여러 빌드 속성이 이미 정의되어 있습니다.

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

모든 속성은 PropertyGroup 요소의 자식 요소입니다. 속성의 이름은 자식 요소의 이름이고 속성 값은 자식 요소의 텍스트 요소입니다. 예를 들어

<TargetFrameworkVersion>net8.0</TargetFrameworkVersion>

"이름이 TargetFrameworkVersion인 속성을 정의하고 문자열 값 'net8.0'을 부여합니다."

빌드 속성은 언제든지 다시 정의할 수 있습니다. 만약

<TargetFrameworkVersion>net6.0</TargetFrameworkVersion>

프로젝트 파일의 후반부나 나중에 프로젝트 파일에서 가져온 파일에 나타나면, TargetFrameworkVersion은 "net6.0"이라는 새 값을 가집니다.

속성 값을 검사하다

속성 값을 얻으려면 다음 구문을 사용합니다. 여기서 PropertyName 속성의 이름입니다.

$(PropertyName)

이 구문을 사용하여 프로젝트 파일의 일부 속성을 검사합니다.

속성 값을 검사하려면

1. 코드 편집기에서 HelloWorld 대상을 다음 코드로 바꿉다.

   <Target Name="HelloWorld">
     <Message Text="Configuration is $(Configuration)" />
     <Message Text="MSBuildToolsPath is $(MSBuildToolsPath)" />
   </Target>
   

2. 프로젝트 파일을 저장합니다.

3. 명령 창다음 줄을 입력하고 실행합니다.

   msbuild buildapp.csproj -t:HelloWorld
   

4. 출력을 검사합니다. 다음 두 줄이 표시됩니다(출력이 다를 수 있음).

   Configuration is Debug
   MSBuildToolsPath is C:\Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\amd64
   

   Configuration is Debug
   MSBuildToolsPath is C:\Program Files (x86)\Microsoft Visual Studio\2019\MSBuild\16.0\Bin
   

조건부 속성

Configuration 같은 많은 속성이 조건부로 정의됩니다. 즉, Condition 특성이 속성 요소에 나타납니다. 조건부 속성은 조건이 "true"로 평가되는 경우에만 정의되거나 다시 정의됩니다. 정의되지 않은 속성에는 빈 문자열의 기본값이 지정됩니다. 예를 들어

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

의미합니다 "Configuration 속성이 아직 정의되지 않은 경우, 속성을 정의하고 값으로 'Debug'를 부여합니다."

거의 모든 MSBuild 요소에는 Condition 특성이 있을 수 있습니다. Condition 특성 사용에 대한 자세한 내용은 조건참조하세요.

예약된 속성

MSBuild는 프로젝트 파일 및 MSBuild 이진 파일에 대한 정보를 저장하기 위해 일부 속성 이름을 예약합니다. MSBuildToolsPath는 예약된 속성의 예입니다. 예약된 속성은 다른 속성과 마찬가지로 $ 표기법으로 참조됩니다. 자세한 내용은 방법: 프로젝트 파일 이름 또는 위치 참조 및 MSBuild 예약 및 잘 알려진 속성 참조 을 참조하세요.

환경 변수

빌드 속성과 동일한 방식으로 프로젝트 파일에서 환경 변수를 참조할 수 있습니다. 예를 들어 프로젝트 파일에서 PATH 환경 변수를 사용하려면 $(Path)를 사용합니다. 프로젝트에 환경 변수와 이름이 같은 속성 정의가 포함되어 있으면 프로젝트의 속성이 환경 변수의 값을 재정의합니다. 자세한 내용은 방법: 빌드에서 환경 변수를 사용하는 방법을 참조하세요.

명령줄에서 속성 설정

-property 또는 -p 명령줄 스위치를 사용하여 명령줄에서 속성을 정의할 수 있습니다. 명령줄에서 받은 속성 값은 프로젝트 파일 및 환경 변수에 설정된 속성 값을 재정의합니다.

명령줄에서 속성 값을 설정하려면

1. 명령 창다음 줄을 입력하고 실행합니다.

   msbuild buildapp.csproj -t:HelloWorld -p:Configuration=Release
   

2. 출력을 검사합니다. 이 줄을 보세요.

   Configuration is Release.
   

MSBuild는 Configuration 속성을 만들고 "Release" 값을 제공합니다.

특수 문자

MSBuild 프로젝트 파일에서 특정 문자는 특별한 의미를 갖습니다. 이러한 문자의 예로는 세미콜론(;) 및 별표(*)가 있습니다. 이러한 특수 문자를 프로젝트 파일에서 리터럴로 사용하려면 구문 %<xx>사용하여 지정해야 합니다. 여기서 <xx> 문자의 ASCII 16진수 값을 나타냅니다.

메시지 태스크를 변경하여 더 쉽게 읽을 수 있도록 특수 문자가 있는 Configuration 속성의 값을 표시합니다.

메시지 태스크에서 특수 문자를 사용하려면:

1. 코드 편집기에서 두 메시지 작업을 다음 줄로 바꿉다.

   <Message Text="%24(Configuration) is %22$(Configuration)%22" />
   

2. 프로젝트 파일을 저장합니다.

3. 명령 창다음 줄을 입력하고 실행합니다.

   msbuild buildapp.csproj -t:HelloWorld
   

4. 출력을 검사합니다. 이 줄을 보셔야 합니다.

   $(Configuration) is "Debug"
   

자세한 내용은 msBuild 특수 문자 참조하세요.

빌드 아이템

항목은 빌드 시스템에 대한 입력으로 사용되는 정보(일반적으로 파일 이름)입니다. 예를 들어 원본 파일을 나타내는 항목의 컬렉션은 컴파일이라는 작업에 전달되어 어셈블리로 컴파일할 수 있습니다.

모든 항목은 ItemGroup 요소의 자식 요소입니다. 항목 이름은 자식 요소의 이름이고 항목 값은 자식 요소의 Include 특성 값입니다. 이름이 같은 항목의 값은 해당 이름의 항목 형식으로 수집됩니다. 예를 들어

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

는 두 개의 항목을 포함하는 항목 그룹을 정의합니다. 컴파일 항목 형식에는 Program.cs 및 Properties\AssemblyInfo.cs두 가지 값이 있습니다.

다음 코드는 세미콜론으로 구분된 하나의 Include 특성에 두 파일을 선언하여 동일한 항목 형식을 만듭니다.

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

자세한 내용은 항목참조하세요.

항목 형식 값 검사

항목 형식의 값을 얻으려면 다음 구문을 사용합니다. 여기서 ItemType 항목 형식의 이름입니다.

@(ItemType)

이 구문을 사용하여 프로젝트 파일에서 Compile 항목 유형을 검사합니다.

항목 유형 값을 검사하려면

1. 코드 편집기에서 HelloWorld 대상 작업을 다음 코드로 바꿉다.

   <Target Name="HelloWorld">
     <Message Text="Compile item type contains @(Compile)" />
   </Target>
   

2. 프로젝트 파일을 저장합니다.

3. 명령 창다음 줄을 입력하고 실행합니다.

   msbuild buildapp.csproj -t:HelloWorld
   

4. 출력을 검사합니다. 이 긴 줄을 보셔야 합니다.

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

항목 형식의 값은 기본적으로 세미콜론으로 구분됩니다.

항목 형식의 구분 기호를 변경하려면 다음 구문을 사용합니다. 여기서 ItemType은 항목 형식이고 구분 기호는 하나 이상의 구분 문자 문자열입니다.

@(ItemType, Separator)

Message 작업을 변경하여 캐리지 리턴 및 줄 바꿈(%0A%0D)을 사용하여 컴파일 항목을 각각 한 줄에 표시합니다.

항목 유형 값을 줄당 하나씩 표시하려면

1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉다.

   <Message Text="Compile item type contains @(Compile, '%0A%0D')" />
   

2. 프로젝트 파일을 저장합니다.

3. 명령 창다음 줄을 입력하고 실행합니다.

   msbuild buildapp.csproj -t:HelloWorld
   

4. 출력을 검사합니다. 다음 줄을 볼 수 있어야 합니다.

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

포함, 제외 및 와일드카드

Include 특성과 함께 와일드카드 "*", "**" 및 "?"를 사용하여 항목 유형에 항목을 추가할 수 있습니다. 예를 들어

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

이미지 폴더에 있는 파일 확장자 .jpeg의 모든 파일을 사진 항목 유형에 추가합니다.

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

는 파일 확장명의 .jpeg 있는 모든 파일을 이미지 폴더에 추가하고 모든 하위 폴더를 사진 항목 유형에 추가합니다. 자세한 예제는 방법:빌드할 파일 선택.을 참조하세요.

항목이 선언되면 항목 유형에 추가됩니다. 예를 들어

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

는 .jpeg 또는 .gif파일 확장자를 사용하여 이미지 폴더의 모든 파일을 포함하는 Photo라는 항목 형식을 만듭니다. 이러한 줄은 다음 줄과 동일합니다.

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

Exclude 특성을 사용하여 항목 형식에서 항목을 제외할 수 있습니다. 예를 들어

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

이름에 문자열 Designer포함된 파일을 제외하고 파일 확장명 .cs 있는 모든 파일을 Compile 항목 형식에 추가합니다. 자세한 예제는 방법: 빌드파일 제외를 참조하세요.

Exclude 특성은 둘 다 포함된 항목 요소의 Include 특성에 의해 추가된 항목에만 영향을 줍니다. 예를 들어

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

는 이전 항목 요소에 추가된 파일 Form1.cs제외하지 않습니다.

항목을 포함 및 제외하려면

1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉다.

   <Message Text="XFiles item type contains @(XFiles)" />
   

2. Import 요소 바로 다음 항목 그룹을 추가합니다.

   <ItemGroup>
      <XFiles Include="*.cs;properties/*.resx" Exclude="*Designer*" />
   </ItemGroup>
   

3. 프로젝트 파일을 저장합니다.

4. 명령 창다음 줄을 입력하고 실행합니다.

   msbuild buildapp.csproj -t:HelloWorld
   

5. 출력을 검사합니다. 다음 줄을 보세요.

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

항목 메타데이터

항목은 Include 및 Exclude 특성에서 수집된 정보 외에 메타데이터를 포함할 수 있습니다. 항목 값보다 항목에 대한 자세한 정보가 필요한 작업은 이 메타데이터를 사용할 수 있습니다.

항목 메타데이터는 메타데이터 이름이 항목의 자식 요소인 요소를 만들어 프로젝트 파일에 선언됩니다. 항목에는 메타데이터 값이 0개 이상 있을 수 있습니다. 예를 들어 다음 CSFile 항목에는 값이 "Fr"인 Culture 메타데이터가 있습니다.

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

항목 형식의 메타데이터 값을 얻으려면 다음 구문을 사용합니다. 여기서 ItemType 항목 형식의 이름이고 MetaDataName은 메타데이터의 이름입니다.

%(ItemType.MetaDataName)

항목 메타데이터를 검사하려면

1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉다.

   <Message Text="Compile.DependentUpon: %(Compile.DependentUpon)" />
   

2. 프로젝트 파일을 저장합니다.

3. 명령 창다음 줄을 입력하고 실행합니다.

   msbuild buildapp.csproj -t:HelloWorld
   

4. 출력을 검사합니다. 다음 줄을 보시게 될 것입니다.

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

"Compile.DependentUpon"이라는 구가 여러 번 나타나는지 확인합니다. 대상 내에서 이 구문과 함께 메타데이터를 사용하면 "일괄 처리"가 발생합니다. 일괄 처리는 대상 내의 태스크가 각 고유 메타데이터 값에 대해 한 번 실행됨을 의미합니다. 일괄 처리는 일반적인 "foreach 루프" 프로그래밍 구문에 해당하는 MSBuild 스크립트입니다. 자세한 내용은 Batching참조하세요.

잘 알려진 메타데이터

항목 목록에 항목이 추가되면 해당 항목에 잘 알려진 메타데이터가 할당됩니다. 예를 들어 %(Filename) 항목의 파일 이름을 반환합니다. 잘 알려진 메타데이터의 전체 목록은 잘 알려진 항목 메타데이터 참조하세요.

잘 알려진 메타데이터를 검사하려면

1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉다.

   <Message Text="Compile Filename: %(Compile.Filename)" />
   

2. 프로젝트 파일을 저장합니다.

3. 명령 창다음 줄을 입력하고 실행합니다.

   msbuild buildapp.csproj -t:HelloWorld
   

4. 출력을 검사합니다. 다음 줄을 확인하세요.

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

앞의 두 예제를 비교하면 Compile 항목 형식의 모든 항목에 DependentUpon 메타데이터가 있는 것은 아니지만 모든 항목에는 잘 알려진 Filename 메타데이터가 있음을 알 수 있습니다.

메타데이터 변환

항목 목록을 새 항목 목록으로 변환할 수 있습니다. 항목 목록을 변환하려면 다음 구문을 사용합니다. 여기서 <ItemType> 항목 형식의 이름이고 <MetadataName> 메타데이터의 이름입니다.

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

예를 들어 원본 파일의 항목 목록은 @(SourceFiles -> '%(Filename).obj')같은 식을 사용하여 개체 파일의 컬렉션으로 변환할 수 있습니다. 자세한 내용은 변환참조하세요.

메타데이터를 사용하여 항목을 변환하려면

1. 코드 편집기에서 메시지 작업을 다음 줄로 바꿉다.

   <Message Text="Backup files: @(Compile->'%(filename).bak')" />
   

2. 프로젝트 파일을 저장합니다.

3. 명령 창다음 줄을 입력하고 실행합니다.

   msbuild buildapp.csproj -t:HelloWorld
   

4. 출력을 검사합니다. 이 줄을 보시면 됩니다.

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

이 구문에 표현된 메타데이터는 일괄 처리를 일으키지 않습니다.

다음 단계

Windows에서 간단한 프로젝트 파일을 한 단계씩 만드는 방법을 배우려면, 처음부터 MSBuild 프로젝트 파일을 만들어 보세요.

주로 .NET SDK를 사용하는 경우 .NET SDK 프로젝트 MSBuild 참조에서 계속 읽어 보세요.

관련 콘텐츠

• MSBuild 개요
• MSBuild 참조