Kể từ năm 2026, để phù hợp với mô hình phát triển ổn định của nhánh chính và đảm bảo tính ổn định của nền tảng cho hệ sinh thái, chúng tôi sẽ xuất bản mã nguồn lên AOSP vào quý 2 và quý 4. Để tạo và đóng góp cho AOSP, bạn nên sử dụng android-latest-release thay vì aosp-main. Nhánh tệp kê khai android-latest-release sẽ luôn tham chiếu đến bản phát hành gần đây nhất được chuyển đến AOSP. Để biết thêm thông tin, hãy xem bài viết Các thay đổi đối với AOSP.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.server.DeviceImpl

Một thiết bị. Đó có thể là một thiết bị thực hoặc trình mô phỏng.

Tóm tắt

Hàm khởi tạo công khai
`DeviceImpl(ClientTracker clientTracer, String serialNumber, IDevice.DeviceState deviceState)`

Phương thức công khai
`boolean`	`arePropertiesSet()` Trả về `true` nếu các thuộc tính đã được lưu vào bộ nhớ đệm
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` Tạo một quy tắc chuyển tiếp cổng giữa cổng TCP cục bộ và Unix Domain Socket từ xa.
`void`	`createForward(int localPort, int remotePort)` Tạo một quy tắc chuyển tiếp cổng giữa cổng cục bộ và cổng từ xa.
`void`	`createReverse(int remotePort, int localPort)` Tạo một cổng đảo ngược giữa cổng từ xa và cổng cục bộ.
`void`	`executeBinderCommand(String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` Thực thi một lệnh Binder trên thiết bị và gửi kết quả đến một `receiver` Thao tác này sử dụng lệnh gọi exec:cmd hoặc abb_exec: nhanh hơn nếu cả hệ điều hành thiết bị và máy chủ ADB lưu trữ đều hỗ trợ tính năng thực thi Cầu liên kết Android.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` Một phiên bản của lệnh executeShell có thể nhận luồng đầu vào để gửi qua stdin.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một `receiver` Điều này tương tự như việc gọi `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một `receiver`.
`void`	`forceStop(String applicationName)` Buộc dừng một ứng dụng theo tên ứng dụng.
	`getAbis()` Trả về các ABI mà thiết bị này hỗ trợ.
`ListenableFuture<AvdData>`	`getAvdData()` Trả về thông tin về AVD mà trình mô phỏng đang chạy.
`String`	`getAvdName()` Trả về tên của AVD mà trình mô phỏng đang chạy.
`String`	`getAvdPath()` Trả về đường dẫn tuyệt đối đến thiết bị ảo trong hệ thống tệp.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` Trả về mức pin của thiết bị, từ 0 đến 100 phần trăm.
	`getBattery()` Trả về mức pin của thiết bị, từ 0 đến 100 phần trăm.
`Integer`	`getBatteryLevel(long freshnessMs)` Trả về mức pin của thiết bị, từ 0 đến 100 phần trăm.
`Integer`	`getBatteryLevel()` Trả về mức pin của thiết bị, từ 0 đến 100 phần trăm.
`ClientImpl`	`getClient(String applicationName)` Trả về một `Client` theo tên ứng dụng.
`String`	`getClientName(int pid)` Trả về tên của ứng dụng theo pid hoặc `null` nếu pid không xác định
`ClientTracker`	`getClientTracker()`
`ClientImpl[]`	`getClients()` Trả về mảng ứng dụng.
`int`	`getDensity()` Trả về nhóm mật độ của màn hình thiết bị bằng cách đọc giá trị cho thuộc tính hệ thống `PROP_DEVICE_DENSITY`.
`FileListingService`	`getFileListingService()` Trả về một `FileListingService` cho thiết bị này.
`String`	`getLanguage()` Trả về ngôn ngữ của người dùng.
`InstallMetrics`	`getLastInstallMetrics()` Lấy thông tin về lần cài đặt gần đây nhất trên thiết bị này.
`String`	`getMountPoint(String name)` Trả về một điểm gắn kết.
`String`	`getName()` Trả về tên (dễ hiểu) cho thiết bị này.
`ClientImpl[]`	`getNativeClients()`
`ClientImpl`	`getNativeClients(String applicationName)`
`ProfileableClientImpl[]`	`getProfileableClients()` Trả về mảng gồm các ứng dụng có thể lập hồ sơ.
	`getProperties()` Trả về các thuộc tính của thiết bị được lưu vào bộ nhớ đệm.
`String`	`getProperty(String name)` Phương thức tiện lợi cố gắng truy xuất một thuộc tính thông qua `IShellEnabledDevice.getSystemProperty(String)` với thời gian chờ rất ngắn và loại bỏ các trường hợp ngoại lệ.
`String`	`getPropertyCacheOrSync(String name)` Kết hợp `getProperty(String)` và `getPropertySync(String)` để cố gắng truy xuất thuộc tính từ bộ nhớ đệm.
`int`	`getPropertyCount()` Trả về số lượng tài sản cho thiết bị này.
`String`	`getPropertySync(String name)` Một biến thể của `getProperty(String)` sẽ cố gắng truy xuất thuộc tính đã cho trực tiếp từ thiết bị mà không cần dùng bộ nhớ đệm.
`String`	`getRegion()` Trả về khu vực của người dùng.
`static String`	`getScreenRecorderCommand(String remoteFilePath, ScreenRecorderOptions options)`
`RawImage`	`getScreenshot()` Chụp ảnh màn hình của thiết bị và trả về ảnh đó dưới dạng `RawImage`.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` Trả về số sê-ri của thiết bị.
`IDevice.DeviceState`	`getState()` Trả về trạng thái của thiết bị.
`SyncService`	`getSyncService()` Trả về một đối tượng `SyncService` để đẩy / kéo các tệp đến và đi từ thiết bị.
`ListenableFuture<String>`	`getSystemProperty(String name)` Thực hiện một truy vấn không đồng bộ tiềm năng cho một thuộc tính hệ thống.
`boolean`	`hasClients()` Trả về kết quả cho biết liệu `IDevice` có `Client` hay không.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Cài đặt một ứng dụng Android trên thiết bị.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Cài đặt một ứng dụng Android trên thiết bị.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` Cài đặt một ứng dụng Android trên thiết bị.
`void`	`installPackages( apks, boolean reinstall, installOptions)` Cài đặt một ứng dụng Android được tạo từ một số tệp APK (một gói chính và 0..n gói phân tách) với thời gian chờ mặc định
`void`	`installPackages( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` Cài đặt một ứng dụng Android được tạo từ một số tệp APK (một gói chính và 0..n gói phân tách)
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Cài đặt gói ứng dụng đã được chuyển đến một vị trí tạm thời trên thiết bị.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` Cài đặt gói ứng dụng đã được chuyển đến một vị trí tạm thời trên thiết bị.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Cài đặt gói ứng dụng đã được chuyển đến một vị trí tạm thời trên thiết bị.
`void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions)` Cài đặt một ứng dụng Android được tạo từ một số tệp APK nằm cục bộ trên thiết bị với thời gian chờ mặc định
`void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` Cài đặt một ứng dụng Android được tạo từ một số tệp APK nằm cục bộ trên thiết bị
`boolean`	`isBootLoader()` Trả về nếu thiết bị đang ở chế độ trình tải khởi động.
`boolean`	`isEmulator()` Trả về `true` nếu thiết bị là một trình mô phỏng.
`boolean`	`isOffline()` Trả về nếu thiết bị đang ngoại tuyến.
`boolean`	`isOnline()` Trả về nếu thiết bị đã sẵn sàng.
`boolean`	`isRoot()` Truy vấn trạng thái root hiện tại của thiết bị.
`void`	`kill(String applicationName)` Huỷ một ứng dụng theo tên ứng dụng.
`void`	`pullFile(String remote, String local)` Kéo một tệp.
`void`	`push(String[] local, String remote)` Đẩy một số tệp hoặc thư mục.
`void`	`pushFile(String local, String remote)` Đẩy một tệp.
`SocketChannel`	`rawBinder(String service, String[] parameters)` Gọi dịch vụ Android Binder Bridge trên một thiết bị từ xa.
`SocketChannel`	`rawExec(String executable, String[] parameters)` Gọi dịch vụ host:exec trên một thiết bị từ xa.
`void`	`reboot(String into)` Khởi động lại thiết bị.
`void`	`removeForward(int localPort)` Xoá một hoạt động chuyển tiếp cổng giữa cổng cục bộ và cổng từ xa.
`void`	`removeRemotePackage(String remoteFilePath)` Xoá một tệp khỏi thiết bị.
`void`	`removeReverse(int remotePort)` Xoá một cổng đảo ngược giữa cổng từ xa và cổng cục bộ.
`boolean`	`root()` Yêu cầu trình nền adb trở thành gốc trên thiết bị.
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` Bắt đầu ghi màn hình trên thiết bị nếu thiết bị hỗ trợ `IDevice.Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature feature)` Trả về thông tin cho biết thiết bị này có hỗ trợ tính năng phần cứng đã cho hay không.
`boolean`	`supportsFeature(IDevice.Feature feature)` Trả về thông tin cho biết thiết bị này có hỗ trợ tính năng phần mềm đã cho hay không.
`String`	`syncPackageToDevice(String localFilePath)` Đẩy tệp vào thiết bị
`String`	`toString()`
`String`	`uninstallApp(String applicationID, String... extraArgs)` Gỡ cài đặt một ứng dụng khỏi thiết bị.
`String`	`uninstallPackage(String packageName)` Gỡ cài đặt một gói khỏi thiết bị.

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

