Google cam kết thúc đẩy công bằng chủng tộc cho các cộng đồng Đen. Xem thế nào.
Trang này được dịch bởi Cloud Translation API.
Switch to English

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


Cung cấp API cấp độ đáng tin cậy và cao hơn một chút cho IDevice IDevice .

Thử lại các lệnh của thiết bị với số lượng có thể định cấu hình và cung cấp giao diện khôi phục thiết bị cho các thiết bị không phản hồi.

Tóm lược

Hằng số

int UNKNOWN_API_LEVEL

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

Phương pháp công cộng

abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Kiểm tra xem một tính năng hiện có được hỗ trợ ở mức được hỗ trợ tối thiểu hay không.

abstract void clearLogcat ()

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

abstract void deleteFile (String deviceFilePath)

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

abstract boolean disableAdbRoot ()

Tắt gốc adb.

abstract boolean doesFileExist (String deviceFilePath)

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

abstract boolean enableAdbRoot ()

Bật gốc adb.

abstract boolean encryptDevice (boolean inplace)

Mã hóa thiết bị.

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.

abstract CommandResult executeFastbootCommand (String... commandArgs)

Phương thức trình 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.

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

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

abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

abstract String executeShellCommand (String command)

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

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

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

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

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

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command (String command)

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

abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

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

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

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

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

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

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

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

abstract CommandResult fastbootWipePartition (String partition)

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

abstract int getApiLevel ()

Nhận cấp API thiết bị.

abstract String getBasebandVersion ()

Phương pháp thuận tiện để có phiên bản baseband (radio) của thiết bị này.

abstract Integer getBattery ()

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

abstract String getBootloaderVersion ()

Phương pháp thuận tiện để có được phiên bản bootloader của thiết bị này.

abstract InputStreamSource getBugreport ()

Lấy một bugreport từ thiết bị.

abstract InputStreamSource getBugreportz ()

Lấy một bugreportz từ thiết bị.

abstract String getBuildAlias ()

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

Lấy bản dựng thiết bị hiện đang chạy.

abstract String getBuildSigningKeys ()

Trả về loại khóa được sử dụng để ký vào hình ảnh thiết bị

Thông thường, các thiết bị Android có thể được ký bằng các khóa kiểm tra (như trong AOSP) hoặc cá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ẻ)

abstract String[] getChildren (String deviceFilePath)

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

abstract String getDeviceClass ()

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

abstract long getDeviceDate ()

Trả về ngày của thiết bị tính bằng mili giây kể từ epoch.

abstract DeviceDescriptor getDeviceDescriptor ()

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

abstract TestDeviceState getDeviceState ()

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

abstract long getDeviceTimeOffset (Date date)

Giúp lấy chênh lệch thời gian giữa thiết bị và ERROR(/Date) .

abstract InputStreamSource getEmulatorOutput ()

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

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ị.

abstract String getFastbootProductType ()

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

abstract String getFastbootProductVariant ()

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

abstract IFileEntry getFileEntry (String path)

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

abstract IDevice getIDevice ()

Returns một tham chiếu đến ddmlib liên IDevice .

abstract long getLastExpectedRebootTimeMillis ()

Trả về lần cuối API được giao dịch đã kích hoạt khởi động lại sau một phần nghìn giây kể từ khi EPOCH được System.currentTimeMillis() trả về.

abstract InputStreamSource getLogcat ()

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

abstract InputStreamSource getLogcat (int maxBytes)

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

abstract InputStreamSource getLogcatDump ()

Nhận một bãi chứa logcat hiện tại cho thiết bị.

abstract InputStreamSource getLogcatSince (long date)

Lấy một luồng ảnh chụp nhanh của dữ liệu logcat đã bắt đầu từ ngày được cung cấp.

abstract String getMountPoint (String mountName)

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

abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

abstract getMountPointInfo ()

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

abstract long getPartitionFreeSpace (String partition)

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

abstract ProcessInfo getProcessByName (String processName)

Phương thức của trình trợ giúp chạy lệnh "ps" và trả về USER, PID và NAME của tên quy trình đã cho.

abstract String getProcessPid (String process)

Trả về giá trị dịch vụ hoặc null nếu có sự cố.

abstract getProcesses ()

Phương thức của trình trợ giúp chạy lệnh "ps" và trả về danh sách USER, PID và NAME của tất cả các quy trình.

abstract String getProductType ()

Phương pháp thuận tiện để có được loại sản phẩm của thiết bị này.

abstract String getProductVariant ()

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

