GTestBase
public abstract class GTestBase
extends Object
implements IRemoteTest , IConfigurationReceiver , ITestFilterReceiver , IRuntimeHintProvider , ITestCollector , IShardableTest , IAbiReceiver
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 () Gets вызывает только тестовый двоичный файл, чтобы собрать список применимых тестовых случаев или нет. |
boolean | isEnableXmlOutput () Получает использовать вывод gtest xml для результатов теста или нет. |
boolean | isSharded () Получает флаг isSharded. |
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-тестового фильтра теста. |
ITestInvocationListener | getGTestListener ( ITestInvocationListener listener) Возвращает |
abstract String | loadFilter (String path) Определите метод получения фильтра. |
void | setRunDisabled (boolean runDisabled) Установите, должен ли GTest запускать отключенные тесты. |
Поля
ФИЛЬТР_РАСШИРЕНИЕ
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 ()
Публичные методы
addAllExcludeFilters
public void addAllExcludeFilters (filters)
Добавляет ERROR(/Set)
фильтров, какие тесты исключить.
Параметры | |
---|---|
filters |
addAllIncludeFilters
public void addAllIncludeFilters (filters)
Добавляет ERROR(/Set)
фильтров для включения тестов.
Параметры | |
---|---|
filters |
добавитьExcludeFilter
public void addExcludeFilter (String filter)
Добавляет фильтр исключаемых тестов.
Параметры | |
---|---|
filter | String |
addIncludeFilter
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 ()
Получает регулярное выражение для исключения выполнения определенных файлов.
Возвращает | |
---|---|
получитьGTestFlags
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 |
получитьShardIndex
public int getShardIndex ()
Получает индекс сегмента этого теста.
Возвращает | |
---|---|
int |
getTestFilterKey
public String getTestFilterKey ()
Получает ключ тестового фильтра.
Возвращает | |
---|---|
String |
getTestModule
public String getTestModule ()
Получает имя модуля.
Возвращает | |
---|---|
String |
isCollectTestsOnly
public boolean isCollectTestsOnly ()
Gets вызывает только тестовый двоичный файл, чтобы собрать список применимых тестовых случаев или нет.
Возвращает | |
---|---|
boolean |
Исенаблексмлаутпут
public boolean isEnableXmlOutput ()
Получает использовать вывод gtest xml для результатов теста или нет.
Возвращает | |
---|---|
boolean |
isSharded
public boolean isSharded ()
Получает флаг isSharded.
Возвращает | |
---|---|
boolean |
сетколлектестсонли
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 |
стеретьпрепендидфиленаме
protected void erasePrependedFileName (filters, String filename)
Параметры | |
---|---|
filters | |
filename | String |
getAllGTestFlags
protected String getAllGTestFlags (String path)
Помощник для передачи всех флагов GTest в команду оболочки adb.
Параметры | |
---|---|
path | String : полный путь к двоичному файлу на устройстве. |
Возвращает | |
---|---|
String | ERROR(/String) всех флагов GTest, которые должны быть переданы в GTest |
Броски | |
---|---|
DeviceNotAvailableException |
получить конфигурацию
protected IConfiguration getConfiguration ()
Возвращает тестовую конфигурацию.
Возвращает | |
---|---|
IConfiguration | IConfiguration |
getExceptionMessage
protected String getExceptionMessage (Exception e)
Приложите все усилия, чтобы получить значимое короткое описательное сообщение для данной ERROR(/Exception)
Параметры | |
---|---|
e | Exception : ERROR(/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-тестового фильтра теста.
Обратите внимание, что фильтры фильтруют только имя функции (например, Google Test "Test"); будут рассмотрены все "тестовые случаи" Google Test.
Параметры | |
---|---|
path | String : полный путь к двоичному файлу на устройстве. |
Возвращает | |
---|---|
String | флаг полного фильтра для прохождения g-теста или пустая строка, если ничего не указано |
Броски | |
---|---|
DeviceNotAvailableException |
получитьGTestListener
protected ITestInvocationListener getGTestListener (ITestInvocationListener listener)
Возвращает GTestListener
, который предоставляет дополнительную отладочную информацию, например, обнаруживает дубликаты тестов и сообщает о них, если mDisabledDuplicateCheck имеет значение false. В противном случае возвращает переданный прослушиватель.
Параметры | |
---|---|
listener | ITestInvocationListener |
Возвращает | |
---|---|
ITestInvocationListener |
loadFilter
protected abstract String loadFilter (String path)
Определите метод получения фильтра.
Подкласс должен реализовать, как получить собственный фильтр.
Параметры | |
---|---|
path | String : полный путь к файлу фильтра. |
Возвращает | |
---|---|
String | строка фильтра. |
Броски | |
---|---|
DeviceNotAvailableException |
setRunDisabled
protected void setRunDisabled (boolean runDisabled)
Установите, должен ли GTest запускать отключенные тесты.
Параметры | |
---|---|
runDisabled | boolean |