ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

已知的间接子类 IManagedTestDevice、LocalAndroidVirtualDevice、ManagedRemoteDevice、NativeDevice、NestedRemoteDevice、RemoteAndroidDevice、RemoteAndroidVirtualDevice、TestDevice IManagedTestDevice 生命周期受管理的 ITestDevice。  LocalAndroidVirtualDevice 在 TradeFed 主机上运行的本地虚拟设备的类。  ManagedRemoteDevice 在虚拟机内运行的设备，我们通过虚拟机内的 Tradefed 实例远程管理该设备。  NativeDevice ITestDevice 非完整堆栈 Android 设备的默认实现。  NestedRemoteDevice 表示在远程 Cuttlefish 虚拟机内运行的设备。  RemoteAndroidDevice 为通过 adb connect 连接的完整堆栈 Android 设备实现 ITestDevice。  RemoteAndroidVirtualDevice 为在 Google Compute Engine (GCE) 中运行的全栈 Android 设备扩展了 RemoteAndroidDevice 行为。  TestDevice 为完整堆栈 Android 设备实现 ITestDevice

---

向 ddmlib IDevice 提供可靠且略高级别的 API。

针对可配置的次数重试设备命令，并为无响应的设备提供设备恢复接口。

摘要

嵌套类
class	ITestDevice.ApexInfo 一个简单的结构体类，用于存储有关单个 APEX 的信息
class	ITestDevice.MountPointInfo 一个简单的结构体类，用于存储有关单个装载点的信息

