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.

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

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

TestDevice

TestDevice Triển khai ITestDevice cho thiết bị Android toàn bộ ngăn xếp

Các lớp con gián tiếp đã biết

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	Lớp cho các thiết bị ảo cục bộ chạy trên máy chủ TradeFed.
ManagedRemoteDevice	Một thiết bị chạy bên trong máy ảo mà chúng tôi quản lý từ xa thông qua một thực thể Tradefed bên trong máy ảo.
NestedRemoteDevice	Hình ảnh đại diện cho thiết bị đang chạy bên trong máy ảo Cuttlefish từ xa.
RemoteAndroidDevice	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.
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).

Cách triển khai mặc định của ITestDevice Thiết bị Android không có ngăn xếp đầy đủ.

Tóm tắt

Lớp lồng ghép
`class`	`NativeDevice.AdbAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` để chạy lệnh "adb ...." của hệ điều hành.
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` để khởi động lại thiết bị.

Hằng số
`int`	`INVALID_USER_ID` Giá trị được trả về cho mọi mã nhận dạng người dùng không hợp lệ/không tìm thấy: UserHandle đã xác định giá trị -10000
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` số lần thử lại lệnh mặc định cần thực hiện

Trường
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

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

Phương thức công khai
`void`	`batchPrefetchStartupBuildProps()` Tối ưu hoá vi mô (khoảng 400 mili giây) bằng cách tải trước tất cả các thuộc tính chúng ta cần thay vì gọi "adb getprop" cho từng thuộc tính.
`boolean`	`canSwitchToHeadlessSystemUser()` Trả về kết quả cho biết liệu có được phép chuyển sang người dùng HỆ THỐNG không có giao diện người dùng hay không.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Kiểm tra xem một tính năng có được hỗ trợ hay không dựa trên cấp độ được hỗ trợ tối thiểu.
`boolean`	`checkConnectivity()` Kiểm tra để đảm bảo thiết bị có kết nối mạng.
`boolean`	`clearErrorDialogs()` Cố gắng đóng mọi hộp thoại lỗi hiện đang hiển thị trên giao diện người dùng của thiết bị.
`void`	`clearLastConnectedWifiNetwork()` Xoá mạng Wi-Fi đã kết nối gần đây nhất.
`void`	`clearLogcat()` Xoá mọi dữ liệu logcat tích luỹ.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Kết nối với mạng Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Kết nối với mạng Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Kết nối với mạng wifi.f
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Kết nối với mạng Wi-Fi.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` Một biến thể của `connectToWifiNetwork(String, String)` chỉ kết nối nếu thiết bị hiện không có kết nối mạng.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Một biến thể của `connectToWifiNetwork(String, String)` chỉ kết nối nếu thiết bị hiện không có kết nối mạng.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Tạo người dùng có tên và cờ đã cung cấp
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Tạo người dùng có tên và cờ đã cung cấp
`int`	`createUser(String name)` Tạo một người dùng có tên và cờ mặc định là 0.
`int`	`createUserNoThrow(String name)` Tạo một người dùng có tên và cờ mặc định là 0.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Kiểm tra một thiết bị và trả về thông tin chi tiết khi không có thiết bị nào.
`void`	`deleteFile(String deviceFilePath, int userId)` Phương thức trợ giúp để xoá tệp hoặc thư mục trên thiết bị.
`void`	`deleteFile(String deviceFilePath)` Phương thức trợ giúp để xoá tệp hoặc thư mục trên thiết bị.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Xoá `IDeviceActionReceiver` đã đăng ký.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại mềm hay không bằng cách so sánh system_server hiện tại với `ProcessInfo` system_server trước đó.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại mềm kể từ thời gian UTC kể từ thời gian bắt đầu của hệ thống từ thiết bị và `ERROR(/TimeUnit)` của thiết bị hay không.
`boolean`	`disableAdbRoot()` Tắt quyền truy cập thư mục gốc adb.
`void`	`disableKeyguard()` Tìm cách tắt khoá phím.
`boolean`	`disableNetworkMonitor()` Tắt tính năng giám sát mạng trên thiết bị.
`boolean`	`disconnectFromWifi()` Ngắt kết nối khỏi mạng Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Phương thức trợ giúp để xác định xem tệp trên thiết bị có tồn tại cho một người dùng cụ thể hay không.
`boolean`	`doesFileExist(String deviceFilePath)` Phương thức trợ giúp để xác định xem tệp trên thiết bị có tồn tại hay không.
`File`	`dumpHeap(String process, String devicePath)` Cố gắng kết xuất vùng nhớ khối xếp từ system_server.
`boolean`	`enableAdbRoot()` Bật quyền truy cập thư mục gốc adb.
`boolean`	`enableNetworkMonitor()` Bật tính năng giám sát mạng trên thiết bị.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` Phương thức trợ giúp thực thi lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Phương thức trợ giúp thực thi lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định.
`String`	`executeAdbCommand(String... cmdArgs)` Phương thức trợ giúp thực thi lệnh adb dưới dạng lệnh hệ thống.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Phương thức trợ giúp thực thi lệnh khởi động nhanh dưới dạng lệnh hệ thống với thời gian chờ mặc định là 2 phút.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` Phương thức trợ giúp thực thi lệnh khởi động nhanh dưới dạng lệnh hệ thống.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Phương thức trợ giúp thực thi lệnh khởi động nhanh chạy trong thời gian dài dưới dạng lệnh hệ thống.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Phương thức trợ giúp thực thi lệnh khởi động nhanh chạy trong thời gian dài dưới dạng lệnh hệ thống với các biến môi trường hệ thống.
`String`	`executeShellCommand(String command)` Phương thức trợ giúp thực thi lệnh shell adb và trả về kết quả dưới dạng `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Thực thi lệnh shell adb đã cho, thử lại nhiều lần nếu lệnh không thành công.
`CommandResult`	`executeShellV2Command(String cmd)` Phương thức trợ giúp thực thi lệnh shell adb và trả về kết quả dưới dạng `CommandResult` được điền chính xác bằng đầu ra trạng thái lệnh, stdout và stderr.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` Phương thức trợ giúp thực thi lệnh shell adb và trả về kết quả dưới dạng `CommandResult` được điền chính xác bằng đầu ra trạng thái lệnh và stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Phương thức trợ giúp thực thi lệnh shell adb và trả về kết quả dưới dạng `CommandResult` được điền chính xác bằng đầu ra trạng thái lệnh, stdout và stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
`CommandResult`	`fastbootWipePartition(String partition)` Phương thức trợ giúp xoá sạch một phân vùng cho thiết bị.
	`getActiveApexes()` Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị.
	`getAllSettings(String namespace)` Trả về các cặp khoá-giá trị của không gian tên được yêu cầu.
`DeviceAllocationState`	`getAllocationState()` Trả về trạng thái phân bổ hiện tại của thiết bị
`String`	`getAndroidId(int userId)` Tìm và trả về android-id được liên kết với một userId, rỗng nếu không tìm thấy.
	`getAndroidIds()` Tạo một Bản đồ gồm các mã nhận dạng Android khớp với mã nhận dạng người dùng.
`int`	`getApiLevel()` Lấy Cấp độ API của thiết bị.
`PackageInfo`	`getAppPackageInfo(String packageName)` Tìm nạp thông tin về một gói đã cài đặt trên thiết bị.
	`getAppPackageInfos()` Tìm nạp thông tin về các gói đã cài đặt trên thiết bị.
`String`	`getBasebandVersion()` Phương thức thuận tiện để lấy phiên bản băng tần cơ sở (vô tuyến) của thiết bị này.
`Integer`	`getBattery()` Trả về mức pin hiện tại của một thiết bị hoặc giá trị Rỗng nếu không có mức pin.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` Trả về giá trị boolean của thuộc tính đã cho.
	`getBootHistory()` Phương thức trợ giúp thu thập bản đồ nhật ký khởi động với thời gian khởi động và lý do khởi động.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` Phương thức trợ giúp thu thập bản đồ nhật ký khởi động với thời gian khởi động và lý do khởi động kể từ thời gian đã cho kể từ thời gian bắt đầu của thiết bị và đơn vị thời gian được chỉ định.
`String`	`getBootloaderVersion()` Phương thức thuận tiện để lấy phiên bản trình tải khởi động của thiết bị này.
`InputStreamSource`	`getBugreport()` Truy xuất báo cáo lỗi từ thiết bị.
`InputStreamSource`	`getBugreportz()` Truy xuất bugreportz từ thiết bị.
`String`	`getBuildAlias()` Truy xuất bí danh của bản dựng mà thiết bị hiện đang chạy.
`String`	`getBuildFlavor()` Truy xuất phiên bản bản dựng cho thiết bị.
`String`	`getBuildId()` Truy xuất bản dựng mà thiết bị đang chạy.
`String`	`getBuildSigningKeys()` Trả về loại khoá dùng để ký hình ảnh thiết bị Thông thường, các thiết bị Android có thể được ký bằng khoá kiểm thử (như trong AOSP) hoặc khoá phát hành (do các nhà sản xuất thiết bị riêng lẻ kiểm soát)
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Trả về `DeviceDescriptor` được lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không thì trả về `DeviceDescriptor` hiện tại.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Trả về `DeviceDescriptor` được lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không thì trả về `DeviceDescriptor` hiện tại.
`String[]`	`getChildren(String path)` Giải pháp thay thế cho việc sử dụng `IFileEntry` đôi khi sẽ không hoạt động do các quyền.
`AbstractConnection`	`getConnection()` Kết nối hiện tại được liên kết với thiết bị.
`ContentProviderHandler`	`getContentProvider(int userId)` Trả về `ContentProviderHandler` hoặc giá trị rỗng nếu không có.
`DeviceFoldableState`	`getCurrentFoldableState()` Trả về trạng thái gập hiện tại của thiết bị hoặc giá trị rỗng nếu có một số vấn đề xảy ra.
`int`	`getCurrentUser()` Trả về mã nhận dạng của người dùng đang chạy.
`String`	`getDeviceClass()` Lấy lớp thiết bị.
`long`	`getDeviceDate()` Trả về ngày của thiết bị theo mili giây kể từ thời gian bắt đầu của hệ thống.
`DeviceDescriptor`	`getDeviceDescriptor()` Trả về `DeviceDescriptor` từ thông tin thiết bị để lấy thông tin về thiết bị đó mà không cần truyền đối tượng thiết bị thực tế.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Trả về `DeviceDescriptor` từ thông tin thiết bị để lấy thông tin về thiết bị đó mà không cần truyền đối tượng thiết bị thực tế.
`TestDeviceState`	`getDeviceState()` Lấy trạng thái của thiết bị.
`long`	`getDeviceTimeOffset(Date date)` Trình trợ giúp để lấy chênh lệch thời gian giữa thiết bị và một `ERROR(/Date)` nhất định.
`InputStreamSource`	`getEmulatorOutput()` Lấy luồng stdout và stderr của trình mô phỏng
`Process`	`getEmulatorProcess()` Trả về `Process` tương ứng với trình mô phỏng này.
`final File`	`getExecuteShellCommandLog()` Nhật ký chứa tất cả nhật ký `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` Phương thức trợ giúp để xác định dung lượng trống trên bộ nhớ ngoài của thiết bị.
`String`	`getFastbootPath()` Trả về đường dẫn của tệp nhị phân fastboot đang được sử dụng.
`String`	`getFastbootProductType()` Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này khi thiết bị ở chế độ khởi động nhanh.
`String`	`getFastbootProductVariant()` Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này khi thiết bị ở chế độ khởi động nhanh.
`String`	`getFastbootSerialNumber()` Trả về số sê-ri của chế độ khởi động nhanh.
`String`	`getFastbootVariable(String variableName)` Truy xuất giá trị biến khởi động nhanh đã cho từ thiết bị.
`String`	`getFastbootVersion()` Trả về chuỗi phiên bản của tệp nhị phân fastboot đang được sử dụng.
`IFileEntry`	`getFileEntry(String path)` Truy xuất tệp tham chiếu đến tệp từ xa trên thiết bị.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Trình trợ giúp không chính thức để lấy `FileEntry` từ một đường dẫn không phải gốc.
	`getFoldableStates()` Trả về danh sách các trạng thái có thể gập lại trên thiết bị.
`IDevice`	`getIDevice()` Trả về một tệp tham chiếu đến `IDevice` ddmlib được liên kết.
	`getInstalledPackageNames()` Tìm nạp tên gói ứng dụng có trên thiết bị.
`long`	`getIntProperty(String name, long defaultValue)` Trả về giá trị số nguyên của thuộc tính đã cho từ thiết bị.
`String`	`getIpAddress()` Lấy địa chỉ IP của thiết bị.
`KeyguardControllerState`	`getKeyguardState()` Trả về một đối tượng để lấy trạng thái hiện tại của khoá bảo vệ hoặc giá trị rỗng nếu không được hỗ trợ.
`long`	`getLastExpectedRebootTimeMillis()` Trả về lần gần nhất API Tradefed kích hoạt quá trình khởi động lại tính bằng mili giây kể từ EPOCH do `System.currentTimeMillis()` trả về.
`int`	`getLaunchApiLevel()` Nhận Cấp độ API được khởi chạy đầu tiên của thiết bị.
`InputStreamSource`	`getLogcat()` Lấy luồng tổng quan nhanh của dữ liệu logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` Lấy luồng tổng quan nhanh của `maxBytes` dữ liệu logcat đã ghi lại gần đây nhất.
`InputStreamSource`	`getLogcatDump()` Tải tệp báo lỗi logcat hiện tại cho thiết bị.
`InputStreamSource`	`getLogcatSince(long date)` Lấy luồng tổng quan nhanh về dữ liệu logcat đã thu thập kể từ ngày được cung cấp.
`String`	`getMacAddress()` Trả về địa chỉ MAC của thiết bị, giá trị rỗng nếu không truy vấn được từ thiết bị.
`Integer`	`getMainUserId()` Trả về mã nhận dạng người dùng chính.
	`getMainlineModuleInfo()` Nhận thông tin về các mô-đun chính được cài đặt trên thiết bị.
`int`	`getMaxNumberOfRunningUsersSupported()` Lấy số lượng người dùng tối đa được hỗ trợ chạy đồng thời.
`int`	`getMaxNumberOfUsersSupported()` Nhận số lượng người dùng tối đa được hỗ trợ.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Trả về `IDeviceStateMonitor` liên kết với thiết bị.
`String`	`getMountPoint(String mountName)` Trả về một điểm gắn kết.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Trả về `MountPointInfo` tương ứng với đường dẫn điểm gắn được chỉ định hoặc `null` nếu đường dẫn đó không có gì được gắn hoặc không xuất hiện trong /proc/mounts dưới dạng điểm gắn.
	`getMountPointInfo()` Trả về phiên bản đã phân tích cú pháp của thông tin trong /proc/mounts trên thiết bị
`TestDeviceOptions`	`getOptions()` Tìm nạp các tuỳ chọn kiểm thử cho thiết bị.
`long`	`getPartitionFreeSpace(String partition)` Phương thức trợ giúp để xác định dung lượng trống trên phân vùng thiết bị.
`Integer`	`getPrimaryUserId()` Trả về mã nhận dạng người dùng chính.
`ProcessInfo`	`getProcessByName(String processName)` Phương thức trợ giúp chạy lệnh "pidof" và "stat", đồng thời trả về đối tượng `ProcessInfo` có PID và thời gian bắt đầu quy trình của quy trình đã cho.
`String`	`getProcessPid(String process)` Trả về pid của dịch vụ hoặc giá trị rỗng nếu có lỗi xảy ra.
`String`	`getProductType()` Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này.
`String`	`getProductVariant()` Phương thức thuận tiện để lấy biến thể sản phẩm của thiết bị này.
`String`	`getProperty(String name)` Truy xuất giá trị thuộc tính đã cho từ thiết bị.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Lấy chế độ khôi phục hiện tại được sử dụng cho thiết bị.
`InputStreamSource`	`getScreenshot(long displayId)` Lấy ảnh chụp màn hình từ thiết bị đã cho mã màn hình.
`InputStreamSource`	`getScreenshot(String format)` Chụp ảnh màn hình từ thiết bị.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Chụp ảnh màn hình từ thiết bị.
`InputStreamSource`	`getScreenshot()` Chụp ảnh màn hình từ thiết bị.
`String`	`getSerialNumber()` Phương thức thuận tiện để lấy số sê-ri của thiết bị này.
`String`	`getSetting(int userId, String namespace, String key)` Trả về giá trị của chế độ cài đặt được yêu cầu.
`String`	`getSetting(String namespace, String key)` Xem `getSetting(int, String, String)` và thực hiện trên người dùng hệ thống.
`String`	`getSimOperator()` Trả về nhà mạng của thẻ SIM hoặc giá trị rỗng nếu không có nhà mạng hoặc không có thiết bị.
`String`	`getSimState()` Trả về trạng thái thẻ SIM hoặc giá trị rỗng nếu không có thẻ SIM hoặc không có thiết bị.
	`getTombstones()` Tìm nạp và trả về danh sách bia mộ từ các thiết bị.
