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 void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

เพิ่มอุปกรณ์ในเครื่องมือตรวจสอบการรีบูตระบบ

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)

เริ่มต้นตัวจัดการอุปกรณ์ด้วยตัวกรองอุปกรณ์

abstract void init()

เริ่มต้นตัวจัดการอุปกรณ์

abstract boolean isEmulator(String serial)

ระบุว่าซีเรียลที่ระบุแสดงถึงโปรแกรมจำลองหรือไม่

default boolean isFileSystemMountCheckEnabled()

แสดงผลว่าควรตรวจสอบหรือไม่ใน NativeDeviceStateMonitor ระบบได้ติดตั้งไฟล์ระบบอย่างถูกต้องแล้ว

abstract boolean isNullDevice(String serial)

ตรวจสอบว่าหมายเลขซีเรียลที่ระบุแสดงถึงอุปกรณ์ Null หรือไม่

abstract void killEmulator(ITestDevice device)

ปิดโปรแกรมจำลองที่ระบุ

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

เมธอดตัวช่วยเพื่อเปิดโปรแกรมจำลอง

abstract listAllDevices(boolean shortDescriptor)

แสดงรายการ DeviceDescriptors สำหรับอุปกรณ์ที่รู้จักทั้งหมด

abstract listAllDevices()

แสดงรายการ DeviceDescriptors สำหรับอุปกรณ์ที่รู้จักทั้งหมด

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 stopAdbBridge()

หยุดบริดจ์ adb และบริการที่ขึ้นอยู่กับการเชื่อมต่อ adb

abstract void terminate()

หยุดบริการตรวจสอบอุปกรณ์และปิดใช้งานคลัง ddm

abstract void terminateDeviceMonitor()

หยุดเครื่องมือตรวจสอบอุปกรณ์

abstract void terminateDeviceRecovery()

หยุดชุดข้อความการกู้คืนอุปกรณ์

default void terminateHard(String reason)

เช่น terminateHard()

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 จะตรวจสอบอุปกรณ์ในโหมด Fastboot เฉพาะในกรณีที่มีผู้ฟังที่ใช้งานอยู่อย่างน้อย 1 คน

สิ่งที่ต้องทำ: นี่เป็นวิธีแก้ปัญหาชั่วคราว โปรดหาวิธีแก้ปัญหาที่ดีกว่า

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

เพิ่มอุปกรณ์ในเครื่องมือตรวจสอบการรีบูตระบบ เครื่องมือตรวจสอบ Fastboot จะใช้ "fastboot_serial" เพื่อสื่อสารกับอุปกรณ์

พารามิเตอร์
serial String: หมายเลขซีเรียลของอุปกรณ์
fastboot_serial String: หมายเลขซีเรียลของโหมด Fastboot ของอุปกรณ์

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

ขออุปกรณ์สำหรับทดสอบที่ตรงตามเกณฑ์ที่กำหนด

พารามิเตอร์
options IDeviceSelection: IDeviceSelection ที่อุปกรณ์ควรมีคุณสมบัติตรงตาม
isTemporary boolean: ควรสร้าง NullDevice ชั่วคราวหรือไม่
คิกรีเทิร์น
ITestDevice ITestDevice สำหรับการทดสอบ หรือ null หากไม่มี

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

ขออุปกรณ์สำหรับทดสอบที่ตรงตามเกณฑ์ที่กำหนด

พารามิเตอร์
options IDeviceSelection: IDeviceSelection ที่อุปกรณ์ควรมีคุณสมบัติตรงตาม
คิกรีเทิร์น
ITestDevice ITestDevice สำหรับการทดสอบ หรือ null หากไม่มี

allocateDevice

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 หรือ null หากสร้างการเชื่อมต่อ TCP ไม่ได้

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

ยกเลิกการเชื่อมต่อจากอุปกรณ์ที่เชื่อมต่อผ่าน adb-over-tcp

เปลี่ยนอุปกรณ์กลับไปเป็นโหมด USB แล้วปล่อยอุปกรณ์

