ตั้งแต่ปี 2026 เป็นต้นไป เราจะเผยแพร่ซอร์สโค้ดไปยัง AOSP ในไตรมาสที่ 2 และ 4 เพื่อให้สอดคล้องกับโมเดลการพัฒนาที่เสถียรของ Trunk และรับประกันความเสถียรของแพลตฟอร์มสำหรับระบบนิเวศ เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main ในการสร้างและมีส่วนร่วมใน AOSP android-latest-release สาขาไฟล์ Manifest จะอ้างอิงถึงรุ่นล่าสุดที่พุชไปยัง AOSP เสมอ ดูข้อมูลเพิ่มเติมได้ที่การเปลี่ยนแปลงใน AOSP

NativeDeviceStateMonitor

public class NativeDeviceStateMonitor
extends Object implements IDeviceStateMonitor

java.lang.Object
↳	com.android.tradefed.device.NativeDeviceStateMonitor

คลาสย่อยโดยตรงที่ทราบ

DeviceStateMonitor

DeviceStateMonitor คลาส Helper สำหรับตรวจสอบสถานะของ IDevice

คลาสย่อยทางอ้อมที่ทราบ

NestedDeviceStateMonitor

NestedDeviceStateMonitor โปรแกรมตรวจสอบสถานะอุปกรณ์ที่ทำการตรวจสอบเพิ่มเติมในอุปกรณ์ที่ซ้อนกันเพื่อรองรับรายละเอียดของ สภาพแวดล้อมเสมือน

คลาส Helper สำหรับการตรวจสอบสถานะของ IDevice ที่ไม่มีการรองรับเฟรมเวิร์ก

สรุป

ค่าคงที่
`long`	`MAX_CHECK_POLL_TIME`
`int`	`MAX_OP_TIME` เวลาดำเนินการสูงสุดเป็นมิลลิวินาทีสำหรับคำสั่ง "สำรวจการตอบสนอง"
`String`	`PERM_DENIED_ERROR_PATTERN`

เครื่องมือสร้างสาธารณะ
`NativeDeviceStateMonitor(IDeviceManager mgr, IDevice device, boolean fastbootEnabled)`

เมธอดสาธารณะ
`void`	`attachFinalState(TestDeviceState finalState)` แนบสถานะสุดท้ายเพื่อยกเลิก waitForDeviceState หากถึง
`void`	`clearTcpFastbootMonitor()` ล้างสถานะใน Device Manager
`TestDeviceState`	`getDeviceState()` รับสถานะอุปกรณ์
`String`	`getFastbootSerialNumber()` รับหมายเลขซีเรียลของ Fastboot Mode
`String`	`getMountPoint(String mountName)` แสดงผลจุดต่อเชื่อม
`String`	`getSerialNumber()` รับหมายเลขซีเรียลของอุปกรณ์
`boolean`	`isAdbTcp()`
`void`	`setDefaultAvailableTimeout(long timeoutMs)` ตั้งค่าเวลารอเป็นมิลลิวินาทีเพื่อให้`waitForDeviceAvailable()`พร้อมใช้งาน
`void`	`setDefaultOnlineTimeout(long timeoutMs)` ตั้งค่าเวลาเป็นมิลลิวินาทีเพื่อรอให้อุปกรณ์ออนไลน์ใน `waitForDeviceOnline()`
`void`	`setFastbootSerialNumber(String serial)` ตั้งค่าหมายเลขซีเรียลของ Fastboot Mode
`void`	`setIDevice(IDevice newDevice)` อัปเดต iDevice ปัจจุบัน
`void`	`setSkipBootComplete(boolean skipBootComplete)`
`void`	`setState(TestDeviceState deviceState)` ตั้งค่าสถานะปัจจุบันของอุปกรณ์
`boolean`	`waitForBootComplete(long waitTime)` บล็อกจนกว่าจะมีการตั้งค่าสถานะการบูตของอุปกรณ์เสร็จสมบูรณ์
`IDevice`	`waitForDeviceAvailable(long waitTime)` รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
`IDevice`	`waitForDeviceAvailable()` รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ
`IDevice`	`waitForDeviceAvailableInRecoverPath(long waitTime)` `waitForDeviceAvailable(long)` รูปแบบพิเศษที่จะเรียกใช้ในเส้นทางการกู้คืนเพื่อ ปรับแต่งการจัดการ
`boolean`	`waitForDeviceBootloader(long time)` รอให้อุปกรณ์อยู่ใน Bootloader
`void`	`waitForDeviceBootloaderStateUpdate()` รอให้ระบบรีเฟรชสถานะ Bootloader ของอุปกรณ์
`boolean`	`waitForDeviceFastbootd(String fastbootPath, long time)` รอให้อุปกรณ์อยู่ใน fastbootd
`IDevice`	`waitForDeviceInRecovery()` รอให้อุปกรณ์เข้าสู่โหมดการกู้คืนโดยใช้การหมดเวลาการบูตมาตรฐาน
`boolean`	`waitForDeviceInRecovery(long waitTime)` รอให้อุปกรณ์อยู่ในสถานะ "การกู้คืน adb"
`boolean`	`waitForDeviceInSideload(long waitTime)` รอให้อุปกรณ์อยู่ในสถานะ "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` รอให้อุปกรณ์ไม่พร้อมใช้งาน
`IDevice`	`waitForDeviceOnline()` รอให้อุปกรณ์ออนไลน์โดยใช้การหมดเวลาการบูตมาตรฐาน
`IDevice`	`waitForDeviceOnline(long waitTime)` รอให้อุปกรณ์ออนไลน์
`boolean`	`waitForDeviceShell(long waitTime)` รอให้อุปกรณ์ตอบสนองต่อคำสั่ง adb shell พื้นฐาน

