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

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

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

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

AdbStopServerPreparer , AllTestAppsInstallSetup , AoaTargetPreparer , AppSetup , ArtChrootPreparer , BaseEmulatorPreparer , BaseTargetPreparer , BuildInfoRecorder , CheckPairingPreparer , CompanionAllocator , CompanionAwarePreparer , CompanionRunCommandTargetPreparer , CompanionTestAppInstallSetup , CompileBootImageWithSpeedTargetPreparer , CpuThrottlingWaiter и 79 других.

AdbStopServerPreparer	Целевой подготовитель останавливает сервер adb на хосте до и после запуска тестов adb.
AllTestAppsInstallSetup	`ITargetPreparer` , который устанавливает все приложения из папки `IDeviceBuildInfo.getTestsDir()` на устройство.
AoaTargetPreparer	`ITargetPreparer` , который выполняет ряд действий (например, щелчков и свайпов) с использованием протокола Android Open Accessory (AOAv2).
AppSetup	`ITargetPreparer` , который устанавливает APK и его тесты.
ArtChrootPreparer	Создайте chroot-каталог для тестов ART.
BaseEmulatorPreparer	Общий подготовительный этап для запуска локального эмулятора.
BaseTargetPreparer	Базовый класс реализации для `ITargetPreparer` , позволяющий контролировать, отключен ли объект или нет.
BuildInfoRecorder	`ITargetPreparer` , который записывает метаданные информации о сборке в указанный файл.
CheckPairingPreparer	`CompanionAwarePreparer` , который проверяет соединение BT между основным и сопутствующим устройствами
CompanionAllocator	Базовый класс, который отвечает за выделение и освобождение сопутствующего устройства. `getCompanionDeviceSelectionOptions()` должен быть реализован для описания критериев, необходимых для выделения сопутствующего устройства.
CompanionAwarePreparer	`ITargetPreparer` , который инкапсулирует логику получения уже выделенного сопутствующего устройства.
CompanionRunCommandTargetPreparer	`ITargetPreparer` , который запускает указанные команды на выделенном сопутствующем устройстве
CompanionTestAppInstallSetup	`ITargetPreparer` , который устанавливает одно или несколько приложений из папки `IDeviceBuildInfo.getTestsDir()` на выделенное сопутствующее устройство.
CompileBootImageWithSpeedTargetPreparer	Перекомпилирует загрузочный classpath и системный сервер с фильтром компилятора «speed».
CpuThrottlingWaiter	`ITargetPreparer` , который ждет, пока максимальная частота на всех ядрах не будет восстановлена до максимально доступного уровня.
CreateAvdPreparer
CreateUserPreparer	Подготовитель цели для создания пользователя и его очистки в конце.
DeviceActionTargetPreparer	`ITargetPreparer` для выполнения действий устройства.
DeviceBuildInfoBootStrapper	`ITargetPreparer` , который заменяет поля информации о сборке атрибутами, считанными с устройства. Это полезно для тестирования устройств со сборками, созданными из внешнего источника (например,
DeviceBuildInfoInjector	`ITargetPreparer` , который вставляет метаданные `DeviceBuildDescriptor` в `IBuildInfo` .
DeviceCleaner	Выполняет перезагрузку или форматирование в качестве очистки после теста и при необходимости отключает экран.
DeviceFlashPreparer	`ITargetPreparer` , который прошивает изображение на физическом оборудовании Android.
DeviceImageZipFlashingTargetPreparer	Подготовитель целевого устройства, который прошивает устройство образами устройств, предоставленными в определенном формате.
DeviceOwnerTargetPreparer	`ITargetPreparer` , который настраивает компонент владельца устройства.
Настройка устройства	`ITargetPreparer` , который настраивает устройство для тестирования на основе предоставленных `Option` .
DeviceStorageFiller	Подготовитель целей должен заполнить хранилище, чтобы осталось немного свободного места.
DeviceStringPusher	Подготовитель цели для записи строки в файл.
DeviceUpdateTargetPreparer	Абстрактный `ITargetPreparer` , который выполняет стандартные шаги по обновлению устройств с помощью файла образа устройства из внешнего источника (в отличие от службы сборки).
DeviceWiper	`ITargetPreparer` , который стирает пользовательские данные
Отключить SELinuxTargetPreparer	Подготовитель цели, который отключает SELinux, если включен.
DynamicSystemPreparer	`ITargetPreparer` , который устанавливает образ системы поверх сборки устройства с помощью динамического обновления системы.
EraseUserDataPreparer	`ITargetPreparer` , который стирает данные пользователя на устройстве.
FastbootCommandPreparer	Подготовитель цели, который запускает быструю загрузку и отправляет команды быстрой загрузки.
FastbootUpdateBootstrapPreparer	`ITargetPreparer` который помещает указанные файлы (загрузчик, радио, образ устройства zip) в `IDeviceBuildInfo` для прошивки устройств с помощью `FastbootDeviceFlasher` , а затем внедряет атрибуты устройства после загрузки в информацию о сборке для целей отчетности о результатах.
FeatureFlagTargetPreparer	Обновляет DeviceConfig (флаги функций, настроенные удаленной службой).
FoldableModePreparer	Подготовитель целевого устройства, который может переключать складное состояние устройства.
FolderSaver	`ITargetPreparer` , который извлекает каталоги с устройства, сжимает их и сохраняет в бэкэнде регистрации.
FutilityCommandPreparer	Готовность к выполнению бесполезных команд.
GkiDeviceFlashPreparer	Целевой подготовитель, который прошивает устройство общим образом ядра Android.
GoogleAccountPreparer	`ITargetPreparer` , поддерживающий настройку учетных записей Google.
GsiDeviceFlashPreparer	Подготовитель целевого устройства, который прошивает устройство с помощью образа универсальной системы Android.
ILabPreparer	Интерфейс маркера для специалистов по подготовке лабораторных образцов Описание назначения этих интерфейсов см. `ITargetPreparer` .
ITargetCleaner	Этот интерфейс устарел. tearDown перенесен в базовый интерфейс ITargetPreparer.
InstallAllTestZipAppsSetup	`ITargetPreparer` , который устанавливает все приложения в тестовый zip-архив.
ИнсталлАпексМодулеТаржетПрепарер
InstallApkSetup	`ITargetPreparer` , который устанавливает один или несколько APK-файлов, расположенных в файловой системе.
InstallBuildEnvApkSetup	`ITargetPreparer` , который устанавливает один или несколько тестовых APK-файлов из среды сборки платформы Android.
InstallKernelModulePreparer	Подготовитель цели, устанавливающий модули ядра.
ИнструментарийПодготовитель	`ITargetPreparer` , который запускает инструментирование
KillExistingEmulatorPreparer	`ITargetPreparer` , который завершает работу эмулятора.
KnownFailurePreparer	Целевой подготовитель должен пропустить повторную попытку в случае известной неудачи.
LocalEmulatorLaunch	TargetPreparer, который запускает эмулятор локально из среды сборки Android.
LocalEmulatorSnapshot	TargetPreparer, предназначенный для создания чистого снимка эмулятора из среды сборки/разработки Android.
MixKernelTargetPreparer	`ITargetPreparer` , позволяющий смешивать образ ядра с образом устройства.
MixRadioTargetPreparer	`ITargetPreparer` , позволяющий смешивать радиоизображение с изображением устройства.
ModuleOemTargetPreparer
NativeLeakCollector	`ITargetPreparer` , который запускает «dumpsys meminfo --unreachable -a» для определения недоступной собственной памяти, удерживаемой в данный момент каждым процессом.
NoApkTestSkipper	Специальный препаратор, позволяющий полностью пропустить вызов (подготовку и тесты), если нет APK-файлов для тестов.
PerfettoPreparer	Подготовитель Perfetto помещает файл конфигурации в устройство в стандартное расположение, к которому у Perfetto есть доступ.
ProfileTargetPreparer	Базовый класс для настройки целевого подготовительного элемента для любого профиля пользователя `android.os.usertype.profile.XXX` .
PushFileInvoker	Этот класс устарел. Вместо него используйте `PushFilePreparer` .
PushFilePreparer	`ITargetPreparer` , который пытается переместить любое количество файлов с любого пути хоста на любой путь устройства.
PythonVirtualenvPreparer	Настраивает виртуальное окружение Python на хосте и устанавливает пакеты.
RebootTargetPreparer	Подготовитель цели, который перезагружает устройство.
RecoveryLogPreparer	Целевой подготовитель, используемый для сбора журналов перед восстановлением.
RemoveSystemAppPreparer	`ITargetPreparer` для удаления APK из системного раздела перед тестовым запуском.
Рестартсистемсервертаржетпрепарер	Подготовитель цели, который перезапускает системный сервер без перезагрузки устройства.
RootTargetPreparer	Подготовитель цели, который выполняет «adb root» или «adb unroot» на основе опции «force-root».
Препаратор корневых каналов
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Целевой подготовитель для запуска произвольных команд хоста до и после запуска теста.
RunHostScriptTargetPreparer	Подготовитель целей, который выполняет сценарий перед запуском теста.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	`ITargetPreparer` отмечает, что тесты должны запускаться в песочнице SDK.
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` , обеспечивающий запуск теста от имени вторичного пользователя.
RunOnSystemUserTargetPreparer	`ITargetPreparer` , который отмечает, что тесты должны запускаться для пользователя (а не для текущего пользователя).
Ранонворкпрофилетаржетпрепарер	`ITargetPreparer` , который создает рабочий профиль при настройке и отмечает, что тесты должны запускаться от имени этого пользователя.
SemaphoreTokenTargetPreparer	Это подготовитель, используемый для использования токена для сериализации выполнения теста на хосте tradefed.
SideloadOtaTargetPreparer	Целевой подготовитель, который выполняет стороннюю загрузку указанного пакета OTA, применяет пакет, ждет загрузки устройства и внедряет свойства сборки устройства для использования в качестве информации о сборке. Этот целевой подготовитель предполагает, что при запуске устройство будет находиться в обычном режиме adb, и гарантирует, что устройство выйдет в том же режиме, но с применением более новой сборки.
StopServicesSetup	`ITargetPreparer` , который останавливает службы на устройстве.
StubTargetPreparer	Заполнитель пустой реализации `ITargetPreparer` .
SuiteApkInstaller	Устанавливает указанные APK для конфигурации Suite: либо из переменной $ANDROID_TARGET_OUT_TESTCASES, либо из ROOT_DIR в информации о сборке.
SwitchUserTargetPreparer	`ITargetPreparer` , который переключается на указанный тип пользователя в setUp.
TearDownPassThroughPreparer	Позволяет запускать tearDown для подготовителей, которые включены в конфигурацию как объект.
Регулирование температурыОжидание	`ITargetPreparer` , который ждет, пока температура устройства не опустится до целевого значения
TestAppInstallSetup	`ITargetPreparer` , который устанавливает одно или несколько приложений из папки `IDeviceBuildInfo.getTestsDir()` на устройство.
TestFilePushSetup	`ITargetPreparer` , который помещает один или несколько файлов/каталогов из папки `IDeviceBuildInfo.getTestsDir()` на устройство.
TestSystemAppInstallSetup	`ITargetPreparer` , который устанавливает одно или несколько приложений из папки `IDeviceBuildInfo.getTestsDir()` в раздел /system на устройстве.
TimeWaster	Простой подготовитель цели, позволяющий тратить время и потенциально перезагружать устройство.
UserCleaner	`ITargetPreparer` , который удаляет вторичных пользователей при демонтаже.
Видимый фоновый пользователь	Целевой подготовитель для запуска тестов в пользователе, который запускается в видимом фоновом режиме.
WaitForDeviceDatetimePreparer	`ITargetPreparer` , который ждет установки даты и времени на устройстве. При необходимости этот подготовитель может принудительно выдать `TargetSetupError` если datetime не будет установлен в течение тайм-аута.
WifiPreparer	`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`	если устройство перестало отвечать