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 个。 AdbStopServerPreparer 目标准备程序，用于在运行 adb 测试之前和之后停止主机上的 adb 服务器。  AllTestAppsInstallSetup 用于将 IDeviceBuildInfo.getTestsDir() 文件夹中的所有应用安装到设备上的 ITargetPreparer。  AoaTargetPreparer ITargetPreparer，用于使用 Android Open Accessory (AOAv2) 协议执行一系列操作（例如点击和滑动）。  AppSetup 用于安装 apk 及其测试的 ITargetPreparer。  ArtChrootPreparer 为 ART 测试创建 chroot 目录。  BaseEmulatorPreparer 用于启动本地模拟器的常用准备程序。  BaseTargetPreparer ITargetPreparer 的基准实现类，用于控制对象是否已停用。  BuildInfoRecorder 用于将 build 信息元数据写入指定文件的 ITargetPreparer。  CheckPairingPreparer 用于验证主设备和配套设备之间的 BT 配对的 CompanionAwarePreparer  CompanionAllocator 负责分配和释放配套设备的基类 应实现 getCompanionDeviceSelectionOptions()，以描述分配配套设备所需的条件 CompanionAwarePreparer 用于封装获取已分配配套设备的逻辑的 ITargetPreparer。  CompanionRunCommandTargetPreparer 在分配的配套设备上运行指定命令的 ITargetPreparer  CompanionTestAppInstallSetup 用于将 IDeviceBuildInfo.getTestsDir() 文件夹中的一个或多个应用安装到分配的配套设备上的 ITargetPreparer。  CompileBootImageWithSpeedTargetPreparer 使用编译器过滤器“speed”重新编译启动类路径和系统服务器。  CpuThrottlingWaiter 一个 ITargetPreparer，用于等待所有核心的最大频率恢复到可用的最高级别 CreateAvdPreparer   CreateUserPreparer 用于创建用户并在最后进行清理工作的目标准备器。  DeviceActionTargetPreparer ITargetPreparer，用于执行设备操作。  DeviceBuildInfoBootStrapper 一个 ITargetPreparer，用于将 build 信息字段替换为从设备读取的属性 这对于使用从外部来源（例如 DeviceBuildInfoInjector 用于将 DeviceBuildDescriptor 元数据插入 IBuildInfo 的 ITargetPreparer。  DeviceCleaner 在测试后执行重新启动或格式化作为清理操作，并可选择关闭屏幕  DeviceFlashPreparer 用于在实体 Android 硬件上刷写映像的 ITargetPreparer。  DeviceImageZipFlashingTargetPreparer 一种目标准备器，用于使用通过特定格式提供的设备映像刷写设备。  DeviceOwnerTargetPreparer 用于设置设备所有者组件的 ITargetPreparer。  DeviceSetup ITargetPreparer，用于根据提供的 Option 配置设备以进行测试。  DeviceStorageFiller 目标准备器会填满存储空间，以便提供一定量的可用空间。  DeviceStringPusher 用于将字符串写入文件的目标准备器。  DeviceUpdateTargetPreparer 一个抽象 ITargetPreparer，用于处理使用外部来源（而非 build 服务）的设备映像文件更新设备的常见步骤。  DeviceWiper 用于擦除 userdata 的 ITargetPreparer  DisableSELinuxTargetPreparer 目标准备程序，用于停用 SELinux（如果已启用）。  DynamicSystemPreparer 一个 ITargetPreparer，用于在具有动态系统更新的设备 build 之上设置系统映像。  EraseUserDataPreparer 用于擦除设备上用户数据的 ITargetPreparer。  FastbootCommandPreparer 用于触发 fastboot 并发送 fastboot 命令的目标准备器。  FastbootUpdateBootstrapPreparer ITargetPreparer，用于将指定文件（引导加载程序、无线装置、设备映像 ZIP 文件）分阶段导入 IDeviceBuildInfo，以便使用 FastbootDeviceFlasher 刷写设备，然后将启动后设备属性注入 build 信息，以便报告结果。  FeatureFlagTargetPreparer 更新 DeviceConfig（由远程服务调整的功能标志）。  FoldableModePreparer 可切换设备可折叠状态的目标准备器。  FolderSaver 用于从设备中拉取目录、对其进行压缩并将其保存到日志记录后端的 ITargetPreparer。  GkiDeviceFlashPreparer 使用 Android 通用内核通用映像刷写设备的目标准备器。  GsiDeviceFlashPreparer 使用 Android 通用系统映像刷写设备的目标准备器。  ILabPreparer 面向实验准备人员的标记接口 如需了解这些接口的用途，请参阅 ITargetPreparer。  ITargetCleaner 此接口已废弃。 tearDown 已移至基本 ITargetPreparer 接口。  InstallAllTestZipAppsSetup 用于安装测试 zip 文件中的所有应用的 ITargetPreparer。  InstallApexModuleTargetPreparer   InstallApkSetup 用于安装文件系统中一个或多个 apk 的 ITargetPreparer。  InstallBuildEnvApkSetup 用于从 Android 平台 build 环境安装一个或多个测试 APK 的 ITargetPreparer。  InstallKernelModulePreparer 用于安装内核模块的目标准备器。  InstrumentationPreparer 运行插桩的 ITargetPreparer  KillExistingEmulatorPreparer 用于关闭正在运行的模拟器的 ITargetPreparer。  KnownFailurePreparer 目标准备程序会跳过重试已知失败的情况。  LocalEmulatorLaunch 用于从 Android build 环境在本地启动模拟器的 TargetPreparer。  LocalEmulatorSnapshot TargetPreparer，用于从 Android build/开发环境生成干净的模拟器快照 MixKernelTargetPreparer 允许将内核映像与设备映像混合的 ITargetPreparer。  ModuleOemTargetPreparer   NativeLeakCollector 运行“dumpsys meminfo --unreachable -a”的 ITargetPreparer，用于确定每个进程当前占用的不可访问原生内存。  NoApkTestSkipper 一种特殊的准备程序，如果没有要测试的 APK，则允许完全跳过调用（准备和测试）。  PerfettoPreparer Perfetto 准备程序会将配置文件推送到 Perfetto 有权访问的标准位置。  ProfileTargetPreparer 用于为任何配置文件用户 android.os.usertype.profile.XXX 设置目标准备程序的基准类。  PushFileInvoker 此类已废弃。 改用 PushFilePreparer  PushFilePreparer 一个 ITargetPreparer，用于尝试将任意数量的文件从任意主机路径推送到任意设备路径。  PythonVirtualenvPreparer 在宿主机上设置 Python virtualenv 并安装软件包。  RebootTargetPreparer 用于重新启动设备的目标准备程序。  RecoveryLogPreparer 目标准备程序，用于在恢复之前收集日志。  RemoveSystemAppPreparer 用于在测试运行之前从系统分区中移除 apk 的 ITargetPreparer。  RestartSystemServerTargetPreparer 在不重新启动设备的情况下重启系统服务器的目标准备程序。  RootTargetPreparer 根据“force-root”选项执行“adb root”或“adb unroot”的目标准备程序。  RootcanalForwarderPreparer   RunCommandTargetPreparer   RunHostCommandTargetPreparer 目标准备器，用于在运行测试之前和之后运行任意主机命令。  RunHostScriptTargetPreparer 在运行测试之前执行脚本的目标准备器。  RunOnCloneProfileTargetPreparer   RunOnPrivateProfileTargetPreparer   RunOnSdkSandboxTargetPreparer ITargetPreparer，用于标记测试应在 SDK 沙盒中运行。  RunOnSecondaryUserTargetPreparer 一个 ITargetPreparer，用于确保测试以次要用户身份运行。  RunOnSystemUserTargetPreparer 一个 ITargetPreparer，用于标记应在用户（而非当前用户）上运行测试。  RunOnWorkProfileTargetPreparer 一个 ITargetPreparer，用于在设置中创建工作资料，并标记应在该用户中运行测试。  SemaphoreTokenTargetPreparer 这是一个准备程序，用于使用令牌在 tradefed 主机中序列化测试执行。  SideloadOtaTargetPreparer 目标准备程序，用于对指定的 OTA 软件包执行旁加载、应用该软件包、等待设备启动，并注入设备 build 属性以用作 build 信息 此目标准备器假定设备在启动时将处于常规 adb 模式，并会确保设备在应用较新 build 后以相同模式退出。  StopServicesSetup 用于停止设备上服务的 ITargetPreparer。  StubTargetPreparer ITargetPreparer 的占位符空实现。  SuiteApkInstaller 为套件配置安装指定的 APK：从 $ANDROID_TARGET_OUT_TESTCASES 变量或 build 信息中的 ROOT_DIR 安装。 SwitchUserTargetPreparer 在 setUp 中切换到指定用户类型的 ITargetPreparer。  TearDownPassThroughPreparer 允许对配置中作为对象包含的准备程序运行 tearDown。  TemperatureThrottlingWaiter 一个 ITargetPreparer，用于等待设备温度降至目标温度 TestAppInstallSetup 用于将一个或多个应用从 IDeviceBuildInfo.getTestsDir() 文件夹安装到设备上的 ITargetPreparer。  TestFilePushSetup 用于将一个或多个文件/目录从 IDeviceBuildInfo.getTestsDir() 文件夹推送到设备上的 ITargetPreparer。  TestSystemAppInstallSetup 用于将一个或多个应用从 IDeviceBuildInfo.getTestsDir() 文件夹安装到设备上的 /system 分区中的 ITargetPreparer。  TimeWaster 简单的目标准备器会浪费时间，并且可能会重启设备。  UserCleaner 一个 ITargetPreparer，用于在拆解时移除次要用户。  VisibleBackgroundUserPreparer 用于在后台可见状态下启动的用户中运行测试的目标准备器。  WaitForDeviceDatetimePreparer 用于等待在设备上设置日期时间的 ITargetPreparer （可选）如果未在超时期限内设置日期时间，此准备程序可以强制使用 TargetSetupError。  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)

