INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

Thử lại các lệnh của thiết bị trong một khoảng thời gian có thể định cấu hình và cung cấp giao diện khôi phục thiết bị cho những thiết bị không phản hồi.

Tóm tắt

Hằng số

int UNKNOWN_API_LEVEL

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

Phương thức công khai

abstract boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

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

abstract void clearLogcat()

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

abstract void deleteFile(String deviceFilePath)

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

abstract void deleteFile(String deviceFilePath, int userId)

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

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

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

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại phần mềm kể từ thời gian UTC tính từ thời gian bắt đầu của hệ thống từ thiết bị và ERROR(/TimeUnit) của thiết bị hay không.

abstract boolean disableAdbRoot()

Tắt quyền truy cập của adb vào thư mục gốc.

abstract boolean doesFileExist(String deviceFilePath)

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

abstract boolean enableAdbRoot()

Bật quyền truy cập adb root.

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

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

abstract String executeAdbCommand(String... commandArgs)

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

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

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

abstract CommandResult executeAdbV2Command(long timeout, envMap, String... commandArgs)

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

abstract CommandResult executeAdbV2Command(String... commandArgs)

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

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

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

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

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

abstract CommandResult executeFastbootCommand(String... commandArgs)

Phương thức trợ giúp thực thi một 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 executeLongFastbootCommand(String... commandArgs)

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

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

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

abstract String executeShellCommand(String command)

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

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.

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.

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command(String command, File pipeAsInput)

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

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.

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.

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.

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.

abstract CommandResult fastbootWipePartition(String partition)

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

abstract int getApiLevel()

Lấy cấp độ API của thiết bị.

abstract String getBasebandVersion()

Phương thức thuận tiện để lấy phiên bản băng tần cơ sở (đài) 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 giá trị rỗng nếu không có thông tin về mức pin.

abstract boolean getBooleanProperty(String name, boolean defaultValue)

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

abstract getBootHistory()

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

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Phương thức trợ giúp thu thập bản đồ nhật ký khởi động với thời gian khởi động và lý do khởi động kể từ thời gian đã cho kể từ thời điểm bắt đầu tính thời gian trên thiết bị và đơn vị thời gian được chỉ định.

abstract String getBootloaderVersion()

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

abstract String getBuildAlias()

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

abstract String getBuildFlavor()

Truy xuất hương vị bản dựng cho thiết bị.

abstract String getBuildId()

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

abstract String getBuildSigningKeys()

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

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

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

Trả về kết nối được liên kết với thiết bị.

abstract String getDeviceClass()

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

abstract long getDeviceDate()

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

abstract DeviceDescriptor getDeviceDescriptor()

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

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

abstract TestDeviceState getDeviceState()

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

abstract long getDeviceTimeOffset(Date date)

Trợ giúp để biết sự khác biệt về thời gian giữa thiết bị và một ERROR(/Date) nhất định.

abstract InputStreamSource getEmulatorOutput()

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

abstract long getExternalStoreFreeSpace()

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

abstract String getFastbootProductType()

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

abstract String getFastbootProductVariant()

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

abstract String getFastbootSerialNumber()

Trả về số sê-ri ở chế độ fastboot.

abstract String getFastbootVariable(String variableName)

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

abstract IFileEntry getFileEntry(String path)

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

abstract IDevice getIDevice()

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

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

abstract long getLastExpectedRebootTimeMillis()

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

abstract int getLaunchApiLevel()

Nhận Cấp độ API được khởi chạy lần đầu của thiết bị.

abstract InputStreamSource getLogcat()

Lấy một luồng thông tin tổng quan nhanh về dữ liệu logcat.

abstract InputStreamSource getLogcat(int maxBytes)

Lấy một luồng ảnh chụp nhanh của maxBytes dữ liệu logcat đã chụp gần đây nhất.

abstract InputStreamSource getLogcatDump()

Nhận một bản kết xuất 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 đã ghi lại, 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ề một MountPointInfo tương ứng với đường dẫn đến điểm gắn đã chỉ định hoặc null nếu đường dẫn đó không có gì được gắn hoặc không xuất hiện trong /proc/mounts dưới dạng một điểm gắn.

abstract getMountPointInfo()

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

abstract long getPartitionFreeSpace(String partition)

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

abstract ProcessInfo getProcessByName(String processName)

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

abstract String getProcessPid(String process)

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

abstract String getProductType()

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

abstract String getProductVariant()

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

abstract String getProperty(String name)

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

abstract ITestDevice.RecoveryMode getRecoveryMode()

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

abstract String getSerialNumber()

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

