使用者參數

在 Android Comms Test Suite (ACTS) 中，您可以透過 ACTS 設定指定其他測試資訊或參數。使用者參數可採用任何符合 JSON 規範的格式，並在 Python 中解碼為適當的類型 (例如 dict、list 和 str)。使用者參數可在兩個位置指定：

• 在設定檔的根層級

  {
      "testbed": {
          ...
      },
      "my_user_param1": "my_value",
      "my_user_param2": {"another": ["value"]}
  }
  

• 在測試平台中

  {
      "testbed": {
          "my_testbed": {
              "AndroidDevice": [...],
              ...,
              "my_user_param1": "my_value",
              "my_user_param2": {"another": ["value"]}
          }
      },
  }
  

如果在根層級和測試平台中找到使用者參數，系統會使用測試平台專屬的值。

在 ACTS 測試類別中，使用者可以透過以下方式讀取這項資訊：

class MyActsTest
    def setup_class(self):
        self.my_param_1 = self.user_params['my_user_param1']

        # Get the parameter with a default value if not found within config.
        self.my_param_2 = self.user_params.get('my_user_param2', default={})

特殊使用者參數

以下是 ACTS 中具有特殊屬性的實用選用使用者參數清單：

• consecutive_failure_limit：允許連續失敗的測試次數，之後會封鎖同一個測試類別的其他測試。如果未指定，預設行為會執行所有測試，無論是否失敗皆然。如果測試平台設定不正確，導致所有測試都失敗，這個參數就很實用。

• quiet_tests：以 test_class 或 test_class.test_name 格式指定的測試類別或測試案例清單，例如 BleScanApiTest 或 BleScanApiTest.test_start_ble_scan_with_default_settings。此清單中的每個測試案例都不會產生任何測試失敗構件 (例如錯誤報告、qxdm 記錄)。如果指定的測試類別名稱沒有測試案例，則指定類別中的所有測試案例都會設為略過錯誤報告。這個旗標可用於隱藏預期會失敗的測試案例輸出內容。

• retry_tests：以 test_class 或 test_class.test_name 格式指定的測試類別或測試案例清單，例如 BleScanApiTest 或 BleScanApiTest.test_start_ble_scan_with_default_settings。對於清單中的每個測試案例，如果測試失敗，系統會重試一次。如果測試第二次失敗，就會標示為失敗。