公共方法
abstract boolean	canSwitchToHeadlessSystemUser() 返回是否允许切换到无头 SYSTEM 用户。
abstract boolean	checkConnectivity() 检查设备是否已连接到网络。
abstract boolean	clearErrorDialogs() 尝试关闭设备界面上当前显示的所有错误对话框。
abstract void	clearLastConnectedWifiNetwork() 清除上次连接的 Wi-Fi 网络。
abstract boolean	connectToWifiNetwork( wifiSsidToPsk) 连接到 Wi-Fi 网络。
abstract boolean	connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid) 连接到 Wi-Fi 网络。
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk) 连接到 Wi-Fi 网络。
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid) 连接到 Wi-Fi 网络。
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid) connectToWifiNetwork(String, String) 的变体，仅在设备当前没有网络连接时连接。
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk) connectToWifiNetwork(String, String) 的变体，仅在设备当前没有网络连接时才进行连接。
abstract int	createUser(String name) 创建一个具有给定名称和默认标志 0 的用户。
abstract int	createUser(String name, boolean guest, boolean ephemeral) 使用指定的名称和提供的标志创建用户
abstract int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) 使用指定的名称和提供的标志创建用户
abstract int	createUserNoThrow(String name) 创建一个具有给定名称和默认标志 0 的用户。
abstract void	deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) 移除已注册的 IDeviceActionReceiver。
abstract void	disableKeyguard() 尝试停用屏幕锁定功能。
abstract boolean	disableNetworkMonitor() 在设备上停用网络监控。
abstract boolean	disconnectFromWifi() 断开 Wi-Fi 网络连接。
abstract boolean	doesFileExist(String deviceFilePath, int userId) 用于确定给定用户是否在设备上有文件的辅助方法。
abstract File	dumpHeap(String process, String devicePath) 尝试从 system_server 转储堆。
abstract boolean	enableNetworkMonitor() 在设备上启用网络监控。
abstract	getActiveApexes() 提取设备上已激活的 APEX 的相关信息。
abstract	getAllSettings(String namespace) 返回请求的命名空间的键值对。
abstract String	getAndroidId(int userId) 查找并返回与 userId 关联的 android-id，如果未找到，则返回 null。
abstract	getAndroidIds() 创建一个包含匹配用户 ID 的 Android ID 的 Map。
abstract PackageInfo	getAppPackageInfo(String packageName) 提取设备上安装的软件包的相关信息。
abstract	getAppPackageInfos() 提取设备上安装的软件包的信息。
abstract InputStreamSource	getBugreport() 从设备中检索 bug 报告。
abstract InputStreamSource	getBugreportz() 从设备检索 bugreportz。
abstract DeviceFoldableState	getCurrentFoldableState() 返回设备的当前可折叠状态；如果发生了一些问题，则返回 null。
abstract int	getCurrentUser() 返回当前运行用户的 ID。
abstract	getFoldableStates() 返回设备上的可折叠状态列表。
abstract	getInstalledPackageNames() 提取设备上存在的应用软件包名称。
abstract String	getIpAddress() 获取设备的 IP 地址。
abstract KeyguardControllerState	getKeyguardState() 返回一个对象以获取屏幕锁定功能的当前状态，如果不受支持，则返回 null。
abstract Integer	getMainUserId() 返回主要用户 ID。
abstract	getMainlineModuleInfo() 获取设备上安装的 Mainline 模块的相关信息。
abstract int	getMaxNumberOfRunningUsersSupported() 获取支持的并发运行用户数上限。
abstract int	getMaxNumberOfUsersSupported() 获取支持的用户数量上限。
abstract TestDeviceOptions	getOptions() 提取设备的测试选项。
abstract Integer	getPrimaryUserId() 返回主要用户 ID。
abstract InputStreamSource	getScreenshot(String format, boolean rescale) 从设备截取屏幕截图。
abstract InputStreamSource	getScreenshot(long displayId) 从指定显示屏 ID 的设备抓取屏幕截图。
abstract InputStreamSource	getScreenshot(String format) 从设备截取屏幕截图。
abstract InputStreamSource	getScreenshot() 从设备截取屏幕截图。
abstract String	getSetting(int userId, String namespace, String key) 返回请求的设置的值。
abstract String	getSetting(String namespace, String key) 请参阅 getSetting(int, String, String)，并在系统用户上执行。
abstract	getUninstallablePackageNames() 提取可卸载的应用软件包名称。
abstract int	getUserFlags(int userId) 查找并返回指定用户的标记。
abstract	getUserInfos() 获取设备上的 useId 到 UserInfo 的映射。
abstract int	getUserSerialNumber(int userId) 返回与 userId 关联的序列号（如果有），在任何其他情况下均返回 -10000。
abstract boolean	hasFeature(String feature) 检查设备是否支持某项功能。
abstract String	installPackage(File packageFile, boolean reinstall, String... extraArgs) 在设备上安装 Android 软件包。
abstract String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) 在设备上安装 Android 软件包。
abstract String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) 在设备上为指定用户安装 Android 软件包。
abstract String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) 在设备上为指定用户安装 Android 软件包。
default String	installPackages( packageFiles, boolean reinstall, String... extraArgs) 安装由多个 APK 文件（一个主要软件包和额外的拆分软件包）组成的 Android 应用。
default String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) 安装由位于 Android 设备上的多个 APK 文件（一个主软件包和额外的拆分软件包）组成的 Android 应用。
default String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs) 为指定用户安装由多个 APK 文件（一个主软件包和额外的拆分软件包）组成的 Android 应用。
default String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) 为指定用户安装由多个 APK 文件（一个主软件包和额外的拆分软件包）组成的 Android 应用。
default String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs) 安装一个 Android 应用，该应用由位于 Android 设备上的多个 APK 文件（一个主要软件包和额外的拆分软件包）组成。
default String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) 安装一个 Android 应用，该应用由位于 Android 设备上的多个 APK 文件（一个主要软件包和额外的拆分软件包）组成。
abstract boolean	isHeadlessSystemUserMode() 返回设备是否使用无头系统用户模式。
abstract boolean	isMainUserPermanentAdmin() 返回主用户是否为永久性管理员，并且无法删除或降级为非管理员状态。
abstract boolean	isMultiUserSupported() 确定是否支持多用户。
abstract boolean	isPackageInstalled(String packageName, String userId) 查询设备中是否存在给定的软件包名称和给定的用户 ID，以检查该软件包当前是否已为该用户安装。
abstract boolean	isPackageInstalled(String packageName) 查询设备以获取给定的软件包名称，检查设备当前是否已安装。
abstract boolean	isUserRunning(int userId) 检查指定用户是否正在运行。
abstract boolean	isUserSecondary(int userId) 根据指定用户的标志返回该用户是否为次要用户。
abstract boolean	isUserVisible(int userId) 检查指定用户是否可见。
abstract boolean	isUserVisibleOnDisplay(int userId, int displayId) 检查指定用户是否在指定显示屏中显示。
abstract boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() 返回设备是否允许用户在 ERROR(/java.android.view.Display#DEFAULT_DISPLAY) 中以后台进程的形式启动。
abstract boolean	isVisibleBackgroundUsersSupported() 返回设备是否允许用户在后台启动时保持可见状态。
abstract boolean	isWifiEnabled() 测试 Wi-Fi 是否已启用。
abstract	listDisplayIds() 收集“dumpsys SurfaceFlinger”报告的设备上可用显示屏 ID 的列表。
abstract	listDisplayIdsForStartingVisibleBackgroundUsers() 获取可用于 start a user visible in the background 的屏幕的列表。
abstract	listUsers() 获取设备上的用户列表。
abstract boolean	logBugreport(String dataName, ITestLogger listener) 用于获取 bugreport 并将其记录到报告程序的辅助方法。
default void	notifySnapuserd(SnapuserdWaitPhase waitPhase) 通知设备等待 snapuserd 完成。
abstract void	registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) 为此设备注册 IDeviceActionReceiver。
abstract boolean	removeAdmin(String componentName, int userId) 移除给定用户中的给定设备管理员，如果成功，则返回 true；否则，返回 false。
abstract void	removeOwners() 尽最大努力移除所有现有的设备个人资料所有者。
abstract boolean	removeUser(int userId) 从设备中移除指定用户。
abstract boolean	setDeviceOwner(String componentName, int userId) 将设备管理组件设为给定用户的设备所有者。
abstract void	setSetting(String namespace, String key, String value) 请参阅 setSetting(int, String, String, String) 并在系统用户上执行。
abstract void	setSetting(int userId, String namespace, String key, String value) 向给定用户的命名空间添加设置值。
abstract boolean	startUser(int userId) 如果给定用户当前处于停止状态，则在后台启动该用户。
abstract boolean	startUser(int userId, boolean waitFlag) 如果给定用户当前处于停止状态，则在后台启动该用户。
abstract boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) 在后台启动给定用户，在给定显示屏中显示（即允许用户在该显示屏中启动 activity）。
abstract boolean	stopUser(int userId) 停止给定用户。
abstract boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) 停止给定用户。
abstract boolean	switchUser(int userId) 切换到具有默认超时的另一个 userId。
abstract boolean	switchUser(int userId, long timeout) 将其他 userId 作为截止期限切换到提供的超时。
abstract Bugreport	takeBugreport() 获取 bugreport 并将其返回到 Bugreport 对象中进行处理。
abstract String	uninstallPackage(String packageName) 从设备中卸载 Android 软件包。
abstract String	uninstallPackageForUser(String packageName, int userId) 从设备中卸载给定用户的 Android 软件包。
default void	waitForSnapuserd(SnapuserdWaitPhase currentPhase) 如果预期，请等待 snapuserd 完成。

