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

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

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

สิ้นสุด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