ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

RemoteAndroidDevice

public class RemoteAndroidDevice
extends TestDevice

java.lang.Object
↳	com.android.tradefed.device.NativeDevice
	↳	com.android.tradefed.device.TestDevice
		↳	com.android.tradefed.device.RemoteAndroidDevice

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

LocalAndroidVirtualDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	คลาสสำหรับอุปกรณ์เสมือนในพื้นที่ที่ทำงานบนโฮสต์ TradeFed
RemoteAndroidVirtualDevice	ขยายลักษณะการทํางานของ `RemoteAndroidDevice` สําหรับอุปกรณ์ Android สแต็กแบบสมบูรณ์ที่ทํางานใน Google Compute Engine (GCE)

การติดตั้งใช้งาน ITestDevice สําหรับอุปกรณ์ Android แบบสแต็กเต็มรูปแบบที่เชื่อมต่อผ่าน adb connect สมมติว่าซีเรียลของอุปกรณ์จะอยู่ในรูปแบบ : ใน adb

สรุป

ค่าคงที่
`long`	`DEFAULT_SHORT_CMD_TIMEOUT`
`int`	`MAX_RETRIES`
`long`	`RETRY_INTERVAL_MS`
`long`	`WAIT_FOR_ADB_CONNECT`

ตัวสร้างแบบสาธารณะ
`RemoteAndroidDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` สร้าง `RemoteAndroidDevice`

เมธอดสาธารณะ
`boolean`	`adbTcpConnect(String host, String port)` เมธอดตัวช่วยสำหรับ adb เชื่อมต่อกับอุปกรณ์ Android ที่ใช้ TCP IP หนึ่งๆ
`boolean`	`adbTcpDisconnect(String host, String port)` เมธอดตัวช่วยสำหรับ adb เพื่อยกเลิกการเชื่อมต่อจากอุปกรณ์ Android ที่ใช้ TCP IP หนึ่งๆ
`static boolean`	`checkSerialFormatValid(String serialString)` ตรวจสอบว่ารูปแบบของซีเรียลเป็นไปตามที่คาดไว้ :port
`DeviceDescriptor`	`getDeviceDescriptor()`
`String`	`getHostName()` แสดงผลชื่อโฮสต์ที่เชื่อมโยงกับอุปกรณ์
`String`	`getMacAddress()`
`String`	`getPortNum()` แสดงผลหมายเลขพอร์ตที่เชื่อมโยงกับอุปกรณ์
`boolean`	`isEncryptionSupported()`
`void`	`postAdbRootAction()` ลบล้างหากอุปกรณ์ต้องดำเนินการบางอย่างหลังจากการรูท adb และก่อนที่อุปกรณ์จะกลับมาออนไลน์อีกครั้ง
`void`	`postAdbUnrootAction()` ลบล้างหากอุปกรณ์ต้องดำเนินการบางอย่างหลังจาก adb ยกเลิกการรูทและก่อนที่อุปกรณ์จะกลับมาออนไลน์อีกครั้ง
`void`	`postInvocationTearDown(Throwable exception)`
`void`	`recoverDevice()` พยายามกู้คืนการสื่อสารของอุปกรณ์
`void`	`setAdbLogFile(File adbLogFile)` ระบุไฟล์รับที่เราใช้จัดเก็บบันทึกการเชื่อมต่อ adb ทั้งหมดเพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่อง
`void`	`waitForAdbConnect(long waitTime)` ตรวจสอบว่าเปิดใช้การเชื่อมต่อ adb หรือไม่

วิธีการที่มีการป้องกัน
`String`	`getInitialIp()` แสดง IP ที่เชื่อมโยงครั้งแรกไปยังอุปกรณ์ หากมี
`String`	`getInitialSerial()` แสดงผลชื่อซีเรียลเริ่มต้นของอุปกรณ์
`void`	`postAdbReboot()` การดำเนินการเพิ่มเติมที่ทำได้หลังจากรีบูต

ค่าคงที่

DEFAULT_SHORT_CMD_TIMEOUT

protected static final long DEFAULT_SHORT_CMD_TIMEOUT

ค่าคงที่: 20000 (0x0000000000004e20)

MAX_RETRIES

protected static final int MAX_RETRIES

ค่าคงที่: 5 (0x00000005)

RETRY_INTERVAL_MS

protected static final long RETRY_INTERVAL_MS

ค่าคงที่: 5000 (0x0000000000001388)

WAIT_FOR_ADB_CONNECT

public static final long WAIT_FOR_ADB_CONNECT

ค่าคงที่: 120000 (0x000000000001d4c0)

ตัวสร้างแบบสาธารณะ

RemoteAndroidDevice

public RemoteAndroidDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

สร้าง RemoteAndroidDevice

