使用 MSBuild 取得組建記錄檔

  • 發行項

透過搭配 MSBuild 使用命令行選項，您可以指定您要檢閱多少組建數據，以及是否要將組建資料儲存至一或多個檔案。 您也可以指定自訂記錄器來收集組建資料。 如需本主題未涵蓋之 MSBuild 命令行選項的資訊，請參閱 命令行參考。

注意

如果您使用 Visual Studio IDE 來建置專案，就能藉由檢視建置記錄檔來進行這些組建的疑難排解。 如需詳細資訊，請參閱如何：檢閱、儲存和設定組建記錄檔。

設定詳細層級

當您使用 MSBuild 來建置專案，但未指定詳細資料層級時，即會在輸出記錄檔中顯示下列資訊：

  • 已分類為高重要性的錯誤、警告和訊息。

  • 一些狀態事件。

  • 組建摘要。

使用 -verbosity (-v) 參數，您可以控制要在輸出記錄檔中顯示的資料量。 如需疑難排解，請使用 detailed (d) 或 diagnostic (diag) 的詳細資訊層級，其中提供了最多資訊。

當您將 -verbosity 設為 detailed 時，建置程序可能會變慢，而當您將 -verbosity 設為 diagnostic 時，甚至會變得更慢。

msbuild MyProject.proj -t:go -v:diag

詳細資訊設定

下表顯示記錄檔的詳細資訊 (資料行值) 對記錄哪些類型的訊息 (資料列的值) 有什麼影響。

訊息類型/ 詳細資訊 Quiet 最小 正常 詳細 Diagnostic
錯誤 ✅ ✅ ✅ ✅ ✅
警告 ✅ ✅ ✅ ✅ ✅
高重要性的訊息 ✅ ✅ ✅ ✅
一般重要性的訊息 ✅ ✅ ✅
低重要性的訊息 ✅ ✅
MSBuild 引擎的其他資訊 ✅

將組建記錄檔儲存至檔案

您可以使用 -fileLogger (fl) 參數，將組建資料儲存至檔案。 下列範例會將組建資料儲存至名為 msbuild.log 的檔案。

msbuild MyProject.proj -t:go -fileLogger

在下列範例中，會將記錄檔命名為 MyProjectOutput.log，並將記錄檔輸出的詳細資訊設為 diagnostic。 您可以使用 -fileLoggerParameters (flp) 參數指定這兩個設定。

msbuild MyProject.proj -t:go -fl -flp:logfile=MyProjectOutput.log;verbosity=diagnostic

如需詳細資訊，請參閱命令列參考。

將記錄輸出儲存至多個檔案

下列範例會將整個記錄檔儲存至 msbuild1.log、只將錯誤儲存至 JustErrors.log，並且只將警告儲存至 JustWarnings.log。 這個範例會針對這三個檔案的每個檔案使用檔案號碼。 檔案號碼會指定於 -fl 和 -flp 參數 (例如，-fl1 和 -flp1) 的正後方。

適用於檔案 2 和 3 的 -fileLoggerParameters (flp) 參數會指定每個檔案的名稱，以及要在每個檔案中包含的項目。 由於未指定檔案 1 的名稱，因此會使用 msbuild1.log 的預設名稱。

msbuild MyProject.proj -t:go -fl1 -fl2 -fl3 -flp2:logfile=JustErrors.log;errorsonly -flp3:logfile=JustWarnings.log;warningsonly

如需詳細資訊，請參閱命令列參考。

儲存二進位記錄檔

您可以使用 -binaryLogger (bl) 參數，以壓縮的二進位格式儲存記錄檔。 此記錄檔包含建置程序的詳細描述，並可以由特定的記錄分析工具讀取。

在下列範例中，會建立具有名稱 binarylogfilename 的二進位記錄檔。

-bl:binarylogfilename.binlog

您可以使用 結構化記錄查看器 來檢視二進位記錄，讓查看發生什麼事變得更容易。

如需詳細資訊，請參閱命令列參考。

使用自訂記錄器

若要撰寫自己的記錄器，請編寫可實作 ILogger 介面的 Managed 類型。 例如，您可以使用自訂記錄器，透過電子郵件傳送建置錯誤、將其記錄至資料庫，或將其記錄至 XML 檔案。 如需詳細資訊，請參閱組建記錄器。

在 MSBuild 命令列中，您會使用 -logger 參數指定自訂記錄器。 您也可以使用 -noconsolelogger 參數，停用預設的主控台記錄器。

相關內容