Начиная с 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 и еще 76.

АдбСтопсерверпрепарер	Целевой подготовительный модуль для остановки сервера 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	Целевой подготовительный модуль, который устанавливает модули ядра.
ИнструментарийПодготовка	`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	Целевой подготовительный модуль, который выполняет «адб-рутирование» или «адб-рутирование» на основе опции «принудительное рутирование».
Корневой каналфорвардерпрепарер
ВыполнитьКоммандТаржетПрепарер
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()` на устройство.
Тестфилепушсетуп	`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`	если устройство перестало отвечать на запросы