abstract getTombstones()

Tìm nạp và trả về danh sách các tệp đánh dấu xoá khỏi thiết bị.

abstract long getTotalMemory()

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

default String getTrackingSerial()

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

abstract boolean getUseFastbootErase()

Lấy thông tin về việc có sử dụng lệnh xoá fastboot hay định dạng fastboot để xoá một phân vùng trên thiết bị hay không.

abstract boolean isAdbRoot()
abstract boolean isAdbTcp()
abstract boolean isAppEnumerationSupported()

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

abstract boolean isBypassLowTargetSdkBlockSupported()

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

abstract boolean isDebugfsMounted()

Kiểm tra xem debugfs đã được gắn hay chưa.

abstract boolean isDeviceEncrypted()

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

abstract boolean isDirectory(String deviceFilePath)

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

abstract boolean isEncryptionSupported()

Trả về nếu thiết bị có hỗ trợ mã hoá.

abstract boolean isExecutable(String fullPath)

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

abstract boolean isHeadless()

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

abstract boolean isRuntimePermissionSupported()

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

abstract boolean isStateBootloaderOrFastbootd()

Trả về true nếu thiết bị ở trạng thái TestDeviceState.FASTBOOT hoặc TestDeviceState.FASTBOOTD.

abstract boolean logAnrs(ITestLogger logger)

Thu thập và ghi lại lỗi ANR trên thiết bị.

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

Ghi nhật ký một thông báo trong logcat của thiết bị.

abstract void mountDebugfs()

Gắn debugfs.

abstract void nonBlockingReboot()

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

abstract void postBootSetup()

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

default void postInvocationTearDown()

Phương thức này không được dùng nữa. Hãy chuyển sang sử dụng postInvocationTearDown(Throwable).

abstract void postInvocationTearDown(Throwable invocationException)

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

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

Các bước bổ sung cho chế độ thiết lập bắt buộc dành riêng cho thiết bị sẽ được thực thi trên thiết bị trước quy trình gọi.

abstract boolean pullDir(String deviceFilePath, File localDir)

Truy xuất nội dung thư mục từ thiết bị theo cách đệ quy.

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

Truy xuất nội dung thư mục từ thiết bị theo cách đệ quy.

abstract File pullFile(String remoteFilePath, int userId)

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

abstract File pullFile(String remoteFilePath)

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

abstract boolean pullFile(String remoteFilePath, File localFile)

Truy xuất một tệp khỏi thiết bị.

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

Truy xuất một tệp khỏi thiết bị.

abstract String pullFileContents(String remoteFilePath)

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

abstract File pullFileFromExternal(String remoteFilePath)

Một phương thức thuận tiện để truy xuất mộ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ề một thông tin tham chiếu đến File đó.

abstract boolean pushDir(File localDir, String deviceFilePath, int userId)

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

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

Đẩy nội dung thư mục một cách đệ quy 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)

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

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

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

abstract boolean pushFile(File localFile, String deviceFilePath)

Đẩy một tệp đến thiết bị.

abstract boolean pushFile(File localFile, String deviceFilePath, int userId)

Đẩy một tệp đến thiết bị.

abstract boolean pushString(String contents, String deviceFilePath)

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

abstract void reboot()

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

abstract void reboot(String reason)

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

abstract void rebootIntoBootloader()

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

abstract void rebootIntoFastbootd()

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

abstract void rebootIntoRecovery()

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

abstract void rebootIntoSideload(boolean autoReboot)

Khởi động lại thiết bị ở chế độ cài đặt không qua cửa hàng adb (lưu ý rằng đây là một chế độ đặc biệt trong chế độ khôi phục)

Chặn cho đến khi thiết bị chuyển sang chế độ tải qua một bên

abstract void rebootIntoSideload()

Khởi động lại thiết bị ở chế độ cài đặt không qua cửa hàng adb (lưu ý rằng đây là một chế độ đặc biệt trong chế độ khôi phục)

Chặn cho đến khi thiết bị chuyển sang chế độ tải qua một bên

abstract void rebootUntilOnline()

Một lựa chọn thay thế cho reboot() chỉ chặn cho đến khi thiết bị kết nối mạng, tức là adb có thể nhìn thấy.

abstract void rebootUntilOnline(String reason)

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

abstract void rebootUserspace()

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

abstract void rebootUserspaceUntilOnline()

Một lựa chọn thay thế cho rebootUserspace() ()} chỉ chặn cho đến khi thiết bị trực tuyến, tức là có thể thấy được đối với adb.

abstract void remountSystemReadOnly()