พารามิเตอร์
tcpDevice ITestDevice: อุปกรณ์ที่อยู่ในโหมด TCP ในปัจจุบัน ซึ่งก่อนหน้านี้ได้รับการจัดสรรผ่าน connectToTcpDevice(String)
คิกรีเทิร์น
boolean true หากเปลี่ยนเป็นโหมด USB สำเร็จ

displayDevicesInfo

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: คำสั่งเชลล์
timeout long: ระยะเวลาที่ใช้ในการดำเนินการตามคำสั่ง
timeUnit TimeUnit: หน่วยของเวลาหมด
คิกรีเทิร์น
CommandResult ก CommandResult

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

กำหนดอุปกรณ์อย่างไม่สุภาพ แม้ว่าอุปกรณ์จะยังไม่พร้อมใช้งานในขณะนี้

จะไม่มีผลหากอุปกรณ์ได้รับการจัดสรรแล้ว

พารามิเตอร์
serial String: หมายเลขซีเรียลของอุปกรณ์ที่จะจัดสรร
คิกรีเทิร์น
ITestDevice ITestDevice หรือ null หากไม่สามารถจัดสรรได้

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

ส่งคืนอุปกรณ์ไปยังพูล

ระบบจะไม่สนใจการพยายามส่งคืนอุปกรณ์ที่ยังไม่ได้จัดสรรก่อนหน้านี้

พารามิเตอร์
device ITestDevice: ITestDevice เป็น ฟรี
state FreeDeviceState: FreeDeviceState ใช้เพื่อควบคุมว่าจะส่งคืนอุปกรณ์กลับไปยังพูลอุปกรณ์ที่พร้อมใช้งานหรือไม่

getAdbPath

public abstract String getAdbPath ()

แสดงผลเส้นทางไปยังไบนารี adb ที่จะใช้

คิกรีเทิร์น
String

getAdbVersion

public abstract String getAdbVersion ()

ดูเวอร์ชัน ADB ที่เครื่องมือจัดการอุปกรณ์ใช้อยู่ในปัจจุบัน

คิกรีเทิร์น
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

แสดงผล DeviceDescriptor ที่มีซีเรียลที่ระบุ

พารามิเตอร์
serial String: หมายเลขซีเรียลของอุปกรณ์ที่จะรับ
คิกรีเทิร์น
DeviceDescriptor DeviceDescriptor สำหรับอุปกรณ์ที่เลือก หรือ Null หากหมายเลขซีเรียลไม่ตรงกับอุปกรณ์ที่รู้จัก

getFastbootPath

public abstract String getFastbootPath ()

แสดงผลเส้นทางไปยังไบนารีของ Fastboot ที่จะใช้งาน

คิกรีเทิร์น
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

เริ่มต้นตัวจัดการอุปกรณ์ด้วยตัวกรองอุปกรณ์ ตัวกรองนี้ใช้เพื่อสั่งให้ DeviceManager ละเว้นอุปกรณ์ที่เชื่อมต่อบางเครื่องได้

พารามิเตอร์
globalDeviceFilter IDeviceSelection: ตัวกรองอุปกรณ์
deviceMonitors

init

public abstract void init ()

เริ่มต้นตัวจัดการอุปกรณ์ คุณต้องเรียกใช้เมธอดนี้เพียงครั้งเดียวก่อนเรียกใช้เมธอดอื่นๆ

isEmulator

public abstract boolean isEmulator (String serial)

ระบุว่าซีเรียลที่ระบุแสดงถึงโปรแกรมจำลองหรือไม่

พารามิเตอร์
serial String

คิกรีเทิร์น
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

แสดงผลว่าควรตรวจสอบหรือไม่ใน NativeDeviceStateMonitor ระบบได้ติดตั้งไฟล์ระบบอย่างถูกต้องแล้ว

คิกรีเทิร์น
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

ตรวจสอบว่าหมายเลขซีเรียลที่ระบุแสดงถึงอุปกรณ์ Null หรือไม่

พารามิเตอร์
serial String

คิกรีเทิร์น
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

ปิดโปรแกรมจำลองที่ระบุ

