共用方式為


HOW TO:將自訂建置工具加入至 MSBuild 專案

自訂建置工具是使用者定義的命令列工具,此工具會與特定檔案相關聯。

針對特定檔案,在專案檔 (.vcxproj) 中指定要執行的命令列、任何其他輸入或輸出檔,以及要顯示的訊息。 如果 MSBuild 判斷相對於輸入檔而言,輸出檔已過期,則會顯示訊息並執行命令列工具。

若要指定何時執行自訂建置工具,請使用專案檔中的 CustomBuildBeforeTargetsCustomBuildAfterTargets XML 項目之一或兩者皆使用。 例如,您可以指定自訂建置工具執行於 MIDL 編譯器之後和 C/C++ 編譯器之前。 指定 CustomBuildBeforeTargets 項目,以在特定目標執行之前執行工具;指定 CustomBuildAfterTargets 項目,以在特定目標之後執行工具;或同時指定兩個項目,以在執行兩個目標之間執行工具。 如果兩個項目均未指定,自訂建置工具會在其預設位置執行,也就是在 MIDL 目標之前。

自訂建置步驟和自訂建置工具會共用在 CustomBuildBeforeTargetsCustomBuildAfterTargets XML 項目中指定的資訊。 在專案檔中指定這些目標一次即可。

若要加入自訂建置工具

  • 將項目群組加入至專案檔,並且為每一個輸入檔加入一個項目。 如下所示,指定命令、其他輸入、輸出及訊息做為項目中繼資料。 這個範例假設在專案的相同目錄中有 "faq.txt" 檔案。

      <ItemGroup>
        <CustomBuild Include="faq.txt">
          <Message>Copying readme...</Message>
          <Command>copy %(Identity) $(OutDir)%(Identity)</Command>
          <Outputs>$(OutDir)%(Identity)</Outputs>
        </CustomBuild>
      </ItemGroup>
    

若要定義自訂建置工具在組建中的執行位置

  • 將下列屬性群組加入至專案檔。 如果您只對於讓建置步驟在特定目標之前 (或之後) 執行有興趣,您必須指定至少一個目標,但您可以略過其他目標。 這個範例是在編譯之後但在連結之前執行自訂步驟。

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

請參閱

工作

逐步解說:使用 MSBuild 來建立 Visual C++ 專案

HOW TO:在 MSBuild 專案中使用建置事件

HOW TO:將自訂建置步驟加入至 MSBuild 專案