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回失敗した場合は、失敗としてマークされます。