Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Genom att använda kommandoradsalternativ med MSBuild kan du ange hur mycket byggdata du vill granska och om du vill spara byggdata i en eller flera filer. Du kan också ange en anpassad loggare för att samla in byggdata. Information om kommandoradsalternativ för MSBuild som inte beskrivs i det här avsnittet finns i Kommandoradsreferens.
Anmärkning
Om du skapar projekt med hjälp av Visual Studio IDE kan du felsöka dessa versioner genom att granska byggloggarna. Mer information finns i Visa, spara och konfigurera byggloggfiler.
Ange detaljnivå
När du skapar ett projekt med hjälp av MSBuild utan att ange någon detaljnivå visas följande information i utdataloggen:
Fel, varningar och meddelanden som kategoriseras som mycket viktiga.
Vissa statushändelser.
En sammanfattning av bygget.
Genom att använda växeln -verbosity (-v) kan du styra hur mycket data som visas i utdataloggen. För felsökning använder du en utförlig nivå av antingen detailed (d) eller diagnostic (diag), som ger mest information.
Byggprocessen kan vara långsammare när du anger -verbosity till detailed och ännu långsammare när du anger -verbosity till diagnostic.
msbuild MyProject.proj -t:go -v:diag
Inställningar för ordrikedom
I följande tabell visas hur loggens utförlighet (kolumnvärden) påverkar vilka typer av meddelanden (radvärden) som loggas.
| Meddelandetyp / Verbositet | Tyst | Minimalt | Normalt | Detaljerad | Diagnostik |
|---|---|---|---|---|---|
| Felaktigheter | ✅ | ✅ | ✅ | ✅ | ✅ |
| Varningar | ✅ | ✅ | ✅ | ✅ | ✅ |
| Meddelanden med hög prioritet | ✅ | ✅ | ✅ | ✅ | |
| Meddelanden med normal prioritet | ✅ | ✅ | ✅ | ||
| Meddelanden med låg prioritet | ✅ | ✅ | |||
| Ytterligare information om MSBuild-engine | ✅ |
Spara byggloggen i en fil
Du kan använda växeln -fileLogger (-fl) för att spara byggdata i en fil. I följande exempel sparas byggdata till en fil med namnet msbuild.log.
msbuild MyProject.proj -t:go -fileLogger
I följande exempel heter loggfilen MyProjectOutput.log och utförligheten för loggutdata är inställd på diagnostic. Du anger dessa två inställningar med hjälp av växeln -fileLoggerParameters (-flp).
msbuild MyProject.proj -t:go -fl -flp:logfile=MyProjectOutput.log;verbosity=diagnostic
Mer information finns i Kommandoradsreferens.
Spara loggutdata i flera filer
I följande exempel sparas hela loggen till msbuild1.log, bara felen för att JustErrors.log och bara varningarna till JustWarnings.log. I exemplet används filnummer för var och en av de tre filerna. Filnumren anges precis efter -fl och -flp växlar (till exempel -fl1 och -flp1).
-fileLoggerParameters Växlarna (-flp) för filer 2 och 3 anger vad varje fil ska namnges och vad som ska inkluderas i varje fil. Inget namn har angetts för fil 1, så standardnamnet för msbuild1.log används.
msbuild MyProject.proj -t:go -fl1 -fl2 -fl3 -flp2:logfile=JustErrors.log;errorsonly -flp3:logfile=JustWarnings.log;warningsonly
Om du använder ett gränssnitt som tolkar semikolon (till exempel bash) placerar du enkla eller dubbla citattecken runt alla alternativ som har semikolon för att förhindra att det tolkas som en kommandoavgränsare. Mer information finns i Kommandoradsreferens.
Spara en binär logg
Du kan spara loggen i komprimerat binärt format med växeln -binaryLogger (-bl). Den här loggen innehåller en detaljerad beskrivning av byggprocessen och kan läsas av vissa logganalysverktyg.
I följande exempel skapas en binär loggfil med namnet binarylogfilename.
-bl:binarylogfilename.binlog
Du kan använda visningsprogrammet för strukturerad logg för att visa binära loggar på ett sätt som gör det mycket enklare att se vad som händer.
Mer information finns i Kommandoradsreferens.
Använd en anpassad loggare
Du kan skriva en egen logger genom att författa en hanterad typ som implementerar ILogger-gränssnittet. Du kan till exempel använda en anpassad loggning för att skicka byggfel i e-post, logga dem till en databas eller logga dem till en XML-fil. Mer information finns i Skapa loggare.
På kommandoraden MSBuild anger du den anpassade loggaren med hjälp av växeln -logger . Du kan också använda växeln -noconsolelogger för att inaktivera standardkonsolloggaren.