`long`	`getTotalMemory()` Trả về tổng dung lượng bộ nhớ vật lý tính bằng byte hoặc -1 trong trường hợp xảy ra lỗi nội bộ
`String`	`getTrackingSerial()` Để quản lý thiết bị, hãy lấy số sê-ri dùng để theo dõi thiết bị.
	`getUninstallablePackageNames()` Tìm nạp tên gói ứng dụng có thể gỡ cài đặt.
`boolean`	`getUseFastbootErase()` Xác định xem có sử dụng tính năng xoá fastboot hay định dạng fastboot để xoá một phân vùng trên thiết bị hay không.
`int`	`getUserFlags(int userId)` Tìm và trả về cờ của một người dùng cụ thể.
	`getUserInfos()` Lấy Bản đồ của useId đến `UserInfo` trên thiết bị.
`int`	`getUserSerialNumber(int userId)` Trả về số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong mọi trường hợp khác.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Xử lý DeviceEvent đã cho. Xử lý DeviceEvent, có thể chuyển đổi thiết bị này sang trạng thái phân bổ mới hoặc không.
`boolean`	`hasFeature(String feature)` Kiểm tra xem một tính năng có trên thiết bị hay không.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` Cài đặt gói Android trên thiết bị.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Cài đặt gói Android trên thiết bị.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` Cài đặt gói Android trên thiết bị cho một người dùng cụ thể.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Cài đặt gói Android trên thiết bị cho một người dùng cụ thể.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Kiểm tra xem nền tảng trên thiết bị có hỗ trợ liệt kê ứng dụng hay không
`boolean`	`isBypassLowTargetSdkBlockSupported()` Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc bỏ qua khối sdk mục tiêu thấp trên lượt cài đặt ứng dụng hay không
`boolean`	`isDebugfsMounted()` Kiểm tra xem debugfs có được gắn hay không.
`boolean`	`isDeviceEncrypted()` Trả về giá trị nếu thiết bị được mã hoá.
`boolean`	`isDirectory(String path)` Trả về True nếu đường dẫn trên thiết bị là một thư mục, trả về false nếu không phải là thư mục.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Trả về kết quả nếu thiết bị hỗ trợ tính năng mã hoá.
`boolean`	`isExecutable(String fullPath)` Trả về True nếu đường dẫn tệp trên thiết bị là tệp thực thi, ngược lại là false.
`boolean`	`isFastbootEnabled()` Trả về nếu thiết bị có chế độ khởi động nhanh.
`boolean`	`isHeadless()` Trả về true nếu thiết bị không có màn hình (không có màn hình), nếu không thì trả về false.
`boolean`	`isHeadlessSystemUserMode()` Trả về liệu thiết bị có sử dụng chế độ người dùng hệ thống không có giao diện người dùng hay không.
`boolean`	`isMainUserPermanentAdmin()` Trả về giá trị cho biết người dùng chính có phải là quản trị viên vĩnh viễn và không thể bị xoá hoặc hạ cấp xuống trạng thái không phải quản trị viên hay không.
`boolean`	`isMultiUserSupported()` Xác định xem chế độ nhiều người dùng có được hỗ trợ hay không.
`boolean`	`isPackageInstalled(String packageName, String userId)` Truy vấn thiết bị theo tên gói và mã nhận dạng người dùng nhất định để kiểm tra xem gói đó có đang được cài đặt cho người dùng đó hay không.
`boolean`	`isPackageInstalled(String packageName)` Truy vấn thiết bị theo tên gói nhất định để kiểm tra xem gói đó hiện đã được cài đặt hay chưa.
`boolean`	`isRuntimePermissionSupported()` Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc cấp quyền khi bắt đầu chạy hay không
`boolean`	`isStateBootloaderOrFastbootd()` Trả về true nếu thiết bị ở `TestDeviceState.FASTBOOT` hoặc `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` Kiểm tra xem một người dùng cụ thể có đang chạy hay không.
`boolean`	`isUserSecondary(int userId)` Trả về liệu người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của người dùng đó.
`boolean`	`isUserVisible(int userId)` Kiểm tra xem người dùng đã cho có hiển thị hay không.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Kiểm tra xem người dùng đã cho có hiển thị trong màn hình đã cho hay không.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Trả về thông tin về việc thiết bị có cho phép người dùng bắt đầu hiển thị ở chế độ nền trong `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` hay không.
`boolean`	`isVisibleBackgroundUsersSupported()` Trả về kết quả cho biết thiết bị có cho phép người dùng hiển thị ở chế độ nền hay không.
`boolean`	`isWifiEnabled()` Kiểm tra xem Wi-Fi đã bật hay chưa.
	`listDisplayIds()` Thu thập danh sách mã nhận dạng màn hình có sẵn trên thiết bị do "dumpsys SurfaceFlinger" báo cáo.
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Lấy danh sách màn hình có thể dùng để `start a user visible in the background`.
	`listUsers()` Lấy danh sách người dùng trên thiết bị.
