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)

Добавляет ERROR(/Set) фильтров, какие тесты исключить.

void addAllIncludeFilters ( filters) addAllIncludeFilters ( filters)

Добавляет ERROR(/Set) фильтров для включения тестов.

void addExcludeFilter (String filter)

Добавляет фильтр исключаемых тестов.

void addIncludeFilter (String filter)

Добавляет фильтр, какие тесты включать.

String cleanFilter (String filter)
void clearExcludeFilters ()

Удалите все отслеживаемые фильтры исключения.

void clearIncludeFilters ()

Удалить все фильтры включения, отслеживаемые в настоящее время.

IAbi getAbi ()
getAfterTestCmd ()

Получает команды оболочки для запуска после GTest.

getBeforeTestCmd ()

Получает команды оболочки для запуска перед GTest.

getExcludeFilters ()

Возвращает текущую ERROR(/Set) фильтров исключения.

getFileExclusionFilterRegex ()

Получает регулярное выражение для исключения выполнения определенных файлов.

getGTestFlags ()

Получает значения дополнительных флагов для передачи команде оболочки собственного теста.

getIncludeFilters ()

Возвращает текущую ERROR(/Set) включенных фильтров.

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)

Внедряет используемую IConfiguration .

void setModuleName (String moduleName)

Установите собственный тестовый модуль Android для запуска.

void setShardCount (int shardCount)

Устанавливает количество осколков этого теста.

void setShardIndex (int shardIndex)

Устанавливает индекс осколка этого теста.

split (int shardCountHint)

Альтернативная версия split() , которая также предоставляет shardCount, который пытались запустить.

Защищенные методы

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)

Приложите все усилия, чтобы получить значимое короткое описательное сообщение для данной ERROR(/Exception)

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)

Возвращает GTestListener , который предоставляет дополнительную отладочную информацию, например, обнаруживает дубликаты тестов и сообщает о них, если mDisabledDuplicateCheck имеет значение false.

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 ()

Удалить все фильтры включения, отслеживаемые в настоящее время.

получитьАби

public IAbi getAbi ()

Возвращает
IAbi

getAfterTestCmd

public  getAfterTestCmd ()

Получает команды оболочки для запуска после GTest.

Возвращает

getBeforeTestCmd

public  getBeforeTestCmd ()

Получает команды оболочки для запуска перед GTest.

Возвращает

getExcludeFilters

public  getExcludeFilters ()

Возвращает текущую ERROR(/Set) фильтров исключения.

Возвращает

getFileExclusionFilterRegex

public  getFileExclusionFilterRegex ()

Получает регулярное выражение для исключения выполнения определенных файлов.

Возвращает

получитьGTestFlags

public  getGTestFlags ()

Получает значения дополнительных флагов для передачи команде оболочки собственного теста.

Возвращает

getIncludeFilters

public  getIncludeFilters ()

Возвращает текущую 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 setAbi (IAbi abi)

Параметры
abi IAbi

сетколлектестсонли

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

расколоть

public  split (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