INativeDevice

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Giá trị mặc định khi không thể phát hiện Cấp API

Giá trị không đổi: -1 (0xffffffff)

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

clearLogcat

public abstract void clearLogcat ()

Xóa mọi dữ liệu logcat đã tích lũy.

Điều này hữu ích cho các trường hợp khi 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 flash một bản dựng thiết bị mới, v.v.).

xóa tài liệu

public abstract void deleteFile (String deviceFilePath)

Phương pháp người trợ giúp để xóa tệp hoặc thư mục trên thiết bị.

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Phương pháp 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 ProcessInfo trước đó. Sử dụng getProcessByName(String) để lấy ProcessInfo .

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Phương pháp của người trợ giúp để kiểm tra xem thiết bị có khởi động lại mềm kể từ thời điểm UTC kể từ kỷ nguyên từ thiết bị hay không và ERROR(/TimeUnit) của thiết bị. Soft-Restart đề cập đến system_server được khởi động lại bên ngoài khởi động lại cứng của thiết bị (ví dụ: khởi động lại được yêu cầu). Thiết bị hiện tại utcEpochTime trong Milliseccond có thể được lấy bằng phương thức getDeviceDate() .

vô hiệu hóaAdbRoot

public abstract boolean disableAdbRoot ()

Tắt adb root.

Việc tắt adb root 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 có thiết bị.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

Bật adb root. Nếu cài đặt "enable-root" là "false", sẽ ghi lại một thông báo và trả về mà không bật root.

Bật adb root 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 có thiết bị.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

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.

executeShellCommand(String) nên được sử dụng thay thế bất cứ khi nào có thể, vì phương pháp đó cung cấp khả năng phát hiện lỗi và hiệu suất tốt hơn.

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

executeShellCommand(String) nên được sử dụng thay thế bất cứ khi nào có thể, vì phương pháp đó cung cấp khả năng phát hiện lỗi và hiệu suất tốt hơn.

thực thiFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Phương thức trợ giúp thực thi lệnh fastboot 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.

thực thiFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

Phương thức trợ giúp thực thi lệnh fastboot 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.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

Phương thức trợ giúp thực thi lệnh fastboot đang chạy lâu 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 nhau để thực executeFastbootCommand(String) ngoại trừ sử dụng thời gian chờ lâu hơn.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

Phương thức trợ giúp thực thi lệnh fastboot chạy dài như một lệnh hệ thống.

Giống nhau để thực executeFastbootCommand(String) ngoại trừ sử dụng thời gian chờ lâu hơn.

executeShellCommand

public abstract String executeShellCommand (String command)

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

executeShellCommand

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

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

executeShellCommand

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

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

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Thực thi lệnh adb shell đã 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.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

executeShellV2Command

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

executeShellV2Command

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

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

executeShellV2Command

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

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Phương pháp trình trợ giúp xóa một phân vùng cho thiết bị.

Nếu getUseFastbootErase() là true , thì xóa fastboot sẽ được sử dụng để xóa 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 của thiết bị. Nếu không, định dạng fastboot được sử dụng sẽ tạo ra 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.

getApiLevel

public abstract int getApiLevel ()

Nhận Cấp API thiết bị. Mặc định là UNKNOWN_API_LEVEL .

getBasebandVersion

public abstract String getBasebandVersion ()

Phương pháp thuận tiện để lấy phiên bản băng tần cơ sở (radio) của thiết bị này. Việc tải phiên bản radio dành riêng cho thiết bị, vì vậy, nó có thể không trả lại thông tin chính xác cho tất cả các thiết bị. Phương thức này dựa vào đề xuất gsm.version.baseband để trả về thông tin phiên bản chính xác. Điều 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ả lại ở đây có thể không khớp với phiên bản được báo cáo từ fastboot và có thể không trả lại phiên bản cho đài CDMA. TL; DR phương pháp 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 được trả về bởi fastboot getvar version-baseband .

getBattery

public abstract Integer getBattery ()

Trả về mức pin hiện tại của thiết bị hoặc Null nếu mức pin không khả dụng.

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

getBootHistory

public abstract  getBootHistory ()

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

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Phương thức trình trợ giúp thu thập bản đồ lịch sử khởi động với thời gian khởi động và lý do khởi động kể từ thời điểm nhất định kể từ kỷ nguyên từ thiết bị và đơn vị thời gian được chỉ định. Thiết bị hiện tại utcEpochTime tính bằng Millisecond có thể được lấy bằng phương thức getDeviceDate() .

getBootloaderVersion

public abstract String getBootloaderVersion ()

Phương pháp thuận tiện để tải phiên bản bộ nạp khởi động của thiết bị này.

Sẽ cố gắng truy xuất phiên bản bộ nạp 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ị ở chế độ khởi động nhanh, nó sẽ cố gắng truy xuất phiên bản từ fastboot)

getBugreport

public abstract InputStreamSource getBugreport ()

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

Việc thực hiện điều này được đảm bảo tiếp tục hoạt động trên thiết bị không có thẻ sdcard (hoặc nơi thẻ sdcard chưa được gắn kết).

