Visa, spara och konfigurera byggloggfiler

När du har skapat ett projekt i Visual Studio Interactive Development Environment (IDE) kan du visa loggad information om bygget i fönstret Visual Studio Output. Utdata kan sparas i loggfiler som du kan visa i Visual Studio och andra redigerare.

Loggarna kan hjälpa dig att felsöka problem i bygget. Du kan hitta de exakta kommandorader som används för alla byggverktyg och få fullständiga diagnostikdata om hela byggprocessen. Visual Studio innehåller alternativ för att ange vilken typ av information du vill se i byggutdata och byggloggfiler.

Den här artikeln beskriver hur du genererar, konfigurerar och visar byggloggfiler i Visual Studio.

Generera och visa byggloggfiler

Använd följande procedurer för att generera och visa byggloggfiler för ditt scenario.

• C++-projekt:

  Visual Studio sparar loggfilerna åt dig när du skapar projektet. Vanliga platser för loggfilerna är Release\<ProjectName>.log, Debug\<ProjectName>.logoch <ProjectName>.txt. Alla filplatser är relativa till projektrotmappen och baseras på din specifika konfiguration.

  1. Använd Windows Utforskaren eller Utforskaren för att bläddra till loggfilen.

  2. Öppna loggfilen i önskad redigerare.

• .NET-projekt:

  För .NET-projekt instruerar du Visual Studio att spara loggfilerna:

  1. I Visual Studio väljer du Build>Build Solution.

  2. I fönstret Utdata väljer du i texten och använder kortkommandot Ctrl+S.

  Visual Studio uppmanar dig att ange en plats för att spara byggutdata. Du kan sedan öppna loggfilerna från den platsen i Visual Studio eller någon annan redigerare.

• MSBuild:

  Du kan generera byggloggar genom att köra MSBuild direkt från kommandoraden med kommandoradsalternativet -fileLogger (-fl). Mer information finns i Hämta byggloggar med MSBuild.

  Med MSBuild kan du också generera binära loggar (-binaryLogger eller -bl kommandoradsalternativ). Du kan visa binära loggar i Structured Log Viewer. Det strukturerade loggvisningsprogrammet har ett mer omfattande användargränssnitt som kan göra det lättare att förstå komplexa byggprocesser.

Du kan ange miljövariabler för att konfigurera Visual Studio att skriva en binär logg till filsystemet. Ange MSBuildDebugEngine till 1 och ange MSBUILDDEBUGPATH till önskad plats för byggloggfilen. Variablerna måste anges i den miljö där Visual Studio startas. De här inställningarna påverkar alla Visual Studio-versioner, så det kanske inte är ett bra alternativ om du bara vill ha loggar för en viss anrop av versionen.

Om du vill ha mer avancerat gränssnittsstöd för byggloggning i .NET-projekt kan du installera tillägget Project System Tools. När tillägget är installerat kan du aktivera och inaktivera binär loggning i användargränssnittet och välja från listan över loggar. Men på grund av hur det integreras med Visual Studio-byggsystemet skiljer sig loggarna lite från de som du skulle få från fönstret Output eller med miljövariablerna.

Ange utförliga data för byggloggar

Du kan ange hur mycket information som ska ingå i byggloggfilerna. Mängden data i loggfilskolumnerna mäts som loggerns detaljeringsgrad. Antalet rader i loggfilen representerar meddelanden som har samlats in. Loggens verbositet (kolumnvärden) påverkar typerna av loggade meddelanden (radvärden). Tyst verbositet ger minimal loggning i byggprocessens utdata. Diagnostik är den mest utförliga inställningen och genererar loggfiler med alla möjliga data.

I följande tabell visas vilka typer av meddelanden som samlas in baserat på loggerverositeten:

Meddelandetyp/Verbosity	Stilla	Minimal	Normal	Detaljerad	Diagnostik
Fel	✅	✅	✅	✅	✅
Varningar	✅	✅	✅	✅	✅
Meddelanden med hög prioritet		✅	✅	✅	✅
Meddelanden med normal prioritet			✅	✅	✅
Meddelanden med låg prioritet				✅	✅
Annan information om MSBuild-verktyget					✅

Du kan konfigurera loggerverositeten med följande steg:

1. I Visual Studio väljer du Verktyg>Alternativ för att öppna dialogrutan Alternativ.

2. Expandera avsnittet Projects and Solutions i dialogrutan och välj fliken Skapa och kör.

3. Använd listrutan för byggverbalitet i MSBuild-projektet och välj din önskade detaljnivå för byggutdata.

4. Använd MSBuild-projektversionsloggfilens utförlighet listruta och välj dina inställningar för loggningsverbröst.

   Tips

   Om du vill se de kommandorader som används för kompilatorn och andra verktyg väljer du minst Detaljerad utförlighetsnivå.

5. Om du vill tillämpa ändringarna väljer du OK.

Viktig

Du måste återskapa projektet för att ändringarna ska börja gälla i fönstret Utdata. För C++-projekt säkerställer projektets återskapande också att ändringarna återspeglas i filen <ProjectName>.txt.

Mer information finns i dialogrutan Alternativ, Projekt och lösningar, Skapa och kör och LoggerVerbosity.

Använda binära loggar för stora loggfiler

Binära loggar är en valfri funktion för .NET-projekt som gör att du kan få en bättre loggbläddringsupplevelse som kan göra det enklare att hitta information i stora loggar. Om du vill använda binära loggar installerar du Project System Tools 2022. Mer information finns i https://msbuildlog.com och binär logg.

Relaterat innehåll

• Skapa och rensa projekt och lösningar i Visual Studio
• kompilera och skapa
• Hämta byggloggar med MSBuild