Zobrazování, ukládání a konfigurace souborů protokolu sestavení

Po sestavení projektu v prostředí Visual Studio Interactive Development Environment (IDE) můžete zobrazit protokolované informace o sestavení v okně Výstup 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í v sadě Visual Studio.

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.

• Projekt C++:

  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>.log a <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ík souborů přejděte k souboru protokolu.

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

• Projekt .NET:

  U projektů .NET dáte sadě Visual Studio pokyn, aby uložil soubory protokolu:

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

  2. V okně Výstup vyberte v textu 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í. Soubory protokolu pak můžete otevřít z daného umístění v sadě Visual Studio 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 -fileLogger řádku (-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í protokoly (-binaryLogger nebo -bl možnost příkazového řádku). Binární protokoly můžete zobrazit v Prohlížeči strukturovaných 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. 1 Nastavte MSBuildDebugEngine na požadované umístění souboru protokolu sestavení a nastavte MSBUILDDEBUGPATH ho. 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í sady Visual Studio, se ale protokoly trochu liší od protokolů, které byste získali z okna Výstup nebo s proměnnými prostředí.

Zadání podrobností dat 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 úroveň podrobností protokolovacího nástroje. Počet řádků souboru protokolu představuje shromážděné zprávy. Podrobnosti protokolu (hodnoty sloupců) ovlivňují typy protokolovaných zpráv (hodnoty řádků). Tichou úroveň podrobností vytváří minimální protokolování ve výstupu sestavení. Diagnostika je nejrozsáhlejší nastavení 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	Quiet	Minimální	Normální	Podrobný	Diagnostika
Chyby	✅	✅	✅	✅	✅
Upozorně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 modulu MSBuild					✅

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

1. V sadě Visual Studio vyberte Možnosti nástrojů>a otevřete dialogové okno Možnosti.

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

3. Použijte rozevírací seznam podrobností výstupu sestavení projektu MSBuild a vyberte předvolbu výstupu sestavení.

4. Použijte rozevírací seznam podrobností souboru protokolu sestavení projektu MSBuild a vyberte předvolbu podrobností protokolovacího nástroje.

   Tip

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

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

Důležité

Aby se změny projevily v okně Výstup , musíte projekt znovu sestavit. U projektů C++ se opětovné sestavení projektu také zajistí, že se změny projeví 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žití binárních protokolů pro velké soubory protokolů

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í protokoly, nainstalujte systémové nástroje projektu 2022. Další informace najdete v části https://msbuildlog.com Binární protokol.

Související obsah

• Sestavování a čištění projektů a řešení v sadě Visual Studio
• Kompilace a sestavení
• Získání protokolů sestavení pomocí nástroje MSBuild