用戶參數

在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_class . test_name ，例如BleScanApiTest或BleScanApiTest.test_start_ble_scan_with_default_settings 。對於此清單中的每個測試案例，如果測試失敗，則會重試一次。如果測試第二次失敗，則將其標記為失敗。