abstract String getProperty (String name)

Lấy giá trị tài sản nhất định từ thiết bị.

abstract ITestDevice.RecoveryMode getRecoveryMode ()

Nhận chế độ phục hồi hiện tại được sử dụng cho thiết bị.

abstract String getSerialNumber ()

Phương pháp thuận tiện để có được số sê-ri của thiết bị này.

abstract getTombstones ()

Lấy và trả về danh sách bia mộ từ các thiết bị.

abstract long getTotalMemory ()

Trả về tổng kích thước bộ nhớ vật lý theo byte hoặc -1 trong trường hợp có lỗi nội bộ

abstract boolean getUseFastbootErase ()

Nhận xem nên sử dụng định dạng xóa fastboot hoặc fastboot để xóa phân vùng trên thiết bị.

abstract boolean isAdbRoot ()
abstract boolean isAdbTcp ()
abstract boolean isDeviceEncrypted ()

Trả về nếu thiết bị được mã hóa.

abstract boolean isDirectory (String deviceFilePath)

Trả về True nếu đường dẫn trên thiết bị là một thư mục, sai thì ngược lại.

abstract boolean isEncryptionSupported ()

Trả về nếu mã hóa được hỗ trợ trên thiết bị.

abstract boolean isExecutable (String fullPath)

Trả về Đúng nếu đường dẫn tệp trên thiết bị là tệp thực thi, nếu không thì sai.

abstract boolean isHeadless ()

Trả về true nếu thiết bị không đầu (không có màn hình), sai khác.

abstract boolean isRuntimePermissionSupported ()

Kiểm tra xem nền tảng trên thiết bị có hỗ trợ cấp quyền thời gian chạy không

abstract boolean logBugreport (String dataName, ITestLogger listener)

Phương thức trợ giúp để lấy một bugreport và đăng nhập nó cho các phóng viên.

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

Đăng nhập một tin nhắn trong logcat của thiết bị.

abstract void nonBlockingReboot ()

Đưa ra lệnh để khởi động lại thiết bị và trả về lệnh hoàn thành và khi thiết bị không còn hiển thị cho adb.

abstract void postBootSetup ()

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

abstract void postInvocationTearDown ()

Các bước bổ sung cho việc dọn dẹp theo yêu cầu cụ thể của thiết bị sẽ được thực hiện sau khi thực hiện yêu cầu.

abstract void preInvocationSetup ( IBuildInfo info)

Các bước bổ sung cho thiết lập yêu cầu cụ thể của thiết bị sẽ được thực hiện trên thiết bị trước luồng gọi.

default void preInvocationSetup ( IBuildInfo info, testResourceBuildInfos) preInvocationSetup ( IBuildInfo info, testResourceBuildInfos)

Các bước bổ sung cho thiết lập yêu cầu cụ thể của thiết bị sẽ được thực hiện trên thiết bị trước luồng gọi.

abstract boolean pullDir (String deviceFilePath, File localDir)

Đệ quy kéo nội dung thư mục từ thiết bị.

abstract File pullFile (String remoteFilePath)

Lấy một tập tin ra khỏi thiết bị, lưu nó trong một ERROR(/File) tạm thời cục bộ và trả về File đó.

abstract boolean pullFile (String remoteFilePath, File localFile)

Lấy một tập tin ra khỏi thiết bị.

abstract String pullFileContents (String remoteFilePath)

Lấy một tập tin ra khỏi thiết bị và trả về nội dung.

abstract File pullFileFromExternal (String remoteFilePath)

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

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

Đệ quy đẩy nội dung thư mục vào thiết bị trong khi loại trừ một số thư mục được lọc.

abstract boolean pushDir (File localDir, String deviceFilePath)

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

abstract boolean pushFile (File localFile, String deviceFilePath)

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

abstract boolean pushString (String contents, String deviceFilePath)

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

abstract void reboot ()

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

abstract void rebootIntoBootloader ()

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

abstract void rebootIntoRecovery ()

Khởi động lại thiết bị vào chế độ phục hồi adb.

abstract void rebootUntilOnline ()

Một thay thế để reboot() chỉ chặn cho đến khi thiết bị đang trực tuyến tức là hiển thị với adb.

abstract void remountSystemWritable ()

Làm cho phân vùng hệ thống trên thiết bị có thể ghi.

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

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

abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

Chạy thử nghiệm thiết bị, và cung cấp phục hồi thiết bị.

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

Giống như ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) nhưng chạy thử nghiệm cho một người dùng nhất định.

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

