Google 致力于为黑人社区推动种族平等。查看具体举措

设备管理器

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


用于管理用于测试的可用设备集的界面。

概括

嵌套类

interface IDeviceManager.IFastbootListener

fastboot 状态更改的侦听器。

公共方法

abstract void addDeviceMonitor ( IDeviceMonitor mon)

添加一个IDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

通知管理器某个侦听器对 fastboot 状态更改感兴趣。

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

将设备添加到 fastboot 监视器。

abstract ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

申请符合特定标准的设备进行测试。

abstract ITestDevice allocateDevice ( IDeviceSelection options)

申请符合特定标准的设备进行测试。

abstract ITestDevice allocateDevice ()

请求物理设备进行测试

abstract ITestDevice connectToTcpDevice (String ipAndPort)

使用 adb-over-tcp 连接到设备

这个方法分配一个新的设备,其最终应通过被释放disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

返回ITestDevice会上网,但可能不会响应。

abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

断开与 adb-over-tcp 连接的设备的连接。

abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)

输出已知的装置,它们的状态,和用于共同使用的值的用户友好的含说明列表IDeviceSelection选项。

abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)

在可用设备上执行 shell 命令的辅助方法。

abstract ITestDevice forceAllocateDevice (String serial)

粗鲁地分配设备,即使它当前不可用。

abstract void freeDevice (ITestDevice device, FreeDeviceState state)

将设备返回到池中

尝试返回先前未分配的设备将被忽略。

abstract String getAdbPath ()

返回要使用的 adb 二进制文件的路径。

abstract String getAdbVersion ()

获取设备管理器当前使用的 adb 版本。

abstract DeviceDescriptor getDeviceDescriptor (String serial)

返回具有给定序列号的 DeviceDescriptor。

abstract String getFastbootPath ()

返回要使用的 fastboot 二进制文件的路径。

abstract void init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors)

使用设备过滤器初始化设备管理器。

abstract void init ()

初始化设备管理器。

abstract boolean isEmulator (String serial)

确定给定的串行是否代表一个模拟器

default boolean isFileSystemMountCheckEnabled ()

返回我们是否应该在检查NativeDeviceStateMonitor文件系统正确安装。

abstract boolean isNullDevice (String serial)

确定给定的串行是否代表空设备

abstract void killEmulator (ITestDevice device)

关闭给定的模拟器。

abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

启动模拟器的辅助方法。

abstract listAllDevices ()

返回所有已知设备的 DeviceDescriptor 列表

abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

切换给定USB设备ADB-过TCP模式,然后甲辅助方法通过连接到它connectToTcpDevice(String)

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

删除以前添加的IDeviceMonitor

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

通知管理器侦听器不再对 fastboot 状态更改感兴趣。

abstract void restartAdbBridge ()

重启(如果stopAdbBridge()被调用)亚行桥和服务依赖于ADB连接。

abstract void stopAdbBridge ()

停止 adb 网桥和服务依赖于 adb 连接。

abstract void terminate ()

停止设备监控服务,并终止 ddm 库。

abstract void terminateDeviceMonitor ()

停止设备监视器。

abstract void terminateDeviceRecovery ()

停止设备恢复线程。

default void terminateHard (String reason)

terminateHard()

abstract void terminateHard ()

terminate()但尝试强制关闭亚行也是如此。

abstract boolean waitForFirstDeviceAdded (long timeout)

等待第一个物理设备连接。

公共方法

添加设备监视器

public abstract void addDeviceMonitor (IDeviceMonitor mon)

添加一个IDeviceMonitor

参数
mon IDeviceMonitor

添加快速启动监听器

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

通知管理器某个侦听器对 fastboot 状态更改感兴趣。

目前,一个IDeviceManager如果有一个或多个活动的听众只会监视FASTBOOT设备。

待办事项:这有点麻烦 - 找到更好的解决方案

添加MonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

将设备添加到 fastboot 监视器。 fastboot 监视器将使用“fastboot_serial”与设备通信。

参数
serial String :设备的序列号。

fastboot_serial String :设备的FASTBOOT模式序列号。

分配设备

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

申请符合特定标准的设备进行测试。

参数
options IDeviceSelection :在IDeviceSelection设备应满足。

isTemporary boolean :临时NullDevice是否应该被创建。

退货
ITestDevice一个ITestDevice进行测试,或者null ,如果没有可用

分配设备

public abstract ITestDevice allocateDevice (IDeviceSelection options)

申请符合特定标准的设备进行测试。

参数
options IDeviceSelection :在IDeviceSelection设备应满足。

退货
ITestDevice一个ITestDevice进行测试,或者null ,如果没有可用

分配设备

public abstract ITestDevice allocateDevice ()

请求物理设备进行测试

退货
ITestDevice一个ITestDevice进行测试,或者null ,如果没有可用

连接到 TCP 设备

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

使用 adb-over-tcp 连接到设备

这个方法分配一个新的设备,其最终应通过被释放disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

返回ITestDevice会上网,但可能不会响应。

需要注意的是执行的动作,例如一个TCP连接的装置上的重新启动,将切断在TCP连接到设备,以及结果DeviceNotAvailableException

参数
ipAndPort String :该设备的原始IP地址和端口连接到

退货
ITestDeviceITestDevicenull ,如果不能形成一个TCP连接