DeviceImpl

public DeviceImpl (ClientTracker clientTracer, 
                String serialNumber, 
                IDevice.DeviceState deviceState)

Tham số
`clientTracer`	`ClientTracker`
`serialNumber`	`String`
`deviceState`	`IDevice.DeviceState`

Phương thức công khai

arePropertiesSet

public boolean arePropertiesSet ()

Trả về true nếu các thuộc tính đã được lưu vào bộ nhớ đệm

Giá trị trả về
`boolean`

createForward

public void createForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

Tạo một quy tắc chuyển tiếp cổng giữa cổng TCP cục bộ và Unix Domain Socket từ xa.

Tham số
`localPort`	`int`: cổng cục bộ cần chuyển tiếp
`remoteSocketName`	`String`: tên của ổ cắm miền Unix được tạo trên thiết bị
`namespace`	`IDevice.DeviceUnixSocketNamespace`: không gian tên mà ổ cắm miền Unix được tạo

Gửi
`AdbCommandRejectedException`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

Tạo một quy tắc chuyển tiếp cổng giữa cổng cục bộ và cổng từ xa.

Tham số
`localPort`	`int`: cổng cục bộ cần chuyển tiếp
`remotePort`	`int`: cổng từ xa.

Gửi
`AdbCommandRejectedException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

Tạo một cổng đảo ngược giữa cổng từ xa và cổng cục bộ.

Tham số
`remotePort`	`int`: cổng từ xa cần đảo ngược.
`localPort`	`int`: cổng cục bộ

Gửi
`AdbCommandRejectedException`
`TimeoutException`

executeBinderCommand

public void executeBinderCommand (String[] parameters, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

Thực thi một lệnh Binder trên thiết bị và gửi kết quả đến một receiver

Thao tác này sử dụng lệnh gọi exec:cmd hoặc abb_exec: nhanh hơn nếu cả hệ điều hành thiết bị và máy chủ ADB lưu trữ đều hỗ trợ tính năng thực thi Cầu liên kết Android.

Tham số
`parameters`	`String`: lệnh liên kết cần thực thi
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` sẽ nhận được đầu ra của lệnh liên kết
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`: luồng đầu vào không bắt buộc để gửi qua stdin

Gửi
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một receiver.

maxTimeToOutputResponse được dùng làm thời gian chờ tối đa khi dự kiến nhận được đầu ra lệnh từ thiết bị.
Bất cứ lúc nào, nếu lệnh shell không xuất ra bất kỳ nội dung nào trong khoảng thời gian dài hơn maxTimeToOutputResponse, thì phương thức này sẽ khai báo ngoại lệ ShellCommandUnresponsiveException.

Đối với các lệnh như đầu ra nhật ký, bạn nên sử dụng giá trị maxTimeToOutputResponse là 0, tức là phương thức sẽ không bao giờ truyền và sẽ chặn cho đến khi IShellOutputReceiver.isCancelled() của receiver trả về true.

Tham số
`command`	`String`: lệnh shell cần thực thi
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` sẽ nhận được đầu ra của lệnh shell
`maxTimeToOutputResponse`	`long`: khoảng thời gian tối đa mà lệnh được phép không xuất bất kỳ phản hồi nào. Giá trị 0 có nghĩa là phương thức sẽ đợi vô thời hạn (cho đến khi `receiver` huỷ thực thi) để có đầu ra lệnh và không bao giờ gửi.
`maxTimeUnits`	`TimeUnit`: Đơn vị cho các giá trị `maxTimeToOutputResponse` khác 0.

