Spécification d'événements de build
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 génération 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. En outre, 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 génération personnalisée et des événements de build.
Pour spécifier un événement de build
Dans l'Explorateur de solutions, sélectionnez le projet pour lequel vous voulez spécifier l'événement de build.
Ouvrez la boîte de dialogue Pages de propriété du projet. Pour plus d'informations, consultez Utilisation des propriétés de projet.
Dans le dossier Événements de build, sélectionnez une page de propriétés d'événement de build.
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 spécification de l'emplacement de fichiers ou de noms de jeux de fichiers, consultez Macros pour les propriétés et les commandes de génération.
Dans la mesure où le caractère « % » est réservé à MSBuild, lorsque 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'affichera dans la fenêtre Sortie lorsque 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
Référence
Présentation des étapes de génération personnalisée et des événements de build
Dépannage des personnalisations de génération