พารามิเตอร์
`device`	`IDevice`: `IDevice` ที่เชื่อมโยง
`stateMonitor`	`IDeviceStateMonitor`: กลไก `IDeviceStateMonitor` ที่จะใช้
`allocationMonitor`	`IDeviceMonitor`: `IDeviceMonitor` เพื่อแจ้งให้ทราบถึงการเปลี่ยนแปลงสถานะการจัดสรร

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

adbTcpConnect

public boolean adbTcpConnect (String host, 
                String port)

เมธอดตัวช่วยสำหรับ adb เชื่อมต่อกับอุปกรณ์ Android ที่ใช้ TCP IP หนึ่งๆ

พารามิเตอร์
`host`	`String`: ชื่อโฮสต์/IP ของอุปกรณ์ Android ที่ใช้ TCP/IP
`port`	`String`: หมายเลขพอร์ตของอุปกรณ์ TCP/IP

คิกรีเทิร์น
`boolean`	จริง หากเชื่อมต่อกับอุปกรณ์สำเร็จ หรือเป็นเท็จ

adbTcpDisconnect

public boolean adbTcpDisconnect (String host, 
                String port)

เมธอดตัวช่วยสำหรับ adb เพื่อยกเลิกการเชื่อมต่อจากอุปกรณ์ Android ที่ใช้ TCP IP หนึ่งๆ

พารามิเตอร์
`host`	`String`: ชื่อโฮสต์/IP ของอุปกรณ์ Android ที่ใช้ TCP/IP
`port`	`String`: หมายเลขพอร์ตของอุปกรณ์ TCP/IP

คิกรีเทิร์น
`boolean`	จริงหากยกเลิกการเชื่อมต่อกับอุปกรณ์เรียบร้อยแล้ว หรือเป็นเท็จ

checkSerialFormatValid

public static boolean checkSerialFormatValid (String serialString)

ตรวจสอบว่ารูปแบบของซีเรียลเป็นไปตามที่คาดไว้ :port

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

คิกรีเทิร์น
`boolean`	จริงหากรูปแบบถูกต้อง เป็นเท็จหากรูปแบบไม่ถูกต้อง

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

getHostName

public String getHostName ()

แสดงผลชื่อโฮสต์ที่เชื่อมโยงกับอุปกรณ์ ดึงมาจากซีเรียล

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

getMacAddress

public String getMacAddress ()

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

getPortNum

public String getPortNum ()

แสดงผลหมายเลขพอร์ตที่เชื่อมโยงกับอุปกรณ์ ดึงมาจากซีเรียล

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

isEncryptionSupported

public boolean isEncryptionSupported ()

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

postAdbRootAction

public void postAdbRootAction ()

ลบล้างหากอุปกรณ์ต้องดำเนินการบางอย่างหลังจากการรูท adb และก่อนที่อุปกรณ์จะกลับมาออนไลน์อีกครั้ง การติดตั้งใช้งานเริ่มต้นจะไม่รวมการดำเนินการเพิ่มเติมใดๆ ไม่มีการรับประกันว่า adb root จะเปิดใช้ในขั้นตอนนี้

การโยน
`DeviceNotAvailableException`

postAdbUnrootAction

public void postAdbUnrootAction ()

ลบล้างหากอุปกรณ์ต้องดำเนินการบางอย่างหลังจาก adb ยกเลิกการรูทและก่อนที่อุปกรณ์จะกลับมาออนไลน์อีกครั้ง การติดตั้งใช้งานเริ่มต้นจะไม่รวมการดำเนินการเพิ่มเติมใดๆ เราไม่รับประกันว่าจะปิดใช้ adb root ในขั้นตอนนี้

การโยน
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

พารามิเตอร์
`exception`	`Throwable`

recoverDevice

public void recoverDevice ()

พยายามกู้คืนการสื่อสารของอุปกรณ์

การโยน
`DeviceNotAvailableException`

setAdbLogFile

public void setAdbLogFile (File adbLogFile)

ระบุไฟล์รับที่เราใช้จัดเก็บบันทึกการเชื่อมต่อ adb ทั้งหมดเพื่อวัตถุประสงค์ในการแก้ไขข้อบกพร่อง

พารามิเตอร์
`adbLogFile`	`File`

waitForAdbConnect

public void waitForAdbConnect (long waitTime)

ตรวจสอบว่าเปิดใช้การเชื่อมต่อ adb หรือไม่

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

การโยน
`DeviceNotAvailableException`

วิธีการที่มีการป้องกัน

getInitialIp

protected String getInitialIp ()

แสดง IP ที่เชื่อมโยงครั้งแรกไปยังอุปกรณ์ หากมี แสดงผล Null หากไม่มี IP เริ่มต้นที่ทราบ

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

getInitialSerial

protected String getInitialSerial ()

แสดงผลชื่อซีเรียลเริ่มต้นของอุปกรณ์

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

postAdbReboot

protected void postAdbReboot ()

การดำเนินการเพิ่มเติมที่ทำได้หลังจากรีบูต

การโยน
`DeviceNotAvailableException`