演练：使用 MSBuild 创建 Visual Studio C++ 项目

创建 C++ 源文件

在本演练中，将创建具有源文件和头文件的项目。源文件 main.cpp 包含控制台应用程序的 main 函数。头文件 main.h 包含代码以包括 <iostream> 头文件。可以通过使用 Visual Studio 或类似 Visual Studio Code 的文本编辑器来创建这些 C++ 文件。
为项目创建 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> 元素包含七个子元素：
三个项组标记 (<ItemGroup>)，用于指定项目配置和平台、源文件名和头文件名。
三个导入标记 (<Import>)，用于指定 Microsoft Visual C++ 设置的位置。
一个属性组标记 (<PropertyGroup>)，用于指定项目设置。
创建 MSBuild 项目文件
使用文本编辑器创建名为 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> 标记之间。
在 <ItemGroup> 元素中添加这两个 <ProjectConfiguration> 子元素。 该子元素指定 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>
添加 <Import> 元素，该元素指定此项目的默认 C++ 设置的路径：
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.default.props" />
添加属性组元素 (<PropertyGroup>)，该元素指定两个项目属性，<ConfigurationType> 和 <PlatformToolset>。 （如果使用的是 Visual Studio 2015，请使用 v140 作为 <PlatformToolset> 值；如果使用的是 Visual Studio 2017，则使用 v141；如果使用的是 Visual Studio 2019，则使用 v142。）
<PropertyGroup>
  <ConfigurationType>Application</ConfigurationType>
  <PlatformToolset>v142</PlatformToolset>
</PropertyGroup>
添加 <Import> 元素，该元素指定此项目的当前 C++ 设置的路径：
<Import Project="$(VCTargetsPath)\Microsoft.Cpp.props" />
在 <ItemGroup> 元素中添加 <ClCompile> 子元素。 该子元素指定要编译的 C/C++ 源文件的名称：
<ItemGroup>
  <ClCompile Include="main.cpp" />
</ItemGroup>
<ClCompile> 是生成目标，在默认目标文件夹中进行定义。
在 <ItemGroup> 元素中添加 <ClInclude> 子元素。 该子元素指定 C/C++ 源文件的头文件的名称：
<ItemGroup>
  <ClInclude Include="main.h" />
</ItemGroup>
添加 <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 程序。 完成生成过程后，请使用此命令从 debug 文件夹中运行应用程序：
myproject
应用程序应在控制台窗口中显示“Hello, from MSBuild!”。
对项目进行自定义
使用 MSBuild，可以执行预定义的生成目标、应用用户定义的属性并使用自定义工具、事件和生成步骤。 本部分阐释了这些任务：
将 MSBuild 和生成目标配合使用。
将 MSBuild 和生成属性配合使用。
将 MSBuild 和 64 位编译器和工具配合使用。
将 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
将 MSBuild 和 64 位编译器和工具配合使用
如果在 64 位 Windows 上安装了 Visual Studio，则默认情况下将安装 64 位 x64 本机和兼容工具。 可以配置 MSBuild，通过设置 PreferredToolArchitecture 属性以使用 64 位编译器和工具来生成自己的应用程序。 此属性不会影响项目配置或平台属性。 默认采用 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 项目中使用生成事件