IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

รู้จักคลาสย่อยทางอ้อม ตัวจัดการอุปกรณ์ ตัวจัดการอุปกรณ์

---

อินเทอร์เฟซสำหรับจัดการชุดอุปกรณ์ที่พร้อมใช้งานสำหรับการทดสอบ

สรุป

คลาสที่ซ้อนกัน
interface	IDeviceManager.IFastbootListener Listener สำหรับการเปลี่ยนแปลงสถานะ 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) เมธอดตัวช่วยเพื่อรันคำสั่งเชลล์บนอุปกรณ์ที่มีอยู่
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) ตรวจสอบว่าซีเรียลที่ให้มาแสดงถึงอุปกรณ์ null หรือไม่
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 (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) แจ้งผู้จัดการว่าผู้ฟังไม่สนใจการเปลี่ยนแปลงสถานะ fastboot อีกต่อไป
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)

แจ้งผู้จัดการว่าผู้ฟังสนใจในการเปลี่ยนแปลงสถานะ fastboot

ปัจจุบัน IDeviceManager จะตรวจสอบอุปกรณ์ใน fastboot เท่านั้นหากมีผู้ฟังที่ใช้งานอยู่อย่างน้อยหนึ่งราย

สิ่งที่ต้องทำ: นี่เป็นการแฮ็กเล็กน้อย - หาวิธีแก้ปัญหาที่ดีกว่า

addMonitoringTcpFastbootDevice

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 หากไม่มีอยู่

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 ได้

ตัดการเชื่อมต่อจากTcpDevice

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 : แสดงอุปกรณ์ต้นขั้วด้วยหรือไม่

รันCmdOnAvailableDevice

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

เมธอดตัวช่วยเพื่อรันคำสั่งเชลล์บนอุปกรณ์ที่มีอยู่

พารามิเตอร์
serial	String : ซีเรียลของอุปกรณ์
command	String : คำสั่งเชลล์
timeout	long : ระยะเวลาที่คำสั่งจะเสร็จสมบูรณ์
timeUnit	TimeUnit : หน่วยสำหรับการหมดเวลา

คืนสินค้า
CommandResult	ผลลัพธ์คำ CommandResult

บังคับจัดสรรอุปกรณ์

public abstract ITestDevice forceAllocateDevice (String serial)

จัดสรรอุปกรณ์อย่างหยาบคาย แม้ว่าจะยังไม่พร้อมใช้งานในปัจจุบันก็ตาม

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

พารามิเตอร์
serial	String : ซีเรียลของอุปกรณ์ที่จะจัดสรร

คืนสินค้า
ITestDevice	ITestDevice หรือ null หากไม่สามารถจัดสรรได้

ฟรีอุปกรณ์

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

ในนั้น

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

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	หากโปรแกรมจำลองไม่สามารถปิดได้

launchEmulator

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

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

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

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

ขว้าง
DeviceNotAvailableException	หากโปรแกรมจำลองไม่สามารถบู๊ตหรือออนไลน์ได้

รายการอุปกรณ์ทั้งหมด

public abstract  listAllDevices (boolean shortDescriptor)

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

พารามิเตอร์
shortDescriptor	boolean : จะจำกัด descriptors เป็นข้อมูลขั้นต่ำหรือไม่

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

รายการอุปกรณ์ทั้งหมด

public abstract  listAllDevices ()

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

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

เชื่อมต่ออุปกรณ์ToTcp อีกครั้ง

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)

แจ้งผู้จัดการว่าผู้ฟังไม่สนใจการเปลี่ยนแปลงสถานะ fastboot อีกต่อไป

รีสตาร์ทAdbBridge

public abstract void restartAdbBridge ()

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

หยุดAdbBridge

public abstract void stopAdbBridge ()

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

ยุติ

public abstract void terminate ()

หยุดบริการตรวจสอบอุปกรณ์ และยุติไลบรารี ddm

สิ่งนี้จะต้องถูกเรียกเมื่อสิ้นสุดการสมัคร

ดูสิ่งนี้ด้วย:

• AndroidDebugBridge.terminate()

สิ้นสุดDeviceMonitor

public abstract void terminateDeviceMonitor ()

หยุดการตรวจสอบอุปกรณ์

ยุติการกู้คืนอุปกรณ์

public abstract void terminateDeviceRecovery ()

หยุดเธรดการกู้คืนอุปกรณ์

ยุติฮาร์ด

public void terminateHard (String reason)

เช่น terminateHard()

พารามิเตอร์
reason	String : เหตุผลที่เลือกได้สำหรับการยกเลิก

ยุติฮาร์ด

public abstract void terminateHard ()

เช่นเดียวกับ terminate() แต่พยายามปิด adb อย่างแรงเช่นกัน

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

พารามิเตอร์
timeout	long : เวลาที่รอเป็นมิลลิวินาทีก่อนที่จะคืนค่าเท็จ

คืนสินค้า
boolean