Ange bygghändelser

Du kan använda bygghändelser för att ange kommandon som körs innan bygget startar, innan länkprocessen eller när bygget är klart.

Bygghändelser körs endast om bygget framgångsrikt når dessa punkter i byggprocessen. Om ett fel inträffar i bygget inträffar inte händelsen efter bygget . Om felet inträffar före länkningsfasen inträffar varken förlänken eller händelsen efter bygget . Om inga filer behöver länkas sker dessutom inte förlänkningshändelsen . Händelsen före länk är inte heller tillgänglig i projekt som inte innehåller ett länksteg.

Om inga filer behöver skapas inträffar inga bygghändelser.

Allmän information om bygghändelser finns i Förstå anpassade byggsteg och bygghändelser.

Så här anger du en bygghändelse

1. I Solution Explorerväljer du det projekt som du vill ange bygghändelsen för.

2. Öppna dialogrutan egenskapssidor för projektet. Mer information finns i Ange C++-kompilator- och byggegenskaper i Visual Studio.

3. I mappen Build Events (Skapa händelser ) väljer du en egenskapssida för bygghändelsen.

4. Ange de egenskaper som är associerade med bygghändelsen:

   • I Kommandorad anger du ett kommando som om du angav det i kommandotolken. Ange ett giltigt kommando eller en batchfil och alla nödvändiga indata- eller utdatafiler. Ange anropsbatchkommandot före namnet på en batchfil för att garantera att alla efterföljande kommandon körs.

     Flera indata- och utdatafiler kan anges symboliskt med MSBuild-makron. Information om hur du anger platsen för filer eller namnen på filuppsättningar finns i Vanliga makron för byggkommandon och egenskaper.

     Eftersom tecknet "%" är reserverat av MSBuild ersätter du varje % escape-tecken med %25 hexadecimal escape-sekvens om du anger en miljövariabel. Ersätt till exempel %WINDIR% med %25WINDIR%25. MSBuild ersätter varje %25 sekvens med % tecknet innan det kommer åt miljövariabeln.

   • I Beskrivning skriver du en beskrivning för den här händelsen. Beskrivningen skrivs ut i utdatafönstret när den här händelsen inträffar.

   • I Exkluderad från build anger du Ja om du inte vill att händelsen ska köras.

Se även

Förstå anpassade byggsteg och bygghändelser
Vanliga makron för att skapa kommandon och egenskaper
Felsöka build-anpassningar