`boolean`	`logAnrs(ITestLogger logger)` Thu thập và ghi nhật ký lỗi ANR từ thiết bị.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Phương thức trợ giúp để lấy báo cáo lỗi và ghi báo cáo đó vào trình báo cáo.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Ghi nhật ký một thông báo trong logcat của thiết bị.
`void`	`mountDebugfs()` Gắn debugfs.
`void`	`nonBlockingReboot()` Phát lệnh khởi động lại thiết bị và trả về khi lệnh hoàn tất cũng như khi thiết bị không còn hiển thị với adb.
`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`	`postBootSetup()` Thực hiện hướng dẫn để định cấu hình thiết bị cho việc kiểm thử sau mỗi lần khởi động.
`void`	`postInvocationTearDown(Throwable exception)` Các bước bổ sung để dọn dẹp bắt buộc theo thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Các bước bổ sung để thiết lập bắt buộc theo thiết bị sẽ được thực thi trên thiết bị trước khi thực hiện luồng gọi.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Kéo nội dung thư mục từ thiết bị theo cách đệ quy.
`boolean`	`pullDir(String deviceFilePath, File localDir)` Kéo nội dung thư mục từ thiết bị theo cách đệ quy.
`boolean`	`pullFile(String remoteFilePath, File localFile)` Truy xuất tệp trên thiết bị.
`File`	`pullFile(String remoteFilePath, int userId)` Truy xuất một tệp trên thiết bị, lưu trữ tệp đó trong `ERROR(/File)` tạm thời cục bộ và trả về `File` đó.
`File`	`pullFile(String remoteFilePath)` Truy xuất một tệp trên thiết bị, lưu trữ tệp đó trong `ERROR(/File)` tạm thời cục bộ và trả về `File` đó.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Truy xuất tệp trên thiết bị.
`String`	`pullFileContents(String remoteFilePath)` Truy xuất tệp trên thiết bị và trả về nội dung.
`File`	`pullFileFromExternal(String remoteFilePath)` Một phương thức thuận tiện để truy xuất tệp từ bộ nhớ ngoài của thiết bị, lưu trữ tệp đó trong một `ERROR(/File)` tạm thời cục bộ và trả về một tệp tham chiếu đến `File` đó.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Đẩy nội dung thư mục đến thiết bị theo đệ quy, đồng thời loại trừ một số thư mục được lọc.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` Đẩy nội dung thư mục đến thiết bị theo đệ quy.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Đẩy nội dung thư mục đến thiết bị theo đệ quy.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Biến thể của `pushFile(File, String)` có thể xem xét việc đánh giá nhu cầu của nhà cung cấp nội dung (không bắt buộc).
`boolean`	`pushFile(File localFile, String remoteFilePath)` Đẩy tệp vào thiết bị.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Đẩy tệp vào thiết bị.
`boolean`	`pushString(String contents, String remoteFilePath)` Đẩy tệp được tạo từ một chuỗi vào thiết bị
`void`	`reboot(String reason)` Khởi động lại thiết bị vào chế độ adb với `reason` đã cho để duy trì trong quá trình khởi động lại.
`void`	`reboot()` Khởi động lại thiết bị vào chế độ adb.
`void`	`rebootIntoBootloader()` Khởi động lại thiết bị ở chế độ trình tải khởi động.
`void`	`rebootIntoFastbootd()` Khởi động lại thiết bị ở chế độ fastbootd.
`void`	`rebootIntoRecovery()` Khởi động lại thiết bị ở chế độ khôi phục adb.
`void`	`rebootIntoSideload()` Khởi động lại thiết bị vào chế độ cài đặt không qua cửa hàng của ADB (lưu ý đây là chế độ đặc biệt trong quá trình khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ tải không qua cửa hàng
`void`	`rebootIntoSideload(boolean autoReboot)` Khởi động lại thiết bị vào chế độ cài đặt không qua cửa hàng của ADB (lưu ý đây là chế độ đặc biệt trong quá trình khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ tải không qua cửa hàng
`void`	`rebootUntilOnline()` Một phương án thay thế cho `reboot()` chỉ chặn cho đến khi thiết bị có kết nối mạng, tức là hiển thị với adb.
`void`	`rebootUntilOnline(String reason)` Một phương án thay thế cho `reboot()` chỉ chặn cho đến khi thiết bị có kết nối mạng, tức là hiển thị với adb.
`void`	`rebootUserspace()` Chỉ khởi động lại phần không gian người dùng của thiết bị.
`void`	`rebootUserspaceUntilOnline()` Một phương án thay thế cho `rebootUserspace()` ()} chỉ chặn cho đến khi thiết bị có kết nối mạng, tức là hiển thị với adb.
`boolean`	`recoverDevice()` Cố gắng khôi phục khả năng giao tiếp của thiết bị.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Đăng ký `IDeviceActionReceiver` cho thiết bị này.
`void`	`remountSystemReadOnly()` Đặt phân vùng hệ thống trên thiết bị ở chế độ chỉ có thể đọc.
`void`	`remountSystemWritable()` Đặt phân vùng hệ thống trên thiết bị ở chế độ có thể ghi.
`void`	`remountVendorReadOnly()` Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ chỉ có thể đọc.
`void`	`remountVendorWritable()` Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ ghi.
`boolean`	`removeAdmin(String componentName, int userId)` Xoá quản trị viên thiết bị đã cho trong người dùng đã cho và trả về `true` nếu thành công, `false` nếu không.
`void`	`removeOwners()` Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có một cách hiệu quả nhất.
`boolean`	`removeUser(int userId)` Xoá một người dùng nhất định khỏi thiết bị.
`void`	`resetContentProviderSetup()` Đặt lại cờ cho chế độ thiết lập nhà cung cấp nội dung để kích hoạt lại chế độ này.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Phương thức thuận tiện để thực hiện `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` với một hoặc nhiều trình nghe được truyền dưới dạng tham số.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Chạy kiểm thử đo lường và khôi phục thiết bị.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` Tương tự như `ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))` nhưng chạy kiểm thử cho người dùng đã cho.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Tương tự như `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)` nhưng chạy kiểm thử cho một người dùng cụ thể.
`void`	`setConfiguration(IConfiguration configuration)` Chèn `IConfiguration` đang sử dụng.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Đặt ngày trên thiết bị Lưu ý: bạn cần can thiệp vào hệ thống để đặt ngày trên thiết bị
`boolean`	`setDeviceOwner(String componentName, int userId)` Đặt thành phần quản trị thiết bị làm chủ sở hữu thiết bị trong người dùng đã cho.
`void`	`setDeviceState(TestDeviceState deviceState)` Cập nhật trạng thái của thiết bị.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Đối với trình mô phỏng, hãy đặt `SizeLimitedOutputStream` để ghi nhật ký đầu ra
`void`	`setEmulatorProcess(Process p)` Đặt `Process` khi thiết bị này là trình mô phỏng.
`void`	`setFastbootEnabled(boolean fastbootEnabled)` Đặt tuỳ chọn khởi động nhanh cho thiết bị.
`void`	`setFastbootPath(String fastbootPath)` Đặt đường dẫn đến tệp nhị phân fastboot cần sử dụng.
`void`	`setIDevice(IDevice newDevice)` Cập nhật IDevice liên kết với ITestDevice này.
`void`	`setLogStartDelay(int delay)` Đặt thời gian chờ tính bằng mili giây trước khi bắt đầu ghi logcat cho một thiết bị trực tuyến.
`void`	`setOptions(TestDeviceOptions options)` Đặt `TestDeviceOptions` cho thiết bị
`boolean`	`setProperty(String propKey, String propValue)` Đặt giá trị thuộc tính đã cho trên thiết bị.
`void`	`setRecovery(IDeviceRecovery recovery)` Đặt `IDeviceRecovery` để sử dụng cho thiết bị này.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Đặt chế độ khôi phục hiện tại để sử dụng cho thiết bị.
`void`	`setSetting(String namespace, String key, String value)` Xem `setSetting(int, String, String, String)` và thực hiện trên người dùng hệ thống.
`void`	`setSetting(int userId, String namespace, String key, String value)` Thêm giá trị cài đặt vào không gian tên của một người dùng cụ thể.
`void`	`setTestLogger(ITestLogger testLogger)` Chèn thực thể `ITestLogger`
`void`	`setTrackingSerial(String trackingSerial)` Để quản lý thiết bị, hãy theo dõi số sê-ri mà chúng tôi sử dụng để tham chiếu đến thiết bị.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Đặt chế độ sử dụng tính năng xoá nhanh qua fastboot hoặc định dạng nhanh qua fastboot để xoá một phân vùng trên thiết bị.
`void`	`startLogcat()` Bắt đầu ghi lại đầu ra logcat từ thiết bị ở chế độ nền.
`boolean`	`startTradeInModeTesting(int timeoutMs)` Bật chế độ thử nghiệm bán đổi.
`boolean`	`startUser(int userId)` Bắt đầu một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang bị dừng.
`boolean`	`startUser(int userId, boolean waitFlag)` Bắt đầu một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang bị dừng.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Bắt đầu một người dùng nhất định ở chế độ nền, hiển thị trong màn hình nhất định (tức là cho phép người dùng chạy các hoạt động trong màn hình đó).
`void`	`stopEmulatorOutput()` Đóng và xoá đầu ra của trình mô phỏng.
`void`	`stopLogcat()` Dừng ghi lại đầu ra logcat từ thiết bị và loại bỏ dữ liệu logcat hiện đã lưu.
`void`	`stopTradeInModeTesting()` Dừng thử nghiệm chế độ đổi cũ lấy mới.
`boolean`	`stopUser(int userId)` Dừng một người dùng cụ thể.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Dừng một người dùng cụ thể.
`String`	`switchToAdbTcp()` Chuyển thiết bị sang chế độ adb-over-tcp.
`boolean`	`switchToAdbUsb()` Chuyển thiết bị sang chế độ adb qua USB.
`boolean`	`switchUser(int userId)` Chuyển sang một userId khác có thời gian chờ mặc định.
`boolean`	`switchUser(int userId, long timeout)` Chuyển sang một userId khác với thời gian chờ được cung cấp làm thời hạn.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Tăng dần nội dung của thư mục tệp cục bộ với thiết bị.
`Bugreport`	`takeBugreport()` Lấy một báo cáo lỗi và trả về báo cáo đó bên trong đối tượng `Bugreport` để xử lý.
`String`	`uninstallPackage(String packageName)` Gỡ cài đặt gói Android khỏi thiết bị.
`String`	`uninstallPackageForUser(String packageName, int userId)` Gỡ cài đặt một gói Android khỏi thiết bị cho một người dùng cụ thể.
`boolean`	`unlockDevice()` Mở khoá thiết bị nếu thiết bị đang ở trạng thái mã hoá.
`void`	`unmountDebugfs()` Huỷ kết nối debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Chặn cho đến khi thiết lập cờ hoàn tất khởi động của thiết bị.
`boolean`	`waitForDeviceAvailable()` Chờ thiết bị phản hồi và có thể kiểm thử.
`boolean`	`waitForDeviceAvailable(long waitTime)` Chờ thiết bị phản hồi và có thể kiểm thử.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Chờ thiết bị phản hồi và có sẵn mà không xem xét đường dẫn khôi phục.
`void`	`waitForDeviceBootloader()` Chặn cho đến khi thiết bị hiển thị qua tính năng khởi động nhanh.
`boolean`	`waitForDeviceInRecovery(long waitTime)` Chặn thiết bị ở trạng thái "adb recovery" (hãy lưu ý rằng trạng thái này khác với `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Chặn thiết bị ở trạng thái "adb sideload"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Các khối để thiết bị không có sẵn, tức là bị thiếu trong adb
`void`	`waitForDeviceOnline()` Chặn cho đến khi thiết bị hiển thị thông qua adb.
`void`	`waitForDeviceOnline(long waitTime)` Chặn cho đến khi thiết bị hiển thị thông qua adb.
`boolean`	`waitForDeviceShell(long waitTime)` Chờ thiết bị phản hồi lệnh shell adb cơ bản.

Phương thức được bảo vệ
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Tạo lệnh hệ điều hành cho phiên lệnh shell adb và args đã cho
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Tạo `RebootDeviceAction` để sử dụng khi thực hiện thao tác khởi động lại.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Khởi động lại adb.
`void`	`ensureRuntimePermissionSupported()` phương thức trợ giúp để gửi ngoại lệ nếu không hỗ trợ quyền khi bắt đầu chạy
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Lấy thực thể `RunUtil` để sử dụng.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Tìm nạp một thuộc tính thiết bị, từ bộ nhớ đệm ddmlib theo mặc định và quay lại `adb shell getprop` hoặc `fastboot getvar` tuỳ thuộc vào việc thiết bị có ở chế độ Khởi động nhanh hay không.
`boolean`	`isInRebootCallback()` Trả về thông tin về việc lệnh gọi lại khởi động lại có đang được thực thi hay không.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Trả về `true` nếu tệp cục bộ mới hơn tệp từ xa.
`void`	`notifyRebootEnded()` Thông báo cho tất cả `IDeviceActionReceiver` về sự kiện kết thúc khởi động lại.
`void`	`notifyRebootStarted()` Thông báo cho tất cả `IDeviceActionReceiver` về sự kiện bắt đầu khởi động lại.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Thực hiện một hành động trên thiết bị này.
`void`	`postAdbReboot()` Các hành động bổ sung có thể thực hiện sau khi khởi động lại.
`void`	`prePostBootSetup()` Cho phép mỗi loại thiết bị (AndroidNativeDevice, TestDevice) ghi đè phương thức này để thiết lập cụ thể sau khi khởi động.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Đặt thực thể Đồng hồ để sử dụng.
`void`	`setMicrodroidProcess(Process process)` Đánh dấu TestDevice là microdroid và đặt CID của thiết bị.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` Thực thi một lệnh khởi động nhanh đơn giản với các biến môi trường và báo cáo trạng thái của lệnh.
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` Thực thi một lệnh khởi động nhanh đơn giản và báo cáo trạng thái của lệnh.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Chờ thiết bị không hoạt động (ngừng báo cáo cho adb).

Hằng số

INVALID_USER_ID

public static final int INVALID_USER_ID

Giá trị được trả về cho mọi mã nhận dạng người dùng không hợp lệ/không tìm thấy: UserHandle đã xác định giá trị -10000

Giá trị hằng số: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

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

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

số lần thử lại lệnh mặc định cần thực hiện

Giá trị không đổi: 2 (0x00000002)

Trường

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

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

NativeDevice

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

Tạo TestDevice.

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ổ. Có thể là giá trị rỗng

Phương thức công khai

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Tối ưu hoá vi mô (khoảng 400 mili giây) bằng cách tìm nạp trước tất cả các thuộc tính mà chúng ta cần thay vì gọi "adb getprop" cho từng thuộc tính. Tức là việc tìm nạp tất cả các thuộc tính cũng nhanh như việc tìm nạp một thuộc tính. Các tính năng như device.getApiLevel(), checkApiLevelAgainstNextRelease và getBuildAlias đều gọi `adb getprop` trong phần phụ trợ. Chúng ta tìm nạp các thuộc tính này trong một lệnh gọi và gọi NativeDevice.setProperty. Ngay cả khi chúng ta không làm việc này, NativeDevice sẽ tự gọi setProperty và lưu kết quả vào bộ nhớ đệm cho các lệnh gọi trong tương lai. Chúng tôi chỉ thực hiện sớm hơn một chút. Nếu thiết bị đang khôi phục hoặc có lỗi khác khi tìm nạp các thành phần, chúng ta chỉ cần bỏ qua các lỗi đó.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Trả về kết quả cho biết liệu có được phép chuyển sang người dùng HỆ THỐNG không có giao diện người dùng hay không.

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Kiểm tra xem một tính năng có được hỗ trợ hay không dựa trên cấp độ được hỗ trợ tối thiểu. Phương thức này tính đến các tính năng chưa phát hành trước khi tăng cấp độ API.

Tham số
`strictMinLevel`	`int`: Cấp độ tối thiểu nghiêm ngặt nhất có thể hỗ trợ tính năng này.

Giá trị trả về
`boolean`	Đúng nếu cấp được hỗ trợ. Nếu không thì giá trị sẽ là false.

Gửi
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

Kiểm tra để đảm bảo thiết bị có kết nối mạng.

Giá trị trả về
`boolean`	`true` nếu thiết bị có kết nối mạng đang hoạt động, `false` nếu không.

Gửi
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

Cố gắng đóng mọi hộp thoại lỗi hiện đang hiển thị trên giao diện người dùng của thiết bị.

Giá trị trả về
`boolean`	`true` nếu không có hộp thoại nào hoặc hộp thoại đã được xoá thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Xoá mạng Wi-Fi đã kết nối gần đây nhất. Bạn nên gọi phương thức này khi bắt đầu một lệnh gọi mới để tránh kết nối với mạng Wi-Fi được dùng trong lần kiểm thử trước sau khi thiết bị khởi động lại.

clearLogcat

public void clearLogcat ()

Xoá mọi dữ liệu logcat tích luỹ.

Điều này hữu ích trong trường hợp bạn muốn đảm bảo ITestDevice.getLogcat() chỉ trả về dữ liệu nhật ký được tạo sau một thời điểm nhất định (chẳng hạn như sau khi cài đặt ROM cho bản dựng thiết bị mới, v.v.).

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Kết nối với mạng Wi-Fi.

Bật wifi và chặn cho đến khi kết nối thành công với một trong các mạng wifi được cung cấp trong bản đồ wifiSsidToPsk. Sau khi kết nối, thực thể sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.

Tham số
`wifiSsidToPsk`	: Bản đồ ánh xạ SSID wifi với mật khẩu.
`scanSsid`	`boolean`: liệu có quét tìm SSID ẩn cho mạng này hay không.

Giá trị trả về
`boolean`	`true` nếu kết nối thành công với mạng Wi-Fi. `false` nếu không

Gửi
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Kết nối với mạng Wi-Fi.

Bật wifi và chặn cho đến khi kết nối thành công với mạng wifi đã chỉ định. Sau khi kết nối, thực thể sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.

Tham số
`wifiSsid`	`String`: ssid wifi cần kết nối
`wifiPsk`	`String`: Cụm mật khẩu PSK hoặc giá trị rỗng nếu không được mã hoá

Giá trị trả về
`boolean`	`true` nếu kết nối thành công với mạng Wi-Fi. `false` nếu không

Gửi
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Kết nối với mạng Wi-Fi.

Tham số
`wifiSsidToPsk`	: Bản đồ ánh xạ SSID wifi với mật khẩu.

Giá trị trả về
`boolean`	`true` nếu kết nối thành công với mạng Wi-Fi. `false` nếu không

Gửi
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Kết nối với mạng Wi-Fi.

Tham số
`wifiSsid`	`String`: ssid wifi cần kết nối
`wifiPsk`	`String`: Cụm mật khẩu PSK hoặc giá trị rỗng nếu không được mã hoá
`scanSsid`	`boolean`: liệu có quét tìm SSID ẩn cho mạng này hay không.

Giá trị trả về
`boolean`	`true` nếu kết nối thành công với mạng Wi-Fi. `false` nếu không

Gửi
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Một biến thể của connectToWifiNetwork(String, String) chỉ kết nối nếu thiết bị hiện không có kết nối mạng.

Tham số
`scanSsid`	`boolean`: liệu có quét tìm SSID ẩn cho mạng này hay không

Giá trị trả về
`boolean`	`true` nếu kết nối thành công với mạng Wi-Fi. `false` nếu không

Gửi
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Một biến thể của connectToWifiNetwork(String, String) chỉ kết nối nếu thiết bị hiện không có kết nối mạng.

Giá trị trả về
`boolean`	`true` nếu kết nối thành công với mạng Wi-Fi. `false` nếu không

Gửi
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Tạo người dùng có tên và cờ đã cung cấp

Tham số
`name`	`String`: của người dùng để tạo trên thiết bị
`guest`	`boolean`: bật cờ người dùng --guest trong quá trình tạo
`ephemeral`	`boolean`: bật cờ người dùng --ephemeral trong quá trình tạo

Giá trị trả về
`int`	mã nhận dạng của người dùng đã tạo

Gửi
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Tạo người dùng có tên và cờ đã cung cấp

Tham số
`name`	`String`: của người dùng để tạo trên thiết bị
`guest`	`boolean`: bật cờ người dùng --guest trong quá trình tạo
`ephemeral`	`boolean`: bật cờ người dùng --ephemeral trong quá trình tạo
`forTesting`	`boolean`: bật cờ kiểm thử --for-testing trong quá trình tạo

Giá trị trả về
`int`	mã nhận dạng của người dùng đã tạo

Gửi
`DeviceNotAvailableException`

createUser

public int createUser (String name)

Tạo một người dùng có tên và cờ mặc định là 0.

Tham số
`name`	`String`: của người dùng để tạo trên thiết bị

Giá trị trả về
`int`	số nguyên cho mã nhận dạng người dùng đã tạo

Gửi
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

Tạo một người dùng có tên và cờ mặc định là 0.

Tham số
`name`	`String`: của người dùng để tạo trên thiết bị

Giá trị trả về
`int`	số nguyên cho mã nhận dạng người dùng đã tạo hoặc -1 cho lỗi.

Gửi
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Kiểm tra một thiết bị và trả về thông tin chi tiết khi không có thiết bị nào.

Giá trị trả về
`DeviceInspectionResult`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

Phương thức trợ giúp để xoá tệp hoặc thư mục trên thiết bị.

Tham số
`deviceFilePath`	`String`: Đường dẫn tuyệt đối của tệp trên thiết bị.
`userId`	`int`: Mã nhận dạng người dùng cần xoá khỏi

Gửi
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

Phương thức trợ giúp để xoá tệp hoặc thư mục trên thiết bị.

Tham số
`deviceFilePath`	`String`: Đường dẫn tuyệt đối của tệp trên thiết bị.

Gửi
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Xoá IDeviceActionReceiver đã đăng ký.

Tham số
`deviceActionReceiver`	`IDeviceActionReceiver`: Một `IDeviceActionReceiver` sẽ bị xoá.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại mềm hay không bằng cách so sánh system_server hiện tại với ProcessInfo system_server trước đó. Sử dụng getProcessByName(String) để nhận ProcessInfo.

Tham số
`prevSystemServerProcess`	`ProcessInfo`: quy trình system_server trước đó `ProcessInfo`.

Giá trị trả về
`boolean`	`true` nếu thiết bị khởi động lại mềm

Gửi
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại mềm kể từ thời gian UTC kể từ thời gian bắt đầu của hệ thống từ thiết bị và ERROR(/TimeUnit) của thiết bị hay không. Khởi động lại mềm đề cập đến việc system_server khởi động lại bên ngoài quá trình khởi động lại cứng của thiết bị (ví dụ: khởi động lại theo yêu cầu). Bạn có thể lấy utcEpochTime của thiết bị hiện tại theo đơn vị mili giây bằng phương thức getDeviceDate().

Tham số
`utcEpochTime`	`long`: thời gian thiết bị tính bằng giây kể từ thời gian bắt đầu của hệ thống.
`timeUnit`	`TimeUnit`: đơn vị thời gian `TimeUnit` cho utcEpochTime đã cho.

Giá trị trả về
`boolean`	`true` nếu thiết bị khởi động lại mềm

Gửi
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

Tắt quyền truy cập thư mục gốc adb.

Việc tắt quyền truy cập gốc adb có thể khiến thiết bị ngắt kết nối khỏi adb. Phương thức này sẽ chặn cho đến khi thiết bị có sẵn.

Giá trị trả về
`boolean`	`true` nếu thành công.

Gửi
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Tìm cách tắt khoá phím.

Trước tiên, hãy đợi quá trình điều phối đầu vào sẵn sàng, việc này xảy ra cùng lúc khi thiết bị báo cáo BOOT_COMPLETE, rõ ràng là không đồng bộ, vì việc triển khai khung hiện tại thỉnh thoảng có tình trạng tương tranh. Sau đó, lệnh sẽ được gửi để đóng khoá phím (chỉ hoạt động trên các khoá phím không bảo mật)

Gửi
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Tắt tính năng giám sát mạng trên thiết bị.

Giá trị trả về
`boolean`	`true` nếu bạn tắt thành công tính năng giám sát. `false` nếu không thành công.

Gửi
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

Ngắt kết nối khỏi mạng Wi-Fi.

Xoá tất cả mạng khỏi danh sách mạng đã biết và tắt Wi-Fi.

Giá trị trả về
`boolean`	`true` nếu đã ngắt kết nối thành công khỏi mạng Wi-Fi. `false` nếu không ngắt kết nối được.

Gửi
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Phương thức trợ giúp để xác định xem tệp trên thiết bị có tồn tại cho một người dùng cụ thể hay không.

Tham số
`deviceFilePath`	`String`: đường dẫn tuyệt đối của tệp trên thiết bị cần kiểm tra
`userId`	`int`: Mã nhận dạng người dùng để kiểm tra xem tệp có tồn tại hay không

Giá trị trả về
`boolean`	`true` nếu tệp tồn tại, `false` nếu không.

Gửi
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Phương thức trợ giúp để xác định xem tệp trên thiết bị có tồn tại hay không.

Tham số
`deviceFilePath`	`String`: đường dẫn tuyệt đối của tệp trên thiết bị cần kiểm tra

Giá trị trả về
`boolean`	`true` nếu tệp tồn tại, `false` nếu không.

Gửi
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Cố gắng kết xuất vùng nhớ khối xếp từ system_server. Phương thức gọi có trách nhiệm dọn dẹp tệp đã kết xuất.

Tham số
`process`	`String`: tên của quy trình thiết bị để kết xuất.
`devicePath`	`String`: đường dẫn trên thiết bị để đặt tệp kết xuất. Đây phải là vị trí mà bạn có quyền truy cập.

Giá trị trả về
`File`	`ERROR(/File)` chứa báo cáo. Rỗng nếu có lỗi.

Gửi
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

Bật quyền truy cập thư mục gốc adb. Nếu chế độ cài đặt "enable-root" là "false", thì sẽ ghi lại thông báo và trả về mà không bật quyền truy cập thư mục gốc.

Việc bật thư mục gốc adb có thể khiến thiết bị ngắt kết nối khỏi adb. Phương thức này sẽ chặn cho đến khi thiết bị có sẵn.

Giá trị trả về
`boolean`	`true` nếu thành công.

Gửi
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Bật tính năng giám sát mạng trên thiết bị.

Giá trị trả về
`boolean`	`true` nếu bạn bật thành công tính năng giám sát. `false` nếu không thành công.

Gửi
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

Phương thức trợ giúp thực thi lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định.

Bạn nên sử dụng executeShellCommand(String) bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và mang lại hiệu suất tốt hơn.

Tham số
`timeout`	`long`: thời gian tính bằng mili giây trước khi thiết bị được coi là không phản hồi, 0L nếu không có thời gian chờ
`cmdArgs`	`String`: lệnh adb và đối số để chạy

Giá trị trả về
`String`	stdout từ lệnh. `null` nếu không thực thi được lệnh.

Gửi
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

Phương thức trợ giúp thực thi lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định.

Bạn nên sử dụng executeShellCommand(String) bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và mang lại hiệu suất tốt hơn.

Tham số
`timeout`	`long`: thời gian tính bằng mili giây trước khi thiết bị được coi là không phản hồi, 0L nếu không có thời gian chờ
`envMap`	: môi trường cần đặt cho lệnh
`cmdArgs`	`String`: lệnh adb và đối số để chạy

Giá trị trả về
`String`	stdout từ lệnh. `null` nếu không thực thi được lệnh.

Gửi
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

Phương thức trợ giúp thực thi lệnh adb dưới dạng lệnh hệ thống.

Bạn nên sử dụng executeShellCommand(String) bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và mang lại hiệu suất tốt hơn.

Tham số
`cmdArgs`	`String`: lệnh adb và đối số để chạy

Giá trị trả về
`String`	stdout từ lệnh. `null` nếu không thực thi được lệnh.

Gửi
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

Phương thức trợ giúp thực thi lệnh khởi động nhanh dưới dạng lệnh hệ thống với thời gian chờ mặc định là 2 phút.

Dự kiến sẽ được sử dụng khi thiết bị đã ở chế độ khởi động nhanh.

Tham số
`cmdArgs`	`String`: lệnh khởi động nhanh và các đối số để chạy

Giá trị trả về
`CommandResult`	CommandResult chứa kết quả của lệnh

Gửi
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

Phương thức trợ giúp thực thi lệnh khởi động nhanh dưới dạng lệnh hệ thống.

Dự kiến sẽ được sử dụng khi thiết bị đã ở chế độ khởi động nhanh.

Tham số
`timeout`	`long`: thời gian tính bằng mili giây trước khi lệnh hết hạn
`cmdArgs`	`String`: lệnh khởi động nhanh và các đối số để chạy

Giá trị trả về
`CommandResult`	CommandResult chứa kết quả của lệnh

Gửi
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

Phương thức trợ giúp thực thi lệnh khởi động nhanh chạy trong thời gian dài dưới dạng lệnh hệ thống.

Giống với executeFastbootCommand(String), ngoại trừ việc sử dụng thời gian chờ lâu hơn.

Tham số
`cmdArgs`	`String`: lệnh khởi động nhanh và các đối số để chạy

Giá trị trả về
`CommandResult`	CommandResult chứa kết quả của lệnh

Gửi
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

Phương thức trợ giúp thực thi lệnh khởi động nhanh chạy trong thời gian dài dưới dạng lệnh hệ thống với các biến môi trường hệ thống.

Giống với executeFastbootCommand(String), ngoại trừ việc sử dụng thời gian chờ lâu hơn.

Tham số
`envVarMap`	: các biến môi trường hệ thống mà lệnh khởi động nhanh chạy cùng
`cmdArgs`	`String`: lệnh khởi động nhanh và các đối số để chạy

Giá trị trả về
`CommandResult`	CommandResult chứa kết quả của lệnh

Gửi
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

Phương thức trợ giúp thực thi lệnh shell adb và trả về kết quả dưới dạng String.

Tham số
`command`	`String`: lệnh shell adb để chạy

Giá trị trả về
`String`	đầu ra của shell

Gửi
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.

Tham số
`command`	`String`: lệnh shell adb để chạy
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` để chuyển hướng đầu ra của shell đến.
`maxTimeToOutputShellResponse`	`long`: khoảng thời gian tối đa mà lệnh được phép không đưa ra phản hồi nào; đơn vị như được chỉ định trong `timeUnit`
`timeUnit`	`TimeUnit`: đơn vị cho `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: số lần thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu `retryAttempts` không được thực hiện thành công.

Gửi
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.

Tham số
`command`	`String`: lệnh shell adb để chạy
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` để chuyển hướng đầu ra của shell đến.
`maxTimeoutForCommand`	`long`: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong `timeUnit`
`maxTimeToOutputShellResponse`	`long`: khoảng thời gian tối đa mà lệnh được phép không đưa ra phản hồi nào; đơn vị như được chỉ định trong `timeUnit`
`timeUnit`	`TimeUnit`: đơn vị cho `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: số lần thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu `retryAttempts` không được thực hiện thành công.

Gửi
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Thực thi lệnh shell adb đã cho, thử lại nhiều lần nếu lệnh không thành công.

Một dạng đơn giản hơn của executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) với các giá trị mặc định.

Tham số
`command`	`String`: lệnh shell adb để chạy
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` để chuyển hướng đầu ra của shell đến.

Gửi
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

Phương thức trợ giúp thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền chính xác bằng đầu ra trạng thái lệnh, stdout và stderr.

Tham số
`cmd`	`String`: Lệnh cần chạy.

Giá trị trả về
`CommandResult`	Kết quả trong `CommandResult`.

Gửi
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

Phương thức trợ giúp thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền chính xác bằng đầu ra trạng thái lệnh và stderr. stdout được chuyển hướng đến luồng đã chỉ định.

Tham số
`cmd`	`String`: Lệnh cần chạy.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` nơi đầu ra std sẽ được chuyển hướng hoặc rỗng.

Giá trị trả về
`CommandResult`	Kết quả trong `CommandResult`.

Gửi
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

Tham số
`cmd`	`String`: Lệnh cần chạy.
`pipeAsInput`	`File`: `ERROR(/File)` sẽ được chuyển vào lệnh dưới dạng dữ liệu đầu vào hoặc giá trị rỗng.

Giá trị trả về
`CommandResult`	Kết quả trong `CommandResult`.

Gửi
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.

Tham số
`cmd`	`String`: lệnh shell adb để chạy
`maxTimeoutForCommand`	`long`: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong `timeUnit`
`timeUnit`	`TimeUnit`: đơn vị cho `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: số lần thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu `retryAttempts` không được thực hiện thành công.

Giá trị trả về
`CommandResult`

Gửi
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.

Tham số
`cmd`	`String`: lệnh shell adb để chạy
`maxTimeoutForCommand`	`long`: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong `timeUnit`
`timeUnit`	`TimeUnit`: đơn vị cho `maxTimeToOutputShellResponse`

Giá trị trả về
`CommandResult`

Gửi
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.

Tham số
`cmd`	`String`: lệnh shell adb để chạy
`pipeAsInput`	`File`: `ERROR(/File)` sẽ được chuyển vào lệnh dưới dạng dữ liệu đầu vào hoặc giá trị rỗng.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` nơi đầu ra std sẽ được chuyển hướng hoặc rỗng.
`maxTimeoutForCommand`	`long`: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong `timeUnit`
`timeUnit`	`TimeUnit`: đơn vị cho `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: số lần thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu `retryAttempts` không được thực hiện thành công.

Giá trị trả về
`CommandResult`

Gửi
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Thực thi lệnh shell adb, với nhiều tham số hơn để kiểm soát hành vi của lệnh.

Tham số
`cmd`	`String`: lệnh shell adb để chạy
`pipeAsInput`	`File`: `ERROR(/File)` sẽ được chuyển vào lệnh dưới dạng dữ liệu đầu vào hoặc giá trị rỗng.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` nơi đầu ra std sẽ được chuyển hướng hoặc rỗng.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` nơi lỗi std sẽ được chuyển hướng hoặc rỗng.
`maxTimeoutForCommand`	`long`: thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong `timeUnit`
`timeUnit`	`TimeUnit`: đơn vị cho `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: số lần thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu `retryAttempts` không được thực hiện thành công.

Giá trị trả về
`CommandResult`

Gửi
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Phương thức trợ giúp xoá sạch một phân vùng cho thiết bị.

Nếu getUseFastbootErase() là true, thì tính năng xoá khởi động nhanh sẽ được dùng để xoá phân vùng. Sau đó, thiết bị phải tạo một hệ thống tệp vào lần khởi động tiếp theo. Nếu không, định dạng khởi động nhanh sẽ được sử dụng để tạo một hệ thống tệp mới trên thiết bị.

Dự kiến sẽ được sử dụng khi thiết bị đã ở chế độ khởi động nhanh.

Tham số
`partition`	`String`: phân vùng cần xoá

Giá trị trả về
`CommandResult`	CommandResult chứa kết quả của lệnh

Gửi
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị.

Giá trị trả về
	`ERROR(/Set)`/`ApexInfo` hiện đang được kích hoạt trên thiết bị

Gửi
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

Trả về các cặp khoá-giá trị của không gian tên được yêu cầu.

Tham số
`namespace`	`String`: phải là một trong các giá trị {"system", "secure", "global"}

Giá trị trả về
	bản đồ của các cặp khoá-giá trị. Rỗng nếu không hỗ trợ không gian tên.

Gửi
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Trả về trạng thái phân bổ hiện tại của thiết bị

Giá trị trả về
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

Tìm và trả về android-id được liên kết với một userId, rỗng nếu không tìm thấy.

Tham số
`userId`	`int`

Giá trị trả về
`String`

Gửi
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Tạo một Bản đồ gồm các mã nhận dạng Android khớp với mã nhận dạng người dùng. Không có gì đảm bảo rằng mỗi mã nhận dạng người dùng sẽ tìm thấy một mã nhận dạng Android được liên kết trong hàm này, vì vậy, một số mã nhận dạng người dùng có thể khớp với giá trị rỗng.

Giá trị trả về
	Bản đồ mã nhận dạng Android đã tìm thấy mã nhận dạng người dùng phù hợp.

Gửi
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

Lấy Cấp độ API của thiết bị. Giá trị mặc định là UNKNOWN_API_LEVEL.

Giá trị trả về
`int`	một số nguyên cho biết Cấp độ API của thiết bị

Gửi
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Tìm nạp thông tin về một gói đã cài đặt trên thiết bị.

Tham số
`packageName`	`String`

Giá trị trả về
`PackageInfo`	`PackageInfo` hoặc `null` nếu không thể truy xuất thông tin

Gửi
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Tìm nạp thông tin về các gói đã cài đặt trên thiết bị.

Giá trị trả về
	`ERROR(/List)` trong số `PackageInfo` đã được cài đặt trên thiết bị.

Gửi
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

Phương thức thuận tiện để lấy phiên bản băng tần cơ sở (vô tuyến) của thiết bị này. Việc lấy phiên bản đài phát thanh là dành riêng cho thiết bị, vì vậy, phiên bản này có thể không trả về thông tin chính xác cho tất cả thiết bị. Phương thức này dựa vào thuộc tính gsm.version.baseband để trả về thông tin phiên bản chính xác. Thông tin này không chính xác đối với một số thiết bị CDMA và phiên bản được trả về tại đây có thể không khớp với phiên bản được báo cáo từ tính năng khởi động nhanh và có thể không trả về phiên bản cho đài CDMA. Tóm tắt: phương thức này chỉ báo cáo phiên bản chính xác nếu thuộc tính gsm.version.baseband giống với phiên bản do fastboot getvar version-baseband trả về.

Giá trị trả về
`String`	phiên bản băng tần cơ sở `String` hoặc `null` nếu không xác định được phiên bản này (thiết bị không có đài hoặc không đọc được chuỗi phiên bản)

Gửi
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

Trả về mức pin hiện tại của một thiết bị hoặc giá trị Rỗng nếu không có mức pin.

Giá trị trả về
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Trả về giá trị boolean của thuộc tính đã cho.

Tham số
`name`	`String`: tên thuộc tính
`defaultValue`	`boolean`: giá trị mặc định để trả về nếu thuộc tính trống hoặc không tồn tại.

Giá trị trả về
`boolean`	`true` nếu thuộc tính có giá trị `"1"`, `"y"`, `"yes"`, `"on"` hoặc `"true"`, `false` nếu thuộc tính có giá trị `"0"`, `"n"`, `"no"`, `"off"`, `"false"` hoặc `defaultValue`.

Gửi
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

Phương thức trợ giúp thu thập bản đồ nhật ký khởi động với thời gian khởi động và lý do khởi động.

Giá trị trả về
	Bản đồ thời gian khởi động (giờ UTC tính bằng giây kể từ thời gian bắt đầu của hệ thống) và lý do khởi động

Gửi
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Phương thức trợ giúp thu thập bản đồ nhật ký khởi động với thời gian khởi động và lý do khởi động kể từ thời gian đã cho kể từ thời gian bắt đầu của thiết bị và đơn vị thời gian được chỉ định. Bạn có thể lấy utcEpochTime của thiết bị hiện tại tính bằng mili giây bằng phương thức getDeviceDate().

Tham số
`utcEpochTime`	`long`: thời gian thiết bị kể từ thời gian bắt đầu của hệ thống.
`timeUnit`	`TimeUnit`: đơn vị thời gian `TimeUnit`.

Giá trị trả về
	Bản đồ thời gian khởi động (giờ UTC tính bằng giây kể từ thời gian bắt đầu của hệ thống) và lý do khởi động

Gửi
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

Phương thức thuận tiện để lấy phiên bản trình tải khởi động của thiết bị này.

Sẽ cố gắng truy xuất phiên bản trình tải khởi động từ trạng thái hiện tại của thiết bị. (tức là nếu thiết bị đang ở chế độ khởi động nhanh, thì thiết bị sẽ cố gắng truy xuất phiên bản từ chế độ khởi động nhanh)

Giá trị trả về
`String`	phiên bản trình tải khởi động `String` hoặc `null` nếu không tìm thấy

Gửi
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

Truy xuất báo cáo lỗi từ thiết bị.

Việc triển khai tính năng này được đảm bảo sẽ tiếp tục hoạt động trên một thiết bị không có thẻ SD (hoặc khi thẻ SD chưa được gắn).

Giá trị trả về
`InputStreamSource`	`InputStreamSource` sẽ tạo nội dung báo cáo lỗi theo yêu cầu. Trong trường hợp không thành công, `InputStreamSource` sẽ tạo ra một `ERROR(/InputStream)` trống.

getBugreportz

public InputStreamSource getBugreportz ()

Truy xuất bugreportz từ thiết bị. Tệp báo cáo lỗi ở định dạng zip chứa tệp báo cáo lỗi chính và các tệp nhật ký khác hữu ích cho việc gỡ lỗi.

Chỉ hỗ trợ cho "phiên bản adb" > 1.0.36

Giá trị trả về
`InputStreamSource`	`InputStreamSource` của tệp zip chứa bugreportz, trả về giá trị rỗng trong trường hợp không thành công.

getBuildAlias

public String getBuildAlias ()

Truy xuất bí danh của bản dựng mà thiết bị hiện đang chạy.

Bí danh bản dựng thường là một chuỗi dễ đọc hơn so với mã bản dựng (thường là một số cho các bản dựng Nexus). Ví dụ: bản phát hành Android 4.2 cuối cùng có bí danh bản dựng JDQ39 và mã bản dựng 573038

Giá trị trả về
`String`	bí danh bản dựng hoặc quay lại mã bản dựng nếu không thể truy xuất

Gửi
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

Truy xuất phiên bản bản dựng cho thiết bị.

Giá trị trả về
`String`	phiên bản xây dựng hoặc giá trị rỗng nếu không truy xuất được phiên bản xây dựng

Gửi
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

Truy xuất bản dựng mà thiết bị đang chạy.

Giá trị trả về
`String`	mã bản dựng hoặc `IBuildInfo.UNKNOWN_BUILD_ID` nếu không thể truy xuất

Gửi
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

Trả về loại khoá dùng để ký hình ảnh thiết bị

Thông thường, các thiết bị Android có thể được ký bằng khoá kiểm thử (như trong AOSP) hoặc khoá phát hành (do các nhà sản xuất thiết bị riêng lẻ kiểm soát)

Giá trị trả về
`String`	Khoá ký nếu tìm thấy, nếu không thì rỗng.

Gửi
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Trả về DeviceDescriptor được lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không thì trả về DeviceDescriptor hiện tại.

Giá trị trả về
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Trả về DeviceDescriptor được lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không thì trả về DeviceDescriptor hiện tại.

Tham số
`shortDescriptor`	`boolean`: Có giới hạn chỉ số mô tả ở mức thông tin tối thiểu hay không

Giá trị trả về
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

Giải pháp thay thế cho việc sử dụng IFileEntry đôi khi sẽ không hoạt động do các quyền.

Tham số
`path`	`String`: là đường dẫn trên thiết bị để thực hiện tìm kiếm

Giá trị trả về
`String[]`	Mảng chuỗi chứa tất cả tệp trong một đường dẫn trên thiết bị.

Gửi
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

Kết nối hiện tại được liên kết với thiết bị.

Giá trị trả về
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Trả về ContentProviderHandler hoặc giá trị rỗng nếu không có.

Bạn có thể sử dụng lại trình cung cấp nội dung nếu trình cung cấp nội dung đó được tạo trước đó bằng cùng một userId.

Tham số
`userId`	`int`: mã nhận dạng người dùng để khởi chạy trình cung cấp nội dung.

Giá trị trả về
`ContentProviderHandler`

Gửi
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Trả về trạng thái gập hiện tại của thiết bị hoặc giá trị rỗng nếu có một số vấn đề xảy ra.

Giá trị trả về
`DeviceFoldableState`

Gửi
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Trả về mã nhận dạng của người dùng đang chạy. Trong trường hợp xảy ra lỗi, hãy trả về -10000.

Giá trị trả về
`int`

Gửi
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Lấy lớp thiết bị.

Giá trị trả về
`String`	lớp thiết bị `String`.

getDeviceDate

public long getDeviceDate ()

Trả về ngày của thiết bị theo mili giây kể từ thời gian bắt đầu của hệ thống.

Giá trị trả về
`long`	ngày của thiết bị ở định dạng thời gian bắt đầu của hệ thống.

Gửi
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

Trả về DeviceDescriptor từ thông tin thiết bị để lấy thông tin về thiết bị đó mà không cần truyền đối tượng thiết bị thực tế.

Giá trị trả về
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Trả về DeviceDescriptor từ thông tin thiết bị để lấy thông tin về thiết bị đó mà không cần truyền đối tượng thiết bị thực tế.

Tham số
`shortDescriptor`	`boolean`: Có giới hạn chỉ số mô tả ở mức thông tin tối thiểu hay không

Giá trị trả về
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Lấy trạng thái của thiết bị.

Giá trị trả về
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Trình trợ giúp để lấy chênh lệch thời gian giữa thiết bị và một ERROR(/Date) nhất định. Sử dụng thời gian Epoch trong nội bộ.

Tham số
`date`	`Date`

Giá trị trả về
`long`	chênh lệch theo mili giây

Gửi
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Lấy luồng stdout và stderr của trình mô phỏng

Giá trị trả về
`InputStreamSource`	đầu ra của trình mô phỏng

getEmulatorProcess

public Process getEmulatorProcess ()

Trả về Process tương ứng với trình mô phỏng này.

Giá trị trả về
`Process`	`Process` hoặc `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Nhật ký chứa tất cả nhật ký executeShellCommand(String).

Giá trị trả về
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Phương thức trợ giúp để xác định dung lượng trống trên bộ nhớ ngoài của thiết bị.

Giá trị trả về
`long`	dung lượng trống tính bằng KB

Gửi
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

Trả về đường dẫn của tệp nhị phân fastboot đang được sử dụng. Vẫn yêu cầu isFastbootEnabled() phải là true để bật các hàm khởi động nhanh.

Giá trị trả về
`String`

getFastbootProductType

public String getFastbootProductType ()

Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này khi thiết bị ở chế độ khởi động nhanh.

Bạn chỉ nên sử dụng phương thức này nếu thiết bị đang ở chế độ khởi động nhanh. Đây là một biến thể an toàn hơn một chút so với phương thức getProductType() chung trong trường hợp này, vì ITestDevice sẽ biết cách khôi phục thiết bị vào chế độ khởi động nhanh nếu thiết bị ở trạng thái không chính xác hoặc không phản hồi.

Giá trị trả về
`String`	tên loại sản phẩm `String` hoặc `null` nếu không xác định được

Gửi
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này khi thiết bị ở chế độ khởi động nhanh.

Giá trị trả về
`String`	tên loại sản phẩm `String` hoặc `null` nếu không xác định được

Gửi
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Trả về số sê-ri của chế độ khởi động nhanh.

Giá trị trả về
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

Truy xuất giá trị biến khởi động nhanh đã cho từ thiết bị.

Tham số
`variableName`	`String`: tên biến

Giá trị trả về
`String`	giá trị thuộc tính hoặc `null` nếu không có

Gửi
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

Trả về chuỗi phiên bản của tệp nhị phân fastboot đang được sử dụng. Hoặc rỗng nếu có lỗi xảy ra.

Giá trị trả về
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

Truy xuất tệp tham chiếu đến tệp từ xa trên thiết bị.

Tham số
`path`	`String`: đường dẫn tệp cần truy xuất. Có thể là đường dẫn tuyệt đối hoặc đường dẫn tương đối so với "/". (tức là cả cú pháp "/system" và "system" đều được hỗ trợ)

Giá trị trả về
`IFileEntry`	`IFileEntry` hoặc `null` nếu không tìm thấy tệp tại `path` đã cho

Gửi
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Trình trợ giúp không chính thức để lấy FileEntry từ một đường dẫn không phải gốc. FIXME: Tái cấu trúc hệ thống FileEntry để có thể sử dụng hệ thống này từ bất kỳ đường dẫn nào. (ngay cả khi không phải là thư mục gốc).

Tham số
`entry`	`FileListingService.FileEntry`: `FileEntry` không nhất thiết phải là thư mục gốc như Ddmlib yêu cầu.

Giá trị trả về
`IFileEntry`	FileEntryWrapper đại diện cho FileEntry.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

Trả về danh sách các trạng thái có thể gập lại trên thiết bị. Có thể lấy bằng lệnh "cmd device_state print-states".

Giá trị trả về

Gửi
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

Trả về một tệp tham chiếu đến IDevice ddmlib được liên kết.

DDMS có thể phân bổ một IDevice mới mỗi khi thiết bị ngắt kết nối và kết nối lại với adb. Do đó, phương thức gọi không nên giữ lại tham chiếu đến IDevice, vì tham chiếu đó có thể trở nên lỗi thời.

Giá trị trả về
`IDevice`	`IDevice`

getInstalledPackageNames

public  getInstalledPackageNames ()

Tìm nạp tên gói ứng dụng có trên thiết bị.

Giá trị trả về
	`ERROR(/Set)` của tên gói `String` hiện được cài đặt trên thiết bị.

Gửi
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Trả về giá trị số nguyên của thuộc tính đã cho từ thiết bị.

Tham số
`name`	`String`: tên thuộc tính
`defaultValue`	`long`: giá trị mặc định để trả về nếu thuộc tính trống hoặc không tồn tại.

Giá trị trả về
`long`	giá trị thuộc tính hoặc `defaultValue` nếu thuộc tính trống, không tồn tại hoặc không có giá trị số nguyên.

Gửi
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

Lấy địa chỉ IP của thiết bị.

Giá trị trả về
`String`	địa chỉ IP của thiết bị hoặc `null` nếu thiết bị không có địa chỉ IP

Gửi
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Trả về một đối tượng để lấy trạng thái hiện tại của khoá bảo vệ hoặc giá trị rỗng nếu không được hỗ trợ.

Giá trị trả về
`KeyguardControllerState`	`KeyguardControllerState` chứa ảnh chụp nhanh về trạng thái của khoá bảo vệ và trả về giá trị Rỗng nếu truy vấn Khoá bảo vệ không được hỗ trợ.

Gửi
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Trả về lần gần nhất API Tradefed kích hoạt quá trình khởi động lại tính bằng mili giây kể từ EPOCH do System.currentTimeMillis() trả về.

Giá trị trả về
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

Nhận Cấp độ API được khởi chạy đầu tiên của thiết bị. Giá trị mặc định là UNKNOWN_API_LEVEL.

Giá trị trả về
`int`	một số nguyên cho biết Cấp độ API đầu tiên được khởi chạy của thiết bị

Gửi
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

Lấy luồng tổng quan nhanh của dữ liệu logcat.

Hoạt động ở hai chế độ:

Nếu logcat hiện đang được ghi lại ở chế độ nền, thì sẽ trả về tối đa TestDeviceOptions.getMaxLogcatDataSize() byte nội dung hiện tại của quá trình ghi logcat ở chế độ nền

Nếu không, sẽ trả về một tệp báo lỗi tĩnh của dữ liệu logcat nếu thiết bị đang phản hồi

Giá trị trả về
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

Lấy luồng tổng quan nhanh của maxBytes dữ liệu logcat đã ghi lại gần đây nhất.

Hữu ích trong trường hợp bạn muốn chụp ảnh nhanh thường xuyên về dữ liệu logcat đã thu thập mà không phải chịu hình phạt về dung lượng ổ đĩa có thể lớn khi lấy toàn bộ ảnh chụp nhanh getLogcat().

Tham số
`maxBytes`	`int`: lượng dữ liệu tối đa cần trả về. Phải là một lượng vừa đủ để vừa với bộ nhớ

Giá trị trả về
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

Tải tệp báo lỗi logcat hiện tại cho thiết bị. Không giống như getLogcat(), phương thức này sẽ luôn trả về một tệp báo lỗi tĩnh của logcat.

Có nhược điểm là sẽ không trả về giá trị nào nếu không thể kết nối với thiết bị.

Giá trị trả về
`InputStreamSource`	`InputStreamSource` của dữ liệu logcat. Hệ thống sẽ trả về một luồng trống nếu không thu thập được dữ liệu logcat.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

Lấy luồng tổng quan nhanh về dữ liệu logcat đã thu thập kể từ ngày được cung cấp. Bạn nên sử dụng thời gian trên thiết bị getDeviceDate().

Tham số
`date`	`long`: tính bằng mili giây kể từ thời gian bắt đầu của hệ thống cho đến thời điểm hiện tại. (có thể lấy bằng cách sử dụng 'date +%s')

Giá trị trả về
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Trả về địa chỉ MAC của thiết bị, giá trị rỗng nếu không truy vấn được từ thiết bị.

Giá trị trả về
`String`

getMainUserId

public Integer getMainUserId ()

Trả về mã nhận dạng người dùng chính.

Giá trị trả về
`Integer`	userId của người dùng chính nếu có và rỗng nếu không có người dùng chính.

Gửi
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Nhận thông tin về các mô-đun chính được cài đặt trên thiết bị.

Giá trị trả về
	`ERROR(/Set)` trong số `String` mô-đun chính đang được cài đặt trên thiết bị.

Gửi
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Lấy số lượng người dùng tối đa được hỗ trợ chạy đồng thời. Giá trị mặc định là: 0

Giá trị trả về
`int`	một số nguyên cho biết số lượng người dùng đang chạy đồng thời

Gửi
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Nhận số lượng người dùng tối đa được hỗ trợ. Giá trị mặc định là: 0

Giá trị trả về
`int`	một số nguyên cho biết số lượng người dùng được hỗ trợ

Gửi
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

Giá trị trả về
`Process`	Trả về Quy trình của máy ảo Microdroid. Nếu TestDevice không phải là Microdroid, trả về giá trị rỗng.

getMonitor

public IDeviceStateMonitor getMonitor ()

Trả về IDeviceStateMonitor liên kết với thiết bị.

Giá trị trả về
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Trả về một điểm gắn kết.

Truy vấn trực tiếp thiết bị nếu không có thông tin được lưu vào bộ nhớ đệm trong IDevice.

VIỆC CẦN LÀM: di chuyển hành vi này sang IDevice.getMountPoint(String)

Tham số
`mountName`	`String`: tên của điểm gắn

Giá trị trả về
`String`	điểm gắn hoặc `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Trả về MountPointInfo tương ứng với đường dẫn điểm gắn được chỉ định hoặc null nếu đường dẫn đó không có gì được gắn hoặc không xuất hiện trong /proc/mounts dưới dạng điểm gắn.

Tham số
`mountpoint`	`String`

Giá trị trả về
`ITestDevice.MountPointInfo`	`ERROR(/List)` của `MountPointInfo` chứa thông tin trong "/proc/mounts"

Gửi
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

Trả về phiên bản đã phân tích cú pháp của thông tin trong /proc/mounts trên thiết bị

Giá trị trả về
	`ERROR(/List)` của `MountPointInfo` chứa thông tin trong "/proc/mounts"

Gửi
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

Tìm nạp các tuỳ chọn kiểm thử cho thiết bị.

Giá trị trả về
`TestDeviceOptions`	`TestDeviceOptions` liên quan đến thiết bị đang được kiểm thử.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

Phương thức trợ giúp để xác định dung lượng trống trên phân vùng thiết bị.

Tham số
`partition`	`String`

Giá trị trả về
`long`	dung lượng trống tính bằng KB

Gửi
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

Trả về mã nhận dạng người dùng chính.

Giá trị trả về
`Integer`	userId của người dùng chính nếu có và rỗng nếu không có người dùng chính.

Gửi
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

Phương thức trợ giúp chạy lệnh "pidof" và "stat", đồng thời trả về đối tượng ProcessInfo có PID và thời gian bắt đầu quy trình của quy trình đã cho.

Tham số
`processName`	`String`: Chuỗi tên quy trình.

Giá trị trả về
`ProcessInfo`	ProcessInfo của processName đã cho

Gửi
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

Trả về pid của dịch vụ hoặc giá trị rỗng nếu có lỗi xảy ra.

Tham số
`process`	`String`: Chuỗi tên quy trình.

Giá trị trả về
`String`

Gửi
`DeviceNotAvailableException`

getProductType

public String getProductType ()

Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này.

Phương thức này sẽ hoạt động nếu thiết bị ở chế độ adb hoặc fastboot.

Giá trị trả về
`String`	tên loại sản phẩm `String`. Không được để trống

Gửi
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

Phương thức thuận tiện để lấy biến thể sản phẩm của thiết bị này.

Phương thức này sẽ hoạt động nếu thiết bị ở chế độ adb hoặc fastboot.

Giá trị trả về
`String`	tên biến thể sản phẩm `String` hoặc `null` nếu không xác định được tên biến thể

Gửi
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

Truy xuất giá trị thuộc tính đã cho từ thiết bị.

Tham số
`name`	`String`: tên thuộc tính

Giá trị trả về
`String`	giá trị thuộc tính hoặc `null` nếu không có

Gửi
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

Lấy chế độ khôi phục hiện tại được sử dụng cho thiết bị.

Giá trị trả về
`ITestDevice.RecoveryMode`	chế độ khôi phục hiện tại được dùng cho thiết bị.

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Lấy ảnh chụp màn hình từ thiết bị đã cho mã màn hình. Định dạng là PNG.

VIỆC CẦN LÀM: mở rộng các phương thức triển khai ở trên để hỗ trợ "định dạng" và "điều chỉnh theo tỷ lệ"

Tham số
`displayId`	`long`: mã màn hình hiển thị của màn hình cần lấy ảnh chụp màn hình.

Giá trị trả về
`InputStreamSource`	`InputStreamSource` của ảnh chụp màn hình ở định dạng hoặc `null` nếu ảnh chụp màn hình không thành công.

Gửi
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

Chụp ảnh màn hình từ thiết bị. Bạn nên sử dụng getScreenshot(format) với phương thức mã hoá JPEG để có kích thước nhỏ hơn

Tham số
`format`	`String`: PNG, JPEG được hỗ trợ

Giá trị trả về
`InputStreamSource`	`InputStreamSource` của ảnh chụp màn hình ở định dạng hoặc `null` nếu ảnh chụp màn hình không thành công.

Gửi
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Chụp ảnh màn hình từ thiết bị. Bạn nên sử dụng getScreenshot(String) thay vì mã hoá JPEG để có kích thước nhỏ hơn.

Tham số
`format`	`String`: PNG, JPEG được hỗ trợ
`rescale`	`boolean`: liệu ảnh chụp màn hình có được điều chỉnh theo tỷ lệ để giảm kích thước của hình ảnh thu được hay không

Giá trị trả về
`InputStreamSource`	`InputStreamSource` của ảnh chụp màn hình ở định dạng hoặc `null` nếu ảnh chụp màn hình không thành công.

Gửi
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Chụp ảnh màn hình từ thiết bị.

Giá trị trả về
`InputStreamSource`	`InputStreamSource` của ảnh chụp màn hình ở định dạng png hoặc `null` nếu ảnh chụp màn hình không thành công.

Gửi
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Phương thức thuận tiện để lấy số sê-ri của thiết bị này.

Giá trị trả về
`String`	số sê-ri `String`

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

Trả về giá trị của chế độ cài đặt được yêu cầu. không gian tên phải là một trong các giá trị sau: {"system", "secure", "global"}

Tham số
`userId`	`int`
`namespace`	`String`
`key`	`String`

Giá trị trả về
`String`	giá trị liên kết với namespace:key của người dùng. Rỗng nếu không tìm thấy.

Gửi
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Xem getSetting(int, String, String) và thực hiện trên người dùng hệ thống.

Tham số
`namespace`	`String`
`key`	`String`

Giá trị trả về
`String`

Gửi
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

Trả về nhà mạng của thẻ SIM hoặc giá trị rỗng nếu không có nhà mạng hoặc không có thiết bị.

Giá trị trả về
`String`

getSimState

public String getSimState ()

Trả về trạng thái thẻ SIM hoặc giá trị rỗng nếu không có thẻ SIM hoặc không có thiết bị.

Giá trị trả về
`String`

getTombstones

public  getTombstones ()

Tìm nạp và trả về danh sách bia mộ từ các thiết bị. Yêu cầu quyền truy cập thư mục gốc.

phương thức là phương pháp hiệu quả nhất, vì vậy, nếu không thể kéo một bia mộ vì bất kỳ lý do gì, bia mộ đó sẽ bị thiếu trong danh sách. Chỉ DeviceNotAvailableException mới chấm dứt sớm phương thức.

Giá trị trả về
	Danh sách tệp bia mộ, trống nếu không có bia mộ.

Gửi
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

Trả về tổng dung lượng bộ nhớ vật lý tính bằng byte hoặc -1 trong trường hợp xảy ra lỗi nội bộ

Giá trị trả về
`long`

getTrackingSerial

public String getTrackingSerial ()

Để quản lý thiết bị, hãy lấy số sê-ri dùng để theo dõi thiết bị.

Giá trị trả về
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Tìm nạp tên gói ứng dụng có thể gỡ cài đặt. Hiện tại, các gói này được xác định là gói không phải hệ thống và gói hệ thống đã cập nhật.

Giá trị trả về
	`ERROR(/Set)` tên gói `String` không thể gỡ cài đặt hiện đã cài đặt trên thiết bị.

Gửi
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

Xác định xem có sử dụng tính năng xoá fastboot hay định dạng fastboot để xoá một phân vùng trên thiết bị hay không.

Giá trị trả về
`boolean`	`true` nếu bạn sử dụng tính năng xoá bằng tính năng khởi động nhanh hoặc `false` nếu bạn sử dụng tính năng định dạng bằng tính năng khởi động nhanh.

getUserFlags

public int getUserFlags (int userId)

Tìm và trả về cờ của một người dùng cụ thể. Cờ được xác định trong lớp "android.content.pm.UserInfo" trong Dự án nguồn mở Android.

Tham số
`userId`	`int`

Giá trị trả về
`int`	cờ được liên kết với mã nhận dạng người dùng được cung cấp nếu có, -10000 trong mọi trường hợp khác.

Gửi
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Lấy Bản đồ của useId đến UserInfo trên thiết bị. Sẽ gửi DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.

Giá trị trả về
	danh sách các đối tượng UserInfo.

Gửi
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

Trả về số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong mọi trường hợp khác.

Tham số
`userId`	`int`

Giá trị trả về
`int`

Gửi
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Xử lý DeviceEvent đã cho. Có thể chuyển đổi thiết bị sang trạng thái mới. Sẽ thông báo cho IDeviceMonitor về mọi quá trình chuyển đổi trạng thái.

Xử lý DeviceEvent, có thể chuyển đổi thiết bị này sang trạng thái phân bổ mới hoặc không.

Tham số
`event`	`DeviceEvent`

Giá trị trả về
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

Kiểm tra xem một tính năng có trên thiết bị hay không.

Tham số
`feature`	`String`: định dạng phải là "feature:" hoặc "" trực tiếp.

Giá trị trả về
`boolean`	Đúng nếu tìm thấy tính năng, sai nếu không tìm thấy.

Gửi
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị.

Tham số
`packageFile`	`File`: tệp apk cần cài đặt
`reinstall`	`boolean`: `true` nếu cần cài đặt lại
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các tuỳ chọn có sẵn.

Giá trị trả về
`String`	`String` có mã lỗi hoặc `null` nếu thành công.

Gửi
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị.

Lưu ý: Chỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền khi bắt đầu chạy tại thời điểm cài đặt mới được gọi hàm này.

Tham số
`packageFile`	`File`: tệp apk cần cài đặt
`reinstall`	`boolean`: `true` nếu cần cài đặt lại
`grantPermissions`	`boolean`: liệu tất cả các quyền khi bắt đầu chạy có được cấp tại thời điểm cài đặt hay không
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các tuỳ chọn có sẵn.

Giá trị trả về
`String`	`String` có mã lỗi hoặc `null` nếu thành công.

Gửi
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng cụ thể.

Tham số
`packageFile`	`File`: tệp apk cần cài đặt
`reinstall`	`boolean`: `true` nếu cần cài đặt lại
`userId`	`int`: mã nhận dạng người dùng dạng số nguyên để cài đặt.
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các tuỳ chọn có sẵn.

Giá trị trả về
`String`	`String` có mã lỗi hoặc `null` nếu thành công.

Gửi
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng cụ thể.

Lưu ý: Chỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền khi bắt đầu chạy tại thời điểm cài đặt mới được gọi hàm này.

Tham số
`packageFile`	`File`: tệp apk cần cài đặt
`reinstall`	`boolean`: `true` nếu cần cài đặt lại
`grantPermissions`	`boolean`: liệu tất cả các quyền khi bắt đầu chạy có được cấp tại thời điểm cài đặt hay không
`userId`	`int`: mã nhận dạng người dùng dạng số nguyên để cài đặt.
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các tuỳ chọn có sẵn.

Giá trị trả về
`String`	`String` có mã lỗi hoặc `null` nếu thành công.

Gửi
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Giá trị trả về
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Kiểm tra xem nền tảng trên thiết bị có hỗ trợ liệt kê ứng dụng hay không

Giá trị trả về
`boolean`	Đúng nếu tính năng liệt kê ứng dụng được hỗ trợ, nếu không thì sai

Gửi
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc bỏ qua khối sdk mục tiêu thấp trên lượt cài đặt ứng dụng hay không

Giá trị trả về
`boolean`	Đúng nếu hỗ trợ bỏ qua khối sdk mục tiêu thấp, nếu không thì sai

Gửi
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Kiểm tra xem debugfs có được gắn hay không.

Giá trị trả về
`boolean`	`true` nếu debugfs được gắn

Gửi
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Trả về giá trị nếu thiết bị được mã hoá.

Giá trị trả về
`boolean`	`true` nếu thiết bị được mã hoá.

Gửi
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

Trả về True nếu đường dẫn trên thiết bị là một thư mục, trả về false nếu không phải là thư mục.

Tham số
`path`	`String`

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

Giá trị trả về
`boolean`	`true` nếu cần bật quyền truy cập gốc adb trên thiết bị

isEncryptionSupported

public boolean isEncryptionSupported ()

Trả về kết quả nếu thiết bị hỗ trợ tính năng mã hoá.

Giá trị trả về
`boolean`	`true` nếu thiết bị hỗ trợ tính năng mã hoá.

Gửi
`DeviceNotAvailableException`

isExecutable

public boolean isExecutable (String fullPath)

Trả về True nếu đường dẫn tệp trên thiết bị là tệp thực thi, ngược lại là false.

Tham số
`fullPath`	`String`

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Trả về nếu thiết bị có chế độ khởi động nhanh.

Giá trị trả về
`boolean`

isHeadless

public boolean isHeadless ()

Trả về true nếu thiết bị không có màn hình (không có màn hình), nếu không thì trả về false.

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Trả về liệu thiết bị có sử dụng chế độ người dùng hệ thống không có giao diện người dùng hay không.

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Trả về giá trị cho biết người dùng chính có phải là quản trị viên vĩnh viễn và không thể bị xoá hoặc hạ cấp xuống trạng thái không phải quản trị viên hay không.

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Xác định xem chế độ nhiều người dùng có được hỗ trợ hay không.

Giá trị trả về
`boolean`	true nếu hỗ trợ nhiều người dùng, false nếu không hỗ trợ

Gửi
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Truy vấn thiết bị theo tên gói và mã nhận dạng người dùng nhất định để kiểm tra xem gói đó có đang được cài đặt cho người dùng đó hay không.

Tham số
`packageName`	`String`: gói mà chúng ta đang kiểm tra xem đã được cài đặt hay chưa.
`userId`	`String`: Mã nhận dạng người dùng mà chúng ta đang kiểm tra gói được cài đặt. Nếu giá trị này là rỗng, hệ thống sẽ sử dụng giá trị 0 cho người dùng chính.

Giá trị trả về
`boolean`	True nếu gói được báo cáo là đã cài đặt. Nếu không thì giá trị sẽ là false.

Gửi
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Truy vấn thiết bị theo tên gói nhất định để kiểm tra xem gói đó hiện đã được cài đặt hay chưa.

Tham số
`packageName`	`String`

Giá trị trả về
`boolean`	True nếu gói được báo cáo là đã cài đặt. Nếu không thì giá trị sẽ là false.

Gửi
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc cấp quyền khi bắt đầu chạy hay không

Giá trị trả về
`boolean`	Đúng nếu quyền khi bắt đầu chạy được hỗ trợ, sai nếu không.

Gửi
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

Trả về true nếu thiết bị ở TestDeviceState.FASTBOOT hoặc TestDeviceState.FASTBOOTD.

Giá trị trả về
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

Kiểm tra xem một người dùng cụ thể có đang chạy hay không.

Tham số
`userId`	`int`

Giá trị trả về
`boolean`	Đúng nếu người dùng đang chạy, sai trong mọi trường hợp khác.

Gửi
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

Trả về liệu người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của người dùng đó.

Tham số
`userId`	`int`

Giá trị trả về
`boolean`	true nếu người dùng là người dùng phụ, false nếu không.

Gửi
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

Kiểm tra xem người dùng đã cho có hiển thị hay không.

Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể chạy các hoạt động khởi chạy (thường là trong màn hình mặc định).

Tham số
`userId`	`int`

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Kiểm tra xem người dùng đã cho có hiển thị trong màn hình đã cho hay không.

Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể chạy các hoạt động khởi chạy trong màn hình đó.

Tham số
`userId`	`int`
`displayId`	`int`

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Trả về thông tin về việc thiết bị có cho phép người dùng bắt đầu hiển thị ở chế độ nền trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) hay không.

Nếu có, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean), truyền một màn hình do listDisplayIdsForStartingVisibleBackgroundUsers() trả về (màn hình này phải bao gồm ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Trả về kết quả cho biết thiết bị có cho phép người dùng hiển thị ở chế độ nền hay không.

Nếu có, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean), truyền một màn hình do listDisplayIdsForStartingVisibleBackgroundUsers() trả về.

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Kiểm tra xem Wi-Fi đã bật hay chưa.

Kiểm tra xem wifi đã được bật trên thiết bị hay chưa. Hữu ích để xác nhận trạng thái wifi trước khi kiểm thử những chương trình không chạy được bằng wifi, ví dụ: kiểm thử dữ liệu di động.

Giá trị trả về
`boolean`	`true` nếu wifi đang bật. `false` nếu bị tắt

Gửi
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

Thu thập danh sách mã nhận dạng màn hình có sẵn trên thiết bị do "dumpsys SurfaceFlinger" báo cáo.

Giá trị trả về
	Danh sách màn hình. Giá trị mặc định luôn trả về màn hình mặc định 0.

Gửi
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Lấy danh sách màn hình có thể dùng để start a user visible in the background.

Giá trị trả về

Gửi
`DeviceNotAvailableException`

listUsers

public  listUsers ()

Lấy danh sách người dùng trên thiết bị. Sẽ gửi DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.

Giá trị trả về
	danh sách mã nhận dạng người dùng.

Gửi
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

Thu thập và ghi nhật ký lỗi ANR từ thiết bị.

Tham số
`logger`	`ITestLogger`: `ITestLogger` để ghi nhật ký lỗi ANR.

Giá trị trả về
`boolean`	Đúng nếu quá trình ghi nhật ký thành công, sai nếu không.

Gửi
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Phương thức trợ giúp để lấy báo cáo lỗi và ghi báo cáo đó vào trình báo cáo.

Tham số
`dataName`	`String`: tên mà báo cáo lỗi sẽ được báo cáo.
`listener`	`ITestLogger`: `ITestLogger` để ghi nhật ký báo cáo lỗi.

Giá trị trả về
`boolean`	Đúng nếu quá trình ghi nhật ký thành công, sai nếu không.

logOnDevice

public void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

Ghi nhật ký một thông báo trong logcat của thiết bị. Đây là lệnh gọi an toàn sẽ không gửi ngay cả khi ghi nhật ký không thành công.

Tham số
`tag`	`String`: Thẻ mà chúng ta ghi nhật ký thông báo trong logcat.
`level`	`Log.LogLevel`: Cấp gỡ lỗi của thông báo trong logcat.
`format`	`String`: Định dạng thông báo.
`args`	`Object`: các đối số cần thay thế thông qua String.format().

mountDebugfs

public void mountDebugfs ()

Gắn debugfs.

Gửi
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

Phát lệnh khởi động lại thiết bị và trả về khi lệnh hoàn tất cũng như khi thiết bị không còn hiển thị với adb.

Gửi
`DeviceNotAvailableException`

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
	com.android.tradefed.device.DeviceNotAvailableException
`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
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public void postBootSetup ()

Thực hiện hướng dẫn để định cấu hình thiết bị cho việc kiểm thử sau mỗi lần khởi động.

Nên được gọi sau khi thiết bị khởi động/có sẵn đầy đủ

Trong trường hợp thông thường, bạn không cần gọi phương thức này một cách rõ ràng, vì các hoạt động triển khai sẽ tự động thực hiện các bước này khi khởi động lại.

Bạn có thể cần gọi phương thức này khi thiết bị khởi động lại do các sự kiện khác (ví dụ: khi lệnh cập nhật khởi động nhanh hoàn tất)

Gửi
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Các bước bổ sung để dọn dẹp bắt buộc theo thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất.

Tham số
`exception`	`Throwable`: ngoại lệ cuối cùng (nếu có) do lỗi gọi gây ra.

preInvocationSetup

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

Các bước bổ sung để thiết lập bắt buộc theo thiết bị sẽ được thực thi trên thiết bị trước khi thực hiện luồng gọi.

Tham số
`info`	`IBuildInfo`: `IBuildInfo` của thiết bị.
`attributes`	`MultiMap`: Các thuộc tính được lưu trữ trong ngữ cảnh gọi

Gửi
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

Kéo nội dung thư mục từ thiết bị theo cách đệ quy.

Tham số
`deviceFilePath`	`String`: đường dẫn tệp tuyệt đối của nguồn từ xa
`localDir`	`File`: thư mục cục bộ để kéo tệp vào
`userId`	`int`: mã nhận dạng người dùng cần lấy

Giá trị trả về
`boolean`	`true` nếu tệp được lấy thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Kéo nội dung thư mục từ thiết bị theo cách đệ quy.

Tham số
`deviceFilePath`	`String`: đường dẫn tệp tuyệt đối của nguồn từ xa
`localDir`	`File`: thư mục cục bộ để kéo tệp vào

Giá trị trả về
`boolean`	`true` nếu tệp được lấy thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

Truy xuất tệp trên thiết bị.

Tham số
`remoteFilePath`	`String`: đường dẫn tuyệt đối đến tệp trên thiết bị.
`localFile`	`File`: tệp cục bộ để lưu trữ nội dung. Nếu không trống, nội dung sẽ được thay thế.

Giá trị trả về
`boolean`	`true` nếu tệp được truy xuất thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

Truy xuất một tệp trên thiết bị, lưu trữ tệp đó trong ERROR(/File) tạm thời cục bộ và trả về File đó.

Tham số
`remoteFilePath`	`String`: đường dẫn tuyệt đối đến tệp trên thiết bị.
`userId`	`int`: Mã nhận dạng người dùng cần lấy

Giá trị trả về
`File`	`ERROR(/File)` chứa nội dung của tệp thiết bị hoặc `null` nếu quá trình sao chép không thành công vì bất kỳ lý do gì (bao gồm cả sự cố với hệ thống tệp máy chủ)

Gửi
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

Truy xuất một tệp trên thiết bị, lưu trữ tệp đó trong ERROR(/File) tạm thời cục bộ và trả về File đó.

Tham số
`remoteFilePath`	`String`: đường dẫn tuyệt đối đến tệp trên thiết bị.

Giá trị trả về
`File`	`ERROR(/File)` chứa nội dung của tệp thiết bị hoặc `null` nếu quá trình sao chép không thành công vì bất kỳ lý do gì (bao gồm cả sự cố với hệ thống tệp máy chủ)

Gửi
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

Truy xuất tệp trên thiết bị.

Tham số
`remoteFilePath`	`String`: đường dẫn tuyệt đối đến tệp trên thiết bị.
`localFile`	`File`: tệp cục bộ để lưu trữ nội dung. Nếu không trống, nội dung sẽ được thay thế.
`userId`	`int`: Mã nhận dạng người dùng cần lấy

Giá trị trả về
`boolean`	`true` nếu tệp được truy xuất thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

Truy xuất tệp trên thiết bị và trả về nội dung.

Tham số
`remoteFilePath`	`String`: đường dẫn tuyệt đối đến tệp trên thiết bị.

Giá trị trả về
`String`	`String` chứa nội dung của tệp thiết bị hoặc `null` nếu quá trình sao chép không thành công vì bất kỳ lý do gì (bao gồm cả sự cố với hệ thống tệp máy chủ)

Gửi
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

Một phương thức thuận tiện để truy xuất tệp từ bộ nhớ ngoài của thiết bị, lưu trữ tệp đó trong một ERROR(/File) tạm thời cục bộ và trả về một tệp tham chiếu đến File đó.

Tham số
`remoteFilePath`	`String`: đường dẫn đến tệp trên thiết bị, tương ứng với điểm gắn bộ nhớ ngoài của thiết bị

Giá trị trả về
`File`	`ERROR(/File)` chứa nội dung của tệp thiết bị hoặc `null` nếu quá trình sao chép không thành công vì bất kỳ lý do gì (bao gồm cả sự cố với hệ thống tệp máy chủ)

Gửi
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

Đẩy nội dung thư mục đến thiết bị theo đệ quy, đồng thời loại trừ một số thư mục được lọc.

Tham số
`localFileDir`	`File`: thư mục cục bộ để đẩy
`deviceFilePath`	`String`: đường dẫn tệp tuyệt đối của đích đến từ xa
`excludedDirectories`	: Tập hợp các tên thư mục bị loại trừ không được đẩy.

Giá trị trả về
`boolean`	`true` nếu tệp đã được đẩy thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Đẩy nội dung thư mục đến thiết bị theo đệ quy.

Tham số
`localFileDir`	`File`: thư mục cục bộ để đẩy
`deviceFilePath`	`String`: đường dẫn tệp tuyệt đối của đích đến từ xa

Giá trị trả về
`boolean`	`true` nếu tệp đã được đẩy thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

Đẩy nội dung thư mục đến thiết bị theo đệ quy.

Tham số
`localFileDir`	`File`: thư mục cục bộ để đẩy
`deviceFilePath`	`String`: đường dẫn tệp tuyệt đối của đích đến từ xa
`userId`	`int`: mã nhận dạng người dùng cần đẩy đến

Giá trị trả về
`boolean`	`true` nếu tệp đã được đẩy thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

Biến thể của pushFile(File, String) có thể xem xét việc đánh giá nhu cầu của nhà cung cấp nội dung (không bắt buộc).

Tham số
`localFile`	`File`: tệp cục bộ cần đẩy
`remoteFilePath`	`String`: đường dẫn tệp tuyệt đối của đích đến từ xa
`evaluateContentProviderNeeded`	`boolean`: liệu có kiểm tra xem chúng ta có cần nhà cung cấp nội dung hay không

Giá trị trả về
`boolean`	`true` nếu tệp đã được đẩy thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

Đẩy tệp vào thiết bị. Theo mặc định, sử dụng một trình cung cấp nội dung.

Tham số
`localFile`	`File`: tệp cục bộ cần đẩy
`remoteFilePath`	`String`: đường dẫn tệp tuyệt đối của đích đến từ xa

Giá trị trả về
`boolean`	`true` nếu tệp đã được đẩy thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                int userId)

