GTestBase

public abstract class GTestBase
extends Object implements IAbiReceiver , IConfigurationReceiver , IRemoteTest , IRuntimeHintProvider , IShardableTest , ITestCollector , ITestFilterReceiver

java.lang.Object
↳ com.android.tradefed.testtype.GTestBase

Базовый класс gTest

Краткое содержание

Константы

String FILTER_EXTENSION

String GTEST_FLAG_FILE

String GTEST_FLAG_FILTER

String GTEST_FLAG_LIST_TESTS

String GTEST_FLAG_PRINT_TIME

String GTEST_FLAG_RUN_DISABLED_TESTS

String GTEST_XML_OUTPUT

Публичные конструкторы

GTestBase ()

Публичные методы

void addAllExcludeFilters ( filters)

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

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

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

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 convertName (String gtestFlagName)
String createFlagFile (String filter)

Создайте файл, содержащий фильтры, которые будут использоваться через --gtest_flagfile, чтобы избежать ограничений ОС на размер аргументов.

void 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... listeners)

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

abstract String loadFilter (String path)

Определить метод получения фильтра.

void setRunDisabled (boolean runDisabled)

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

Константы

FILTER_EXTENSION 

protected static final String FILTER_EXTENSION

Постоянное значение: «.filter»

GTEST_FLAG_FILE 

protected static final String GTEST_FLAG_FILE

Постоянное значение: "--gtest_flagfile"

GTEST_FLAG_FILTER 

protected static final String GTEST_FLAG_FILTER

Постоянное значение: "--gtest_filter"

GTEST_FLAG_LIST_TESTS 

protected static final String GTEST_FLAG_LIST_TESTS

Постоянное значение: "--gtest_list_tests"

GTEST_FLAG_PRINT_TIME 

protected static final String GTEST_FLAG_PRINT_TIME

Постоянное значение: "--gtest_print_time"

GTEST_FLAG_RUN_DISABLED_TESTS 

protected static final String GTEST_FLAG_RUN_DISABLED_TESTS

Постоянное значение: "--gtest_also_run_disabled_tests"

GTEST_XML_OUTPUT 

protected static final String GTEST_XML_OUTPUT

Постоянное значение: "--gtest_output=xml:%s"

Публичные конструкторы

GTestBase 

public GTestBase ()

Публичные методы

addAllExcludeFilters 

public void addAllExcludeFilters ( filters)

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

Параметры
filters

addAllIncludeFilters 

public void addAllIncludeFilters ( filters)

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

Параметры
filters

addExcludeFilter 

public void addExcludeFilter (String filter)

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

Параметры
filter String

addIncludeFilter 

public void addIncludeFilter (String filter)

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

Параметры
filter String

чистый фильтр 

public String cleanFilter (String filter)

Параметры
filter String

Возврат
String

clearExcludeFilters 

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) включенных фильтров.

Возврат

получитьMaxTestTimeMs 

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

получитьShardCount 

public int getShardCount ()

Возвращает текущее количество осколков.

Возврат
int

получитьShardIndex 

public int getShardIndex ()

Получает индекс шарда этого теста.

Возврат
int

получитьTestFilterKey 

public String getTestFilterKey ()

Получает ключ тестового фильтра.

Возврат
String

получитьTestModule 

public String getTestModule ()

Получает имя модуля.

Возврат
String

isCollectTestsOnly 

public boolean isCollectTestsOnly ()

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

Возврат
boolean

isEnableXmlOutput 

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

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

расколоть 

public  split (int shardCountHint)

Альтернативная версия split() , которая также возвращает shardCount, который был предпринят для выполнения. Это полезно для некоторых тестировщиков, которые иногда не могут принимать произвольные решения.

Параметры
shardCountHint int : количество попыток осколков.

Возврат
набор подтестов, которые будут выполняться отдельно, или null если тест в данный момент не поддается сегментированию

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

convertName 

protected String convertName (String gtestFlagName)

Параметры
gtestFlagName String

Возврат
String

createFlagFile 

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

получитьExceptionMessage 

protected String getExceptionMessage (Exception e)

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

Параметры
e Exception : Exception

Возврат
String короткое сообщение

получитьGTestCmdLine 

protected String getGTestCmdLine (String fullPath, 
                String flags)

Вспомогательный метод для построения команды gtest для запуска.

Параметры
fullPath String : абсолютный путь в файловой системе к исполняемому файлу gtest на устройстве

flags String : флаги выполнения gtest

Возврат
String командная строка оболочки для запуска gtest

получитьGTestCmdLineWrapper 

protected String getGTestCmdLineWrapper (String fullPath, 
                String flags)

Вспомогательный метод, который позволяет производным классам обернуть команду gtest в какой-либо другой инструмент (chroot, strace, gdb и т.п.).

Параметры
fullPath String

flags String

Возврат
String

получитьGTestFilters 

protected String getGTestFilters (String path)

Помощник для запуска фильтра g-test.

Обратите внимание, что фильтры фильтруют только по имени функции (например: Google Test «Test»); будут рассмотрены все тестовые случаи Google Test.

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

Возврат
String флаг полного фильтра для передачи в g-тест или пустая строка, если ничего не указано

Броски
DeviceNotAvailableException

получитьGTestListener 

protected ITestInvocationListener getGTestListener (ITestInvocationListener... listeners)

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

Параметры
listeners ITestInvocationListener

Возврат
ITestInvocationListener

loadFilter 

protected abstract String loadFilter (String path)

Определить метод получения фильтра.

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

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

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

Броски
DeviceNotAvailableException

setRunDisabled 

protected void setRunDisabled (boolean runDisabled)

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

Параметры
runDisabled boolean