บล็อกจนกว่าโปรแกรมจำลองจะหายไปจาก adb จะไม่มีผลหากไม่มีโปรแกรมจำลองอยู่แล้ว

พารามิเตอร์
device ITestDevice: ITestDevice ที่แสดงถึงโปรแกรมจำลองที่จะปิด
การโยน
DeviceNotAvailableException if emulator fails to shut down

launchEmulator

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

เมธอดตัวช่วยเพื่อเปิดโปรแกรมจำลอง

จะเปิดโปรแกรมจําลองตามที่ผู้เรียกระบุ

พารามิเตอร์
device ITestDevice: ตัวยึดตําแหน่ง ITestDevice ที่แสดงถึงอุปกรณ์โปรแกรมจําลองที่จัดสรร
bootTimeout long: เวลาเป็นมิลลิวินาทีที่ใช้ในการรอให้โปรแกรมจำลองบูต
emulatorArgs : อาร์กิวเมนต์บรรทัดคำสั่งเพื่อเปิดโปรแกรมจำลอง
การโยน
DeviceNotAvailableException หากโปรแกรมจำลองไม่สามารถบูตหรือออนไลน์

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

แสดงรายการ DeviceDescriptors สำหรับอุปกรณ์ที่รู้จักทั้งหมด

พารามิเตอร์
shortDescriptor boolean: กำหนดให้คำอธิบายใช้ข้อมูลขั้นต่ำหรือไม่
คิกรีเทิร์น
รายการ DeviceDescriptor สำหรับอุปกรณ์ทั้งหมดที่รู้จัก

listAllDevices

public abstract  listAllDevices ()

แสดงรายการ DeviceDescriptors สำหรับอุปกรณ์ที่รู้จักทั้งหมด

คิกรีเทิร์น
รายการ DeviceDescriptor สำหรับอุปกรณ์ทั้งหมดที่รู้จัก

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

เมธอดตัวช่วยที่จะเปลี่ยนอุปกรณ์ USB หนึ่งๆ เป็นโหมด adb-over-tcp แล้วเชื่อมต่อกับอุปกรณ์ผ่าน connectToTcpDevice(String)

พารามิเตอร์
usbDevice ITestDevice: อุปกรณ์อยู่ในโหมด USB อยู่
คิกรีเทิร์น
ITestDevice ITestDevice ที่จัดสรรใหม่ในโหมด TCP หรือ null หากสร้างการเชื่อมต่อ TCP ไม่ได้
การโยน
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

stopAdbBridge

public abstract void stopAdbBridge ()

หยุดบริดจ์ adb และบริการที่ขึ้นอยู่กับการเชื่อมต่อ adb

สิ้นสุด

public abstract void terminate ()

หยุดบริการตรวจสอบอุปกรณ์และปิดใช้งานคลัง ddm

ฟังก์ชันนี้ต้องเรียกใช้เมื่อมีการสิ้นสุดการสมัคร

ดูเพิ่มเติม

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

หยุดเครื่องมือตรวจสอบอุปกรณ์

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

หยุดชุดข้อความการกู้คืนอุปกรณ์

terminateHard

public void terminateHard (String reason)

เช่น terminateHard()

พารามิเตอร์
reason String: เหตุผลในการสิ้นสุด (ไม่บังคับ)

terminateHard

public abstract void terminateHard ()

เหมือนกับ terminate() แต่พยายามปิด adb ด้วย

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

รอจนกว่าอุปกรณ์จริงเครื่องแรกจะเชื่อมต่อ หากมีการเชื่อมต่ออุปกรณ์ไว้ก่อนหน้านี้ ฟังก์ชันนี้จะแสดงผลเป็น "จริง" โดยตรง หากไม่มีการเพิ่มอุปกรณ์ ระบบจะแสดงผลเป็นเท็จหลังจากหมดเวลา

พารามิเตอร์
timeout long: เวลาที่รอเป็นมิลลิวินาทีก่อนที่จะแสดงผลเป็นเท็จ
คิกรีเทิร์น
boolean