Compartir vía


Especificar eventos de compilación

Los eventos de compilación se pueden usar para especificar comandos que se ejecuten antes de que se inicie la compilación, antes del proceso de vinculación o después de que finalice la compilación.

Los eventos de compilación se ejecutan solo si se alcanzan correctamente esos puntos en el proceso de compilación. Si se produce un error en la compilación, no se produce el evento posterior a la compilación; si el error se produce antes de la fase de vinculación, no se producen los eventos anterior a la vinculación ni posterior a la compilación. Además, si no es necesario vincular ningún archivo, el evento anterior a la vinculación no se produce. El evento anterior a la vinculación no está disponible en los proyectos que no contengan un paso de vinculación.

Si no es necesario compilar ningún archivo, no se producirá ningún evento de compilación.

Para obtener información general sobre los eventos de compilación, vea Descripción de los pasos de compilación personalizada y los eventos de compilación.

Para especificar un evento de compilación

  1. En el Explorador de soluciones, seleccione el proyecto para el que quiere especificar el evento de compilación.

  2. Abra el cuadro de diálogo Páginas de propiedades del proyecto. Para más información, vea Establecimiento del compilador de C++ y de propiedades de compilación en Visual Studio.

  3. En la carpeta Eventos de compilación, seleccione una página de propiedades de evento de compilación.

  4. Especifique las propiedades asociadas al evento de compilación:

    • En Línea de comandos, especifique un comando como si estuviera especificándolo en el símbolo del sistema. Especifique un comando o archivo por lotes válido, y los archivos de entrada o salida necesarios. Especifique el comando por lotes call antes del nombre de un archivo por lotes para garantizar que se ejecuten todos los comandos siguientes.

      Se pueden especificar varios archivos de entrada y salida simbólicamente mediante macros de MSBuild. Para obtener información sobre cómo especificar la ubicación de los archivos o los nombres de los conjuntos de archivos, vea Macros comunes para propiedades y comandos de compilación.

      Como el carácter "%" está reservado por MSBuild, si se especifica una variable de entorno, reemplace todos los caracteres con escape % con la secuencia de escape hexadecimal %25. Por ejemplo, reemplace %WINDIR% con %25WINDIR%25. MSBuild reemplaza todas las secuencias %25 con el carácter % antes de acceder a la variable de entorno.

    • En Descripción, escriba una descripción para este evento. La descripción se imprime en la ventana Salida cuando se produce este evento.

    • En Excluir de la compilación, especifique si no quiere que el evento se ejecute.

Consulte también

Descripción de los pasos de compilación personalizada y los eventos de compilación
Macros comunes para propiedades y comandos de compilación
Solucionar problemas de personalizaciones de compilación