Thiết bị gốc
public
interface
INativeDevice
com.android.tradefed.device.INativeDevice |
Cung cấp API đáng tin cậy và cấp cao hơn một chút cho IDevice
ddmlib.
Thử lại các lệnh trên thiết bị với số tiền có thể định cấu hình và cung cấp dịch vụ 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 thể phát hiện 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 hiện có được hỗ trợ ở mức tối thiểu được hỗ trợ hay không. |
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
system_server trước đó |
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 tạm thời kể từ thời gian UTC kể từ thời gian bắt đầu của hệ thống hay không
thiết bị và |
abstract
boolean
|
disableAdbRoot()
Tắt adb gốc. |
abstract
boolean
|
doesFileExist(String deviceFilePath)
Phương thức trợ giúp để xác định xem có tệp trên thiết bị hay không. |
abstract
boolean
|
enableAdbRoot()
Bật thư mục gốc adb. |
abstract
String
|
executeAdbCommand(long timeout, String... commandArgs)
Phương thức trợ giúp sẽ thực thi một lệnh adb dưới dạng một 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 một lệnh hệ thống. |
abstract
String
|
executeAdbCommand(long timeout,
Phương thức trợ giúp sẽ thực thi một lệnh adb dưới dạng một 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 sẽ thực thi một lệnh khởi động nhanh dưới dạng một 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 giúp thực thi một 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 một lệnh khởi động nhanh chạy trong thời gian dài dưới dạng một lệnh hệ thống với hệ thống biến môi trường. |
abstract
String
|
executeShellCommand(String command)
Phương thức trợ giúp sẽ thực thi một 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 một lệnh shell adb, với các tham số khác để 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 shell adb, với các tham số khác để 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 sẽ 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 sẽ 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 sẽ 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 một lệnh shell adb, với các tham số khác để 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 shell adb, với các tham số khác để 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 shell adb, với các tham số khác để 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 shell adb, với các tham số khác để kiểm soát hành vi của lệnh. |
abstract
CommandResult
|
fastbootWipePartition(String partition)
Phương thức trợ giúp 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 để mua 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 thiết bị hoặc trả về 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, kèm theo 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 cùng với thời gian khởi động và lý do khởi động kể từ khi kể từ thời gian bắt đầu của hệ thống từ thiết bị và đơn vị thời gian đã chỉ định. |
abstract
String
|
getBootloaderVersion()
Phương thức thuận tiện để tải 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 các 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ề một |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Trả về một |
abstract
String[]
|
getChildren(String deviceFilePath)
Phương 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ị tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. |
abstract
DeviceDescriptor
|
getDeviceDescriptor()
Trả lại một |
abstract
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Trả lại một |
abstract
TestDeviceState
|
getDeviceState()
Xem trạng thái của thiết bị. |
abstract
long
|
getDeviceTimeOffset(Date date)
Giúp bạn tìm 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 pháp 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ế độ 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 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 đây nhất Trade tác API kích hoạt khởi động lại tính bằng mili giây kể từ khi EPOCH là
được trả về bởi |
abstract
int
|
getLaunchApiLevel()
Lấy Cấp độ API đầu tiên của thiết bị. |
abstract
InputStreamSource
|
getLogcat()
Lấy một luồng tổng quan nhanh của dữ liệu logcat. |
abstract
InputStreamSource
|
getLogcat(int maxBytes)
Lấy luồng ảnh chụp nhanh của |
abstract
InputStreamSource
|
getLogcatDump()
Tải tệp kết xuất logcat hiện tại cho thiết bị. |
abstract
InputStreamSource
|
getLogcatSince(long date)
Lấy một luồng tổng quan nhanh về dữ liệu logcat đã ghi bắt đầu từ ngày đã cung cấp. |
abstract
String
|
getMountPoint(String mountName)
Trả về một điểm gắn. |
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/sticks trên thiết bị |
abstract
long
|
getPartitionFreeSpace(String partition)
Phương pháp 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 sẽ chạy "pidof" và "số liệu thống kê" và 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 xảy ra lỗi. |
abstract
String
|
getProductType()
Phương thức thuận tiện để mua loại sản phẩm của thiết bị này. |
abstract
String
|
getProductVariant()
Phương thức thuận tiện để mua 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()
Tải 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 tombstone trên các thiết bị. |
abstract
long
|
getTotalMemory()
Trả về tổng kích thước bộ nhớ thực tính bằng byte hoặc -1 trong trường hợp có lỗi nội bộ |
default
String
|
getTrackingSerial()
Nhằm mục đích quản lý thiết bị, hãy lấy số sê-ri dùng để theo dõi thiết bị. |
abstract
boolean
|
getUseFastbootErase()
Chọn sử dụng định dạng xoá khởi động nhanh hay định dạng khởi động nhanh để xoá sạch một phân vùng trên thiết bị. |
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ợ tính năng 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ợ 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 kết 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, nếu không thì trả về false. |
abstract
boolean
|
isEncryptionSupported()
Trả về 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, nếu không thì trả về false. |
abstract
boolean
|
isHeadless()
Trả về true nếu thiết bị không có giao diện người dùng (không có màn hình), trả về false nếu không có màn hình. |
abstract
boolean
|
isRuntimePermissionSupported()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ cấp quyền khi bắt đầu chạy hay không |
abstract
boolean
|
isStateBootloaderOrFastbootd()
Trả về giá trị true nếu thiết bị đang ở |
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 lại thông điệp trong logcat của thiết bị. |
abstract
void
|
mountDebugfs()
Gắn gỡ lỗi. |
abstract
void
|
nonBlockingReboot()
Đưa ra lệnh để khởi động lại thiết bị và quay lại khi hoàn tất lệnh và khi thiết bị tắt hiển thị lâu hơn với adb. |
abstract
void
|
postBootSetup()
Thực hiện hướng dẫn định cấu hình thiết bị để 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.
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ị cụ thể sẽ được thực thi sau lệnh gọi là xong. |
default
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Các bước bổ sung để thiết lập chế độ bắt buộc theo từng thiết bị. Những bước này sẽ được thực thi trên thiết bị trước khi luồng gọi. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir)
Lấy nội dung thư mục từ thiết bị theo cách đệ quy. |
abstract
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Lấy nội dung thư mục từ thiết bị theo cách đệ quy. |
abstract
File
|
pullFile(String remoteFilePath, int userId)
Truy xuất tệp từ thiết bị, lưu trữ tệp đó trong |
abstract
File
|
pullFile(String remoteFilePath)
Truy xuất tệp từ thiết bị, lưu trữ tệp đó trong |
abstract
boolean
|
pullFile(String remoteFilePath, File localFile)
Truy xuất tệp ra khỏi thiết bị. |
abstract
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Truy xuất tệp ra khỏi thiết bị. |
abstract
String
|
pullFileContents(String remoteFilePath)
Truy xuất tệp ra khỏi 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
|
abstract
boolean
|
pushDir(File localDir, String deviceFilePath, int userId)
Đẩy định kỳ các nội dung trong thư mục sang thiết bị. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath,
Đẩy định kỳ nội dung trong thư mục sang thiết bị đồng thời loại trừ một số thư mục đã lọc. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath)
Đẩy định kỳ các nội dung trong thư mục sang thiết bị. |
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 đến 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 bằng |
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ế độ khởi động nhanh. |
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ế độ tải không qua cửa hàng adb (lưu ý rằng đây là chế độ đặc biệt đang trong quá trình khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ cài đặt không qua cửa hàng ứng dụng |
abstract
void
|
rebootIntoSideload()
Khởi động lại thiết bị ở chế độ tải không qua cửa hàng adb (lưu ý rằng đây là chế độ đặc biệt đang trong quá trình khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ cài đặt không qua cửa hàng ứng dụng |
abstract
void
|
rebootUntilOnline()
Một giải pháp thay thế cho |
abstract
void
|
rebootUntilOnline(String reason)
Một giải pháp thay thế cho |
abstract
void
|
rebootUserspace()
Chỉ khởi động lại một phần trong 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()
Đặ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ạo phân vùng nhà cung cấp trên thiết bị có thể ghi. |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Phương thức thuận tiện để biểu diễn |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Chạy kiểm thử đo lường và cung cấp dịch vụ khôi phục thiết bị. |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Giống như |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Giống như |
abstract
void
|
setDate(Date date)
Đặt ngày trên thiết bị Lưu ý: việc đặt ngày trên thiết bị yêu cầu thư mục gốc |
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 ta sử dụng để tham chiếu thiết bị. |
abstract
void
|
setUseFastbootErase(boolean useFastbootErase)
Đặt xem bạn nên sử dụng định dạng xoá khởi động nhanh hay định dạng khởi động nhanh để xoá sạch một phân vùng trên thiết bị. |
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á dữ liệu đầ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 adb qua chế độ USB. |
abstract
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Đồng bộ hoá 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()
Ngắt kết nối debugfs. |
abstract
boolean
|
waitForBootComplete(long timeOut)
Chặn cho đến khi cờ hoàn tất 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 để kiểm thử. |
abstract
boolean
|
waitForDeviceAvailable(long waitTime)
Chờ thiết bị phản hồi và sẵn sàng để kiểm thử. |
abstract
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Chờ thiết bị phản hồi và sẵn sàng 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ị thông qua tính năng khởi động nhanh. |
abstract
boolean
|
waitForDeviceInRecovery(long waitTime)
Chặn thiết bị trong quá trình "khôi phục adb" trạng thái (lưu ý rằng điều này khác với
|
abstract
boolean
|
waitForDeviceInSideload(long waitTime)
Các quy tắc chặn để thiết bị nằm trong "phần tải không qua cửa hàng adb" trạng thái |
abstract
boolean
|
waitForDeviceNotAvailable(long waitTime)
Các quy tắc chặn thiết bị không hoạt động, tức là bị thiếu 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 với lệnh adb shell cơ bản. |
Hằng số
KHÔNG XÁC ĐỊNH_API_LEVEL
public static final int UNKNOWN_API_LEVEL
Giá trị mặc định khi không thể phát hiện cấp độ API
Giá trị 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 hiện có được hỗ trợ ở mức tối thiểu được hỗ trợ hay không. Chiến dịch này tính đến các tính năng chưa được phát hành, trước khi tăng cấp độ API.
Tham số | |
---|---|
strictMinLevel |
int : Cấp độ nghiêm ngặt tối thiểu có thể hỗ trợ tính năng này. |
Giá trị trả về | |
---|---|
boolean |
Đúng nếu cấp độ này được hỗ trợ. Nếu không thì là False. |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
xoáLogcat
public abstract void clearLogcat ()
Xoá mọi dữ liệu logcat đã tích luỹ.
Điều này hữu ích cho trường hợp bạn muốn đảm bảo rằng 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 một bản dựng thiết bị mới, v.v.).
xoá tệp
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 |
xoá tệp
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á |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
thiết bị đã khởi động lại mềm
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
system_server trước đó ProcessInfo
. Dùng getProcessByName(String)
để hưởng ProcessInfo
.
Tham số | |
---|---|
prevSystemServerProcess |
ProcessInfo : quá 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 |
thiết bịSoftRestartedSince
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 tạm thời kể từ thời gian UTC kể từ thời gian bắt đầu của hệ thống hay không
thiết bị và ERROR(/TimeUnit)
của thiết bị đó. Khởi động lại mềm đề cập đến system_server khởi động lại bên ngoài
khởi động cứng thiết bị (ví dụ: đã yêu cầu khởi động lại). Thiết bị hiện tại utcEpochTime trong
Có thể thu được Milivôn 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 của 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 |
vô hiệu hoáAdbRoot
public abstract boolean disableAdbRoot ()
Tắt adb gốc.
Việc tắt adb gốc 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 thiết bị của họ.
Giá trị trả về | |
---|---|
boolean |
true nếu thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
không có tệpExist
public abstract boolean doesFileExist (String deviceFilePath)
Phương thức trợ giúp để xác định xem có tệp 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, nếu không thì false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
enableAdbRoot
public abstract boolean enableAdbRoot ()
Bật thư mục gốc adb. Nếu lệnh "enable-root" là "false", sẽ ghi lại thông báo và trả về mà không cần bật thư mục gốc.
Việc bật adb gốc 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 thiết bị của họ.
Giá trị trả về | |
---|---|
boolean |
true nếu thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiAdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
Phương thức trợ giúp sẽ thực thi một lệnh adb dưới dạng một lệnh hệ thống với thời gian chờ được chỉ định.
Nếu có thể, bạn nên sử dụng executeShellCommand(String)
, vì như vậy
mang lại hiệu suất và khả năng phát hiện lỗi 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 đối với
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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiAdbCommand
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 một lệnh hệ thống.
Nếu có thể, bạn nên sử dụng executeShellCommand(String)
, vì như vậy
mang lại hiệu suất và khả năng phát hiện lỗi 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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiAdbCommand
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
Phương thức trợ giúp sẽ thực thi một lệnh adb dưới dạng một lệnh hệ thống với thời gian chờ được chỉ định.
Nếu có thể, bạn nên sử dụng executeShellCommand(String)
, vì như vậy
mang lại hiệu suất và khả năng phát hiện lỗi 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 đối với
không có thời gian chờ |
envMap |
: môi trường để đặ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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thi FastbootCommand
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ị đang ở 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ố cần chạy |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả của lệnh |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thi FastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
Phương thức trợ giúp sẽ thực thi một lệnh khởi động nhanh dưới dạng một 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ị đang ở chế độ khởi động nhanh.
Tham số | |
---|---|
commandArgs |
String : lệnh khởi động nhanh và các đối số cần chạy |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả của lệnh |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
Phương thức trợ giúp giúp thực thi một 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 hệt với executeFastbootCommand(String)
, ngoại trừ việc sử dụng thời gian chờ dài hơn.
Tham số | |
---|---|
commandArgs |
String : lệnh khởi động nhanh và các đối số cần chạy |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả của lệnh |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiLongFastbootCommand
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
Phương thức trợ giúp thực thi một lệnh khởi động nhanh chạy trong thời gian dài dưới dạng một lệnh hệ thống với hệ thống biến môi trường.
Giống hệt với executeFastbootCommand(String)
, ngoại trừ việc sử dụng thời gian chờ dài 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ố cần chạy |
Giá trị trả về | |
---|---|
CommandResult |
CommandResult chứa kết quả của lệnh |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiShellCommand
public abstract String executeShellCommand (String command)
Phương thức trợ giúp sẽ thực thi một lệnh shell adb và trả về kết quả dưới dạng String
.
Tham số | |
---|---|
command |
String : lệnh adb shell để chạy |
Giá trị trả về | |
---|---|
String |
kết quả đầu ra shell |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
Tham số | |
---|---|
command |
String : lệnh adb shell để chạy |
receiver |
IShellOutputReceiver : IShellOutputReceiver để trực tiếp điều hướng đầu ra shell đến. |
maxTimeToOutputShellResponse |
long : khoảng thời gian tối đa mà lệnh được thực hiện
được phép không đưa ra bất kỳ phản hồi nào; như được chỉ định trong timeUnit |
timeUnit |
TimeUnit : đơn vị của 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
ngoại lệ. DeviceNotresponseException sẽ được gửi nếu retryAttempts
được thực hiện mà không thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
Tham số | |
---|---|
command |
String : lệnh adb shell để chạy |
receiver |
IShellOutputReceiver : IShellOutputReceiver để trực tiếp điều hướng đầu ra shell đến. |
maxTimeoutForCommand |
long : thời gian chờ tối đa để hoàn tất lệnh; đơn vị dưới dạng
được chỉ định ở timeUnit |
maxTimeToOutputShellResponse |
long : khoảng thời gian tối đa mà lệnh được thực hiện
được phép không đưa ra bất kỳ phản hồi nào; như được chỉ định trong timeUnit |
timeUnit |
TimeUnit : đơn vị của 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
ngoại lệ. DeviceNotResponseException sẽ được gửi nếu retryAttempts là
thực hiện không thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiShellCommand
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 hình thức đơn giản hơn
executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
bằng
giá trị mặc định.
Tham số | |
---|---|
command |
String : lệnh adb shell để chạy |
receiver |
IShellOutputReceiver : IShellOutputReceiver để trực tiếp điều hướng đầu ra shell đến. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiShellV2Command
public abstract CommandResult executeShellV2Command (String command)
Phương thức trợ giúp sẽ thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult
được điền đúng cách cùng với đầu ra trạng thái của lệnh là 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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
Phương thức trợ giúp sẽ thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult
được điền đúng cách cùng với đầu ra trạng thái và stderr của lệnh. stdout là
chuyển hướng đến luồng được chỉ định.
Tham số | |
---|---|
command |
String : Lệnh cần chạy. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , trong đó đầu ra std sẽ được chuyển hướng hoặc rỗng. |
Giá trị trả về | |
---|---|
CommandResult |
Kết quả bằng CommandResult . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
Phương thức trợ giúp sẽ thực thi lệnh shell adb và trả về kết quả dưới dạng CommandResult
được điền đúng cách cùng với đầu ra trạng thái của lệnh là stdout và stderr.
Tham số | |
---|---|
command |
String : Lệnh cần chạy. |
pipeAsInput |
File : Một ERROR(/File) sẽ được chuyển thành đầ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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
Thực thiShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
Tham số | |
---|---|
command |
String : lệnh adb shell để chạy |
maxTimeoutForCommand |
long : thời gian chờ tối đa để hoàn tất lệnh; đơn vị dưới dạng
được chỉ định ở timeUnit |
timeUnit |
TimeUnit : đơn vị của 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
ngoại lệ. DeviceNotResponseException sẽ được gửi nếu retryAttempts là
thực hiện không thành công. |
Giá trị trả về | |
---|---|
CommandResult |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Xem thêm:
Thực thiShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
Tham số | |
---|---|
command |
String : lệnh adb shell để chạy |
maxTimeoutForCommand |
long : thời gian chờ tối đa để hoàn tất lệnh; đơn vị dưới dạng
được chỉ định ở timeUnit |
timeUnit |
TimeUnit : đơn vị của maxTimeToOutputShellResponse |
Giá trị trả về | |
---|---|
CommandResult |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Xem thêm:
Thực thiShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
Tham số | |
---|---|
command |
String : lệnh adb shell để chạy |
pipeAsInput |
File : Một ERROR(/File) sẽ được chuyển thành đầu vào cho lệnh hoặc giá trị rỗng. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , trong đó đầ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ị dưới dạng
được chỉ định ở timeUnit |
timeUnit |
TimeUnit : đơn vị của 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
ngoại lệ. DeviceNotResponseException sẽ được gửi nếu retryAttempts là
thực hiện không thành công. |
Giá trị trả về | |
---|---|
CommandResult |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Xem thêm:
Thực thiShellV2Command
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 shell adb, với các tham số khác để kiểm soát hành vi của lệnh.
Tham số | |
---|---|
command |
String : lệnh adb shell để chạy |
pipeAsInput |
File : Một ERROR(/File) sẽ được chuyển thành đầu vào cho lệnh hoặc giá trị rỗng. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , trong đó đầ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ị dưới dạng
được chỉ định ở timeUnit |
timeUnit |
TimeUnit : đơn vị của 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
ngoại lệ. DeviceNotResponseException sẽ được gửi nếu retryAttempts là
thực hiện không thành công. |
Giá trị trả về | |
---|---|
CommandResult |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Xem thêm:
khởi động nhanhWipePartition
public abstract CommandResult fastbootWipePartition (String partition)
Phương thức trợ giúp 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á sạch
phân vùng. Sau đó, thiết bị phải tạo một hệ thống tệp vào lần khởi động tiếp theo của thiết bị.
Nếu không, định dạng khởi động nhanh sẽ được dùng để tạo hệ thống tệp mới trên thiết bị.
Dự kiến sẽ được sử dụng khi thiết bị đang ở 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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
lấy cấp độ API
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 |
nhận phiên bản băng tần cơ sở
public abstract String getBasebandVersion ()
Phương thức thuận tiện để mua phiên bản băng tần cơ sở (vô tuyến) của thiết bị này. Tải phiên bản đài phát thanh
dành riêng cho từng thiết bị, vì vậy tính năng này có thể không trả về thông tin chính xác cho tất cả thiết bị. Chiến dịch này
dựa vào thuộc tính gsm.version.base Band để trả về thông tin phiên bản chính xác.
Điều này không chính xác đối với một số thiết bị CDMA và phiên bản được trả về ở đây có thể không khớp
phiên bản được báo cáo từ chế độ khởi động nhanh và có thể không trả về phiên bản cho hệ thống vô tuyến 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.base Band là
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 chuỗi phiên bản không đọc được) |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể có thể được 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 trả về giá trị rỗng nếu không có mức pin.
Giá trị trả về | |
---|---|
Integer |
Thuộc tính getBoolean
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ị là "0" ,
"n" , "no" , "off" , "false" hoặc defaultValue
nếu không. |
Gửi | |
---|---|
DeviceNotAvailableException |
getNhật ký khởi động
public abstractgetBootHistory ()
Phương thức trợ giúp thu thập bản đồ nhật ký khởi động, kèm theo 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ừ Kỷ nguyên) và lý do khởi động |
Gửi | |
---|---|
DeviceNotAvailableException |
nhận nhật ký khởi động từ
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
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 kể từ khi
kể từ thời gian bắt đầu của hệ thống từ thiết bị và đơn vị thời gian đã chỉ định. Thiết bị hiện tại utcEpochTime trong
Mili giây có thể thu được bằng phương thức getDeviceDate()
.
Tham số | |
---|---|
utcEpochTime |
long : thời gian 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ừ Kỷ nguyên) và lý do khởi động |
Gửi | |
---|---|
DeviceNotAvailableException |
nhận phiên bản trình tải khởi động
public abstract String getBootloaderVersion ()
Phương thức thuận tiện để tải phiên bản trình tải khởi động của thiết bị này.
Sẽ tìm cách 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ị. (ví dụ: nếu thiết bị đang ở chế độ khởi động nhanh, hệ thống sẽ tìm cách 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 phiên bản này |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất 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 mã bản dựng (thường là một số của phiên bản Nexus). Ví dụ: bản phát hành Android 4.2 chính thức có bí danh bản dựng JDQ39 và id 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 truy xuất được mã bản dựng đó |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
tạo hương vị
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 bản dựng hoặc giá trị rỗng nếu không thể truy xuất được phiên bản đó |
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 truy xuất được |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBuildKýKeys
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 các 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ì khoá sẽ rỗng. |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getBộ nhớ đệm thiết bị mô tả
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
Trả về một DeviceDescriptor
đã lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không sẽ trả về
DeviceDescriptor
hiện tại.
Giá trị trả về | |
---|---|
DeviceDescriptor |
getBộ nhớ đệm thiết bị mô tả
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Trả về một DeviceDescriptor
đã lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không sẽ trả về
DeviceDescriptor
hiện tại.
Tham số | |
---|---|
shortDescriptor |
boolean : Có giới hạn phần mô tả ở dạng thông tin tối thiểu hay không |
Giá trị trả về | |
---|---|
DeviceDescriptor |
lấy trẻ em
public abstract String[] getChildren (String deviceFilePath)
Phương pháp thay thế cho việc sử dụng IFileEntry
mà đôi khi không hoạt động do 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 . |
ngày thiết bị
public abstract long getDeviceDate ()
Trả về ngày của thiết bị tính bằng 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ả lại một DeviceDescriptor
trong thông tin thiết bị để nhận thông tin trên 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ả lại một DeviceDescriptor
trong thông tin thiết bị để nhận thông tin trên 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 phần mô tả ở dạng thông tin tối thiểu hay không |
Giá trị trả về | |
---|---|
DeviceDescriptor |
nhận Trạng thái thiết bị
public abstract TestDeviceState getDeviceState ()
Xem trạng thái của thiết bị.
Giá trị trả về | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
Giúp bạn tìm chênh lệch thời gian giữa thiết bị và một ERROR(/Date)
cụ thể. Sử dụng Giờ bắt đầu của hệ thống
nội bộ.
Tham số | |
---|---|
date |
Date |
Giá trị trả về | |
---|---|
long |
mức chênh lệch tính 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 pháp 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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
loại chiến dịch khởi động nhanh
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. Biến thể an toàn hơn một chút
so với phương thức getProductType()
chung trong trường hợp này, vì ITestDevice
sẽ biết để khôi phục thiết bị vào chế độ khởi động nhanh nếu thiết bị ở trạng thái không chính xác hoặc đang
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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
phương thứ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. Biến thể an toàn hơn một chút
so với phương thức getProductType()
chung trong trường hợp này, vì ITestDevice
sẽ biết để khôi phục thiết bị vào chế độ khởi động nhanh nếu thiết bị ở trạng thái không chính xác hoặc đang
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 kết nối với thiết bị bị mất 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 |
phương thức khởi động nhanh
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 tồn tại |
Gửi | |
---|---|
|
Trường hợp ngoại lệ không được hỗ trợ |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
Truy xuất 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à một đường dẫn hoặc đường dẫn tuyệt đối tương đối so với "/". (ví dụ:
cả "/system" và "hệ thống" có hỗ trợ cú pháp) |
Giá trị trả về | |
---|---|
IFileEntry |
IFileEntry hoặc null nếu tệp tại path đã cho không thể
được tìm thấy |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
Trả về tham chiếu đến IDevice
ddmlib 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 từ adb. Do đó, phương thức gọi không được giữ lại tham chiếu đến IDevice
,
vì tham chiếu đó có thể đã 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 |
getLastSuggestedRestartTimeMillis cho lượt khởi động lại
public abstract long getLastExpectedRebootTimeMillis ()
Trả về lần gần đây nhất Trade tác API kích hoạt khởi động lại tính bằng mili giây kể từ khi EPOCH là
được trả về bởi System.currentTimeMillis()
.
Giá trị trả về | |
---|---|
long |
getLaunchApilevel
public abstract int getLaunchApiLevel ()
Lấy Cấp độ API đầ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 khởi chạy đầu tiên của thiết bị |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
lấy Logcat
public abstract InputStreamSource getLogcat ()
Lấy một 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 chế độ nền sau
thu thập logcat
Giá trị trả về | |
---|---|
InputStreamSource |
lấy Logcat
public abstract InputStreamSource getLogcat (int maxBytes)
Lấy luồng ảnh chụp nhanh của maxBytes
dữ liệu logcat đã thu thập gần đây nhất.
Hữu ích cho các trường hợp bạn muốn thường xuyên chụp ảnh nhanh dữ liệu logcat đã thu thập
mà không phải chịu hình phạt dung lượng ổ đĩa lớn có thể là 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à số tiền có thể
vừa khít với bộ nhớ |
Giá trị trả về | |
---|---|
InputStreamSource |
tải LogcatDump
public abstract InputStreamSource getLogcatDump ()
Tải tệp 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 tệp kết xuất tĩnh của logcat.
Nhược điểm là sẽ không có nội dung nào được trả về nếu không kết nối được với thiết bị.
Giá trị trả về | |
---|---|
InputStreamSource |
InputStreamSource dữ liệu logcat. Một luồng trống sẽ được trả về nếu không thành công
để thu thập dữ liệu logcat. |
Nhận Logcat từ
public abstract InputStreamSource getLogcatSince (long date)
Lấy một luồng tổng quan nhanh về dữ liệu logcat đã ghi bắt đầu từ ngày đã cung cấp. Thời gian trên
thiết bị sẽ được sử dụng getDeviceDate()
.
Tham số | |
---|---|
date |
long : tính bằng mili giây kể từ định dạng thời gian bắt đầu của thời điểm bắt đầu bản tổng quan nhanh cho đến hiện tại.
(có thể lấy bằng cách sử dụng 'ngày +%s') |
Giá trị trả về | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
Trả về một điểm gắn.
Truy vấn trực tiếp thiết bị nếu không có thông tin đã 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ề một 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ó giá trị nào được gắn hoặc không xuất hiện trong
/proc/Mua sắm làm điểm gắn.
Tham số | |
---|---|
mountpoint |
String |
Giá trị trả về | |
---|---|
ITestDevice.MountPointInfo |
ERROR(/List) trong số MountPointInfo chứa thông tin trong "/proc/videos" |
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/sticks trên thiết bị
Giá trị trả về | |
---|---|
|
ERROR(/List) trong số MountPointInfo chứa thông tin trong "/proc/videos" |
Gửi | |
---|---|
DeviceNotAvailableException |
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
Phương pháp 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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
Phương thức trợ giúp sẽ chạy "pidof" và "số liệu thống kê" và trả về đối tượng ProcessInfo
bằng
PID và thời gian bắt đầu tiến trình của một quy trình cụ thể.
Tham số | |
---|---|
processName |
String : Chuỗi tên thủ tục. |
Giá trị trả về | |
---|---|
ProcessInfo |
ProcessInfo của processName nhất định |
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 xảy ra lỗi.
Tham số | |
---|---|
process |
String : Chuỗi tên thủ tục. |
Giá trị trả về | |
---|---|
String |
Gửi | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
Phương thức thuận tiện để mua 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ị đang ở chế độ adb hoặc chế độ khởi động nhanh.
Giá trị trả về | |
---|---|
String |
tên loại sản phẩm String . Sẽ không có giá trị rỗng |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục hoặc nếu không thể xác định loại sản phẩm |
getProductVariant
public abstract String getProductVariant ()
Phương thức thuận tiện để mua 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ị đang ở chế độ adb hoặc chế độ khởi động nhanh.
Giá trị trả về | |
---|---|
String |
tên biến thể sản phẩm String hoặc null nếu không thể
đã xác định |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
nhận thuộc tính
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 tồn tại |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
lấy lại Chế độ khôi phục
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
Tải 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 tombstone trên các thiết bị. Cần phải can thiệp vào hệ thống.
phương pháp là nỗ lực nhất, nhưng nếu không kéo được bia mộ vì bất kỳ lý do gì thì nó sẽ
bị thiếu trong danh sách. Chỉ DeviceNotAvailableException
mới chấm dứt phương thức
sớm.
Giá trị trả về | |
---|---|
|
Danh sách các tệp tombstone, trống nếu không có tombstone. |
Gửi | |
---|---|
DeviceNotAvailableException |
Xem thêm:
getTotalMemory
public abstract long getTotalMemory ()
Trả về tổng kích thước bộ nhớ thực tính bằng byte hoặc -1 trong trường hợp có lỗi nội bộ
Giá trị trả về | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
Nhằm mục đích 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 |
getUseKhởi động nhanh
public abstract boolean getUseFastbootErase ()
Chọn sử dụng định dạng xoá khởi động nhanh hay định dạng khởi động nhanh để xoá sạch một phân vùng trên thiết bị.
Giá trị trả về | |
---|---|
boolean |
true nếu định dạng khởi động nhanh được sử dụng hoặc false nếu định dạng khởi động nhanh
để sử dụng. |
Xem thêm:
isAdbRoot
public abstract boolean isAdbRoot ()
Giá trị trả về | |
---|---|
boolean |
true nếu thiết bị hiện có gốc adb, nếu không thì false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất 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. |
isAppEnumeration được hỗ trợ
public abstract boolean isAppEnumerationSupported ()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ tính năng liệt kê ứng dụng hay không
Giá trị trả về | |
---|---|
boolean |
True nếu liệt kê ứng dụng được hỗ trợ, false nếu không hỗ trợ |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Hàm isBypassLowTargetSdkBlockSupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ 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 bỏ qua khối sdk mục tiêu thấp được hỗ trợ, nếu không thì là false |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isDebugfsMounted
public abstract boolean isDebugfsMounted ()
Kiểm tra xem Debugfs đã được gắn kết hay chưa.
Giá trị trả về | |
---|---|
boolean |
true nếu debugfs được liên kết |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Đã mã hoá thiết bị
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 kết nối với thiết bị bị mất 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, nếu không thì trả về false.
Tham số | |
---|---|
deviceFilePath |
String |
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Hỗ trợ Mã hoá
public abstract boolean isEncryptionSupported ()
Trả về 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ợ mã hoá. |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
có thể thực thi
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, nếu không thì trả về false.
Tham số | |
---|---|
fullPath |
String |
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Không có giao diện người dùng
public abstract boolean isHeadless ()
Trả về true nếu thiết bị không có giao diện người dùng (không có màn hình), trả về false nếu không có màn hình.
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
isRuntimePermission được hỗ trợ
public abstract boolean isRuntimePermissionSupported ()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ cấp quyền khi bắt đầu chạy hay không
Giá trị trả về | |
---|---|
boolean |
True nếu quyền khi bắt đầu chạy được hỗ trợ, nếu không thì là false. |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
isStateKhởi động hoặc Khởi động nhanh
public abstract boolean isStateBootloaderOrFastbootd ()
Trả về giá trị true nếu thiết bị đang ở 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ý các lỗi ANR. |
Giá trị trả về | |
---|---|
boolean |
True nếu quá trình ghi nhật ký thành công, nếu không thì sẽ trả về false. |
Gửi | |
---|---|
DeviceNotAvailableException |
đăng nhập trên thiết bị
public abstract void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Ghi lại thông điệp trong logcat của thiết bị. Đây là lệnh gọi an toàn và 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 dùng để ghi nhật ký thông điệp của mình 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 : đối số sẽ được thay thế thông qua String.format(). |
Debugfs
public abstract void mountDebugfs ()
Gắn gỡ lỗi.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
không chặn khởi động lại
public abstract void nonBlockingReboot ()
Đưa ra lệnh để khởi động lại thiết bị và quay lại khi hoàn tất lệnh và khi thiết bị tắt hiển thị lâu hơn với adb.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Thiết lập postBoot
public abstract void postBootSetup ()
Thực hiện hướng dẫn định cấu hình thiết bị để kiểm thử sau mỗi lần khởi động.
Sẽ được gọi sau khi thiết bị khởi động xong/có sẵn
Trong các 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ì Quá trình triển khai sẽ tự động thực hiện các bước này khi khởi động lại.
Vị trí có thể cần gọi là khi thiết bị khởi động lại do các sự kiện khác (ví dụ: lệnh cập nhật khởi động nhanh đã hoàn tất)
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất 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.
Thay vào đó, 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ị cụ thể sẽ được thực thi sau lệnh gọi là xong.
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ị cụ thể sẽ được thực thi sau lệnh gọi là xong.
Tham số | |
---|---|
invocationException |
Throwable : nếu có thì ngoại lệ cuối cùng do lỗi lệnh gọi phát sinh. |
Thiết lập preInvocation
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Các bước bổ sung để thiết lập chế độ bắt buộc theo từng thiết bị. Những bước này sẽ được thực thi trên thiết bị trước khi luồng 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 lệnh gọi |
Gửi | |
---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
TargetSetupError |
kéoDir
public abstract boolean pullDir (String deviceFilePath, File localDir)
Lấy 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 bạn kéo tệp thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
kéoDir
public abstract boolean pullDir (String deviceFilePath, File localDir, int userId)
Lấy 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 bạn kéo tệp thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
tệp kéo
public abstract File pullFile (String remoteFilePath, int userId)
Truy xuất tệp từ thiết bị, lưu trữ tệp đó trong ERROR(/File)
cục bộ tạm thời và trả về tệp đó
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
không sao chép được vì bất kỳ lý do nào (bao gồm cả sự cố với hệ thống tệp lưu trữ) |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
tệp kéo
public abstract File pullFile (String remoteFilePath)
Truy xuất tệp từ thiết bị, lưu trữ tệp đó trong ERROR(/File)
cục bộ tạm thời và trả về tệp đó
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
không sao chép được vì bất kỳ lý do nào (bao gồm cả sự cố với hệ thống tệp lưu trữ) |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
tệp kéo
public abstract boolean pullFile (String remoteFilePath, File localFile)
Truy xuất tệp ra 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
bị thay thế. |
Giá trị trả về | |
---|---|
boolean |
true nếu tệp được truy xuất thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
tệp kéo
public abstract boolean pullFile (String remoteFilePath, File localFile, int userId)
Truy xuất tệp ra 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
bị 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 . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
putFileContents
public abstract String pullFileContents (String remoteFilePath)
Truy xuất tệp ra khỏi 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
không sao chép được vì bất kỳ lý do nào (bao gồm cả sự cố với hệ thống tệp lưu trữ) |
Gửi | |
---|---|
DeviceNotAvailableException |
kéotệp từ bên ngoài
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
ERROR(/File)
tạm thời cục bộ rồi trả về một tham chiếu đến File
đó.
Tham số | |
---|---|
remoteFilePath |
String : đường dẫn đến tệp trên thiết bị, so với bộ nhớ ngoài của thiết bị
điểm gắn |
Giá trị trả về | |
---|---|
File |
ERROR(/File) chứa nội dung của tệp thiết bị hoặc null nếu
không sao chép được vì bất kỳ lý do nào (bao gồm cả sự cố với hệ thống tệp lưu trữ) |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath, int userId)
Đẩy định kỳ các nội dung trong thư mục sang thiết bị.
Tham số | |
---|---|
localDir |
File : thư mục cục bộ sẽ đẩ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 bạn đẩy tệp thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath,excludedDirectories)
Đẩy định kỳ nội dung trong thư mục sang thiết bị đồng thời loại trừ một số thư mục đã lọc.
Tham số | |
---|---|
localDir |
File : thư mục cục bộ sẽ đẩy |
deviceFilePath |
String : đường dẫn tệp tuyệt đối của đích đến từ xa |
excludedDirectories |
: Tập hợp tên của các thư mục bị loại trừ không được đẩy lên. |
Giá trị trả về | |
---|---|
boolean |
true nếu bạn đẩy tệp thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
pushDir
public abstract boolean pushDir (File localDir, String deviceFilePath)
Đẩy định kỳ các nội dung trong thư mục sang thiết bị.
Tham số | |
---|---|
localDir |
File : thư mục cục bộ sẽ đẩ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 bạn đẩy tệp thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
tệp đẩy
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 (không bắt buộc)
cho 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 cho đích đến từ xa |
evaluateContentProviderNeeded |
boolean : liệu để kiểm tra xem chúng tôi có cần trình cung cấp nội dung hay không |
Giá trị trả về | |
---|---|
boolean |
true nếu bạn đẩy tệp thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
tệp đẩy
public abstract boolean pushFile (File localFile, String deviceFilePath)
Đẩy tệp vào thiết bị. Theo mặc định, việc 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 cho đích đến từ xa |
Giá trị trả về | |
---|---|
boolean |
true nếu bạn đẩy tệp thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
tệp đẩy
public abstract boolean pushFile (File localFile, String deviceFilePath, int userId)
Đẩy tệp vào thiết bị. Theo mặc định, việc 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 cho đích đến từ xa |
userId |
int : userId để đẩy đến |
Giá trị trả về | |
---|---|
boolean |
true nếu bạn đẩy tệp thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
chuỗi thông báo đẩy
public abstract boolean pushString (String contents, String deviceFilePath)
Đẩy tệp được tạo từ một chuỗi đến 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 cho đích đến từ xa |
Giá trị trả về | |
---|---|
boolean |
true nếu chuỗi được đẩy thành công. false . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất 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.
Các quy tắc chặn cho đến khi có thiết bị.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không khả dụ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 bằng reason
nhất định để duy trì khi khởi động lại.
Các quy tắc chặn cho đến khi có thiết bị.
Bạn có thể biết lý do khởi động lại lần gần đây nhất bằng cách truy vấn truy vấn truy vấn sys.boot.reason
.
Tham số | |
---|---|
reason |
String : lý do khởi động lại hoặc null nếu bạn không chỉ định lý do. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không khả dụng sau khi khởi động lại |
khởi động lạiIntoBootloader
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 kết nối với thiết bị bị mất và không thể đã khôi phục. |
khởi động lạiIntoFastbootd
public abstract void rebootIntoFastbootd ()
Khởi động lại thiết bị ở chế độ khởi động nhanh.
Chặn cho đến khi thiết bị ở chế độ khởi động nhanh.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
khởi động lạiIntoRecovery
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 bước khôi phục
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không khả dụng sau khi khởi động lại |
khởi động lạiIntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
Khởi động lại thiết bị ở chế độ tải không qua cửa hàng adb (lưu ý rằng đây là chế độ đặc biệt đang trong quá trình khôi phục)
Chặn cho đến khi thiết bị chuyển sang chế độ cài đặt không qua cửa hàng ứng dụng
Tham số | |
---|---|
autoReboot |
boolean : có tự động khởi động lại thiết bị sau khi cài đặt không qua cửa hàng ứng dụng hay không |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không tải không qua cửa hàng ứng dụng sau khi khởi động lại |
khởi động lạiIntoSideload
public abstract void rebootIntoSideload ()
Khởi động lại thiết bị ở chế độ tải không qua cửa hàng adb (lưu ý rằng đây là chế độ đặc biệt đang trong quá trình khôi phục)
Chặn cho đến khi thiết bị chuyển sang chế độ cài đặt không qua cửa hàng ứng dụng
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không tải không qua cửa hàng ứng dụng sau khi khởi động lại |
khởi động lại cho đến khi trực tuyến
public abstract void rebootUntilOnline ()
Một giải pháp thay thế cho reboot()
chỉ chặn cho đến khi thiết bị kết nối mạng, tức là hiển thị với adb.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không khả dụng sau khi khởi động lại |
khởi động lại cho đến khi trực tuyến
public abstract void rebootUntilOnline (String reason)
Một giải pháp thay thế cho reboot()
chỉ chặn cho đến khi thiết bị 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 bạn không chỉ định lý do. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không khả dụng sau khi khởi động lại |
Xem thêm:
khởi động lạikhông gian người dùng
public abstract void rebootUserspace ()
Chỉ khởi động lại một phần trong không gian người dùng của thiết bị.
Các quy tắc chặn cho đến khi có thiết bị.
CẢNH BÁO. Quá trình 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 quá trình này.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không khả dụng sau khi khởi động lại |
khởi động lại
public abstract void rebootUserspaceUntilOnline ()
Một lựa chọn thay thế cho rebootUserspace()
()} chỉ chặ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 thiết bị không khả dụng sau khi khởi động lại |
chỉ đọc lại hệ thống
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 |
kết nối lạiHệ thống có thể ghi
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 |
chỉ đọc lại nhà cung cấp
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 |
gắn lại nhà cung cấp có thể ghi
public abstract void remountVendorWritable ()
Tạo phân vùng nhà cung cấp trên thiết bị có thể ghi. Có thể khởi động lại thiết bị.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
chạyInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Phương thức thuận tiện để biểu diễ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 bài 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 thực hiện được
đã hoàn tất, nhưng đã khôi phục thành công |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. tức là không hoàn tất được lệnh kiểm thử và không khôi phục được. |
chạyInstrumentationTests
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Chạy kiểm thử đo lường và cung cấp dịch vụ khôi phục thiết bị.
Nếu bị mất kết nối với thiết bị trước khi chạy thử nghiệm hoàn tất và khôi phục thành công, tất cả trình nghe sẽ được thông báo về testRunFailed và "false" (sai) sẽ được trả về. Lệnh kiểm thử sẽ không được chạy lại. Người gọi sẽ có quyền thử lại nếu cần.
Nếu bị mất kết nối với thiết bị trước khi chạy thử nghiệm hoàn tất và không khôi phục được, 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 bài 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 thực hiện được
đã hoàn tất do ngoại lệ về giao tiếp trên thiết bị nhưng đã khôi phục thành công |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. tức là không hoàn tất được lệnh kiểm thử và không khôi phục được. |
runInstrumentationTestsAsUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Giống như ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
nhưng
sẽ chạy bài kiểm thử cho người dùng cụ thể.
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)
Giống 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 |
ngày đặt
public abstract void setDate (Date date)
Đặt ngày trên thiết bị
Lưu ý: việc đặt ngày trên thiết bị yêu cầu thư mục gốc
Tham số | |
---|---|
date |
Date : chỉ định một ngày cụ thể; sẽ sử dụng ngày 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 |
đặt thuộc tính
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 gốc adb là true.
Tham số | |
---|---|
propKey |
String : Khoá được nhắm mục tiêu cần đặt. |
propValue |
String : Giá trị thuộc tính cần đặt. |
Giá trị trả về | |
---|---|
boolean |
sẽ trả về True nếu lệnh setprop thành công, nếu không thì sẽ trả về False. |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Đặt lại
public abstract void setRecovery (IDeviceRecovery recovery)
Đặt IDeviceRecovery
để sử dụng cho thiết bị này. Nên đặt khi thiết bị là đầu tiên
đã phân bổ.
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 cần sử dụng khi gặp sự cố giao tiếp với thiết bị gặp phải. Bạn chỉ nên dùng phương pháp này một cách thận trọng khi cần (ví dụ: khi khung đi xuống, v.v.
Tham số | |
---|---|
mode |
ITestDevice.RecoveryMode : chọn "chỉ khôi phục cho đến khi trực tuyến" có nên bật 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 ta sử dụng để tham chiếu thiết bị.
Tham số | |
---|---|
trackingSerial |
String |
setUse FastbootXoá
public abstract void setUseFastbootErase (boolean useFastbootErase)
Đặt xem nên sử dụng định dạng xoá khởi động nhanh hay định dạng khởi động nhanh để xoá sạch một phân vùng trên thiết bị.
Tham số | |
---|---|
useFastbootErase |
boolean : true nếu cần sử dụng tính năng xoá khởi động nhanh hoặc false nếu
bạn nên dùng định dạng khởi động nhanh. |
Xem thêm:
bắt đầuLogcat
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 đó, bạn có thể truy xuất dữ liệu qua getLogcat.
Khi không 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
trong ngữ cảnh lệnh gọi TF, vì khung TF sẽ bắt đầu và dừng logcat.
dừngTrình mô phỏngOutput
public abstract void stopEmulatorOutput ()
Đóng và xoá dữ liệu đầu ra của trình mô phỏng.
dừngLogcat
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ó ảnh hưởng nếu đầu ra logcat không được ghi lại.
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 adb qua chế độ USB.
Giá trị trả về | |
---|---|
boolean |
true nếu quá trình chuyển đổi thành công, nếu không thì false . |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
SyncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
Đồng bộ hoá 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 trên máy bằng điều khiển từ xa quy tắc tương đương. Chỉ "newer" (mới hơn) hoặc không tồn tại sẽ được đẩy tới thiết bị. Do đó, mức hao tổn phải tương đối nhỏ nếu thiết lập 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 tệp này không tồn tại và đẩy nội dung /tmp/files theo cách đệ quy 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 : gốc đường dẫn tệp tuyệt đối của đích đến từ xa. Tất cả thư mục trong thos
đường dẫn tệp phải đọc được. tức là đẩy tới /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 . |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
mở khoá thiết bị
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 để được kiểm thử khi phương thức này trả về.
Giá trị trả về | |
---|---|
boolean |
true nếu thiết bị thành công hoặc nếu thiết bị chưa được mã hoá. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
UnsupportedOperationException |
nếu thiết bị không hỗ trợ mã hoá. |
gỡ lỗi gắn kết
public abstract void unmountDebugfs ()
Ngắt kết nối debugfs.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Chờ đợiKhởi động hoàn tất
public abstract boolean waitForBootComplete (long timeOut)
Chặn cho đến khi cờ hoàn tất khởi động của thiết bị được đặt.
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 |
Chờ thiết bị có sẵn
public abstract boolean waitForDeviceAvailable ()
Chờ thiết bị phản hồi và sẵn sàng để kiểm thử. Sử dụng thời gian chờ mặc định.
Giá trị trả về | |
---|---|
boolean |
"True" nếu có thiết bị, False nếu tính năng khôi phục bị tắt và không hoạt động. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
Chờ thiết bị có sẵn
public abstract boolean waitForDeviceAvailable (long waitTime)
Chờ thiết bị phản hồi và sẵn sàng để kiểm thử.
Tham số | |
---|---|
waitTime |
long : thời gian tính bằng mili giây |
Giá trị trả về | |
---|---|
boolean |
"True" nếu có thiết bị, False nếu tính năng khôi phục bị tắt và không hoạt động. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị vẫn không phản hồi sau khi hết thời gian chờ. |
Chờ đợi thiết bị có sẵnInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Chờ thiết bị phản hồi và sẵn sàng mà không xem xét đường dẫn khôi phục.
Tham số | |
---|---|
waitTime |
long |
Giá trị trả về | |
---|---|
boolean |
"True" nếu có thiết bị, False nếu không có thiết bị. |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
bộ lọc khởi động thiết bị
public abstract void waitForDeviceBootloader ()
Chặn cho đến khi thiết bị hiển thị thông qua tính năng khởi động nhanh. Sử dụng thời gian chờ mặc định.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
WaitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
Chặn thiết bị trong quá trình "khôi phục adb" trạng thái (lưu ý rằng điều này khác với
IDeviceRecovery
).
Tham số | |
---|---|
waitTime |
long : thời gian tính bằng mili giây |
Giá trị trả về | |
---|---|
boolean |
true nếu thiết bị khởi động vào quá trình khôi phục trước khi hết thời gian khôi phục.
Nếu không thì false |
waitForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
Các quy tắc chặn để thiết bị nằm trong "phần tải không qua cửa hàng adb" trạng thái
Tham số | |
---|---|
waitTime |
long : thời gian tính bằng mili giây |
Giá trị trả về | |
---|---|
boolean |
true nếu thiết bị khởi động ở chế độ cài đặt không qua cửa hàng ứng dụng trước khi hết thời gian. Nếu không thì false
|
Chờ thiết bị không có sẵn
public abstract boolean waitForDeviceNotAvailable (long waitTime)
Các quy tắc chặn thiết bị không hoạt động, tức là bị thiếu trong adb
Tham số | |
---|---|
waitTime |
long : thời gian tính bằng mili giây |
Giá trị trả về | |
---|---|
boolean |
true nếu không dùng được thiết bị trước khi hết thời gian.
Nếu không thì false |
ChờChoThiết bịTrực tuyến
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
Lưu ý rằng thiết bị có thể không nhất thiết phải phản hồi với các lệnh sau khi hoàn tất. Sử dụng
Hãy waitForDeviceAvailable()
.
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
ChờChoThiết bịTrực tuyến
public abstract void waitForDeviceOnline (long waitTime)
Chặn cho đến khi thiết bị hiển thị qua adb.
Lưu ý rằng thiết bị có thể không nhất thiết phản hồi với các lệnh sau khi hoàn tất. Sử dụng
Hãy waitForDeviceAvailable()
.
Tham số | |
---|---|
waitTime |
long : thời gian tính bằng mili giây |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu kết nối với thiết bị bị mất và không thể đã khôi phục. |
WaitForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
Chờ thiết bị phản hồi với lệnh adb shell cơ bản.
Tham số | |
---|---|
waitTime |
long : thời gian 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. |