Đẩy tệp vào thiết bị. Theo mặc định, sử dụng một trình cung cấp nội dung.

Tham số
`localFile`	`File`: tệp cục bộ cần đẩy
`remoteFilePath`	`String`: đường dẫn tệp tuyệt đối của đích đến từ xa
`userId`	`int`: mã nhận dạng người dùng cần đẩy đến

Giá trị trả về
`boolean`	`true` nếu tệp đã được đẩy thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Đẩy tệp được tạo từ một chuỗi vào thiết bị

Tham số
`contents`	`String`: nội dung của tệp cần đẩy
`remoteFilePath`	`String`: đường dẫn tệp tuyệt đối của đích đến từ xa

Giá trị trả về
`boolean`	`true` nếu chuỗi đã được đẩy thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

khởi động lại

public void reboot (String reason)

Khởi động lại thiết bị vào chế độ adb với reason đã cho để duy trì trong quá trình khởi động lại.

Chặn cho đến khi thiết bị có sẵn.

Bạn có thể lấy lý do khởi động lại gần đây nhất bằng cách truy vấn thuộc tính sys.boot.reason.

Tham số
`reason`	`String`: lý do khởi động lại hoặc `null` nếu không có lý do nào được chỉ định.

Gửi
`DeviceNotAvailableException`

