本頁面由 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 範本。