Especificando eventos de compilação

Você pode usar eventos de compilação para especificar comandos que são executados antes do início da compilação, antes do processo de link ou após a conclusão da compilação.

Os eventos de compilação são executados somente se a compilação atingir com êxito esses pontos no processo de compilação. Se ocorrer um erro na compilação, o evento pós-compilação não ocorrerá; Se o erro ocorrer antes da fase de vinculação, nem o evento pré-link nem o pós-compilação ocorrerão. Além disso, se nenhum arquivo precisar ser vinculado, o evento de pré-link não ocorrerá. O evento pre-link também não está disponível em projetos que não contenham uma etapa de link.

Se nenhum arquivo precisar ser criado, nenhum evento de compilação ocorrerá.

Para obter informações gerais sobre eventos de compilação, consulte Noções básicas sobre etapas de compilação personalizadas e eventos de compilação.

Para especificar um evento de compilação

1. Em Gerenciador de Soluções, selecione o projeto para o qual você deseja especificar o evento de compilação.

2. Abra a caixa de diálogo Property Pages do projeto. Para obter mais informações, consulte Definir compilador C++ e criar propriedades no Visual Studio.

3. Na pasta Build Events , selecione uma página de propriedades do evento de compilação.

4. Especifique as propriedades associadas ao evento build:

   • Em Linha de Comando, especifique um comando como se estivesse especificando-o no prompt de comando. Especifique um comando ou arquivo em lotes válido e todos os arquivos de entrada ou saída necessários. Especifique o comando call batch antes do nome de um arquivo em lotes para garantir que todos os comandos subsequentes sejam executados.

     Vários arquivos de entrada e saída podem ser especificados simbolicamente com macros MSBuild. Para obter informações sobre como especificar o local dos arquivos ou os nomes dos conjuntos de arquivos, consulte Macros comuns para comandos e propriedades de compilação.

     Como o caractere '%' é reservado pelo MSBuild, se você especificar uma variável de ambiente, substitua cada % caractere de escape pela %25 sequência de escape hexadecimal. Por exemplo, substitua %WINDIR% por %25WINDIR%25. MSBuild substitui cada sequência %25 pelo carácter % antes de aceder à variável de ambiente.

   • Em Descrição, digite uma descrição para este evento. A descrição é impressa na janela Saída quando esse evento ocorre.

   • Em Excluído da compilação, especifique Sim se não quiser que o evento seja executado.

Ver também

Noções básicas sobre etapas de compilação personalizadas e eventos de compilação
Macros comuns para comandos de compilação e propriedades
Solução de problemas de personalizações de compilação