Giống như ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) cho người dùng nhất định.

abstract void setDate (Date date)

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

Lưu ý: cài đặt ngày trên thiết bị yêu cầu root

abstract void setOptions ( TestDeviceOptions options)

Đặt TestDeviceOptions cho thiết bị

abstract boolean setProperty (String propKey, String propValue)

Đặt giá trị thuộc tính đã cho trên thiết bị.

abstract void setRecovery ( IDeviceRecovery recovery)

Đặt IDeviceRecovery để sử dụng cho thiết bị này.

abstract void setRecoveryMode ( ITestDevice.RecoveryMode mode)

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

abstract void setUseFastbootErase (boolean useFastbootErase)

Đặt xem sử dụng định dạng xóa fastboot hoặc fastboot để xóa phân vùng trên thiết bị.

abstract void startLogcat ()

Bắt đầu chụp đầu ra logcat từ thiết bị trong nền.

abstract void stopEmulatorOutput ()

Đóng và xóa đầu ra giả lập.

abstract void stopLogcat ()

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

abstract String switchToAdbTcp ()

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

abstract boolean switchToAdbUsb ()

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

abstract boolean syncFiles (File localFileDir, String deviceFilePath)

Đồng bộ hóa nội dung của một thư mục tệp cục bộ vào thiết bị.

abstract Bugreport takeBugreport ()

Lấy một bugreport và trả nó vào trong một đối tượng Bugreport để xử lý nó.

abstract boolean unencryptDevice ()

Mở khóa thiết bị.

abstract boolean unlockDevice ()

Mở khóa thiết bị nếu thiết bị ở trạng thái được mã hóa.

abstract boolean waitForBootComplete (long timeOut)

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

abstract void waitForDeviceAvailable ()

Chờ thiết bị phản hồi và có sẵn để thử nghiệm.

abstract void waitForDeviceAvailable (long waitTime)

Chờ thiết bị phản hồi và có sẵn để thử nghiệm.

abstract boolean waitForDeviceInRecovery (long waitTime)

Các khối cho thiết bị ở trạng thái 'phục hồi adb' (lưu ý điều này khác với IDeviceRecovery ).

abstract boolean waitForDeviceNotAvailable (long waitTime)

Các khối cho thiết bị không khả dụng tức là thiếu adb

abstract void waitForDeviceOnline ()

Khối cho đến khi thiết bị được hiển thị thông qua adb.

abstract void waitForDeviceOnline (long waitTime)

Khối cho đến khi thiết bị được hiển thị thông qua adb.

abstract boolean waitForDeviceShell (long waitTime)

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

Hằng số

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

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

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

Phương pháp công cộng

kiểm traApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Kiểm tra xem một tính năng hiện có được hỗ trợ ở mức được hỗ trợ tối thiểu hay không. 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 mức API được nâng lên.

Thông số
strictMinLevel int : Mức tối thiểu có thể hỗ trợ tính năng.

Trả về
boolean Đúng nếu mức được hỗ trợ. Sai khác.

Ném
DeviceNotAvailableException

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 trợ giúp để xóa một tập tin hoặc thư mục trên thiết bị.

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

Ném
DeviceNotAvailableException

vô hiệu hóa

public abstract boolean disableAdbRoot ()

Tắt gốc adb.

Vô hiệu hóa root adb có thể khiến thiết bị ngắt kết nối với adb. Phương pháp này sẽ chặn cho đến khi thiết bị có sẵn.

Trả về
boolean true nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

Trả về
boolean true nếu tập tin tồn tại, false khác.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

enableAdbRoot

public abstract boolean enableAdbRoot ()

Bật gốc adb. 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.

Kích hoạt root adb có thể khiến thiết bị ngắt kết nối với adb. Phương pháp này sẽ chặn cho đến khi thiết bị có sẵn.

Trả về
boolean true nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

Thiết bị mã hóa

public abstract boolean encryptDevice (boolean inplace)

Mã hóa thiết bị.

Mã hóa thiết bị có thể được thực hiện tại chỗ hoặc bằng một lần lau. Mã hóa tại chỗ sẽ không xóa bất kỳ dữ liệu nào trên thiết bị nhưng thông thường sẽ mất một vài đơn đặt hàng lớn hơn thời gian xóa.

Phương pháp này sẽ khởi động lại thiết bị nếu nó chưa được mã hóa và sẽ chặn cho đến khi thiết bị trực tuyến. Ngoài ra, nó sẽ không giải mã thiết bị sau khi khởi động lại. Do đó, thiết bị có thể không được khởi động đầy đủ và / hoặc sẵn sàng để được kiểm tra khi phương thức này trở lại.

