测试设备

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

可用于关闭键盘锁的命令。

测试设备

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

清除错误对话框

public boolean clearErrorDialogs ()

尝试关闭当前显示在设备 UI 上的任何错误对话框。

创建用户

public int createUser (String name)

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

创建用户

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

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

createUserNoThrow

public int createUserNoThrow (String name)

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

禁用键盘锁

public void disableKeyguard ()

尝试禁用键盘锁。

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

文件是否存在

public boolean doesFileExist (String deviceFilePath)

确定设备上的文件是否存在的辅助方法。

文件是否存在

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

转储堆

public File dumpHeap (String process, 
                String devicePath)

尝试从 system_server 转储堆。清理转储文件是调用者的责任。

获取活动顶点

public  getActiveApexes ()

获取有关设备上激活的 APEX 的信息。

获取所有设置

public  getAllSettings (String namespace)

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

获取AndroidId

public String getAndroidId (int userId)

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

获取AndroidIds

public  getAndroidIds ()

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

获取应用程序包信息

public PackageInfo getAppPackageInfo (String packageName)

获取有关安装在设备上的包的信息。

获取应用程序包信息

public  getAppPackageInfos ()

获取设备上安装的包的信息。

获取当前可折叠状态

public DeviceFoldableState getCurrentFoldableState ()

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

获取当前用户

public int getCurrentUser ()

返回当前运行用户的 id。如果出错，返回 -10000。

获取可折叠状态

public  getFoldableStates ()

返回设备上的可折叠状态列表。可以通过“cmd device_state print-states”获得。

getInstalledPackageNames

public  getInstalledPackageNames ()

获取设备上存在的应用程序包名称。

获取键盘锁状态

public KeyguardControllerState getKeyguardState ()

返回一个对象以获取键盘锁的当前状态，如果不支持则返回 null。

获取主线模块信息

public  getMainlineModuleInfo ()

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

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

获取支持的同时运行用户的最大数量。默认为 0。

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

获取支持的最大用户数。默认为 0。

getMicrodroid进程

public Process getMicrodroidProcess ()

获取PrimaryUserId

public Integer getPrimaryUserId ()

返回主用户 ID。

截屏

public InputStreamSource getScreenshot ()

从设备抓取屏幕截图。

截屏

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

从设备抓取屏幕截图。建议使用getScreenshot(String)而不是 JPEG 编码以获得更小的尺寸。

截屏

public InputStreamSource getScreenshot (String format)

从设备抓取屏幕截图。建议使用 getScreenshot(format) 而不是 JPEG 编码以获得更小的尺寸

截屏

public InputStreamSource getScreenshot (long displayId)

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

TODO：扩展上面的实现以支持'format'和'rescale'

获取设置

public String getSetting (String namespace, 
                String key)

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

获取设置

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

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

getUninstallablePackageNames

public  getUninstallablePackageNames ()

获取可卸载的应用程序包名称。这目前被定义为非系统包和更新的系统包。

获取用户标志

public int getUserFlags (int userId)

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

获取用户信息

public  getUserInfos ()

获取设备上useId到UserInfo的Map。如果设备的输出不符合预期，将抛出DeviceRuntimeException 。

获取用户序列号

public int getUserSerialNumber (int userId)

如果找到，则返回与 userId 关联的序列号，在任何其他情况下返回 -10000。

有特征

public boolean hasFeature (String feature)

检查某项功能是否在设备上可用。

安装包

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

在设备上安装 Android 包。

安装包

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

在设备上安装 Android 包。

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

安装包

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

在设备上安装 Android 包。

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

installPackageForUser

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

为给定用户在设备上安装 Android 包。

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

installPackageForUser

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

为给定用户在设备上安装 Android 包。

安装包

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

安装包

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

installPackagesForUser

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

installPackagesForUser

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

安装远程包

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

安装远程包

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

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

检查设备上的平台是否支持应用枚举

isMultiUserSupported

public boolean isMultiUserSupported ()

确定是否支持多用户。

isPackageInstalled

public boolean isPackageInstalled (String packageName)

在设备上查询给定的包名称以检查它当前是否已安装。

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

查询设备以获取给定的包名称和给定的用户 ID，以检查当前是否为该用户安装了它。

isUserRunning

public boolean isUserRunning (int userId)

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

isUserSecondary

public boolean isUserSecondary (int userId)

根据其标志返回指定用户是否为二级用户。

listDisplayIds

public  listDisplayIds ()

收集“dumpsys SurfaceFlinger”报告的设备上可用显示 ID 的列表。

列出用户

public  listUsers ()

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

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

特定于设备的额外步骤需要清理，将在调用完成后执行。

删除管理员

public boolean removeAdmin (String componentName, 
                int userId)

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

删除所有者

public void removeOwners ()

尽最大努力删除所有现有的设备配置文件所有者。

删除用户

public boolean removeUser (int userId)

从设备中删除给定的用户。

设置设备所有者

public boolean setDeviceOwner (String componentName, 
                int userId)

将设备管理组件设置为给定用户的设备所有者。

设定设定

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

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

设定设定

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

将设置值添加到给定用户的命名空间。某些设置仅在重新启动后可用。命名空间必须是以下之一：{"system", "secure", "global"}

关机微软

public void shutdownMicrodroid (ITestDevice microdroidDevice)

关闭微型机器人设备（如果存在）。

启动用户

public boolean startUser (int userId)

如果当前已停止，则在后台启动给定用户。如果用户已经在后台运行，则此方法是 NOOP。

启动用户

public boolean startUser (int userId, 
                boolean waitFlag)

如果当前已停止，则在后台启动给定用户。如果用户已经在后台运行，则此方法是 NOOP。可以提供额外的标志以等待操作生效。

停止用户

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

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

停止用户

public boolean stopUser (int userId)

停止给定的用户。如果用户已经停止，则此方法是 NOOP。无法停止当前和系统用户。

支持Microdroid

public boolean supportsMicrodroid ()

检查运行微型机器人的先决条件。

支持Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

检查运行微型机器人的先决条件。

切换用户

public boolean switchUser (int userId)

切换到另一个具有默认超时的 userId。 switchUser(int, long) 。

切换用户

public boolean switchUser (int userId, 
                long timeout)

以提供的超时为截止日期切换到另一个 userId。用户更改成功后尝试禁用键盘锁。

卸载包

public String uninstallPackage (String packageName)

从设备卸载 Android 包。

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

从给定用户的设备中卸载 Android 包。

创建解析器

protected AaptParser createParser (File appFile)

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

执行 adb 重启。

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

暴露测试。

获取主机当前时间

protected long getHostCurrentTime ()

暴露测试

启动后设置

protected void prePostBootSetup ()

允许每种设备类型（AndroidNativeDevice、TestDevice）为特定的启动后设置覆盖此方法。