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.

StubDevice

public class StubDevice
extends Object implements IDevice

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

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

DeviceManager.FastbootDevice, NullDevice, RemoteAvdIDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

DeviceManager.FastbootDevice	Hình ảnh minh hoạ một thiết bị ở Chế độ khởi động nhanh.
NullDevice	`IDevice` là một phần giữ chỗ mà `DeviceManager` dùng để phân bổ khi `IDeviceSelection.nullDeviceRequested()` là `true`
RemoteAvdIDevice	`IDevice` là một phần giữ chỗ mà `DeviceManager` dùng để phân bổ khi `DeviceSelectionOptions.gceDeviceRequested()` là `true`
StubLocalAndroidVirtualDevice	`IDevice` là một phần giữ chỗ mà `DeviceManager` dùng để phân bổ khi `DeviceSelectionOptions.localVirtualDeviceRequested()` là `true`
VmRemoteDevice	Một thiết bị ảo từ xa mà chúng ta sẽ quản lý từ bên trong Máy ảo.

Triển khai phần giữ chỗ gốc của IDevice.

Tóm tắt

Hàm khởi tạo công khai
`StubDevice(String serial)`
`StubDevice(String serial, boolean isEmulator)`

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`	`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)` 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)` Phương thức này không được dùng nữa. sử dụng `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)`.
`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`.
	`getAbis()` Trả về các ABI mà thiết bị này hỗ trợ.
`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)` Phương thức này không được dùng nữa. hãy sử dụng `getBattery(long, TimeUnit)`.
`Integer`	`getBatteryLevel()` Phương thức này không được dùng nữa. hãy sử dụng `getBattery()`.
`Client`	`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
`Client[]`	`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.
`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.
	`getProperties()` Phương thức này không được dùng nữa. hãy sử dụng `getSystemProperty(String)`.
`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)` Phương thức này không được dùng nữa. hãy sử dụng `getProperty(String)`.
`int`	`getPropertyCount()` Phương thức này không được dùng nữa. không dùng nữa trong ddmlib với lý do là "chi tiết triển khai".
`String`	`getPropertySync(String name)` Phương thức này không được dùng nữa. hãy sử dụng `getProperty(String)`.
`String`	`getRegion()` Trả về khu vực của người dùng.
`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( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)` 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ị.
`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`	`pullFile(String remote, String local)` Kéo một tệp.
`void`	`pushFile(String local, String remote)` Đẩy một tệp.
`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`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`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`	`setSerial(String serial)`
`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 arg0)` 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`	`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

StubDevice

public StubDevice (String serial)

Tham số
`serial`	`String`

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

Tham số
`serial`	`String`
`isEmulator`	`boolean`

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`

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)

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)

Phương thức này không được dùng nữa.
sử dụng executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

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`

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.

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)

Phương thức này không được dùng nữa.
hãy sử dụng getBattery(long, 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 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

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

getBatteryLevel

public Integer getBatteryLevel ()

Phương thức này không được dùng nữa.
hãy sử dụng 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ề
`Integer`	mức pin hoặc `null` nếu không truy xuất được

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

getClient

public Client 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ề
`Client`	đố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`

getClients

public Client[] getClients ()

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

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

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

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`

getProperties

public  getProperties ()

Phương thức này không được dùng nữa.
hãy sử dụng getSystemProperty(String).

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)

Phương thức này không được dùng nữa.
hãy sử dụng getProperty(String).

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

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

getPropertyCount

public int getPropertyCount ()

Phương thức này không được dùng nữa.
không được dùng nữa trong ddmlib với lý do là "thông tin chi tiết về việc triển khai".

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)

Phương thức này không được dùng nữa.
hãy sử dụng getProperty(String).

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

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

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

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 ( apkFilePaths, 
                boolean reinstall, 
                 extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

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ố
`apkFilePaths`	: 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
`extraArgs`	: 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.
`timeOutInMs`	`long`: thời gian chờ cài đặt
`timeunit`	`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`

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`

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`

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`

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`

removeForward

public void removeForward (int localPort, 
                int remotePort)

Tham số
`localPort`	`int`
`remotePort`	`int`

Gửi
`AdbCommandRejectedException`
`TimeoutException`

removeForward

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

Tham số
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

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`

setSerial

public void setSerial (String serial)

Tham số
`serial`	`String`

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 arg0)

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ố
`arg0`	`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`

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`