Thông số
inplace boolean : nếu quá trình mã hóa sẽ diễn ra và thiết bị không bị xóa.

Trả về
boolean true nếu thành công.

Ném
DeviceNotAvailableException nếu thiết bị không có sẵn sau khi khởi động lại.
UnsupportedOperationException nếu mã hóa không được hỗ trợ trên thiết bị.

thực thiAdbCommand

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 thức đó cung cấp hiệu suất và phát hiện lỗi tốt hơn.

Thông số
commandArgs String : lệnh adb và đối số để chạy

Trả về
String thiết bị xuất chuẩn từ lệnh. null nếu lệnh không thực thi.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Phương thức trình 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ế độ fastboot.

Thông số
commandArgs String : lệnh fastboot và các đối số để chạy

Trả về
CommandResult CommandResult chứa đầu ra của lệnh

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnFastbootCommand

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

Phương thức trình 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ế độ fastboot.

Thông số
timeout long : thời gian tính bằng mili giây trước khi lệnh hết hạn

commandArgs String : lệnh fastboot và các đối số để chạy

Trả về
CommandResult CommandResult chứa đầu ra của lệnh

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

Đồng nhất với executeFastbootCommand(String) ngoại trừ sử dụng thời gian chờ lâu hơn.

Thông số
commandArgs String : lệnh fastboot và các đối số để chạy

Trả về
CommandResult CommandResult chứa đầu ra của lệnh

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellCommand

public abstract String executeShellCommand (String command)

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

Thông số
command String : lệnh shell adb để chạy

Trả về
String đầu ra vỏ

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellCommand

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

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

Thông số
command String : lệnh shell adb để chạy

receiver IShellOutputReceiver : IShellOutputReceiver để đầu ra shell trực tiếp tới.

maxTimeToOutputShellResponse long : lượng thời gian tối đa mà lệnh được phép không xuất ra bất kỳ phản hồi nào; đơn vị như được chỉ định trong timeUnit

timeUnit TimeUnit : đơn vị cho maxTimeToOutputShellResponse

retryAttempts int : số lần tối đa để thử lại lệnh nếu thất bại do ngoại lệ. DeviceNotResponsiveException sẽ bị ném nếu retryAttempts được thực hiện mà không thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellCommand

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

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

Thông số
command String : lệnh shell adb để chạy

receiver IShellOutputReceiver : IShellOutputReceiver để đầu ra shell trực tiếp tới.

maxTimeoutForCommand long : thời gian chờ tối đa để lệnh hoàn thành; đơn vị như được chỉ định trong timeUnit

maxTimeToOutputShellResponse long : lượng thời gian tối đa mà lệnh được phép không xuất ra bất kỳ phản hồi nào; đơn vị như được chỉ định trong timeUnit

timeUnit TimeUnit : đơn vị cho maxTimeToOutputShellResponse

retryAttempts int : số lần tối đa để thử lại lệnh nếu thất bại do ngoại lệ. DeviceNotResponsiveException sẽ bị ném nếu retryAttempts được thực hiện mà không thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

Thông số
command String : lệnh shell adb để chạy

receiver IShellOutputReceiver : IShellOutputReceiver để đầu ra shell trực tiếp tới.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

Thông số
command String : Lệnh nên được chạy.

Trả về
CommandResult Kết quả trong CommandResult .

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

Thông số
command String : Lệnh nên được chạy.

pipeToOutput OutputStream : ERROR(/OutputStream) trong đó đầu ra tiêu chuẩn sẽ được chuyển hướng.

Trả về
CommandResult Kết quả trong CommandResult .

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

Thông số
command String : Lệnh nên được chạy.

pipeAsInput File : Một ERROR(/File) sẽ được chuyển thành đầu vào cho lệnh.

Trả về
CommandResult Kết quả trong CommandResult .

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellV2Command

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

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

Thông số
command String : lệnh shell adb để chạy

maxTimeoutForCommand long : thời gian chờ tối đa để lệnh hoàn thành; đơn vị như được chỉ định trong timeUnit

timeUnit TimeUnit : đơn vị cho maxTimeToOutputShellResponse

retryAttempts int : số lần tối đa để thử lại lệnh nếu thất bại do ngoại lệ. DeviceNotResponsiveException sẽ bị ném nếu retryAttempts được thực hiện mà không thành công.