khởi động lại

public void reboot ()

Khởi động lại thiết bị vào chế độ adb.

Chặn cho đến khi thiết bị có sẵn.

Gửi
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

Khởi động lại thiết bị ở chế độ trình tải khởi động.

Chặn cho đến khi thiết bị ở chế độ trình tải khởi động.

Gửi
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

Khởi động lại thiết bị ở chế độ fastbootd.

Chặn cho đến khi thiết bị ở chế độ fastbootd.

Gửi
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

Khởi động lại thiết bị ở chế độ khôi phục adb.

Chặn cho đến khi thiết bị chuyển sang chế độ khôi phục

Gửi
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

Khởi động lại thiết bị vào chế độ cài đặt không qua cửa hàng của ADB (lưu ý đây là chế độ đặc biệt trong quá trình khôi phục)

Chặn cho đến khi thiết bị chuyển sang chế độ tải không qua cửa hàng

Gửi
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

Khởi động lại thiết bị vào chế độ cài đặt không qua cửa hàng của ADB (lưu ý đây là chế độ đặc biệt trong quá trình khôi phục)

Chặn cho đến khi thiết bị chuyển sang chế độ tải không qua cửa hàng

Tham số
`autoReboot`	`boolean`: liệu có tự động khởi động lại thiết bị sau khi tải không qua cửa hàng ứng dụng hay không