公共方法

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

返回是否允许切换到无头 SYSTEM 用户。

返回
boolean

抛出
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

检查设备是否已连接到网络。

返回
boolean	如果设备的网络连接正常，则为 true；否则为 false。

抛出
DeviceNotAvailableException	如果与设备的连接已断开且无法恢复。

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

尝试关闭设备界面上当前显示的所有错误对话框。

返回
boolean	如果没有对话框或对话框已成功清除，则为 true。 否则为 false。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

清除上次连接的 Wi-Fi 网络。应在启动新的调用时调用此方法，以避免在设备重启后连接到上次测试中使用的 Wi-Fi 网络。

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

连接到 Wi-Fi 网络。

开启 Wi-Fi 并屏蔽，直到与 wifiSsidToPsk 映射中指定的某个 Wi-Fi 网络成功建立连接。建立连接后，实例将在每次重新启动后尝试恢复连接，直到调用 ITestDevice#disconnectFromWifi() 或 ITestDevice#clearLastConnectedWifiNetwork()。

参数
wifiSsidToPsk	：Wi-Fi SSID 与密码的映射。

返回
boolean	true（如果已成功连接到 Wi-Fi 网络）。false 否则

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

连接到 Wi-Fi 网络。

开启 Wi-Fi 并阻止，直到与 wifiSsidToPsk 映射中提供的其中一个 Wi-Fi 网络成功建立连接。建立连接后，实例会在每次重新启动后尝试恢复连接，直到调用 ITestDevice#disconnectFromWifi() 或 ITestDevice#clearLastConnectedWifiNetwork()。

参数
wifiSsidToPsk	：Wi-Fi SSID 与密码的映射。
scanSsid	boolean：是否扫描此网络的隐藏 SSID。

返回
boolean	true（如果已成功连接到 Wi-Fi 网络）。false 否则

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

连接到 Wifi 网络

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

连接到 Wi-Fi 网络。

开启 Wi-Fi 并屏蔽，直到成功连接到指定的 Wi-Fi 网络。 建立连接后，实例会在每次重新启动后尝试恢复连接，直到调用 ITestDevice#disconnectFromWifi() 或 ITestDevice#clearLastConnectedWifiNetwork()。

