Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

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

public class InvocationExecution
extends Object implements IInvocationExecution

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

Известные прямые подклассы

DelegatedInvocationExecution , ParentSandboxInvocationExecution , RemoteInvocationExecution , SandboxedInvocationExecution

ДелегированноеВызовВыполнение	`InvocationExecution` , который делегирует выполнение другому двоичному файлу Tradefed.
ParentSandboxInvocationExecution	Версия `InvocationExecution` для специальных действий родительского вызова при запуске песочницы.
RemoteInvocationExecution	Реализация `InvocationExecution` , которая управляет удаленным выполнением.
SandboxedInvocationExecution	Специальное выполнение вызова в песочнице: Это InvocationExection для случая, когда мы находимся внутри песочницы и запускаем команду.

Класс, описывающий все этапы вызова: загрузка сборки, target_prep, запуск тестов, очистка. Может быть расширен для переопределения поведения некоторых этапов по умолчанию. Порядок этапов определяется 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, используемую для вызова.
	`getLabPreparersToRun ( IConfiguration config, String deviceName)` Получить список средств подготовки лабораторных образцов для запуска на этом устройстве.
	`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, preparersToRun, trackPreparersMap)`
`void`	`setTestTag ( IBuildInfo info, IConfiguration config)` Обработка установки тестового тега в информации о сборке.

Константы

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` : исходное исключение, выданное при выполнении теста.

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` результатов теста

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`

настроитьDevicePreInvocation

protected void customizeDevicePreInvocation (IConfiguration config, 
                IInvocationContext context)

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

Параметры
`config`	`IConfiguration` : Конфигурация вызова.
`context`	`IInvocationContext` : Текущий контекст вызова.

getAdbVersion

protected String getAdbVersion ()

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

Возврат
`String`

getLabPreparersToRun

protected  getLabPreparersToRun (IConfiguration config, 
                String deviceName)

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

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

Параметры
`config`	`IConfiguration`
`deviceName`	`String`

Возврат

getTargetPreparersToRun

protected  getTargetPreparersToRun (IConfiguration config, 
                String deviceName)

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

Параметры
`config`	`IConfiguration`
`deviceName`	`String`

Возврат

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, 
                 preparersToRun, 
                 trackPreparersMap)

Параметры
`testInfo`	`TestInformation`
`device`	`ITestDevice`
`deviceName`	`String`
`deviceIndex`	`int`
`logger`	`ITestLogger`
`exception`	`Throwable`
`preparersToRun`
`trackPreparersMap`

Возврат
`Throwable`

setTestTag

protected void setTestTag (IBuildInfo info, 
                IConfiguration config)

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

Параметры
`info`	`IBuildInfo`
`config`	`IConfiguration`