Como adicionar uma etapa de compilação personalizada a projetos MSBuild

Uma etapa de criação personalizado é uma etapa definido pelo usuário em uma compilação. Uma etapa personalizado de compilação se comporta como qualquer outra etapa da ferramenta de comando , como o padrão criar ou vincular a etapa da ferramenta.

Especifique uma etapa de criação personalizado no arquivo de projeto (.vcxproj). A etapa pode especificar uma linha de comando para executar, qualquer entrada ou arquivos de saída adicionais, e uma mensagem a ser exibida. Se MSBuild determina que os arquivos de saída são expirado em relação aos arquivos de entrada, exibe a mensagem e executa o comando.

Para especificar o local da etapa de criação personalizado na sequência de destinos de construção, use um ou ambos os elementos XML de CustomBuildAfterTargets e de CustomBuildBeforeTargets no arquivo de projeto. Por exemplo, você poderia especificar que as execuções personalizadas da etapa de compilação depois da ferramenta de link visam e antes de destino manifesto de ferramenta. O conjunto real de destinos disponíveis depende da construção específico.

Especifica o elemento de CustomBuildBeforeTargets para executar a etapa de criação personalizado antes que um destino específico executado, o elemento de CustomBuildAfterTargets para executar a etapa depois que um destino específico é executado, ou ambos os elementos para executar a etapa entre dois destinos adjacentes. Se nenhum elemento é especificado, a ferramenta de criação personalizado é executado no local padrão, que está depois que o destino de Link .

As etapas personalizadas da construção e as ferramentas personalizadas de compilação compartilham as informações especificadas em elementos XML de CustomBuildBeforeTargets e de CustomBuildAfterTargets . Consequentemente, especifique os destinos apenas uma vez no seu arquivo de projeto.

Para definir o que é executado pela etapa de criação personalizado

• Adicionar um grupo de propriedades para o arquivo de projeto. Neste grupo de propriedade, especifique o comando, suas entradas e saídas, e uma mensagem, conforme mostrado no exemplo a seguir. Este exemplo cria um arquivo .cab do arquivo de main.cpp que você criou em Instruções passo a passo: usando MSBuild para criar um projeto do Visual C++.

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

Para definir onde a etapa na criação personalizado de compilação executará

• Adicione o seguinte grupo de propriedades para o arquivo de projeto. Você pode especificar ambos os destinos, ou você pode omitir um se você deseja apenas a etapa personalizado para executar antes ou depois de destino específico. Este exemplo instrui MSBuild para executar a etapa personalizado depois que a etapa de compilação mas antes da etapa do link.

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

Consulte também

Tarefas

Instruções passo a passo: usando MSBuild para criar um projeto do Visual C++

Como usar eventos de compilação em projetos de MSBuild

Como adicionar ferramentas de compilação personalizadas a projetos MSBuild