Gửi
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

Một phiên bản của lệnh executeShell có thể nhận luồng đầu vào để gửi qua stdin.

Tham số
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`

Gửi
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một receiver

Điều này tương tự như việc gọi executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

Tham số
`command`	`String`: lệnh shell cần thực thi
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` sẽ nhận được đầu ra của lệnh shell

Gửi
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                int maxTimeToOutputResponse)

Tham số
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

Gửi
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Thực thi một lệnh shell trên thiết bị và gửi kết quả đến một receiver.

Tham số
`command`	`String`: lệnh shell cần thực thi
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` sẽ nhận được đầu ra của lệnh shell
`maxTimeout`	`long`: thời gian chờ tối đa để lệnh trả về. Giá trị 0 có nghĩa là sẽ không áp dụng thời gian chờ tối đa.
`maxTimeToOutputResponse`	`long`: khoảng thời gian tối đa mà lệnh được phép không xuất bất kỳ phản hồi nào. Giá trị 0 có nghĩa là phương thức sẽ đợi vô thời hạn (cho đến khi `receiver` huỷ thực thi) để có đầu ra lệnh và không bao giờ gửi.
`maxTimeUnits`	`TimeUnit`: Đơn vị cho các giá trị `maxTimeout` và `maxTimeToOutputResponse` khác 0.

Gửi
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

forceStop

public void forceStop (String applicationName)

Buộc dừng một ứng dụng theo tên ứng dụng. Thao tác này sẽ xoá tất cả chuông báo đang chờ xử lý và phép tính được xếp hàng.

Tham số
`applicationName`	`String`: tên của ứng dụng

getAbis

public  getAbis ()

Trả về các ABI mà thiết bị này hỗ trợ. Các ABI được sắp xếp theo thứ tự ưu tiên, trong đó ABI đầu tiên được ưu tiên nhất.

Giá trị trả về
	danh sách ABI.

getAvdData

public ListenableFuture<AvdData> getAvdData ()

Trả về thông tin về AVD mà trình mô phỏng đang chạy.

AvdData.getName là tên của AVD hoặc null nếu không có tên nào.

AvdData.getPath là đường dẫn AVD hoặc giá trị rỗng nếu đây là một thiết bị thực, lệnh phụ của bảng điều khiển trình mô phỏng không thành công hoặc phiên bản của trình mô phỏng cũ hơn 30.0.18

Giá trị trả về
`ListenableFuture<AvdData>`	`AvdData` của thiết bị.

getAvdName

public String getAvdName ()

Trả về tên của AVD mà trình mô phỏng đang chạy.

Điều này chỉ hợp lệ nếu isEmulator() trả về true.

Nếu trình mô phỏng không chạy bất kỳ AVD nào (ví dụ: trình mô phỏng đang chạy từ bản dựng cây nguồn Android), phương thức này sẽ trả về "<build>".

Lưu ý: Nên dùng getAvdData() nếu bạn muốn kiểm soát thời gian chờ.

Giá trị trả về
`String`	tên của AVD hoặc `null` nếu không có tên nào.

getAvdPath

public String getAvdPath ()

Trả về đường dẫn tuyệt đối đến thiết bị ảo trong hệ thống tệp. Đường dẫn này phụ thuộc vào hệ điều hành; đường dẫn này sẽ có dấu phân cách / trên Linux và dấu phân cách \ trên Windows.

Lưu ý: Nên dùng getAvdData() nếu bạn muốn kiểm soát thời gian chờ.

Giá trị trả về
`String`	đường dẫn AVD hoặc giá trị rỗng nếu đây là một thiết bị thực, lệnh con của bảng điều khiển trình mô phỏng không thành công hoặc phiên bản của trình mô phỏng cũ hơn 30.0.18

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

Trả về mức pin của thiết bị, từ 0 đến 100 phần trăm.

Mức pin có thể được lưu vào bộ nhớ đệm. Chỉ truy vấn thiết bị để biết mức pin nếu freshnessTime đã hết hạn kể từ lần truy vấn thành công gần đây nhất.

Tham số
`freshnessTime`	`long`: mức độ gần đây mong muốn của mức pin
`timeUnit`	`TimeUnit`: `ERROR(/TimeUnit)` của freshnessTime

Giá trị trả về
	`ERROR(/Future)` có thể dùng để truy vấn mức pin. Future sẽ trả về một `ERROR(/ExecutionException)` nếu không truy xuất được mức pin.

getBattery

public  getBattery ()

Trả về mức pin của thiết bị, từ 0 đến 100 phần trăm.

Mức pin có thể được lưu vào bộ nhớ đệm. Chỉ truy vấn thiết bị để biết mức pin nếu đã hết 5 phút kể từ lần truy vấn thành công gần đây nhất.

Giá trị trả về
	`ERROR(/Future)` có thể dùng để truy vấn mức pin. Future sẽ trả về một `ERROR(/ExecutionException)` nếu không truy xuất được mức pin.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

Trả về mức pin của thiết bị, từ 0 đến 100 phần trăm.

Mức pin có thể được lưu vào bộ nhớ đệm. Chỉ truy vấn thiết bị để biết mức pin nếu freshnessMs mili giây đã trôi qua kể từ lần truy vấn thành công gần đây nhất.

Giá trị trả về
`Integer`	mức pin hoặc `null` nếu không truy xuất được

getBatteryLevel

public Integer getBatteryLevel ()

Trả về mức pin của thiết bị, từ 0 đến 100 phần trăm.

Mức pin có thể được lưu vào bộ nhớ đệm. Chỉ truy vấn thiết bị để biết mức pin nếu đã hết 5 phút kể từ lần truy vấn thành công gần đây nhất.

Giá trị trả về
`Integer`	mức pin hoặc `null` nếu không truy xuất được

getClient

public ClientImpl getClient (String applicationName)

Trả về một Client theo tên ứng dụng.

Tham số
`applicationName`	`String`: tên của ứng dụng

Giá trị trả về
`ClientImpl`	đối tượng `Client` hoặc `null` nếu không tìm thấy kết quả trùng khớp.

getClientName

public String getClientName (int pid)

Trả về tên của ứng dụng theo pid hoặc null nếu pid không xác định

Tham số
`pid`	`int`: pid của ứng dụng.

Giá trị trả về
`String`

getClientTracker

public ClientTracker getClientTracker ()

Giá trị trả về
`ClientTracker`

getClients

public ClientImpl[] getClients ()

Trả về mảng ứng dụng.

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

getDensity

public int getDensity ()

Trả về nhóm mật độ của màn hình thiết bị bằng cách đọc giá trị cho thuộc tính hệ thống PROP_DEVICE_DENSITY.

Giá trị trả về
`int`	mật độ hoặc -1 nếu không xác định được.

getFileListingService

public FileListingService getFileListingService ()

Trả về một FileListingService cho thiết bị này.

Giá trị trả về
`FileListingService`

getLanguage

public String getLanguage ()

Trả về ngôn ngữ của người dùng.

Giá trị trả về
`String`	ngôn ngữ của người dùng hoặc giá trị rỗng nếu không xác định được

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

Lấy thông tin về lần cài đặt gần đây nhất trên thiết bị này.

Giá trị trả về
`InstallMetrics`	`InstallMetrics` chỉ số mô tả lượt cài đặt.

getMountPoint

public String getMountPoint (String name)

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

Tham số
`name`	`String`: tên của điểm gắn cần trả về

Giá trị trả về
`String`

getName

public String getName ()

Trả về tên (dễ hiểu) cho thiết bị này. Thông thường, đây là tên AVD cho AVD và tổ hợp tên nhà sản xuất, tên mẫu mã và số sê-ri cho thiết bị.

Giá trị trả về
`String`

getNativeClients

public ClientImpl[] getNativeClients ()

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

getNativeClients

public ClientImpl getNativeClients (String applicationName)

Tham số
`applicationName`	`String`

Giá trị trả về
`ClientImpl`

getProfileableClients

public ProfileableClientImpl[] getProfileableClients ()

Trả về mảng gồm các ứng dụng có thể lập hồ sơ.

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

getProperties

public  getProperties ()

Trả về các thuộc tính của thiết bị được lưu vào bộ nhớ đệm. Nó chứa toàn bộ đầu ra của "getprop"

Giá trị trả về

getProperty

public String getProperty (String name)

Phương thức tiện lợi cố gắng truy xuất một thuộc tính thông qua IShellEnabledDevice.getSystemProperty(String) với thời gian chờ rất ngắn và loại bỏ các trường hợp ngoại lệ.

Lưu ý: Nên dùng IShellEnabledDevice.getSystemProperty(String) nếu bạn muốn kiểm soát thời gian chờ.

Tham số
`name`	`String`: tên của giá trị cần trả về.

Giá trị trả về
`String`	giá trị hoặc `null` nếu giá trị thuộc tính không có sẵn ngay lập tức

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

Kết hợp getProperty(String) và getPropertySync(String) để cố gắng truy xuất thuộc tính từ bộ nhớ đệm. Nếu không tìm thấy, sẽ cố gắng truy vấn thiết bị trực tiếp một cách đồng bộ và điền lại vào bộ nhớ đệm nếu thành công.

Tham số
`name`	`String`: tên của giá trị cần trả về.

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

getPropertyCount

public int getPropertyCount ()

Trả về số lượng tài sản cho thiết bị này.

Giá trị trả về
`int`

getPropertySync

public String getPropertySync (String name)

Một biến thể của getProperty(String) sẽ cố gắng truy xuất thuộc tính đã cho trực tiếp từ thiết bị mà không cần dùng bộ nhớ đệm. Phương thức này (chỉ) nên được dùng cho mọi thuộc tính biến động.

Tham số
`name`	`String`: tên của giá trị cần trả về.

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

getRegion

public String getRegion ()

Trả về khu vực của người dùng.

Giá trị trả về
`String`	khu vực của người dùng hoặc giá trị rỗng nếu không xác định được

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

Tham số
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`