Trả về
CommandResult

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellV2Command

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

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

Thông số
command String : lệnh shell adb để chạy

maxTimeoutForCommand long : thời gian chờ tối đa để lệnh hoàn thành; đơn vị như được chỉ định trong timeUnit

timeUnit TimeUnit : đơn vị cho maxTimeToOutputShellResponse

Trả về
CommandResult

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

thực hiệnShellV2Command

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

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

Thông số
command String : lệnh shell adb để chạy

pipeAsInput File : Một ERROR(/File) sẽ được chuyển thành đầu vào cho lệnh.

pipeToOutput OutputStream : ERROR(/OutputStream) trong đó đầu ra tiêu chuẩn sẽ được chuyển hướng.

maxTimeoutForCommand long : thời gian chờ tối đa để lệnh hoàn thành; đơn vị như được chỉ định trong timeUnit

timeUnit TimeUnit : đơn vị cho maxTimeToOutputShellResponse

retryAttempts int : số lần tối đa để thử lại lệnh nếu thất bại do ngoại lệ. DeviceNotResponsiveException sẽ bị ném nếu retryAttempts được thực hiện mà không thành công.

Trả về
CommandResult

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

Nếu getUseFastbootErase()true , thì việc 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 tin vào lần tiếp theo thiết bị khởi động. Mặt khác, đị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ế độ fastboot.

Thông số
partition String : phân vùng để xóa

Trả về
CommandResult CommandResult chứa đầu ra của lệnh

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

getApiLevel

public abstract int getApiLevel ()

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

Trả về
int một số nguyên chỉ mức API của thiết bị

Ném
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

Phương pháp thuận tiện để có phiên bản baseband (radio) của thiết bị này. Lấy phiên bản radio là thiết bị cụ thể, do đó, nó có thể không trả về thông tin chính xác cho tất cả các thiết bị. Phương pháp này dựa trên sự phù hợp của 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ả về phiên bản cho radio CDMA. TL; DR phương thức này chỉ báo cáo phiên bản chính xác nếu thuộc tính GSM.version.baseband giống với phiên bản được trả về bởi fastboot getvar version-baseband .

Trả về
String phiên bản cơ sở String hoặc null nếu không thể xác định được (thiết bị không có chuỗi radio hoặc chuỗi phiên bản không thể đọc được)

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

getBattery

public abstract Integer getBattery ()

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

Trả về
Integer

getBootloaderVersion

public abstract String getBootloaderVersion ()

Phương pháp thuận tiện để có được phiên bản bootloader 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ế độ fastboot, nó sẽ cố gắng truy xuất phiên bản từ fastboot)

Trả về
String phiên bản String bootloader hoặc null nếu không thể tìm thấy

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

getBugreport

public abstract InputStreamSource getBugreport ()

Lấy một bugreport 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ị mà không cần thẻ sdcard (hoặc khi chưa gắn thẻ sdcard).

Trả về
InputStreamSource Một InputStreamSource sẽ tạo ra các nội dung bugreport theo yêu cầu. Trong trường hợp thất bại, InputStreamSource sẽ tạo ra một ERROR(/InputStream) trống ERROR(/InputStream) .

getBugreportz

public abstract InputStreamSource getBugreportz ()

Lấy một bugreportz từ thiết bị. Bugreport định dạng zip chứa bugreport chính và các tệp nhật ký khác hữu ích để gỡ lỗi.

Chỉ được hỗ trợ cho 'phiên bản adb'> 1.0.36

Trả về
InputStreamSource một InputStreamSource của tệp zip chứa bugreportz, trả về null trong trường hợp thất bại.

getBuildAlias

public abstract String getBuildAlias ()

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

Bí danh xây dựng thường là một chuỗi dễ đọc hơn so với id xây 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ản dựng bí danh JDQ39 và bản dựng id 573038

Trả về
String bí danh xây dựng hoặc quay lại xây dựng id nếu không thể truy xuất được

Ném
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

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

Trả về
String hương vị xây dựng hoặc null nếu nó không thể được lấy

Ném
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

Lấy bản dựng thiết bị hiện đang chạy.

Trả về
String id xây dựng hoặc IBuildInfo#UNKNOWN_BUILD_ID nếu không thể truy xuất được

Ném
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

Trả về loại khóa được sử dụng để ký vào hình ảnh thiết bị

Thông thường, các thiết bị Android có thể được ký bằng các khóa kiểm tra (như trong AOSP) hoặc cá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ẻ)