参数
wifiSsid	String：要连接到的 Wi-Fi SSID
wifiPsk	String：PSK 密码；如果未加密，则为 null

返回
boolean	如果成功连接到 Wi-Fi 网络，则为 true。false otherwise

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

连接到 Wi-Fi 网络。

开启 Wi-Fi 并阻止，直到成功连接到指定的 Wi-Fi 网络。 建立连接后，实例将在每次重新启动后尝试恢复连接，直到调用 ITestDevice#disconnectFromWifi() 或 ITestDevice#clearLastConnectedWifiNetwork() 为止。

参数
wifiSsid	String：要连接到的 Wi-Fi SSID
wifiPsk	String：PSK 密码（如果未加密，则为 null）
scanSsid	boolean：是否扫描此网络的隐藏 SSID。

返回
boolean	如果成功连接到 Wi-Fi 网络，则为 true。false otherwise

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

connectToWifiNetwork(String, String) 的变体，仅在设备当前没有网络连接时连接。

参数
scanSsid	boolean：是否扫描此网络的隐藏 SSID

返回
boolean	如果成功连接到 Wi-Fi 网络，则为 true。false otherwise

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

connectToWifiNetwork(String, String) 的变体，仅在设备当前没有网络连接时连接。

返回
boolean	如果成功连接到 Wi-Fi 网络，则为 true。false otherwise

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

创建一个具有给定名称和默认标志 0 的用户。

参数
name	String：要在设备上创建的用户

返回
int	创建的用户 ID 的整数

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

使用指定的名称和提供的标志创建用户

参数
name	String：要在设备上创建的用户
guest	boolean：在创建期间启用用户标志 --guest
ephemeral	boolean：在创建期间启用用户标志 --Temporary

返回
int	所创建用户的 ID

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

使用指定的名称和提供的标志创建用户

参数
name	String：要在设备上创建的用户
guest	boolean：在创建期间启用用户标志 --guest
ephemeral	boolean：在创建时启用用户标志 --ephemeral
forTesting	boolean：在创建期间启用测试标志 --for-testing

返回
int	所创建用户的 ID

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

使用给定名称和默认标志 0 创建用户。

参数
name	String：要在设备上创建的用户

返回
int	创建的用户 ID 对应的整数，如果出错，则为 -1。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

移除已注册的 IDeviceActionReceiver。

参数
deviceActionReceiver	IDeviceActionReceiver：要移除的 IDeviceActionReceiver。

停用键盘锁

public abstract void disableKeyguard ()

尝试停用屏幕锁定功能。

首先等待输入调度准备就绪，这大约与设备报告 BOOT_COMPLETE 的时间同时发生，显然是异步的，因为当前框架实现偶尔会出现竞态条件。然后发送命令以关闭键盘锁（仅适用于非安全键盘）

抛出
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

在设备上停用网络监控功能。

返回
boolean	如果已成功停用监控功能，则为 true。如果失败，则为 false。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

断开 Wi-Fi 网络连接。

从已知网络列表中移除所有网络并停用 Wi-Fi。

返回
boolean	true（如果成功断开与 Wi-Fi 网络的连接）。如果断开连接失败，则为 false。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

用于确定给定用户是否在设备上拥有文件的辅助方法。

参数
deviceFilePath	String：要检查的设备端文件的绝对路径
userId	int：用于检查文件是否存在的用户 ID

返回
boolean	如果文件存在，则为 true；否则为 false。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

尝试从 system_server 转储堆。调用方负责清理转储的文件。

参数
process	String：要转储堆的设备进程的名称。
devicePath	String：设备上用于放置转储文件的路径。这必须是权限允许的位置。

返回
File	包含报告的 ERROR(/File)。如果失败，则为 null。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

在设备上启用网络监控。

返回
boolean	如果监控成功启用，则为 true。如果失败，则为 false。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

getActiveApexes

public abstract  getActiveApexes ()

提取设备上已激活的 APEX 的相关信息。

返回
	目前在设备上激活的 ApexInfo 中，ERROR(/Set) 个

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

返回所请求命名空间的键值对。

参数
namespace	String：必须是 {"system", "secure", "global"} 之一

返回
	键值对的映射。如果不支持命名空间，则为 null。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

查找并返回与 userId 关联的 android-id；如果未找到，则返回 null。

参数
userId	int

返回
String

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

针对找到的 Android ID 创建与用户 ID 匹配的映射。无法保证每个用户 ID 都能找到此函数中关联的 Android ID，因此某些用户 ID 可能会与 null 匹配。

返回
	找到的与用户 ID 匹配的 Android ID 的映射。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