Gửi
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

Một phương án thay thế cho reboot() chỉ chặn cho đến khi thiết bị có kết nối mạng, tức là hiển thị với adb.

Gửi
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

Một phương án thay thế cho reboot() chỉ chặn cho đến khi thiết bị có kết nối mạng, tức là hiển thị với adb.

Tham số
`reason`	`String`: lý do khởi động lại hoặc `null` nếu không có lý do nào được chỉ định.

Gửi
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

Chỉ khởi động lại phần không gian người dùng của thiết bị.

Chặn cho đến khi thiết bị có sẵn.

CẢNH BÁO. Tính năng khởi động lại không gian người dùng hiện đang trong quá trình phát triển, bạn tự chịu rủi ro khi sử dụng.

Gửi
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

Một phương án thay thế cho rebootUserspace() ()} chỉ chặn cho đến khi thiết bị có kết nối mạng, tức là hiển thị với adb.

Gửi
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

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

Giá trị trả về
`boolean`	Đúng nếu đã thử khôi phục và thành công, trả về Sai nếu đã bỏ qua quá trình khôi phục

Gửi
`DeviceNotAvailableException`	nếu thiết bị không còn hoạt động

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Đăng ký IDeviceActionReceiver cho thiết bị này.

Tất cả IDeviceActionReceiver đã đăng ký sẽ được thông báo trước khi một thao tác trên thiết bị bắt đầu và sau khi thao tác trên thiết bị kết thúc.

