本頁面由 Cloud Translation API 翻譯而成。

拆解全域記錄的嚴重性檔案

目標和動機

無論是在正式環境或測試環境，記錄通常用於診斷及排解系統狀態。

測試中的記錄檔有一個實用的功能，可限制記錄嚴重性。這樣一來，測試作者就能確信，即使測試符合所有預期，也不會遇到意外的錯誤情況。經驗證明，這項功能可偵測細微的錯誤和回歸。

根據預設，如果記錄的嚴重性層級大於 WARNING，也就是 ERROR 以上，測試就會失敗。如要覆寫這項行為，開發人員可以設定更高的門檻。舉例來說，如果預期會出現 ERROR，開發人員就會在與測試相關聯的測試規格中設定 max_severity = "ERROR"。

這項功能剛推出時，所有覆寫值都會在單一檔案中設定。自此之後，您便可針對測試本身定義的測試設定專屬覆寫值。新方法較容易維護。

您必須具備編輯 BUILD.gn 檔案的入門知識。

從 max_severity_fuchsia.json 中挑選項目。例如：

      {
           "max_severity": "FATAL"
           "url": "fuchsia-pkg://fuchsia.com/audio_core_unittests#meta/audio_core_unittests.cm"
      },

您將刪除這部分，並針對上述測試在建構定義中設定類似的設定。

fuchsia_test_package("audio_core_unittests") {
  test_specs = {
      log_settings = {
        max_severity = "FATAL"
      }
  }
  ...
}

您也可以參考這份指南。

請注意，雖然大多數測試都是使用 fuchsia_test_package() 範本定義，但某些測試則是使用其他包裝函式範本定義。通常包裝函式會接受 test_specs，並將其轉送至基礎 fuchsia_test_package 範本。