此页面由 Cloud Translation API 翻译。

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知的间接子类

AdbStopServerPreparer 、 AllTestAppsInstallSetup 、 AoaTargetPreparer 、 AppSetup 、 ArtChrootPreparer 、 BaseEmulatorPreparer 、 BaseTargetPreparer 、 BuildInfoRecorder 、 CheckPairingPreparer 、 CompanionAllocator 、 CompanionAwarePreparer 、 CompanionRunCommandTargetPreparer 、 CompanionTestAppInstallSetup 、 CompileBootImage WithSpeedTargetPreparer 、 CpuThrotdlingWaiter和其他 73 个。

AdbStopServerPreparer	目标准备器在运行 adb 测试之前和之后停止主机上的 adb 服务器。
AllTestApps安装设置	一个`ITargetPreparer` ，用于将`IDeviceBuildInfo#getTestsDir()`文件夹中的所有应用程序安装到设备上。
Aoa目标准备器	`ITargetPreparer`使用 Android Open Accessory (AOAv2) 协议执行一系列操作（例如单击和滑动）。
应用程序设置	一个`ITargetPreparer` ，用于安装 apk 及其测试。
ArtChrootPreparer	为 ART 测试创建 chroot 目录。
基础仿真器准备器	用于启动本地模拟器的通用准备器。
基础目标准备器	`ITargetPreparer`的基本实现类，允许控制对象是否被禁用。
构建信息记录器	将构建信息元数据写入指定文件的`ITargetPreparer` 。
检查配对准备器	`CompanionAwarePreparer` ，用于验证主设备和配套设备之间的 BT 绑定
同伴分配器	负责分配和释放配套设备的基类应实现`getCompanionDeviceSelectionOptions()`来描述分配配套设备所需的标准
CompanionAwarePreparer	一个`ITargetPreparer` ，封装了获取已分配的配套设备的逻辑。
CompanionRunCommandTargetPreparer	在分配的配套设备上运行指定命令的`ITargetPreparer`
CompanionTestApp安装设置	一种`ITargetPreparer` ，用于将`IDeviceBuildInfo#getTestsDir()`文件夹中的一个或多个应用程序安装到分配的配套设备上。
CompileBootImageWithSpeedTargetPreparer	使用编译器过滤器“speed”重新编译启动类路径和系统服务器。
CPU节流等待者	`ITargetPreparer`等待所有内核的最大频率恢复到可用的最高级别
创建AvdPreparer
创建用户准备器	用于创建用户并在最后清理它的目标准备器。
DeviceBuildInfoBootStrapper	`ITargetPreparer` ，用从设备读取的属性替换构建信息字段这对于测试具有从外部源生成的版本的设备非常有用（例如
设备构建信息注入器	将`DeviceBuildDescriptor`元数据插入`IBuildInfo` `ITargetPreparer` 。
设备清理器	测试后执行重新启动或格式化作为清理操作，并可选择关闭屏幕
设备闪存准备器	一个`ITargetPreparer` ，可在物理 Android 硬件上闪烁图像。
DeviceImageZipFlashingTargetPreparer	目标准备器，使用通过特定格式提供的设备图像来刷新设备。
设备所有者目标准备者	用于设置设备所有者组件的`ITargetPreparer` 。
设备设置	一个`ITargetPreparer` ，根据提供的`Option`配置设备进行测试。
设备存储填充器	目标准备器填充存储空间，以便有一些可用空间。
设备字符串推送器	目标准备器将字符串写入文件。
设备更新目标准备器	一个抽象的`ITargetPreparer` ，负责使用外部源（而不是构建服务）的设备映像文件更新设备的常见步骤。
设备擦拭器	擦除用户数据的`ITargetPreparer`
禁用SELinuxTargetPreparer	目标准备器将禁用 SELinux（如果已启用）。
动态系统准备器	`ITargetPreparer` ，通过动态系统更新在设备构建之上设置系统映像。
擦除用户数据准备器	一个`ITargetPreparer` ，用于擦除设备上的用户数据。
FastbootCommandPreparer	触发 fastboot 并发送 fastboot 命令的目标准备器。
FastbootUpdateBootstrapPreparer	`ITargetPreparer`将指定文件（引导加载程序、无线电、设备映像 zip）暂存到`IDeviceBuildInfo`中，以获取使用`FastbootDeviceFlasher`刷新的设备，然后将启动后设备属性注入到构建信息中以用于结果报告目的。
功能标志目标准备器	更新 DeviceConfig（由远程服务调整的功能标志）。
可折叠模式准备器	可以切换设备可折叠状态的目标准备器。
文件夹保护程序	`ITargetPreparer`从设备中提取目录，压缩并将其保存到日志记录后端。
GkiDeviceFlashPreparer	一个目标准备器，使用 Android 通用内核通用映像刷新设备。
GsiDeviceFlashPreparer	一个目标准备器，使用 Android 通用系统映像刷新设备。
ILab准备器	实验室准备人员的标记界面有关这些接口用途的描述，请参阅`ITargetPreparer` 。
目标清理器	该接口已被弃用。 TearDown 已移至基本 ITargetPreparer 接口。
安装所有TestZipApps安装程序	一个`ITargetPreparer` ，用于安装测试 zip 中的所有应用程序。
安装ApexModuleTargetPreparer
安装Apk安装	一种`ITargetPreparer` ，用于安装位于文件系统上的一个或多个 apk。
安装BuildEnvApk设置	一种`ITargetPreparer` ，用于从 Android 平台构建环境安装一个或多个测试 apk。
仪表准备者	运行检测的`ITargetPreparer`
杀死现有的模拟器准备器	用于关闭正在运行的模拟器的`ITargetPreparer` 。
已知故障准备器	目标准备器跳过重试已知故障。
本地模拟器启动	从 Android 构建环境本地启动模拟器的 TargetPreparer。
本地模拟器快照	TargetPreparer 用于从 Android 构建/开发环境生成干净的模拟器快照
MixKernelTargetPreparer	一个`ITargetPreparer` ，允许将内核映像与设备映像混合。
模块OemTargetPreparer
NativeLeakCollector	运行“dumpsys meminfo --unreachable -a”的`ITargetPreparer`来识别每个进程当前持有的无法访问的本机内存。
没有ApkTestSkipper	如果没有要测试的 apk，特殊的准备器允许完全跳过调用（准备和测试）。
完美准备者	Perfetto 准备器将配置文件推送到设备中 perfetto 有权访问的标准位置。
配置文件目标准备器	用于为任何配置文件用户设置目标准备器的基类`android.os.usertype.profile.XXX` 。
推送文件调用器	该类已被弃用。使用`PushFilePreparer`代替
推送文件准备器	`ITargetPreparer`尝试将任意数量的文件从任何主机路径推送到任何设备路径。
PythonVirtualenvPreparer	在主机上设置 Python virtualenv 并安装软件包。
重启目标准备器	重新启动设备的目标准备器。
恢复日志准备器	用于在恢复之前收集日志的目标准备器。
删除SystemAppPreparer	`ITargetPreparer` ，用于在测试运行之前从系统分区中删除 apk。
重新启动SystemServerTargetPreparer	重新启动系统服务器而不重新启动设备的目标准备器。
根目标准备器	基于选项“force-root”执行“adb root”或“adb unroot”的目标准备器。
根管转发器准备器
运行命令目标准备器
运行主机命令目标准备器	目标准备器在运行测试之前和之后运行任意主机命令。
运行HostScriptTargetPreparer	在运行测试之前执行脚本的目标准备器。
RunOnCloneProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	一个`ITargetPreparer` ，用于标记测试应在 sdk 沙箱中运行。
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` ，用于在设置中创建辅助用户，并标记测试应在该用户中运行。
RunOnSystemUserTargetPreparer	一个`ITargetPreparer`标记测试应该在用户（而不是当前用户）上运行。
RunOnWorkProfileTargetPreparer	`ITargetPreparer` ，用于在设置中创建工作配置文件，并标记应在该用户中运行测试。
SemaphoreTokenTargetPreparer	这是一个准备器，用于使用令牌在 tradefed 主机中序列化测试执行。
旁载 OtaTargetPreparer	目标准备器，执行指定 OTA 包的旁加载、应用包、等待设备启动并注入设备构建属性以用作构建信息此目标准备器假定设备在启动时将处于常规 adb 模式，并将确保设备以相同模式退出，但应用了较新的版本。
停止服务设置	用于停止设备上的服务的`ITargetPreparer` 。
存根目标准备器	`ITargetPreparer`的占位符空实现。
SuiteApk安装程序	安装套件配置的指定 APK：来自 $ANDROID_TARGET_OUT_TESTCASES 变量或构建信息中的 ROOT_DIR。
切换用户目标准备器	一个`ITargetPreparer` ，用于在setUp中切换到指定的用户类型。
TearDownPassThroughPreparer	允许在作为对象包含在配置中的准备器上运行tearDown。
温度节流服务员	`ITargetPreparer`等待设备温度降至目标值
测试应用程序安装设置	一种`ITargetPreparer` ，用于将`IDeviceBuildInfo.getTestsDir()`文件夹中的一个或多个应用程序安装到设备上。
测试文件推送设置	一种`ITargetPreparer` ，将`IDeviceBuildInfo.getTestsDir()`文件夹中的一个或多个文件/目录推送到设备上。
测试系统应用程序安装设置	一种`ITargetPreparer` ，用于将`IDeviceBuildInfo.getTestsDir()`文件夹中的一个或多个应用程序安装到设备上的 /system 分区上。
浪费时间的人	一个简单的目标准备器，浪费时间并可能重新启动设备。
用户清理器	一个`ITargetPreparer` ，可在拆卸时删除辅助用户。
可见背景用户准备器	用于在后台可见启动的用户中运行测试的目标准备器。
等待设备日期时间准备器	等待在设备上设置日期时间的`ITargetPreparer` （可选）如果未在超时内设置日期时间，则此准备器可以强制`TargetSetupError` ，或者将主机日期时间强制到设备上，
Wifi准备器	如有必要，可在设备上配置 wifi 的`ITargetPreparer` 。

为测试运行准备测试环境。

例如，安装软件、调整环境设置以进行测试、启动目标等。

请注意，可以在配置中指定多个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` ：有关被测构建的数据。

