ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer
АдбСтопсерверпрепарер Целевой подготовительный модуль для остановки сервера adb на хосте до и после запуска тестов adb.
AllTestAppsInstallНастройка ITargetPreparer , который устанавливает все приложения из папки IDeviceBuildInfo#getTestsDir() на устройство.
AoaTargetPreparer ITargetPreparer , который выполняет ряд действий (например, щелчков и пролистываний) с использованием протокола Android Open Accessory (AOAv2).
Настройка приложения ITargetPreparer , который устанавливает APK и его тесты.
ИскусствоChrootPreparer Создайте каталог chroot для тестов ART.
Базовый эмуляторPreparer Общий подготовительный модуль для запуска локального эмулятора.
Базетаржетпрепарер Базовый класс реализации ITargetPreparer , позволяющий контролировать, отключен объект или нет.
БилдИнфоРекордер ITargetPreparer , который записывает метаданные информации о сборке в указанный файл.
CheckPairingPreparer CompanionAwarePreparer , который проверяет соединение BT между основным и сопутствующим устройствами.
CompanionAllocator Базовый класс, который отвечает за выделение и освобождение сопутствующего устройства.

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

CompanionAwarePreparer ITargetPreparer , инкапсулирующий логику получения уже выделенного сопутствующего устройства.
CompanionRunCommandTargetPreparer ITargetPreparer , выполняющий указанные команды на выделенном сопутствующем устройстве.
CompanionTestAppInstallSetup ITargetPreparer , который устанавливает одно или несколько приложений из папки IDeviceBuildInfo#getTestsDir() на выделенное сопутствующее устройство.
CompileBootImageWithSpeedTargetPreparer Перекомпилирует путь к классам загрузки и системный сервер с фильтром компилятора «скорость».
ПроцессорРегулированиеОфициант ITargetPreparer , который ждет, пока максимальная частота всех ядер не восстановится до максимально доступного уровня.
Создатьавдпрепарер
CreateUserPreparer Целевой подготовительный модуль для создания пользователя и его очистки в конце.
Девицеактионтаржетпрепарер ITargetPreparer для выполнения действий с устройством.
УстройствоBuildInfoBootStrapper ITargetPreparer , который заменяет поля информации о сборке атрибутами, считанными с устройства.