Giá trị trả về
`String`

getScreenshot

public RawImage getScreenshot ()

Chụp ảnh màn hình của thiết bị và trả về ảnh đó dưới dạng RawImage.

Giá trị trả về
`RawImage`	ảnh chụp màn hình dưới dạng `RawImage` hoặc `null` nếu đã xảy ra lỗi.

Gửi
`AdbCommandRejectedException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Tham số
`timeout`	`long`
`unit`	`TimeUnit`

Giá trị trả về
`RawImage`

Gửi
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

Trả về số sê-ri của thiết bị.

Giá trị trả về
`String`

getState

public IDevice.DeviceState getState ()

Trả về trạng thái của thiết bị.

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

getSyncService

public SyncService getSyncService ()

Trả về một đối tượng SyncService để đẩy / kéo các tệp đến và đi từ thiết bị.

Giá trị trả về
`SyncService`	`null` nếu không tạo được SyncService. Điều này có thể xảy ra nếu adb từ chối mở kết nối vì `IDevice` không hợp lệ (hoặc bị ngắt kết nối).

Gửi
`AdbCommandRejectedException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

Thực hiện một truy vấn không đồng bộ tiềm năng cho một thuộc tính hệ thống.

Tham số
`name`	`String`: tên của giá trị cần trả về.

