ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知的间接子类 AFlagsTargetPreparer、AdbStopServerPreparer、AllTestAppsInstallSetup、AoaTargetPreparer、AppSetup、ArtChrootPreparer、BaseEmulatorPreparer、BaseSwitchUserTargetPreparer、BaseSystemTestEnvPreparer、BaseTargetPreparer、BuildInfoRecorder、CheckPairingPreparer、CompanionAllocator、CompanionAwarePreparer、CompanionRunCommandTargetPreparer 以及其他 94 个。 AFlagsTargetPreparer 使用 aflags 在运行测试之前覆盖标志。  AdbStopServerPreparer 用于在运行 adb 测试之前和之后停止主机上 adb 服务器的目标准备器。  AllTestAppsInstallSetup 一种 ITargetPreparer，可将 IDeviceBuildInfo.getTestsDir() 文件夹中的所有应用安装到设备上。  AoaTargetPreparer ITargetPreparer，用于使用 Android 开放配件 (AOAv2) 协议执行一系列操作（例如点击和滑动）。  AppSetup 用于安装 APK 及其测试的 ITargetPreparer。  ArtChrootPreparer 为 ART 测试创建 chroot 目录。  BaseEmulatorPreparer 用于启动本地模拟器的通用准备器。  BaseSwitchUserTargetPreparer 一种 ITargetPreparer，可在设置中切换到指定的用户类型。  BaseSystemTestEnvPreparer 重新启动到基本系统测试环境  BaseTargetPreparer ITargetPreparer 的基本实现类，用于控制对象是否处于停用状态。  BuildInfoRecorder 一种将 build 信息元数据写入指定文件的 ITargetPreparer。  CheckPairingPreparer 一种用于验证主设备和配套设备之间蓝牙配对的 CompanionAwarePreparer CompanionAllocator 负责分配和释放配套设备的基类 应实现 getCompanionDeviceSelectionOptions() 以描述分配配套设备所需的条件 CompanionAwarePreparer 一种封装了获取已分配的配套设备的逻辑的 ITargetPreparer。  CompanionRunCommandTargetPreparer 一种 ITargetPreparer，可在分配的配套设备上运行指定命令  CompanionTestAppInstallSetup 一种 ITargetPreparer，用于将 IDeviceBuildInfo.getTestsDir() 文件夹中的一个或多个应用安装到已分配的配套设备上。  CompatTargetPreparer 一种 ITargetPreparer，用于准备设备以运行兼容性测试。  CompileBootImageWithSpeedTargetPreparer 使用编译器过滤器“speed”重新编译启动类路径和系统服务器。  CpuThrottlingWaiter 一种 ITargetPreparer，用于等待所有核心上的最大频率恢复到最高可用级别 CreateAvdPreparer   CreateUserPreparer 用于创建次要用户并在结束时清理该用户的目标准备器。  CrosDutTopologyPreparer 一种运行 dt-converter 工具以生成测试配置和测试参数的准备器。  CrosLsNexusPreparer 一种为 ChromeOS 设备启动和停止 LSNexus 服务的准备器。  CtsSettingsSetup 一个 ITargetPreparer，用于配置设备的设置，以便准备运行 CTS 测试。  DeviceActionTargetPreparer 用于执行设备操作的 ITargetPreparer。  DeviceBuildInfoBootStrapper 一种 ITargetPreparer，用于将 build 信息字段替换为从设备读取的属性 这对于测试具有从外部来源生成的 build 的设备非常有用（例如 DeviceBuildInfoInjector 一种将 DeviceBuildDescriptor 元数据插入到 IBuildInfo 中的 ITargetPreparer。  DeviceCleaner 在测试后执行重新启动或格式化操作作为清理操作，并可选择关闭屏幕  DeviceFlashPreparer 一种在实体 Android 硬件上刷写映像的 ITargetPreparer。  DeviceImageZipFlashingTargetPreparer 一种目标准备器，用于将设备刷写为通过特定格式提供的设备映像。  DeviceOwnerTargetPreparer 用于设置设备所有者组件的 ITargetPreparer。  DeviceSetup 一种 ITargetPreparer，可根据提供的 Option 配置设备以进行测试。  DeviceStorageFiller 目标准备器，用于填满存储空间，以便提供一定量的可用空间。  DeviceStringPusher 用于将字符串写入文件的目标准备器。  DeviceUpdateTargetPreparer 一个抽象的 ITargetPreparer，用于处理通过来自外部来源（而非 build 服务）的设备映像文件更新设备的相关常见步骤。  DeviceWiper 一种会擦除用户数据的 ITargetPreparer DexMetadataExtractor 为指定的 APK 安装 Dex 元数据文件。  DisableSELinuxTargetPreparer 如果已启用 SELinux，则停用 SELinux 的目标准备器。  DynamicSystemPreparer 一种 ITargetPreparer，用于在搭载动态系统更新的设备 build 之上设置系统映像。  EhideTargetPreparer 启动 ehide，该进程会向 Android 网络堆栈隐藏以太网接口。  EraseUserDataPreparer 一种会擦除设备上用户数据的 ITargetPreparer。  FastbootCommandPreparer 触发 fastboot 并发送 fastboot 命令的目标准备器。  FastbootUpdateBootstrapPreparer 一个 ITargetPreparer，用于将指定文件（引导加载程序、无线装置、设备映像 zip）暂存到 IDeviceBuildInfo 中，以使设备刷写 FastbootDeviceFlasher，然后将启动后设备属性注入到 build 信息中，以用于结果报告。  FeatureFlagTargetPreparer 此类已弃用。 请改用 AFlagsTargetPreparer。  FoldableModePreparer 一种可以切换设备的可折叠状态的目标准备器。  FolderSaver 一种 ITargetPreparer，用于从设备中提取目录，对其进行压缩并将其保存到日志记录后端。  FutilityCommandPreparer 用于执行无用命令的 Preparer。  GkiDeviceFlashPreparer 一种目标准备器，用于使用 Android 通用内核通用映像刷写设备。  GoogleAccountPreparer 支持配置 Google 账号的 ITargetPreparer。  GoogleAppsSetup 支持各种 Google 应用设置选项的 ITargetPreparer 注意：设备必须先配置账号，请参阅 GoogleAccountPreparer  GoogleDeviceFlashPreparer DeviceFlashPreparer 的一种专业化，支持刷写 Google 设备所需的自定义步骤。  GoogleDeviceSetup DeviceSetup 的扩展版本，可用于设置其他 Google 特定属性。  GsiDeviceFlashPreparer 一种将 Android 通用系统映像刷写到设备上的目标准备器。  HsumBootStrategyPreparer   ILabPreparer 面向实验准备人员的标记界面 如需了解这些接口的用途，请参阅 ITargetPreparer。  ITargetCleaner 此接口已弃用。 tearDown 已移至基本 ITargetPreparer 接口。  InstallAllTestZipAppsSetup 一种用于安装测试 zip 中所有应用的 ITargetPreparer。  InstallApexModuleTargetPreparer   InstallApkSetup 一种 ITargetPreparer，用于安装文件系统上的一个或多个 APK。  InstallBuildEnvApkSetup 一种 ITargetPreparer，用于从 Android 平台 build 环境安装一个或多个测试 apk。  InstallKernelModulePreparer 一种用于安装内核模块的目标准备器。  InstrumentationPreparer 运行插桩的 ITargetPreparer KillExistingEmulatorPreparer 用于关闭正在运行的模拟器的 ITargetPreparer。  KnownFailurePreparer 目标准备器，用于跳过重试已知失败。  LocalEmulatorLaunch 一种 TargetPreparer，用于从 Android 构建环境在本地启动模拟器。  LocalEmulatorSnapshot 一种旨在从 Android build/开发环境生成干净的模拟器快照的 TargetPreparer MixKernelTargetPreparer 一种可将内核映像与设备映像混合的 ITargetPreparer。  MixRadioTargetPreparer 一种可将无线装置映像与设备映像混合的 ITargetPreparer。  ModuleOemTargetPreparer   NativeLeakCollector 一个 ITargetPreparer，用于运行“dumpsys meminfo --unreachable -a”，以识别每个进程当前持有的无法访问的原生内存。  NoApkTestSkipper 一种特殊准备器，如果没有任何 APK 要测试，则允许完全跳过调用（准备和测试）。  PerfettoPreparer Perfetto preparer 将配置文件推送到设备上 Perfetto 可以访问的标准位置。  ProfileTargetPreparer 用于为任何配置文件用户 android.os.usertype.profile.XXX 设置目标准备器的基类。  PushFileInvoker 此类已弃用。 请改用 PushFilePreparer PushFilePreparer 一个 ITargetPreparer，用于尝试将任意数量的文件从任意主机路径推送到任意设备路径。  PythonVirtualenvPreparer 在主机上设置 Python virtualenv 并安装软件包。  RamdumpPreparer 启用 Ramdump。  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 主机中使用令牌来序列化测试执行。  设置设置 一种通过对 SettingsUtil.apk 进行插桩来配置设备设置的 ITargetPreparer。  SideloadOtaTargetPreparer 一种目标准备器，用于执行指定 OTA 软件包的旁加载、应用该软件包、等待设备启动，并注入设备 build 属性以用作 build 信息 此目标准备器假定设备在启动时将处于常规 adb 模式，并确保设备在退出时处于相同模式，但应用了较新的 build。  StopServicesSetup 一种会停止设备上服务的 ITargetPreparer。  StubTargetPreparer ITargetPreparer 的占位空实现。  SuiteApkInstaller 安装指定 APK 以进行 Suite 配置：从 $ANDROID_TARGET_OUT_TESTCASES 变量或 build 信息中的 ROOT_DIR 安装。 SwitchUserTargetPreparer BaseSwitchUserTargetPreparer 的默认实现 - 如需了解详情，请参阅该类的 javadoc。 TearDownPassThroughPreparer 允许对以对象形式包含在配置中的 preparer 运行 tearDown。  TemperatureThrottlingWaiter 一种 ITargetPreparer，用于等待设备温度降至目标温度 TestAppInstallSetup 一种从 IDeviceBuildInfo.getTestsDir() 文件夹向设备安装一个或多个应用的 ITargetPreparer。  TestFilePushSetup 一种 ITargetPreparer，用于将 IDeviceBuildInfo.getTestsDir() 文件夹中的一个或多个文件/目录推送到设备。  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(TestInformation)
default void	setUp(TestInformation testInformation) 执行测试所需的目标设置。
default void	tearDown(TestInformation testInformation, Throwable e) 在测试后执行目标清理/拆解。
default void	tearDown(ITestDevice device, IBuildInfo buildInfo, Throwable e) 此方法已废弃。 请改用 tearDown(TestInformation,Throwable)

公共方法

setUp

public void setUp (ITestDevice device, 
                IBuildInfo buildInfo)

此方法已废弃。
请改用 setUp(TestInformation)

执行测试所需的目标设置。

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

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

setUp

public void setUp (TestInformation testInformation)

执行测试所需的目标设置。

参数
testInformation	TestInformation：调用的 TestInformation。

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

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(TestInformation,Throwable)

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

参数
device	ITestDevice：要准备的 ITestDevice。
buildInfo	IBuildInfo：有关被测 build 的数据。
e	Throwable：如果调用因异常而结束，则此属性将是调用级别捕获的异常。否则，将为 null。

抛出
DeviceNotAvailableException	如果设备无响应