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)

Добавляет 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 ()

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

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)

Внедряет используемый 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)

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

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

Возвращает 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 ()

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

получитьАби 

public IAbi getAbi ()

Возврат
IAbi

getAfterTestCmd 

public  getAfterTestCmd ()

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

Возврат

getBeforeTestCmd 

public  getBeforeTestCmd ()

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

Возврат

getExcludeFilters 

public  getExcludeFilters ()

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

Возврат

getFileExclusionFilterRegex 

public  getFileExclusionFilterRegex ()

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

Возврат

getGTestFlags 

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

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

setAbi 

public void setAbi (IAbi abi)

Параметры
abi IAbi

setCollectTestOnly 

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

стирание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 listener)

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

Параметры
listener ITestInvocationListener

Возврат
ITestInvocationListener

loadFilter 

protected abstract String loadFilter (String path)

Определите метод фильтра get.

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

Параметры
path String : полный путь к файлу фильтра.

Возврат
String строка фильтра.

Броски
DeviceNotAvailableException

setRunDisabled 

protected void setRunDisabled (boolean runDisabled)

Установите, должен ли GTest запускать отключенные тесты.

Параметры
runDisabled boolean