Tham số
`deviceActionReceiver`	`IDeviceActionReceiver`: Một `IDeviceActionReceiver` sẽ được đăng ký.

remountSystemReadOnly

public void remountSystemReadOnly ()

Đặt phân vùng hệ thống trên thiết bị ở chế độ chỉ có thể đọc. Có thể khởi động lại thiết bị.

Gửi
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

Đặt phân vùng hệ thống trên thiết bị ở chế độ có thể ghi. Có thể khởi động lại thiết bị.

Gửi
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ chỉ có thể đọc. Có thể khởi động lại thiết bị.

Gửi
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ ghi. Có thể khởi động lại thiết bị.

Gửi
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Xoá quản trị viên thiết bị đã cho trong người dùng đã cho và trả về true nếu thành công, false nếu không.

Tham số
`componentName`	`String`: của quản trị viên thiết bị cần xoá.
`userId`	`int`: của người dùng mà quản trị viên thiết bị đang ở.

Giá trị trả về
`boolean`	Đúng nếu thành công, sai nếu không thành công.

Gửi
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có một cách hiệu quả nhất.

Gửi
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Xoá một người dùng nhất định khỏi thiết bị.

Tham số
`userId`	`int`: của người dùng cần xoá

Giá trị trả về
`boolean`	true nếu chúng ta xoá thành công người dùng, false nếu không.

Gửi
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

Đặt lại cờ cho chế độ thiết lập nhà cung cấp nội dung để kích hoạt lại chế độ này.

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                ITestLifeCycleReceiver... listeners)

Phương thức thuận tiện để thực hiện ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) với một hoặc nhiều trình nghe được truyền dưới dạng tham số.

Tham số
`runner`	`IRemoteAndroidTestRunner`: `IRemoteAndroidTestRunner` chạy các chương trình kiểm thử
`listeners`	`ITestLifeCycleReceiver`: (các) trình nghe kết quả kiểm thử

Giá trị trả về
`boolean`	`true` nếu lệnh kiểm thử đã hoàn tất. `false` nếu không hoàn tất được nhưng quá trình khôi phục đã thành công

Gửi
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Chạy kiểm thử đo lường và khôi phục thiết bị.

Nếu kết nối với thiết bị bị mất trước khi quá trình chạy kiểm thử hoàn tất và quá trình khôi phục thành công, thì tất cả trình nghe sẽ được thông báo về testRunFailed và "false" sẽ được trả về. Lệnh kiểm thử sẽ không được chạy lại. Việc này sẽ do phương thức gọi thực hiện nếu cần.

Nếu kết nối với thiết bị bị mất trước khi quá trình chạy kiểm thử hoàn tất và không khôi phục được, thì tất cả trình nghe sẽ được thông báo về testRunFailed và DeviceNotAvailableException sẽ được gửi.

Tham số
`runner`	`IRemoteAndroidTestRunner`: `IRemoteAndroidTestRunner` chạy các chương trình kiểm thử
`listeners`	: trình nghe kết quả kiểm thử

Giá trị trả về
`boolean`	`true` nếu lệnh kiểm thử đã hoàn tất. `false` nếu không hoàn tất được do ngoại lệ liên lạc với thiết bị, nhưng đã khôi phục thành công

Gửi
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                 listeners)

Tương tự như ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) nhưng chạy kiểm thử cho người dùng đã cho.

Tham số
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

Tương tự như ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) nhưng chạy kiểm thử cho một người dùng cụ thể.

Tham số
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Chèn IConfiguration đang sử dụng.

Tham số
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

Tham số
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

Đặt ngày trên thiết bị

Lưu ý: bạn cần can thiệp vào hệ thống để đặt ngày trên thiết bị

Tham số
`date`	`Date`: chỉ định một ngày cụ thể; sẽ sử dụng ngày của máy chủ lưu trữ nếu `null`

Gửi
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Đặt thành phần quản trị thiết bị làm chủ sở hữu thiết bị trong người dùng đã cho.

Tham số
`componentName`	`String`: của quản trị viên thiết bị để trở thành chủ sở hữu thiết bị.
`userId`	`int`: của người dùng mà chủ sở hữu thiết bị sinh sống.

Giá trị trả về
`boolean`	Đúng nếu thành công, sai nếu không thành công.

Gửi
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Cập nhật trạng thái của thiết bị.

Tham số
`deviceState`	`TestDeviceState`: `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Đối với trình mô phỏng, hãy đặt SizeLimitedOutputStream để ghi nhật ký đầu ra

Tham số
`output`	`SizeLimitedOutputStream`: để ghi lại đầu ra

setEmulatorProcess

public void setEmulatorProcess (Process p)

Đặt Process khi thiết bị này là trình mô phỏng.

Tham số
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Đặt tuỳ chọn khởi động nhanh cho thiết bị. Bạn nên đặt khi thiết bị được phân bổ lần đầu.

Tham số
`fastbootEnabled`	`boolean`: liệu thiết bị có hỗ trợ tính năng khởi động nhanh hay không

setFastbootPath

public void setFastbootPath (String fastbootPath)

Đặt đường dẫn đến tệp nhị phân fastboot cần sử dụng. Vẫn yêu cầu isFastbootEnabled() phải là true để bật các hàm khởi động nhanh.

Tham số
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Cập nhật IDevice liên kết với ITestDevice này.

IDevice mới phải tham chiếu đến cùng một thiết bị thực tế như tham chiếu hiện tại. Phương thức này sẽ được gọi nếu DDMS đã phân bổ một IDevice mới

Tham số
`newDevice`	`IDevice`: `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

Đặt thời gian chờ tính bằng mili giây trước khi bắt đầu ghi logcat cho một thiết bị trực tuyến.

Tham số
`delay`	`int`: độ trễ tính bằng mili giây

setOptions

public void setOptions (TestDeviceOptions options)

Đặt TestDeviceOptions cho thiết bị

Tham số
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

Đặt giá trị thuộc tính đã cho trên thiết bị. Yêu cầu quyền truy cập thư mục gốc adb là đúng.

Tham số
`propKey`	`String`: Khoá cần đặt.
`propValue`	`String`: Giá trị thuộc tính cần đặt.

Giá trị trả về
`boolean`	trả về `True` nếu lệnh setprop thành công, trả về False nếu không.

Gửi
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Đặt IDeviceRecovery để sử dụng cho thiết bị này. Bạn nên đặt khi thiết bị được phân bổ lần đầu.