Chuyển phân vùng hệ thống trên thiết bị sang chế độ chỉ đọc.

abstract void remountSystemWritable()

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

abstract void remountVendorReadOnly()

Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ chỉ đọc.

abstract void remountVendorWritable()

Cho phép ghi vào phân vùng nhà cung cấp trên thiết bị.

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

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

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

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

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

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

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

abstract void setDate(Date date)

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

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

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 setTrackingSerial(String trackingSerial)

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

abstract void setUseFastbootErase(boolean useFastbootErase)

Đặt xem có sử dụng lệnh fastboot erase hay fastboot format để xoá một phân vùng trên thiết bị hay không.

abstract void startLogcat()

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

abstract boolean startTradeInModeTesting(int timeoutMs)

Bật chế độ kiểm thử giao dịch thu cũ đổi mới.

abstract void stopEmulatorOutput()

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

abstract void stopLogcat()

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

abstract void stopTradeInModeTesting()

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

abstract String switchToAdbTcp()

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

abstract boolean switchToAdbUsb()

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

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

Đồng bộ hoá nội dung của một thư mục tệp cục bộ với thiết bị theo từng bước.

abstract boolean unlockDevice()

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

abstract void unmountDebugfs()

Huỷ gắn debugfs.

abstract boolean waitForBootComplete(long timeOut)

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

abstract boolean waitForDeviceAvailable()

Chờ thiết bị phản hồi và sẵn sàng cho việc kiểm thử.

abstract boolean waitForDeviceAvailable(long waitTime)

Chờ thiết bị phản hồi và sẵn sàng cho việc kiểm thử.

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

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

abstract void waitForDeviceBootloader()

Chặn cho đến khi thiết bị xuất hiện qua fastboot.

abstract boolean waitForDeviceInRecovery(long waitTime)

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

abstract boolean waitForDeviceInSideload(long waitTime)

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

abstract boolean waitForDeviceNotAvailable(long waitTime)

Các khối để thiết bị không hoạt động, tức là không có trong adb

abstract void waitForDeviceOnline()

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

abstract void waitForDeviceOnline(long waitTime)

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

abstract boolean waitForDeviceShell(long waitTime)

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

Hằng số

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

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

Giá trị hằng số: -1 (0xffffffff)

Phương thức công khai

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

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

clearLogcat

public abstract void clearLogcat ()

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

userId int: Mã nhận dạng người dùng cần xoá

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

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

Gửi
RuntimeException nếu thiết bị có lý do khởi động bất thường
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

timeUnit TimeUnit: đơn vị thời gian TimeUnit cho utcEpochTime đã cho.

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

Gửi
RuntimeException nếu thiết bị có lý do khởi động bất thường
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

disableAdbRoot

public abstract boolean disableAdbRoot ()

Tắt quyền truy cập của adb vào thư mục gốc.

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

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

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

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

executeAdbCommand

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

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

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

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

commandArgs String: lệnh adb và các đối số cần chạy

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

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

Tham số
commandArgs String: lệnh adb và các đối số cần chạy

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

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

executeAdbCommand

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

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

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

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

envMap : môi trường cần đặt cho lệnh

commandArgs String: lệnh adb và các đối số cần chạy

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... commandArgs)

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

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

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

envMap : môi trường cần đặt cho lệnh

commandArgs String: lệnh adb và các đối số cần chạy

Giá trị trả về
CommandResult CommandResult chứa đầu ra của lệnh.

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

Tham số
commandArgs String: lệnh adb và các đối số cần chạy

Giá trị trả về
CommandResult CommandResult chứa đầu ra của lệnh.

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

executeAdbV2Command

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

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

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

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

commandArgs String: lệnh adb và các đối số cần chạy

Giá trị trả về
CommandResult CommandResult chứa đầu ra của lệnh.

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

executeFastbootCommand

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

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

Dự kiến được dùng khi thiết bị đã ở chế độ fastboot.

Tham 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

Giá trị trả về
CommandResult CommandResult chứa đầu ra của lệnh

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Phương thức trợ giúp thực thi một 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 được dùng khi thiết bị đã ở chế độ fastboot.

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

Giá trị trả về
CommandResult CommandResult chứa đầu ra của lệnh

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

Tương tự như executeFastbootCommand(String), ngoại trừ việc sử dụng thời gian chờ lâu hơn.

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

Giá trị trả về
CommandResult CommandResult chứa đầu ra của lệnh

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

executeLongFastbootCommand

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

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

Tương tự như executeFastbootCommand(String), ngoại trừ việc sử dụng thời gian chờ lâu hơn.

