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 (Set<String> filters)

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

void addAllIncludeFilters (Set<String> filters)

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

void addExcludeFilter (String filter)

Добавляет фильтр, позволяющий исключить определенные тесты.

void addIncludeFilter (String filter)

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

String cleanFilter (String filter)
void clearExcludeFilters ()

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

void clearIncludeFilters ()

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

IAbi getAbi ()
List<String> getAfterTestCmd ()

Задает команду(ы) оболочки для выполнения после GTest.

List<String> getBeforeTestCmd ()

Заставляет выполнить команду(ы) оболочки перед запуском GTest.

Set<String> getExcludeFilters ()

Возвращает текущий Set исключаемых фильтров.

Set<String> getFileExclusionFilterRegex ()

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

List<String> getGTestFlags ()

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

Set<String> getIncludeFilters ()

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

Позволяет использовать XML-вывод gtest для отображения результатов тестирования или нет.

boolean isSharded ()

Получает флаг isSharded.

void notifyTestExecution (boolean incompleteTestFound, Set<String> 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)

Задает индекс сегмента для этого теста.

Collection< IRemoteTest > split (int shardCountHint)

Альтернативная версия функции split() , которая также предоставляет количество шардов, которые пытаются запустить.

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

String convertName (String gtestFlagName)
String createFlagFile (String filter)

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

void erasePrependedFileName (Set<String> 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 (Set<String> filters)

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

Параметры
filters Set

addAllIncludeFilters 

public void addAllIncludeFilters (Set<String> filters)

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

Параметры
filters Set

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

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

getAbi 

public IAbi getAbi ()

Возвраты
IAbi

getAfterTestCmd 

public List<String> getAfterTestCmd ()

Задает команду(ы) оболочки для выполнения после GTest.

Возвраты
List<String>

getBeforeTestCmd 

public List<String> getBeforeTestCmd ()

Заставляет выполнить команду(ы) оболочки перед запуском GTest.

Возвраты
List<String>

getExcludeFilters 

public Set<String> getExcludeFilters ()

Возвращает текущий Set исключаемых фильтров.

Возвраты
Set<String>

getFileExclusionFilterRegex 

public Set<String> getFileExclusionFilterRegex ()

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

Возвраты
Set<String>

getGTestFlags 

public List<String> getGTestFlags ()

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

Возвраты
List<String>

getIncludeFilters 

public Set<String> getIncludeFilters ()

Возвращает текущий Set включаемых фильтров.

Возвраты
Set<String>

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

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

Возвраты
boolean

isEnableXmlOutput 

public boolean isEnableXmlOutput ()

Позволяет использовать XML-вывод gtest для отображения результатов тестирования или нет.

Возвраты
boolean

isSharded 

public boolean isSharded ()

Получает флаг isSharded.

Возвраты
boolean

notifyTestExecution 

public void notifyTestExecution (boolean incompleteTestFound, 
                Set<String> failedTests)

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

Параметры
incompleteTestFound boolean

failedTests Set

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 Collection<IRemoteTest> split (int shardCountHint)

Альтернативная версия функции split() , которая также предоставляет количество шардов, которые пытаются запустить. Это полезно для некоторых средств запуска тестов, которые иногда не могут принимать произвольные решения.

Параметры
shardCountHint int : количество попыток создания шардов.

Возвраты
Collection< IRemoteTest > набор подтестов, которые должны выполняться отдельно, или 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

erasePrependedFileName 

protected void erasePrependedFileName (Set<String> filters, 
                String filename)

Параметры
filters Set

filename String

getAllGTestFlags 

protected String getAllGTestFlags (String path)

Вспомогательная функция для получения всех флагов GTest, которые будут переданы в команду оболочки adb.

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

Возвраты
String String , содержащая все флаги GTest, которые должны быть переданы в GTest.

Броски
DeviceNotAvailableException

получить конфигурацию 

protected IConfiguration getConfiguration ()

Возвращает конфигурацию теста.

Возвраты
IConfiguration IConfiguration

получить сообщение об ошибке 

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 "Test"); будут учитываться все "Test Cases" из Google Test.

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

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

Броски
DeviceNotAvailableException

getGTestListener 

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