getBugreportz

public abstract InputStreamSource getBugreportz ()

Truy xuất báo cáo lỗi từ thiết bị. Báo cáo lỗi định dạng zip chứa 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

getBuildAlias

public abstract 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 id 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à bản dựng id 573038

getBuildFlavor

public abstract String getBuildFlavor ()

Truy xuất hương vị xây dựng cho thiết bị.

getBuildId

public abstract String getBuildId ()

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

getBuildSagingKeys

public abstract String getBuildSigningKeys ()

Trả về loại khóa được sử 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 khóa kiểm tra (như trong AOSP) hoặc khóa phát hành (được kiểm soát bởi các nhà sản xuất thiết bị riêng lẻ)

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Trả về DeviceDescriptor lưu trong bộ nhớ cache nếu thiết bị được cấp phát, nếu không sẽ trả về DeviceDescriptor hiện tại.

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Trả về DeviceDescriptor lưu trong bộ nhớ cache nếu thiết bị được cấp phát, nếu không sẽ trả về DeviceDescriptor hiện tại.

getChildren

public abstract String[] getChildren (String deviceFilePath)

Thay thế cho việc sử dụng IFileEntry đôi khi không hoạt động vì quyền.

getDeviceClass

public abstract String getDeviceClass ()

Nhận loại thiết bị.

getDeviceDate

public abstract long getDeviceDate ()

Trả lại ngày của thiết bị trong mili giây kể từ kỷ nguyên.

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

getDeviceState

public abstract TestDeviceState getDeviceState ()

Nhận trạng thái của thiết bị.

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Người trợ giúp nhận được 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ộ.

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Nhận luồng trình giả lập stdout và stderr

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

Phương pháp này chỉ nên được sử dụng nếu thiết bị phải ở chế độ khởi động nhanh. Biến thể của nó 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 fastboot nếu thiết bị ở trạng thái không chính xác hoặc không phản hồi.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

Phương pháp này chỉ nên được sử dụng nếu thiết bị phải ở chế độ khởi động nhanh. Biến thể của nó 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 fastboot nếu thiết bị ở trạng thái không chính xác hoặc không phản hồi.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Trả về số sê-ri của chế độ fastboot.

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Truy xuất giá trị biến fastboot đã cho từ thiết bị.

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

getIDevice

public abstract IDevice getIDevice ()

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

Một IDevice mới có thể được DDMS cấp phát mỗi khi thiết bị ngắt kết nối và kết nối lại từ adb. Vì vậy, người gọi không nên giữ một tham chiếu đến IDevice , vì tham chiếu đó có thể trở nên cũ.

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

getLastEosystemRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Trả về lần cuối cùng các API Tradefed kích hoạt khởi động lại trong mili giây kể từ EPOCH như được trả về bởi System.currentTimeMillis() .

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

getLogcat

public abstract InputStreamSource getLogcat ()

Lấy một luồng ảnh chụp nhanh của dữ liệu logcat.

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

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

Lấy một luồng ảnh chụp nhanh của maxBytes cuối cùng của dữ liệu logcat đã thu được.

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

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

Get a dump of the current logcat for device. Unlike getLogcat() , this method will always return a static dump of the logcat.

Has the disadvantage that nothing will be returned if device is not reachable.

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

Grabs a snapshot stream of captured logcat data starting the date provided. The time on the device should be used getDeviceDate() .

getMountPoint

public abstract String getMountPoint (String mountName)

Returns a mount point.

Queries the device directly if the cached info in IDevice is not available.

TODO: move this behavior to IDevice#getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Returns a MountPointInfo corresponding to the specified mountpoint path, or null if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.

getMountPointInfo

public abstract  getMountPointInfo ()

Returns a parsed version of the information in /proc/mounts on the device

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

Helper method to determine amount of free space on device partition.

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

Helper method runs the "pidof" and "stat" command and returns ProcessInfo object with PID and process start time of the given process.

getProcessPid

public abstract String getProcessPid (String process)

Returns the pid of the service or null if something went wrong.

getProductType

public abstract String getProductType ()

Convenience method to get the product type of this device.

This method will work if device is in either adb or fastboot mode.

getProductVariant

public abstract String getProductVariant ()

Convenience method to get the product variant of this device.

This method will work if device is in either adb or fastboot mode.

getProperty

public abstract String getProperty (String name)

Retrieve the given property value from the device.

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

Get the current recovery mode used for the device.

getSerialNumber

public abstract String getSerialNumber ()

Convenience method to get serial number of this device.

getTombstones

public abstract  getTombstones ()

Fetch and return the list of tombstones from the devices. Requires root.

method is best-effort so if one tombstone fails to be pulled for any reason it will be missing from the list. Only a DeviceNotAvailableException will terminate the method early.

getTotalMemory

public abstract long getTotalMemory ()

Returns total physical memory size in bytes or -1 in case of internal error

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

Get whether to use fastboot erase or fastboot format to wipe a partition on the device.

isAdbRoot

public abstract boolean isAdbRoot ()

