建立轉送記錄器

  • 發行項

轉送記錄器可讓您選擇在多處理器系統上建置專案時想要監視的事件，以提高記錄的效率。 啟用轉送記錄器時，您可以防止不必要的事件塞滿中央記錄器，而導致建置時間變慢、記錄空間暴增等問題。

若要建立轉送記錄器，您可以實作 IForwardingLogger 介面，然後以手動方式實作它的方法，或使用 ConfigurableForwardingLogger 類別和其預先設定的方法。 對大部分的應用程式來說，採用後者就足夠了。

註冊與回應事件

轉送記錄器會收集由次要建置引擎所報告的建置事件相關資訊；次要建置引擎是在多處理器系統上建置期間，由主要建置程序建立的背景工作處理序。 接著，轉送記錄器會根據您所提供的指示，選取要轉送給中央記錄器的事件。

您必須註冊轉送記錄器，才能處理想要監視的事件。 若要註冊事件，記錄器必須覆寫 Initialize 方法。 這個方法現在包含一個 nodecount 選擇性參數，您可用來設定系統處理器的數量。 預設值為 1。

您可以監視的事件範例為 TargetStarted、ProjectStarted 和 ProjectFinished。

在多處理器環境中，可能不會按順序接收事件訊息。 因此，您必須使用轉送記錄器中的事件處理常式來評估事件，並為它編寫程式以決定哪些事件要傳遞到重新導向程式，並轉送給中央記錄器。 若要完成此動作，您可以使用每個訊息附加的 BuildEventContext 類別，以協助識別您想要轉送的事件，然後將事件的名稱傳遞給 ConfigurableForwardingLogger 類別 (或它的子類別)。 當您使用這個方法時，不需要任何其他特定編碼即可轉送事件。

指定轉送記錄器

當轉接記錄器已編譯成組件之後，您必須要求 MSBuild 在建置期間使用這個組件。 若要執行此工作，請搭配使用 -FileLogger、-FileLoggerParameters 和 -DistributedFileLogger 參數與 MSBuild.exe。 -FileLogger 參數會告知 MSBuild.exe 已直接附加記錄器。 -DistributedFileLogger 參數表示每個節點都有一個記錄檔。 若要設定轉送記錄器的參數，請使用 -FileLoggerParameters 參數。 如需這些參數與其他 MSBuild.exe 參數的詳細資訊，請參閱命令列參考。

能夠辨識多處理器的記錄器

當您在多處理器系統建置專案時，來自每個處理器的建置訊息不會自動按一致順序交錯排列。 因此，您必須使用附加至每個訊息的 BuildEventContext 類別，以建立訊息群組優先順序。 如需多處理器建置的詳細資訊，請參閱在多處理器環境中記錄。

相關內容