Tham số
`recovery`	`IDeviceRecovery`: `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

Đặt chế độ khôi phục hiện tại để sử dụng cho thiết bị.

Dùng để kiểm soát phương thức khôi phục sẽ sử dụng khi gặp sự cố giao tiếp với thiết bị. Bạn chỉ nên sử dụng phương thức này khi cần (ví dụ: khi khung bị lỗi, v.v.

Tham số
`mode`	`ITestDevice.RecoveryMode`: liệu có bật chế độ "khôi phục cho đến khi chỉ có thể truy cập trực tuyến" hay không.

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

Xem setSetting(int, String, String, String) và thực hiện trên người dùng hệ thống.

Tham số
`namespace`	`String`
`key`	`String`
`value`	`String`

Gửi
`DeviceNotAvailableException`

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Thêm giá trị cài đặt vào không gian tên của một người dùng cụ thể. Một số chế độ cài đặt sẽ chỉ hoạt động sau khi khởi động lại. không gian tên phải là một trong các giá trị sau: {"system", "secure", "global"}

Tham số
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

Gửi
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Chèn thực thể ITestLogger

Tham số
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

Để quản lý thiết bị, hãy theo dõi số sê-ri mà chúng tôi sử dụng để tham chiếu đến thiết bị.

Tham số
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

Đặt chế độ sử dụng tính năng xoá nhanh qua fastboot hoặc định dạng nhanh qua fastboot để xoá một phân vùng trên thiết bị.

Tham số
`useFastbootErase`	`boolean`: `true` nếu bạn nên sử dụng tính năng xoá bằng tính năng khởi động nhanh hoặc `false` nếu bạn nên sử dụng tính năng định dạng bằng tính năng khởi động nhanh.

startLogcat

public void startLogcat ()

Bắt đầu ghi lại đầu ra logcat từ thiết bị ở chế độ nền.

Sẽ không có hiệu lực nếu đầu ra logcat đang được ghi lại. Sau đó, bạn có thể truy xuất dữ liệu thông qua getLogcat.

Khi không còn sử dụng thiết bị, bạn phải gọi stopLogcat().

Thông thường, bạn không cần gọi startLogcat() và stopLogcat() khi nằm trong ngữ cảnh gọi TF, vì khung TF sẽ bắt đầu và dừng logcat.

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

Bật chế độ thử nghiệm bán đổi. Thiết bị sẽ bị xoá sạch và khởi động lại.

Tham số
`timeoutMs`	`int`

Giá trị trả về
`boolean`	Đúng nếu chúng ta thành công, sai nếu không

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

Bắt đầu một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang bị dừng. Nếu người dùng đang chạy ở chế độ nền, thì phương thức này là NOOP.

Tham số
`userId`	`int`: của người dùng để bắt đầu ở chế độ nền

Giá trị trả về
`boolean`	true nếu người dùng đã khởi động thành công ở chế độ nền.

Gửi
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Bắt đầu một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang bị dừng. Nếu người dùng đang chạy ở chế độ nền, thì phương thức này là NOOP. Có thể cung cấp cờ bổ sung để chờ thao tác có hiệu lực.

Tham số
`userId`	`int`: của người dùng để bắt đầu ở chế độ nền
`waitFlag`	`boolean`: sẽ khiến lệnh chờ cho đến khi người dùng khởi động và mở khoá.

Giá trị trả về
`boolean`	true nếu người dùng đã khởi động thành công ở chế độ nền.

Gửi
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Bắt đầu một người dùng nhất định ở chế độ nền, hiển thị trong màn hình nhất định (tức là cho phép người dùng chạy các hoạt động trong màn hình đó).

LƯU Ý: lệnh này không kiểm tra xem người dùng có tồn tại hay không, màn hình có hoạt động hay không, device supports such feature, v.v.

Tham số
`userId`	`int`: của người dùng để bắt đầu ở chế độ nền
`displayId`	`int`: màn hình để bắt đầu hiển thị người dùng
`waitFlag`	`boolean`: sẽ khiến lệnh chờ cho đến khi người dùng khởi động và mở khoá.

Giá trị trả về
`boolean`	`true` nếu người dùng đã bắt đầu thành công trong nền.

Gửi
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Đóng và xoá đầu ra của trình mô phỏng.

stopLogcat

public void stopLogcat ()

Dừng ghi lại đầu ra logcat từ thiết bị và loại bỏ dữ liệu logcat hiện đã lưu.

Sẽ không có hiệu lực nếu không thu thập được đầu ra logcat.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

Dừng thử nghiệm chế độ đổi cũ lấy mới.

Gửi
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

Dừng một người dùng cụ thể. Nếu người dùng đã dừng, phương thức này là NOOP. Không thể dừng người dùng hiện tại và người dùng hệ thống.

Tham số
`userId`	`int`: của người dùng để dừng.

Giá trị trả về
`boolean`	true nếu đã dừng người dùng thành công.

Gửi
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Dừng một người dùng cụ thể. Có thể cung cấp thêm cờ để chờ thao tác có hiệu lực và buộc chấm dứt người dùng. Không thể dừng người dùng hiện tại và người dùng hệ thống.

Tham số
`userId`	`int`: của người dùng để dừng.
`waitFlag`	`boolean`: sẽ khiến lệnh chờ cho đến khi người dùng dừng lại.
`forceFlag`	`boolean`: sẽ buộc người dùng dừng.

Giá trị trả về
`boolean`	true nếu đã dừng người dùng thành công.

Gửi
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

Chuyển thiết bị sang chế độ adb-over-tcp.

Giá trị trả về
`String`	số sê-ri tcp hoặc `null` nếu không thể chuyển đổi thiết bị

Gửi
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Chuyển thiết bị sang chế độ adb qua USB.

Giá trị trả về
`boolean`	`true` nếu chuyển đổi thành công, `false` nếu không.

Gửi
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

Chuyển sang một userId khác có thời gian chờ mặc định. switchUser(int, long).

Tham số
`userId`	`int`

Giá trị trả về
`boolean`	Đúng nếu userId mới khớp với trình cung cấp userId. Nếu không thì giá trị sẽ là false.

Gửi
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Chuyển sang một userId khác với thời gian chờ được cung cấp làm thời hạn. Cố gắng tắt khoá phím sau khi người dùng thay đổi thành công.

Tham số
`userId`	`int`
`timeout`	`long`: để chờ trước khi trả về false cho trường hợp chuyển đổi người dùng không thành công.

Giá trị trả về
`boolean`	Đúng nếu userId mới khớp với trình cung cấp userId. Nếu không thì giá trị sẽ là false.

Gửi
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Tăng dần nội dung của thư mục tệp cục bộ với thiết bị.

Quyết định những tệp cần đẩy bằng cách so sánh dấu thời gian của các tệp cục bộ với các tệp tương đương từ xa. Chỉ những tệp "mới hơn" hoặc không tồn tại mới được đẩy đến thiết bị. Do đó, mức hao tổn sẽ tương đối nhỏ nếu tệp được đặt trên thiết bị đã được cập nhật.

Các tệp ẩn (có tên bắt đầu bằng ".") sẽ bị bỏ qua.

Ví dụ về cách sử dụng: syncFiles("/tmp/files", "/sdcard") sẽ tạo thư mục /sdcard/files nếu thư mục này chưa tồn tại và đẩy nội dung /tmp/files vào /sdcard/files theo cách đệ quy.

Tham số
`localFileDir`	`File`: thư mục tệp cục bộ chứa các tệp cần đẩy đệ quy.
`deviceFilePath`	`String`: thư mục gốc của đường dẫn tệp tuyệt đối đến đích từ xa. Tất cả thư mục trong đường dẫn tệp này phải có thể đọc được. Ví dụ: đẩy vào /data/local/tmp khi adb không phải là thư mục gốc sẽ không thành công

Giá trị trả về
`boolean`	`true` nếu các tệp đã được đồng bộ hoá thành công. `false` nếu không.

Gửi
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Lấy một báo cáo lỗi và trả về báo cáo đó bên trong đối tượng Bugreport để xử lý. Trả về giá trị rỗng trong trường hợp gặp vấn đề. Bạn cần xoá tệp được tham chiếu trong đối tượng Bugreport thông qua Bugreport.close().

Giá trị trả về
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

Gỡ cài đặt gói Android khỏi thiết bị.

Tham số
`packageName`	`String`: gói Android cần gỡ cài đặt

Giá trị trả về
`String`	`String` có mã lỗi hoặc `null` nếu thành công.

Gửi
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Gỡ cài đặt một gói Android khỏi thiết bị cho một người dùng cụ thể.

Tham số
`packageName`	`String`: gói Android cần gỡ cài đặt
`userId`	`int`: mã nhận dạng người dùng dạng số nguyên để gỡ cài đặt.

Giá trị trả về
`String`	`String` có mã lỗi hoặc `null` nếu thành công.

Gửi
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

Mở khoá thiết bị nếu thiết bị đang ở trạng thái mã hoá.

Phương thức này có thể khởi động lại khung nhưng sẽ không gọi postBootSetup(). Do đó, thiết bị có thể chưa sẵn sàng để kiểm thử khi phương thức này trả về.

Giá trị trả về
`boolean`	`true` nếu thành công hoặc nếu thiết bị không được mã hoá.

Gửi
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Huỷ kết nối debugfs.

Gửi
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

Chặn cho đến khi thiết lập cờ hoàn tất khởi động của thiết bị.

Tham số
`timeOut`	`long`: thời gian tính bằng mili giây để chờ đặt cờ

Giá trị trả về
`boolean`	true nếu cờ hoàn tất khởi động của thiết bị được đặt trong thời gian chờ

Gửi
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

Chờ thiết bị phản hồi và có thể kiểm thử. Sử dụng thời gian chờ mặc định.

Giá trị trả về
`boolean`	Đúng nếu thiết bị có sẵn, Sai nếu tính năng khôi phục bị tắt và không có sẵn.

Gửi
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

Chờ thiết bị phản hồi và có thể kiểm thử.

Tham số
`waitTime`	`long`: thời gian chờ tính bằng mili giây

Giá trị trả về
`boolean`	Đúng nếu thiết bị có sẵn, Sai nếu tính năng khôi phục bị tắt và không có sẵn.

Gửi
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Chờ thiết bị phản hồi và có sẵn mà không xem xét đường dẫn khôi phục.

Tham số
`waitTime`	`long`

Giá trị trả về
`boolean`	Đúng nếu có thiết bị, Sai nếu không có thiết bị.

Gửi
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

Chặn cho đến khi thiết bị hiển thị qua tính năng khởi động nhanh. Sử dụng thời gian chờ mặc định.

Gửi
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Chặn thiết bị ở trạng thái "adb recovery" (hãy lưu ý rằng trạng thái này khác với IDeviceRecovery).

Tham số
`waitTime`	`long`: thời gian chờ tính bằng mili giây

Giá trị trả về
`boolean`	`true` nếu thiết bị khởi động vào chế độ khôi phục trước khi hết thời gian. `false` nếu không

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Chặn thiết bị ở trạng thái "adb sideload"

Tham số
`waitTime`	`long`: thời gian chờ tính bằng mili giây

Giá trị trả về
`boolean`	`true` nếu thiết bị khởi động vào chế độ cài đặt không qua cửa hàng trước khi hết thời gian. `false` nếu không

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

Các khối để thiết bị không có sẵn, tức là bị thiếu trong adb

Tham số
`waitTime`	`long`: thời gian chờ tính bằng mili giây

Giá trị trả về
`boolean`	`true` nếu thiết bị không hoạt động trước khi hết thời gian. `false` nếu không

waitForDeviceOnline

public void waitForDeviceOnline ()

Chặn cho đến khi thiết bị hiển thị thông qua adb. Sử dụng thời gian chờ mặc định

Xin lưu ý rằng thiết bị có thể không phản hồi các lệnh khi hoàn tất. Thay vào đó, hãy sử dụng waitForDeviceAvailable().

Gửi
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

Chặn cho đến khi thiết bị hiển thị thông qua adb.

Xin lưu ý rằng thiết bị có thể không phản hồi các lệnh khi hoàn tất. Thay vào đó, hãy sử dụng waitForDeviceAvailable().

Tham số
`waitTime`	`long`: thời gian chờ tính bằng mili giây

Gửi
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

Chờ thiết bị phản hồi lệnh shell adb cơ bản.

Tham số
`waitTime`	`long`: thời gian chờ tính bằng mili giây

Giá trị trả về
`boolean`	`true` nếu thiết bị trở nên phản hồi trước khi `waitTime` trôi qua.

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

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

Tham số
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

Tạo lệnh hệ điều hành cho phiên lệnh shell adb và args đã cho

Tham số
`command`	`String`
`forceExitStatusDetection`	`boolean`

Giá trị trả về
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

Tham số
`feature`	`String`
`strictMinLevel`	`int`

createRebootDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

Tạo RebootDeviceAction để sử dụng khi thực hiện thao tác khởi động lại.

Tham số
`rebootMode`	`NativeDevice.RebootMode`: chế độ khởi động lại này.
`reason`	`String`: cho lần khởi động lại này.

Giá trị trả về
`NativeDevice.RebootDeviceAction`	`RebootDeviceAction` đã tạo.

createRunUtil

protected IRunUtil createRunUtil ()

Giá trị trả về
`IRunUtil`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Khởi động lại adb.

Tham số
`rebootMode`	`NativeDevice.RebootMode`: chế độ khởi động lại này.
`reason`	`String`: cho lần khởi động lại này.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

phương thức trợ giúp để gửi ngoại lệ nếu không hỗ trợ quyền khi bắt đầu chạy

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getApiLevelSafe

protected int getApiLevelSafe ()

Giá trị trả về
`int`

getLogger

protected ITestLogger getLogger ()

Giá trị trả về
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

Lấy thực thể RunUtil để sử dụng.

Giá trị trả về
`IRunUtil`

initializeConnection

protected void initializeConnection (IBuildInfo info, 
                MultiMap<String, String> attributes)

Tham số
`info`	`IBuildInfo`
`attributes`	`MultiMap`

Gửi
`DeviceNotAvailableException`
`TargetSetupError`

internalGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

Tìm nạp một thuộc tính thiết bị, từ bộ nhớ đệm ddmlib theo mặc định và quay lại `adb shell getprop` hoặc `fastboot getvar` tuỳ thuộc vào việc thiết bị có ở chế độ Khởi động nhanh hay không.

Tham số
`propName`	`String`: Tên của thuộc tính thiết bị do lệnh "adb shell getprop" trả về
`fastbootVar`	`String`: Tên của biến khởi động nhanh tương đương để truy vấn. nếu `null`, truy vấn khởi động nhanh sẽ không được thực hiện
`description`	`String`: Nội dung mô tả đơn giản về biến. Chữ cái đầu tiên phải được viết hoa.

Giá trị trả về
`String`	Một chuỗi, có thể là `null` hoặc trống, chứa giá trị của thuộc tính đã cho

Gửi
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

Trả về thông tin về việc lệnh gọi lại khởi động lại có đang được thực thi hay không. Tất cả các API công khai để khởi động lại sẽ bị tắt nếu giá trị này là true.

Giá trị trả về
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Trả về true nếu tệp cục bộ mới hơn tệp từ xa. IFileEntry chính xác đến phút, trong trường hợp thời gian bằng nhau, tệp sẽ được coi là mới hơn.

Tham số
`localFile`	`File`
`entry`	`IFileEntry`

Giá trị trả về
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

Thông báo cho tất cả IDeviceActionReceiver về sự kiện kết thúc khởi động lại.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

notifyRebootStarted

protected void notifyRebootStarted ()

Thông báo cho tất cả IDeviceActionReceiver về sự kiện bắt đầu khởi động lại.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

Thực hiện một hành động trên thiết bị này. Cố gắng khôi phục thiết bị và tuỳ ý thử lại lệnh nếu thao tác không thành công.

Tham số
`actionDescription`	`String`: nội dung mô tả ngắn về hành động cần thực hiện. Chỉ dùng cho mục đích ghi nhật ký.
`action`	`NativeDevice.DeviceAction`: hành động cần thực hiện
`retryAttempts`	`int`: thử lại để thực hiện hành động nếu không thành công nhưng khôi phục thành công

Giá trị trả về
`boolean`	`true` nếu hành động được thực hiện thành công

Gửi
`DeviceNotAvailableException`	nếu không khôi phục được hoặc đã thực hiện số lần khôi phục tối đa mà không thành công

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
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

prePostBootSetup

protected void prePostBootSetup ()

Cho phép mỗi loại thiết bị (AndroidNativeDevice, TestDevice) ghi đè phương thức này để thiết lập cụ thể sau khi khởi động.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

Tham số
`remoteFilePath`	`String`
`localFile`	`File`

Giá trị trả về
`boolean`

Gửi
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

Đặt thực thể Đồng hồ để sử dụng.

Tham số
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Đánh dấu TestDevice là microdroid và đặt CID của thiết bị.

Tham số
`process`	`Process`: Quy trình của máy ảo Microdroid.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

Tham số
`deviceOptions`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

Thực thi một lệnh khởi động nhanh đơn giản với các biến môi trường và báo cáo trạng thái của lệnh.

Tham số
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

Giá trị trả về
`CommandResult`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

Thực thi một lệnh khởi động nhanh đơn giản và báo cáo trạng thái của lệnh.

Tham số
`timeout`	`long`
`fullCmd`	`String`

Giá trị trả về
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Chờ thiết bị không hoạt động (ngừng báo cáo cho adb).

Tham số
`operationDesc`	`String`: Tên của thao tác đang chờ không có sẵn.
`time`	`long`: Thời gian chờ trạng thái không có sẵn xảy ra.

Giá trị trả về
`boolean`	Đúng nếu thiết bị không còn hoạt động.

NativeDevice

Tóm tắt

Lớp lồng ghép

Hằng số

Trường

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

Phương thức công khai

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

Hằng số

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

Trường

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

mOptions

mStateMonitor

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

NativeDevice

Phương thức công khai

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos