Zobrazení, uložení a konfigurace souborů protokolu sestavení

Po sestavení projektu v prostředí Visual Studio IDE můžete zobrazit záznamy o sestavení v okně výstupu sady Visual Studio. Výstupní data je možné uložit do souborů protokolu, které můžete zobrazit v sadě Visual Studio a dalších editorech.

Tyto protokoly vám můžou pomoct s řešením problémů v sestavení. Můžete najít přesné příkazové řádky používané pro všechny nástroje sestavení a získat úplná diagnostická data o celém procesu sestavení. Visual Studio poskytuje možnosti pro určení typů informací, které chcete zobrazit ve výstupu sestavení a souborech protokolu sestavení.

Tento článek popisuje, jak generovat, konfigurovat a zobrazit soubory protokolu sestavení ve Visual Studiu.

Generování a zobrazení souborů protokolu sestavení

K vygenerování a zobrazení souborů protokolu sestavení pro váš scénář použijte následující postupy.

• C++ projekt

  Visual Studio ukládá soubory protokolu za vás při sestavování projektu. Mezi běžná umístění souborů protokolu patří Release\<ProjectName>.log, Debug\<ProjectName>.loga <ProjectName>.txt. Všechna umístění souborů jsou relativní vzhledem ke kořenové složce projektu a na základě vaší konkrétní konfigurace.

  1. Pomocí Průzkumníka Windows nebo Průzkumníka souborů přejděte k souboru protokolu.

  2. Otevřete soubor protokolu v preferovaném editoru.

• projektu .NET:

  U projektů .NET instruujete Visual Studio, aby uložilo soubory protokolu.

  1. V sadě Visual Studio vyberte Sestavení>Sestavit řešení.

  2. V okně Výstup vyberte text a použijte klávesovou zkratku Ctrl+S.

  Visual Studio vás vyzve k zadání umístění pro uložení výstupu sestavení. Poté můžete otevřít soubory protokolu z daného umístění ve Visual Studiu nebo jiném editoru.

• MSBuild:

  Protokoly sestavení můžete vygenerovat spuštěním nástroje MSBuild přímo z příkazového řádku pomocí možnosti příkazového řádku -fileLogger (-fl). Další informace naleznete v tématu Získání protokolů sestavení pomocí nástroje MSBuild.

  Pomocí nástroje MSBuild můžete také generovat binární záznamy (-binaryLogger nebo -bl přepínač příkazového řádku). Binární protokoly můžete zobrazit v strukturovaném prohlížeči protokolů. Prohlížeč strukturovaných protokolů poskytuje bohatší uživatelské rozhraní, které by mohlo usnadnit pochopení složitých procesů sestavení.

Proměnné prostředí můžete nastavit tak, aby visual Studio nakonfigurovali tak, aby do systému souborů zapisovali binární protokol. Nastavte MSBuildDebugEngine na 1 a nastavte MSBUILDDEBUGPATH na požadované umístění souboru protokolu sestavení. Proměnné musí být nastaveny v prostředí, ve kterém je sada Visual Studio spuštěna. Tato nastavení ovlivňují všechna sestavení sady Visual Studio, takže nemusí být dobrou volbou, pokud chcete protokoly pouze pro konkrétní vyvolání sestavení.

Pokud chcete pokročilejší podporu uživatelského rozhraní pro protokolování sestavení v projektech .NET, zvažte instalaci rozšíření Project System Tools. S nainstalovaným rozšířením můžete v uživatelském rozhraní zapnout a vypnout binární protokolování a vybrat si ze seznamu protokolů. Vzhledem k tomu, jak se integruje se systémem sestavení Visual Studio, se ale záznamy trochu liší od těch, které byste získali z okna výstupu, nebo z proměnných prostředí.

Nastavit úroveň podrobností pro protokoly sestavení

Můžete určit, kolik informací se má zahrnout do souborů protokolu sestavení. Množství dat ve sloupcích souboru protokolu se měří jako podrobností protokolovacího nástroje. Počet řádků souboru protokolu představuje počet zpráv, které byly shromážděny. Podrobnosti protokolu (hodnoty sloupců) ovlivňují typy protokolovaných zpráv (hodnoty řádků). Tichá ukecanost vede k minimálnímu protokolování ve výstupu sestavení. Nastavení Diagnostic je nejpodrobnější a generuje soubory protokolu se všemi možnými daty.

Následující tabulka uvádí, jaké typy zpráv se shromažďují na základě podrobností protokolovacího nástroje:

Typ zprávy / podrobnosti	Tichý	Minimální	Normální	Detailní	Diagnostika
Chyby	✅	✅	✅	✅	✅
Varování	✅	✅	✅	✅	✅
Zprávy s vysokou důležitostí		✅	✅	✅	✅
Zprávy o normální důležitosti			✅	✅	✅
Zprávy s nízkou důležitostí				✅	✅
Další informace o MSBuild-engine					✅

Úroveň podrobností protokolovacího modulu můžete nakonfigurovat pomocí následujících kroků:

1. V sadě Visual Studio vyberte Tools>Options (Možnosti Options).

2. V dialogovém okně rozbalte část Projekty a řešení a vyberte kartu Sestavení a spuštění.

3. Pomocí rozevíracího seznamu pro úroveň podrobností výstupu sestavení projektu MSBuild vyberte svou preferenci výstupu sestavení.

4. Použijte rozevírací seznam pro úroveň podrobnosti protokolu sestavení projektu MSBuild a vyberte si svou preferovanou úroveň podrobností protokolování.

   Spropitné

   Pokud chcete zobrazit příkazové řádky používané pro kompilátor a další nástroje, zvolte alespoň úroveň podrobností.

5. Pokud chcete změny použít, vyberte OK.

Důležitý

Projekt je nutné znovu sestavit, aby se změny projevily v okně Výstup. U projektů C++ se opětovné sestavení projektu také zajistí, aby se změny projevily v souboru <ProjectName>.txt.

Další informace naleznete v dialogovém okně možnosti , projekty a řešení, sestavení a spuštění a LoggerVerbosity.

Použijte binární logy pro velké soubory záznamů

Binární protokoly jsou volitelnou funkcí pro projekty .NET, která umožňuje bohatší procházení protokolů, které by mohlo usnadnit hledání informací ve velkých protokolech. Chcete-li použít binární logy, nainstalujte nástroje Project System Tools 2022. Další informace naleznete v tématu https://msbuildlog.com a Binární protokol.

Související obsah

• Sestavit a vyčistit projekty a řešení v sadě Visual Studio
• Kompilace a sestavení
• Získejte protokoly sestavení pomocí nástroje MSBuild