如何：向 MSBuild 项目添加自定义生成步骤

自定义生成步骤是生成中的用户定义的步骤。 自定义生成步骤的行为类似于任何其他命令工具步骤，如标准编译或链接工具步骤。

在项目文件 (.vcxproj) 中指定自定义生成步骤。 该步骤可指定要执行的命令行、任何其他输入或输出文件，以及要显示的消息。 如果 MSBuild 确定输出文件相对于输入文件而言已过期，则会显示消息并执行命令。

若要在生成目标序列中指定自定义生成步骤的位置，请在项目文件中使用 CustomBuildAfterTargets 和 CustomBuildBeforeTargets XML 元素中的一个或两个。 例如，可以指定自定义生成步骤在链接工具目标之后以及在清单工具目标之前运行。 实际的可用目标集取决于特定生成。

指定 CustomBuildBeforeTargets 元素可在特定目标运行之前执行自定义生成步骤，指定 CustomBuildAfterTargets 元素可在特定目标运行之后执行步骤，或同时指定这两个元素可在两个相邻目标之间执行步骤。 如果未指定任一元素，则自定义生成工具会在其默认位置（链接目标之后）执行。

自定义生成步骤和自定义生成工具共享在 CustomBuildBeforeTargets 和 CustomBuildAfterTargets XML 元素中指定的信息。 因此，只需在项目文件中指定这些目标一次。

定义自定义生成步骤执行的操作

1. 将属性组添加到项目文件。 在此属性组中，指定命令、其输入和输出以及消息，如下面的示例中所示。 此示例通过在演练：使用 MSBuild 创建 C++ 项目中创建的 main.cpp 文件来创建 .cab 文件。

   <ItemDefinitionGroup>
     <CustomBuildStep>
       <Command>makecab.exe $(ProjectDir)main.cpp $(TargetName).cab</Command>
       <Outputs>$(TargetName).cab</Outputs>
       <Inputs>$(ProjectDir)main.cpp</Inputs>
     </CustomBuildStep>
   </ItemDefinitionGroup>
   

定义在生成中执行自定义生成步骤的位置

1. 将以下属性组添加到项目文件。 可以同时指定这两个目标，如果只想在特定目标之前或之后执行自定义步骤，也可以省略一个目标。 此示例告知 MSBuild 在编译步骤之后，但在链接步骤之前执行自定义步骤。

   <PropertyGroup>
     <CustomBuildAfterTargets>ClCompile</CustomBuildAfterTargets>
     <CustomBuildBeforeTargets>Link</CustomBuildBeforeTargets>
   </PropertyGroup>
   

另请参阅

演练：使用 MSBuild 创建 C++ 项目
如何：在 MSBuild 项目中使用生成事件
如何：向 MSBuild 项目添加自定义生成工具