Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi 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

Các lớp con trực tiếp đã biết

LocalAndroidVirtualDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	Lớp cho các thiết bị ảo cục bộ chạy trên máy chủ TradeFed.
RemoteAndroidVirtualDevice	Mở rộng hành vi `RemoteAndroidDevice` cho một thiết bị Android toàn ngăn xếp chạy trong Google Compute Engine (Gce).

Triển khai ITestDevice cho một thiết bị Android có đầy đủ ngăn xếp được kết nối thông qua adb connect. Giả sử số sê-ri của thiết bị sẽ có định dạng : trong adb.

Tóm tắt

Hằng số
`long`	`DEFAULT_SHORT_CMD_TIMEOUT`
`int`	`MAX_RETRIES`
`long`	`RETRY_INTERVAL_MS`
`long`	`WAIT_FOR_ADB_CONNECT`

Hàm khởi tạo công khai
`RemoteAndroidDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` Tạo `RemoteAndroidDevice`.

Phương thức công khai
`boolean`	`adbTcpConnect(String host, String port)` Phương thức trợ giúp để adb kết nối với một thiết bị Android có địa chỉ IP tcp nhất định
`boolean`	`adbTcpDisconnect(String host, String port)` Phương thức trợ giúp để ngắt kết nối adb khỏi một thiết bị Android ip tcp nhất định
`static boolean`	`checkSerialFormatValid(String serialString)` Kiểm tra xem định dạng của tệp nối tiếp có đúng như dự kiến :port hay không
`DeviceDescriptor`	`getDeviceDescriptor()`
`String`	`getHostName()` Trả về tên máy chủ được liên kết với thiết bị.
`String`	`getMacAddress()`
`String`	`getPortNum()` Trả về số cổng liên kết với thiết bị.
`boolean`	`isEncryptionSupported()`
`void`	`postAdbRootAction()` Ghi đè nếu thiết bị cần thực hiện một số thao tác cụ thể sau khi thiết bị gốc adb và trước khi thiết bị kết nối lại với mạng.
`void`	`postAdbUnrootAction()` Ghi đè nếu thiết bị cần thực hiện một số thao tác cụ thể sau khi adb huỷ bỏ quyền truy cập gốc và trước khi thiết bị kết nối lại với mạng.
`void`	`postInvocationTearDown(Throwable exception)`
`void`	`recoverDevice()` Cố gắng khôi phục khả năng giao tiếp của thiết bị.
`void`	`setAdbLogFile(File adbLogFile)` Cung cấp một tệp receiver để chúng ta có thể lưu trữ tất cả nhật ký kết nối adb cho mục đích gỡ lỗi.
`void`	`waitForAdbConnect(long waitTime)` Kiểm tra xem bạn đã bật kết nối adb hay chưa.

Phương thức được bảo vệ
`String`	`getInitialIp()` Trả về địa chỉ IP được liên kết ban đầu cho thiết bị (nếu có).
`String`	`getInitialSerial()` Trả về tên sê-ri ban đầu của thiết bị.
`void`	`postAdbReboot()` Các hành động bổ sung có thể thực hiện sau khi khởi động lại.

Hằng số

DEFAULT_SHORT_CMD_TIMEOUT

protected static final long DEFAULT_SHORT_CMD_TIMEOUT

Giá trị không đổi: 20000 (0x0000000000004e20)

MAX_RETRIES

protected static final int MAX_RETRIES

Giá trị hằng số: 5 (0x00000005)

RETRY_INTERVAL_MS

protected static final long RETRY_INTERVAL_MS

Giá trị không đổi: 5000 (0x0000000000001388)

WAIT_FOR_ADB_CONNECT

public static final long WAIT_FOR_ADB_CONNECT

Giá trị không đổi: 120000 (0x000000000001d4c0)

Hàm khởi tạo công khai

RemoteAndroidDevice

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

Tạo RemoteAndroidDevice.

Tham số
`device`	`IDevice`: `IDevice` được liên kết
`stateMonitor`	`IDeviceStateMonitor`: cơ chế `IDeviceStateMonitor` cần sử dụng
`allocationMonitor`	`IDeviceMonitor`: `IDeviceMonitor` để thông báo về các thay đổi trạng thái phân bổ.

