INativeDevice
public
interface
INativeDevice
com.android.tradefed.device.INativeDevice |
Cung cấp một API cấp độ cao hơn một chút và đáng tin cậy cho IDevice
ddmlib.
Thử lại các lệnh của thiết bị với số lượng có thể định cấu hình và cung cấp giao diện khôi phục thiết bị cho các thiết bị không phản hồi.
Tóm 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 dựa trên cấp độ được 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á 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á 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 mềm hay không bằng cách so sánh system_server hiện tại với |
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 mềm kể từ thời gian UTC kể 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 thư mục gốc adb. |
abstract
boolean
|
doesFileExist(String deviceFilePath)
Phương thức trợ giúp để xác định xem tệp trên thiết bị có tồn tại hay không. |
abstract
boolean
|
enableAdbRoot()
Bật quyền truy cập thư mục gốc adb. |
abstract
String
|
executeAdbCommand(long timeout, String... commandArgs)
Phương thức trợ giúp thực thi lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định. |
abstract
String
|
executeAdbCommand(String... commandArgs)
Phương thức trợ giúp thực thi lệnh adb dưới dạng lệnh hệ thống. |
abstract
String
|
executeAdbCommand(long timeout,
Phương thức trợ giúp thực thi lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định. |
abstract
CommandResult
|
executeFastbootCommand(long timeout, String... commandArgs)
Phương thức trợ giúp thực thi lệnh khởi động nhanh dưới dạng lệnh hệ thống. |
abstract
CommandResult
|
executeFastbootCommand(String... commandArgs)
Phương thức trợ giúp thực thi lệnh khởi động nhanh 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 lệnh khởi động nhanh 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 lệnh khởi động nhanh 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 lệnh shell adb và trả về kết quả dưới dạng |
abstract
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Thực thi lệnh shell adb, 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 lệnh shell adb, 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 shell adb đã cho, thử lại nhiều lần nếu lệnh không thành công. |
abstract
CommandResult
|
executeShellV2Command(String command)
Phương thức trợ giúp thực thi 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 lệnh shell adb 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 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 lệnh shell adb, 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 lệnh shell adb, 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 lệnh shell adb, 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 lệnh shell adb, 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á sạch 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ở (vô tuyến) của thiết bị này. |
abstract
Integer
|
getBattery()
Trả về mức pin hiện tại của một thiết bị hoặc giá trị Rỗng nếu không có 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 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 gian bắt đầu của 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 bí danh của bản dựng mà thiết bị hiện đang chạy. |
abstract
String
|
getBuildFlavor()
Truy xuất phiên bản bản dựng cho thiết bị. |
abstract
String
|
getBuildId()
Truy xuất bản dựng mà thiết bị đ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 các nhà sản xuất thiết bị riêng lẻ 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 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ề |
abstract
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Trả về |
abstract
TestDeviceState
|
getDeviceState()
Lấy trạng thái của thiết bị. |
abstract
long
|
getDeviceTimeOffset(Date date)
Trình trợ giúp để lấy chênh lệch thời gian giữa thiết bị và một |
abstract
InputStreamSource
|
getEmulatorOutput()
Nhận 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 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ế độ khởi động nhanh. |
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ế độ khởi động nhanh. |
abstract
String
|
getFastbootSerialNumber()
Trả về số sê-ri của chế độ khởi động nhanh. |
abstract
String
|
getFastbootVariable(String variableName)
Truy xuất giá trị biến khởi động nhanh đã cho từ thiết bị. |
abstract
IFileEntry
|
getFileEntry(String path)
Truy xuất tệp tham chiếu đến tệp từ xa trên thiết bị. |
abstract
IDevice
|
getIDevice()
Trả về tham chiếu đến |
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 gần nhất các API Tradefed kích hoạt quá trình 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 đầu tiên của thiết bị. |
abstract
InputStreamSource
|
getLogcat()
Lấy luồng tổng quan nhanh của dữ liệu logcat. |
abstract
InputStreamSource
|
getLogcat(int maxBytes)
Lấy luồng tổng quan nhanh về |
abstract
InputStreamSource
|
getLogcatDump()
Tải tệp báo lỗi logcat hiện tại cho thiết bị. |
abstract
InputStreamSource
|
getLogcatSince(long date)
Lấy luồng tổng quan nhanh về dữ liệu logcat đã thu thập kể 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ề |
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 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ó lỗi 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 sử 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 bia mộ từ các thiết bị. |
abstract
long
|
getTotalMemory()
Trả về tổng dung lượng 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()
Xác định xem có sử dụng tính năng xoá nhanh qua Fastboot hay định dạng nhanh qua 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ợ 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 trên lượt cài đặt ứng dụng hay không |
abstract
boolean
|
isDebugfsMounted()
Kiểm tra xem debugfs có được gắn hay không. |
abstract
boolean
|
isDeviceEncrypted()
Trả về giá trị 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 phải là thư mục. |
abstract
boolean
|
isEncryptionSupported()
Trả về kết quả nếu thiết bị hỗ trợ tính năng mã hoá. |
abstract
boolean
|
isExecutable(String fullPath)
Trả về True nếu đường dẫn tệp trên thiết bị là tệp thực thi, ngược lại là false. |
abstract
boolean
|
isHeadless()
Trả về true nếu thiết bị không có màn hình (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 khi bắt đầu chạy hay không |
abstract
boolean
|
isStateBootloaderOrFastbootd()
Trả về true nếu thiết bị ở |
abstract
boolean
|
logAnrs(ITestLogger logger)
Thu thập và ghi nhật ký 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()
Phát lệnh khởi động lại thiết bị và trả về khi lệnh hoàn tất cũng như khi thiết bị không còn hiển thị với adb. |
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òn được dùng nữa.
Thay vào đó, hãy sử dụng |
abstract
void
|
postInvocationTearDown(Throwable invocationException)
Các bước bổ sung để dọn dẹp bắt buộc theo thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất. |
default
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Các bước bổ sung để thiết lập bắt buộc theo thiết bị sẽ được thực thi trên thiết bị trước khi thực hiện quy trình gọi. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir)
Kéo nội dung thư mục từ thiết bị theo cách đệ quy. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Kéo 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 trên thiết bị, lưu trữ tệp đó trong |
abstract
File
|
pullFile(String remoteFilePath)
Truy xuất một tệp trên thiết bị, lưu trữ tệp đó trong |
abstract
boolean
|
pullFile(String remoteFilePath, File localFile)
Truy xuất tệp trên thiết bị. |
abstract
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Truy xuất tệp trên thiết bị. |
abstract
String
|
pullFileContents(String remoteFilePath)
Truy xuấ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 tệp từ bộ nhớ ngoài của thiết bị, lưu trữ tệp đó trong một |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath, int userId)
Đẩy nội dung thư mục đến thiết bị theo đệ quy. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath,
Đẩy nội dung thư mục đến thiết bị theo đệ quy, đồng thời 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 đến thiết bị theo đệ quy. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
Biến thể của |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath)
Đẩy tệp vào thiết bị. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, int userId)
Đẩy tệp vào thiết bị. |
abstract
boolean
|
pushString(String contents, String deviceFilePath)
Đẩy tệp được tạo từ một chuỗi vào thiết bị |
abstract
void
|
reboot()
Khởi động lại thiết bị vào chế độ adb. |
abstract
void
|
reboot(String reason)
Khởi động lại thiết bị vào 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ị vào chế độ cài đặt không qua cửa hàng của ADB (lưu ý đây là chế độ đặc biệt trong quá trình khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ tải không qua cửa hàng |
abstract
void
|
rebootIntoSideload()
Khởi động lại thiết bị vào chế độ cài đặt không qua cửa hàng của ADB (lưu ý đây là chế độ đặc biệt trong quá trình khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ tải không qua cửa hàng |
abstract
void
|
rebootUntilOnline()
Một phương án thay thế cho |
abstract
void
|
rebootUntilOnline(String reason)
Một phương á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 phương án thay thế cho |
abstract
void
|
remountSystemReadOnly()
Đặt phân vùng hệ thống trên thiết bị ở chế độ chỉ có thể đọ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ó thể đọc. |
abstract
void
|
remountVendorWritable()
Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ ghi. |
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à 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 phải can thiệp vào hệ thống để thiết lập 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 sử dụng để tham chiếu đến thiết bị. |
abstract
void
|
setUseFastbootErase(boolean useFastbootErase)
Đặt xem có sử dụng tính năng xoá fastboot hay định dạng fastboot để 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
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 đã lưu. |
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)
Tăng dần nội dung của thư mục tệp cục bộ với thiết bị. |
abstract
boolean
|
unlockDevice()
Mở khoá thiết bị nếu thiết bị đang ở trạng thái mã hoá. |
abstract
void
|
unmountDebugfs()
Huỷ kết nối debugfs. |
abstract
boolean
|
waitForBootComplete(long timeOut)
Chặn cho đến khi thiết lập cờ hoàn tất khởi động của thiết bị. |
abstract
boolean
|
waitForDeviceAvailable()
Chờ thiết bị phản hồi và có thể kiểm thử. |
abstract
boolean
|
waitForDeviceAvailable(long waitTime)
Chờ thiết bị phản hồi và có thể kiểm thử. |
abstract
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Chờ thiết bị phản hồi và có sẵn mà không xem xét đường dẫn khôi phục. |
abstract
void
|
waitForDeviceBootloader()
Chặn cho đến khi thiết bị hiển thị qua tính năng khởi động nhanh. |
abstract
boolean
|
waitForDeviceInRecovery(long waitTime)
Chặn thiết bị ở trạng thái "adb recovery" (hãy 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 có sẵn, tức là bị thiếu trong adb |
abstract
void
|
waitForDeviceOnline()
Chặn cho đến khi thiết bị hiển thị thông qua adb. |
abstract
void
|
waitForDeviceOnline(long waitTime)
Chặn cho đến khi thiết bị hiển thị thông qua adb. |
abstract
boolean
|
waitForDeviceShell(long waitTime)
Chờ thiết bị phản hồi lệnh shell adb cơ bản. |
Hằng số
UNKNOWN_API_LEVEL
public static final int UNKNOWN_API_LEVEL
Giá trị mặc định khi 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 dựa trên cấp độ được hỗ trợ tối thiểu. Phương thức này tính đến các tính năng chưa phát hành trước khi tăng cấp độ API.
Tham số | |
---|---|
strictMinLevel |
int : Cấp độ tối thiểu nghiêm ngặt nhất 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ì giá trị sẽ là 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 ROM cho 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á 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á 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á khỏi |
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 mềm hay không bằng cách so sánh system_server hiện tại với ProcessInfo
system_server trước đó. Sử dụng getProcessByName(String)
để nhận 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 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 mềm kể từ thời gian UTC kể 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 mềm đề cập đến việc system_server khởi động lại bên ngoài quá trình khởi động lại cứng của thiết bị (ví dụ: khởi động lại theo yêu cầu). Bạn có thể lấy utcEpochTime của thiết bị hiện tại theo đơn vị mili giây bằng phương thức getDeviceDate()
.
Tham số | |
---|---|
utcEpochTime |
long : thời gian 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 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 thư mục gốc adb.
Việc tắt quyền truy cập gốc adb có thể khiến thiết bị ngắt kết nối khỏi adb. Phương thức này sẽ chặn cho đến khi thiết bị có sẵn.
Giá trị trả về | |
---|---|
boolean |
true nếu thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 trợ giúp để xác định xem tệp trên thiết bị có tồn tại 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 bị 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 thư mục gốc adb. Nếu chế độ cài đặt "enable-root" là "false", thì sẽ ghi lại thông báo và trả về mà không bật quyền truy cập thư mục gốc.
Việc bật thư mục 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 bị 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 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 sử dụng executeShellCommand(String)
bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và mang lại 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ố để 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 bị 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 lệnh adb dưới dạng lệnh hệ thống.
Bạn nên sử dụng executeShellCommand(String)
bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và mang lại hiệu suất tốt hơn.
Tham số | |
---|---|
commandArgs |
String : lệnh adb và các đối số để 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 bị 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 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 sử dụng executeShellCommand(String)
bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và mang lại 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ố để 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 bị 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 lệnh khởi động nhanh dưới dạng lệnh hệ thống.
Dự kiến sẽ được sử dụng khi thiết bị đã ở chế độ khởi động nhanh.
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 khởi động nhanh và các đối số để chạy |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả của lệnh |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh khởi động nhanh dưới dạng lệnh hệ thống với thời gian chờ mặc định là 2 phút.
Dự kiến sẽ được sử dụng khi thiết bị đã ở chế độ khởi động nhanh.
Tham số | |
---|---|
commandArgs |
String : lệnh khởi động nhanh và các đối số để chạy |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả của lệnh |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh khởi động nhanh chạy trong thời gian dài dưới dạng lệnh hệ thống.
Giống với executeFastbootCommand(String)
ngoại trừ việc sử dụng thời gian chờ lâu hơn.
Tham số | |
---|---|
commandArgs |
String : lệnh khởi động nhanh và các đối số để chạy |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả của lệnh |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh khởi động nhanh 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.
Giống với 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 khởi động nhanh chạy cùng |
commandArgs |
String : lệnh khởi động nhanh và các đối số để chạy |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả của lệnh |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh shell adb và trả về kết quả dưới dạng String
.
Tham số | |
---|---|
command |
String : lệnh shell adb để chạy |
Giá trị trả về | |
---|---|
String |
đầu ra của shell |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh shell adb, 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 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 thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không được thực hiện thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh shell adb, 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 để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit |
maxTimeToOutputShellResponse |
long : khoảng thời gian tối đa mà lệnh được phép không đưa ra 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 thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không được thực hiện thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 shell adb đã cho, thử lại nhiều lần nếu lệnh không thành công.
Một dạng đơn giản hơn của executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
với các giá trị mặc định.
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 bị 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 lệnh shell adb và trả về kết quả dưới dạng CommandResult
được điền chính xác 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ả trong CommandResult . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh shell adb và trả về kết quả dưới dạng CommandResult
được điền chính xác bằng đầu ra trạng thái lệnh và stderr. stdout được chuyển hướng đến luồng đã chỉ định.
Tham số | |
---|---|
command |
String : Lệnh cần chạy. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) nơi đầu ra std sẽ được chuyển hướng hoặc rỗng. |
Giá trị trả về | |
---|---|
CommandResult |
Kết quả trong CommandResult . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh shell adb và trả về kết quả dưới dạng CommandResult
được điền chính xác 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 : ERROR(/File) sẽ được chuyển vào lệnh dưới dạng dữ liệu đầu vào hoặc giá trị rỗng. |
Giá trị trả về | |
---|---|
CommandResult |
Kết quả trong CommandResult . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh shell adb, 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 để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit : đơn vị cho maxTimeToOutputShellResponse |
retryAttempts |
int : số lần thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không được thực hiện thành công. |
Giá trị trả về | |
---|---|
CommandResult |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh shell adb, 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 để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit : đơn vị cho maxTimeToOutputShellResponse |
Giá trị trả về | |
---|---|
CommandResult |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh shell adb, 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 : ERROR(/File) sẽ được chuyển vào lệnh dưới dạng dữ liệu đầu vào hoặc giá trị rỗng. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) nơi đầu ra std sẽ được chuyển hướng hoặc rỗng. |
maxTimeoutForCommand |
long : thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit : đơn vị cho maxTimeToOutputShellResponse |
retryAttempts |
int : số lần thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không được thực hiện thành công. |
Giá trị trả về | |
---|---|
CommandResult |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 lệnh shell adb, 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 : ERROR(/File) sẽ được chuyển vào lệnh dưới dạng dữ liệu đầu vào hoặc giá trị rỗng. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) nơi đầu ra std sẽ được chuyển hướng hoặc rỗng. |
pipeToError |
OutputStream : ERROR(/OutputStream) nơi lỗi std sẽ được chuyển hướng hoặc rỗng. |
maxTimeoutForCommand |
long : thời gian chờ tối đa để hoàn tất lệnh; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit : đơn vị cho maxTimeToOutputShellResponse |
retryAttempts |
int : số lần thử lại tối đa nếu lệnh không thành công do ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không được thực hiện thành công. |
Giá trị trả về | |
---|---|
CommandResult |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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á sạch một phân vùng cho thiết bị.
Nếu getUseFastbootErase()
là true
, thì tính năng xoá khởi động nhanh 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, định dạng khởi động nhanh sẽ được sử dụng để tạo một hệ thống tệp mới trên thiết bị.
Dự kiến sẽ được sử dụng khi thiết bị đã ở chế độ khởi động nhanh.
Tham số | |
---|---|
partition |
String : phân vùng cần xoá |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả của lệnh |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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ở (vô tuyến) của thiết bị này. Việc lấy phiên bản đài phát thanh là dành riêng cho thiết bị, vì vậy, phiên bản này có thể không trả về thông tin chính xác cho tất 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ề tại đây có thể không khớp với phiên bản được báo cáo từ tính năng khởi động nhanh và có thể không trả về phiên bản cho đài CDMA.
Tóm tắt: 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 phiên bản này
(thiết bị không có đài hoặc không đọc được chuỗi phiên bản) |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 một thiết bị hoặc giá trị Rỗng nếu không có 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 . |
Gửi | |
---|---|
DeviceNotAvailableException |
getBootHistory
public abstractgetBootHistory ()
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.
Giá trị trả về | |
---|---|
|
Bản đồ thời gian khởi động (giờ 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 gian bắt đầu của thiết bị và đơn vị thời gian được chỉ định. Bạn có thể lấy utcEpochTime của thiết bị hiện tại tính bằng mili giây bằng phương thức getDeviceDate()
.
Tham số | |
---|---|
utcEpochTime |
long : thời gian thiết bị kể từ thời gian bắt đầu của hệ thống. |
timeUnit |
TimeUnit : đơn vị thời gian TimeUnit . |
Giá trị trả về | |
---|---|
|
Bản đồ thời gian khởi động (giờ 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ị đang ở chế độ khởi động nhanh, thì thiết bị sẽ cố gắng truy xuất phiên bản từ chế độ khởi động nhanh)
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 bị 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 bí danh của bản dựng mà thiết bị hiện đang chạy.
Bí danh bản dựng thường là một chuỗi dễ đọc hơn so với mã bản dựng (thường là một số cho các bản dựng Nexus). Ví dụ: bản phát hành Android 4.2 cuối cùng có bí danh bản dựng JDQ39 và mã bản dựng 573038
Giá trị trả về | |
---|---|
String |
bí danh bản dựng hoặc quay lại mã bản dựng nếu không thể truy xuất |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
Truy xuất phiên bản bản dựng cho thiết bị.
Giá trị trả về | |
---|---|
String |
phiên bản xây dựng hoặc giá trị rỗng nếu không truy xuất được phiên bản xây dựng |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
Truy xuất bản dựng mà thiết bị đang chạy.
Giá trị trả về | |
---|---|
String |
mã bản dựng hoặc IBuildInfo.UNKNOWN_BUILD_ID nếu không thể truy xuất |
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 các nhà sản xuất thiết bị riêng lẻ kiểm soát)
Giá trị trả về | |
---|---|
String |
Khoá ký nếu tìm thấy, nếu không thì rỗng. |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getCachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
Trả về DeviceDescriptor
được 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
được 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 chỉ số mô tả ở mức thông tin 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 sẽ không hoạt động do các 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 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ề DeviceDescriptor
từ thông tin thiết bị để lấy 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ề DeviceDescriptor
từ thông tin thiết bị để lấy 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 chỉ số mô tả ở mức thông tin 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ình trợ giúp để lấy chênh lệch thời gian giữa thiết bị và một ERROR(/Date)
nhất định. Sử dụng thời gian Epoch trong nội bộ.
Tham số | |
---|---|
date |
Date |
Giá trị trả về | |
---|---|
long |
chênh lệch theo mili giây |
Gửi | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
Nhận 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 dung lượng trống trên bộ nhớ ngoài của thiết bị.
Giá trị trả về | |
---|---|
long |
dung lượng trống tính bằng KB |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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ế độ khởi động nhanh.
Bạn chỉ nên sử dụng phương thức này nếu thiết bị đang ở chế độ khởi động nhanh. Đâ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ế độ khởi động nhanh 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 bị 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ế độ khởi động nhanh.
Bạn chỉ nên sử dụng phương thức này nếu thiết bị đang ở chế độ khởi động nhanh. Đâ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ế độ khởi động nhanh 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 bị 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 của chế độ khởi động nhanh.
Giá trị trả về | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
Truy xuất giá trị biến khởi động nhanh đã 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 không có |
Gửi | |
---|---|
|
UnsupportedOperationException |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Truy xuất tệp tham chiếu đến 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ề tham chiếu đến IDevice
ddmlib đượ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 đó, phương thức gọi không nên giữ lại tham chiếu đến IDevice
, vì 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 này 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 gần nhất các API Tradefed kích hoạt quá trình 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 đầu tiên 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 được khởi chạy của thiết bị |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
Lấy luồng tổng quan nhanh của dữ liệu logcat.
Hoạt động ở hai chế độ:
TestDeviceOptions.getMaxLogcatDataSize()
byte nội dung hiện tại của quá trình ghi logcat ở chế độ nền
Giá trị trả về | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
Lấy luồng tổng quan nhanh về maxBytes
dữ liệu logcat đã ghi lại gần đây nhất.
Hữu ích trong trường hợp bạn muốn chụp ảnh nhanh thường xuyên về dữ liệu logcat đã thu thập mà không phải chịu mức phạt về dung lượng ổ đĩa có thể lớn 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 lượng vừa đủ để vừa với bộ nhớ |
Giá trị trả về | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
Tải tệp báo lỗi 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 tệp kết xuất tĩnh của logcat.
Có nhược điểm là sẽ không trả về giá trị nào nếu không thể kết nối với thiết bị.
Giá trị trả về | |
---|---|
InputStreamSource |
InputStreamSource của dữ liệu logcat. Hệ thống sẽ trả về một luồng trống nếu không thu thập được dữ liệu logcat. |
getLogcatSince
public abstract InputStreamSource getLogcatSince (long date)
Lấy luồng tổng quan nhanh về dữ liệu logcat đã thu thập kể 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
.
VIỆC CẦN LÀM: di chuyển hành vi này sang 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ề MountPointInfo
tương ứng với đường dẫn điểm gắn được 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 điểm gắn.
Tham số | |
---|---|
mountpoint |
String |
Giá trị trả về | |
---|---|
ITestDevice.MountPointInfo |
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ề | |
---|---|
|
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 dung lượng trống trên phân vùng thiết bị.
Tham số | |
---|---|
partition |
String |
Giá trị trả về | |
---|---|
long |
dung lượng trống tính bằng KB |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 quy trình của quy trình đã cho.
Tham số | |
---|---|
processName |
String : Chuỗi tên quy trình. |
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ó lỗi 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 để trống |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 tên biến thể |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 không có |
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 sử dụng cho thiết bị.
Giá trị trả về | |
---|---|
ITestDevice.RecoveryMode |
chế độ khôi phục hiện tại được sử 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 bia mộ từ các thiết bị. Yêu cầu quyền truy cập thư mục gốc.
phương thức là phương pháp hiệu quả nhất, vì vậy, nếu không thể kéo một bia mộ vì bất kỳ lý do gì, bia mộ đó sẽ bị thiếu trong danh sách. Chỉ DeviceNotAvailableException
mới chấm dứt sớm phương thức.
Giá trị trả về | |
---|---|
|
Danh sách tệp bia mộ, trống nếu không có bia mộ. |
Gửi | |
---|---|
DeviceNotAvailableException |
Xem thêm:
getTotalMemory
public abstract long getTotalMemory ()
Trả về tổng dung lượng 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 ()
Xác định xem có sử dụng tính năng xoá nhanh qua Fastboot hay định dạng nhanh qua 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 tính năng xoá bằng tính năng khởi động nhanh hoặc false nếu bạn sử dụng tính năng định dạng bằng tính năng khởi động nhanh. |
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 bị 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ợ liệt kê ứng dụng hay không
Giá trị trả về | |
---|---|
boolean |
Đúng nếu tính năng liệt kê ứng dụng được hỗ trợ, sai nếu không được hỗ trợ |
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 trên lượt cài đặt ứng dụng hay không
Giá trị trả về | |
---|---|
boolean |
Đúng nếu hỗ trợ bỏ qua khối SDK mục tiêu thấp, nếu không thì sai |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDebugfsMounted
public abstract boolean isDebugfsMounted ()
Kiểm tra xem debugfs có được gắn hay không.
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ề giá trị 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 bị 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 phải là thư mục.
Tham số | |
---|---|
deviceFilePath |
String |
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isEncryptionSupported
public abstract boolean isEncryptionSupported ()
Trả về kết quả nếu thiết bị hỗ trợ tính năng 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à tệp thực thi, ngược lại là false.
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 (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 khi bắt đầu chạy hay không
Giá trị trả về | |
---|---|
boolean |
Đúng nếu quyền trong thời gian chạy được hỗ trợ, sai nếu không được hỗ trợ. |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public abstract boolean isStateBootloaderOrFastbootd ()
Trả về true nếu thiết bị ở TestDeviceState.FASTBOOT
hoặc TestDeviceState.FASTBOOTD
.
Giá trị trả về | |
---|---|
boolean |
logAnrs
public abstract boolean logAnrs (ITestLogger logger)
Thu thập và ghi nhật ký lỗi ANR trên thiết bị.
Tham số | |
---|---|
logger |
ITestLogger : ITestLogger để ghi nhật ký 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à lệnh gọi an toàn sẽ không gửi ngay cả khi ghi nhật ký không thành công.
Tham số | |
---|---|
tag |
String : Thẻ mà chúng ta ghi nhật ký thông báo trong logcat. |
level |
Log.LogLevel : Cấp gỡ lỗi của thông báo trong logcat. |
format |
String : Định dạng thông báo. |
args |
Object : các đối số cần 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 ()
Phát lệnh khởi động lại thiết bị và trả về khi lệnh hoàn tất cũng như khi thiết bị không còn hiển thị với adb.
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.
Nên được gọi sau khi thiết bị khởi động/có sẵn đầy đủ
Trong trường hợp thông 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 phương thức 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 khởi động nhanh hoàn tất)
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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òn đượ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 thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
Các bước bổ sung để dọn dẹp bắt buộc theo thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất.
Tham số | |
---|---|
invocationException |
Throwable : ngoại lệ cuối cùng (nếu có) do lỗi gọi gây ra. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Các bước bổ sung để thiết lập bắt buộc theo thiết bị sẽ được thực thi trên thiết bị trước khi thực hiện 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)
Kéo nội dung thư mục từ thiết bị theo cách đệ quy.
Tham số | |
---|---|
deviceFilePath |
String : đường dẫn tệp tuyệt đối 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 lấy thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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)
Kéo nội dung thư mục từ thiết bị theo cách đệ quy.
Tham số | |
---|---|
deviceFilePath |
String : đường dẫn tệp tuyệt đối của nguồn từ xa |
localDir |
File : thư mục cục bộ để kéo tệp vào |
userId |
int : mã nhận dạng người dùng cần lấy |
Giá trị trả về | |
---|---|
boolean |
true nếu tệp được lấy thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 trên 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 quá trình sao chép không thành công vì bất kỳ lý do gì (bao gồm cả sự cố với hệ thống tệp máy chủ) |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 trên 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 quá trình sao chép không thành công vì bất kỳ lý do gì (bao gồm cả sự cố với hệ thống tệp máy chủ) |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 tệp trên 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 tệp được truy xuất thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 tệp trên 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 tệp được truy xuất thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 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 quá trình sao chép không thành công vì bất kỳ lý do gì (bao gồm cả sự cố 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 tệp từ bộ nhớ ngoài của thiết bị, lưu trữ tệp đó trong một ERROR(/File)
tạm thời cục bộ và trả về một tệp 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 bộ nhớ ngoài của 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 quá trình sao chép không thành công vì bất kỳ lý do gì (bao gồm cả sự cố với hệ thống tệp máy chủ) |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 đến thiết bị theo đệ quy.
Tham số | |
---|---|
localDir |
File : thư mục cục bộ để đẩy |
deviceFilePath |
String : đường dẫn tệp tuyệt đối của đích đến từ xa |
userId |
int : mã nhận dạng người dùng cần đẩy đến |
Giá trị trả về | |
---|---|
boolean |
true nếu tệp đã được đẩy thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 đến thiết bị theo đệ quy, đồng thời 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 tệp tuyệt đối 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 đẩy thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 đến thiết bị theo đệ quy.
Tham số | |
---|---|
localDir |
File : thư mục cục bộ để đẩy |
deviceFilePath |
String : đường dẫn tệp tuyệt đối của đích đến từ xa |
Giá trị trả về | |
---|---|
boolean |
true nếu tệp đã được đẩy thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 việc đá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 tệp tuyệt đối của đích đến từ xa |
evaluateContentProviderNeeded |
boolean : liệu có kiểm tra xem chúng ta có cần nhà cung cấp nội dung hay không |
Giá trị trả về | |
---|---|
boolean |
true nếu tệp đã được đẩy thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 tệp vào thiết bị. Theo mặc định, sử dụng 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 tệp tuyệt đối của đích đến từ xa |
Giá trị trả về | |
---|---|
boolean |
true nếu tệp đã được đẩy thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 tệp vào thiết bị. Theo mặc định, sử dụng 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 tệp tuyệt đối của đích đến từ xa |
userId |
int : userId cần đẩy đến |
Giá trị trả về | |
---|---|
boolean |
true nếu tệp đã được đẩy thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 vào thiết bị
Tham số | |
---|---|
contents |
String : nội dung của tệp cần đẩy |
deviceFilePath |
String : đường dẫn tệp tuyệt đối của đích đến từ xa |
Giá trị trả về | |
---|---|
boolean |
true nếu chuỗi đã được đẩy thành công. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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ị vào chế độ adb.
Chặn cho đến khi thiết bị có sẵn.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu không có thiết bị 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ị vào 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ể lấy lý do khởi động lại gần đây nhất bằng cách truy vấn thuộc tính sys.boot.reason
.
Tham số | |
---|---|
reason |
String : lý do khởi động lại hoặc null nếu không có lý do nào được chỉ định. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu không có thiết bị 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 bị 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 bị 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 không có thiết bị sau khi khởi động lại |
rebootIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
Khởi động lại thiết bị vào chế độ cài đặt không qua cửa hàng của ADB (lưu ý đây là chế độ đặc biệt trong quá trình khôi phục)
Chặn cho đến khi thiết bị chuyển sang chế độ tải không qua cửa hàng
Tham số | |
---|---|
autoReboot |
boolean : liệu có tự động khởi động lại thiết bị sau khi tải không qua cửa hàng ứng dụng hay không |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không ở chế độ cài đặt không qua cửa hàng Play sau khi khởi động lại |
rebootIntoSideload
public abstract void rebootIntoSideload ()
Khởi động lại thiết bị vào chế độ cài đặt không qua cửa hàng của ADB (lưu ý đây là chế độ đặc biệt trong quá trình khôi phục)
Chặn cho đến khi thiết bị chuyển sang chế độ tải không qua cửa hàng
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không ở chế độ cài đặt không qua cửa hàng Play sau khi khởi động lại |
rebootUntilOnline
public abstract void rebootUntilOnline ()
Một phương án thay thế cho reboot()
chỉ chặn cho đến khi thiết bị có kết nối mạng, tức là hiển thị với adb.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu không có thiết bị sau khi khởi động lại |
rebootUntilOnline
public abstract void rebootUntilOnline (String reason)
Một phương án thay thế cho reboot()
chỉ chặn cho đến khi thiết bị có kết nối mạng, tức là hiển thị với adb.
Tham số | |
---|---|
reason |
String : lý do khởi động lại hoặc null nếu không có lý do nào được chỉ định. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu không có thiết bị 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, bạn tự chịu rủi ro khi sử dụng.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu không có thiết bị sau khi khởi động lại |
rebootUserspaceUntilOnline
public abstract void rebootUserspaceUntilOnline ()
Một phương án thay thế cho rebootUserspace()
()} chỉ chặn cho đến khi thiết bị có kết nối mạng, tức là hiển thị với adb.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu không có thiết bị sau khi khởi động lại |
remountSystemReadOnly
public abstract void remountSystemReadOnly ()
Đặt phân vùng hệ thống trên thiết bị ở chế độ chỉ có thể đọ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 ()
Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ chỉ có thể đọc. Có thể khởi động lại thiết bị.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
remountVendorWritable
public abstract void remountVendorWritable ()
Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ ghi. 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 chương trình 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 quá trình khôi phục đã thành công |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị mất kết nối với thiết bị và không thể khôi phục. Ví dụ: không thể hoàn tất lệnh kiểm thử và không thể khôi phục. |
runInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Chạy kiểm thử đo lường và khôi phục thiết bị.
Nếu kết nối với thiết bị bị mất trước khi quá trình chạy kiểm thử hoàn tất và quá trình khôi phục thành công, tất 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 được chạy lại. Việc này sẽ do phương thức gọi thực hiện nếu cần.
Nếu kết nối với thiết bị bị mất trước khi quá trình chạy kiểm thử hoàn tất và không khôi phục được, thì tất 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 chương trình 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ệ liên lạc với thiết bị, nhưng đã khôi phục thành công |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị mất kết nối với thiết bị và không thể khôi phục. Ví dụ: không thể hoàn tất lệnh kiểm thử và không thể khôi phụ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 kiểm thử 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 phải can thiệp vào hệ thống để thiết lập 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ủ lưu trữ 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 quyền truy cập thư mục gốc adb là đúng.
Tham số | |
---|---|
propKey |
String : Khoá cầ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, trả về False nếu không. |
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ẽ sử dụng khi gặp sự cố giao tiếp với thiết bị. Bạn chỉ nên sử dụng phương thức này khi cần (ví dụ: khi khung bị lỗi, v.v.
Tham số | |
---|---|
mode |
ITestDevice.RecoveryMode : liệu có bật chế độ "khôi phục cho đến khi chỉ có thể truy cập 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 sử dụng để tham chiếu đến thiết bị.
Tham số | |
---|---|
trackingSerial |
String |
setUseFastbootErase
public abstract void setUseFastbootErase (boolean useFastbootErase)
Đặt xem có sử dụng tính năng xoá fastboot hay định dạng fastboot để 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 tính năng xoá bằng tính năng khởi động nhanh hoặc false nếu bạn nên sử dụng tính năng định dạng bằng tính năng khởi động nhanh. |
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 đang được ghi lại. Sau đó, 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ị, bạn phải gọi stopLogcat()
.
Thông thường, bạn không cần gọi startLogcat()
và stopLogcat()
khi nằm trong ngữ cảnh gọi TF, vì khung TF sẽ bắt đầu và dừng logcat.
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 đã lưu.
Sẽ không có hiệu lực nếu không thu thập được đầu ra logcat.
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 thể chuyển đổi 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)
Tăng dần nội dung của thư mục tệp cục bộ với thiết bị.
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 đẩy đến thiết bị. Do đó, mức hao tổn sẽ tương đối nhỏ nếu tệp được đặt 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 nội dung /tmp/files vào /sdcard/files theo cách đệ quy.
Tham số | |
---|---|
localFileDir |
File : thư mục tệp cục bộ chứa các tệp cần đẩy đệ quy. |
deviceFilePath |
String : thư mục gốc của đường dẫn tệp tuyệt đối đến đích từ xa. Tất cả thư mục trong đường dẫn tệp này phải có thể đọc được. Ví dụ: đẩy vào /data/local/tmp khi adb không phải là thư mục 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. false nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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 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 để 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 bị 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ợ tính năng mã hoá. |
unmountDebugfs
public abstract void unmountDebugfs ()
Huỷ kết nối debugfs.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
waitForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
Chặn cho đến khi thiết lập cờ hoàn tất khởi động của thiết bị.
Tham số | |
---|---|
timeOut |
long : thời gian tính bằng mili giây để chờ đặt cờ |
Giá trị trả về | |
---|---|
boolean |
true nếu cờ hoàn tất 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à có thể kiểm thử. Sử dụng thời gian chờ mặc định.
Giá trị trả về | |
---|---|
boolean |
Đúng nếu thiết bị có sẵn, Sai nếu tính năng khôi phục bị tắt và không có sẵn. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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à có thể kiểm thử.
Tham số | |
---|---|
waitTime |
long : thời gian chờ tính bằng mili giây |
Giá trị trả về | |
---|---|
boolean |
Đúng nếu thiết bị có sẵn, Sai nếu tính năng khôi phục bị tắt và không có sẵn. |
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 xem xét đường dẫn khôi phục.
Tham số | |
---|---|
waitTime |
long |
Giá trị trả về | |
---|---|
boolean |
Đúng nếu có thiết bị, Sai nếu không có thiết bị. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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ị hiển thị qua tính năng khởi động nhanh. Sử dụng thời gian chờ mặc định.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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)
Chặn thiết bị ở trạng thái "adb recovery" (hãy 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.
false nếu không |
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. false
nếu không |
waitForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Các khối để thiết bị không có sẵn, tức là bị thiếu 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.
false nếu không |
waitForDeviceOnline
public abstract void waitForDeviceOnline ()
Chặn cho đến khi thiết bị hiển thị thông 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 khi hoàn tất. Thay vào đó, hãy sử dụng waitForDeviceAvailable()
.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu bị 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ị thông qua adb.
Xin lưu ý rằng thiết bị có thể không phản hồi các lệnh 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 bị 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 lệnh shell adb cơ bản.
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. |