使用者參數

在 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。若測試失敗，系統會重試此清單中的每個測試案例。如果測試第二次失敗，就會標示為失敗。