Spécification d’événements de build

  • Article

Vous pouvez utiliser des événements de build pour spécifier des commandes qui s’exécutent avant le début de la génération, avant le processus d’édition des liens ou après la génération.

Les événements de build sont exécutés uniquement si la build atteint ces étapes du processus de génération. Si une erreur survient pendant la génération, l’événement post-build ne se produit pas ; si l’erreur se produit avant la phase de liaison, ni l’événement avant l’édition des liens ni l’événement post-build ne se produisent. De plus, si aucun fichier ne doit être lié, l’événement avant l’édition des liens ne se produit pas. L’événement avant l’édition des liens n’est pas non plus disponible dans les projets qui ne contiennent pas d’étape de liaison.

Si aucun fichier ne doit être généré, aucun événement de build ne se produit.

Pour obtenir des informations générales sur les événements de build, consultez Présentation des étapes de build personnalisée et des événements de build.

Pour spécifier un événement de build

  1. Dans l’Explorateur de solutions, sélectionnez le projet pour lequel vous voulez spécifier l’événement de build.

  2. Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d’informations, consultez Définir le compilateur C++ et les propriétés de build dans Visual Studio.

  3. Dans le dossier Événements de build, sélectionnez une page de propriétés d’événement de build.

  4. Spécifiez les propriétés associées à l’événement de build :

    • Dans Ligne de commande, spécifiez une commande comme vous le feriez à une invite de commandes. Spécifiez une commande ou un fichier de commandes valide, ainsi que les fichiers d’entrée ou de sortie requis. Spécifiez la commande batch call avant le nom d’un fichier de commandes pour garantir l’exécution de toutes les commandes suivantes.

      Il est possible de spécifier plusieurs fichiers d’entrée et de sortie symboliquement à l’aide de macros MSBuild. Pour plus d’informations sur la façon de spécifier l’emplacement des fichiers ou les noms des jeux de fichiers, consultez macros communes pour les commandes et propriétés de build.

      Dans la mesure où le caractère « % » est réservé à MSBuild, quand vous spécifiez une variable d’environnement, il convient de remplacer chaque caractère d’échappement % par la séquence d’échappement hexadécimale %25. Par exemple, remplacez %WINDIR% par %25WINDIR%25. MSBuild remplace chaque séquence %25 par le caractère % avant d’accéder à la variable d’environnement.

    • Dans Description, tapez une description pour cet événement. La description s’affiche dans la fenêtre Sortie quand cet événement se produit.

    • Dans Exclu de la génération, spécifiez Oui si vous ne voulez pas que l’événement soit exécuté.

Voir aussi

Présentation des étapes de génération personnalisée et des événements de build
Macros courantes pour les propriétés et les commandes de build
Dépannage des personnalisations de génération