ユーザーパラメータ

Android Comms Test Suite（ACTS）では、ACTS構成内から追加のテスト情報またはパラメーターを指定できます。ユーザーパラメーターは、JSON準拠の任意の形式にすることができ、Pythonで適切なタイプ（たとえば、 dict 、 list 、 str ）にデコードされます。ユーザーパラメータを指定できる場所は2つあります。

• 構成のルートレベル

  {
      "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で特別なプロパティを持つ便利なオプションのユーザーパラメータのリストです。

• Continuous_failure_limit：同じテストクラスの残りのテストをブロックする前に許可する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 。このリストのテストケースごとに、テストが失敗した場合、テストは1回再試行されます。テストが2回失敗した場合は、失敗としてマークされます。