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

이 연습에서는 명령 프롬프트에서 MSBuild를 사용하여 Visual Studio C++ 프로젝트를 빌드하는 방법을 보여 줍니다. Visual C++ 콘솔 애플리케이션용 XML 기반 .vcxproj 프로젝트 파일을 만드는 방법을 알아봅니다. 프로젝트를 빌드한 후 빌드 프로세스를 사용자 지정하는 방법을 배웁니다.

Important

Visual Studio IDE를 사용하여 나중에 프로젝트 파일을 편집하려는 경우에는 이 방법을 사용하지 마세요. .vcxproj 파일을 수동으로 만드는 경우 특히 프로젝트가 프로젝트 항목에 와일드카드를 사용하면 Visual Studio IDE를 편집하거나 로드하지 못할 수도 있습니다. 자세한 내용은 .vcxproj 및 .props 파일 구조와 .vcxproj 파일 및 와일드카드를 참조하세요.

이 연습에서는 다음 작업을 설명합니다.

• 프로젝트를 위한 C++ 원본 파일 만들기
• XML MSBuild 프로젝트 파일 만들기
• MSBuild를 사용하여 프로젝트 빌드
• MSBuild를 사용하여 프로젝트 사용자 지정

필수 조건

이 연습을 완료하려면 다음 필수 조건을 충족해야 합니다.

• C++를 사용한 데스크톱 개발 워크로드가 설치된 Visual Studio 복사본이 필요합니다.
• MSBuild 시스템에 대해 전반적으로 이해합니다.

참고 항목

대부분의 하위 수준 빌드 지침은 기본 대상 폴더에 정의된 .targets 및 .props 파일에 포함되어 있습니다($(VCTargetsPath) 속성에 저장되어 있음). 이 위치에 Microsoft.Cpp.Common.props와 같은 파일이 있습니다. 이 파일의 기본 경로는 %VSINSTALLDIR%MSBuild\Microsoft\VC\<version>\입니다. <version> 경로 요소는 Visual Studio 버전에 해당됩니다. Visual Studio 2019의 경우 v160입니다. Visual Studio 2017의 경우 이 파일은 %VSINSTALLDIR%Common7\IDE\VC\VCTargets\에 저장됩니다. Visual Studio 2015 이전 버전에서는 %ProgramFiles(x86)%\MSBuild\Microsoft.Cpp\v4.0\<version>\에 저장됩니다.

C++ 소스 파일 만들기

이 연습에서는 원본 파일 및 헤더 파일이 있는 프로젝트를 만듭니다. 소스 파일 main.cpp에는 콘솔 애플리케이션의 main 함수가 포함되어 있습니다. 헤더 파일 main.h에는 <iostream> 헤더 파일을 포함하는 코드가 포함되어 있습니다. 이러한 C++ 파일을 Visual Studio 또는 Visual Studio Code와 같은 텍스트 편집기를 사용하여 만들 수 있습니다.

프로젝트를 위한 C++ 원본 파일을 만들려면

1. 프로젝트에 대한 폴더를 만듭니다.

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

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

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

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

XML MSBuild 프로젝트 파일 만들기

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

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

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

1. 텍스트 편집기를 사용하여 myproject.vcxproj라는 프로젝트 파일을 만든 다음, 여기 나온 루트 <Project> 요소를 추가합니다. Visual Studio 2015를 사용 중인 경우 ToolsVersion="14.0"을 사용하고, Visual Studio 2017을 사용 중인 경우 ToolsVersion="15.0"을 사용하고, Visual Studio 2019를 사용 중인 경우 ToolsVersion="16.0"을 사용합니다.

   <Project DefaultTargets="Build" ToolsVersion="16.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
   </Project>
   

   루트 <Project> 태그 간 다음 절차 단계에 요소를 삽입합니다.

2. 다음 두 개의 <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>
   

3. 이 프로젝트를 위한 기본 C++ 설정의 경로를 지정하는 <Import> 요소를 추가합니다.

   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.default.props" />
   

4. <ConfigurationType>, <PlatformToolset>의 두 프로젝트 속성을 지정하는 속성 그룹 요소(<PropertyGroup>)를 추가합니다. Visual Studio 2015를 사용 중인 경우 <PlatformToolset> 값으로 v140을 사용하고, Visual Studio 2017을 사용 중인 경우 v141을 사용하고, Visual Studio 2019를 사용 중인 경우 v142를 사용합니다.

   <PropertyGroup>
     <ConfigurationType>Application</ConfigurationType>
     <PlatformToolset>v142</PlatformToolset>
   </PropertyGroup>
   