วิธีการที่ได้รับการป้องกัน
`CollectingOutputReceiver`	`createOutputReceiver()` เปิดให้ทดสอบ
`long`	`getCheckPollTime()` เปิดให้ทดสอบ
`long`	`getCurrentTime()` เปิดให้ทดสอบ
`IDevice`	`getIDevice()`
`boolean`	`postOnlineCheck(long waitTime)` การตรวจสอบเพิ่มเติมที่ต้องดำเนินการในอุปกรณ์ที่ออนไลน์
`boolean`	`waitForStoreMount(long waitTime)` รอให้อุปกรณ์ติดตั้งที่เก็บข้อมูลภายนอก

ค่าคงที่

MAX_CHECK_POLL_TIME

protected static final long MAX_CHECK_POLL_TIME

ค่าคงที่: 3000 (0x0000000000000bb8)

MAX_OP_TIME

protected static final int MAX_OP_TIME

เวลาดำเนินการสูงสุดเป็นมิลลิวินาทีสำหรับคำสั่ง "สำรวจการตอบสนอง"

ค่าคงที่ 10000 (0x00002710)

PERM_DENIED_ERROR_PATTERN

protected static final String PERM_DENIED_ERROR_PATTERN

ค่าคงที่: "ไม่อนุญาต"

เครื่องมือสร้างสาธารณะ

NativeDeviceStateMonitor

public NativeDeviceStateMonitor (IDeviceManager mgr, 
                IDevice device, 
                boolean fastbootEnabled)

พารามิเตอร์
`mgr`	`IDeviceManager`
`device`	`IDevice`
`fastbootEnabled`	`boolean`

เมธอดสาธารณะ

attachFinalState

public void attachFinalState (TestDeviceState finalState)

แนบสถานะสุดท้ายเพื่อยกเลิก waitForDeviceState หากถึง

พารามิเตอร์
`finalState`	`TestDeviceState`

clearTcpFastbootMonitor

public void clearTcpFastbootMonitor ()

ล้างสถานะใน Device Manager

getDeviceState

public TestDeviceState getDeviceState ()

รับสถานะอุปกรณ์

คิกรีเทิร์น
`TestDeviceState`	`TestDeviceState` ของอุปกรณ์

getFastbootSerialNumber

public String getFastbootSerialNumber ()

รับหมายเลขซีเรียลของ Fastboot Mode

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

getMountPoint

public String getMountPoint (String mountName)

แสดงผลจุดต่อเชื่อม

ค้นหาอุปกรณ์โดยตรงหากไม่มีข้อมูลที่แคชไว้ใน IDevice

สิ่งที่ต้องทำ: ย้ายลักษณะการทำงานนี้ไปที่ IDevice.getMountPoint(String)

พารามิเตอร์
`mountName`	`String`: ชื่อของจุดต่อเชื่อม

คิกรีเทิร์น
`String`	จุดต่อเชื่อมหรือ `null`

การขว้าง
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

รับหมายเลขซีเรียลของอุปกรณ์

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

isAdbTcp

