ВызовВыполнение

public class InvocationExecution
extends Object implements IInvocationExecution

java.lang.Object
↳ com.android.tradefed.invoker.InvocationExecution

Класс, описывающий все этапы вызова: сборка, загрузка, подготовка цели, запуск тестов, очистка. Может быть расширен для переопределения поведения по умолчанию для некоторых этапов. Порядок этапов определяется классом TestInvocation .

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

Константы

String ADB_VERSION_KEY

String JAVA_CLASSPATH_KEY

String JAVA_VERSION_KEY

Государственные строители

InvocationExecution ()

Общедоступные методы

void cleanUpBuilds ( IInvocationContext context, IConfiguration config)

Выполните шаг очистки build_provider.

void doCleanUp ( IInvocationContext context, IConfiguration config, Throwable exception)

Выполните этап очистки target_preparer и multi_target_preparer.

void doSetup ( TestInformation testInfo, IConfiguration config, ITestLogger listener)

Выполните шаг настройки target_preparer и multi_target_preparer.

void doTeardown ( TestInformation testInfo, IConfiguration config, ITestLogger logger, Throwable exception)

Выполните этапы завершения работы target_preparer и multi_target_preparer.

boolean fetchBuild ( TestInformation testInfo, IConfiguration config, IRescheduler rescheduler, ITestInvocationListener listener)

Выполните шаг build_provider вызова.

void reportLogs ( ITestDevice device, ITestLogger listener, TestInvocation.Stage stage)

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

void runDevicePostInvocationTearDown ( IInvocationContext context, IConfiguration config, Throwable exception)

Вызовите метод ITestDevice.postInvocationTearDown(Throwable) для каждого устройства, участвующего в вызове.

void runDevicePreInvocationSetup ( IInvocationContext context, IConfiguration config, ITestLogger logger)

Вызовите ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) для каждого устройства в рамках вызова.

void runTests ( TestInformation info, IConfiguration config, ITestInvocationListener listener)

Выполняет тест.

boolean shardConfig ( IConfiguration config, TestInformation testInfo, IRescheduler rescheduler, ITestLogger logger)

Предпринята попытка разделить конфигурацию на подконфигурации для последующего параллельного выполнения на нескольких ресурсах.

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

void collectAutoInfo ( IConfiguration config, TestInformation info)

Автоматически собирает некоторую информацию об основном тестируемом устройстве.

IShardHelper createShardHelper ()

Создайте и верните объект IShardHelper , который будет использоваться.

void customizeDevicePreInvocation ( IConfiguration config, IInvocationContext context)

Предоставьте возможность настроить некоторые параметры устройства перед выполнением команды preInvocationSetup.

String getAdbVersion ()

Возвращает версию adb, используемую при вызове.

List< ITargetPreparer > getLabPreparersToRun ( IConfiguration config, String deviceName)

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

List< ITargetPreparer > getTargetPreparersToRun ( IConfiguration config, String deviceName)

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

void linkExternalDirs ( IBuildInfo info, TestInformation testInfo)
void logHostAdb ( IConfiguration config, ITestLogger logger)

Соберите логи из файла $TMPDIR/adb.$UID.log.

Throwable runPreparersTearDown ( TestInformation testInfo, ITestDevice device, String deviceName, int deviceIndex, ITestLogger logger, Throwable exception, List< ITargetPreparer > preparersToRun, Map<String, Set< ITargetPreparer >> trackPreparersMap)
void setTestTag ( IBuildInfo info, IConfiguration config)

Обработайте установку тега test в информации о сборке.

Константы

ADB_VERSION_KEY 

public static final String ADB_VERSION_KEY

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

JAVA_CLASSPATH_KEY 

public static final String JAVA_CLASSPATH_KEY

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

JAVA_VERSION_KEY 

public static final String JAVA_VERSION_KEY

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

Государственные строители

ВызовВыполнение 

public InvocationExecution ()

Общедоступные методы

cleanUpBuilds 

public void cleanUpBuilds (IInvocationContext context, 
                IConfiguration config)

Выполните шаг очистки build_provider. Связан с процессом получения данных для сборки.

Параметры
context IInvocationContext : контекст вызова IInvocationContext .

config IConfiguration : IConfiguration этого тестового запуска.

doCleanUp 

