Cómo: Usar eventos de compilación en proyectos de MSBuild

Un evento de compilación es un comando que MSBuild ejecuta en una fase concreta del proceso de compilación. El evento de la pre- compilación se produce antes de que comience la compilación, el evento de pre- vínculo aparece antes de que comience el paso de vinculación; y el evento posterior a la compilación se produce después de que finalice la compilación correctamente. Un evento de compilación sólo aparece si el paso asociado de compilación aparece. Por ejemplo, el evento anterior a la vinculación no se produce si no se ejecuta el paso de vinculación.

Cada uno de los tres eventos de compilación se representa en un grupo de definición de elementos mediante un elemento de comando (<Command>) que se ejecuta y un elemento de mensaje (<Message>) que se muestra cuando MSBuild ejecuta el evento de compilación. Cada elemento es opcional y, si se especifica el mismo elemento varias veces, la última tiene prioridad.

El elemento opcional de la uso-en- compilación (<build-eventUseInBuild>) se puede especificar en un grupo de propiedades para indicar si se ejecuta el evento de compilación. El valor del contenido de un elemento use-in-build es true o false. De forma predeterminada, un evento de compilación se ejecuta a menos que su elemento use-in-build esté establecido en false.

En la siguiente tabla se incluye cada elemento XML del evento de compilación:

Elemento XML	Descripción
PreBuildEvent	Este evento se ejecuta antes de que comience la compilación.
PreLinkEvent	Este evento se ejecuta antes de que comience el paso de vinculación.
PostBuildEvent	Este evento se ejecuta cuando finaliza la compilación.

En la siguiente tabla se incluye cada elemento use-in-build:

Elemento XML	Descripción
PreBuildEventUseInBuild	Especifica si se debe ejecutar el evento anterior a la compilación.
PreLinkEventUseInBuild	Especifica si se debe ejecutar el evento anterior a la vinculación.
PostBuildEventUseInBuild	Especifica si se debe ejecutar el evento posterior a la compilación.

Ejemplo

El siguiente ejemplo se puede agregar dentro del elemento Project del archivo myproject.vcxproj creado en Tutorial: Usar MSBuild para crear un proyecto de Visual C++. Un evento anterior a la compilación realiza una copia de main.cpp, un evento anterior a la vinculación realiza una copia de main.obj y un evento posterior a la compilación realiza una copia de myproject.exe. Si el proyecto se compila con una configuración de lanzamiento, se ejecutan los eventos de compilación. Si el proyecto se compila con una configuración de depuración, no se ejecutan los eventos de compilación.

  <ItemDefinitionGroup>
    <PreBuildEvent>
      <Command>copy $(ProjectDir)main.cpp $(ProjectDir)copyOfMain.cpp</Command>
      <Message>Making a copy of main.cpp </Message>
    </PreBuildEvent>
    <PreLinkEvent>
   <Command>copy $(ProjectDir)$(Configuration)\main.obj $(ProjectDir)$(Configuration)\copyOfMain.obj</Command>
      <Message>Making a copy of main.obj</Message>
    </PreLinkEvent>
    <PostBuildEvent>
   <Command>copy $(ProjectDir)$(Configuration)\$(TargetFileName) $(ProjectDir)$(Configuration)\copyOfMyproject.exe</Command>
      <Message>Making a copy of myproject.exe</Message>
    </PostBuildEvent>
  </ItemDefinitionGroup>
 
  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
    <PreBuildEventUseInBuild>true</PreBuildEventUseInBuild>
    <PreLinkEventUseInBuild>true</PreLinkEventUseInBuild>
    <PostBuildEventUseInBuild>true</PostBuildEventUseInBuild>
  </PropertyGroup>

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">
    <PreBuildEventUseInBuild>false</PreBuildEventUseInBuild>
    <PreLinkEventUseInBuild>false</PreLinkEventUseInBuild>
    <PostBuildEventUseInBuild>false</PostBuildEventUseInBuild>
  </PropertyGroup>

Vea también

Tareas

Tutorial: Usar MSBuild para crear un proyecto de Visual C++

Otros recursos

MSBuild (Visual C++)