public boolean isAdbTcp ()

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

setDefaultAvailableTimeout

public void setDefaultAvailableTimeout (long timeoutMs)

ตั้งค่าเวลารอเป็นมิลลิวินาทีเพื่อให้waitForDeviceAvailable()พร้อมใช้งาน

พารามิเตอร์
`timeoutMs`	`long`

setDefaultOnlineTimeout

public void setDefaultOnlineTimeout (long timeoutMs)

ตั้งค่าเวลาเป็นมิลลิวินาทีเพื่อรอให้อุปกรณ์ออนไลน์ใน waitForDeviceOnline()

พารามิเตอร์
`timeoutMs`	`long`

setFastbootSerialNumber

public void setFastbootSerialNumber (String serial)

ตั้งค่าหมายเลขซีเรียลของ Fastboot Mode

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

setIDevice

public void setIDevice (IDevice newDevice)

อัปเดต iDevice ปัจจุบัน

setSkipBootComplete

public void setSkipBootComplete (boolean skipBootComplete)

พารามิเตอร์
`skipBootComplete`	`boolean`

setState

public void setState (TestDeviceState deviceState)

ตั้งค่าสถานะปัจจุบันของอุปกรณ์

waitForBootComplete

public boolean waitForBootComplete (long waitTime)

บล็อกจนกว่าจะมีการตั้งค่าสถานะการบูตของอุปกรณ์เสร็จสมบูรณ์

พารามิเตอร์
`waitTime`	`long`: จำนวนในหน่วยมิลลิวินาทีที่จะรอ

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

waitForDeviceAvailable

public IDevice waitForDeviceAvailable (long waitTime)

รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ ปัจจุบันหมายความว่าตัวจัดการแพ็กเกจและพื้นที่เก็บข้อมูลภายนอกพร้อมใช้งาน

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

คิกรีเทิร์น
`IDevice`	`IDevice` หากอุปกรณ์ออนไลน์ก่อนเวลาหมดอายุ `null` หรือไม่เช่นนั้น

waitForDeviceAvailable

public IDevice waitForDeviceAvailable ()

รอให้อุปกรณ์ตอบสนองและพร้อมสำหรับการทดสอบ

เทียบเท่ากับ waitForDeviceAvailable(long) แต่ใช้การหมดเวลาการรีบูตเริ่มต้นของอุปกรณ์

คิกรีเทิร์น
`IDevice`	`IDevice` หากอุปกรณ์ออนไลน์ก่อนเวลาหมดอายุ `null` หรือไม่เช่นนั้น

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

waitForDeviceAvailable(long) รูปแบบพิเศษที่จะเรียกใช้ในเส้นทางการกู้คืนเพื่อ ปรับแต่งการจัดการ

พารามิเตอร์
`waitTime`	`long`

คิกรีเทิร์น
`IDevice`

การขว้าง
`DeviceNotAvailableException`

waitForDeviceBootloader

public boolean waitForDeviceBootloader (long time)

รอให้อุปกรณ์อยู่ใน Bootloader

พารามิเตอร์
`time`	`long`: เวลาสูงสุดเป็นมิลลิวินาทีที่จะรอ

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์อยู่ใน Bootloader ก่อนเวลาจะหมด

waitForDeviceBootloaderStateUpdate

public void waitForDeviceBootloaderStateUpdate ()

รอให้ระบบรีเฟรชสถานะ Bootloader ของอุปกรณ์

waitForDeviceFastbootd

public boolean waitForDeviceFastbootd (String fastbootPath, 
                long time)

รอให้อุปกรณ์อยู่ใน fastbootd

พารามิเตอร์
`fastbootPath`	`String`: เส้นทางของไบนารี fastboot ที่จะใช้
`time`	`long`: เวลาสูงสุดเป็นมิลลิวินาทีที่จะรอ

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์อยู่ใน fastbootd ก่อนเวลาจะหมด

waitForDeviceInRecovery

public IDevice waitForDeviceInRecovery ()

รอให้อุปกรณ์อยู่ในโหมดการกู้คืนโดยใช้การหมดเวลาการบูตมาตรฐาน

คิกรีเทิร์น
`IDevice`	`IDevice` หากอุปกรณ์เข้าสู่โหมดการกู้คืนก่อนเวลาหมดอายุ `null` มิฉะนั้น

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

รอให้อุปกรณ์อยู่ในสถานะ "การกู้คืน adb"