公共方法

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

此方法已废弃。
改用 setUp(com.android.tradefed.invoker.TestInformation)

执行目标设置以进行测试。

参数
device	ITestDevice：要准备的 ITestDevice。
buildInfo	IBuildInfo：与受测 build 相关的数据。

抛出
TargetSetupError	如果在设置环境时发生严重错误
BuildError	如果发生与 BuildInfo 相关的错误
DeviceNotAvailableException	如果设备无响应

setUp

public void setUp (TestInformation testInformation)

执行目标设置以进行测试。

参数
testInformation	TestInformation：调用的 TestInformation。

抛出
TargetSetupError	如果在设置环境时发生严重错误
BuildError	如果由于准备构建而发生错误
DeviceNotAvailableException	如果设备无响应

tearDown

public void tearDown (TestInformation testInformation, 
                Throwable e)

在测试后执行目标清理/拆解。

参数
testInformation	TestInformation：调用的 TestInformation。
e	Throwable：如果调用以异常结束，则这是在调用级别捕获的异常。否则，将为 null。

抛出
DeviceNotAvailableException	如果设备无响应

tearDown

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

此方法已废弃。
改用 tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

在测试后执行目标清理/拆解。

参数
device	ITestDevice：要准备的 ITestDevice。
buildInfo	IBuildInfo：与受测 build 相关的数据。
e	Throwable：如果调用以异常结束，则这是在调用级别捕获的异常。否则，将为 null。

抛出
DeviceNotAvailableException	如果设备无响应