Phương thức công khai

adbTcpConnect

public boolean adbTcpConnect (String host, 
                String port)

Phương thức trợ giúp để adb kết nối với một thiết bị Android có địa chỉ IP tcp nhất định

Tham số
`host`	`String`: tên máy chủ/ip của thiết bị Android tcp/ip
`port`	`String`: số cổng của thiết bị tcp/ip

Giá trị trả về
`boolean`	true nếu chúng ta kết nối thành công với thiết bị, false nếu không.

adbTcpDisconnect

public boolean adbTcpDisconnect (String host, 
                String port)

Phương thức trợ giúp để ngắt kết nối adb khỏi một thiết bị Android ip tcp nhất định

Tham số
`host`	`String`: tên máy chủ/ip của thiết bị Android tcp/ip
`port`	`String`: số cổng của thiết bị tcp/ip

Giá trị trả về
`boolean`	true nếu chúng ta đã ngắt kết nối thành công với thiết bị, false nếu không.

checkSerialFormatValid

public static boolean checkSerialFormatValid (String serialString)

Kiểm tra xem định dạng của tệp nối tiếp có đúng như dự kiến :port hay không

Tham số
`serialString`	`String`

Giá trị trả về
`boolean`	true nếu định dạng hợp lệ, false nếu không hợp lệ.

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Giá trị trả về
`DeviceDescriptor`

getHostName

public String getHostName ()

Trả về tên máy chủ được liên kết với thiết bị. Được trích xuất từ tệp tuần tự.

Giá trị trả về
`String`

getMacAddress

public String getMacAddress ()

Giá trị trả về
`String`

getPortNum

public String getPortNum ()

Trả về số cổng liên kết với thiết bị. Được trích xuất từ tệp tuần tự.

Giá trị trả về
`String`

isEncryptionSupported

public boolean isEncryptionSupported ()

Giá trị trả về
`boolean`

postAdbRootAction

public void postAdbRootAction ()

Ghi đè nếu thiết bị cần thực hiện một số thao tác cụ thể sau khi thiết bị gốc adb và trước khi thiết bị kết nối lại với mạng. Phương thức triển khai mặc định không bao gồm bất kỳ hành động bổ sung nào. Không đảm bảo rằng quyền truy cập gốc adb sẽ được bật ở giai đoạn này.

Gửi
`DeviceNotAvailableException`

postAdbUnrootAction

public void postAdbUnrootAction ()

Ghi đè nếu thiết bị cần thực hiện một số thao tác cụ thể sau khi adb huỷ bỏ quyền truy cập gốc và trước khi thiết bị kết nối lại với mạng. Phương thức triển khai mặc định không bao gồm bất kỳ hành động bổ sung nào. Không đảm bảo rằng quyền truy cập gốc adb sẽ bị tắt ở giai đoạn này.

Gửi
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Tham số
`exception`	`Throwable`

recoverDevice

public void recoverDevice ()

Cố gắng khôi phục khả năng giao tiếp của thiết bị.

Gửi
`DeviceNotAvailableException`

setAdbLogFile

public void setAdbLogFile (File adbLogFile)

Cung cấp một tệp receiver để chúng ta có thể lưu trữ tất cả nhật ký kết nối adb cho mục đích gỡ lỗi.

Tham số
`adbLogFile`	`File`

waitForAdbConnect

public void waitForAdbConnect (long waitTime)

Kiểm tra xem bạn đã bật kết nối adb hay chưa.

Tham số
`waitTime`	`long`

Gửi
`DeviceNotAvailableException`

Phương thức được bảo vệ

getInitialIp

protected String getInitialIp ()

Trả về địa chỉ IP được liên kết ban đầu cho thiết bị (nếu có). Trả về giá trị rỗng nếu không có địa chỉ IP ban đầu nào được biết.

Giá trị trả về
`String`

getInitialSerial

protected String getInitialSerial ()

Trả về tên sê-ri ban đầu của thiết bị.

Giá trị trả về
`String`

postAdbReboot

protected void postAdbReboot ()

Các hành động bổ sung có thể thực hiện sau khi khởi động lại.

Gửi
`DeviceNotAvailableException`