Giá trị trả về
`ListenableFuture<String>`	`ListenableFuture.` `ERROR(get/Future#get() get)` có thể trả về giá trị rỗng.

hasClients

public boolean hasClients ()

Trả về kết quả cho biết liệu IDevice có Client hay không.

Giá trị trả về
`boolean`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Cài đặt một ứng dụng Android trên thiết bị. Đây là một phương thức trợ giúp kết hợp các bước syncPackageToDevice, installRemotePackage và removePackage

Tham số
`packageFilePath`	`String`: đường dẫn tuyệt đối của hệ thống tệp đến tệp trên máy chủ lưu trữ cục bộ cần cài đặt
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`receiver`	`InstallReceiver`: `InstallReceiver` sẽ được dùng để theo dõi quá trình cài đặt và nhận trạng thái cuối cùng.
`maxTimeout`	`long`: thời gian chờ tối đa để lệnh trả về. Giá trị 0 có nghĩa là sẽ không áp dụng thời gian chờ tối đa.
`maxTimeToOutputResponse`	`long`: khoảng thời gian tối đa mà lệnh được phép không xuất bất kỳ phản hồi nào. Giá trị 0 có nghĩa là phương thức sẽ đợi vô thời hạn (cho đến khi `receiver` huỷ thực thi) để có đầu ra lệnh và không bao giờ gửi.
`maxTimeUnits`	`TimeUnit`: Đơn vị cho các giá trị `maxTimeout` và `maxTimeToOutputResponse` khác 0.
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.