提取设备上安装的软件包的相关信息。

参数
packageName	String

返回
PackageInfo	PackageInfo 或 null（如果无法检索到信息）

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

提取设备上安装的软件包的信息。

返回
	设备上安装的 PackageInfo 的 ERROR(/List)。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

从设备中检索 bug 报告。

此实现保证可在没有 SD 卡（或尚未装载 SD 卡）的设备上继续正常运行。

返回
InputStreamSource	一个 InputStreamSource，用于按需生成 bugreport 内容。如果失败了，InputStreamSource 将生成一个空的 ERROR(/InputStream)。

getBugreportz

public abstract InputStreamSource getBugreportz ()

从设备检索 bugreportz。Zip 格式的 bugreport 包含主要 bugreport 和其他对调试有用的日志文件。

仅适用于“adb 版本”高于 1.0.36 的设备

返回
InputStreamSource	包含 bugreportz 的 ZIP 文件的 InputStreamSource，失败时返回 null。

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

返回设备当前的可折叠状态；如果发生某些问题，则返回 null。

返回
DeviceFoldableState

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

获取当前用户

public abstract int getCurrentUser ()

返回当前运行用户的 ID。如果发生错误，则返回 -10000。

返回
int

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

返回设备上的可折叠状态列表。可以使用“cmd device_state print-states”获取。

返回

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstallPackageNames

public abstract  getInstalledPackageNames ()

提取设备上存在的应用软件包名称。

返回
	设备上当前安装的 String 软件包名称的 ERROR(/Set)。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

获取设备的 IP 地址。

返回
String	设备的 IP 地址，如果设备没有 IP 地址，则为 null

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

返回一个对象以获取屏幕锁定功能的当前状态，如果不受支持，则返回 null。

返回
KeyguardControllerState	一个 KeyguardControllerState，其中包含屏幕保护程序状态的快照；如果不支持屏幕保护程序查询，则返回 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

getMainUserId

public abstract Integer getMainUserId ()

返回主要用户 ID。

返回
Integer	主要用户的 userId（如果有）；如果没有主要用户，则返回 null。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	如果设备的输出不符合预期。
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

获取设备上安装的主线模块的相关信息。

返回
	设备上当前安装的 String Mainline 模块的 ERROR(/Set)。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

获取支持的并发运行用户数上限。默认设置为 0。

返回
int	一个整数，表示同时运行的用户数

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

支持的最大用户数

public abstract int getMaxNumberOfUsersSupported ()

获取支持的用户数上限。默认设置为 0。

返回
int	一个整数，表示支持的用户数

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

获取设备的测试选项。

返回
TestDeviceOptions	与被测设备相关的 TestDeviceOptions。

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

返回主要用户 ID。

返回
Integer	主要用户的 userId（如果有）；如果没有主要用户，则返回 null。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	如果设备的输出不符合预期。
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

从设备上抓取屏幕截图。建议改用 getScreenshot(String) 并采用 JPEG 编码，以缩减大小。

参数
format	String：支持 PNG、JPEG
rescale	boolean：确定是否应重新缩放屏幕截图以减小生成图片的大小

返回
InputStreamSource	屏幕截图的 InputStreamSource（采用 .jpg 格式），如果屏幕截图未成功，则为 null。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

获取屏幕截图

public abstract InputStreamSource getScreenshot (long displayId)

从指定显示屏 ID 的设备获取屏幕截图。格式为 PNG。

TODO：扩展上述实现以支持“format”和“rescale”

参数
displayId	long：要获取屏幕截图的屏幕的显示 ID。

返回
InputStreamSource	屏幕截图的 InputStreamSource（采用 .jpg 格式），如果屏幕截图未成功，则为 null。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

从设备截取屏幕截图。 建议改用 getScreenshot(format) 并采用 JPEG 编码，以缩减文件大小

参数
format	String：支持 PNG、JPEG

返回
InputStreamSource	屏幕截图的 InputStreamSource（采用 .jpg 格式），如果屏幕截图未成功，则为 null。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

从设备截取屏幕截图。

返回
InputStreamSource	屏幕截图的 InputStreamSource（采用 png 格式），如果屏幕截图未成功，则为 null。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (int userId, 
                String namespace, 
                String key)

返回请求的设置的值。 命名空间必须为以下各项之一：{"system", "secure", "global"}

参数
userId	int
namespace	String
key	String

返回
String	与用户的命名空间：键关联的值。如果未找到，则为 null。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

请参阅 getSetting(int, String, String)，并在系统用户上执行。

