此页面由 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 , CompanionTestAppIn stallSetup 、 CompileBootImageWithSpeedTargetPreparer 、 CpuThrottlingWaiter和其他 72 个。

AdbStopServerPreparer	目标准备器在运行 adb 测试之前和之后停止主机上的 adb 服务器。
所有测试应用程序安装设置	将`IDeviceBuildInfo#getTestsDir()`文件夹中的所有应用程序安装到设备上的`ITargetPreparer` 。
Aoa目标准备器	`ITargetPreparer`使用 Android Open Accessory (AOAv2) 协议执行一系列操作（例如点击和滑动）。
应用设置	安装 apk 及其测试的`ITargetPreparer` 。
ArtChrootPreparer	为 ART 测试创建 chroot 目录。
BaseEmulatorPreparer	用于启动本地模拟器的通用准备器。
基础目标准备者	`ITargetPreparer`的基本实现类，允许控制对象是否被禁用。
构建信息记录器	将构建信息元数据写入指定文件的`ITargetPreparer` 。
检查配对准备器	一个`CompanionAwarePreparer` ，用于验证主要设备和配套设备之间的 BT 绑定
同伴分配器	负责分配和释放配套设备的基类应该实施`getCompanionDeviceSelectionOptions()`来描述分配配套设备所需的标准
CompanionAware准备者	一个`ITargetPreparer` ，它封装了获取已分配的配套设备的逻辑。
CompanionRunCommandTargetPreparer	在分配的配套设备上运行指定命令的`ITargetPreparer`
CompanionTestAppInstallSetup	一个`ITargetPreparer` ，它将`IDeviceBuildInfo#getTestsDir()`文件夹中的一个或多个应用程序安装到分配的配套设备上。
CompileBootImageWithSpeedTargetPreparer	使用编译器过滤器“speed”重新编译引导类路径和系统服务器。
CpuThrottlingWaiter	`ITargetPreparer`等待所有内核的最大频率恢复到可用的最高级别
创建AvdPreparer
创建用户准备者	用于创建用户并在最后清理它的目标准备器。
DeviceBuildInfoBootStrapper	用从设备读取的属性替换构建信息字段的`ITargetPreparer` 这对于测试具有从外部源生成的构建的设备很有用（例如
DeviceBuildInfoInjector	将`DeviceBuildDescriptor`元数据插入`IBuildInfo` `ITargetPreparer` 。
设备清理器	在测试后执行重启或格式化作为清理操作，并可选择关闭屏幕
DeviceFlashPreparer	在物理 Android 硬件上闪烁图像的`ITargetPreparer` 。
DeviceImageZipFlashingTargetPreparer	一个目标准备器，它使用通过特定格式提供的设备映像刷新设备。
设备所有者目标准备者	设置设备所有者组件的`ITargetPreparer` 。
设备设置	一个`ITargetPreparer` ，它根据提供的`Option`配置设备进行测试。
设备存储填充器	目标准备器填满存储空间，以便有一些可用空间可用。
设备字符串推送器	目标准备器将字符串写入文件。
设备更新目标准备器	一个抽象的`ITargetPreparer` ，它负责使用来自外部源（与构建服务相对）的设备映像文件更新设备的常见步骤。
设备刮水器	擦除用户数据的`ITargetPreparer`
禁用 SELinuxTargetPreparer	如果启用，则禁用 SELinux 的目标准备器。
动态系统准备器	一个`ITargetPreparer` ，它在使用动态系统更新构建的设备之上设置系统映像。
擦除用户数据准备器	擦除设备上的用户数据的`ITargetPreparer` 。
FastbootCommandPreparer	触发 fastboot 并发送 fastboot 命令的目标准备器。
FastbootUpdateBootstrapPreparer	一个`ITargetPreparer`将指定文件（引导加载程序、无线电、设备映像 zip）暂存到`IDeviceBuildInfo`中以使用`FastbootDeviceFlasher`刷新设备，然后将启动后设备属性注入构建信息以用于结果报告目的。
FeatureFlagTargetPreparer	更新 DeviceConfig（由远程服务调整的功能标志）。
可折叠模式准备器	可以切换设备折叠状态的目标准备器。
文件夹保护程序	一个`ITargetPreparer` ，它从设备中提取目录，压缩并将其保存到日志记录后端。
GkiDeviceFlashPreparer	使用 android 通用内核通用映像刷新设备的目标准备器。
GsiDeviceFlashPreparer	使用 android 通用系统映像刷新设备的目标准备器。
ILab准备者	实验室准备者的标记界面有关这些接口的用途的说明，请参阅`ITargetPreparer` 。
ITargetCleaner	此接口已弃用。 tearDown 已移至基础 ITargetPreparer 接口。
InstallAllTestZipAppsSetup	在测试 zip 中安装所有应用程序的`ITargetPreparer` 。
安装 ApexModuleTargetPreparer
安装ApkSetup	一个`ITargetPreparer` ，用于安装位于文件系统上的一个或多个 apk。
安装BuildEnvApkSetup	从 Android 平台构建环境安装一个或多个测试 apk 的`ITargetPreparer` 。
InstrumentationPreparer工具	运行检测的`ITargetPreparer`
KillExistingEmulatorPreparer	关闭正在运行的模拟器的`ITargetPreparer` 。
已知故障准备者	目标准备程序跳过重试已知失败。
本地模拟器启动	从 android 构建环境本地启动模拟器的 TargetPreparer。
本地模拟器快照	用于从 android 构建/开发环境生成干净的模拟器快照的 TargetPreparer
MixKernelTargetPreparer	允许将内核映像与设备映像混合的`ITargetPreparer` 。
模块OemTargetPreparer
NativeLeakCollector	运行“dumpsys meminfo --unreachable -a”的`ITargetPreparer`来识别每个进程当前持有的无法访问的本机内存。
NoApkTestSkipper	如果没有要测试的 apk，允许完全跳过调用（准备和测试）的特殊准备器。
完美准备者	Perfetto 准备器将配置文件推送到设备中 perfetto 可以访问的标准位置。
简介目标准备者	为任何配置文件用户`android.os.usertype.profile.XXX`设置目标准备器的基类。
PushFileInvoker	此类已弃用。改为使用`PushFilePreparer`
推送文件准备器	一个`ITargetPreparer` ，它试图将任意数量的文件从任意主机路径推送到任意设备路径。
PythonVirtualenvPreparer	在主机上设置 Python virtualenv 并安装包。
RebootTargetPreparer	重新启动设备的目标准备程序。
恢复日志准备器	用于在恢复之前收集日志的目标准备器。
删除SystemAppPreparer	用于在测试运行之前从系统分区中删除 apk 的`ITargetPreparer` 。
RestartSystemServerTargetPreparer	在不重启设备的情况下重启系统服务器的目标准备器。
根目标准备器	基于选项“force-root”执行“adb root”或“adb unroot”的目标准备器。
RunCommandTargetPreparer
RunHostCommandTargetPreparer	目标准备器在运行测试之前和之后运行任意主机命令。
RunHostScriptTargetPreparer	在运行测试之前执行脚本的目标准备器。
RunOnCloneProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	一个`ITargetPreparer`来标记测试应该在 sdk 沙箱中运行。
RunOnSecondaryUserTargetPreparer	一个`ITargetPreparer` ，它在设置中创建一个辅助用户，并标记应该在该用户中运行的测试。
RunOnSystemUserTargetPreparer	标记应在用户（而不是当前用户）上运行测试的`ITargetPreparer` 。
RunOnWorkProfileTargetPreparer	一个`ITargetPreparer` ，它在设置中创建一个工作配置文件，并标记应该在该用户中运行的测试。
信号量令牌目标准备器	这是一个准备程序，用于使用令牌在 tradefed 主机中序列化测试执行。
侧载OtaTargetPreparer	执行指定 OTA 包的侧载、应用包、等待设备启动并注入设备构建属性以用作构建信息的目标准备器此目标准备器假定设备在启动时将处于常规 adb 模式，并将确保设备以相同模式退出但应用了较新的构建。
停止服务设置	停止设备上的服务的`ITargetPreparer` 。
StubTargetPreparer	`ITargetPreparer`的占位符空实现。
SuiteApk安装程序	为套件配置安装指定的 APK：来自 $ANDROID_TARGET_OUT_TESTCASES 变量或构建信息中的 ROOT_DIR。
SwitchUserTargetPreparer	在 setUp 中切换到指定用户种类的`ITargetPreparer` 。
TearDownPassThroughPreparer	允许在作为对象包含在配置中的准备器上运行 tearDown。
TemperatureThrottlingWaiter	`ITargetPreparer`等待设备温度降至目标值
测试应用程序安装设置	一个`ITargetPreparer` ，用于将`IDeviceBuildInfo.getTestsDir()`文件夹中的一个或多个应用程序安装到设备上。
测试文件推送设置	将一个或多个文件/目录从`IDeviceBuildInfo.getTestsDir()`文件夹推送到设备上的`ITargetPreparer` 。
测试系统AppInstallSetup	一个`ITargetPreparer` ，它将`IDeviceBuildInfo.getTestsDir()`文件夹中的一个或多个应用程序安装到设备上的 /system 分区。
浪费时间的人	一个简单的目标准备器会浪费时间并可能重新启动设备。
用户清理器	在拆卸时删除次要用户的`ITargetPreparer` 。
VisibleBackgroundUserPreparer	Target 准备器用于在后台可见的用户中运行测试。
WaitForDeviceDatetimePreparer	等待在设备上设置日期时间的`ITargetPreparer` 如果 datetime 未在超时内设置，则此准备程序可以选择强制`TargetSetupError` ，或者强制主机 datetime 到设备上，
Wifi准备器	必要时在设备上配置 wifi 的`ITargetPreparer` 。

为测试运行准备测试环境。

例如，安装软件、调整环境设置以进行测试、启动目标等。

请注意，可以在配置中指定多个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`	如果设备变得无响应