연습: MSBuild를 사용하여 Visual C++ 프로젝트 만들기

아티클
08/10/2011

업데이트: 2011년 4월

이 연습에서는 MSBuild를 사용하여 Visual C++ 프로젝트를 명령 프롬프트에서 빌드하는 방법을 보여 줍니다. 이 연습을 통해 Visual C++ 콘솔 응용 프로그램용 C++ 소스 파일 및 XML 기반 프로젝트 파일을 만드는 방법을 배우게 됩니다. 프로젝트를 빌드한 후에는 빌드 프로세스를 사용자 지정하는 방법을 배웁니다.

이 연습에서는 다음 작업을 수행합니다.

프로젝트의 C++ 소스 파일 만들기
XML MSBuild 프로젝트 파일 만들기
MSBuild를 사용하여 프로젝트 빌드
MSBuild를 사용하여 프로젝트 사용자 지정

사전 요구 사항

이 연습을 진행하려면 먼저 다음 작업을 수행해야 합니다.

Visual Studio 2010
MSBuild 시스템에 대한 전반적인 이해

C++ 소스 파일 만들기

이 연습에서는 소스 파일 및 헤더 파일이 하나씩 있는 프로젝트를 만듭니다. 소스 파일인 main.cpp에는 콘솔 응용 프로그램의 main 함수가 포함되고, 헤더 파일인 main.h에는 iostream 헤더 파일을 포함하는 코드가 포함됩니다. 이러한 C++ 파일은 Visual Studio 또는 텍스트 편집기를 사용하여 만들 수 있습니다.

프로젝트의 C++ 소스 파일을 만들려면

프로젝트의 디렉터리를 만듭니다.

main.cpp라는 파일을 만들고 다음 코드를 이 파일에 추가합니다.

// main.cpp : the application source code.
#include <iostream>
#include "main.h"
int main()
{
   std::cout << "Hello, from MSBuild!\n";
   return 0;
}

main.h라는 파일을 만들고 다음 코드를 이 파일에 추가합니다.

// main.h: the application header code.
/* Additional source code to include. */

XML MSBuild 프로젝트 파일 만들기

MSBuild 프로젝트 파일은 프로젝트 루트 요소(<Project>)를 포함하는 XML 파일입니다. 다음 예제 프로젝트에서 <Project> 요소에는 자식 요소가 7개 있습니다.

프로젝트 구성과 플랫폼, 소스 파일 이름 및 헤더 파일 이름을 지정하는 항목 그룹 태그(<ItemGroup>) 3개
Microsoft Visual C++ 설정의 위치를 지정하는 가져오기 태그(<Import>) 3개
프로젝트 설정을 지정하는 속성 그룹 태그(<PropertyGroup>) 1개

MSBuild 프로젝트 파일을 만들려면

텍스트 편집기를 사용하여 myproject.vcxproj라는 프로젝트 파일을 만들고 다음과 같은 <Project> 루트 요소를 추가합니다. 이 절차의 다음 단계에서 <Project> 루트 태그 사이에 루트 요소를 삽입합니다.
```
<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
</Project>
```

다음과 같은 자식 요소 <ProjectConfiguration> 두 개를 <ItemGroup> 요소에 추가합니다. 이 자식 요소는 32비트 Windows 운영 체제에 대해 디버그 및 릴리스 구성을 지정합니다.

<ItemGroup>
   <ProjectConfiguration Include="Debug|Win32">
      <Configuration>Debug</Configuration>
      <Platform>Win32</Platform>
   </ProjectConfiguration>
   <ProjectConfiguration Include="Release|Win32">
      <Configuration>Release</Configuration>
      <Platform>Win32</Platform>
   </ProjectConfiguration>
</ItemGroup>

이 프로젝트에 대한 기본 C++ 설정의 경로를 지정하는 다음과 같은 <Import/> 요소를 추가합니다.
```
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.default.props" />
```

두 프로젝트 속성을 지정하는 다음과 같은 속성 그룹 요소(<PropertyGroup>)를 추가합니다.

<PropertyGroup>
   <ConfigurationType>Application</ConfigurationType>
   <ShowAllFiles>false</ShowAllFiles>
</PropertyGroup>

이 프로젝트에 대한 현재 C++ 설정의 경로를 지정하는 다음과 같은 <Import/> 요소를 추가합니다.
```
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
```
<ImportGroup> 요소에 다음과 같은 <ClCompile> 자식 요소를 추가합니다. 이 자식 요소는 컴파일할 C/C++ 소스 파일의 이름을 지정합니다.
```
<ItemGroup>
   <ClCompile Include="main.cpp" />
</ItemGroup>
```
<ImportGroup> 요소에 다음과 같은 <ClInclude> 자식 요소를 추가합니다. 이 자식 요소는 C/C++ 소스 파일에서 필요한 헤더 파일의 이름을 지정합니다.
```
<ItemGroup>
   <ClInclude Include="main.h" />
</ItemGroup>
```
이 프로젝트의 대상을 정의하는 파일의 경로를 지정하는 다음과 같은 <Import> 요소를 추가합니다.
```
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.Targets" />
```

전체 프로젝트 파일

다음 코드는 앞의 절차에서 만든 전체 프로젝트 파일을 보여 줍니다.