public void doCleanUp (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Выполните шаг очистки target_preparer и multi_target_preparer. Произошла ли очистка устройств?

Параметры
context IInvocationContext : контекст вызова IInvocationContext .

config IConfiguration : IConfiguration этого тестового запуска.

exception Throwable : исходное исключение, выброшенное при выполнении теста.

doSetup 

public void doSetup (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger listener)

Выполните шаг настройки target_preparer и multi_target_preparer. Это выполнит всю необходимую настройку устройств для запуска теста.

Параметры
testInfo TestInformation : информация о вызове функции TestInformation .

config IConfiguration : IConfiguration этого тестового запуска.

listener ITestLogger : инструмент ITestLogger для регистрации ошибок настройки.

Броски
BuildError
DeviceNotAvailableException
TargetSetupError

doTeardown 

public void doTeardown (TestInformation testInfo, 
                IConfiguration config, 
                ITestLogger logger, 
                Throwable exception)

Выполните этап завершения работы target_preparer и multi_target_preparer. Выполните завершение работы устройств, связанных с настройкой.

Параметры
testInfo TestInformation : информация о вызове функции TestInformation .

config IConfiguration : IConfiguration этого тестового запуска.

logger ITestLogger : инструмент ITestLogger для создания отчетов.

exception Throwable : исходное исключение, выброшенное при выполнении теста.

Броски
Throwable

fetchBuild 

public boolean fetchBuild (TestInformation testInfo, 
                IConfiguration config, 
                IRescheduler rescheduler, 
                ITestInvocationListener listener)

Выполните шаг build_provider вызова.

Параметры
testInfo TestInformation : информация о вызове функции TestInformation .

config IConfiguration : IConfiguration этого тестового запуска.

rescheduler IRescheduler : IRescheduler для перепланирования частей вызова для выполнения на другом ресурсе(ах)

listener ITestInvocationListener : объект ITestInvocation для сообщения о сбоях при загрузке результатов сборки.

Возвраты
boolean Возвращает true, если сборка успешно загружена, false в противном случае.

Броски
BuildRetrievalError
DeviceNotAvailableException

reportLogs 

public void reportLogs (ITestDevice device, 
                ITestLogger listener, 
                TestInvocation.Stage stage)

Сообщайте о состоянии устройства на разных этапах выполнения команды. Например: logcat.

Параметры
device ITestDevice : Устройство, с которого будут отправляться журналы.

listener ITestLogger : Программа для ведения логов.

stage TestInvocation.Stage : Этап вызова, на котором мы находимся.

runDevicePostInvocationTearDown 

public void runDevicePostInvocationTearDown (IInvocationContext context, 
                IConfiguration config, 
                Throwable exception)

Вызовите метод ITestDevice.postInvocationTearDown(Throwable) для каждого устройства, участвующего в вызове.

Параметры
context IInvocationContext : контекст вызова IInvocationContext .

config IConfiguration : IConfiguration этого тестового запуска.

exception Throwable : исходное исключение, выброшенное выполняющимся тестом, если таковое имелось.

runDevicePreInvocationSetup 

public void runDevicePreInvocationSetup (IInvocationContext context, 
                IConfiguration config, 
                ITestLogger logger)

Вызовите ERROR(ITestDevice.preInvocationSetup(IBuildInfo)/com.android.tradefed.device.ITestDevice#preInvocationSetup(com.android.tradefed.build.IBuildInfo) ITestDevice.preInvocationSetup(IBuildInfo)) для каждого устройства в рамках вызова.

Параметры
context IInvocationContext : контекст вызова IInvocationContext .

config IConfiguration : IConfiguration этого тестового запуска.

logger ITestLogger : инструмент ITestLogger для создания отчетов.

Броски
DeviceNotAvailableException
TargetSetupError

runTests 

public void runTests (TestInformation info, 
                IConfiguration config, 
                ITestInvocationListener listener)

Выполняет тест.

Параметры
info TestInformation : информация TestInformation , используемая для запуска тестов.

config IConfiguration : IConfiguration для выполнения

listener ITestInvocationListener : ITestInvocationListener для результатов тестирования.

Броски
Throwable

shardConfig 

public boolean shardConfig (IConfiguration config, 
                TestInformation testInfo, 
                IRescheduler rescheduler, 
                ITestLogger logger)

Предпринята попытка разделить конфигурацию на подконфигурации для последующего параллельного выполнения на нескольких ресурсах.

Если количество шардов превышает 1, система просто создаст конфигурации для каждого шарда, установив индексы шардов, и перепланирует их. Если количество шардов не задано, система будет использовать IShardHelper.shardConfig .

Параметры
config IConfiguration : текущая IConfiguration .

testInfo TestInformation : TestInformation , содержащий информацию о тестах.

rescheduler IRescheduler : IRescheduler .

logger ITestLogger : ITestLogger используется для записи логов в файл во время сегментирования.

Возвраты
boolean Возвращает true, если тест был сегментирован. В противном случае возвращает false

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

collectAutoInfo 

protected void collectAutoInfo (IConfiguration config, 
                TestInformation info)

Автоматически собирает некоторую информацию об основном тестируемом устройстве.

Параметры
config IConfiguration

info TestInformation

Броски
DeviceNotAvailableException

createShardHelper 

protected IShardHelper createShardHelper ()

Создайте и верните объект IShardHelper , который будет использоваться.

Возвраты
IShardHelper

customizeDevicePreInvocation 

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

Предоставьте возможность настроить некоторые параметры устройства перед выполнением команды preInvocationSetup.

Параметры
config IConfiguration : Конфигурация вызова.

context IInvocationContext : Текущий контекст вызова.

getAdbVersion 

protected String getAdbVersion ()

Возвращает версию adb, используемую при вызове.

Возвраты
String

getLabPreparersToRun 

protected List<ITargetPreparer> getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

Параметры
config IConfiguration

deviceName String

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

getTargetPreparersToRun 

protected List<ITargetPreparer> getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

Параметры
config IConfiguration

deviceName String

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

linkExternalDirs 

protected void linkExternalDirs (IBuildInfo info, 
                TestInformation testInfo)

Параметры
info IBuildInfo

testInfo TestInformation

logHostAdb 

protected void logHostAdb (IConfiguration config, 
                ITestLogger logger)

Соберите логи из файла $TMPDIR/adb.$UID.log.

Параметры
config IConfiguration

logger ITestLogger

runPreparersTearDown 

protected Throwable runPreparersTearDown (TestInformation testInfo, 
                ITestDevice device, 
                String deviceName, 
                int deviceIndex, 
                ITestLogger logger, 
                Throwable exception, 
                List<ITargetPreparer> preparersToRun, 
                Map<String, Set<ITargetPreparer>> trackPreparersMap)

Параметры
testInfo TestInformation

device ITestDevice

deviceName String

deviceIndex int

logger ITestLogger

exception Throwable

preparersToRun List

trackPreparersMap Map

Возвраты
Throwable

setTestTag 

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

Обработайте установку тега test в информации о сборке.

Параметры
info IBuildInfo

config IConfiguration