Gửi
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Cài đặt một ứng dụng Android trên thiết bị. Đây là một phương thức trợ giúp kết hợp các bước syncPackageToDevice, installRemotePackage và removePackage

Tham số
`packageFilePath`	`String`: đường dẫn tuyệt đối của hệ thống tệp đến tệp trên máy chủ lưu trữ cục bộ cần cài đặt
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`receiver`	`InstallReceiver`: `InstallReceiver` sẽ được dùng để theo dõi quá trình cài đặt và nhận trạng thái cuối cùng.
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.

Gửi
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                String... extraArgs)

Cài đặt một ứng dụng Android trên thiết bị. Đây là một phương thức trợ giúp kết hợp các bước syncPackageToDevice, installRemotePackage và removePackage

Tham số
`packageFilePath`	`String`: đường dẫn tuyệt đối của hệ thống tệp đến tệp trên máy chủ lưu trữ cục bộ cần cài đặt
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.

Gửi
`InstallException`

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

Cài đặt một ứng dụng Android được tạo từ một số tệp APK (một gói chính và 0..n gói phân tách) với thời gian chờ mặc định

Tham số
`apks`	: danh sách các tệp APK cần cài đặt (1 APK chính + 0..n APK tách biệt)
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`installOptions`	: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.

Gửi
`InstallException`

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

Cài đặt một ứng dụng Android được tạo từ một số tệp APK (một gói chính và 0..n gói phân tách)

Tham số
`apks`	: danh sách các tệp APK cần cài đặt (1 APK chính + 0..n APK tách biệt)
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`installOptions`	: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.
`timeout`	`long`: thời gian chờ cài đặt
`timeoutUnit`	`TimeUnit`: `ERROR(/TimeUnit)` tương ứng với tham số thời gian chờ

