MSBuild でのビルド ログの取得
を使用して、MSBuild に切り替えて、ビルド データの量を確認するかどうか、および一つ以上のファイルにビルドのデータを保存する方法を指定できます。また、ビルド データを収集するためのカスタム ロガーを指定できます。このトピックは対応できない MSBuild コマンド ライン スイッチについては、MSBuild コマンド ライン リファレンス"を参照してください。
[!メモ]
Visual Studio IDE を使用してプロジェクトをビルドすると、ビルド ログを確認して、それらのビルドを修正できます。詳細については、「方法: ビルド ログ ファイルを表示、保存、および構成する」を参照してください。
詳細レベルの配置
MSBuild を使用して詳細レベルを指定せずにプロジェクトをビルドすると、次の情報がログ出力に表示されます:
エラー、非常に重要に分類される警告、およびメッセージ。
ある状態イベント。
ビルドの概要。
/verbosity (/v) スイッチを使用して、データの量が出力ログに表示されるかを制御できます。トラブルシューティングのために、detailed(d) または diagnostic (diag) レベルのほとんどの情報を提供する詳細度を使用します。
ビルド処理は、detailed に /verbosity 設定されていると diagnosticに低速に設定 /verbosity 新しい場合があります。
msbuild MyProject.proj /t:go /v:diag
ファイルへのビルド ログの保存
ファイルにビルドのデータを保存するには /fileLogger (fl) スイッチを使用できます。次の例では msbuild.logという名前のファイルにビルドのデータを保存します。
msbuild MyProject.proj /t:go /fileLogger
次の例では、ログ ファイルは MyProjectOutput.logという名前で、ログ出力の詳細度は diagnosticに設定されます。/filelogparameters (flp) スイッチを使用して、二つの設定を指定します。
msbuild MyProject.proj /t:go /fl /flp:logfile=MyProjectOutput.log;verbosity=diagnostic
詳細については、「MSBuild コマンド ライン リファレンス」を参照してください。
複数ファイルに出力するログを保存します
次の例では JustErrors.logに msbuild1.logに、ログ、エラー、および JustWarnings.logに、警告を保存します。例では、3 本の各ファイルのファイル番号を使用します。ファイル番号は /fl と /flp スイッチの直後に指定されます (たとえば、/fl1 と /flp1)。
ファイル 2 および 3 の /filelogparameters (flp) スイッチは、を各ファイルを参照するのか、各ファイルに含まれるの内容を指定します。ファイル名は 1 に指定されないため、msbuild1.log の既定の名前が使用されます。
msbuild MyProject.proj /t:go /fl1 /fl2 /fl3 /flp2:logfile=JustErrors.log;errorsonly /flp3:logfile=JustWarnings.log;warningsonly
詳細については、「MSBuild コマンド ライン リファレンス」を参照してください。
カスタム ロガーを使用する
ILogger インターフェイスを実装するマネージ型を記述することにより、独自のロガーを作成できます。たとえば、電子メールのビルド エラーを送信する、データベースに記録したり、XML ファイルに記録するには、カスタム ロガーを使用する場合があります。詳細については、「ビルド ロガー」を参照してください。
MSBuild コマンド ラインでは、/logger スイッチを使用してカスタム ロガーを指定します。また、既定のコンソール ロガーを無効にするには /noconsolelogger スイッチを使用できます。