Это полезно для тестирования устройств со сборками, созданными из внешнего источника (например,

Девицебилдинформоинжектор ITargetPreparer , который вставляет метаданные DeviceBuildDescriptor в IBuildInfo .
УстройствоОчиститель Выполняет перезагрузку или форматирование в качестве действия по очистке после теста и при необходимости отключает экран.
УстройствоFlashPreparer ITargetPreparer , который записывает образ на физическое оборудование Android.
DeviceImageZipFlashingTargetPreparer Целевой подготовительный модуль, который прошивает устройство образами устройств, предоставленными в определенном формате.
Девицеовнертаржетпрепарер ITargetPreparer , который настраивает компонент владельца устройства.
Настройка устройства ITargetPreparer , который настраивает устройство для тестирования на основе предоставленных Option s.
УстройствоХранилищеНаполнитель Целевой подготовительный модуль для заполнения хранилища, чтобы было доступно некоторое количество свободного места.
УстройствоStringPusher Целевой подготовительный модуль для записи строки в файл.
Девицеупдатетаржетпрепарер Абстрактный ITargetPreparer , который выполняет общие действия по обновлению устройств с помощью файла образа устройства из внешнего источника (в отличие от службы сборки).
УстройствоWiper ITargetPreparer , который стирает пользовательские данные
ОтключитьSELinuxTargetPreparer Целевой подготовительный модуль, который отключает SELinux, если он включен.
ДинамическийСистемПрепарер ITargetPreparer , который настраивает образ системы поверх сборки устройства с помощью динамического обновления системы.
EraseUserDataPreparer ITargetPreparer , который стирает пользовательские данные на устройстве.
Команда FastbootPreparer Целевой подготовительный модуль, который запускает быструю загрузку и отправляет команды быстрой загрузки.
FastbootUpdateBootstrapPreparer ITargetPreparer , который помещает указанные файлы (загрузчик, радио, zip-архив образа устройства) в IDeviceBuildInfo для прошивки устройств с помощью FastbootDeviceFlasher , а затем вводит атрибуты устройства после загрузки в информацию о сборке для целей отчетности о результатах.
FeatureFlagTargetPreparer Обновляет DeviceConfig (флаги функций, настроенные удаленной службой).
Фолдаблемодепрепарер Устройство подготовки цели, которое может переключать складное состояние устройства.
FolderSaver ITargetPreparer , который извлекает каталоги с устройства, сжимает и сохраняет их в серверной части журнала.
GkiDeviceFlashPreparer Целевой подготовительный модуль, который прошивает устройство общим образом общего ядра Android.
GsiDeviceFlashPreparer Целевой подготовительный модуль, который прошивает устройство общим образом системы Android.
ILabPreparer Интерфейс маркеров для специалистов по подготовке лабораторий

См. ITargetPreparer для описания того, для чего предназначены эти интерфейсы.

ITargetCleaner Этот интерфейс устарел. TearDown был перенесен в базовый интерфейс ITargetPreparer.
УстановитьAllTestZipAppsSetup ITargetPreparer , который устанавливает все приложения в тестовый ZIP-архив.
ИнсталлАпексМодулеТаржетПрепарер
Установить ApkSetup ITargetPreparer , который устанавливает один или несколько APK-файлов, расположенных в файловой системе.
УстановитьBuildEnvApkSetup ITargetPreparer , который устанавливает один или несколько тестовых APK-файлов из среды сборки платформы Android.
УстановитьKernelModulePreparer Целевой подготовительный модуль, который прошивает устройство общим образом общего ядра Android.
ИнструментарийПодготовка ITargetPreparer , который запускает инструментарий
KillExistingEmulatorPreparer ITargetPreparer , который завершает работающий эмулятор.
ИзвестныйОтказПодготовка Целевой составитель пропускает повторную попытку с известной неудачей.
ЛокальныйЭмуляторЗапуск TargetPreparer, который запускает эмулятор локально из среды сборки Android.
Снимок локального эмулятора TargetPreparer, предназначенный для создания чистого снимка эмулятора из среды сборки/разработки Android.
MixKernelTargetPreparer ITargetPreparer , который позволяет смешивать образ ядра с образом устройства.
МодульOemTargetPreparer
NativeLeakCollector ITargetPreparer , который запускает 'dumpsys meminfo --unreachable -a' для определения недоступной собственной памяти, в настоящее время удерживаемой каждым процессом.
NoApkTestSkipper Специальный подготовительный модуль, позволяющий полностью пропустить вызов (подготовку и тесты), если к тестам нет APK.
ПерфеттоПрепарер Средство подготовки Perfetto помещает файл конфигурации на устройство в стандартное место, к которому у Perfetto есть доступ.
Профилеттаржетпрепарер Базовый класс для настройки средства подготовки цели для любого пользователя профиля android.os.usertype.profile.XXX .
Пушфилеинвокер Этот класс устарел. Вместо этого используйте PushFilePreparer
Пушфилепрепарер ITargetPreparer , который пытается отправить любое количество файлов с любого пути хоста на любой путь устройства.
PythonVirtualenvPreparer Настраивает виртуальную среду Python на хосте и устанавливает пакеты.
RebootTargetPreparer Целевой подготовительный модуль, который перезагружает устройство.
RecoveryLogPreparer Целевой подготовительный модуль, используемый для сбора журналов перед восстановлением.
Удалениесистемапппрепарер ITargetPreparer для удаления APK из системного раздела перед тестовым запуском.
Рестартсистемсервертаржетпрепарер Целевой подготовительный модуль, который перезапускает системный сервер без перезагрузки устройства.
RootTargetPreparer Целевой подготовительный модуль, выполняющий «adb root» или «adb unroot» на основе опции «force-root».
корневой каналфорвардерпрепарер
ВыполнитьКоммандТаржетПрепарер
RunHostCommandTargetPreparer Целевой подготовительный модуль для запуска произвольных команд хоста до и после запуска теста.
ЗапуститьHostScriptTargetPreparer Целевой подготовительный модуль, который выполняет сценарий перед запуском теста.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer ITargetPreparer отмечающий, что тесты следует запускать в изолированной программной среде SDK.
RunOnSecondaryUserTargetPreparer ITargetPreparer , гарантирующий запуск теста от имени вторичного пользователя.
RunOnSystemUserTargetPreparer ITargetPreparer , который отмечает, что тесты следует запускать для пользователя (а не для текущего пользователя).
Ранонворкпрофилетаржетпрепарер ITargetPreparer , который создает рабочий профиль в программе установки и отмечает, что тесты следует запускать для этого пользователя.
СемафорТокенТаргетПрепарер Это средство подготовки, используемое для использования токена для сериализации выполнения теста на обменном хосте.
Боковая загрузкаOtaTargetPreparer Целевой подготовительный модуль, который выполняет неопубликованную загрузку указанного OTA-пакета, применяет пакет, ждет загрузки устройства и внедряет свойства сборки устройства для использования в качестве информации о сборке.

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

СтопServicesSetup ITargetPreparer , который останавливает службы на устройстве.
Стабтаржетпрепарер Пустая реализация заполнителя ITargetPreparer .
SuiteApkInstaller Устанавливает указанные APK для конфигурации Suite: либо из переменной $ANDROID_TARGET_OUT_TESTCASES, либо из ROOT_DIR в информации о сборке.
SwitchUserTargetPreparer ITargetPreparer , который переключается на указанный тип пользователя в setUp.
TearDownPassThroughPreparer Позволяет запускать TearDown на модулях подготовки, которые включены в конфигурацию как объект.
ТемператураДросселированиеОфициант ITargetPreparer , который ждет, пока температура устройства не снизится до целевого значения.
Настройка TestAppInstall ITargetPreparer , который устанавливает одно или несколько приложений из папки IDeviceBuildInfo.getTestsDir() на устройство.
TestFilePushSetup ITargetPreparer , который помещает один или несколько файлов/каталогов из папки IDeviceBuildInfo.getTestsDir() на устройство.
Настройка TestSystemAppInstall ITargetPreparer , который устанавливает одно или несколько приложений из папки IDeviceBuildInfo.getTestsDir() в раздел /system на устройстве.
TimeWaster Простой средство подготовки цели, позволяющее тратить время и потенциально перезапускать устройство.
ПользовательОчиститель ITargetPreparer , который удаляет дополнительных пользователей при удалении.
VisibleBackgroundUserPreparer Целевой подготовительный модуль для запуска тестов у пользователя, который запускается в видимом фоновом режиме.
WaitForDeviceDatetimePreparer ITargetPreparer , который ожидает установки даты и времени на устройстве.

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

Wi-FiPreparer ITargetPreparer , который при необходимости настраивает Wi-Fi на устройстве.


Подготавливает тестовую среду для тестового запуска.

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

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

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

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

default void setUp ( ITestDevice device, IBuildInfo buildInfo)

Этот метод устарел. Вместо этого используйте setUp(com.android.tradefed.invoker.TestInformation)

default void setUp ( TestInformation testInformation)

Выполните целевую настройку для тестирования.

default void tearDown ( TestInformation testInformation, Throwable e)

Выполните целевую очистку/демонтаж после тестирования.

default void tearDown ( ITestDevice device, IBuildInfo buildInfo, Throwable e)

Этот метод устарел. Вместо этого используйте tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

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

настраивать

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Этот метод устарел.
Вместо этого используйте setUp(com.android.tradefed.invoker.TestInformation)

Выполните целевую настройку для тестирования.

Параметры
device ITestDevice : ITestDevice для подготовки.

buildInfo IBuildInfo : данные о тестируемой сборке.

Броски
TargetSetupError если произошла фатальная ошибка настройки среды
BuildError Если возникает ошибка, связанная с BuildInfo
DeviceNotAvailableException если устройство перестало отвечать на запросы

настраивать

public void setUp (TestInformation testInformation)

Выполните целевую настройку для тестирования.

Параметры
testInformation TestInformation : TestInformation вызова.

Броски
TargetSetupError если произошла фатальная ошибка настройки среды
BuildError Если ошибка возникает из-за подготовки сборки
DeviceNotAvailableException если устройство перестало отвечать на запросы

срывать

public void tearDown (TestInformation testInformation, 
                Throwable e)

Выполните целевую очистку/демонтаж после тестирования.

Параметры
testInformation TestInformation : TestInformation вызова.

e Throwable : если вызов завершился исключением, это будет исключение, перехваченное на уровне вызова. В противном случае будет null .

Броски
DeviceNotAvailableException если устройство перестало отвечать на запросы

срывать

public void tearDown (ITestDevice device, 
                IBuildInfo buildInfo, 
                Throwable e)

Этот метод устарел.
Вместо этого используйте tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

Выполните целевую очистку/демонтаж после тестирования.

Параметры
device ITestDevice : ITestDevice для подготовки.

buildInfo IBuildInfo : данные о тестируемой сборке.

e Throwable : если вызов завершился исключением, это будет исключение, перехваченное на уровне вызова. В противном случае будет null .

Броски
DeviceNotAvailableException если устройство перестало отвечать на запросы