isAdbTcp

public abstract boolean isAdbTcp ()

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

Check whether platform on device supports app enumeration

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

Returns if the device is encrypted.

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

Return True if the path on the device is a directory, false otherwise.

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

Returns if encryption is supported on the device.

isExecutable

public abstract boolean isExecutable (String fullPath)

Returns True if the file path on the device is an executable file, false otherwise.

isHeadless

public abstract boolean isHeadless ()

Return true if the device is headless (no screen), false otherwise.

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

Check whether platform on device supports runtime permission granting

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

Returns true if device is in TestDeviceState#FASTBOOT or TestDeviceState.FASTBOOTD .

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

Collects and log ANRs from the device.

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Helper method to take a bugreport and log it to the reporters.

logOnDevice

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

Log a message in the logcat of the device. This is a safe call that will not throw even if the logging fails.

nonBlockingReboot

public abstract void nonBlockingReboot ()

Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.

postBootSetup

public abstract void postBootSetup ()

Perform instructions to configure device for testing that after every boot.

Should be called after device is fully booted/available

In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot.

Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)

postInvocationTearDown

public void postInvocationTearDown ()

This method is deprecated.
Use postInvocationTearDown(Throwable) instead.

Extra steps for device specific required clean up that will be executed after the invocation is done.

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

Extra steps for device specific required clean up that will be executed after the invocation is done.

preInvocationSetup

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

Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

Recursively pull directory contents from device.

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

pullFile

public abstract File pullFile (String remoteFilePath)

Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

Retrieves a file off device.

pullFile

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

Retrieves a file off device.

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

Retrieves a file off device, and returns the contents.

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

Recursively push directory contents to device while excluding some directories that are filtered.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Recursively push directory contents to device.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

Push a file to device. By default using a content provider.

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Push file created from a string to device

reboot

public abstract void reboot ()

Reboots the device into adb mode.

Blocks until device becomes available.

reboot

public abstract void reboot (String reason)

Reboots the device into adb mode with given reason to be persisted across reboot.

Blocks until device becomes available.

Last reboot reason can be obtained by querying sys.boot.reason propety.

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

Reboots the device into bootloader mode.

Blocks until device is in bootloader mode.

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

Reboots the device into fastbootd mode.

Blocks until device is in fastbootd mode.

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

Reboots the device into adb recovery mode.

Blocks until device enters recovery

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

Reboots the device into adb sideload mode (note that this is a special mode under recovery)

Blocks until device enters sideload mode

rebootIntoSideload

public abstract void rebootIntoSideload ()

Reboots the device into adb sideload mode (note that this is a special mode under recovery)

Blocks until device enters sideload mode

rebootUntilOnline

public abstract void rebootUntilOnline ()

An alternate to reboot() that only blocks until device is online ie visible to adb.

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

An alternate to reboot() that only blocks until device is online ie visible to adb.

rebootUserspace

public abstract void rebootUserspace ()

Reboots only userspace part of device.

Blocks until device becomes available.

WARNING. Userspace reboot is currently under active development, use it on your own risk.

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

remountSystemWritable

public abstract void remountSystemWritable ()

Make the system partition on the device writable. May reboot the device.

remountVendorWritable

public abstract void remountVendorWritable ()

Make the vendor partition on the device writable. May reboot the device.

runInstrumentationTests

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

Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Runs instrumentation tests, and provides device recovery.

If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

runInstrumentationTestsAsUser

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

Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

runInstrumentationTestsAsUser

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

Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

setDate

public abstract void setDate (Date date)

Sets the date on device

Note: setting date on device requires root

setOptions

public abstract void setOptions (TestDeviceOptions options)

Set the TestDeviceOptions for the device

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

Sets the given property value on the device. Requires adb root is true.

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Set the current recovery mode to use for the device.

Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

startLogcat

public abstract void startLogcat ()

Start capturing logcat output from device in the background.

Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

When the device is no longer in use, stopLogcat() must be called.

startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

Close and delete the emulator output.

stopLogcat

public abstract void stopLogcat ()

Stop capturing logcat output from device, and discard currently saved logcat data.

Will have no effect if logcat output is not being captured.

switchToAdbTcp

public abstract String switchToAdbTcp ()

Switch device to adb-over-tcp mode.

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Switch device to adb over usb mode.

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Incrementally syncs the contents of a local file directory to device.

Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

Hidden files (with names starting with ".") will be ignored.

Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

takeBugreport

public abstract Bugreport takeBugreport ()

Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue.

unlockDevice

public abstract boolean unlockDevice ()

Unlocks the device if the device is in an encrypted state.

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

Blocks until the device's boot complete flag is set.

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

Waits for the device to be responsive and available for testing. Uses default timeout.

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

Waits for the device to be responsive and available for testing.

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

Blocks until device is visible via fastboot. Use default timeout.

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Blocks for the device to be in the 'adb sideload' state

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Blocks for the device to be not available ie missing from adb

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

Blocks until device is visible via adb. Uses default timeout

Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

Blocks until device is visible via adb.

Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Waits for device to be responsive to a basic adb shell command.