<Project DefaultTargets="Build" ToolsVersion="4.0" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <ProjectConfiguration Include="Debug|Win32">
      <Configuration>Debug</Configuration>
      <Platform>Win32</Platform>
    </ProjectConfiguration>
    <ProjectConfiguration Include="Release|Win32">
      <Configuration>Release</Configuration>
      <Platform>Win32</Platform>
    </ProjectConfiguration>
  </ItemGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.default.props" />
  <PropertyGroup>
    <ConfigurationType>Application</ConfigurationType>
    <ShowAllFiles>false</ShowAllFiles>
  </PropertyGroup>
  <Import Project="$(VCTargetsPath)/Microsoft.Cpp.props" />
  <ItemGroup>
    <ClCompile Include="main.cpp" />
  </ItemGroup>
  <ItemGroup>
    <ClInclude Include="main.h" />
  </ItemGroup>
  <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Targets" />
</Project>

MSBuild를 사용하여 프로젝트 빌드

명령 프롬프트에서 다음 명령을 입력하여 콘솔 응용 프로그램을 빌드합니다.

msbuild myproject.vcxproj /p:configuration=debug

MSBuild에서는 출력 파일을 저장할 디렉터리를 만든 다음, 프로젝트를 컴파일 및 링크하여 Myproject.exe 프로그램을 생성합니다. 빌드 프로세스가 끝나면 다음 명령을 사용하여 응용 프로그램을 실행합니다.

myproject

응용 프로그램의 콘솔 창에 "Hello, from MSBuild!"가 표시됩니다.

프로젝트 사용자 지정

MSBuild를 사용하면 미리 정의된 빌드 대상을 실행하고, 사용자 정의 속성을 적용할 수 있고 사용자 지정 도구, 이벤트 및 빌드 단계를 사용할 수 있습니다. 이 단원에서는 다음 작업에 대해 설명합니다.

빌드 대상과 함께 MSBuild 사용
빌드 속성과 함께 MSBuild 사용
다른 도구 집합과 함께 MSBuild 사용
MSBuild 사용자 지정 추가

빌드 대상과 함께 MSBuild 사용

빌드 대상은 빌드 중에 실행할 수 있는 미리 정의되거나 사용자 정의된 명령의 명명된 집합입니다. 빌드 대상을 지정하려면 대상 명령줄 옵션(/t)을 사용합니다. myproject 예제 프로젝트의 경우 미리 정의된 clean 대상은 Debug 폴더에서 모든 파일을 삭제하고 새 로그 파일을 만듭니다.

myproject를 정리하려면 명령 프롬프트에 다음 명령을 입력합니다.

msbuild myproject.vcxproj /t:clean

빌드 속성과 함께 MSBuild 사용

속성 명령줄 옵션(/p)을 사용하면 프로젝트 빌드 파일에서 속성을 재정의할 수 있습니다. myproject 예제 프로젝트에서 릴리스 또는 디버그 빌드 구성은 Configuration 속성으로 지정되고, 빌드한 응용 프로그램을 실행할 운영 체제는 Platform 속성으로 지정됩니다.

32비트 Windows에서 실행될 myproject 응용 프로그램의 디버그 빌드를 만들려면 명령 프롬프트에서 다음 명령을 입력합니다.

msbuild myproject.vcxproj /p:configuration=debug /p:platform=win32

myproject 예제 프로젝트에서 64비트 Windows용 구성 및 사용자 지정 운영 체제용으로 myplatform이라는 다른 구성도 정의하는 것으로 가정해 봅니다.

이 경우 64비트 Windows에서 실행되는 릴리스 빌드를 만들려면 명령 프롬프트에서 다음 명령을 입력합니다.

msbuild myproject.vcxproj /p:configuration=release /p:platform=x64

myplatform용 릴리스 빌드를 만들려면 명령 프롬프트에서 다음 명령을 입력합니다.

msbuild myproject.vcxproj /p:configuration=release /p:platform=myplatform

다른 도구 집합과 함께 MSBuild 사용

Visual C++ 9.0 및 10.0 라이브러리(도구 집합)가 모두 설치되어 있는 경우 MSBuild에서는 Visual C++ 9.0 또는 10.0에 맞게 응용 프로그램을 빌드할 수 있습니다. Visual C++ 9.0 도구 집합을 지정하려면 다음 속성 그룹 요소를 Myproject.vcxproj 프로젝트 파일에서 Microsoft.Cpp.props <Import /> 요소 뒤에 추가합니다.

<PropertyGroup>
    <PlatformToolset>v90</PlatformToolset>
</PropertyGroup>

Visual C++ 9.0 도구 집합을 사용하여 프로젝트를 다시 빌드하려면 다음 명령 중 하나를 입력합니다.

msbuild myproject.vcxproj /p:PlatformToolset=v90 /t:rebuild 
msbuild myproject.vcxproj /t:rebuild

MSBuild 사용자 지정 추가

MSBuild에서는 빌드 프로세스를 사용자 지정할 수 있는 다양한 방법을 제공합니다. 다음 항목은 사용자 지정 빌드 단계, 도구 및 이벤트를 MSBuild 프로젝트에 추가하는 방법을 보여 줍니다.

변경 기록

날짜	변경 내용	이유
2011년 4월	첫 번째 코드 조각에서 "xmlns" 특성 주위에 따옴표가 추가되었습니다.	고객 의견

2011년 4월

첫 번째 코드 조각에서 "xmlns" 특성 주위에 따옴표가 추가되었습니다.

고객 의견

다음을 통해 공유