5. 이 프로젝트를 위한 현재 C++ 설정의 경로를 지정하는 <Import> 요소를 추가합니다.

   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
   

6. <ItemGroup> 요소에 <ClCompile> 자식 요소를 추가합니다. 자식 요소는 컴파일할 C/C++ 원본 파일의 이름을 지정합니다.

   <ItemGroup>
     <ClCompile Include="main.cpp" />
   </ItemGroup>
   

   참고 항목

   <ClCompile>은 ‘빌드 대상’이며 기본 대상 폴더에서 정의됩니다.

7. <ItemGroup> 요소에 <ClInclude> 자식 요소를 추가합니다. 자식 요소는 C/C++ 원본 파일에 사용할 헤더 파일의 이름을 지정합니다.

   <ItemGroup>
     <ClInclude Include="main.h" />
   </ItemGroup>
   

8. 이 프로젝트를 위한 대상을 정의하는 파일의 경로를 지정하는 <Import> 요소를 추가합니다.

   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.Targets" />
   

전체 프로젝트 파일

다음 코드는 이전 절차에서 만든 전체 프로젝트 파일을 보여 줍니다. Visual Studio 2017의 경우 ToolsVersion="15.0"을 사용하고 Visual Studio 2015의 경우 ToolsVersion="14.0"을 사용합니다.

<Project DefaultTargets="Build" ToolsVersion="16.0" xmlns="http://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>
    <PlatformToolset>v142</PlatformToolset>
  </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, MSBuild에서!" 표시되어야 합니다.

프로젝트 사용자 지정

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

• 빌드 대상과 함께 MSBuild 사용
• 빌드 속성과 함께 MSBuild 사용
• 64비트 컴파일러 및 도구와 함께 MSBuild 사용
• 다른 도구 집합과 함께 MSBuild 사용
• MSBuild 사용자 지정 추가

빌드 대상과 함께 MSBuild 사용

빌드 대상은 미리 정의되거나 사용자가 정의한 명령의 명명된 세트로, 빌드하는 동안 실행할 수 있습니다. 대상 명령줄 옵션(/t)을 사용하여 빌드 대상을 지정합니다. myproject 예제 프로젝트의 경우 미리 정의된 clean 대상은 디버그 폴더의 모든 파일을 삭제하고 새 로그 파일을 만듭니다.

명령 프롬프트 창에 다음 명령을 입력하여 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

64비트 컴파일러 및 도구와 함께 MSBuild 사용

64비트 Windows에 Visual Studio를 설치한 경우 64비트 x64 네이티브 및 크로스 도구가 기본적으로 설치됩니다. PreferredToolArchitecture 속성을 설정하면 64비트 컴파일러 및 도구를 사용하여 애플리케이션을 빌드하도록 MSBuild를 구성할 수 있습니다. 이 속성은 프로젝트 구성 또는 플랫폼 속성에 영향을 주지 않습니다. 기본적으로, 도구의 32비트 버전이 사용됩니다. 64비트 버전의 컴파일러 및 도구를 지정하려면 Myproject.vcxproj 프로젝트 파일에서 Microsoft.Cpp.default.props 파일 <Import /> 요소 뒤에 다음 속성 그룹 요소를 추가합니다.

<PropertyGroup>
    <PreferredToolArchitecture>x64</PreferredToolArchitecture>
</PropertyGroup>

64비트 도구를 사용하여 애플리케이션을 빌드하려면 명령 프롬프트에서 다음 명령을 입력합니다.

msbuild myproject.vcxproj /p:PreferredToolArchitecture=x64

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

다른 버전의 Visual C++를 위한 도구 집합과 라이브러리가 설치되어 있는 경우 MSBuild는 현재 Visual C++ 버전 또는 다른 설치된 버전을 위한 애플리케이션을 빌드할 수 있습니다. 예를 들어 Visual Studio 2012를 설치한 경우 Windows XP를 위한 Visual C++ 11.0 도구 집합을 지정하려면 Myproject.vcxproj 프로젝트 파일에서 Microsoft.Cpp.props 파일 <Import /> 요소 뒤에 다음 속성 그룹 요소를 추가합니다.

<PropertyGroup>
    <PlatformToolset>v110_xp</PlatformToolset>
</PropertyGroup>

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

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

MSBuild 사용자 지정 추가

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

• 방법: MSBuild 프로젝트에 사용자 지정 빌드 단계 추가
• 방법: MSBuild 프로젝트에 사용자 지정 빌드 도구 추가
• 방법: MSBuild 프로젝트에서 빌드 이벤트 사용

참고 항목

• MSBuild 프로젝트의 vcpkg
• 자습서: Visual Studio에서 MSBuild에서 패키지 설치 및 사용