Trả về
String Khóa ký nếu tìm thấy, null khác.

Ném
DeviceNotAvailableException

trẻ em

public abstract String[] getChildren (String deviceFilePath)

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

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

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

Ném
DeviceNotAvailableException

getDeviceClass

public abstract String getDeviceClass ()

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

Trả về
String lớp thiết bị String .

getDeviceDate

public abstract long getDeviceDate ()

Trả về ngày của thiết bị tính bằng mili giây kể từ epoch.

Trả về
long ngày của thiết bị ở định dạng kỷ nguyên.

Ném
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Trả về
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

Trả về
TestDeviceState

getDeviceTime Offerset

public abstract long getDeviceTimeOffset (Date date)

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

Thông số
date Date

Trả về
long sự khác biệt tính bằng mili giây

Ném
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

Trả về
InputStreamSource đầu ra giả lập

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ị.

Trả về
long lượng không gian trống tính bằng KB

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

getFastbootSản phẩm

public abstract String getFastbootProductType ()

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

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

Trả về
String Tên loại sản phẩm String hoặc null nếu không thể xác định được

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

getFastbootSản phẩmVariant

public abstract String getFastbootProductVariant ()

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

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

Trả về
String Tên loại sản phẩm String hoặc null nếu không thể xác định được

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

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ị.

Thông số
path String : đường dẫn tệp để lấy. Có thể là một đường dẫn tuyệt đối hoặc đường dẫn liên quan đến '/'. (tức là cả cú pháp "/ system" và "system" đều được hỗ trợ)

Trả về
IFileEntry IFileEntry hoặc null nếu không thể tìm thấy tệp tại path thể

Ném
DeviceNotAvailableException

nhận được

public abstract IDevice getIDevice ()

Returns một tham chiếu đến ddmlib liên IDevice .

IDevice mới có thể được phân bổ bởi DDMS mỗi khi thiết bị ngắt kết nối và kết nối lại từ adb. Do đó, 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ũ.

Trả về
IDevice IDevice

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Trả về lần cuối API được giao dịch đã kích hoạt khởi động lại sau một phần nghìn giây kể từ khi EPOCH được System.currentTimeMillis() trả về.