Tham số
envVarMap : các biến môi trường hệ thống mà lệnh fastboot chạy cùng

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

Giá trị trả về
CommandResult CommandResult chứa đầu ra của lệnh

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

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

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

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.

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

receiver IShellOutputReceiver: IShellOutputReceiver để chuyển hướng đầu ra của shell đến.

maxTimeToOutputShellResponse long: khoảng thời gian tối đa mà lệnh được phép không đưa ra 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 lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được.

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

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.

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

receiver IShellOutputReceiver: IShellOutputReceiver để chuyển hướng đầu ra của shell đến.

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

maxTimeToOutputShellResponse long: khoảng thời gian tối đa mà lệnh không được phép đưa 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 lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được.

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

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.

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

receiver IShellOutputReceiver: IShellOutputReceiver để chuyển hướng đầu ra của shell đến.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

Giá trị trả về
CommandResult Kết quả bằng CommandResult.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

pipeToOutput OutputStream: ERROR(/OutputStream) nơi đầu ra chuẩn sẽ được chuyển hướng hoặc giá trị rỗng.

Giá trị trả về
CommandResult Kết quả bằng CommandResult.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

pipeAsInput File: Một ERROR(/File) sẽ được chuyển hướng làm dữ liệu đầu vào cho lệnh hoặc giá trị rỗng.

Giá trị trả về
CommandResult Kết quả bằng CommandResult.

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

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.

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

maxTimeoutForCommand long: thời gian chờ tối đa để lệnh hoàn tất; đơ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 lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được.

Giá trị trả về
CommandResult

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

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.

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

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

timeUnit TimeUnit: đơn vị cho maxTimeToOutputShellResponse

Giá trị trả về
CommandResult

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

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.

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

pipeAsInput File: Một ERROR(/File) sẽ được chuyển hướng làm dữ liệu đầu vào cho lệnh hoặc giá trị rỗng.

pipeToOutput OutputStream: ERROR(/OutputStream) nơi đầu ra chuẩn sẽ được chuyển hướng hoặc giá trị rỗng.

maxTimeoutForCommand long: thời gian chờ tối đa để lệnh hoàn tất; đơ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 lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được.

Giá trị trả về
CommandResult

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

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.

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

pipeAsInput File: Một ERROR(/File) sẽ được chuyển hướng làm dữ liệu đầu vào cho lệnh hoặc giá trị rỗng.

pipeToOutput OutputStream: ERROR(/OutputStream) nơi đầu ra chuẩn sẽ được chuyển hướng hoặc giá trị rỗng.

pipeToError OutputStream: ERROR(/OutputStream) nơi lỗi std sẽ được chuyển hướng hoặc giá trị rỗng.

maxTimeoutForCommand long: thời gian chờ tối đa để lệnh hoàn tất; đơ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 lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được.

Giá trị trả về
CommandResult

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

Dự kiến được dùng khi thiết bị đã ở chế độ fastboot.

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

Giá trị trả về
CommandResult CommandResult chứa đầu ra của lệnh

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

getApiLevel

public abstract int getApiLevel ()

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

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

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

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBattery

public abstract Integer getBattery ()

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

Giá trị trả về
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

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

Giá trị trả về
boolean true nếu thuộc tính có giá trị "1", "y", "yes", "on" hoặc "true", false nếu thuộc tính có giá trị "0", "n", "no", "off", "false" hoặc defaultValue trong trường hợp khác.

Gửi
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

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

Gửi
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Tham số
utcEpochTime long: thời gian của thiết bị kể từ Epoch.

timeUnit TimeUnit: đơn vị thời gian TimeUnit.

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

Gửi
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

Truy xuất hương vị bản dựng cho thiết bị.

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

Giá trị trả về
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

Tham số
shortDescriptor boolean: Có giới hạn nội dung mô tả ở mức tối thiểu hay không

Giá trị trả về
DeviceDescriptor

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

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

getConnection

public abstract AbstractConnection getConnection ()

Trả về kết nối được liên kết với thiết bị.

Giá trị trả về
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

Giá trị trả về
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

Tham số
shortDescriptor boolean: Có giới hạn nội dung mô tả ở mức tối thiểu hay không

Giá trị trả về
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

Giá trị trả về
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Trợ giúp để biết sự khác biệt về thời gian giữa thiết bị và một ERROR(/Date) nhất định. Sử dụng Epoch time nội bộ.

Tham số
date Date

Giá trị trả về
long mức chênh lệch tính bằng mili giây

Gửi
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

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

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