参数
namespace	String
key	String

返回
String

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

提取可卸载的应用软件包名称。目前，这定义为非系统软件包和更新后的系统软件包。

返回
	设备上当前安装的不可卸载的 String 软件包名称的 ERROR(/Set)。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

查找并返回指定用户的标志。 标志在 Android 开源项目的“android.content.pm.UserInfo”类中定义。

参数
userId	int

返回
int	与所提供的 userId 相关联的标志（如果有），在任何其他情况下均为 -10000。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

获取设备上 useId 与 UserInfo 的映射。如果设备的输出不符合预期，则会抛出 DeviceRuntimeException。

返回
	UserInfo 对象列表。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

返回与 userId 关联的序列号（如果有），在任何其他情况下均返回 -10000。

参数
userId	int

返回
int

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

检查设备是否支持某项功能。

参数
feature	String：格式应为“feature:”或直接为“”。

返回
boolean	如果找到地图项，则返回 true；否则，返回 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

在设备上安装 Android 软件包。

参数
packageFile	File：要安装的 APK 文件
reinstall	boolean：true（如果应执行重新安装）
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接已断开且无法恢复。

installPackage

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

在设备上安装 Android 软件包。

注意：只有需要在安装时明确控制授予运行时权限的用例才应调用此函数。

参数
packageFile	File：要安装的 APK 文件
reinstall	boolean：true（如果应执行重新安装）
grantPermissions	boolean：如果应在安装时授予所有运行时权限
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。
UnsupportedOperationException	如果设备上的平台不支持运行时权限。

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

在设备上为指定用户安装 Android 软件包。

参数
packageFile	File：要安装的 APK 文件
reinstall	boolean：true（如果应执行重新安装）
userId	int：要安装的整数用户 ID。
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

在设备上为指定用户安装 Android 软件包。

注意：只有需要在安装时明确控制授予运行时权限的用例才应调用此函数。

参数
packageFile	File：要安装的 APK 文件
reinstall	boolean：true（如果应执行重新安装）
grantPermissions	boolean：是否应在安装时授予所有运行时权限
userId	int：要为其安装的整数用户 ID。
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功，则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。
UnsupportedOperationException	如果设备上的平台不支持运行时权限。

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

安装由多个 APK 文件（一个主软件包和额外的拆分软件包）组成的 Android 应用。 如需了解如何将 APK 拆分为多个文件，请参阅“https://developer.android.com/studio/build/configure-apk-splits”。

参数
packageFiles	：本地 apk 文件
reinstall	boolean：true（如果应执行重新安装）
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。
UnsupportedOperationException	如果设备上的平台不支持运行时权限。

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

安装由位于 Android 设备上的多个 APK 文件（一个主软件包和额外的拆分软件包）组成的 Android 应用。如需了解如何将 APK 拆分为多个文件，请参阅“https://developer.android.com/studio/build/configure-apk-splits”。

注意：只有需要在安装时明确控制授予运行时权限的用例才应调用此函数。

参数
packageFiles	：要安装的远程 APK 文件路径
reinstall	boolean：如果应执行重新安装，则为 true
grantPermissions	boolean：如果应在安装时授予所有运行时权限
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。
UnsupportedOperationException	如果设备上的平台不支持运行时权限。

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

为指定用户安装由多个 APK 文件（一个主软件包和额外的拆分软件包）组成的 Android 应用。如需了解如何将 APK 拆分为多个文件，请参阅“https://developer.android.com/studio/build/configure-apk-splits”。

参数
packageFiles	：本地 apk 文件
reinstall	boolean：true（如果应执行重新安装）
userId	int：要安装的整数用户 ID。
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功，则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。
UnsupportedOperationException	如果设备上的平台不支持运行时权限。

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

为指定用户安装由多个 APK 文件（一个主软件包和额外的拆分软件包）组成的 Android 应用。如需了解如何将 APK 拆分为多个文件，请参阅“https://developer.android.com/studio/build/configure-apk-splits”。

注意：只有需要在安装时明确控制授予运行时权限的用例才应调用此函数。

参数
packageFiles	：本地 apk 文件
reinstall	boolean：true（如果应执行重新安装）
grantPermissions	boolean：是否应在安装时授予所有运行时权限
userId	int：要为其安装的整数用户 ID。
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功，则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。
UnsupportedOperationException	如果设备上的平台不支持运行时权限。

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

安装由 Android 设备上多个 APK 文件（一个主要软件包和额外的拆分软件包）组成的 Android 应用。如需了解如何将 APK 拆分为多个文件，请参阅“https://developer.android.com/studio/build/configure-apk-splits”。

