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 开放配件 (AOAv2) 协议执行一系列操作（例如点击和滑动）。  AppSetup 用于安装 apk 及其测试的 ITargetPreparer。  ArtChrootPreparer 为 ART 测试创建 chroot 目录。  BaseEmulatorPreparer 用于启动本地模拟器的常用准备程序。  BaseTargetPreparer ITargetPreparer 的基准实现类，用于控制对象是否已停用。  BuildInfoRecorder 一个 ITargetPreparer，用于将 build 信息元数据写入指定文件。  CheckPairingPreparer CompanionAwarePreparer，用于验证主要设备和配套设备之间的 BT 绑定 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，负责处理使用来自外部来源（而不是构建服务）的设备映像文件更新设备的常用步骤。  DeviceWiper 用于擦除 userdata 的 ITargetPreparer  DisableSELinuxTargetPreparer 目标准备程序，用于停用 SELinux（如果已启用）。  DynamicSystemPreparer 一个 ITargetPreparer，用于在包含动态系统更新的设备 build 上设置系统映像。  EraseUserDataPreparer 用于擦除设备上的用户数据的 ITargetPreparer。  FastbootCommandPreparer 触发 fastboot 并发送 fastboot 命令的目标准备器。  FastbootUpdateBootstrapPreparer 一个 ITargetPreparer，用于将指定的文件（引导加载程序、无线装置、设备映像 zip）暂存到 IDeviceBuildInfo 中，以获取使用 FastbootDeviceFlasher 刷写的设备，然后将启动后的设备属性注入版本信息中，以便报告结果。  FeatureFlagTargetPreparer 更新 DeviceConfig（由远程服务调整的功能标志）。  FoldableModePreparer 可以切换设备的可折叠状态的目标准备器。  FolderSaver 的存储器 一个 ITargetPreparer，用于从设备中提取目录，对目录进行压缩并将其保存到日志记录后端。  GkiDeviceFlashPreparer 使用 Android 通用内核通用映像刷写设备的目标准备器。  GsiDeviceFlashPreparer 使用 Android 通用系统映像刷写设备的目标准备器。  ILabPreparer 实验准备器的标记界面 如需了解这些接口的用途，请参阅 ITargetPreparer。  ITargetCleaner 此接口已废弃。 tearDown 已移至基本 ITargetPreparer 接口。  InstallAllTestZipAppsSetup ITargetPreparer，用于在测试 ZIP 中安装所有应用。  InstallApexModuleTargetPreparer   InstallApkSetup 一个 ITargetPreparer，用于安装位于文件系统上的一个或多个 APK。  InstallBuildEnvApkSetup 从 Android 平台构建环境安装一个或多个测试 APK 的 ITargetPreparer。  InstallKernelModulePreparer 用于安装内核模块的目标准备器。  InstrumentationPreparer 运行插桩的 ITargetPreparer  KillExistingEmulatorPreparer 一个 ITargetPreparer，用于关闭正在运行的模拟器。  KnownFailurePreparer 目标准备器跳过重试已知失败的操作。  LocalEmulatorLaunch 可从 Android 构建环境本地启动模拟器的 TargetPreparer。  LocalEmulatorSnapshot 一个 TargetPreparer，用于从 Android 构建/开发环境中生成干净的模拟器快照 MixKernelTargetPreparer 允许将内核映像与设备映像混合的 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 virtualenv 并安装软件包。  RebootTargetPreparer 用于重新启动设备的目标准备器。  RecoveryLogPreparer 目标准备程序，用于在恢复之前收集日志。  RemoveSystemAppPreparer ITargetPreparer，用于在测试运行之前从系统分区中移除 APK。  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 变量或版本信息中的 ROOT_DIR 安装。 SwitchUserTargetPreparer 用于在 setUp 中切换到指定用户种类的 ITargetPreparer。  TearDownPassThroughPreparer 允许对配置中作为对象包含的准备程序运行 tearDown。  TemperatureThrottlingWaiter 一个 ITargetPreparer，用于等待设备温度降至目标温度 TestAppInstallSetup 将 IDeviceBuildInfo.getTestsDir() 文件夹中的一个或多个应用安装到设备上的 ITargetPreparer。  TestFilePushSetup 用于将一个或多个文件/目录从 IDeviceBuildInfo.getTestsDir() 文件夹推送到设备上的 ITargetPreparer。  TestSystemAppInstallSetup 一个 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(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	如果设备无响应