Gửi
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Cài đặt gói ứng dụng đã được chuyển đến một vị trí tạm thời trên thiết bị.

Tham số
`remoteFilePath`	`String`: đường dẫn tuyệt đối đến tệp gói trên thiết bị
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`receiver`	`InstallReceiver`: `InstallReceiver` sẽ được dùng để theo dõi quá trình cài đặt và nhận trạng thái cuối cùng.
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.

Gửi
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

Cài đặt gói ứng dụng đã được chuyển đến một vị trí tạm thời trên thiết bị.

Tham số
`remoteFilePath`	`String`: đường dẫn tuyệt đối đến tệp gói trên thiết bị
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.

Gửi
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Cài đặt gói ứng dụng đã được chuyển đến một vị trí tạm thời trên thiết bị.

Tham số
`remoteFilePath`	`String`: đường dẫn tuyệt đối đến tệp gói trên thiết bị
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`receiver`	`InstallReceiver`: `InstallReceiver` sẽ được dùng để theo dõi quá trình cài đặt và nhận trạng thái cuối cùng.
`maxTimeout`	`long`: thời gian chờ tối đa để lệnh trả về. Giá trị 0 có nghĩa là sẽ không áp dụng thời gian chờ tối đa.
`maxTimeToOutputResponse`	`long`: khoảng thời gian tối đa mà lệnh được phép không xuất bất kỳ phản hồi nào. Giá trị 0 có nghĩa là phương thức sẽ đợi vô thời hạn (cho đến khi `receiver` huỷ thực thi) để có đầu ra lệnh và không bao giờ gửi.
`maxTimeUnits`	`TimeUnit`: Đơn vị cho các giá trị `maxTimeout` và `maxTimeToOutputResponse` khác 0.
`extraArgs`	`String`: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.

Gửi
`InstallException`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

Cài đặt một ứng dụng Android được tạo từ một số tệp APK nằm cục bộ trên thiết bị với thời gian chờ mặc định

Tham số
`remoteApks`	: danh sách đường dẫn tệp apk trên thiết bị để cài đặt
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`installOptions`	: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.

Gửi
`InstallException`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

Cài đặt một ứng dụng Android được tạo từ một số tệp APK nằm cục bộ trên thiết bị

Tham số
`remoteApks`	: danh sách các đường dẫn tệp apk nằm trên thiết bị để cài đặt
`reinstall`	`boolean`: đặt thành `true` nếu cần cài đặt lại ứng dụng
`installOptions`	: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm install --help" để biết các lựa chọn có sẵn.
`timeout`	`long`: thời gian chờ cài đặt
`timeoutUnit`	`TimeUnit`: `ERROR(/TimeUnit)` tương ứng với tham số thời gian chờ

Gửi
`InstallException`

isBootLoader

public boolean isBootLoader ()

Trả về nếu thiết bị đang ở chế độ trình tải khởi động.

Giá trị trả về
`boolean`	`true` nếu `getState()` trả về `DeviceState.BOOTLOADER`.

isEmulator

public boolean isEmulator ()

Trả về true nếu thiết bị là một trình mô phỏng.

Giá trị trả về
`boolean`

isOffline

public boolean isOffline ()

Trả về nếu thiết bị đang ngoại tuyến.

Giá trị trả về
`boolean`	`true` nếu `getState()` trả về `DeviceState.OFFLINE`.

isOnline

public boolean isOnline ()

Trả về nếu thiết bị đã sẵn sàng.

Giá trị trả về
`boolean`	`true` nếu `getState()` trả về `DeviceState.ONLINE`.

isRoot

public boolean isRoot ()

Truy vấn trạng thái root hiện tại của thiết bị. Hãy xem phần "adb root" để biết thêm thông tin.

Giá trị trả về
`boolean`	true nếu adb daemon đang chạy dưới dạng gốc, nếu không thì false.

Gửi
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

kill

public void kill (String applicationName)

Huỷ một ứng dụng theo tên ứng dụng. Thao tác này chỉ huỷ bỏ các hoạt động, để lại trạng thái của hoạt động trong hệ thống Android.

Tham số
`applicationName`	`String`: tên của ứng dụng

pullFile

public void pullFile (String remote, 
                String local)

Kéo một tệp.

Tham số
`remote`	`String`: đường dẫn đầy đủ đến tệp từ xa
`local`	`String`: Điểm đến tại địa phương.

Gửi
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

đẩy

public void push (String[] local, 
                String remote)

Đẩy một số tệp hoặc thư mục.

Tham số
`local`	`String`: các tệp cục bộ cần đẩy
`remote`	`String`: đường dẫn từ xa đại diện cho một thư mục