参数
remoteApkPaths	：远程 APK 文件路径
reinstall	boolean：true（如果应执行重新安装）
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。
UnsupportedOperationException	如果设备上的平台不支持运行时权限。

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

安装由 Android 设备上多个 APK 文件（一个主要软件包和额外的拆分软件包）组成的 Android 应用。如需了解如何将 APK 拆分为多个文件，请参阅“https://developer.android.com/studio/build/configure-apk-splits”。

注意：只有需要在安装时明确控制授予运行时权限的用例才应调用此函数。

参数
remoteApkPaths	：远程 APK 文件路径
reinstall	boolean：true（如果应执行重新安装）
grantPermissions	boolean：如果应在安装时授予所有运行时权限
extraArgs	String：可选的额外参数。如需了解可用选项，请参阅“adb shell pm -h”。

返回
String	包含错误代码的 String，如果成功则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接断开且无法恢复。
UnsupportedOperationException	如果设备上的平台不支持运行时权限，则会发生此错误。

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

返回设备是否使用无头系统用户模式。

返回
boolean

抛出
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

返回主用户是否为永久性管理员，并且无法删除或降级为非管理员状态。

返回
boolean

抛出
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

确定是否支持多用户。

返回
boolean	如果支持多用户，则为 true，否则为 false

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

针对给定的软件包名称和给定的用户 ID 查询设备，以检查该软件包当前是否已为该用户安装。

参数
packageName	String：我们要检查是否已安装的软件包。
userId	String：我们正在检查软件包的安装情况的用户 ID。如果为 null，则使用主要用户的零。

返回
boolean	如果软件包被报告为已安装，则为 true。否则为 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

查询设备以获取给定的软件包名称，检查设备当前是否已安装。

参数
packageName	String

返回
boolean	如果软件包被报告为已安装，则为 true。否则为 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

检查指定用户是否正在运行。

参数
userId	int

返回
boolean	如果用户正在运行，则为 true；在所有其他情况下，则为 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

根据其标记返回指定用户是否为次要用户。

参数
userId	int

返回
boolean	如果用户是辅助用户，则为 true；否则为 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible（用户可见）

public abstract boolean isUserVisible (int userId)

检查指定用户是否可见。

“可见”用户是指与“真人”用户互动，因此能够启动启动 activity（通常在默认显示屏中）的用户。

参数
userId	int

返回
boolean

抛出
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

检查指定用户是否在指定显示屏中显示。

“可见”用户是指与“真人”用户互动，因此能够在该显示屏中启动 activity 的用户。

参数
userId	int
displayId	int

返回
boolean

抛出
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

