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 |
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à |
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,
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,
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(
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 |
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 |
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 |
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 |
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ề |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Trả về |
abstract
String[]
|
getChildren(String deviceFilePath)
Giải pháp thay thế cho việc sử dụng |
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 |
abstract
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Trả về mộ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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
abstract
File
|
pullFile(String remoteFilePath)
Truy xuất một tệp khỏi thiết bị, lưu trữ tệp đó trong |
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 |
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,
Đẩ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 |
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 |
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 |
abstract
void
|
rebootUntilOnline(String reason)
Một lựa chọn thay thế cho |
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 |
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 |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
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,
Tương tự như |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Tương tự như |
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 |
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 |
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 |
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. |
Xem thêm:
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. |
Xem thêm:
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. |
Xem thêm:
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. |
Xem thêm:
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() là 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 abstractgetBootHistory ()
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 abstractgetBootHistorySince (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ế độ:
TestDeviceOptions.getMaxLogcatDataSize() byte nội dung hiện tại của quá trình ghi lại logcat ở chế độ nền
| 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 |
Xem thêm:
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 abstractgetMountPointInfo ()
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 abstractgetTombstones ()
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 |
|
Xem thêm:
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. |
Xem thêm:
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. |
Xem thêm:
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() và 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ọipostBootSetup(). 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. |