GTestBase
public abstract class GTestBase
extends Object
implements IAbiReceiver , IConfigurationReceiver , IRemoteTest , IRuntimeHintProvider , IShardableTest , ITestCollector , ITestFilterReceiver
java.lang.Объект | |
↳ | com.android.tradefed.testtype.GTestBase |
Базовый класс gTest
Краткое содержание
Поля | |
---|---|
protected static final String | FILTER_EXTENSION |
protected static final String | GTEST_FLAG_FILE |
protected static final String | GTEST_FLAG_FILTER |
protected static final String | GTEST_FLAG_LIST_TESTS |
protected static final String | GTEST_FLAG_PRINT_TIME |
protected static final String | GTEST_FLAG_RUN_DISABLED_TESTS |
protected static final String | GTEST_XML_OUTPUT
|
Общественные конструкторы | |
---|---|
GTestBase () |
Публичные методы | |
---|---|
void | addAllExcludeFilters ( filters) addAllExcludeFilters ( filters) Добавляет |
void | addAllIncludeFilters ( filters) addAllIncludeFilters ( filters) Добавляет |
void | addExcludeFilter (String filter) Добавляет фильтр, какие тесты следует исключить. |
void | addIncludeFilter (String filter) Добавляет фильтр, определяющий, какие тесты включать. |
String | cleanFilter (String filter) |
void | clearExcludeFilters () Удалите все фильтры исключения, отслеживаемые в данный момент. |
void | clearIncludeFilters () Удалите все отслеживаемые в данный момент фильтры включения. |
IAbi | getAbi () |
getAfterTestCmd () Получает команды оболочки для запуска после GTest. | |
getBeforeTestCmd () Получает команды оболочки для запуска перед GTest. | |
getExcludeFilters () Возвращает текущую | |
getFileExclusionFilterRegex () Получает регулярное выражение для исключения выполнения определенных файлов. | |
getGTestFlags () Получает дополнительные значения флагов для передачи команде оболочки собственного теста. | |
getIncludeFilters () Возвращает текущую | |
long | getMaxTestTimeMs () Получает максимальное время выполнения gtest. |
String | getModuleName () Запустите собственный тестовый модуль Android. |
boolean | getRunDisabledTests () Узнайте, должен ли GTest запускать отключенные тесты. |
long | getRuntimeHint () Возвращает ожидаемое время выполнения теста в миллисекундах. |
int | getShardCount () Возвращает текущее количество осколков. |
int | getShardIndex () Получает индекс осколка этого теста. |
String | getTestFilterKey () Получает ключ тестового фильтра. |
String | getTestModule () Получает имя модуля. |
boolean | isCollectTestsOnly () Получает только вызов тестового двоичного файла для сбора списка применимых тестовых случаев или нет. |
boolean | isEnableXmlOutput () Получает возможность использовать выходные данные gtest xml для получения результатов теста или нет. |
boolean | isSharded () Получает флаг isSharded. |
void | notifyTestExecution (boolean incompleteTestFound, failedTests) notifyTestExecution (boolean incompleteTestFound, failedTests) Уведомить родителя о выполнении теста, чтобы фильтры включения/исключения могли правильно обрабатываться при повторных попытках. |
void | setAbi ( IAbi abi) |
void | setCollectTestsOnly (boolean shouldCollectTest) Включает или отключает режим сбора тестов. |
void | setConfiguration ( IConfiguration configuration) Внедряет используемый |
void | setModuleName (String moduleName) Запустите собственный тестовый модуль Android. |
void | setShardCount (int shardCount) Устанавливает количество осколков этого теста. |
void | setShardIndex (int shardIndex) Устанавливает индекс осколка этого теста. |
split (int shardCountHint) Альтернативная версия функции |
Защищенные методы | |
---|---|
String | createFlagFile (String filter) Создайте файл, содержащий фильтры, которые будут использоваться через --gtest_flagfile, чтобы избежать ограничений ОС на размер аргументов. |
void | erasePrependedFileName ( filters, String filename) erasePrependedFileName ( filters, String filename) |
String | getAllGTestFlags (String path) Помощник для передачи всех флагов GTest в команду оболочки adb. |
IConfiguration | getConfiguration () Возвращает тестовую конфигурацию. |
String | getExceptionMessage (Exception e) Приложите все усилия, чтобы получить значимое короткое описательное сообщение для данного |
String | getGTestCmdLine (String fullPath, String flags) Вспомогательный метод для создания команды gtest для запуска. |
String | getGTestCmdLineWrapper (String fullPath, String flags) Помощник, который позволяет производным классам помещать команду gtest в какой-либо другой инструмент (chroot, strace, gdb и т. д.). |
String | getGTestFilters (String path) Помощник для запуска фильтра g-test. |
ITestInvocationListener | getGTestListener ( ITestInvocationListener... listeners) Возвращает GTestListener, который предоставляет дополнительную информацию об отладке, например обнаруживает и сообщает о повторяющихся тестах, если mDisabledDuplateCheck имеет значение false. |
abstract String | loadFilter (String path) Определите метод фильтра get. |
void | setRunDisabled (boolean runDisabled) Установите, должен ли GTest запускать отключенные тесты. |
Поля
FILTER_EXTENSION
protected static final String FILTER_EXTENSION
GTEST_FLAG_FILE
protected static final String GTEST_FLAG_FILE
GTEST_FLAG_FILTER
protected static final String GTEST_FLAG_FILTER
GTEST_FLAG_LIST_TESTS
protected static final String GTEST_FLAG_LIST_TESTS
GTEST_FLAG_PRINT_TIME
protected static final String GTEST_FLAG_PRINT_TIME
GTEST_FLAG_RUN_DISABLED_TESTS
protected static final String GTEST_FLAG_RUN_DISABLED_TESTS
GTEST_XML_OUTPUT
protected static final String GTEST_XML_OUTPUT
Общественные конструкторы
GTestBase
public GTestBase ()
Публичные методы
добавитьаллексклудефилтерс
public void addAllExcludeFilters (filters)
Добавляет ERROR(/Set)
фильтров, тесты которых нужно исключить.
Параметры | |
---|---|
filters |
добавитьаллинклудефилтерс
public void addAllIncludeFilters (filters)
Добавляет ERROR(/Set)
фильтров, тесты которых нужно включить.
Параметры | |
---|---|
filters |
добавитьExcludeFilter
public void addExcludeFilter (String filter)
Добавляет фильтр, какие тесты следует исключить.
Параметры | |
---|---|
filter | String |
адиндклюдефилтер
public void addIncludeFilter (String filter)
Добавляет фильтр, определяющий, какие тесты включать.
Параметры | |
---|---|
filter | String |
ОчиститьФильтр
public String cleanFilter (String filter)
Параметры | |
---|---|
filter | String |
Возврат | |
---|---|
String |
ОчиститьExcludeFilters
public void clearExcludeFilters ()
Удалите все фильтры исключения, отслеживаемые в данный момент.
ClearIncludeFilters
public void clearIncludeFilters ()
Удалите все отслеживаемые в данный момент фильтры включения.
getAfterTestCmd
publicgetAfterTestCmd ()
Получает команды оболочки для запуска после GTest.
Возврат | |
---|---|
getBeforeTestCmd
publicgetBeforeTestCmd ()
Получает команды оболочки для запуска перед GTest.
Возврат | |
---|---|
getExcludeFilters
publicgetExcludeFilters ()
Возвращает текущую ERROR(/Set)
фильтров исключения.
Возврат | |
---|---|
getFileExclusionFilterRegex
publicgetFileExclusionFilterRegex ()
Получает регулярное выражение для исключения выполнения определенных файлов.
Возврат | |
---|---|
getGTestFlags
publicgetGTestFlags ()
Получает дополнительные значения флагов для передачи команде оболочки собственного теста.
Возврат | |
---|---|
getIncludeFilters
publicgetIncludeFilters ()
Возвращает текущую ERROR(/Set)
включаемых фильтров.
Возврат | |
---|---|
getMaxTestTimeMs
public long getMaxTestTimeMs ()
Получает максимальное время выполнения gtest.
Возврат | |
---|---|
long |
getModuleName
public String getModuleName ()
Запустите собственный тестовый модуль Android.
Возврат | |
---|---|
String | имя собственного тестового модуля для запуска или значение NULL, если оно не установлено. |
getRunDisabledTests
public boolean getRunDisabledTests ()
Узнайте, должен ли GTest запускать отключенные тесты.
Возврат | |
---|---|
boolean | True, если необходимо запускать отключенные тесты, в противном случае — false. |
getRuntimeHint
public long getRuntimeHint ()
Возвращает ожидаемое время выполнения теста в миллисекундах. Время используется для балансировки нагрузки при сегментированном выполнении.
Возврат | |
---|---|
long |
getShardCount
public int getShardCount ()
Возвращает текущее количество осколков.
Возврат | |
---|---|
int |
getShardIndex
public int getShardIndex ()
Получает индекс осколка этого теста.
Возврат | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
Получает ключ тестового фильтра.
Возврат | |
---|---|
String |
getTestModule
public String getTestModule ()
Получает имя модуля.
Возврат | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
Получает только вызов тестового двоичного файла для сбора списка применимых тестовых случаев или нет.
Возврат | |
---|---|
boolean |
исенаблексмлаутпут
public boolean isEnableXmlOutput ()
Получает возможность использовать выходные данные gtest xml для получения результатов теста или нет.
Возврат | |
---|---|
boolean |
isSharded
public boolean isSharded ()
Получает флаг isSharded.
Возврат | |
---|---|
boolean |
уведомитьTestExecution
public void notifyTestExecution (boolean incompleteTestFound,failedTests)
Уведомить родителя о выполнении теста, чтобы фильтры включения/исключения могли правильно обрабатываться при повторных попытках.
Параметры | |
---|---|
incompleteTestFound | boolean |
failedTests |
setCollectTestsOnly
public void setCollectTestsOnly (boolean shouldCollectTest)
Включает или отключает режим сбора тестов.
setConfiguration
public void setConfiguration (IConfiguration configuration)
Внедряет используемый IConfiguration
.
Параметры | |
---|---|
configuration | IConfiguration |
setModuleName
public void setModuleName (String moduleName)
Запустите собственный тестовый модуль Android.
Параметры | |
---|---|
moduleName | String : имя собственного тестового модуля для запуска. |
setShardCount
public void setShardCount (int shardCount)
Устанавливает количество осколков этого теста.
Параметры | |
---|---|
shardCount | int |
setShardIndex
public void setShardIndex (int shardIndex)
Устанавливает индекс осколка этого теста.
Параметры | |
---|---|
shardIndex | int |
расколоть
publicsplit (int shardCountHint)
Альтернативная версия функции split()
, которая также предоставляет shardCount при попытке запуска. Это полезно для некоторых тестировщиков, которые иногда не могут принимать произвольные решения.
Параметры | |
---|---|
shardCountHint | int : количество попыток осколков. |
Возврат | |
---|---|
набор подтестов, которые будут выполняться отдельно, или null если тест в данный момент не подлежит сегментированию |
Защищенные методы
Создать флагфиле
protected String createFlagFile (String filter)
Создайте файл, содержащий фильтры, которые будут использоваться через --gtest_flagfile, чтобы избежать ограничений ОС на размер аргументов.
Параметры | |
---|---|
filter | String : строка фильтра. |
Возврат | |
---|---|
String | Путь к файлу, содержащему фильтр. |
Броски | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
стираниеPrependedFileName
protected void erasePrependedFileName (filters, String filename)
Параметры | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
Помощник для передачи всех флагов GTest в команду оболочки adb.
Параметры | |
---|---|
path | String : полный путь к двоичному файлу на устройстве. |
Возврат | |
---|---|
String | String всех флагов GTest, которые должны быть переданы в GTest. |
Броски | |
---|---|
DeviceNotAvailableException |
получить конфигурацию
protected IConfiguration getConfiguration ()
Возвращает тестовую конфигурацию.
Возврат | |
---|---|
IConfiguration | IConfiguration |
getExceptionMessage
protected String getExceptionMessage (Exception e)
Приложите все усилия, чтобы получить значимое короткое описательное сообщение для данного Exception
Параметры | |
---|---|
e | Exception : Exception |
Возврат | |
---|---|
String | короткое сообщение |
getGTestCmdLine
protected String getGTestCmdLine (String fullPath, String flags)
Вспомогательный метод для создания команды gtest для запуска.
Параметры | |
---|---|
fullPath | String : абсолютный путь файловой системы к двоичному файлу gtest на устройстве. |
flags | String : флаги выполнения gtest. |
Возврат | |
---|---|
String | командная строка оболочки для запуска gtest |
getGTestCmdLineWrapper
protected String getGTestCmdLineWrapper (String fullPath, String flags)
Помощник, который позволяет производным классам обертывать команду gtest каким-либо другим инструментом (chroot, strace, gdb и т. д.).
Параметры | |
---|---|
fullPath | String |
flags | String |
Возврат | |
---|---|
String |
GetGTestFilters
protected String getGTestFilters (String path)
Помощник для запуска фильтра g-test.
Обратите внимание, что фильтры фильтруют только имя функции (например: Google Test «Тест»); будут рассмотрены все тестовые примеры Google Test.
Параметры | |
---|---|
path | String : полный путь к двоичному файлу на устройстве. |
Возврат | |
---|---|
String | флаг полного фильтра для передачи в g-тест или пустая строка, если она не была указана |
Броски | |
---|---|
DeviceNotAvailableException |
getGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)
Возвращает GTestListener, который предоставляет дополнительную информацию об отладке, например обнаруживает и сообщает о повторяющихся тестах, если mDisabledDuplateCheck имеет значение false. В противном случае возвращает переданный прослушиватель.
Параметры | |
---|---|
listeners | ITestInvocationListener |
Возврат | |
---|---|
ITestInvocationListener |
loadFilter
protected abstract String loadFilter (String path)
Определите метод фильтра get.
Подкласс должен реализовать способ получения собственного фильтра.
Параметры | |
---|---|
path | String : полный путь к файлу фильтра. |
Возврат | |
---|---|
String | строка фильтра. |
Броски | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Установите, должен ли GTest запускать отключенные тесты.
Параметры | |
---|---|
runDisabled | boolean |