ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知的间接子类 AdbStopServerPreparer、AllTestAppsInstallSetupr、AoaTargetPreparer、AppSetup、ArtChrootPreparer、BaseEmulatorPreparer、BaseTargetPreparer、BuildInfoPreparer、BuildInfoPrepare8准备{Pair{Pair}准备{Pair}准备{准备} 准备{Pair}准备{Pair}准备{Pair}准备{Pair}准备、准备{Pair} AdbStopServerPreparer 目标准备器，用于在运行 adb 测试前后停止主机上的 adb 服务器。  AllTestAppsInstallSetup 一个 ITargetPreparer，用于将 IDeviceBuildInfo#getTestsDir() 文件夹中的所有应用安装到设备上。  AoaTargetPreparer ITargetPreparer，它使用 Android 开放配件 (AOAv2) 协议执行一系列操作（例如点击和滑动）。  应用设置 用于安装 APK 及其测试的 ITargetPreparer。  ArtChrootPreparer 为 ART 测试创建 chroot 目录。  BaseEmulatorPreparer 用于启动本地模拟器的通用准备器。  BaseTargetPreparer ITargetPreparer 的基础实现类，用于控制是否停用对象。  BuildInfoRecorder 一个 ITargetPreparer，用于将 build 信息元数据写入指定文件。  CheckPairingPreparer CompanionAwarePreparer，用于验证主要设备和配套设备之间的 BT 绑定 CompanionAllocator 负责分配和释放配套设备的基类 应实现 getCompanionDeviceSelectionOptions() 以描述分配配套设备所需的条件 CompanionAwarePreparer ITargetPreparer，用于封装获取已分配的配套设备的逻辑。  CompanionRunCommandTargetPreparer 在分配的配套设备上运行指定命令的 ITargetPreparer CompanionTestAppInstallSetup 一个 ITargetPreparer，用于将 IDeviceBuildInfo#getTestsDir() 文件夹中的一个或多个应用安装到分配的配套设备上。  CompileBootImageWithSpeedTargetPreparer 使用编译过滤器“speed”重新编译启动类路径和系统服务器。  CpuThrottlingWaiter 一个 ITargetPreparer，会等待所有核心上的最大频率都恢复到可用的最高级别 CreateAvdPreparer   CreateUserPreparer 用于创建用户并在最后清理的目标准备器。  DeviceActionTargetPreparer 用于执行设备操作的 ITargetPreparer。  DeviceBuildInfoBootStrapper ITargetPreparer，用于将 build 信息字段替换为从设备读取的属性 这对于测试使用从外部源代码（例如 DeviceBuildInfoInjector 一个 ITargetPreparer，用于将 DeviceBuildDescriptor 元数据插入 IBuildInfo。  DeviceCleaner 在测试后执行重新启动或格式化操作作为清理操作，并且可以选择关闭屏幕 DeviceFlashPreparer 用于在 Android 实体硬件上刷写映像的 ITargetPreparer。  DeviceImageZipFlashingTargetPreparer 一个目标准备器，可使用通过特定格式提供的设备映像刷写设备。  DeviceOwnerTargetPreparer 用于设置设备所有者组件的 ITargetPreparer。  设备设置 一个 ITargetPreparer，用于根据提供的 Option 配置用于测试的设备。  DeviceStorageFiller 目标准备器来填充存储空间，以便有足够的可用空间。  DeviceStringPusher 用于将字符串写入文件的目标准备器。  DeviceUpdateTargetPreparer 一个抽象 ITargetPreparer，负责处理使用来自外部来源（而不是构建服务）的设备映像文件更新设备的常用步骤。  设备擦除器 用于擦除用户数据的 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。  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 一个 ITargetPreparer，用于将 IDeviceBuildInfo.getTestsDir() 文件夹中的一个或多个文件/目录推送到设备上。  TestSystemAppInstallSetup 一个 ITargetPreparer，用于将 IDeviceBuildInfo.getTestsDir() 文件夹中的一个或多个应用安装到设备上的 /system 分区。  耗时 一个简单的目标准备器，用于浪费时间并可能重启设备。  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)

公共方法

设置

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

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

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

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

抛出
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：被测 build 的相关数据。
e	Throwable：如果调用因异常而结束，这将成为在调用级别捕获的异常。否则，将为 null。

抛出
DeviceNotAvailableException	如果设备无响应