从 TcpDevice 断开连接

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

断开与 adb-over-tcp 连接的设备的连接。

将设备切换回 USB 模式,并释放它。

参数
tcpDevice ITestDevice :当前在TCP模式的装置中,通过预先分配connectToTcpDevice(String)

退货
boolean true若切换至USB模式是成功的

显示设备信息

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

输出已知的装置,它们的状态,和用于共同使用的值的用户友好的含说明列表IDeviceSelection选项。

参数
printWriter PrintWriter :所述ERROR(/PrintWriter)到输出的描述

includeStub boolean :是否要显示存根设备了。

executeCmdOnAvailableDevice

public abstract CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

在可用设备上执行 shell 命令的辅助方法。

参数
serial String :设备的序列。

command String :shell命令。

timeout long :的时间命令完成量。

timeUnit TimeUnit :对超时的单位。

退货
CommandResult一个CommandResult

强制分配设备

public abstract ITestDevice forceAllocateDevice (String serial)

粗鲁地分配设备,即使它当前不可用。

如果设备已分配,则无效。

参数
serial String :设备序列分配

退货
ITestDeviceITestDevice ,或null ,如果它无法分配

免费设备

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

将设备返回到池中

尝试返回先前未分配的设备将被忽略。

参数
device ITestDevice :在ITestDevice免费

state FreeDeviceState :在FreeDeviceState 。用于控制设备是否返回到可用设备池。

获取路径

public abstract String getAdbPath ()

返回要使用的 adb 二进制文件的路径。

退货
String

获取Adb版本

public abstract String getAdbVersion ()

获取设备管理器当前使用的 adb 版本。

退货
String

获取设备描述符

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

返回具有给定序列号的 DeviceDescriptor。

参数
serial String :设备获得序列号

退货
DeviceDescriptorDeviceDescriptor所选设备,或者null如果串行不匹配的已知设备。

获取快速启动路径

public abstract String getFastbootPath ()

返回要使用的 fastboot 二进制文件的路径。

退货
String

在里面

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

使用设备过滤器初始化设备管理器。此过滤器可用于指示 DeviceManager 忽略某些已连接的设备。

参数
globalDeviceFilter IDeviceSelection :设备过滤器

deviceMonitors

在里面

public abstract void init ()

初始化设备管理器。在调用任何其他方法之前,这必须被调用一次并且只能调用一次。

模拟器

public abstract boolean isEmulator (String serial)

确定给定的串行是否代表一个模拟器

参数
serial String

退货
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

返回我们是否应该在检查NativeDeviceStateMonitor文件系统正确安装。

退货
boolean

是空设备

public abstract boolean isNullDevice (String serial)

确定给定的串行是否代表空设备

参数
serial String

退货
boolean

杀死模拟器

public abstract void killEmulator (ITestDevice device)

关闭给定的模拟器。

阻塞直到模拟器从 adb 中消失。如果模拟器已经不可用,则无效。

参数
device ITestDevice :在ITestDevice代表模拟器关闭

投掷
DeviceNotAvailableException如果模拟器无法关闭

启动模拟器

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

启动模拟器的辅助方法。

将启动调用者指定的模拟器

参数
device ITestDevice :占位符ITestDevice代表分配模拟器设备

bootTimeout long :在毫秒的时间等待模拟器启动

emulatorArgs : 启动模拟器的命令行参数

投掷
DeviceNotAvailableException如果模拟器无法启动或上线

列出所有设备

public abstract  listAllDevices ()

返回所有已知设备的 DeviceDescriptor 列表

退货
清单DeviceDescriptor所有已知设备

重新连接DeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

切换给定USB设备ADB-过TCP模式,然后甲辅助方法通过连接到它connectToTcpDevice(String)

参数
usbDevice ITestDevice :目前在USB模式下的设备

退货
ITestDevice新分配的ITestDevice在TCP模式或null ,如果不能形成一个TCP连接

投掷
DeviceNotAvailableException如果与之连接usbDevice已丢失,无法恢复

移除设备监视器

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

删除以前添加的IDeviceMonitor 。如果未添加 mon 则无效。

参数
mon IDeviceMonitor

移除快速启动监听器

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

通知管理器侦听器不再对 fastboot 状态更改感兴趣。

重启AdbBridge

public abstract void restartAdbBridge ()

重启(如果stopAdbBridge()被调用)亚行桥和服务依赖于ADB连接。

停止亚行桥

public abstract void stopAdbBridge ()

停止 adb 网桥和服务依赖于 adb 连接。

终止

public abstract void terminate ()

停止设备监控服务,并终止 ddm 库。

这必须在应用程序终止时调用。

也可以看看:

终止设备监视器

public abstract void terminateDeviceMonitor ()

停止设备监视器。

终止设备恢复

public abstract void terminateDeviceRecovery ()

停止设备恢复线程。

硬终止

public void terminateHard (String reason)

terminateHard()

参数
reason String :对于给定的终止理由可选。

硬终止

public abstract void terminateHard ()

terminate()但尝试强制关闭亚行也是如此。

等待第一个设备添加

public abstract boolean waitForFirstDeviceAdded (long timeout)

等待第一个物理设备连接。如果之前连接过设备,则直接返回 True。如果没有添加设备,超时后返回false。

参数
timeout long :时间在毫秒返回false前等待。

退货
boolean