В 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
. Для каждого теста в этом списке, если тест не пройден, он повторяется один раз. Если тест не пройден во второй раз, он помечается как проваленный.