ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知的间接子类 AdbStopStopServerPreparer、全部 AdbStopServerPreparer 目标准备器，用于在运行 adb 测试前后停止主机上的 adb 服务器。  AllTestAppsInstallSetup 用于安装 IDeviceBuildInfo#getTestsDir() 中的所有应用的 ITargetPreparer 复制到设备上  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，用于在具有 Dynamic Activity 的设备 build 之上设置系统映像 系统更新。  EraseUserDataPreparer 用于擦除设备上的用户数据的 ITargetPreparer。  FastbootCommandPreparer 触发 fastboot 并发送 fastboot 命令的目标准备器。  FastbootUpdateBootstrapPreparer 一个 ITargetPreparer，用于将指定的文件（引导加载程序、无线装置、设备映像 zip）暂存到 IDeviceBuildInfo，用于通过 FastbootDeviceFlasher 刷写设备，然后进行注入 启动后设备属性添加到 build 信息中，以便报告结果。  FeatureFlagTargetPreparer 更新 DeviceConfig（由远程服务调整的功能标志）。  FoldableModePreparer 可以切换设备的可折叠状态的目标准备器。  FolderSaver 的存储器 一个 ITargetPreparer，用于从设备上提取目录、压缩目录并将其保存到日志记录中 后端。  GkiDeviceFlashPreparer 使用 Android 通用内核通用映像刷写设备的目标准备器。  GsiDeviceFlashPreparer 使用 Android 通用系统映像刷写设备的目标准备器。  ILabPreparer 实验准备器的标记界面 如需了解这些接口的用途，请参阅 ITargetPreparer。  ITargetCleaner <ph type="x-smartling-placeholder"></ph> 此接口已废弃。 tearDown 已移至 ITargetPreparer 基础接口。  InstallAllTestZipAppsSetup 一个 ITargetPreparer，用于将所有应用安装到测试 zip 中。  InstallApexModuleTargetPreparer   InstallApkSetup 一个 ITargetPreparer，用于安装位于文件系统上的一个或多个 APK。  InstallBuildEnvApkSetup 从 Android 平台构建环境安装一个或多个测试 APK 的 ITargetPreparer。  InstallKernelModulePreparer 使用 Android 通用内核通用映像刷写设备的目标准备器。  InstrumentationPreparer 运行插桩的 ITargetPreparer KillExistingEmulatorPreparer 一个 ITargetPreparer，用于关闭正在运行的模拟器。  KnownFailurePreparer 目标准备器跳过重试已知失败的操作。  LocalEmulatorLaunch 可从 Android 构建环境本地启动模拟器的 TargetPreparer。  LocalEmulatorSnapshot 一个 TargetPreparer，用于从 Android 设备生成干净的模拟器快照 构建/开发环境 MixKernelTargetPreparer 一个允许混合内核映像与设备映像的 ITargetPreparer。  ModuleOemTargetPreparer   NativeLeakCollector 运行“dumpsys meminfo --unreachable -a”的 ITargetPreparer来找出 每个进程当前占用的无法访问的原生内存  NoApkTestSkipper 特殊准备器，允许在存在以下情况时完全跳过调用（准备和测试） 没有要测试的 apk。  PerfettoPreparer Perfetto 准备器将配置文件推送到设备的标准位置 Perfetto 的访问权限  ProfileTargetPreparer 用于为任何个人资料用户 android.os.usertype.profile.XXX 设置目标准备器的基类。  PushFileInvoker <ph type="x-smartling-placeholder"></ph> 此类已弃用。 改用 PushFilePreparer PushFilePreparer 一个 ITargetPreparer，它会尝试将任意数量的文件从任何主机路径推送到任何主机路径 设备路径。  PythonVirtualenvPreparer 在主机上设置 Python virtualenv 并安装软件包。  RebootTargetPreparer 用于重新启动设备的目标准备器。  RecoveryLogPreparer 用于在恢复前收集日志的目标准备器。  RemoveSystemAppPreparer ITargetPreparer，用于在测试运行之前从系统分区中移除 APK。  RestartSystemServerTargetPreparer 无需重新启动设备即可重启系统服务器的目标准备器。  RootTargetPreparer 执行“adb root”的目标准备器或“adb unroot”基于“force-root”选项。  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 一个 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) <ph type="x-smartling-placeholder"></ph> 此方法已被弃用。 改用 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) <ph type="x-smartling-placeholder"></ph> 此方法已被弃用。 改用 tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

公共方法

设置

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

<ph type="x-smartling-placeholder"></ph> 此方法已废弃。
改用 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)

<ph type="x-smartling-placeholder"></ph> 此方法已废弃。
改用 tearDown(com.android.tradefed.invoker.TestInformation, Throwable)

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

参数
device	ITestDevice：要准备的 ITestDevice。
buildInfo	IBuildInfo：被测 build 的相关数据。
e	Throwable：如果调用因异常而结束，那么也就表示之前 是在调用级别捕获的。否则，将为 null。

抛出
DeviceNotAvailableException	如果设备无响应