Buildlogboekbestanden weergeven, opslaan en configureren

Nadat u een project hebt gebouwd in de Visual Studio Interactive Development Environment (IDE), kunt u vastgelegde informatie over de build bekijken in het venster Visual Studio Output. De uitvoergegevens kunnen worden opgeslagen in logboekbestanden die u kunt weergeven in Visual Studio en andere editors.

De logboeken kunnen u helpen bij het oplossen van problemen in de build. U kunt de exacte opdrachtregels vinden die worden gebruikt voor alle buildhulpprogramma's en volledige diagnostische gegevens over het hele buildproces ophalen. Visual Studio biedt opties voor het opgeven van de soorten informatie die u wilt zien in de build-uitvoer en buildlogboekbestanden.

In dit artikel wordt beschreven hoe u buildlogboekbestanden genereert, configureert en weergeeft in Visual Studio.

Buildlogboekbestanden genereren en weergeven

Gebruik de volgende procedures om buildlogboekbestanden voor uw scenario te genereren en weer te geven.

• C++-project:

  Visual Studio slaat de logboekbestanden voor u op wanneer u uw project bouwt. Algemene locaties voor de logboekbestanden zijn Release\<ProjectName>.log, Debug\<ProjectName>.logen <ProjectName>.txt. Alle bestandslocaties zijn relatief ten opzichte van de hoofdmap van uw project en op basis van uw specifieke configuratie.

  1. Gebruik Windows Verkenner of Bestandsverkenner om naar het logboekbestand te bladeren.

  2. Open het logboekbestand in de gewenste editor.

• .NET project:

  Voor .NET-projecten geeft u Visual Studio de opdracht om de logboekbestanden op te slaan:

  1. Selecteer in Visual Studio Build>Build Solution.

  2. Selecteer in het venster Uitvoer de tekst en gebruik de sneltoets Ctrl+S.

  Visual Studio vraagt u om een locatie om de build-uitvoer op te slaan. Vervolgens kunt u de logboekbestanden openen vanaf die locatie in Visual Studio of een andere editor.

• MSBuild:

  U kunt buildlogboeken genereren door MSBuild rechtstreeks vanaf de opdrachtregel uit te voeren met behulp van de opdrachtregeloptie -fileLogger (-fl). Zie Build-logboeken verkrijgen met MSBuildvoor meer informatie.

  Met MSBuild kunt u ook binaire logboeken genereren (-binaryLogger of -bl opdrachtregeloptie). U kunt binaire logboeken weergeven in de Structured Log Viewer. De gestructureerde logboekviewer biedt een uitgebreidere gebruikersinterface die het gemakkelijker maakt om complexe buildprocessen te begrijpen.

U kunt omgevingsvariabelen instellen om Visual Studio te configureren voor het schrijven van een binair logboek naar het bestandssysteem. Stel MSBuildDebugEngine in op 1 en stel MSBUILDDEBUGPATH in op de gewenste locatie van het buildlogboekbestand. De variabelen moeten worden ingesteld in de omgeving waarin Visual Studio wordt gestart. Deze instellingen zijn van invloed op alle Visual Studio-builds, dus is mogelijk geen goede optie als u alleen logboeken wilt voor een bepaalde aanroep van de build.

Voor meer geavanceerde ondersteuning voor gebruikersinterfaces bij buildlogging in .NET-projecten kunt u overwegen de Project System Tools-extensie te installeren. Als de extensie is geïnstalleerd, kunt u binaire logboekregistratie in- en uitschakelen in de gebruikersinterface en kiezen uit de lijst met logboeken. Vanwege de manier waarop het wordt geïntegreerd met het Build-systeem van Visual Studio, verschillen de logboeken echter iets van de logboeken die u zou krijgen uit het venster Uitvoer of met de omgevingsvariabelen.

Specificeer de gegevensuitgebreidheid voor build logs

U kunt opgeven hoeveel informatie moet worden opgenomen in de buildlogboekbestanden. De hoeveelheid gegevens in de kolommen van het logbestand wordt gemeten als logger-verbaalheid. Het aantal rijen met logboekbestanden vertegenwoordigt berichten die zijn verzameld. De uitgebreidheid van logboeken (kolomwaarden) is van invloed op de typen vastgelegde berichten (rijwaarden). Quiet uitgebreidheid produceert minimale logboekregistratie in de build-uitvoer. Diagnostische is de meest uitgebreide instelling en genereert logboekbestanden met alle mogelijke gegevens.

In de volgende tabel ziet u welke typen berichten worden verzameld op basis van de uitgebreidheid van de logboekregistratie:

Berichttype/uitgebreidheid	Rustig	Minimaal	Normaal	Gedetailleerd	Diagnostisch
Fouten	✅	✅	✅	✅	✅
Waarschuwingen	✅	✅	✅	✅	✅
Belangrijke berichten		✅	✅	✅	✅
Berichten met normaal belang			✅	✅	✅
Berichten met lage urgentie				✅	✅
Overige informatie over MSBuild-engine					✅

U kunt de nauwkeurigheid van de logboekinstellingen configureren met de volgende stappen:

1. In Visual Studio, selecteer Extra>Opties om het dialoogvenster Opties te openen.

2. Vouw in het dialoogvenster de sectie Projecten en oplossingen uit en selecteer het tabblad Bouwen en uitvoeren.

3. Gebruik de MSBuild project build uitvoer uitgebreid vervolgkeuzelijst en selecteer uw build uitvoervoorkeur.

4. Gebruik de de keuzelijst voor de uitvoerigheid van het logbestand van het MSBuild-project en selecteer uw voorkeur voor de uitvoerigheid van de logger.

   Tip

   Als u de opdrachtregels wilt zien die worden gebruikt voor de compiler en andere hulpprogramma's, kiest u ten minste het niveau Gedetailleerde uitgebreidheidsniveau.

5. Als u uw wijzigingen wilt toepassen, selecteert u OK-.

Belangrijk

U moet het project opnieuw opbouwen om de wijzigingen van kracht te laten worden in het venster Uitvoer. Voor C++-projecten zorgt het opnieuw opbouwen van het project er ook voor dat de wijzigingen worden doorgevoerd in het <ProjectName>.txt-bestand.

Zie het dialoogvenster Opties, Projecten en oplossingen, bouwen en uitvoeren en LoggerVerbosityvoor meer informatie.

Binaire logboeken gebruiken voor grote logboekbestanden

Binaire logboeken zijn een optionele functie voor .NET-projecten waarmee u een uitgebreidere browserervaring voor logboeken hebt waarmee u gemakkelijker informatie in grote logboeken kunt vinden. Als u binaire logboeken wilt gebruiken, installeert u de Project System Tools 2022. Zie https://msbuildlog.com en binair logboekvoor meer informatie.

Verwante inhoud

• Projecten en oplossingen bouwen en opschonen in Visual Studio
• compileren en bouwen
• Build-logboeken verkrijgen met MSBuild