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

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

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