พารามิเตอร์
`waitTime`	`long`: เวลาสูงสุดเป็นมิลลิวินาทีที่จะรอ

คิกรีเทิร์น
`boolean`	เป็นจริงหากอุปกรณ์อยู่ในโหมดการกู้คืนก่อนหมดเวลา เป็นเท็จในกรณีอื่นๆ

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

รอให้อุปกรณ์อยู่ในสถานะ "adb sideload"

พารามิเตอร์
`waitTime`	`long`: เวลาสูงสุดเป็นมิลลิวินาทีที่จะรอ

คิกรีเทิร์น
`boolean`	เป็นจริงหากอุปกรณ์อยู่ในโหมดการโหลดแอปจากแหล่งที่ไม่รู้จักก่อนหมดเวลา มิเช่นนั้นจะเป็นเท็จ

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

รอให้อุปกรณ์ไม่พร้อมใช้งาน

พารามิเตอร์
`waitTime`	`long`: เวลาสูงสุดเป็นมิลลิวินาทีที่จะรอ

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์ไม่พร้อมใช้งาน

waitForDeviceOnline

public IDevice waitForDeviceOnline ()

รอให้อุปกรณ์ออนไลน์โดยใช้การหมดเวลาการบูตมาตรฐาน

หมายเหตุ: วิธีนี้จะแสดงผลเมื่ออุปกรณ์ปรากฏผ่าน DDMS ซึ่งไม่ได้รับประกันว่าอุปกรณ์จะตอบสนองต่อคำสั่ง adb จริงๆ ให้ใช้ waitForDeviceAvailable() แทน

คิกรีเทิร์น
`IDevice`	`IDevice` หากอุปกรณ์ออนไลน์ก่อนเวลาหมดอายุ `null` หรือไม่เช่นนั้น

waitForDeviceOnline

public IDevice waitForDeviceOnline (long waitTime)

รอให้อุปกรณ์ออนไลน์

พารามิเตอร์
`waitTime`	`long`: เวลาสูงสุดเป็นมิลลิวินาทีที่จะรอ

คิกรีเทิร์น
`IDevice`	`IDevice` หากอุปกรณ์ออนไลน์ก่อนเวลาหมดอายุ `null` หรือไม่เช่นนั้น

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

รอให้อุปกรณ์ตอบสนองต่อคำสั่ง adb shell พื้นฐาน

พารามิเตอร์
`waitTime`	`long`: เวลาที่รอเป็นมิลลิวินาที

คิกรีเทิร์น
`boolean`	`true` หากอุปกรณ์ตอบสนองก่อนที่ `waitTime` จะหมดเวลา

วิธีการที่ได้รับการป้องกัน

createOutputReceiver

protected CollectingOutputReceiver createOutputReceiver ()

เปิดให้ทดสอบ

คิกรีเทิร์น
`CollectingOutputReceiver`	`CollectingOutputReceiver`

getCheckPollTime

protected long getCheckPollTime ()

เปิดให้ทดสอบ

คิกรีเทิร์น
`long`

getCurrentTime

protected long getCurrentTime ()

เปิดให้ทดสอบ

คิกรีเทิร์น
`long`

getIDevice

protected IDevice getIDevice ()

คิกรีเทิร์น
`IDevice`	`IDevice` เชื่อมโยงกับจอภาพของรัฐ

postOnlineCheck

protected boolean postOnlineCheck (long waitTime)

การตรวจสอบเพิ่มเติมที่ต้องดำเนินการในอุปกรณ์ที่ออนไลน์

พารามิเตอร์
`waitTime`	`long`: เวลาเป็นมิลลิวินาทีที่จะรอจนกว่าจะยอมแพ้

คิกรีเทิร์น
`boolean`	`true` หากการตรวจสอบสำเร็จก่อนที่ waitTime จะหมดอายุ `false` มิฉะนั้น

การขว้าง
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForStoreMount

protected boolean waitForStoreMount (long waitTime)

รอให้อุปกรณ์ติดตั้งที่เก็บข้อมูลภายนอก

พารามิเตอร์
`waitTime`	`long`: เวลาเป็นมิลลิวินาทีที่จะรอจนกว่าจะยอมแพ้

คิกรีเทิร์น
`boolean`	`true` หากติดตั้งร้านค้าภายนอกก่อนที่ waitTime จะหมดอายุ `false` มิฉะนั้น

การขว้าง
`DeviceNotAvailableException`