Trình quản lý thiết bị
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
Giao diện quản lý bộ thiết bị hiện có để thử nghiệm.
Bản tóm tắt
các lớp lồng nhau | |
---|---|
interface | IDeviceManager.IFastbootListener Một bộ lắng nghe để thay đổi trạng thái fastboot. |
Phương thức công khai | |
---|---|
abstract void | addDeviceMonitor ( IDeviceMonitor mon) Thêm một |
abstract void | addFastbootListener ( IDeviceManager.IFastbootListener listener) Thông báo cho người quản lý rằng người nghe quan tâm đến các thay đổi trạng thái fastboot. |
abstract void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Thêm thiết bị vào màn hình fastboot. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options, boolean isTemporary) Yêu cầu một thiết bị để thử nghiệm đáp ứng các tiêu chí nhất định. |
abstract ITestDevice | allocateDevice ( IDeviceSelection options) Yêu cầu một thiết bị để thử nghiệm đáp ứng các tiêu chí nhất định. |
abstract ITestDevice | allocateDevice () Yêu cầu một thiết bị vật lý để thử nghiệm |
abstract ITestDevice | connectToTcpDevice (String ipAndPort) Kết nối với thiết bị bằng adb-over-tcp Phương thức này phân bổ một thiết bị mới, thiết bị này cuối cùng sẽ được giải phóng thôngdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) ITestDevice được trả lại sẽ trực tuyến nhưng có thể không phản hồi. |
abstract boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) Ngắt kết nối khỏi thiết bị được kết nối adb-over-tcp. |
abstract void | displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Xuất mô tả thân thiện với người dùng có chứa danh sách các thiết bị đã biết, trạng thái của chúng và giá trị cho các tùy chọn |
abstract CommandResult | executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Một phương thức trợ giúp để thực thi lệnh shell trên thiết bị khả dụng. |
abstract ITestDevice | forceAllocateDevice (String serial) Phân bổ một cách thô bạo một thiết bị, ngay cả khi thiết bị đó hiện không khả dụng. |
abstract void | freeDevice ( ITestDevice device, FreeDeviceState state) Trả thiết bị về nhóm Các nỗ lực trả lại thiết bị chưa được cấp phát trước đó sẽ bị bỏ qua. |
abstract String | getAdbPath () Trả về đường dẫn đến tệp nhị phân adb để sử dụng. |
abstract String | getAdbVersion () Nhận phiên bản adb hiện đang được trình quản lý thiết bị sử dụng. |
abstract DeviceDescriptor | getDeviceDescriptor (String serial) Trả về DeviceDescriptor với sê-ri đã cho. |
abstract String | getFastbootPath () Trả về đường dẫn đến tệp nhị phân fastboot để sử dụng. |
abstract void | init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors) Khởi tạo trình quản lý thiết bị bằng bộ lọc thiết bị. |
abstract void | init () Khởi tạo trình quản lý thiết bị. |
abstract boolean | isEmulator (String serial) Xác định xem sê-ri đã cho có đại diện cho trình giả lập không |
default boolean | isFileSystemMountCheckEnabled () Trả về việc chúng ta có nên kiểm tra trong |
abstract boolean | isNullDevice (String serial) Xác định xem số sê-ri đã cho có đại diện cho thiết bị rỗng không |
abstract void | killEmulator ( ITestDevice device) Tắt trình giả lập đã cho. |
abstract void | launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Phương thức trợ giúp để khởi chạy trình giả lập. |
abstract | listAllDevices (boolean shortDescriptor) Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết |
abstract | listAllDevices () Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết |
abstract ITestDevice | reconnectDeviceToTcp ( ITestDevice usbDevice) Một phương thức trợ giúp chuyển thiết bị usb đã cho sang chế độ adb-over-tcp, sau đó kết nối với nó qua |
abstract void | removeDeviceMonitor ( IDeviceMonitor mon) Xóa |
abstract void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Thông báo cho người quản lý rằng người nghe không còn quan tâm đến các thay đổi trạng thái fastboot. |
abstract void | restartAdbBridge () Khởi động lại (nếu |
abstract void | stopAdbBridge () Dừng cầu nối adb và các dịch vụ phụ thuộc vào kết nối adb. |
abstract void | terminate () Dừng các dịch vụ giám sát thiết bị và chấm dứt thư viện ddm. |
abstract void | terminateDeviceMonitor () Dừng Màn hình Thiết bị. |
abstract void | terminateDeviceRecovery () Dừng chuỗi khôi phục thiết bị. |
default void | terminateHard (String reason) Giống như |
abstract void | terminateHard () Giống như |
abstract boolean | waitForFirstDeviceAdded (long timeout) Đợi cho đến khi thiết bị vật lý đầu tiên được kết nối. |
Phương thức công khai
thêmDeviceMonitor
public abstract void addDeviceMonitor (IDeviceMonitor mon)
Thêm một IDeviceMonitor
Thông số | |
---|---|
mon | IDeviceMonitor |
addFastbootListener
public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)
Thông báo cho người quản lý rằng người nghe quan tâm đến các thay đổi trạng thái fastboot.
Hiện tại,IDeviceManager
sẽ chỉ giám sát các thiết bị trong fastboot nếu có một hoặc nhiều trình nghe đang hoạt động. TODO: đây là một chút khó khăn - hãy tìm giải pháp tốt hơn addMonitoringTcpFastbootDevice
public abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
Thêm thiết bị vào màn hình fastboot. Màn hình fastboot sẽ sử dụng 'fastboot_serial' để giao tiếp với thiết bị.
Thông số | |
---|---|
serial | String : số sê-ri của thiết bị. |
fastboot_serial | String : số sê-ri chế độ fastboot của thiết bị. |
phân bổthiết bị
public abstract ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Yêu cầu một thiết bị để thử nghiệm đáp ứng các tiêu chí nhất định.
Thông số | |
---|---|
options | IDeviceSelection : IDeviceSelection mà thiết bị phải đáp ứng. |
isTemporary | boolean : có nên tạo NullDevice tạm thời hay không. |
trả lại | |
---|---|
ITestDevice | một ITestDevice để thử nghiệm hoặc null nếu không có sẵn |
phân bổthiết bị
public abstract ITestDevice allocateDevice (IDeviceSelection options)
Yêu cầu một thiết bị để thử nghiệm đáp ứng các tiêu chí nhất định.
Thông số | |
---|---|
options | IDeviceSelection : IDeviceSelection mà thiết bị phải đáp ứng. |
trả lại | |
---|---|
ITestDevice | một ITestDevice để thử nghiệm hoặc null nếu không có sẵn |
phân bổthiết bị
public abstract ITestDevice allocateDevice ()
Yêu cầu một thiết bị vật lý để thử nghiệm
trả lại | |
---|---|
ITestDevice | một ITestDevice để thử nghiệm hoặc null nếu không có sẵn |
connectToTcpDevice
public abstract ITestDevice connectToTcpDevice (String ipAndPort)
Kết nối với thiết bị bằng adb-over-tcp
Phương thức này phân bổ một thiết bị mới, thiết bị này cuối cùng sẽ được giải phóng thôngdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
ITestDevice
được trả lại sẽ trực tuyến nhưng có thể không phản hồi. Lưu ý rằng việc thực hiện hành động chẳng hạn như khởi động lại trên thiết bị được kết nối tcp sẽ cắt kết nối tcp với thiết bị và dẫn đến DeviceNotAvailableException
Thông số | |
---|---|
ipAndPort | String : địa chỉ ip ban đầu và cổng của thiết bị để kết nối với |
trả lại | |
---|---|
ITestDevice | ITestDevice hoặc null nếu không thể hình thành kết nối tcp |
ngắt kết nốiTừTcpDevice
public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Ngắt kết nối khỏi thiết bị được kết nối adb-over-tcp.
Chuyển thiết bị về chế độ usb và giải phóng thiết bị.Thông số | |
---|---|
tcpDevice | ITestDevice : thiết bị hiện ở chế độ tcp, được phân bổ trước đó qua connectToTcpDevice(String) |
trả lại | |
---|---|
boolean | true nếu chuyển sang chế độ usb thành công |
displayDevicesInfo
public abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)
Xuất mô tả thân thiện với người dùng có chứa danh sách các thiết bị đã biết, trạng thái của chúng và giá trị cho các tùy chọn IDeviceSelection
thường được sử dụng.
Thông số | |
---|---|
printWriter | PrintWriter : ERROR(/PrintWriter) để xuất mô tả sang |
includeStub | boolean : Có hay không hiển thị các thiết bị còn sơ khai. |
thực thiCmdOnAvailableDevice
public abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)
Một phương thức trợ giúp để thực thi lệnh shell trên thiết bị khả dụng.
Thông số | |
---|---|
serial | String : Sê-ri của thiết bị. |
command | String : Lệnh trình bao. |
timeout | long : Lượng thời gian để lệnh hoàn thành. |
timeUnit | TimeUnit : Đơn vị thời gian chờ. |
trả lại | |
---|---|
CommandResult | Một CommandResult . |
buộc phân bổ thiết bị
public abstract ITestDevice forceAllocateDevice (String serial)
Phân bổ một cách thô bạo một thiết bị, ngay cả khi thiết bị đó hiện không khả dụng.
Sẽ không có hiệu lực nếu thiết bị đã được phân bổ.Thông số | |
---|---|
serial | String : nối tiếp thiết bị để phân bổ |
trả lại | |
---|---|
ITestDevice | ITestDevice hoặc null nếu không thể cấp phát |
thiết bị miễn phí
public abstract void freeDevice (ITestDevice device, FreeDeviceState state)
Trả thiết bị về nhóm
Các nỗ lực trả lại thiết bị chưa được cấp phát trước đó sẽ bị bỏ qua.Thông số | |
---|---|
device | ITestDevice : ITestDevice miễn phí |
state | FreeDeviceState : FreeDeviceState . Được sử dụng để kiểm soát nếu thiết bị được đưa trở lại nhóm thiết bị có sẵn. |
getAdbPath
public abstract String getAdbPath ()
Trả về đường dẫn đến tệp nhị phân adb để sử dụng.
trả lại | |
---|---|
String |
getAdbVersion
public abstract String getAdbVersion ()
Nhận phiên bản adb hiện đang được trình quản lý thiết bị sử dụng.
trả lại | |
---|---|
String |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (String serial)
Trả về DeviceDescriptor với sê-ri đã cho.
Thông số | |
---|---|
serial | String : số sê-ri để thiết bị lấy |
trả lại | |
---|---|
DeviceDescriptor | DeviceDescriptor cho thiết bị đã chọn hoặc null nếu sê-ri không khớp với thiết bị đã biết. |
getFastbootPath
public abstract String getFastbootPath ()
Trả về đường dẫn đến tệp nhị phân fastboot để sử dụng.
trả lại | |
---|---|
String |
trong đó
public abstract void init (IDeviceSelection globalDeviceFilter,deviceMonitors)
Khởi tạo trình quản lý thiết bị bằng bộ lọc thiết bị. Bộ lọc này có thể được sử dụng để hướng dẫn Trình quản lý thiết bị bỏ qua một số thiết bị được kết nối.
Thông số | |
---|---|
globalDeviceFilter | IDeviceSelection : bộ lọc thiết bị |
deviceMonitors |
trong đó
public abstract void init ()
Khởi tạo trình quản lý thiết bị. Điều này phải được gọi một lần và chỉ một lần trước khi bất kỳ phương thức nào khác được gọi.
isEmulator
public abstract boolean isEmulator (String serial)
Xác định xem sê-ri đã cho có đại diện cho trình giả lập không
Thông số | |
---|---|
serial | String |
trả lại | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Trả về việc chúng ta có nên kiểm tra trong NativeDeviceStateMonitor
hay không, hệ thống tệp được gắn đúng cách.
trả lại | |
---|---|
boolean |
isNullDevice
public abstract boolean isNullDevice (String serial)
Xác định xem số sê-ri đã cho có đại diện cho thiết bị rỗng không
Thông số | |
---|---|
serial | String |
trả lại | |
---|---|
boolean |
giết giả lập
public abstract void killEmulator (ITestDevice device)
Tắt trình giả lập đã cho.
Chặn cho đến khi trình giả lập biến mất khỏi adb. Sẽ không có tác dụng nếu trình giả lập chưa có sẵn.Thông số | |
---|---|
device | ITestDevice : trình giả lập đại diện cho ITestDevice tắt |
ném | |
---|---|
DeviceNotAvailableException | nếu trình giả lập không tắt được |
khởi độngTrình mô phỏng
public abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Phương thức trợ giúp để khởi chạy trình giả lập.
Sẽ khởi chạy trình giả lập theo chỉ định của người gọiThông số | |
---|---|
device | ITestDevice : trình giữ chỗ ITestDevice đại diện cho thiết bị giả lập được phân bổ |
bootTimeout | long : thời gian tính bằng ms để đợi trình giả lập khởi động |
emulatorArgs |
ném | |
---|---|
DeviceNotAvailableException | nếu trình giả lập không khởi động được hoặc trực tuyến |
listAllDevices
public abstractlistAllDevices (boolean shortDescriptor)
Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết
Thông số | |
---|---|
shortDescriptor | boolean : có nên giới hạn bộ mô tả ở mức thông tin tối thiểu hay không |
trả lại | |
---|---|
một danh sách DeviceDescriptor cho tất cả các thiết bị đã biết |
listAllDevices
public abstractlistAllDevices ()
Trả về danh sách DeviceDescriptors cho tất cả các thiết bị đã biết
trả lại | |
---|---|
một danh sách DeviceDescriptor cho tất cả các thiết bị đã biết |
kết nối lạiDeviceToTcp
public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
Một phương thức trợ giúp chuyển thiết bị usb đã cho sang chế độ adb-over-tcp, sau đó kết nối với nó qua connectToTcpDevice(String)
.
Thông số | |
---|---|
usbDevice | ITestDevice : thiết bị hiện đang ở chế độ usb |
trả lại | |
---|---|
ITestDevice | ITestDevice mới được phân bổ ở chế độ tcp hoặc null nếu không thể hình thành kết nối tcp |
ném | |
---|---|
DeviceNotAvailableException | nếu kết nối với usbDevice bị mất và không thể phục hồi |
loại bỏDeviceMonitor
public abstract void removeDeviceMonitor (IDeviceMonitor mon)
Xóa IDeviceMonitor
đã thêm trước đó. Không có tác dụng nếu mon chưa được thêm vào.
Thông số | |
---|---|
mon | IDeviceMonitor |
gỡ bỏFastbootListener
public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Thông báo cho người quản lý rằng người nghe không còn quan tâm đến các thay đổi trạng thái fastboot.
khởi động lạiAdbBridge
public abstract void restartAdbBridge ()
Khởi động lại (nếu stopAdbBridge()
được gọi) adb bridge và các dịch vụ phụ thuộc vào kết nối adb.
dừngAdbBridge
public abstract void stopAdbBridge ()
Dừng cầu nối adb và các dịch vụ phụ thuộc vào kết nối adb.
chấm dứt
public abstract void terminate ()
Dừng các dịch vụ giám sát thiết bị và chấm dứt thư viện ddm.
Điều này phải được gọi khi chấm dứt ứng dụng.Xem thêm:
chấm dứtDeviceMonitor
public abstract void terminateDeviceMonitor ()
Dừng Màn hình Thiết bị.
chấm dứtDeviceRecovery
public abstract void terminateDeviceRecovery ()
Dừng chuỗi khôi phục thiết bị.
chấm dứtHard
public void terminateHard (String reason)
Giống như terminateHard()
.
Thông số | |
---|---|
reason | String : lý do tùy chọn được đưa ra để chấm dứt. |
chấm dứtHard
public abstract void terminateHard ()
Giống như terminate()
, nhưng cũng cố gắng tắt adb một cách mạnh mẽ.
waitForFirstDeviceAdded
public abstract boolean waitForFirstDeviceAdded (long timeout)
Đợi cho đến khi thiết bị vật lý đầu tiên được kết nối. Nếu một thiết bị đã được kết nối trước đó, nó sẽ trả về trực tiếp True. Nếu không có thiết bị nào được thêm vào, nó sẽ trả về false sau khi hết thời gian chờ.
Thông số | |
---|---|
timeout | long : thời gian đợi tính bằng mili giây trước khi trả về false. |
trả lại | |
---|---|
boolean |
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2023-03-30 UTC.