Gửi
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

Đẩy một tệp.

Tham số
`local`	`String`: đường dẫn tệp cục bộ.
`remote`	`String`: đường dẫn tệp từ xa

Gửi
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

rawBinder

public SocketChannel rawBinder (String service, 
                String[] parameters)

Gọi dịch vụ Android Binder Bridge trên một thiết bị từ xa. Trả về một kênh ổ cắm được kết nối với lệnh liên kết thiết bị.

Quyền sở hữu SocketChannel được chuyển giao cho phương thức gọi, phương thức này phải được đóng một cách rõ ràng sau khi sử dụng.

Tham số
`service`	`String`: tên của dịch vụ Android cần kết nối
`parameters`	`String`: các tham số của lệnh liên kết

Giá trị trả về
`SocketChannel`	SocketChannel được kết nối với quy trình thực thi trên thiết bị. sau khi sử dụng.

Gửi
`AdbCommandRejectedException`
`TimeoutException`

rawExec

public SocketChannel rawExec (String executable, 
                String[] parameters)

Gọi dịch vụ host:exec trên một thiết bị từ xa. Trả về một kênh ổ cắm được kết nối với quy trình thực thi. Xin lưu ý rằng dịch vụ exec không phân biệt stdout và stderr, vì vậy, bất cứ nội dung nào được đọc từ socket đều có thể đến từ cả hai đầu ra và được xen kẽ.

Quyền sở hữu SocketChannel được chuyển giao cho phương thức gọi, phương thức này phải được đóng một cách rõ ràng sau khi sử dụng.

Tham số
`executable`	`String`
`parameters`	`String`

Giá trị trả về
`SocketChannel`	SocketChannel được kết nối với quy trình thực thi trên thiết bị. sau khi sử dụng.

Gửi
`AdbCommandRejectedException`
`TimeoutException`

khởi động lại

public void reboot (String into)

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

Tham số
`into`	`String`: tên trình tải khởi động để khởi động lại, hoặc giá trị rỗng để chỉ khởi động lại thiết bị.

Gửi
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

Xoá một hoạt động chuyển tiếp cổng giữa cổng cục bộ và cổng từ xa.

Tham số
`localPort`	`int`: cổng cục bộ cần chuyển tiếp

Gửi
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

Xoá một tệp khỏi thiết bị.

Tham số
`remoteFilePath`	`String`: đường dẫn trên thiết bị của tệp cần xoá

Gửi
`InstallException`

removeReverse

public void removeReverse (int remotePort)

Xoá một cổng đảo ngược giữa cổng từ xa và cổng cục bộ.

Tham số
`remotePort`	`int`: cổng từ xa.

Gửi
`AdbCommandRejectedException`
`TimeoutException`

gốc

public boolean root ()

Yêu cầu trình nền adb trở thành gốc trên thiết bị. Thao tác này có thể không thành công một cách âm thầm và chỉ có thể thành công trên các bản dựng dành cho nhà phát triển. Hãy xem phần "adb root" để biết thêm thông tin.

Giá trị trả về
`boolean`	true nếu adb daemon đang chạy dưới dạng gốc, nếu không thì false.

Gửi
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

startScreenRecorder

public void startScreenRecorder (String remoteFilePath, 
                ScreenRecorderOptions options, 
                IShellOutputReceiver receiver)

Bắt đầu ghi màn hình trên thiết bị nếu thiết bị hỗ trợ IDevice.Feature.SCREEN_RECORD.

Tham số
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

Gửi
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature feature)

Trả về thông tin cho biết thiết bị này có hỗ trợ tính năng phần cứng đã cho hay không.

Tham số
`feature`	`IDevice.HardwareFeature`

Giá trị trả về
`boolean`

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

Trả về thông tin cho biết thiết bị này có hỗ trợ tính năng phần mềm đã cho hay không.

Tham số
`feature`	`IDevice.Feature`

Giá trị trả về
`boolean`

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

Đẩy tệp vào thiết bị

Tham số
`localFilePath`	`String`: đường dẫn tuyệt đối đến tệp trên máy chủ lưu trữ cục bộ

Giá trị trả về
`String`	Đường dẫn đích đến `String` trên thiết bị cho tệp

Gửi
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

toString

public String toString ()

Giá trị trả về
`String`

uninstallApp

public String uninstallApp (String applicationID, 
                String... extraArgs)

Gỡ cài đặt một ứng dụng khỏi thiết bị.

Tham số
`applicationID`	`String`: mã ứng dụng Android cần gỡ 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 install --help" để biết các lựa 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
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

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

Tham số
`packageName`	`String`: mã ứng dụng 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
`InstallException`