Начиная с 2026 года, в соответствии с нашей моделью стабильной разработки основной ветки и для обеспечения стабильности платформы для экосистемы, мы будем публиковать исходный код в AOSP во 2-м и 4-м кварталах. Для сборки и внесения вклада в AOSP используйте ветку android-latest-release . Ветка android-latest-release manifest всегда будет ссылаться на самый последний релиз, выпущенный в AOSP. Для получения дополнительной информации см. раздел «Изменения в AOSP» .

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

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

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

AFlagsTargetPreparer , AdbStopServerPreparer , AllTestAppsInstallSetup , AoaTargetPreparer , AppSetup , ArtChrootPreparer , BaseEmulatorPreparer , BaseSwitchUserTargetPreparer , BaseSystemTestEnvPreparer , BaseTargetPreparer , BuildInfoRecorder , CheckPairingPreparer , CompanionAllocator , CompanionAwarePreparer , CompanionRunCommandTargetPreparer и еще 94 других.

AFlagsTargetPreparer	Использует `aflags` для переопределения флагов перед запуском теста.
AdbStopServerPreparer	Для подготовки целевой программы необходимо остановить сервер ADB на хосте до и после выполнения тестов ADB.
AllTestAppsInstalLestSetup	Компонент `ITargetPreparer` , который устанавливает все приложения из папки, указанной в `IDeviceBuildInfo.getTestsDir()` на устройство.
AoaTargetPreparer	`ITargetPreparer` это приложение, выполняющее ряд действий (например, клики и свайпы) с использованием протокола Android Open Accessory (AOAv2).
Настройка приложения	`ITargetPreparer` это средство, устанавливающее APK-файл и его тесты.
ArtChrootPreparer	Создайте chroot-каталог для ART-тестов.
BaseEmulatorPreparer	Стандартный инструмент для запуска локального эмулятора.
BaseSwitchUserTargetPreparer	Объект `ITargetPreparer` , который переключается на указанный тип пользователя в параметре setUp.
BaseSystemTestEnvPreparer	Перезагружается в базовую среду тестирования системы.
BaseTargetPreparer	Базовый класс реализации для `ITargetPreparer` , позволяющий управлять тем, отключен объект или нет.
BuildInfoRecorder	Компонент `ITargetPreparer` , который записывает метаданные информации о сборке в указанный файл.
CheckPairingPreparer	`CompanionAwarePreparer` средство проверки сопряжения Bluetooth между основным и дополнительным устройствами.
CompanionAllocator	Базовый класс, отвечающий за выделение и освобождение ресурсов вспомогательного устройства. Для описания критериев, необходимых для выделения вспомогательного устройства, следует реализовать функцию `getCompanionDeviceSelectionOptions()`
CompanionAwarePreparer	Компонент `ITargetPreparer` , инкапсулирующий логику получения уже выделенного вспомогательного устройства.
CompanionRunCommandTargetPreparer	`ITargetPreparer` , выполняющий указанные команды на выделенном вспомогательном устройстве.
CompanionTestAppInstallSetup	`ITargetPreparer` , который устанавливает одно или несколько приложений из папки, указанной в `IDeviceBuildInfo.getTestsDir()` на выделенное вспомогательное устройство.
CompatTargetPreparer	Компонент `ITargetPreparer` , подготавливающий устройство к выполнению тестов совместимости.
CompileBootImageWithSpeedTargetPreparer	Перекомпилирует путь к загрузочным классам и системный сервер с использованием фильтра компилятора 'speed'.
CpuThrottlingWaiter	Компонент `ITargetPreparer` , который ожидает, пока максимальная частота на всех ядрах не будет восстановлена до максимально доступного уровня.
CreateAvdPreparer
CreateUserPreparer	Целевой специалист по подготовке данных для создания дополнительного пользователя и последующей его очистке.
CrosDutTopologyPreparer	Программа-подготовитель, которая запускает инструмент dt-converter для генерации конфигурации и параметров тестирования.
CrosLsNexusPreparer	Программа, которая запускает и останавливает службу LSNexus для устройств ChromeOS.
CtsSettingsSetup	Компонент `ITargetPreparer` , который настраивает параметры устройства в рамках подготовки к запуску тестов CTS.
DeviceActionTargetPreparer	Компонент `ITargetPreparer` для выполнения действий с устройством.
DeviceBuildInfoBootStrapper	Компонент `ITargetPreparer` , заменяющий поля с информацией о сборке атрибутами, считанными с устройства. Это полезно для тестирования устройств с использованием сборок, сгенерированных из внешнего источника (например,
DeviceBuildInfoInjector	Компонент `ITargetPreparer` , который вставляет метаданные `DeviceBuildDescriptor` в `IBuildInfo` .
DeviceCleaner	После проверки выполняет перезагрузку или форматирование в качестве действия по очистке, а также, при необходимости, выключает экран.
DeviceFlashPreparer	`ITargetPreparer` это программа, которая прошивает образ на физическое оборудование Android.
DeviceImageZipFlashingTargetPreparer	Программа для подготовки целевого устройства, которая прошивает устройство образами, предоставленными в определенном формате.
DeviceOwnerTargetPreparer	Компонент `ITargetPreparer` , который настраивает компонент владельца устройства.
Настройка устройства	Компонент `ITargetPreparer` , который настраивает устройство для тестирования на основе предоставленных `Option` .
DeviceStorageFiller	Цель состоит в том, чтобы подготовить документ таким образом заполнить хранилище, чтобы освободить некоторое количество свободного места.
DeviceStringPusher	Целевой подготовитель должен записать строку в файл.
DeviceUpdateTargetPreparer	Абстрактный компонент `ITargetPreparer` , который выполняет стандартные шаги по обновлению устройств с помощью файла образа устройства из внешнего источника (в отличие от службы сборки).
DeviceWiper	`ITargetPreparer` , который удаляет пользовательские данные.
DexMetadataExtractor	Устанавливает файлы метаданных Dex для указанных APK-файлов.
DisableSELinuxTargetPreparer	Программа подготовки целевых объектов, которая отключает SELinux, если он включен.
DynamicSystemPreparer	`ITargetPreparer` это компонент, который создает образ системы поверх сборки устройства с использованием динамического обновления системы.
EhideTargetPreparer	Запускает ehide, который скрывает сетевой интерфейс Ethernet от сетевого стека Android.
EraseUserDataPreparer	`ITargetPreparer` это программа, которая удаляет пользовательские данные с устройства.
FastbootCommandPreparer	Целевой подготовитель, запускающий fastboot и отправляющий команды fastboot.
FastbootUpdateBootstrapPreparer	Компонент `ITargetPreparer` , который подготавливает указанные файлы (загрузчик, радиомодуль, zip-архив образа устройства) для `IDeviceBuildInfo` устройств с помощью `FastbootDeviceFlasher` , а затем внедряет атрибуты устройства после загрузки в информацию о сборке для целей формирования отчета о результатах.
FeatureFlagTargetPreparer	Этот класс устарел. Используйте вместо него `AFlagsTargetPreparer` .
FoldableModePreparer	Устройство для подготовки мишени, позволяющее переключать состояние складывания устройства.
FolderSaver	`ITargetPreparer` , который загружает каталоги с устройства, сжимает их и сохраняет в систему логирования.
FutilityCommandPreparer	Программа-подготовитель для выполнения команд, не приносящих результата.
GkiDeviceFlashPreparer	Программа для подготовки целевых устройств, которая прошивает устройство стандартным образом ядра Android.
GoogleAccountPreparer	Инструмент `ITargetPreparer` , поддерживающий настройку учетных записей Google.
GoogleAppsSetup	`ITargetPreparer` , поддерживающий различные параметры настройки для приложений Google. Примечание: на устройстве сначала необходимо настроить учетную запись, см. `GoogleAccountPreparer`
GoogleDeviceFlashPreparer	Специализация `DeviceFlashPreparer` , поддерживающая пользовательские шаги, необходимые для прошивки устройств Google.
GoogleDeviceSetup	Расширение `DeviceSetup` , позволяющее настраивать дополнительные свойства, специфичные для Google.
GsiDeviceFlashPreparer	Программа для подготовки устройства, которая прошивает его стандартным образом системы Android.
HsumBootStrategyPreparer
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 preparer загружает файл конфигурации на устройство в стандартное место, к которому у Perfetto есть доступ.
ProfileTargetPreparer	Базовый класс для настройки целевого подготовителя для любого профиля пользователя `android.os.usertype.profile.XXX` .
PushFileInvoker	Этот класс устарел. Используйте `PushFilePreparer` вместо него.
PushFilePreparer	`ITargetPreparer` , который пытается отправить любое количество файлов с любого пути на хосте на любой путь на устройстве.
PythonVirtualenvPreparer	Создает виртуальное окружение Python на хосте и устанавливает пакеты.
RamdumpPreparer	Включить дамп оперативной памяти.
RebootTargetPreparer	Целевой подготовитель, который перезагружает устройство.
RecoveryLogPreparer	Программа для подготовки целевых файлов, используемая для сбора логов перед восстановлением.
RemoveSystemAppPreparer	Инструмент `ITargetPreparer` для удаления APK-файла из системного раздела перед запуском теста.
Рестартсистемсервертаржетпрепарер	Программа подготовки цели, которая перезапускает системный сервер без перезагрузки устройства.
RootTargetPreparer	Целевой подготовитель, выполняющий команды «adb root» или «adb unroot» в зависимости от опции «force-root».
RootcanalForwarderPreparer
RunCommandTargetPreparer
RunHostCommandTargetPreparer	Программа подготовки целевых объектов должна выполнять произвольные команды хоста до и после запуска теста.
RunHostScriptTargetPreparer	Инструмент подготовки цели, который выполняет скрипт перед запуском теста.
RunOnCloneProfileTargetPreparer
RunOnPrivateProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	Объект `ITargetPreparer` указывающий на необходимость запуска тестов в песочнице SDK.
RunOnSecondaryUserTargetPreparer	Компонент `ITargetPreparer` , обеспечивающий запуск теста от имени дополнительного пользователя.
RunOnSystemUserTargetPreparer	Параметр `ITargetPreparer` , указывающий на необходимость запуска тестов для данного пользователя (а не для текущего).
Ранонворкпрофилетаржетпрепарер	Компонент `ITargetPreparer` , который создает рабочий профиль в процессе настройки и помечает, что тесты должны выполняться от имени этого пользователя.
SemaphoreTokenTargetPreparer	Это инструмент подготовки, используемый для сериализации выполнения тестов с помощью токена на хосте TradeFed.
Настройки	`ITargetPreparer` , который настраивает параметры устройства посредством анализа файла SettingsUtil.apk.
SideloadOtaTargetPreparer	Программа подготовки целевого устройства, которая выполняет установку указанного OTA-пакета, применяет пакет, ожидает загрузки устройства и внедряет свойства сборки устройства для использования в качестве информации о сборке. Данный инструмент подготовки целевых файлов предполагает, что устройство будет находиться в обычном режиме adb при запуске, и гарантирует, что устройство завершит работу в том же режиме, но с применением более новой сборки.
StopServicesSetup	Компонент `ITargetPreparer` , который останавливает службы на устройстве.
StubTargetPreparer	Заполнитель: пустая реализация объекта `ITargetPreparer` .
SuiteApkInstaller	Устанавливает указанные APK-файлы для конфигурации пакета тестов: либо из переменной $ANDROID_TARGET_OUT_TESTCASES, либо из корневого каталога (ROOT_DIR), указанного в информации о сборке.
SwitchUserTargetPreparer	Реализация класса `BaseSwitchUserTargetPreparer` по умолчанию — см. документацию этого класса для получения дополнительной информации.
TearDownPassThroughPreparer	Позволяет запускать tearDown для подготовителей, включенных в конфигурацию в виде объекта.
Температура, регулирование скорости, официант	Компонент `ITargetPreparer` , который ожидает, пока температура устройства не снизится до целевого значения.
TestAppInstalListSetup	Объект `ITargetPreparer` , который устанавливает одно или несколько приложений из папки, указанной в `IDeviceBuildInfo.getTestsDir()` на устройство.
TestFilePushSetup	Объект `ITargetPreparer` , который отправляет один или несколько файлов/каталогов из папки, созданной с помощью `IDeviceBuildInfo.getTestsDir()` на устройство.
TestSystemAppInstalListSetup	Объект `ITargetPreparer` , который устанавливает одно или несколько приложений из папки, созданной с помощью `IDeviceBuildInfo.getTestsDir()` в раздел /system на устройстве.
TimeWaster	Простая программа для подготовки целей, позволяющая потратить время и, возможно, перезагрузить устройство.
UserCleaner	Компонент `ITargetPreparer` , который удаляет дополнительных пользователей при завершении работы системы.
VisibleBackgroundUserPreparer	Целевой подготовитель для запуска тестов для пользователя, запущенного в видимом фоновом режиме.
WaitForDeviceDatetimePreparer	Компонент `ITargetPreparer` , который ожидает установки даты и времени на устройстве. При желании этот подготовитель может принудительно вызвать ошибку `TargetSetupError` если дата и время не установлены в течение установленного времени ожидания.
WifiPreparer	`ITargetPreparer` это средство, которое при необходимости настраивает Wi-Fi на устройстве.

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

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

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

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

Общедоступные методы
`default void`	`setUp ( ITestDevice device, IBuildInfo buildInfo)` Этот метод устарел. Используйте `setUp(TestInformation)` вместо него.
`default void`	`setUp ( TestInformation testInformation)` Выполните настройку целевой системы для тестирования.
`default void`	`tearDown ( TestInformation testInformation, Throwable e)` После тестирования выполните целевую очистку/демонтаж.
`default void`	`tearDown ( ITestDevice device, IBuildInfo buildInfo, Throwable e)` Этот метод устарел. Используйте `tearDown(TestInformation,Throwable)` вместо него.

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

настраивать

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

Этот метод устарел.
Используйте setUp(TestInformation) вместо этого.

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

Параметры
`device`	`ITestDevice` : `ITestDevice` которое необходимо подготовить.
`buildInfo`	`IBuildInfo` : данные о тестируемой сборке.

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

настраивать

public void setUp (TestInformation testInformation)

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

Параметры
`testInformation`	`TestInformation` : `TestInformation` полученная в результате вызова.

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

срывать

public void tearDown (TestInformation testInformation, 
                Throwable e)

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

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

Броски
`DeviceNotAvailableException`	если устройство перестало реагировать

срывать

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

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

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

Параметры
`device`	`ITestDevice` : `ITestDevice` которое необходимо подготовить.
`buildInfo`	`IBuildInfo` : данные о тестируемой сборке.
`e`	`Throwable` : если вызов завершился исключением, это будет исключение, перехваченное на уровне вызова. В противном случае будет `null` .

Броски
`DeviceNotAvailableException`	если устройство перестало реагировать