投掷
`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` ：有关被测构建的数据。
`e`	`Throwable` ：如果调用以异常结束，则这将是在调用级别捕获的异常。否则，将为`null` 。

投掷
`DeviceNotAvailableException`	如果设备没有响应

ITargetPreparer

public interface ITargetPreparer
implements IDisableable

com.android.tradefed.targetprep.ITargetPreparer

已知的间接子类

AdbStopServerPreparer	目标准备器在运行 adb 测试之前和之后停止主机上的 adb 服务器。
AllTestApps安装设置	一个`ITargetPreparer` ，用于将`IDeviceBuildInfo#getTestsDir()`文件夹中的所有应用程序安装到设备上。
Aoa目标准备器	`ITargetPreparer`使用 Android Open Accessory (AOAv2) 协议执行一系列操作（例如单击和滑动）。
应用程序设置	一个`ITargetPreparer` ，用于安装 apk 及其测试。
ArtChrootPreparer	为 ART 测试创建 chroot 目录。
基础仿真器准备器	用于启动本地模拟器的通用准备器。
基础目标准备器	`ITargetPreparer`的基本实现类，允许控制对象是否被禁用。
构建信息记录器	将构建信息元数据写入指定文件的`ITargetPreparer` 。
检查配对准备器	`CompanionAwarePreparer` ，用于验证主设备和配套设备之间的 BT 绑定
同伴分配器	负责分配和释放配套设备的基类应实现`getCompanionDeviceSelectionOptions()`来描述分配配套设备所需的标准
CompanionAwarePreparer	一个`ITargetPreparer` ，封装了获取已分配的配套设备的逻辑。
CompanionRunCommandTargetPreparer	在分配的配套设备上运行指定命令的`ITargetPreparer`
CompanionTestApp安装设置	一种`ITargetPreparer` ，用于将`IDeviceBuildInfo#getTestsDir()`文件夹中的一个或多个应用程序安装到分配的配套设备上。
CompileBootImageWithSpeedTargetPreparer	使用编译器过滤器“speed”重新编译启动类路径和系统服务器。
CPU节流等待者	`ITargetPreparer`等待所有内核的最大频率恢复到可用的最高级别
创建AvdPreparer
创建用户准备器	用于创建用户并在最后清理它的目标准备器。
DeviceBuildInfoBootStrapper	`ITargetPreparer` ，用从设备读取的属性替换构建信息字段这对于测试具有从外部源生成的版本的设备非常有用（例如
设备构建信息注入器	将`DeviceBuildDescriptor`元数据插入`IBuildInfo` `ITargetPreparer` 。
设备清理器	测试后执行重新启动或格式化作为清理操作，并可选择关闭屏幕
设备闪存准备器	一个`ITargetPreparer` ，可在物理 Android 硬件上闪烁图像。
DeviceImageZipFlashingTargetPreparer	目标准备器，使用通过特定格式提供的设备图像来刷新设备。
设备所有者目标准备者	用于设置设备所有者组件的`ITargetPreparer` 。
设备设置	一个`ITargetPreparer` ，根据提供的`Option`配置设备进行测试。
设备存储填充器	目标准备器填充存储空间，以便有一些可用空间。
设备字符串推送器	目标准备器将字符串写入文件。
设备更新目标准备器	一个抽象的`ITargetPreparer` ，负责使用外部源（而不是构建服务）的设备映像文件更新设备的常见步骤。
设备擦拭器	擦除用户数据的`ITargetPreparer`
禁用SELinuxTargetPreparer	目标准备器将禁用 SELinux（如果已启用）。
动态系统准备器	`ITargetPreparer` ，通过动态系统更新在设备构建之上设置系统映像。
擦除用户数据准备器	一个`ITargetPreparer` ，用于擦除设备上的用户数据。
FastbootCommandPreparer	触发 fastboot 并发送 fastboot 命令的目标准备器。
FastbootUpdateBootstrapPreparer	`ITargetPreparer`将指定文件（引导加载程序、无线电、设备映像 zip）暂存到`IDeviceBuildInfo`中，以获取使用`FastbootDeviceFlasher`刷新的设备，然后将启动后设备属性注入到构建信息中以用于结果报告目的。
功能标志目标准备器	更新 DeviceConfig（由远程服务调整的功能标志）。
可折叠模式准备器	可以切换设备可折叠状态的目标准备器。
文件夹保护程序	`ITargetPreparer`从设备中提取目录，压缩并将其保存到日志记录后端。
GkiDeviceFlashPreparer	一个目标准备器，使用 Android 通用内核通用映像刷新设备。
GsiDeviceFlashPreparer	一个目标准备器，使用 Android 通用系统映像刷新设备。
ILab准备器	实验室准备人员的标记界面有关这些接口用途的描述，请参阅`ITargetPreparer` 。
目标清理器	该接口已被弃用。 TearDown 已移至基本 ITargetPreparer 接口。
安装所有TestZipApps安装程序	一个`ITargetPreparer` ，用于安装测试 zip 中的所有应用程序。
安装ApexModuleTargetPreparer
安装Apk安装	一种`ITargetPreparer` ，用于安装位于文件系统上的一个或多个 apk。
安装BuildEnvApk设置	一种`ITargetPreparer` ，用于从 Android 平台构建环境安装一个或多个测试 apk。
仪表准备者	运行检测的`ITargetPreparer`
杀死现有的模拟器准备器	用于关闭正在运行的模拟器的`ITargetPreparer` 。
已知故障准备器	目标准备器跳过重试已知故障。
本地模拟器启动	从 Android 构建环境本地启动模拟器的 TargetPreparer。
本地模拟器快照	TargetPreparer 用于从 Android 构建/开发环境生成干净的模拟器快照
MixKernelTargetPreparer	一个`ITargetPreparer` ，允许将内核映像与设备映像混合。
模块OemTargetPreparer
NativeLeakCollector	运行“dumpsys meminfo --unreachable -a”的`ITargetPreparer`来识别每个进程当前持有的无法访问的本机内存。
没有ApkTestSkipper	如果没有要测试的 apk，特殊的准备器允许完全跳过调用（准备和测试）。
完美准备者	Perfetto 准备器将配置文件推送到设备中 perfetto 有权访问的标准位置。
配置文件目标准备器	用于为任何配置文件用户设置目标准备器的基类`android.os.usertype.profile.XXX` 。
推送文件调用器	该类已被弃用。使用`PushFilePreparer`代替
推送文件准备器	`ITargetPreparer`尝试将任意数量的文件从任何主机路径推送到任何设备路径。
PythonVirtualenvPreparer	在主机上设置 Python virtualenv 并安装软件包。
重启目标准备器	重新启动设备的目标准备器。
恢复日志准备器	用于在恢复之前收集日志的目标准备器。
删除SystemAppPreparer	`ITargetPreparer` ，用于在测试运行之前从系统分区中删除 apk。
重新启动SystemServerTargetPreparer	重新启动系统服务器而不重新启动设备的目标准备器。
根目标准备器	基于选项“force-root”执行“adb root”或“adb unroot”的目标准备器。
根管转发器准备器
运行命令目标准备器
运行主机命令目标准备器	目标准备器在运行测试之前和之后运行任意主机命令。
运行HostScriptTargetPreparer	在运行测试之前执行脚本的目标准备器。
RunOnCloneProfileTargetPreparer
RunOnSdkSandboxTargetPreparer	一个`ITargetPreparer` ，用于标记测试应在 sdk 沙箱中运行。
RunOnSecondaryUserTargetPreparer	`ITargetPreparer` ，用于在设置中创建辅助用户，并标记测试应在该用户中运行。
RunOnSystemUserTargetPreparer	一个`ITargetPreparer`标记测试应该在用户（而不是当前用户）上运行。
RunOnWorkProfileTargetPreparer	`ITargetPreparer` ，用于在设置中创建工作配置文件，并标记应在该用户中运行测试。
SemaphoreTokenTargetPreparer	这是一个准备器，用于使用令牌在 tradefed 主机中序列化测试执行。
旁载 OtaTargetPreparer	目标准备器，执行指定 OTA 包的旁加载、应用包、等待设备启动并注入设备构建属性以用作构建信息此目标准备器假定设备在启动时将处于常规 adb 模式，并将确保设备以相同模式退出，但应用了较新的版本。
停止服务设置	用于停止设备上的服务的`ITargetPreparer` 。
存根目标准备器	`ITargetPreparer`的占位符空实现。
SuiteApk安装程序	安装套件配置的指定 APK：来自 $ANDROID_TARGET_OUT_TESTCASES 变量或构建信息中的 ROOT_DIR。
切换用户目标准备器	一个`ITargetPreparer` ，用于在setUp中切换到指定的用户类型。
TearDownPassThroughPreparer	允许在作为对象包含在配置中的准备器上运行tearDown。
温度节流服务员	`ITargetPreparer`等待设备温度降至目标值
测试应用程序安装设置	一种`ITargetPreparer` ，用于将`IDeviceBuildInfo.getTestsDir()`文件夹中的一个或多个应用程序安装到设备上。
测试文件推送设置	一种`ITargetPreparer` ，将`IDeviceBuildInfo.getTestsDir()`文件夹中的一个或多个文件/目录推送到设备上。
测试系统应用程序安装设置	一种`ITargetPreparer` ，用于将`IDeviceBuildInfo.getTestsDir()`文件夹中的一个或多个应用程序安装到设备上的 /system 分区上。
浪费时间的人	一个简单的目标准备器，浪费时间并可能重新启动设备。
用户清理器	一个`ITargetPreparer` ，可在拆卸时删除辅助用户。
可见背景用户准备器	用于在后台可见启动的用户中运行测试的目标准备器。
等待设备日期时间准备器	等待在设备上设置日期时间的`ITargetPreparer` （可选）如果未在超时内设置日期时间，则此准备器可以强制`TargetSetupError` ，或者将主机日期时间强制到设备上，
Wifi准备器	如有必要，可在设备上配置 wifi 的`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` ：有关被测构建的数据。

投掷
`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` ：有关被测构建的数据。
`e`	`Throwable` ：如果调用以异常结束，则这将是在调用级别捕获的异常。否则，将为`null` 。

投掷
`DeviceNotAvailableException`	如果设备没有响应