ビルド ログ ファイルの表示、保存、構成
Visual Studio 対話型開発環境 (IDE) でプロジェクトをビルドした後、Visual Studio 出力 ウィンドウでビルドに関するログに記録された情報を表示できます。 出力データは、Visual Studio やその他のエディターで表示できるログ ファイルに保存できます。
ログは、ビルドの問題のトラブルシューティングに役立ちます。 すべてのビルド ツールに使用される正確なコマンド ラインを見つけ、ビルド プロセス全体に関する完全な診断データを取得できます。 Visual Studio には、ビルド出力とビルド ログ ファイルに表示する情報の種類を指定するオプションが用意されています。
この記事では、Visual Studio でビルド ログ ファイルを生成、構成、および表示する方法について説明します。
ビルド ログ ファイルの生成と表示
シナリオのビルド ログ ファイルを生成して表示するには、次の手順に従います。
C++ プロジェクト:
Visual Studio では、プロジェクトのビルド時にログ ファイルが保存されます。 ログ ファイルの一般的な場所には、Release\<ProjectName>.log、Debug\<ProjectName>.log、ProjectName>.txt<があります。 すべてのファイルの場所は、プロジェクトのルート フォルダーに対して相対的であり、特定の構成に基づいています。
Windows エクスプローラー またはファイル エクスプローラー を使用して、ログ ファイルを参照します。
任意のエディターでログ ファイルを開きます。
.NET プロジェクト:
.NET プロジェクトの場合は、ログ ファイルを保存するように Visual Studio に指示します。
Visual Studio で、[ビルド]>[ソリューションのビルド] を選択します。
出力 ウィンドウで、テキストを選択し、Ctrl+S キーボード ショートカットを使用します。
Visual Studio では、ビルド出力を保存する場所の入力を求められます。 その後、Visual Studio または別のエディターでその場所からログ ファイルを開くことができます。
MSBuild:
-fileLogger(-fl) コマンド ライン オプションを使用して、コマンド ラインから直接 MSBuild を実行することで、ビルド ログを生成できます。 詳細については、「MSBuildを使用したビルド ログの取得」を参照してください。MSBuild では、バイナリ ログ (
-binaryLoggerまたはコマンド ライン オプション-bl) を生成することもできます。 バイナリ ログは、構造化ログ ビューアーで表示できます。 構造化されたログ ビューアーは、複雑なビルド プロセスを理解しやすくする、より豊富な UI を提供します。
環境変数を設定して、バイナリ ログをファイル システムに書き込むよう Visual Studio を構成できます。 MSBuildDebugEngine を 1 に設定し、ビルド ログ ファイルの目的の場所に MSBUILDDEBUGPATH を設定します。 変数は、Visual Studio が起動される環境で設定する必要があります。 これらの設定はすべての Visual Studio ビルドに影響するため、ビルドの特定の呼び出しに対してのみログが必要な場合は、適切なオプションではない可能性があります。
.NET プロジェクトでのビルド ログ記録のより高度な UI サポートについては、Project System Tools 拡張機能のインストールを検討してください。 拡張機能をインストールすると、UI でバイナリ ログのオンとオフを切り替え、ログの一覧から選択できます。 ただし、Visual Studio ビルド システムとの統合方法により、ログは、出力 ウィンドウや環境変数から取得するログとは少し異なります。
ビルド ログのデータの詳細度を指定する
ビルド ログ ファイルに含める情報の量を指定できます。 ログ ファイル列のデータ量は、ロガーの詳細度 として測定されます。 ログ ファイル行の数は、"収集されたメッセージ数" を表します。 ログの詳細度 (列値) は、ログに記録されるメッセージの種類 (行の値) に影響します。 [サイレント] の詳細度により、ビルド出力のログ記録が最小限に抑えられます。 診断 は最も詳細な設定であり、考えられるすべてのデータを含むログ ファイルを生成します。
次の表は、ロガーのログレベルに基づいて収集されるメッセージの種類を示しています。
| メッセージの種類と詳細 | 静か | 最小限 | 正常 | 詳細 | 診断 |
|---|---|---|---|---|---|
| エラー | ✅ | ✅ | ✅ | ✅ | ✅ |
| 警告 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 重要度の高いメッセージ | ✅ | ✅ | ✅ | ✅ | |
| 通常の重要度のメッセージ | ✅ | ✅ | ✅ | ||
| 重要度の低いメッセージ | ✅ | ✅ | |||
| その他の MSBuild エンジン情報 | ✅ |
ロガーの詳しさは、次の手順で設定できます。
Visual Studio で、[ツール] >[オプション]選択して、[オプション] ダイアログを開きます。
ダイアログで、[プロジェクトとソリューション] セクションを展開し、[ビルドと実行] タブを選択します。
[MSBuild プロジェクト ビルドの出力の詳細] ドロップダウン リストを使用し、ビルド出力の基本設定を選択します。
MSBuild プロジェクト ビルド ログ ファイルの冗長性 ドロップダウン リストを使用し、ロガーの冗長性の好みを選択します。
ヒント
コンパイラやその他のツールに使用されたコマンド ラインを表示する場合は、少なくとも [詳細] の詳細レベルを選択してください。
変更を適用するには、[OK] 選択します。
重要
出力 ウィンドウで変更を有効にするには、プロジェクトをリビルドする必要があります。 C++ プロジェクトの場合、プロジェクトの再構築により、<ProjectName>.txt ファイルに変更が反映されます。
詳細については、「オプション]ダイアログ ボックス、[プロジェクトとソリューション]、[ビルドと実行]、[ と LoggerVerbosityを参照してください。
大きなログ ファイルにバイナリ ログを使用する
バイナリ ログは、大規模なログの情報を簡単に見つけられるように、より豊富なログ閲覧エクスペリエンスを実現する .NET プロジェクトのオプション機能です。 バイナリ ログを使用するには、Project System Toolsをインストールします。 詳細については、「バイナリ ログ の https://msbuildlog.com と」を参照してください。
バイナリ ログは、大規模なログの情報を簡単に見つけられるように、より豊富なログ閲覧エクスペリエンスを実現する .NET プロジェクトのオプション機能です。 バイナリ ログを使用するには、Project System Tools 2022をインストールします。 詳細については、「バイナリ ログ の https://msbuildlog.com と」を参照してください。
関連コンテンツ
- Visual Studio でプロジェクトとソリューションをビルドしてクリーン化する
- コンパイルとビルド
- MSBuild を使用してビルド ログを取得する