Bạn chỉ nên sử dụng phương thức này nếu thiết bị cần ở chế độ 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 cách khôi phục thiết bị vào chế độ fastboot nếu thiết bị ở trạng thái không chính xác hoặc không phản hồi.

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

Bạn chỉ nên sử dụng phương thức này nếu thiết bị cần ở chế độ 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 cách khôi phục thiết bị vào chế độ fastboot nếu thiết bị ở trạng thái không chính xác hoặc không phản hồi.

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Trả về số sê-ri ở chế độ fastboot.

Giá trị trả về
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

Gửi
UnsupportedOperationException
DeviceNotAvailableException

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

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

getIDevice

public abstract IDevice getIDevice ()

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

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

Giá trị trả về
IDevice IDevice

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

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

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

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

Gửi
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

Giá trị trả về
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

Giá trị trả về
int một số nguyên cho biết Cấp độ API đầu tiên mà thiết bị đã chạy

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

getLogcat

public abstract InputStreamSource getLogcat ()

Lấy một luồng thông tin tổng quan nhanh về dữ liệu logcat.

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

  • Nếu logcat hiện đang được ghi lại ở chế độ nền, thì sẽ trả về tối đa TestDeviceOptions.getMaxLogcatDataSize() byte nội dung hiện tại của quá trình ghi lại logcat ở chế độ nền
  • Nếu không, sẽ trả về một bản kết xuất tĩnh của dữ liệu logcat nếu thiết bị hiện đang phản hồi

    Giá trị trả về
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

    Lấy một luồng ảnh chụp nhanh của maxBytes dữ liệu logcat đã chụp gần đây nhất.

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

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

    Giá trị trả về
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

    Giá trị trả về
    InputStreamSource InputStreamSource của dữ liệu logcat. Một luồng trống sẽ đượ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 đã ghi lại, bắt đầu từ ngày được cung cấp. Bạn nên sử dụng thời gian trên thiết bị getDeviceDate().

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

    Giá trị trả về
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

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

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

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

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

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

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Tham số
    mountpoint String

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

    Gửi
    DeviceNotAvailableException

    Xem thêm:

    getMountPointInfo

    public abstract  getMountPointInfo ()

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

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

    Gửi
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

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

    Tham số
    partition String

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

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

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

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

    Tham số
    processName String: tên quy trình String.

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

    Gửi
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

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

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

    Giá trị trả về
    String

    Gửi
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

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

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

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

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

    getProductVariant

    public abstract String getProductVariant ()

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

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

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

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

    getProperty

    public abstract String getProperty (String name)

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

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

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

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

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getSerialNumber

    public abstract String getSerialNumber ()

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

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

    getTombstones

    public abstract  getTombstones ()

    Tìm nạp và trả về danh sách các tệp đánh dấu xoá khỏi thiết bị. Yêu cầu quyền truy cập vào thư mục gốc.

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

    Giá trị trả về
    Danh sách các tệp đánh dấu xoá, trống nếu không có tệp đánh dấu xoá.

    Gửi
    DeviceNotAvailableException

    getTotalMemory

    public abstract long getTotalMemory ()

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

    Giá trị trả về
    long

    getTrackingSerial

    public String getTrackingSerial ()

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

    Giá trị trả về
    String

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

    Lấy thông tin về việc có sử dụng lệnh xoá fastboot hay định dạng fastboot để xoá một phân vùng trên thiết bị hay không.

    Giá trị trả về
    boolean true nếu bạn sẽ dùng lệnh xoá fastboot hoặc false nếu bạn sẽ dùng lệnh định dạng fastboot.

    isAdbRoot

    public abstract boolean isAdbRoot ()

    Giá trị trả về
    boolean true nếu thiết bị hiện có quyền truy cập gốc adb, false nếu không.

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

    isAdbTcp

    public abstract boolean isAdbTcp ()

    Giá trị trả về
    boolean true nếu thiết bị được kết nối với adb-over-tcp, false nếu không.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

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

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

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

    isBypassLowTargetSdkBlockSupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

    Giá trị trả về
    boolean True nếu được hỗ trợ bỏ qua khối sdk mục tiêu thấp, false nếu không

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

    isDebugfsMounted

    public abstract boolean isDebugfsMounted ()

    Kiểm tra xem debugfs đã được gắn hay chưa.

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

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

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

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

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

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

    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, trả về false nếu không.

    Tham số
    deviceFilePath String

    Giá trị trả về
    boolean

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

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

    Trả về nếu thiết bị có hỗ trợ mã hoá.

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

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

    isExecutable

    public abstract boolean isExecutable (String fullPath)

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

    Tham số
    fullPath String

    Giá trị trả về
    boolean

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

    isHeadless

    public abstract boolean isHeadless ()

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

    Giá trị trả về
    boolean

    Gửi
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

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

    Giá trị trả về
    boolean True nếu được hỗ trợ quyền trong thời gian chạy, false nếu không.

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

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Trả về true nếu thiết bị ở trạng thái TestDeviceState.FASTBOOT hoặc TestDeviceState.FASTBOOTD.

    Giá trị trả về
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Thu thập và ghi lại lỗi ANR trên thiết bị.

    Tham số
    logger ITestLogger: một ITestLogger để ghi lại các lỗi ANR.

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

    Gửi
    DeviceNotAvailableException

    logOnDevice

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

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

    Tham số
    tag String: Thẻ mà chúng ta dùng để ghi thông báo vào logcat.

    level Log.LogLevel: Cấp gỡ lỗi của thông báo trong logcat.

    format String: Định dạng thư.

    args Object: các đối số sẽ được thay thế thông qua String.format().

    mountDebugfs

    public abstract void mountDebugfs ()

    Gắn debugfs.

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

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

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

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

    postBootSetup

    public abstract void postBootSetup ()

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

    Phải được gọi sau khi thiết bị khởi động/sẵn sàng hoàn toàn

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

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

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

    postInvocationTearDown

    public void postInvocationTearDown ()

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

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

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

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

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

    preInvocationSetup

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

    Các bước bổ sung cho chế độ thiết lập bắt buộc dành riêng cho thiết bị sẽ được thực thi trên thiết bị trước quy trình gọi.

    Tham số
    info IBuildInfo: IBuildInfo của thiết bị.

    attributes MultiMap: Các thuộc tính được lưu trữ trong ngữ cảnh gọi

    Gửi
    com.android.tradefed.targetprep.TargetSetupError
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public abstract boolean pullDir (String deviceFilePath, 
                    File localDir)

    Truy xuất nội dung thư mục từ thiết bị theo cách đệ quy.

    Tham số
    deviceFilePath String: đường dẫn tuyệt đối đến tệp của nguồn từ xa

    localDir File: thư mục cục bộ để kéo tệp vào

    Giá trị trả về
    boolean true nếu tệp được kéo thành công. Nếu không thì là false.

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

    pullDir

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

    Truy xuất nội dung thư mục từ thiết bị theo cách đệ quy.

    Tham số
    deviceFilePath String: đường dẫn tuyệt đối đến tệp của nguồn từ xa

    localDir File: thư mục cục bộ để kéo tệp vào

    userId int: mã người dùng cần lấy

    Giá trị trả về
    boolean true nếu tệp được kéo thành công. Nếu không thì là false.

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

    pullFile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int: Mã nhận dạng người dùng cần lấy

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

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

    pullFile

    public abstract File pullFile (String remoteFilePath)

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

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

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

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

    pullFile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

    Truy xuất một tệp khỏi thiết bị.

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

    localFile File: tệp cục bộ để lưu trữ nội dung. Nếu không trống, nội dung sẽ được thay thế.

    Giá trị trả về
    boolean true nếu truy xuất tệp thành công. Nếu không thì là false.

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

    pullFile

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

    Truy xuất một tệp khỏi thiết bị.

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

    localFile File: tệp cục bộ để lưu trữ nội dung. Nếu không trống, nội dung sẽ được thay thế.

    userId int: Mã nhận dạng người dùng cần lấy

    Giá trị trả về
    boolean true nếu truy xuất tệp thành công. Nếu không thì là false.

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

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

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

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

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

    Gửi
    DeviceNotAvailableException

    pullFileFromExternal

    public abstract File pullFileFromExternal (String remoteFilePath)

    Một phương thức thuận tiện để truy xuất mộ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ề một thông tin tham chiếu đến File đó.

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

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

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

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                    int userId)

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

    Tham số
    localDir File: thư mục cục bộ để đẩy

    deviceFilePath String: đường dẫn tuyệt đối đến tệp của đích đến từ xa

    userId int: mã nhận dạng người dùng để đẩy đến

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

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

    pushDir

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

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

    Tham số
    localDir File: thư mục cục bộ để đẩy

    deviceFilePath String: đường dẫn tuyệt đối đến tệp của đích đến từ xa

    excludedDirectories : Tập hợp các tên thư mục bị loại trừ không được đẩy.

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

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

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

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

    Tham số
    localDir File: thư mục cục bộ để đẩy

    deviceFilePath String: đường dẫn tuyệt đối đến tệp của đích đến từ xa

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

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

    pushFile

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

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

    Tham số
    localFile File: tệp cục bộ cần đẩy

    deviceFilePath String: đường dẫn tuyệt đối đến tệp đích từ xa

    evaluateContentProviderNeeded boolean: liệu có cần kiểm tra xem chúng tôi có cần nhà cung cấp nội dung hay không

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

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

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

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

    Tham số
    localFile File: tệp cục bộ cần đẩy

    deviceFilePath String: đường dẫn tuyệt đối đến tệp đích từ xa

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

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

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    int userId)

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

    Tham số
    localFile File: tệp cục bộ cần đẩy

    deviceFilePath String: đường dẫn tuyệt đối đến tệp đích từ xa

    userId int: mã người dùng để đẩy đến

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

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

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

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

    Tham số
    contents String: nội dung của tệp cần đẩy

    deviceFilePath String: đường dẫn tuyệt đối đến tệp đích từ xa

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

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

    khởi động lại

    public abstract void reboot ()

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

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

    Gửi
    DeviceNotAvailableException nếu thiết bị không hoạt động sau khi khởi động lại

    khởi động lại

    public abstract void reboot (String reason)

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

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

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

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

    Gửi
    DeviceNotAvailableException nếu thiết bị không hoạt động sau khi khởi động lại

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

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

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

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

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

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

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

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

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

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

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

    Gửi
    DeviceNotAvailableException nếu thiết bị không hoạt động sau khi khởi động lại

    rebootIntoSideload

    public abstract void rebootIntoSideload (boolean autoReboot)

    Khởi động lại thiết bị ở chế độ cài đặt không qua cửa hàng adb (lưu ý rằng đây là một chế độ đặc biệt trong chế độ khôi phục)

    Chặn cho đến khi thiết bị chuyển sang chế độ tải qua một bên

    Tham số
    autoReboot boolean: có tự động khởi động lại thiết bị sau khi cài đặt từ nguồn bên ngoài hay không

    Gửi
    DeviceNotAvailableException nếu thiết bị không ở chế độ tải lên từ nguồn bên ngoài sau khi khởi động lại

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

    Khởi động lại thiết bị ở chế độ cài đặt không qua cửa hàng adb (lưu ý rằng đây là một chế độ đặc biệt trong chế độ khôi phục)

    Chặn cho đến khi thiết bị chuyển sang chế độ tải qua một bên

    Gửi
    DeviceNotAvailableException nếu thiết bị không ở chế độ tải lên từ nguồn bên ngoài sau khi khởi động lại

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

    Một lựa chọn thay thế cho reboot(), chỉ chặn cho đến khi thiết bị kết nối mạng, tức là adb có thể nhìn thấy.

    Gửi
    DeviceNotAvailableException nếu thiết bị không hoạt động sau khi khởi động lại

    rebootUntilOnline

    public abstract void rebootUntilOnline (String reason)

    Một lựa chọn thay thế cho reboot(), chỉ chặn cho đến khi thiết bị kết nối mạng, tức là adb có thể nhìn thấy.

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

    Gửi
    DeviceNotAvailableException nếu thiết bị không hoạt động sau khi khởi động lại

    Xem thêm:

    rebootUserspace

    public abstract void rebootUserspace ()

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

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

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

    Gửi
    DeviceNotAvailableException nếu thiết bị không hoạt động sau khi khởi động lại

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

    Một lựa chọn thay thế cho rebootUserspace() ()} chỉ chặn cho đến khi thiết bị trực tuyến, tức là có thể thấy được đối với adb.

    Gửi
    DeviceNotAvailableException nếu thiết bị không hoạt động sau khi khởi động lại

    remountSystemReadOnly

    public abstract void remountSystemReadOnly ()

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

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

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

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

    remountVendorReadOnly

    public abstract void remountVendorReadOnly ()

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

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

    remountVendorWritable

    public abstract void remountVendorWritable ()

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

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

    runInstrumentationTests

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

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

    Tham số
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner chạy các kiểm thử

    listeners ITestLifeCycleReceiver: (các) trình nghe kết quả kiểm thử

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

    Gửi
    DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục. tức là lệnh kiểm thử không hoàn tất và không khôi phục được.

    runInstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

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

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

    Tham số
    runner IRemoteAndroidTestRunner: IRemoteAndroidTestRunner chạy các kiểm thử

    listeners : trình nghe kết quả kiểm thử

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

    Gửi
    DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục. tức là lệnh kiểm thử không hoàn tất và không khôi phục được.

    runInstrumentationTestsAsUser

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

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

    Tham số
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Giá trị trả về
    boolean

    Gửi
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Tham số
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Giá trị trả về
    boolean

    Gửi
    DeviceNotAvailableException

    setDate

    public abstract void setDate (Date date)

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

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

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

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

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Đặt TestDeviceOptions cho thiết bị

    Tham số
    options TestDeviceOptions

    setProperty

    public abstract boolean setProperty (String propKey, 
                    String propValue)

    Đặt giá trị thuộc tính đã cho trên thiết bị. Yêu cầu adb root là true.

    Tham số
    propKey String: Khoá được nhắm đến để đặt.

    propValue String: Giá trị thuộc tính cần đặt.

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

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

    setRecovery

    public abstract void setRecovery (IDeviceRecovery recovery)

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

    Tham số
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

    Tham số
    mode ITestDevice.RecoveryMode: có nên bật chế độ "chỉ khôi phục cho đến khi trực tuyến" hay không.

    setTrackingSerial

    public abstract void setTrackingSerial (String trackingSerial)

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

    Tham số
    trackingSerial String

    setUseFastbootErase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

    Đặt xem có sử dụng lệnh fastboot erase hay fastboot format để xoá một phân vùng trên thiết bị hay không.

    Tham số
    useFastbootErase boolean: true nếu bạn nên sử dụng lệnh xoá fastboot hoặc false nếu bạn nên sử dụng lệnh định dạng fastboot.

    startLogcat

    public abstract void startLogcat ()

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

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

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

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

    startTradeInModeTesting

    public abstract boolean startTradeInModeTesting (int timeoutMs)

    Bật chế độ kiểm thử giao dịch thu cũ đổi mới. Thiết bị sẽ bị xoá sạch dữ liệu và khởi động lại.

    Tham số
    timeoutMs int

    Giá trị trả về
    boolean True nếu thành công, false nếu không

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

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

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

    stopLogcat

    public abstract void stopLogcat ()

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

    Sẽ không có hiệu lực nếu đầu ra logcat không được ghi lại.

    stopTradeInModeTesting

    public abstract void stopTradeInModeTesting ()

    Dừng thử nghiệm chế độ đổi cũ lấy mới. Thiết bị sẽ khởi động lại.

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

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

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

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

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

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

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

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

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

    syncFiles

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Đồng bộ hoá nội dung của một thư mục tệp cục bộ với thiết bị theo từng bước.

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

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

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

    Tham số
    localFileDir File: thư mục tệp cục bộ chứa các tệp cần đẩy đệ quy.

    deviceFilePath String: đường dẫn tuyệt đối đến thư mục gốc của tệp đích từ xa. Bạn phải đọc được tất cả các thư mục trong đường dẫn tệp đó. Tức là việc đẩy đến /data/local/tmp khi adb không phải là gốc sẽ không thành công

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

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

    unlockDevice

    public abstract boolean unlockDevice ()

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

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

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

    Gửi
    DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.
    UnsupportedOperationException nếu thiết bị không hỗ trợ mã hoá.

    unmountDebugfs

    public abstract void unmountDebugfs ()

    Huỷ gắn debugfs.

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

    waitForBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

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

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

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

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

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable ()

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

    Giá trị trả về
    boolean True nếu thiết bị có sẵn, False nếu chế độ khôi phục bị tắt và không dùng được.

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

    waitForDeviceAvailable

    public abstract boolean waitForDeviceAvailable (long waitTime)

    Chờ thiết bị phản hồi và sẵn sàng cho việc kiểm thử.

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

    Giá trị trả về
    boolean True nếu thiết bị có sẵn, False nếu chế độ khôi phục bị tắt và không dùng được.

    Gửi
    DeviceNotAvailableException nếu thiết bị vẫn không phản hồi sau khi waitTime hết hạn.

    waitForDeviceAvailableInRecoverPath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Tham số
    waitTime long

    Giá trị trả về
    boolean True nếu thiết bị có sẵn, False nếu không có sẵn.

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

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

    Chặn cho đến khi thiết bị xuất hiện qua fastboot. Sử dụng thời gian chờ mặc định.

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

    waitForDeviceInRecovery

    public abstract boolean waitForDeviceInRecovery (long waitTime)

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

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

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

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

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

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

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

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

    Các khối để thiết bị không hoạt động, tức là không có trong adb

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

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

    waitForDeviceOnline

    public abstract void waitForDeviceOnline ()

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

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

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

    waitForDeviceOnline

    public abstract void waitForDeviceOnline (long waitTime)

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

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

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

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

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

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

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