返回设备是否允许用户在 ERROR(/java.android.view.Display#DEFAULT_DISPLAY) 中在后台启动。

如果是，您可以调用 startVisibleBackgroundUser(int, int, boolean)，并传递 listDisplayIdsForStartingVisibleBackgroundUsers() 返回的显示屏（应包含 ERROR(/java.android.view.Display#DEFAULT_DISPLAY)）。

返回
boolean

抛出
DeviceNotAvailableException

isVisibleBackgroundUsersSupported 支持

public abstract boolean isVisibleBackgroundUsersSupported ()

返回设备是否允许用户在后台启动时保持可见状态。

如果是，您可以调用 startVisibleBackgroundUser(int, int, boolean)，并传递 listDisplayIdsForStartingVisibleBackgroundUsers() 返回的显示屏。

返回
boolean

抛出
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

测试 Wi-Fi 是否已启用。

检查设备上是否已启用 Wi-Fi。在不应使用 Wi-Fi 运行的测试（例如移动流量测试）之前断言 Wi-Fi 状态时非常有用。

返回
boolean	如果 Wi-Fi 已启用，则为 true。false（如果已停用）

抛出
DeviceNotAvailableException	如果与设备的连接已断开且无法恢复。

listDisplayIds

public abstract  listDisplayIds ()

收集设备上由“dumpsys SurfaceFlinger”报告的可用屏幕 ID 的列表。

返回
	显示设备的列表。默认值始终返回默认显示 0。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

获取可用于 start a user visible in the background 的显示屏列表。

返回

抛出
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

获取设备上的用户列表。如果设备的输出不符合预期，则会抛出 DeviceRuntimeException。

返回
	用户 ID 的列表。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

用于获取 bugreport 并将其记录到报告程序的辅助方法。

参数
dataName	String：用于报告 bug 报告的名称。
listener	ITestLogger：用于记录 bugreport 的 ITestLogger。

返回
boolean	如果日志记录成功，则为 true，否则为 false。

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

通知设备等待 snapuserd 完成。

参数
waitPhase	SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

为此设备注册 IDeviceActionReceiver。

在设备操作开始前和结束后，系统都会通知所有已注册的 IDeviceActionReceiver。

参数
deviceActionReceiver	IDeviceActionReceiver：将注册的 IDeviceActionReceiver。

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

移除指定用户中的指定设备管理员，如果成功，则返回 true；否则，返回 false。

参数
componentName	String：要移除的设备管理员的 ID。
userId	int：设备管理员所在用户的用户。

返回
boolean	如果成功则为 true，否则为 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

尽最大努力移除所有现有的设备个人资料所有者。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

移除用户

public abstract boolean removeUser (int userId)

从设备中移除指定用户。

参数
userId	int：要移除的用户

返回
boolean	如果成功移除了用户，则为 true，否则为 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

在指定用户中将设备管理组件设为设备所有者。

参数
componentName	String：将设备管理员设为设备所有者。
userId	int：设备所有者的居住地。

返回
boolean	如果成功则为 true，否则为 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

public abstract void setSetting (String namespace, 
                String key, 
                String value)

请参阅 setSetting(int, String, String, String)，并在系统用户上执行。

参数
namespace	String
key	String
value	String

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

public abstract void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

将设置值添加到指定用户的命名空间。某些设置只有在重新启动后才可用。 命名空间必须为以下各项之一：{"system", "secure", "global"}

参数
userId	int
namespace	String
key	String
value	String

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

如果给定用户当前处于停止状态，则在后台启动该用户。如果用户已在后台运行，此方法将执行无操作。

参数
userId	int：要后台启动的用户

返回
boolean	如果用户已成功在后台启动，则为 true。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

在后台启动指定用户（如果当前已停止）。如果用户已在后台运行，此方法将执行无操作。可以提供额外的标记以等待操作生效。

参数
userId	int：要后台启动的用户
waitFlag	boolean：会让命令等待用户启动并解锁。

返回
boolean	如果用户已成功在后台启动，则为 true。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

public abstract boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

在后台启动给定用户，并在给定显示屏中显示（即允许用户在该显示屏中启动 activity）。

注意 ：此命令不会检查用户是否存在、显示可用、device supports such feature 等。

参数
userId	int：要在后台启动的用户
displayId	int：用于启动用户可见的显示屏
waitFlag	boolean：会使该命令等待用户启动并解锁。

返回
boolean	true，如果用户已成功启动并在后台显示。

抛出
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

停止给定用户。如果用户已停止，此方法将执行无操作。 无法停止当前用户和系统用户。

参数
userId	int：要停止的用户。

返回
boolean	如果成功停止用户，则为 true。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

停止给定用户。可以提供额外的标志来等待操作生效，并强制终止用户。无法停止当前用户和系统用户。

参数
userId	int：要停止的用户。
waitFlag	boolean：会让命令等待用户停止。
forceFlag	boolean：会强行停止用户。

返回
boolean	如果成功停止用户，则为 true。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

切换用户

public abstract boolean switchUser (int userId)

切换到另一个 userId（默认超时）。switchUser(int, long)。

参数
userId	int

返回
boolean	如果新的 userId 与 userId 提供方匹配，则返回 true。否则为 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

切换到其他 userId，并将所提供的超时时间作为截止期限。 在用户更改成功后尝试停用屏幕锁定。

参数
userId	int
timeout	long：在切换用户失败后，等待一段时间再返回 false。

返回
boolean	如果新的 userId 与 userId 提供方匹配，则返回 true。否则为 false。

抛出
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

获取 bugreport 并将其返回到 Bugreport 对象中进行处理。如果出现问题，则返回 null。需要通过 Bugreport.close() 清理 Bugreport 对象中引用的文件。

返回
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

从设备中卸载 Android 软件包。

参数
packageName	String：要卸载的 Android 软件包

返回
String	包含错误代码的 String，如果成功则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接已断开且无法恢复。

downloadPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

从设备上为指定用户卸载 Android 软件包。

参数
packageName	String：要卸载的 Android 软件包
userId	int：要为其卸载的整数用户 ID。

返回
String	包含错误代码的 String，如果成功则为 null。

抛出
DeviceNotAvailableException	如果与设备的连接已断开且无法恢复。

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

如果预期，请等待 snapuserd 完成。

参数
currentPhase	SnapuserdWaitPhase

抛出
DeviceNotAvailableException