Trả về
long

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ế độ:

  • Nếu logcat hiện đang bị bắt trong nền, sẽ trở về TestDeviceOptions#getMaxLogcatDataSize() của nội dung hiện tại của bản ghi logcat nền
  • Nếu không, sẽ trả về kết xuất tĩnh của dữ liệu logcat nếu thiết bị hiện đang phản hồi

    Trả về
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

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

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

    Thông số
    maxBytes int : lượng dữ liệu tối đa để trả về. Nên là một lượng có thể thoải mái phù hợp với bộ nhớ

    Trả về
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

    Nhận một bãi chứa logcat hiện tại cho thiết bị. Không giống như getLogcat() , phương thức này sẽ luôn trả về kết xuất tĩnh của logcat.

    Có nhược điểm là không có gì sẽ được trả lại nếu không thể truy cập thiết bị.

    Trả về
    InputStreamSource một InputStreamSource của dữ liệu logcat. Một luồng trống được trả về nếu không chụp được dữ liệu logcat.

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

    Lấy một luồng ảnh chụp nhanh của dữ liệu logcat đã bắt đầu từ ngày được cung cấp. Thời gian trên thiết bị nên được sử dụng getDeviceDate() .

    Thông số
    date long : tính bằng mili giây kể từ định dạng kỷ nguyên khi bắt đầu ảnh chụp nhanh cho đến hiện tại. (có thể lấy được bằng cách sử dụng 'ngày +% s')

    Trả về
    InputStreamSource

    lấy điểm số

    public abstract String getMountPoint (String mountName)

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

    Truy vấn thiết bị trực tiếp nếu thông tin được lưu trong bộ nhớ cache trong IDevice không khả dụng.

    TODO: chuyển hành vi này sang IDevice#getMountPoint(String)

    Thông số
    mountName String : tên của điểm gắn kết

    Trả về
    String điểm gắn kết hoặc null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Thông số
    mountpoint String

    Trả về
    ITestDevice.MountPointInfo Một ERROR(/List) của MountPointInfo chứa thông tin trong "/ Proc / mounts"

    Ném
    DeviceNotAvailableException

    Xem thêm:

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

    Trả về
    Một ERROR(/List) của MountPointInfo chứa thông tin trong "/ Proc / mounts"

    Ném
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

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

    Thông số
    partition String

    Trả về
    long lượng không gian trống tính bằng KB

    Ném
    DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    Phương thức của trình trợ giúp chạy lệnh "ps" và trả về USER, PID và NAME của tên quy trình đã cho.

    Thông số
    processName String

    Trả về
    ProcessInfo ProcessInfo của processName đã cho

    Ném
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Trả về giá trị dịch vụ hoặc null nếu có sự cố.

    Thông số
    process String

    Trả về
    String

    Ném
    DeviceNotAvailableException

    getProcesses

    public abstract  getProcesses ()

    Phương thức của trình trợ giúp chạy lệnh "ps" và trả về danh sách USER, PID và NAME của tất cả các quy trình.

    Trả về
    Danh sách các đối tượng ProcessInfo

    Ném
    DeviceNotAvailableException

    getSản phẩm

    public abstract String getProductType ()

    Phương pháp thuận tiện để có được loại sản phẩm của thiết bị này.

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

    Trả về
    String tên loại sản phẩm String . Sẽ không có giá trị

    Ném
    DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi hoặc nếu không xác định được loại sản phẩm

    getSản phẩmVariant

    public abstract String getProductVariant ()

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

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

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

    Ném
    DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

    nhận được

    public abstract String getProperty (String name)

    Lấy giá trị tài sản nhất định từ thiết bị.

    Thông số
    name String : tên thuộc tính

    Trả về
    String giá trị tài sản hoặc null nếu nó không tồn tại

    Ném
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Nhận chế độ phục hồi hiện tại được sử dụng cho thiết bị.

    Trả về
    ITestDevice.RecoveryMode chế độ phục hồi hiện tại được sử dụng cho thiết bị.

    getSerialNumber

    public abstract String getSerialNumber ()

    Phương pháp thuận tiện để có được số sê-ri của thiết bị này.

    Trả về
    String số sê-ri String

    getTombstones

    public abstract  getTombstones ()

    Lấy và trả về danh sách bia mộ từ các thiết bị. Yêu cầu root.

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

    Trả về
    Một danh sách các tập tin bia mộ, trống nếu không có bia mộ.

    Ném
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

    Trả về tổng kích thước bộ nhớ vật lý theo byte hoặc -1 trong trường hợp có lỗi nội bộ

    Trả về
    long

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Nhận xem nên sử dụng định dạng xóa fastboot hoặc fastboot để xóa phân vùng trên thiết bị.

    Trả về
    boolean true nếu xóa fastboot sẽ được sử dụng hoặc false nếu định dạng fastboot sẽ được sử dụng.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Trả về
    boolean true nếu thiết bị hiện có root adb, false khác.

    Ném
    DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Trả về
    boolean true nếu thiết bị được kết nối với adb-over-tcp, false thì ngược lại.

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Trả về nếu thiết bị được mã hóa.

    Trả về
    boolean true nếu thiết bị được mã hóa.

    Ném
    DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể phục hồi.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Trả về True nếu đường dẫn trên thiết bị là một thư mục, sai thì ngược lại.

    Thông số
    deviceFilePath String

    Trả về
    boolean

    Ném
    DeviceNotAvailableException

    isEncryptSupported

    public abstract boolean isEncryptionSupported ()

    Trả về nếu mã hóa được hỗ trợ trên thiết bị.

    Trả về
    boolean true nếu thiết bị hỗ trợ mã hóa.

    Ném
    DeviceNotAvailableException

    có thể thực hiện được

    public abstract boolean isExecutable (String fullPath)

    Trả về Đúng nếu đường dẫn tệp trên thiết bị là tệp thực thi, nếu không thì sai.

    Thông số
    fullPath String

    Trả về
    boolean

    Ném
    DeviceNotAvailableException

    không có gì

    public abstract boolean isHeadless ()

    Trả về true nếu thiết bị không đầu (không có màn hình), sai khác.

    Trả về
    boolean

    Ném
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Check whether platform on device supports runtime permission granting

    Returns
    boolean True if runtime permission are supported, false otherwise.

    Throws
    DeviceNotAvailableException

    logBugreport

    public abstract boolean logBugreport (String dataName, 
                    ITestLogger listener)

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

    Parameters
    dataName String : name under which the bugreport will be reported.

    listener ITestLogger : an ITestLogger to log the bugreport.

    Returns
    boolean True if the logging was successful, false otherwise.

    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.

    Parameters
    tag String : The tag under which we log our message in the logcat.

    level Log.LogLevel : The debug level of the message in the logcat.

    format String : The message format.

    args Object : the args to be replaced via String.format().

    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.

    Throws
    DeviceNotAvailableException

    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)

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    postInvocationTearDown

    public abstract void postInvocationTearDown ()

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

    preInvocationSetup

    public abstract void preInvocationSetup ( IBuildInfo info)

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

    Parameters
    info IBuildInfo

    Throws
    DeviceNotAvailableException
    TargetSetupError

    preInvocationSetup

    public void preInvocationSetup ( IBuildInfo info, 
                     testResourceBuildInfos)

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

    Parameters
    info IBuildInfo

    testResourceBuildInfos

    Throws
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Recursively pull directory contents from device.

    Parameters
    deviceFilePath String : the absolute file path of the remote source

    localDir File : the local directory to pull files into

    Returns
    boolean true if file was pulled successfully. false otherwise.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract File pullFile (String remoteFilePath)

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

    Parameters
    remoteFilePath String : the absolute path to file on device.

    Returns
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Retrieves a file off device.

    Parameters
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    Returns
    boolean true if file was retrieved successfully. false otherwise.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    Parameters
    remoteFilePath String : the absolute path to file on device.

    Returns
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Throws
    DeviceNotAvailableException

    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 .

    Parameters
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    Returns
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushDir

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

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

    Parameters
    localDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    Returns
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    Parameters
    localDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    Returns
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

    Push a file to device

    Parameters
    localFile File : the local file to push

    deviceFilePath String : the remote destination absolute file path

    Returns
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Push file created from a string to device

    Parameters
    contents String : the contents of the file to push

    deviceFilePath String : the remote destination absolute file path

    Returns
    boolean true if string was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    reboot

    public abstract void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    Throws
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    Throws
    DeviceNotAvailableException if device is not available after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

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

    Throws
    DeviceNotAvailableException if device is not available after reboot

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

    Throws
    DeviceNotAvailableException

    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.

    Parameters
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    Returns
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    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.

    Parameters
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    Returns
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    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.

    Parameters
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Returns
    boolean

    Throws
    DeviceNotAvailableException

    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.

    Parameters
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Returns
    boolean

    Throws
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    Parameters
    date Date : specify a particular date; will use host date if null

    Throws
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions ( TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    Parameters
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

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

    Parameters
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    Returns
    boolean returns True if the setprop command was successful, False otherwise.

    Throws
    DeviceNotAvailableException

    setRecovery

    public abstract void setRecovery ( IDeviceRecovery recovery)

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

    Parameters
    recovery IDeviceRecovery : the IDeviceRecovery

    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

    Parameters
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

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

    Parameters
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    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.

    Returns
    String the tcp serial number or null if device could not be switched

    Throws
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    Returns
    boolean true if switch was successful, false otherwise.

    Throws
    DeviceNotAvailableException

    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.

    Parameters
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    Returns
    boolean true if files were synced successfully. false otherwise.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    takeBugreport

    public abstract Bugreport takeBugreport ()

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

    File referenced in the Bugreport object need to be cleaned via Bugreport#close() .

    Returns
    Bugreport

    unencryptDevice

    public abstract boolean unencryptDevice ()

    Unencrypts the device.

    Unencrypting the device may cause device to be wiped and may reboot device. This method will block until device is available and ready for testing. Requires fastboot inorder to wipe the userdata partition.

    Returns
    boolean true if successful.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.
    UnsupportedOperationException if encryption is not supported on the device.

    unlockDevice

    public abstract boolean unlockDevice ()

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

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    Returns
    boolean true if successful or if the device is unencrypted.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.
    UnsupportedOperationException if encryption is not supported on the device.

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

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

    Parameters
    timeOut long : time in msecs to wait for the flag to be set

    Returns
    boolean true if device's boot complete flag is set within the timeout

    Throws
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract void waitForDeviceAvailable ()

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

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceAvailable

    public abstract void waitForDeviceAvailable (long waitTime)

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

    Parameters
    waitTime long : the time in ms to wait

    Throws
    DeviceNotAvailableException if device is still unresponsive after waitTime expires.

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

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

    Parameters
    waitTime long : the time in ms to wait

    Returns
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

    Parameters
    waitTime long : the time in ms to wait

    Returns
    boolean true if device becomes not available before time expires. false otherwise

    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.

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    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.

    Parameters
    waitTime long : the time in ms to wait

    Throws
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

    Parameters
    waitTime long : the time in ms to wait

    Returns
    boolean true if device becomes responsive before waitTime elapses.