Partager via


Spécifier des événements de build personnalisés

Visual Studio vous permet de spécifier des commandes de build personnalisées à exécuter automatiquement avant qu’un build ne commence ou après qu’il soit terminé. Vous pourriez créer des commandes pour exécuter un fichier .bat avant qu’un build ne commence ou copier de nouveaux fichiers dans un dossier après la fin du build. Les événements de build personnalisés ne s’exécutent que lorsque le build atteint avec succès le point pertinent dans le processus de build.

Cet article donne un aperçu de la syntaxe recommandée pour les commandes de build personnalisées. Si vous recherchez des informations sur un langage de programmation spécifique, veuillez consulter la section Visual Basic, C# et F#, et Visual C++.

Conseil

Si vous souhaitez ajouter des opérations complexes à votre processus de build, consultez les techniques de personnalisation MSBuild. Par exemple, vous pouvez ajouter des événements de build pour générer des fichiers de code, et gérer correctement le nettoyage après une opération clean ou exécuter la tâche uniquement lorsque les entrées sont obsolètes.

Syntaxe pour les commandes de build personnalisées

Les commandes de build suivent la même syntaxe que les commandes de l’invite de commande Windows, et vous pouvez utiliser des macros pour créer facilement les événements. Pour une liste des macros disponibles, veuillez consulter la section Prébuild événement et événement post-build boîte de dialogue en ligne de commande.

Pour de meilleurs résultats, suivez ces conseils de mise en forme :

  • Ajoutez une instruction call avant tous les événements de build qui exécutent des fichiers .bat.

    Exemple : call C:\MyFile.bat

    Exemple : call C:\MyFile.bat call C:\MyFile2.bat

  • Placez les chemins d'accès de fichier entre guillemets.

    Exemple : "%ProgramFiles(x86)%\Microsoft SDKs\Windows\v10.0A\bin\NETFX 4.8 Tools\gacutil.exe" -if "$(TargetPath)"

  • Séparez les commandes à l'aide de sauts de ligne.

  • Incluez des caractères génériques si nécessaire.

    Exemple : for %I in (*.txt *.doc *.html) do copy %I c:\<Directory>\

    Remarque

    Pour un script batch, remplacez la variable %I dans cet exemple par %%I.