Google 致力于为黑人社区推动种族平等。查看具体举措
此页面由 Cloud Translation API 翻译。
Switch to English

IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


用于管理一组可用设备进行测试的界面。

摘要

嵌套类

interface IDeviceManager.IFastbootListener

快速启动状态更改的侦听器。

公开方法

abstract void addDeviceMonitor ( IDeviceMonitor mon)

添加一个IDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

通知管理器侦听器对快速启动状态更改感兴趣。

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 ITestDevice forceAllocateDevice (String serial)

粗略分配设备,即使该设备当前不可用。

abstract void freeDevice ( ITestDevice device, FreeDeviceState state)

将设备退回池

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

abstract String getAdbPath ()

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

abstract String getAdbVersion ()

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

abstract int getAvailableFlashingPermits ()

获取可用的闪光灯许可证数量

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)

确定给定的序列是否代表仿真器

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-over-tcp模式,然后通过connectToTcpDevice(String)连接到它。

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

删除以前添加的IDeviceMonitor

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

通知管理器,侦听器不再对快速启动状态更改感兴趣。

abstract void restartAdbBridge ()

重新启动(如果stopAdbBridge() )adb网桥,并且服务取决于adb连接。

abstract void returnFlashingPermit ()

恢复我们之前获得的闪光许可证

abstract void stopAdbBridge ()

停止adb桥接,服务取决于adb连接。

abstract void takeFlashingPermit ()

请求闪光许可。

abstract void terminate ()

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

abstract void terminateDeviceMonitor ()

停止设备监视器。

abstract void terminateDeviceRecovery ()

停止设备恢复线程。

abstract void terminateHard ()

terminate()类似,但也尝试强制关闭adb。

abstract boolean waitForFirstDeviceAdded (long timeout)

等待直到连接了第一台物理设备。

公开方法

addDeviceMonitor

public abstract void addDeviceMonitor ( IDeviceMonitor mon)

添加一个IDeviceMonitor

参量
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

通知管理器侦听器对快速启动状态更改感兴趣。

当前,如果有一个或多个活动的侦听器,则IDeviceManager仅监视快速启动中的设备。

待办事项:这有点hack-寻找更好的解决方案

分配设备

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

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

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

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

返回的ITestDevice将处于联机状态,但可能没有响应。

请注意,在连接了tcp的设备上执行诸如重新启动之类的操作,将切断与设备的tcp连接,并导致DeviceNotAvailableException

参量
ipAndPort String :要连接的设备的原始IP地址和端口

退货
ITestDevice ITestDevice如果无法形成TCP连接,则ITestDevice null

offlineFromTcpDevice

public abstract boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

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

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

参量
tcpDevice ITestDevice :当前处于tcp模式的设备,以前是通过connectToTcpDevice(String)分配的

退货
boolean 如果成功切换到USB模式,则为true

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

输出用户友好的描述,其中包含已知设备的列表,它们的状态以及常用IDeviceSelection选项的值。

参量
printWriter PrintWriter :将描述输出到的ERROR(/PrintWriter)

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

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

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

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

参量
serial String :要分配的设备序列号

退货
ITestDevice ITestDevice ;如果无法分配,则ITestDevice null

freeDevice

public abstract void freeDevice ( ITestDevice device, 
                FreeDeviceState state)

将设备退回池

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

参量
device ITestDevice :要释放的ITestDevice

state FreeDeviceStateFreeDeviceState 。用于控制设备是否返回到可用设备池。

getAdbPath

public abstract String getAdbPath ()

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

退货
String

getAdbVersion

public abstract String getAdbVersion ()

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

退货
String

getAvailableFlashingPermits

public abstract int getAvailableFlashingPermits ()

获取可用的闪光灯许可证数量

退货
int 可用的闪烁许可数或Integer.MAX_VALUE(如果不可用)。

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

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

参量
serial String :设备要获取的序列号

退货
DeviceDescriptor 所选设备的DeviceDescriptor ;如果序列与已知设备不匹配,则返回null。

getFastbootPath

public abstract String getFastbootPath ()

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

退货
String

在里面

public abstract void init ( IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

参量
globalDeviceFilter IDeviceSelection :设备过滤器

deviceMonitors

在里面

public abstract void init ()

初始化设备管理器。必须先调用一次,然后再调用一次。

isEmulator

public abstract boolean isEmulator (String serial)

确定给定的序列是否代表仿真器

参量
serial String

退货
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

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

参量
serial String

退货
boolean

killEmulator

public abstract void killEmulator ( ITestDevice device)

关闭给定的模拟器。

阻塞,直到模拟器从adb中消失。如果仿真器尚不可用,则将不起作用。

参量
device ITestDevice :代表要关闭的模拟器的ITestDevice

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

launchEmulator

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

启动模拟器的辅助方法。

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

参量
device ITestDevice :占位符ITestDevice代表分配的仿真器设备

bootTimeout long :等待仿真器启动的时间(以毫秒为单位)

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

投掷
DeviceNotAvailableException 如果仿真器无法启动或无法联机

listAllDevices

public abstract  listAllDevices ()

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

退货
所有已知设备的DeviceDescriptor列表

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

一种帮助程序方法,将给定的USB设备切换到adb-over-tcp模式,然后通过connectToTcpDevice(String)连接到它。

参量
usbDevice ITestDevice :当前处于USB模式的设备

退货
ITestDevice 在tcp模式下新分配的ITestDevice ;如果无法形成tcp连接,则返回null

投掷
DeviceNotAvailableException 如果与usbDevice的连接丢失并且无法恢复

removeDeviceMonitor

public abstract void removeDeviceMonitor ( IDeviceMonitor mon)

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

参量
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

通知管理器,侦听器不再对快速启动状态更改感兴趣。

restartAdbBridge

public abstract void restartAdbBridge ()

重新启动(如果stopAdbBridge() )adb网桥,并且服务取决于adb连接。

returnFlashingPermit

public abstract void returnFlashingPermit ()

恢复我们之前获得的闪光许可证

stopAdbBridge

public abstract void stopAdbBridge ()

停止adb桥接,服务取决于adb连接。

takeFlashingPermit

public abstract void takeFlashingPermit ()

请求闪光许可。如果并发闪光灯的数量受到限制,则它将排队等待,以保持在闪光灯限制计数之下。

终止

public abstract void terminate ()

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

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

也可以看看:

TerminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

停止设备监视器。

TerminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

停止设备恢复线程。

终止硬

public abstract void terminateHard ()

terminate()类似,但也尝试强制关闭adb。

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

等待直到连接了第一台物理设备。如果以前连接过设备,它将直接返回True。如果未添加任何设备,则超时后返回false。

参量
timeout long :返回false之前等待的时间(以毫秒为单位)。

退货
boolean