Thiết bị gốc
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
Phương thức triển khai mặc định của ITestDevice
Thiết bị Android không ở trong ngăn xếp đầy đủ.
Tóm tắt
Lớp lồng ghép | |
---|---|
class |
NativeDevice.AdbAction
Một |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Hằng số | |
---|---|
int |
INVALID_USER_ID
Giá trị được trả về cho mọi mã nhận dạng người dùng không hợp lệ/không tìm thấy: UserHandle đã xác định giá trị -10000 |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
số lần thử thực hiện lại lệnh mặc định |
Trường | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Hàm khởi tạo công khai | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Tạo |
Phương thức công khai | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Tối ưu hoá vi mô (khoảng 400 mili giây) bằng cách tìm nạp trước tất cả các đạo cụ chúng ta cần thay vì gọi 'adb getprop' cho từng chiến dịch. |
boolean
|
canSwitchToHeadlessSystemUser()
Trả về việc có cho phép chuyển sang người dùng HỆ THỐNG không có giao diện người dùng hay không. |
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. |
boolean
|
checkConnectivity()
Kiểm tra để đảm bảo rằng thiết bị có kết nối mạng. |
boolean
|
clearErrorDialogs()
Hãy thử loại bỏ mọi hộp thoại lỗi đang hiển thị trên giao diện người dùng của thiết bị. |
void
|
clearLastConnectedWifiNetwork()
Xoá mạng Wi-Fi kết nối gần đây nhất. |
void
|
clearLogcat()
Xoá mọi dữ liệu logcat đã tích luỹ. |
boolean
|
connectToWifiNetwork(
Kết nối với mạng Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Kết nối với mạng Wi-Fi. |
boolean
|
connectToWifiNetwork(
Kết nối với một mạng Wi-Fi.f |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Kết nối với mạng Wi-Fi. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Một biến thể của |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Một biến thể của |
int
|
createUser(String name, boolean guest, boolean ephemeral)
Tạo một người dùng bằng tên cụ thể và cờ được cung cấp |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Tạo một người dùng bằng tên cụ thể và cờ được cung cấp |
int
|
createUser(String name)
Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0. |
int
|
createUserNoThrow(String name)
Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0. |
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ị. |
void
|
deleteFile(String deviceFilePath)
Phương thức trợ giúp để xoá tệp hoặc thư mục trên thiết bị. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Xoá |
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 đó |
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à |
boolean
|
disableAdbRoot()
Tắt adb gốc. |
void
|
disableKeyguard()
Cố gắng tắt tính năng bảo vệ bàn phím. |
boolean
|
disableNetworkMonitor()
Tắt tính năng giám sát mạng trên thiết bị. |
boolean
|
disconnectFromWifi()
Ngắt kết nối khỏi mạng Wi-Fi. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
Phương thức trợ giúp để xác định xem một người dùng cụ thể có tồn tại tệp trên thiết bị hay không. |
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. |
File
|
dumpHeap(String process, String devicePath)
Thử kết xuất vùng nhớ khối xếp từ system_server. |
boolean
|
enableAdbRoot()
Bật thư mục gốc adb. |
boolean
|
enableNetworkMonitor()
Bật tính năng giám sát mạng trên thiết bị. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
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. |
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. |
String
|
executeAdbCommand(String... cmdArgs)
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. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
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. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
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. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
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. |
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. |
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 |
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. |
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. |
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. |
CommandResult
|
executeShellV2Command(String cmd)
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
|
executeShellV2Command(String cmd, 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
|
executeShellV2Command(String cmd, 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
|
executeShellV2Command(String cmd, 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. |
CommandResult
|
executeShellV2Command(String cmd, 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. |
CommandResult
|
executeShellV2Command(String cmd, 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. |
CommandResult
|
executeShellV2Command(String cmd, 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. |
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ị. |
|
getActiveApexes()
Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị. |
|
getAllSettings(String namespace)
Trả về cặp khoá-giá trị của không gian tên được yêu cầu. |
DeviceAllocationState
|
getAllocationState()
Trả về trạng thái phân bổ hiện tại của thiết bị |
String
|
getAndroidId(int userId)
Tìm và trả về android-id được liên kết với userId, null nếu không tìm thấy. |
|
getAndroidIds()
Tạo Bản đồ các mã nhận dạng Android tìm thấy khớp với mã nhận dạng người dùng. |
int
|
getApiLevel()
Lấy cấp độ API của thiết bị. |
PackageInfo
|
getAppPackageInfo(String packageName)
Tìm nạp thông tin về một gói đã cài đặt trên thiết bị. |
|
getAppPackageInfos()
Tìm nạp thông tin của các gói được cài đặt trên thiết bị. |
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. |
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. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Trả về giá trị boolean của thuộc tính đã cho. |
|
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. |
|
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. |
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. |
InputStreamSource
|
getBugreport()
Truy xuất báo cáo lỗi từ thiết bị. |
InputStreamSource
|
getBugreportz()
Truy xuất báo cáo lỗi từ thiết bị. |
String
|
getBuildAlias()
Truy xuất bí danh của bản dựng mà thiết bị hiện đang chạy. |
String
|
getBuildFlavor()
Truy xuất phiên bản bản dựng cho thiết bị. |
String
|
getBuildId()
Truy xuất bản dựng mà thiết bị đang chạy. |
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) |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Trả về một |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Trả về một |
String[]
|
getChildren(String path)
Phương pháp thay thế cho việc sử dụng |
AbstractConnection
|
getConnection()
Kết nối hiện tại được liên kết với thiết bị. |
ContentProviderHandler
|
getContentProvider(int userId)
Trả về |
DeviceFoldableState
|
getCurrentFoldableState()
Trả về trạng thái gập hiện tại của thiết bị hoặc rỗng nếu xảy ra một số vấn đề. |
int
|
getCurrentUser()
Trả về mã nhận dạng của người dùng hiện đang chạy. |
String
|
getDeviceClass()
Lấy lớp thiết bị. |
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. |
DeviceDescriptor
|
getDeviceDescriptor()
Trả lại một |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Trả lại một |
TestDeviceState
|
getDeviceState()
Xem trạng thái của thiết bị. |
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 |
InputStreamSource
|
getEmulatorOutput()
Nhận luồng stdout và stderr của trình mô phỏng |
Process
|
getEmulatorProcess()
Trả về |
final
File
|
getExecuteShellCommandLog()
Nhật ký chứa tất cả nhật ký |
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ị. |
String
|
getFastbootPath()
Trả về đường dẫn của tệp nhị phân khởi động nhanh đang được sử dụng. |
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. |
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. |
String
|
getFastbootSerialNumber()
Trả về số sê-ri của chế độ khởi động nhanh. |
String
|
getFastbootVariable(String variableName)
Truy xuất giá trị biến khởi động nhanh đã cho từ thiết bị. |
String
|
getFastbootVersion()
Trả về chuỗi phiên bản của tệp nhị phân khởi động nhanh đang được sử dụng. |
IFileEntry
|
getFileEntry(String path)
Truy xuất tham chiếu đến tệp từ xa trên thiết bị. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Trình trợ giúp không chính thức để nhận |
|
getFoldableStates()
Trả về danh sách trạng thái gập trên thiết bị. |
IDevice
|
getIDevice()
Trả về tham chiếu đến |
|
getInstalledPackageNames()
Tìm nạp tên gói ứng dụng có trên thiết bị. |
long
|
getIntProperty(String name, long defaultValue)
Trả về giá trị số nguyên của thuộc tính đã cho từ thiết bị. |
String
|
getIpAddress()
Lấy địa chỉ IP của thiết bị. |
KeyguardControllerState
|
getKeyguardState()
Trả về một đối tượng để nhận trạng thái hiện tại của tính năng bảo vệ bàn phím hoặc trả về giá trị rỗng nếu không được hỗ trợ. |
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 |
int
|
getLaunchApiLevel()
Lấy Cấp độ API đầu tiên của thiết bị. |
InputStreamSource
|
getLogcat()
Lấy một luồng tổng quan nhanh của dữ liệu logcat. |
InputStreamSource
|
getLogcat(int maxBytes)
Lấy luồng ảnh chụp nhanh của |
InputStreamSource
|
getLogcatDump()
Tải tệp kết xuất logcat hiện tại cho thiết bị. |
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. |
String
|
getMacAddress()
Trả về địa chỉ MAC của thiết bị, giá trị rỗng nếu không truy vấn được từ thiết bị. |
Integer
|
getMainUserId()
Trả về mã nhận dạng người dùng chính. |
|
getMainlineModuleInfo()
Lấy thông tin về các mô-đun đường dây chính đã cài đặt trên thiết bị. |
int
|
getMaxNumberOfRunningUsersSupported()
Nhận số lượng tối đa người dùng chạy đồng thời được hỗ trợ. |
int
|
getMaxNumberOfUsersSupported()
Nhận số lượng người dùng được hỗ trợ tối đa. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Trả về |
String
|
getMountPoint(String mountName)
Trả về một điểm gắn. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Trả về một |
|
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ị |
TestDeviceOptions
|
getOptions()
Tìm nạp các tuỳ chọn kiểm thử cho thiết bị. |
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ị. |
Integer
|
getPrimaryUserId()
Trả về mã nhận dạng người dùng chính. |
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 |
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. |
String
|
getProductType()
Phương thức thuận tiện để mua loại sản phẩm của thiết bị này. |
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. |
String
|
getProperty(String name)
Truy xuất giá trị thuộc tính đã cho từ thiết bị. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Tải chế độ khôi phục hiện tại được dùng cho thiết bị. |
InputStreamSource
|
getScreenshot(String format)
Chụp ảnh màn hình từ thiết bị. |
InputStreamSource
|
getScreenshot(long displayId)
Chụp ảnh màn hình từ thiết bị có mã hiển thị được cung cấp. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Chụp ảnh màn hình từ thiết bị. |
InputStreamSource
|
getScreenshot()
Chụp ảnh màn hình từ thiết bị. |
String
|
getSerialNumber()
Phương thức thuận tiện để lấy số sê-ri của thiết bị này. |
String
|
getSetting(int userId, String namespace, String key)
Trả về giá trị của chế độ cài đặt được yêu cầu. |
String
|
getSetting(String namespace, String key)
Xem |
String
|
getSimOperator()
Trả về nhà cung cấp dịch vụ thẻ SIM hoặc giá trị rỗng nếu không có hoặc nếu thiết bị không có sẵn. |
String
|
getSimState()
Trả về trạng thái thẻ SIM hoặc rỗng nếu không có hoặc thiết bị không hoạt động. |
|
getTombstones()
Tìm nạp và trả về danh sách tombstone trên các thiết bị. |
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ộ |
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ị. |
|
getUninstallablePackageNames()
Tìm nạp tên gói ứng dụng có thể gỡ cài đặt. |
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ị. |
int
|
getUserFlags(int userId)
Tìm và trả về cờ của một người dùng cụ thể. |
|
getUserInfos()
Tải Map of useId cho |
int
|
getUserSerialNumber(int userId)
Trả lại số sê-ri được liên kết với userId nếu có, -10000 trong mọi trường hợp khác. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Xử lý DeviceEvent đã cho. Xử lý DeviceEvent. Quá trình này có thể hoặc không thể chuyển thiết bị này sang một lượt phân bổ mới trạng thái. |
boolean
|
hasFeature(String feature)
Kiểm tra xem thiết bị có tính năng nào không. |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Cài đặt một gói Android trên thiết bị. |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Cài đặt một gói Android trên thiết bị. |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Cài đặt một gói Android trên thiết bị cho một người dùng cụ thể. |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Cài đặt một gói Android trên thiết bị cho một người dùng cụ thể. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
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 |
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 |
boolean
|
isDebugfsMounted()
Kiểm tra xem Debugfs đã được gắn kết hay chưa. |
boolean
|
isDeviceEncrypted()
Trả về nếu thiết bị được mã hoá. |
boolean
|
isDirectory(String path)
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. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Trả về nếu thiết bị hỗ trợ tính năng mã hoá. |
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. |
boolean
|
isFastbootEnabled()
Quay lại nếu thiết bị có tính năng khởi động nhanh. |
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. |
boolean
|
isHeadlessSystemUserMode()
Trả về việc thiết bị có sử dụng chế độ người dùng hệ thống không có giao diện người dùng hay không. |
boolean
|
isMainUserPermanentAdmin()
Trả về việc người dùng chính có phải là quản trị viên vĩnh viễn và không thể bị xoá hoặc hạ cấp xuống không phải quản trị viên. |
boolean
|
isMultiUserSupported()
Xác định xem có hỗ trợ nhiều người dùng hay không. |
boolean
|
isPackageInstalled(String packageName, String userId)
Truy vấn thiết bị để biết một tên gói cụ thể và mã nhận dạng người dùng được cung cấp để kiểm tra xem gói đó hiện đã cài đặt hoặc chưa được cài đặt cho người dùng đó. |
boolean
|
isPackageInstalled(String packageName)
Truy vấn thiết bị về một tên gói cụ thể để kiểm tra xem thiết bị đã được cài đặt hay chưa. |
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 |
boolean
|
isStateBootloaderOrFastbootd()
Trả về giá trị true nếu thiết bị đang ở |
boolean
|
isUserRunning(int userId)
Kiểm tra xem một người dùng cụ thể có đang chạy hay không. |
boolean
|
isUserSecondary(int userId)
Trả về việc người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của ứng dụng đó. |
boolean
|
isUserVisible(int userId)
Kiểm tra xem người dùng cụ thể có hiển thị hay không. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Kiểm tra xem người dùng cụ thể có xuất hiện trên màn hình cụ thể hay không. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Trả về xem thiết bị có cho phép người dùng bắt đầu xuất hiện ở chế độ nền trong |
boolean
|
isVisibleBackgroundUsersSupported()
Trả về xem thiết bị có cho phép người dùng bắt đầu xuất hiện ở chế độ nền hay không. |
boolean
|
isWifiEnabled()
Kiểm tra xem Wi-Fi đã được bật chưa. |
|
listDisplayIds()
Thu thập danh sách mã màn hình có sẵn trên thiết bị theo báo cáo của "dumpsys SurfaceFlinger". |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Lấy danh sách màn hình có thể dùng để |
|
listUsers()
Lấy danh sách người dùng trên thiết bị. |
boolean
|
logAnrs(ITestLogger logger)
Thu thập và ghi nhật ký lỗi ANR trên thiết bị. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Phương pháp trợ giúp để báo cáo lỗi và ghi báo cáo đó cho người báo cáo. |
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ị. |
void
|
mountDebugfs()
Gắn gỡ lỗi. |
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. |
void
|
postAdbRootAction()
Ghi đè nếu thiết bị cần thực hiện một số thao tác cụ thể sau adb gốc và trước lệnh thiết bị đã kết nối mạng trở lại. |
void
|
postAdbUnrootAction()
Ghi đè nếu thiết bị cần thực hiện một số thao tác cụ thể sau khi gỡ bỏ adb và trước thiết bị đã kết nối mạng trở lại. |
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. |
void
|
postInvocationTearDown(Throwable exception)
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. |
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. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Lấy nội dung thư mục từ thiết bị theo cách đệ quy. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Lấy nội dung thư mục từ thiết bị theo cách đệ quy. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Truy xuất tệp ra khỏi thiết bị. |
File
|
pullFile(String remoteFilePath, int userId)
Truy xuất tệp từ thiết bị, lưu trữ tệp đó trong |
File
|
pullFile(String remoteFilePath)
Truy xuất tệp từ thiết bị, lưu trữ tệp đó trong |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Truy xuất tệp ra khỏi thiết bị. |
String
|
pullFileContents(String remoteFilePath)
Truy xuất tệp ra khỏi thiết bị và trả về nội dung. |
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
|
boolean
|
pushDir(File localFileDir, 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. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Đẩy định kỳ các nội dung trong thư mục sang thiết bị. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Đẩy định kỳ các nội dung trong thư mục sang thiết bị. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Biến thể của |
boolean
|
pushFile(File localFile, String remoteFilePath)
Đẩy tệp vào thiết bị. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Đẩy tệp vào thiết bị. |
boolean
|
pushString(String contents, String remoteFilePath)
Đẩy tệp được tạo từ một chuỗi đến thiết bị |
void
|
reboot(String reason)
Khởi động lại thiết bị ở chế độ adb bằng |
void
|
reboot()
Khởi động lại thiết bị ở chế độ adb. |
void
|
rebootIntoBootloader()
Khởi động lại thiết bị ở chế độ trình tải khởi động. |
void
|
rebootIntoFastbootd()
Khởi động lại thiết bị ở chế độ khởi động nhanh. |
void
|
rebootIntoRecovery()
Khởi động lại thiết bị ở chế độ khôi phục adb. |
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 |
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 |
void
|
rebootUntilOnline()
Một giải pháp thay thế cho |
void
|
rebootUntilOnline(String reason)
Một giải pháp thay thế cho |
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ị. |
void
|
rebootUserspaceUntilOnline()
Một lựa chọn thay thế cho |
boolean
|
recoverDevice()
Cố gắng khôi phục khả năng kết nối của thiết bị. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Đăng ký một |
void
|
remountSystemReadOnly()
Đặt phân vùng hệ thống trên thiết bị ở chế độ chỉ có thể đọc. |
void
|
remountSystemWritable()
Đặt phân vùng hệ thống trên thiết bị ở chế độ có thể ghi. |
void
|
remountVendorReadOnly()
Đặt phân vùng nhà cung cấp trên thiết bị ở chế độ chỉ có thể đọc. |
void
|
remountVendorWritable()
Tạo phân vùng nhà cung cấp trên thiết bị có thể ghi. |
boolean
|
removeAdmin(String componentName, int userId)
Xoá quản trị viên thiết bị đã cho trong người dùng cụ thể và trả về |
void
|
removeOwners()
Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có một cách hiệu quả nhất có thể. |
boolean
|
removeUser(int userId)
Xoá một người dùng cụ thể khỏi thiết bị. |
void
|
resetContentProviderSetup()
Đặt lại cờ cho chế độ thiết lập trình cung cấp nội dung để kích hoạt lại cờ. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Phương thức thuận tiện để biểu diễn |
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ị. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Giống như |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Giống như |
void
|
setConfiguration(IConfiguration configuration)
Chèn |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
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 |
boolean
|
setDeviceOwner(String componentName, int userId)
Đặt một thành phần quản trị viên thiết bị làm chủ sở hữu thiết bị trong người dùng cụ thể. |
void
|
setDeviceState(TestDeviceState deviceState)
Cập nhật trạng thái của thiết bị. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
Đối với trình mô phỏng, hãy đặt |
void
|
setEmulatorProcess(Process p)
Đặt |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Đặt tuỳ chọn khởi động nhanh cho thiết bị. |
void
|
setFastbootPath(String fastbootPath)
Thiết lập đường dẫn đến tệp nhị phân khởi động nhanh sẽ được sử dụng. |
void
|
setIDevice(IDevice newDevice)
Cập nhật IDevice được liên kết với ITestDevice này. |
void
|
setLogStartDelay(int delay)
Đặt thời gian tính bằng mili giây để chờ trước khi bắt đầu thu thập logcat cho một thiết bị trực tuyến. |
void
|
setOptions(TestDeviceOptions options)
Đặt |
boolean
|
setProperty(String propKey, String propValue)
Đặt giá trị thuộc tính đã cho trên thiết bị. |
void
|
setRecovery(IDeviceRecovery recovery)
Đặt |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Đặt chế độ khôi phục hiện tại để sử dụng cho thiết bị. |
void
|
setSetting(String namespace, String key, String value)
Xem |
void
|
setSetting(int userId, String namespace, String key, String value)
Thêm giá trị cài đặt vào không gian tên của một người dùng cụ thể. |
void
|
setTestLogger(ITestLogger testLogger)
Chèn thực thể |
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ị. |
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ị. |
void
|
startLogcat()
Bắt đầu ghi lại đầu ra logcat từ thiết bị ở chế độ nền. |
boolean
|
startUser(int userId)
Bắt đầu một người dùng cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng. |
boolean
|
startUser(int userId, boolean waitFlag)
Bắt đầu một người dùng cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Bắt đầu một người dùng cụ thể ở chế độ nền, hiển thị trên màn hình đã cho (tức là cho phép người dùng đó để khởi chạy các hoạt động trong màn hình đó). |
void
|
stopEmulatorOutput()
Đóng và xoá dữ liệu đầu ra của trình mô phỏng. |
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. |
boolean
|
stopUser(int userId)
Dừng một người dùng cụ thể. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Dừng một người dùng cụ thể. |
String
|
switchToAdbTcp()
Chuyển thiết bị sang chế độ adb-over-tcp. |
boolean
|
switchToAdbUsb()
Chuyển thiết bị sang adb qua chế độ USB. |
boolean
|
switchUser(int userId)
Chuyển sang một userId khác có thời gian chờ mặc định. |
boolean
|
switchUser(int userId, long timeout)
Hãy chuyển sang một userId khác có thời gian chờ đã cung cấp làm thời hạn. |
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ị. |
Bugreport
|
takeBugreport()
Tạo báo cáo lỗi và trả về bên trong đối tượng |
String
|
uninstallPackage(String packageName)
Gỡ cài đặt một gói Android khỏi thiết bị. |
String
|
uninstallPackageForUser(String packageName, int userId)
Gỡ cài đặt một gói Android khỏi thiết bị của một người dùng cụ thể. |
boolean
|
unlockDevice()
Mở khoá thiết bị nếu thiết bị đang ở trạng thái đã mã hoá. |
void
|
unmountDebugfs()
Ngắt kết nối debugfs. |
boolean
|
waitForBootComplete(long timeOut)
Chặn cho đến khi cờ hoàn tất khởi động của thiết bị được đặt. |
boolean
|
waitForDeviceAvailable()
Chờ thiết bị phản hồi và sẵn sàng để kiểm thử. |
boolean
|
waitForDeviceAvailable(long waitTime)
Chờ thiết bị phản hồi và sẵn sàng để kiểm thử. |
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. |
void
|
waitForDeviceBootloader()
Chặn cho đến khi thiết bị hiển thị thông qua tính năng khởi động nhanh. |
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
|
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 |
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 |
void
|
waitForDeviceOnline()
Chặn cho đến khi thiết bị hiển thị qua adb. |
void
|
waitForDeviceOnline(long waitTime)
Chặn cho đến khi thiết bị hiển thị qua adb. |
boolean
|
waitForDeviceShell(long waitTime)
Chờ thiết bị phản hồi với lệnh adb shell cơ bản. |
Phương thức được bảo vệ | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Tạo lệnh hệ điều hành cho phiên và đối số lệnh adb shell nhất định |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Tạo |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Khởi động lại adb. |
void
|
ensureRuntimePermissionSupported()
phương thức trợ giúp để gửi trường hợp ngoại lệ nếu quyền khi bắt đầu chạy không được hỗ trợ |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Tải thực thể |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Tìm nạp một thuộc tính thiết bị từ bộ nhớ đệm ddmlib theo mặc định và quay lại phương thức "adb" shell getprop` hoặc "fastboot getvar" tuỳ thuộc vào việc thiết bị có đang ở chế độ Fastboot hay không. |
boolean
|
isInRebootCallback()
Trả về xem lệnh gọi lại khởi động lại hiện có đang được thực thi hay không. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Trả về |
void
|
notifyRebootEnded()
Thông báo cho tất cả |
void
|
notifyRebootStarted()
Thông báo cho tất cả |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Thực hiện một hành động trên thiết bị này. |
void
|
postAdbReboot()
Những thao tác bổ sung mà bạn có thể thực hiện sau khi khởi động lại. |
void
|
prePostBootSetup()
Cho phép từng loại thiết bị (AndroidNativeDevice, TestDevice) ghi đè phương thức này cho thiết lập khởi động bài đăng cụ thể. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Đặt thực thể Đồng hồ để sử dụng. |
void
|
setMicrodroidProcess(Process process)
Đánh dấu TestDevice là microdroid và đặt CID. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Thực thi một lệnh khởi động nhanh đơn giản với các biến môi trường và báo cáo trạng thái của . |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Thực thi một lệnh khởi động nhanh đơn giản và báo cáo trạng thái của lệnh đó. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Chờ để xem thiết bị không hoạt động (ngừng báo cáo với adb). |
Hằng số
Mã INVALID_USER_ID
public static final int INVALID_USER_ID
Giá trị được trả về cho mọi mã nhận dạng người dùng không hợp lệ/không tìm thấy: UserHandle đã xác định giá trị -10000
Giá trị không đổi: -10.000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Giá trị không đổi: 5.000 (0x0000000000001388)
MAX_RETRY_ Channel
protected static final int MAX_RETRY_ATTEMPTS
số lần thử thực hiện lại lệnh mặc định
Giá trị không đổi: 2 (0x00000002)
Trường
DEBUGFS_PATH
public static final String DEBUGFS_PATH
THẺ SD
protected static final String SD_CARD
ĐÃ_ĐƯỢC TRUY CẬP
protected static final String STORAGE_EMULATED
Hàm khởi tạo công khai
Thiết bị gốc
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Tạo TestDevice
.
Tham số | |
---|---|
device |
IDevice : IDevice được liên kết |
stateMonitor |
IDeviceStateMonitor : cơ chế IDeviceStateMonitor để sử dụng |
allocationMonitor |
IDeviceMonitor : IDeviceMonitor để thông báo về những thay đổi ở trạng thái phân bổ.
Có thể có giá trị rỗng |
Phương thức công khai
lôTìm nạp trướcKhởi độngBuildProps
public void batchPrefetchStartupBuildProps ()
Tối ưu hoá vi mô (khoảng 400 mili giây) bằng cách tìm nạp trước tất cả các đạo cụ chúng ta cần thay vì gọi 'adb getprop' cho từng chiến dịch. Ví dụ: việc tìm nạp tất cả tài sản diễn ra nhanh như khi tìm nạp một tài sản. Tất cả các lệnh gọi như device.getApilevel(), checkApiLevelAgainstNextRelease và getBuildAlias Tìm hiểu sâu về `adb getprop`. Chúng tôi tìm nạp các mã này bằng một lệnh gọi và gọi NativeDevice.setProperty. Ngay cả khi chúng ta không thực hiện việc này, NativeDevice sẽ tự gọi setProperty và lưu kết quả vào bộ nhớ đệm các cuộc gọi trong tương lai. Chúng tôi chỉ thực hiện việc này sớm hơn một chút. Nếu thiết bị đang trong quá trình khôi phục hoặc có những lỗi khác khi tìm nạp đạo cụ, chúng ta sẽ bỏ qua chúng.
Người dùng canSwitchTo HeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Trả về việc có cho phép chuyển sang người dùng HỆ THỐNG không có giao diện người dùng hay không.
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
checkApilevelAgainstNextRelease
public 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 | |
---|---|
DeviceNotAvailableException |
kiểm tra kết nối
public boolean checkConnectivity ()
Kiểm tra để đảm bảo rằng thiết bị có kết nối mạng.
Giá trị trả về | |
---|---|
boolean |
true nếu thiết bị có kết nối mạng đang hoạt động,
false quá mức. |
Gửi | |
---|---|
DeviceNotAvailableException |
clearErrorDialogs
public boolean clearErrorDialogs ()
Hãy thử loại bỏ mọi hộp thoại lỗi đang hiển thị trên giao diện người dùng của thiết bị.
Giá trị trả về | |
---|---|
boolean |
true nếu không có hộp thoại nào hoặc các hộp thoại đã được xoá thành công.
false . |
Gửi | |
---|---|
DeviceNotAvailableException |
clearLastKết nốiWifiNetwork
public void clearLastConnectedWifiNetwork ()
Xoá mạng Wi-Fi kết nối gần đây nhất. Lệnh gọi này sẽ được gọi khi bắt đầu một lệnh gọi mới để tránh kết nối với mạng Wi-Fi được dùng trong thử nghiệm trước đó sau khi thiết bị khởi động lại.
xoáLogcat
public 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.).
kết nối vớiMạng Wifi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Kết nối với mạng Wi-Fi.
Bật Wi-Fi và chặn cho đến khi kết nối thành công với một trong các Wi-Fi
mạng được cung cấp trong bản đồ wifiSsidToPsk. Sau khi kết nối, thực thể máy ảo sẽ cố gắng
khôi phục kết nối sau mỗi lần khởi động lại cho đến ITestDevice#disconnectFromWifi()
hoặc
ITestDevice#clearLastConnectedWifiNetwork()
sẽ được gọi.
Tham số | |
---|---|
wifiSsidToPsk |
: Bản đồ các SSID của Wi-Fi đến mật khẩu. |
scanSsid |
boolean : xem có quét tìm SSID ẩn cho mạng này hay không. |
Giá trị trả về | |
---|---|
boolean |
true nếu đã kết nối thành công với mạng Wi-Fi. false
nếu không |
Gửi | |
---|---|
DeviceNotAvailableException |
kết nối vớiMạng Wifi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Kết nối với mạng Wi-Fi.
Bật Wi-Fi và chặn cho đến khi kết nối thành công với mạng Wi-Fi được chỉ định.
Sau khi tạo kết nối, thực thể máy ảo này sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại
cho đến ITestDevice#disconnectFromWifi()
hoặc
ITestDevice#clearLastConnectedWifiNetwork()
sẽ được gọi.
Tham số | |
---|---|
wifiSsid |
String : ssid Wi-Fi cần kết nối |
wifiPsk |
String : Cụm mật khẩu PSK hoặc rỗng nếu không được mã hoá |
Giá trị trả về | |
---|---|
boolean |
true nếu đã kết nối thành công với mạng Wi-Fi. false
nếu không |
Gửi | |
---|---|
DeviceNotAvailableException |
kết nối vớiMạng Wifi
public boolean connectToWifiNetwork (wifiSsidToPsk)
Kết nối với mạng Wi-Fi.
Bật Wi-Fi và chặn cho đến khi kết nối thành công với một trong các Wi-Fi
mạng được cung cấp trong bản đồ wifiSsidToPsk. Sau khi kết nối, thực thể máy ảo sẽ cố gắng
khôi phục kết nối sau mỗi lần khởi động lại cho đến ITestDevice#disconnectFromWifi()
hoặc
ITestDevice#clearLastConnectedWifiNetwork()
sẽ được gọi.f
Tham số | |
---|---|
wifiSsidToPsk |
: Bản đồ các SSID của Wi-Fi đến mật khẩu. |
Giá trị trả về | |
---|---|
boolean |
true nếu đã kết nối thành công với mạng Wi-Fi. false
nếu không |
Gửi | |
---|---|
DeviceNotAvailableException |
kết nối vớiMạng Wifi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Kết nối với mạng Wi-Fi.
Bật Wi-Fi và chặn cho đến khi kết nối thành công với mạng Wi-Fi được chỉ định.
Sau khi tạo kết nối, thực thể máy ảo này sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại
cho đến ITestDevice#disconnectFromWifi()
hoặc
ITestDevice#clearLastConnectedWifiNetwork()
sẽ được gọi.
Tham số | |
---|---|
wifiSsid |
String : ssid Wi-Fi cần kết nối |
wifiPsk |
String : Cụm mật khẩu PSK hoặc rỗng nếu không được mã hoá |
scanSsid |
boolean : xem có quét tìm SSID ẩn cho mạng này hay không. |
Giá trị trả về | |
---|---|
boolean |
true nếu đã kết nối thành công với mạng Wi-Fi. false
nếu không |
Gửi | |
---|---|
DeviceNotAvailableException |
kết nối vớiWi-FiMạng nếu cần
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Một biến thể của connectToWifiNetwork(String, String)
chỉ kết nối nếu thiết bị
hiện không có kết nối mạng.
Tham số | |
---|---|
scanSsid |
boolean : có quét tìm SSID ẩn cho mạng này hay không |
Giá trị trả về | |
---|---|
boolean |
true nếu đã kết nối thành công với mạng Wi-Fi. false
nếu không |
Gửi | |
---|---|
DeviceNotAvailableException |
kết nối vớiWi-FiMạng nếu cần
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Một biến thể của connectToWifiNetwork(String, String)
chỉ kết nối nếu thiết bị
hiện không có kết nối mạng.
Giá trị trả về | |
---|---|
boolean |
true nếu đã kết nối thành công với mạng Wi-Fi. false
nếu không |
Gửi | |
---|---|
DeviceNotAvailableException |
Tạo người dùng
public int createUser (String name, boolean guest, boolean ephemeral)
Tạo một người dùng bằng tên cụ thể và cờ được cung cấp
Tham số | |
---|---|
name |
String : số người dùng được tạo trên thiết bị |
guest |
boolean : bật cờ người dùng – khách trong quá trình tạo |
ephemeral |
boolean : bật cờ người dùng -- tạm thời trong quá trình tạo |
Giá trị trả về | |
---|---|
int |
mã nhận dạng của người dùng đã tạo |
Gửi | |
---|---|
DeviceNotAvailableException |
Tạo người dùng
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Tạo một người dùng bằng tên cụ thể và cờ được cung cấp
Tham số | |
---|---|
name |
String : số người dùng được tạo trên thiết bị |
guest |
boolean : bật cờ người dùng – khách trong quá trình tạo |
ephemeral |
boolean : bật cờ người dùng -- tạm thời trong quá trình tạo |
forTesting |
boolean : bật cờ kiểm thử để kiểm thử trong quá trình tạo |
Giá trị trả về | |
---|---|
int |
mã nhận dạng của người dùng đã tạo |
Gửi | |
---|---|
DeviceNotAvailableException |
Tạo người dùng
public int createUser (String name)
Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0.
Tham số | |
---|---|
name |
String : số người dùng được tạo trên thiết bị |
Giá trị trả về | |
---|---|
int |
số nguyên cho mã nhận dạng người dùng đã tạo |
Gửi | |
---|---|
DeviceNotAvailableException |
createNgười dùngKhôngThrow
public int createUserNoThrow (String name)
Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0.
Tham số | |
---|---|
name |
String : số người dùng được tạo trên thiết bị |
Giá trị trả về | |
---|---|
int |
số nguyên cho mã nhận dạng người dùng được tạo hoặc -1 nếu bị lỗi. |
Gửi | |
---|---|
DeviceNotAvailableException |
xoá tệp
public 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 | |
---|---|
DeviceNotAvailableException |
xoá tệp
public 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 | |
---|---|
DeviceNotAvailableException |
huỷ đăng kýDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Xoá IDeviceActionReceiver
đã đăng ký.
Tham số | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Một IDeviceActionReceiver sẽ bị xoá. |
thiết bị đã khởi động lại mềm
public 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 | |
---|---|
DeviceNotAvailableException |
thiết bịSoftRestartedSince
public 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 | |
---|---|
DeviceNotAvailableException |
vô hiệu hoáAdbRoot
public 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 |
tắt tính năng Bảo vệ bàn phím
public void disableKeyguard ()
Cố gắng tắt tính năng bảo vệ bàn phím.
Trước tiên, hãy đợi việc truyền dữ liệu đầu vào sẵn sàng, điều này xảy ra cùng khoảng thời gian khi thiết bị báo cáo BOOT_complete, có vẻ như không đồng bộ, vì khung hiện tại Việc triển khai không thường xuyên có tình huống tương tranh. Sau đó, lệnh được gửi để đóng tính năng bảo vệ bàn phím (hoạt động chỉ đối với những miền không an toàn)
Gửi | |
---|---|
DeviceNotAvailableException |
vô hiệu hoáNetworkMonitor
public boolean disableNetworkMonitor ()
Tắt tính năng giám sát mạng trên thiết bị.
Giá trị trả về | |
---|---|
boolean |
true nếu bạn tắt tính năng giám sát thành công. false
nếu không thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
ngắt kết nối TừWifi
public boolean disconnectFromWifi ()
Ngắt kết nối khỏi mạng Wi-Fi.
Xóa tất cả mạng khỏi danh sách mạng đã biết và tắt Wi-Fi.
Giá trị trả về | |
---|---|
boolean |
true nếu đã ngắt kết nối thành công khỏi mạng Wi-Fi. false
nếu ngắt kết nối không thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
không có tệpExist
public boolean doesFileExist (String deviceFilePath, int userId)
Phương thức trợ giúp để xác định xem một người dùng cụ thể có tồn tại 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 |
userId |
int : Mã nhận dạng người dùng để kiểm tra sự tồn tại của tệp |
Giá trị trả về | |
---|---|
boolean |
true nếu tệp tồn tại, nếu không thì false . |
Gửi | |
---|---|
DeviceNotAvailableException |
không có tệpExist
public 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 |
Tệp báo lỗi
public File dumpHeap (String process, String devicePath)
Thử kết xuất vùng nhớ khối xếp từ system_server. Người gọi có trách nhiệm dọn dẹp tệp kết xuất.
Tham số | |
---|---|
process |
String : tên của quy trình thiết bị để tệp kết xuất. |
devicePath |
String : đường dẫn trên thiết bị nơi để tệp kết xuất. Đây phải là địa điểm mà
quyền cho phép cài đặt đó. |
Giá trị trả về | |
---|---|
File |
ERROR(/File) chứa báo cáo. Giá trị rỗng nếu có lỗi xảy ra. |
Gửi | |
---|---|
DeviceNotAvailableException |
enableAdbRoot
public 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 |
bậtNetworkMonitor
public boolean enableNetworkMonitor ()
Bật tính năng giám sát mạng trên thiết bị.
Giá trị trả về | |
---|---|
boolean |
true nếu tính năng giám sát được bật thành công. false
nếu không thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
Thực thiAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
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ờ |
cmdArgs |
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 |
Thực thiAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
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 |
cmdArgs |
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 |
Thực thiAdbCommand
public String executeAdbCommand (String... cmdArgs)
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ố | |
---|---|
cmdArgs |
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 |
Thực thi FastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
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ố | |
---|---|
cmdArgs |
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 |
Thực thi FastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
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 |
cmdArgs |
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 |
Thực thiLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
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ố | |
---|---|
cmdArgs |
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 |
Thực thiLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
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 |
cmdArgs |
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 |
Thực thiShellCommand
public 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 |
Thực thiShellCommand
public 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 |
Thực thiShellCommand
public 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 |
Thực thiShellCommand
public 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 |
Thực thiShellV2Command
public CommandResult executeShellV2Command (String cmd)
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ố | |
---|---|
cmd |
String : Lệnh cần chạy. |
Giá trị trả về | |
---|---|
CommandResult |
Kết quả bằng CommandResult . |
Gửi | |
---|---|
DeviceNotAvailableException |
Thực thiShellV2Command
public CommandResult executeShellV2Command (String cmd, 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ố | |
---|---|
cmd |
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 |
Thực thiShellV2Command
public CommandResult executeShellV2Command (String cmd, 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ố | |
---|---|
cmd |
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 |
Thực thiShellV2Command
public CommandResult executeShellV2Command (String cmd, 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ố | |
---|---|
cmd |
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 |
Thực thiShellV2Command
public CommandResult executeShellV2Command (String cmd, 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ố | |
---|---|
cmd |
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 |
Thực thiShellV2Command
public CommandResult executeShellV2Command (String cmd, 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ố | |
---|---|
cmd |
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 |
Thực thiShellV2Command
public CommandResult executeShellV2Command (String cmd, 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ố | |
---|---|
cmd |
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 |
khởi động nhanhWipePartition
public 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 |
getActiveApexes
publicgetActiveApexes ()
Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị.
Giá trị trả về | |
---|---|
|
ERROR(/Set) /ApexInfo hiện đã được kích hoạt trên thiết bị |
Gửi | |
---|---|
DeviceNotAvailableException |
getTất cả chế độ cài đặt
publicgetAllSettings (String namespace)
Trả về cặp khoá-giá trị của không gian tên được yêu cầu.
Tham số | |
---|---|
namespace |
String : phải là một trong các giá trị {"system", "secure", "global"} |
Giá trị trả về | |
---|---|
|
sơ đồ các cặp khoá-giá trị. Rỗng nếu không gian tên không được hỗ trợ. |
Gửi | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Trả về trạng thái phân bổ hiện tại của thiết bị
Giá trị trả về | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
Tìm và trả về android-id được liên kết với userId, null nếu không tìm thấy.
Tham số | |
---|---|
userId |
int |
Giá trị trả về | |
---|---|
String |
Gửi | |
---|---|
DeviceNotAvailableException |
getAndroidIds
publicgetAndroidIds ()
Tạo Bản đồ các mã nhận dạng Android tìm thấy khớp với mã nhận dạng người dùng. Không có bảo hiểm mà mỗi người dùng mã nhận dạng sẽ tìm thấy mã nhận dạng Android được liên kết trong hàm này, vì vậy, một số mã nhận dạng người dùng có thể khớp với giá trị rỗng.
Giá trị trả về | |
---|---|
|
Bản đồ mã nhận dạng Android tìm thấy mã nhận dạng người dùng trùng khớp. |
Gửi | |
---|---|
DeviceNotAvailableException |
lấy cấp độ API
public 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 | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Tìm nạp thông tin về một gói đã cài đặt trên thiết bị.
Tham số | |
---|---|
packageName |
String |
Giá trị trả về | |
---|---|
PackageInfo |
PackageInfo hoặc null nếu không thể lấy thông tin |
Gửi | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
Tìm nạp thông tin của các gói đã cài đặt trên thiết bị.
Giá trị trả về | |
---|---|
|
Đã cài đặt ERROR(/List) /PackageInfo trên thiết bị. |
Gửi | |
---|---|
DeviceNotAvailableException |
nhận phiên bản băng tần cơ sở
public 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 |
getBattery
public 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 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
publicgetBootHistory ()
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ừ
publicgetBootHistorySince (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 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 |
nhận báo cáo lỗi
public InputStreamSource getBugreport ()
Truy xuất báo cáo lỗi từ thiết bị.
Việc triển khai tính năng này đảm bảo sẽ tiếp tục hoạt động trên thiết bị không có thẻ sd (hoặc khi thẻ sd chưa được gắn).
Giá trị trả về | |
---|---|
InputStreamSource |
InputStreamSource sẽ tạo nội dung báo cáo lỗi theo yêu cầu. Trong
trường hợp không thành công, InputStreamSource sẽ tạo ra một ERROR(/InputStream) trống. |
lỗi báo cáo lỗi
public InputStreamSource getBugreportz ()
Truy xuất báo cáo lỗi từ thiết bị. Báo cáo lỗi ở định dạng zip chứa báo cáo lỗi chính và các tệp nhật ký khác hữu ích cho việc gỡ lỗi.
Chỉ hỗ trợ cho "phiên bản adb" > 1.0.36
Giá trị trả về | |
---|---|
InputStreamSource |
InputStreamSource của tệp zip chứa báo cáo lỗi, trả về giá trị rỗng trong
trường hợp không thành công. |
getBuildAlias
public 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 | |
---|---|
DeviceNotAvailableException |
tạo hương vị
public 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 | |
---|---|
DeviceNotAvailableException |
getBuildId
public 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 | |
---|---|
DeviceNotAvailableException |
getBuildKýKeys
public 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 | |
---|---|
DeviceNotAvailableException |
getBộ nhớ đệm thiết bị mô tả
public 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 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 String[] getChildren (String path)
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ố | |
---|---|
path |
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 | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
Kết nối hiện tại được liên kết với thiết bị.
Giá trị trả về | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Trả về ContentProviderHandler
hoặc giá trị rỗng nếu không có.
Trình cung cấp nội dung có thể được sử dụng lại nếu được tạo trước đó bằng cùng một userId
.
Tham số | |
---|---|
userId |
int : mã nhận dạng người dùng để khởi tạo nhà cung cấp nội dung. |
Giá trị trả về | |
---|---|
ContentProviderHandler |
Gửi | |
---|---|
DeviceNotAvailableException |
Nhận trạng thái có thể gập lại hiện tại
public DeviceFoldableState getCurrentFoldableState ()
Trả về trạng thái gập hiện tại của thiết bị hoặc rỗng nếu xảy ra một số vấn đề.
Giá trị trả về | |
---|---|
DeviceFoldableState |
Gửi | |
---|---|
DeviceNotAvailableException |
nhận người dùng hiện tại
public int getCurrentUser ()
Trả về mã nhận dạng của người dùng hiện đang chạy. Trong trường hợp lỗi, hãy trả về -10000.
Giá trị trả về | |
---|---|
int |
Gửi | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Lấy lớp thiết bị.
Giá trị trả về | |
---|---|
String |
lớp thiết bị String . |
nhận ngày thiết bị
public 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 | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public 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 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 TestDeviceState getDeviceState ()
Xem trạng thái của thiết bị.
Giá trị trả về | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public 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 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 |
getEmulatorProcess
public Process getEmulatorProcess ()
Trả về Process
tương ứng với trình mô phỏng này.
Giá trị trả về | |
---|---|
Process |
Process hoặc null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
Nhật ký chứa tất cả nhật ký executeShellCommand(String)
.
Giá trị trả về | |
---|---|
File |
getExternalStoreFreeSpace
public 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 |
getFastbootPath
public String getFastbootPath ()
Trả về đường dẫn của tệp nhị phân khởi động nhanh đang được sử dụng.
Vẫn yêu cầu isFastbootEnabled()
là true để bật các chức năng khởi động nhanh.
Giá trị trả về | |
---|---|
String |
loại chiến dịch khởi động nhanh
public 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 |
phương thức getFastbootProductVariant
public 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 |
getFastbootSerialNumber
public 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 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 | |
---|---|
DeviceNotAvailableException |
lấy phiên bản khởi động nhanh
public String getFastbootVersion ()
Trả về chuỗi phiên bản của tệp nhị phân khởi động nhanh đang được sử dụng. Hoặc rỗng nếu có sự cố không chính xác.
Giá trị trả về | |
---|---|
String |
getFileEntry
public 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 | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Trình trợ giúp không chính thức để nhận FileEntry
từ một đường dẫn không phải gốc. FIXME: Tái cấu trúc phần tử
FileEntry của hệ thống để có sẵn từ bất kỳ đường dẫn nào. (kể cả không phải thư mục gốc).
Tham số | |
---|---|
entry |
FileListingService.FileEntry : FileEntry không nhất thiết phải là gốc như Ddmlib yêu cầu. |
Giá trị trả về | |
---|---|
IFileEntry |
FileEntryWrapper đại diện cho FileEntry. |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
có thể gập lạiStates
publicgetFoldableStates ()
Trả về danh sách trạng thái gập trên thiết bị. Có thể lấy được bằng lệnh "cmd device_state" trạng thái in".
Giá trị trả về | |
---|---|
|
Gửi | |
---|---|
DeviceNotAvailableException |
getIDevice
public 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 |
getInstallPackageNames
publicgetInstalledPackageNames ()
Tìm nạp tên gói ứng dụng có trên thiết bị.
Giá trị trả về | |
---|---|
|
ERROR(/Set) /String tên gói hiện được cài đặt trên thiết bị. |
Gửi | |
---|---|
DeviceNotAvailableException |
getIntProperty
public 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 |
getIpAddress
public String getIpAddress ()
Lấy địa chỉ IP của thiết bị.
Giá trị trả về | |
---|---|
String |
địa chỉ IP của thiết bị hoặc null nếu thiết bị không có địa chỉ IP |
Gửi | |
---|---|
DeviceNotAvailableException |
nhận trạng thái bảo vệ phím
public KeyguardControllerState getKeyguardState ()
Trả về một đối tượng để nhận trạng thái hiện tại của tính năng bảo vệ bàn phím hoặc trả về giá trị rỗng nếu không được hỗ trợ.
Giá trị trả về | |
---|---|
KeyguardControllerState |
KeyguardControllerState chứa thông tin tổng quan nhanh về trạng thái của tính năng khoá bàn phím
và trả về giá trị Null nếu truy vấn Bàn phím không được hỗ trợ. |
Gửi | |
---|---|
DeviceNotAvailableException |
getLastIntentRestartTimeMillis
public 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 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 | |
---|---|
DeviceNotAvailableException |
lấy Logcat
public 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 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 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 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 |
getMacAddress
public String getMacAddress ()
Trả về địa chỉ MAC của thiết bị, giá trị rỗng nếu không truy vấn được từ thiết bị.
Giá trị trả về | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
Trả về mã nhận dạng người dùng chính.
Giá trị trả về | |
---|---|
Integer |
userId của người dùng chính nếu có và rỗng nếu không có người dùng chính. |
Gửi | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Lấy thông tin về các mô-đun đường dây chính đã cài đặt trên thiết bị.
Giá trị trả về | |
---|---|
|
ERROR(/Set) /String mô-đun đường dây chính hiện đã được cài đặt trên thiết bị. |
Gửi | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningNgười dùng được hỗ trợ
public int getMaxNumberOfRunningUsersSupported ()
Nhận số lượng tối đa người dùng chạy đồng thời được hỗ trợ. Giá trị mặc định là: 0
Giá trị trả về | |
---|---|
int |
một số nguyên cho biết số người dùng chạy đồng thời |
Gửi | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
Nhận số lượng người dùng được hỗ trợ tối đa. Giá trị mặc định là: 0
Giá trị trả về | |
---|---|
int |
số nguyên cho biết số lượng người dùng được hỗ trợ |
Gửi | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Giá trị trả về | |
---|---|
Process |
Trả về Quy trình của máy ảo Microdroid. Nếu TestDevice không phải là Microdroid, hãy trả về rỗng. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Trả về IDeviceStateMonitor
được liên kết với thiết bị.
Giá trị trả về | |
---|---|
IDeviceStateMonitor |
getMountPoint
public 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 |
getMountPointInfo
public 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 |
getMountPointInfo
publicgetMountPointInfo ()
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 |
getOptions
public TestDeviceOptions getOptions ()
Tìm nạp các tuỳ chọn kiểm thử cho thiết bị.
Giá trị trả về | |
---|---|
TestDeviceOptions |
TestDeviceOptions liên quan đến thiết bị đang được kiểm thử. |
getPartitionFreeSpace
public 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 |
getPrimaryUserId
public Integer getPrimaryUserId ()
Trả về mã nhận dạng người dùng chính.
Giá trị trả về | |
---|---|
Integer |
userId của người dùng chính nếu có và rỗng nếu không có người dùng chính. |
Gửi | |
---|---|
DeviceNotAvailableException |
getProcessByName
public 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 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 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 |
getProductVariant
public 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 |
lấy thuộc tính
public 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 | |
---|---|
DeviceNotAvailableException |
lấy lại Chế độ khôi phục
public 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ị. |
getẢnh chụp màn hình
public InputStreamSource getScreenshot (String format)
Chụp ảnh màn hình từ thiết bị. Nên dùng getScreenshot(format) thay vì phương thức mã hoá JPEG cho kích thước nhỏ hơn
Tham số | |
---|---|
format |
String : PNG, JPEG được hỗ trợ |
Giá trị trả về | |
---|---|
InputStreamSource |
InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu
ảnh chụp màn hình không thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
getẢnh chụp màn hình
public InputStreamSource getScreenshot (long displayId)
Chụp ảnh màn hình từ mã màn hình được cung cấp của thiết bị. Định dạng là PNG.
VIỆC CẦN LÀM: mở rộng các cách triển khai ở trên để hỗ trợ "định dạng" và "rescale"
Tham số | |
---|---|
displayId |
long : mã hiển thị của màn hình để lấy ảnh chụp màn hình. |
Giá trị trả về | |
---|---|
InputStreamSource |
InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu
chụp ảnh màn hình không thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
getẢnh chụp màn hình
public InputStreamSource getScreenshot (String format, boolean rescale)
Chụp ảnh màn hình từ thiết bị. Nên dùng getScreenshot(String)
với mã hoá JPEG cho kích thước nhỏ hơn.
Tham số | |
---|---|
format |
String : PNG, JPEG được hỗ trợ |
rescale |
boolean : nếu cần điều chỉnh ảnh chụp màn hình để giảm kích thước của hình ảnh thu được |
Giá trị trả về | |
---|---|
InputStreamSource |
InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu
chụp ảnh màn hình không thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
getẢnh chụp màn hình
public InputStreamSource getScreenshot ()
Chụp ảnh màn hình từ thiết bị.
Giá trị trả về | |
---|---|
InputStreamSource |
InputStreamSource của ảnh chụp màn hình ở định dạng png hoặc null nếu
ảnh chụp màn hình không thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public 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 |
getCài đặt
public String getSetting (int userId, String namespace, String key)
Trả về giá trị của chế độ cài đặt được yêu cầu. không gian tên phải là một trong: {"system", "secure", "global"}
Tham số | |
---|---|
userId |
int |
namespace |
String |
key |
String |
Giá trị trả về | |
---|---|
String |
giá trị được liên kết với không gian tên:khoá của một người dùng. Rỗng nếu không tìm thấy. |
Gửi | |
---|---|
DeviceNotAvailableException |
getCài đặt
public String getSetting (String namespace, String key)
Xem getSetting(int, String, String)
và được thực hiện trên người dùng hệ thống.
Tham số | |
---|---|
namespace |
String |
key |
String |
Giá trị trả về | |
---|---|
String |
Gửi | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
Trả về nhà cung cấp dịch vụ thẻ SIM hoặc giá trị rỗng nếu không có hoặc nếu thiết bị không có sẵn.
Giá trị trả về | |
---|---|
String |
getSimState
public String getSimState ()
Trả về trạng thái thẻ SIM hoặc rỗng nếu không có hoặc thiết bị không hoạt động.
Giá trị trả về | |
---|---|
String |
getTombstones
publicgetTombstones ()
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 |
getTotalMemory
public 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 |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
Tìm nạp tên gói ứng dụng có thể gỡ cài đặt. Điều này hiện được định nghĩa là các gói không phải hệ thống và các gói hệ thống đã cập nhật.
Giá trị trả về | |
---|---|
|
ERROR(/Set) tên gói String có thể gỡ cài đặt hiện được cài đặt trên
thiết bị. |
Gửi | |
---|---|
DeviceNotAvailableException |
getUseKhởi động nhanh
public 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. |
getUserGắn cờ
public int getUserFlags (int userId)
Tìm và trả về cờ của một người dùng cụ thể. Cờ được xác định trong "android.content.pm.UserInfo" trong Dự án nguồn mở Android.
Tham số | |
---|---|
userId |
int |
Giá trị trả về | |
---|---|
int |
các cờ được liên kết với userId được cung cấp nếu có, -10000 trong mọi trường hợp khác. |
Gửi | |
---|---|
DeviceNotAvailableException |
getUserInfo
publicgetUserInfos ()
Tải Map of useId cho UserInfo
trên thiết bị. Sẽ gửi DeviceRuntimeException
nếu đầu ra từ thiết bị không như mong đợi.
Giá trị trả về | |
---|---|
|
danh sách đối tượng UserInfo. |
Gửi | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Trả lại số sê-ri được liên kết với userId nếu có, -10000 trong mọi trường hợp khác.
Tham số | |
---|---|
userId |
int |
Giá trị trả về | |
---|---|
int |
Gửi | |
---|---|
DeviceNotAvailableException |
sự kiện xử lýAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Xử lý DeviceEvent đã cho. Có thể chuyển đổi thiết bị
sang trạng thái mới. Sẽ thông báo cho IDeviceMonitor
về mọi quá trình chuyển đổi trạng thái.
Xử lý DeviceEvent. Quá trình này có thể hoặc không thể chuyển thiết bị này sang một lượt phân bổ mới trạng thái.
Tham số | |
---|---|
event |
DeviceEvent |
Giá trị trả về | |
---|---|
IManagedTestDevice.DeviceEventResponse |
cóTính năng
public boolean hasFeature (String feature)
Kiểm tra xem thiết bị có tính năng nào không.
Tham số | |
---|---|
feature |
String : định dạng phải là "feature: |
Giá trị trả về | |
---|---|
boolean |
"True" nếu tìm thấy đối tượng, nếu không thì sẽ trả về. |
Gửi | |
---|---|
DeviceNotAvailableException |
lượt cài đặt
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Cài đặt một gói Android trên thiết bị.
Tham số | |
---|---|
packageFile |
File : tệp APK cần cài đặt |
reinstall |
boolean : true nếu thực hiện cài đặt lại |
extraArgs |
String : đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn
. |
Giá trị trả về | |
---|---|
String |
String có mã lỗi hoặc null nếu thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
lượt cài đặt
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Cài đặt một gói Android trên thiết bị.
Lưu ý: Chỉ các trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền khi bắt đầu chạy tại thời gian cài đặt sẽ gọi hàm này.
Tham số | |
---|---|
packageFile |
File : tệp APK cần cài đặt |
reinstall |
boolean : true nếu thực hiện cài đặt lại |
grantPermissions |
boolean : nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt |
extraArgs |
String : đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn
. |
Giá trị trả về | |
---|---|
String |
String có mã lỗi hoặc null nếu thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
lượt cài đặt cho người dùng gói cài đặt
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Cài đặt một gói Android trên thiết bị cho một người dùng cụ thể.
Tham số | |
---|---|
packageFile |
File : tệp APK cần cài đặt |
reinstall |
boolean : true nếu thực hiện cài đặt lại |
userId |
int : mã nhận dạng người dùng dạng số nguyên để cài đặt. |
extraArgs |
String : đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn
. |
Giá trị trả về | |
---|---|
String |
String có mã lỗi hoặc null nếu thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
lượt cài đặt cho người dùng gói cài đặt
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Cài đặt một gói Android trên thiết bị cho một người dùng cụ thể.
Lưu ý: Chỉ các trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền khi bắt đầu chạy tại thời gian cài đặt sẽ gọi hàm này.
Tham số | |
---|---|
packageFile |
File : tệp APK cần cài đặt |
reinstall |
boolean : true nếu thực hiện cài đặt lại |
grantPermissions |
boolean : nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt |
userId |
int : mã nhận dạng người dùng dạng số nguyên để cài đặt. |
extraArgs |
String : đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn
. |
Giá trị trả về | |
---|---|
String |
String có mã lỗi hoặc null nếu thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
Giá trị trả về | |
---|---|
boolean |
isAppEnumeration được hỗ trợ
public 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 | |
---|---|
DeviceNotAvailableException |
Hàm isBypassLowTargetSdkBlockSupported
public 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 | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public 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 | |
---|---|
DeviceNotAvailableException |
Đã mã hoá thiết bị
public 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 |
isDirectory
public boolean isDirectory (String path)
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ố | |
---|---|
path |
String |
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot
public boolean isEnableAdbRoot ()
Giá trị trả về | |
---|---|
boolean |
true nếu có phải bật adb gốc trên thiết bị |
Hỗ trợ Mã hoá
public 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 | |
---|---|
DeviceNotAvailableException |
có thể thực thi
public 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 | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled
public boolean isFastbootEnabled ()
Quay lại nếu thiết bị có tính năng khởi động nhanh.
Giá trị trả về | |
---|---|
boolean |
Không có giao diện người dùng
public 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 |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Trả về việc thiết bị có sử dụng chế độ người dùng hệ thống không có giao diện người dùng hay không.
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
isMainUserNgười Quản trị viên Vĩnh viễn
public boolean isMainUserPermanentAdmin ()
Trả về việc người dùng chính có phải là quản trị viên vĩnh viễn và không thể bị xoá hoặc hạ cấp xuống không phải quản trị viên.
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
được MultiUser hỗ trợ
public boolean isMultiUserSupported ()
Xác định xem có hỗ trợ nhiều người dùng hay không.
Giá trị trả về | |
---|---|
boolean |
true nếu nhiều người dùng được hỗ trợ, false nếu không hỗ trợ nhiều người dùng |
Gửi | |
---|---|
DeviceNotAvailableException |
Đã cài đặt gói isPackage
public boolean isPackageInstalled (String packageName, String userId)
Truy vấn thiết bị để biết một tên gói cụ thể và mã nhận dạng người dùng được cung cấp để kiểm tra xem gói đó hiện đã cài đặt hoặc chưa được cài đặt cho người dùng đó.
Tham số | |
---|---|
packageName |
String : gói mà chúng ta đang kiểm tra xem đã được cài đặt hay chưa. |
userId |
String : Mã nhận dạng người dùng mà chúng ta đang kiểm tra gói đã được cài đặt hay chưa. Nếu rỗng, người dùng chính
0 sẽ được sử dụng. |
Giá trị trả về | |
---|---|
boolean |
Đúng nếu gói được báo cáo là đã cài đặt. Nếu không thì là False. |
Gửi | |
---|---|
DeviceNotAvailableException |
Đã cài đặt gói isPackage
public boolean isPackageInstalled (String packageName)
Truy vấn thiết bị về một tên gói cụ thể để kiểm tra xem thiết bị đã được cài đặt hay chưa.
Tham số | |
---|---|
packageName |
String |
Giá trị trả về | |
---|---|
boolean |
Đúng nếu gói được báo cáo là đã cài đặt. Nếu không thì là False. |
Gửi | |
---|---|
DeviceNotAvailableException |
isRuntimePermission được hỗ trợ
public 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 | |
---|---|
DeviceNotAvailableException |
isStateKhởi động hoặc Khởi động nhanh
public boolean isStateBootloaderOrFastbootd ()
Trả về giá trị true nếu thiết bị đang ở TestDeviceState#FASTBOOT
hoặc TestDeviceState.FASTBOOTD
.
Giá trị trả về | |
---|---|
boolean |
đang chạy người dùng
public boolean isUserRunning (int userId)
Kiểm tra xem một người dùng cụ thể có đang chạy hay không.
Tham số | |
---|---|
userId |
int |
Giá trị trả về | |
---|---|
boolean |
"True" nếu người dùng đang chạy, "false" trong mọi trường hợp khác. |
Gửi | |
---|---|
DeviceNotAvailableException |
isUserPhụ
public boolean isUserSecondary (int userId)
Trả về việc người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của ứng dụng đó.
Tham số | |
---|---|
userId |
int |
Giá trị trả về | |
---|---|
boolean |
true nếu người dùng là phụ, false nếu người dùng không là phụ. |
Gửi | |
---|---|
DeviceNotAvailableException |
Hiển thị người dùng
public boolean isUserVisible (int userId)
Kiểm tra xem người dùng cụ thể có hiển thị hay không.
"Hiển thị" người dùng là một người dùng đang tương tác với "người dùng" và do đó có thể khởi chạy các hoạt động khởi chạy (thường là trong màn hình mặc định).
Tham số | |
---|---|
userId |
int |
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
hiển thị người dùng trên màn hình
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Kiểm tra xem người dùng cụ thể có xuất hiện trên màn hình cụ thể hay không.
"Hiển thị" người dùng là một người dùng đang tương tác với "người dùng" và do đó có thể khởi chạy các hoạt động trong màn hình đó.
Tham số | |
---|---|
userId |
int |
displayId |
int |
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
isHiển thịBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Trả về xem thiết bị có cho phép người dùng bắt đầu xuất hiện ở chế độ nền trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
hay không.
Nếu có, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean)
, truyền
một màn hình được listDisplayIdsForStartingVisibleBackgroundUsers()
trả về (
phải bao gồm ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Trả về xem thiết bị có cho phép người dùng bắt đầu xuất hiện ở chế độ nền hay không.
Nếu có, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean)
, truyền
màn hình được listDisplayIdsForStartingVisibleBackgroundUsers()
trả về.
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
isWifiEnabled
public boolean isWifiEnabled ()
Kiểm tra xem Wi-Fi đã được bật chưa.
Kiểm tra xem thiết bị đã bật Wi-Fi chưa. Hữu ích khi xác nhận trạng thái Wi-Fi trước các thử nghiệm không nên chạy với wifi, ví dụ: kiểm thử dữ liệu di động.
Giá trị trả về | |
---|---|
boolean |
true nếu Wi-Fi đã bật. false nếu đã tắt |
Gửi | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
Thu thập danh sách mã màn hình có sẵn trên thiết bị theo báo cáo của "dumpsys SurfaceFlinger".
Giá trị trả về | |
---|---|
|
Danh sách màn hình. Mặc định luôn trả về màn hình mặc định 0. |
Gửi | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForĐể Khởi độngHiển thịNgười dùngNền
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Lấy danh sách màn hình có thể dùng để start a user visible in the background
.
Giá trị trả về | |
---|---|
|
Gửi | |
---|---|
DeviceNotAvailableException |
Người dùng list
publiclistUsers ()
Lấy danh sách người dùng trên thiết bị. Sẽ gửi DeviceRuntimeException
nếu đầu ra
từ thiết bị không như mong đợi.
Giá trị trả về | |
---|---|
|
danh sách id người dùng. |
Gửi | |
---|---|
DeviceNotAvailableException |
logAnrs
public 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 |
báo cáo lỗi
public boolean logBugreport (String dataName, ITestLogger listener)
Phương pháp trợ giúp để báo cáo lỗi và ghi báo cáo đó cho người báo cáo.
Tham số | |
---|---|
dataName |
String : tên mà báo cáo lỗi sẽ được báo cáo. |
listener |
ITestLogger : ITestLogger để ghi nhật ký báo cáo lỗi. |
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. |
đăng nhập trên thiết bị
public 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(). |
không chặn khởi động lại
public 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 | |
---|---|
DeviceNotAvailableException |
PostAdbRootAction
public void postAdbRootAction ()
Ghi đè nếu thiết bị cần thực hiện một số thao tác cụ thể sau adb gốc và trước lệnh thiết bị đã kết nối mạng trở lại. Cách triển khai mặc định không bao gồm bất kỳ hành động bổ sung nào. Không đảm bảo sẽ bật adb gốc ở giai đoạn này.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PostAdbUnrootAction
public void postAdbUnrootAction ()
Ghi đè nếu thiết bị cần thực hiện một số thao tác cụ thể sau khi gỡ bỏ adb và trước thiết bị đã kết nối mạng trở lại. Phương thức triển khai mặc định không bao gồm bất kỳ hành động nào khác. Không đảm bảo rằng gốc adb sẽ bị tắt ở giai đoạn này.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Thiết lập postBoot
public 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 |
PostInvocationTearDown
public void postInvocationTearDown (Throwable exception)
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ố | |
---|---|
exception |
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 | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
kéoDir
public 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 |
kéoDir
public 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 |
tệp kéo
public 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 |
tệp kéo
public 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 |
tệp kéo
public 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 |
tệp kéo
public 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 |
putFileContents
public 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 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 |
pushDir
public boolean pushDir (File localFileDir, 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ố | |
---|---|
localFileDir |
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 |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Đẩy định kỳ các nội dung trong thư mục sang thiết bị.
Tham số | |
---|---|
localFileDir |
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 |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Đẩy định kỳ các nội dung trong thư mục sang thiết bị.
Tham số | |
---|---|
localFileDir |
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 |
tệp đẩy
public boolean pushFile (File localFile, String remoteFilePath, 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 |
remoteFilePath |
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 |
tệp đẩy
public boolean pushFile (File localFile, String remoteFilePath)
Đẩ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 |
remoteFilePath |
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 |
tệp đẩy
public boolean pushFile (File localFile, String remoteFilePath, 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 |
remoteFilePath |
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 |
chuỗi thông báo đẩy
public boolean pushString (String contents, String remoteFilePath)
Đẩ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 |
remoteFilePath |
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 |
khởi động lại
public 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.
Chặn cho đến khi thiết bị có sẵn.
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 |
khởi động lại
public 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 |
khởi động lạiIntoBootloader
public 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 |
khởi động lạiIntoFastbootd
public 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 |
khởi động lạiIntoRecovery
public 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 |
khởi động lạiIntoSideload
public void rebootIntoSideload ()
Khởi động lại thiết bị ở chế độ cài đặt không qua cửa hàng adb (lưu ý rằng đây là 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 |
khởi động lạiIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Khởi động lại thiết bị ở chế độ cài đặt không qua cửa hàng adb (lưu ý rằng đây là 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 |
khởi động lại cho đến khi trực tuyến
public 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 |
khởi động lại cho đến khi trực tuyến
public 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 |
khởi động lạikhông gian người dùng
public 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 |
khởi động lại
public 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 |
khôi phục thiết bị
public boolean recoverDevice ()
Cố gắng khôi phục khả năng kết nối của thiết bị.
Giá trị trả về | |
---|---|
boolean |
True nếu quá trình khôi phục đã cố gắng và thành công, trả về False nếu quá trình khôi phục bị bỏ qua |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu thiết bị không còn khả dụng |
subscriptionDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Đăng ký một IDeviceActionReceiver
cho thiết bị này.
Tất cả IDeviceActionReceiver
đã đăng ký sẽ được thông báo trước khi có hành động trên thiết bị
bắt đầu và sau khi hành động trên thiết bị kết thúc.
Tham số | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Một IDeviceActionReceiver sẽ được đăng ký. |
chỉ đọc lại hệ thống
public 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 | |
---|---|
DeviceNotAvailableException |
kết nối lạiHệ thống có thể ghi
public 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 | |
---|---|
DeviceNotAvailableException |
chỉ đọc lại nhà cung cấp
public 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 | |
---|---|
DeviceNotAvailableException |
gắn lại nhà cung cấp có thể ghi
public 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 | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Xoá quản trị viên thiết bị đã cho trong người dùng cụ thể và trả về true
nếu thành công, nếu không thì trả về false
.
Tham số | |
---|---|
componentName |
String : quản trị viên thiết bị sẽ bị loại bỏ. |
userId |
int : người dùng thuộc quyền quản trị viên thiết bị. |
Giá trị trả về | |
---|---|
boolean |
"True" nếu thành công, nếu không thì sẽ trả lời sai. |
Gửi | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có một cách hiệu quả nhất có thể.
Gửi | |
---|---|
DeviceNotAvailableException |
xoá người dùng
public boolean removeUser (int userId)
Xoá một người dùng cụ thể khỏi thiết bị.
Tham số | |
---|---|
userId |
int : người dùng cần xoá |
Giá trị trả về | |
---|---|
boolean |
true nếu chúng tôi xoá được người dùng thành công, nếu không thì sẽ trả về false. |
Gửi | |
---|---|
DeviceNotAvailableException |
thiết lập lạiContentProviderSetup
public void resetContentProviderSetup ()
Đặt lại cờ cho chế độ thiết lập trình cung cấp nội dung để kích hoạt lại cờ.
chạyInstrumentationTests
public 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 |
chạyInstrumentationTests
public 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 xong 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 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 |
runInstrumentationTestsAsUser
public 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 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 |
Cấu hình đặt
public void setConfiguration (IConfiguration configuration)
Chèn IConfiguration
đang sử dụng.
Tham số | |
---|---|
configuration |
IConfiguration |
Thông tin setConnectionAvd
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Tham số | |
---|---|
avdInfo |
GceAvdInfo |
ngày đặt
public 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 | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
Đặt một thành phần quản trị viên thiết bị làm chủ sở hữu thiết bị trong người dùng cụ thể.
Tham số | |
---|---|
componentName |
String : của quản trị viên thiết bị sẽ là chủ sở hữu thiết bị. |
userId |
int : người dùng sở hữu thiết bị. |
Giá trị trả về | |
---|---|
boolean |
"True" nếu thành công, nếu không thì sẽ trả lời sai. |
Gửi | |
---|---|
DeviceNotAvailableException |
Trạng thái thiết bị
public void setDeviceState (TestDeviceState deviceState)
Cập nhật trạng thái của thiết bị.
Tham số | |
---|---|
deviceState |
TestDeviceState : TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
Đối với trình mô phỏng, hãy đặt SizeLimitedOutputStream
thành nhật ký đầu ra
Tham số | |
---|---|
output |
SizeLimitedOutputStream : để ghi kết quả đầu ra |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Đặt Process
khi thiết bị này là trình mô phỏng.
Tham số | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Đặt tuỳ chọn khởi động nhanh cho thiết bị. Nên đặt khi thiết bị là đầu tiên đã phân bổ.
Tham số | |
---|---|
fastbootEnabled |
boolean : thiết bị có dùng được tính năng khởi động nhanh hay không |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Thiết lập đường dẫn đến tệp nhị phân khởi động nhanh sẽ được sử dụng.
Vẫn yêu cầu isFastbootEnabled()
là true để bật các chức năng khởi động nhanh.
Tham số | |
---|---|
fastbootPath |
String |
Thiết lập tôi
public void setIDevice (IDevice newDevice)
Cập nhật IDevice được liên kết với ITestDevice này.
Thiết bị IDevice mới phải tham chiếu cùng thiết bị thực như tham chiếu hiện tại. Phương thức này sẽ được gọi nếu DDMS đã phân bổ một IDevice mới
Tham số | |
---|---|
newDevice |
IDevice : IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Đặt thời gian tính bằng mili giây để chờ trước khi bắt đầu thu thập logcat cho một thiết bị trực tuyến.
Tham số | |
---|---|
delay |
int : độ trễ tính bằng mili giây |
setOptions
public void setOptions (TestDeviceOptions options)
Đặt TestDeviceOptions
cho thiết bị
Tham số | |
---|---|
options |
TestDeviceOptions |
setProperty
public 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 | |
---|---|
DeviceNotAvailableException |
Đặt lại
public 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 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. |
cài đặt
public void setSetting (String namespace, String key, String value)
Xem setSetting(int, String, String, String)
và được thực hiện trên người dùng hệ thống.
Tham số | |
---|---|
namespace |
String |
key |
String |
value |
String |
Gửi | |
---|---|
DeviceNotAvailableException |
cài đặt
public void setSetting (int userId, String namespace, String key, String value)
Thêm giá trị cài đặt vào không gian tên của một người dùng cụ thể. Một số chế độ cài đặt sẽ chỉ hoạt động sau khi khởi động lại. không gian tên phải là một trong: {"system", "secure", "global"}
Tham số | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
Gửi | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Chèn thực thể ITestLogger
Tham số | |
---|---|
testLogger |
ITestLogger |
setTrackingSerial
public 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 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. |
bắt đầuLogcat
public 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.
người dùng bắt đầu
public boolean startUser (int userId)
Bắt đầu một người dùng cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng. Nếu người dùng đã chạy ở chế độ nền, phương thức này là NOOP.
Tham số | |
---|---|
userId |
int : số người dùng bắt đầu ở chế độ nền |
Giá trị trả về | |
---|---|
boolean |
true nếu người dùng đã khởi động thành công trong nền. |
Gửi | |
---|---|
DeviceNotAvailableException |
người dùng bắt đầu
public boolean startUser (int userId, boolean waitFlag)
Bắt đầu một người dùng cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng. Nếu người dùng đã chạy ở chế độ nền, phương thức này là NOOP. Có thể cung cấp thêm cờ để chờ thao tác đó có hiệu lực.
Tham số | |
---|---|
userId |
int : số người dùng bắt đầu ở chế độ nền |
waitFlag |
boolean : sẽ thực hiện lệnh chờ cho đến khi người dùng khởi động và mở khoá. |
Giá trị trả về | |
---|---|
boolean |
true nếu người dùng đã khởi động thành công trong nền. |
Gửi | |
---|---|
DeviceNotAvailableException |
người dùng bắt đầu hiển thị
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Bắt đầu một người dùng cụ thể ở chế độ nền, hiển thị trên màn hình đã cho (tức là cho phép người dùng đó để khởi chạy các hoạt động trong màn hình đó).
LƯU Ý: lệnh này không kiểm tra xem người dùng có tồn tại, màn hình có sẵn hay không, device supports such feature
, v.v.
Tham số | |
---|---|
userId |
int : số người dùng bắt đầu ở chế độ nền |
displayId |
int : màn hình để bắt đầu hiển thị người dùng |
waitFlag |
boolean : sẽ thực hiện lệnh chờ cho đến khi người dùng khởi động và mở khoá. |
Giá trị trả về | |
---|---|
boolean |
Là giá trị true nếu người dùng đã khởi động thành công và hiển thị trong nền. |
Gửi | |
---|---|
DeviceNotAvailableException |
dừngTrình mô phỏngOutput
public void stopEmulatorOutput ()
Đóng và xoá dữ liệu đầu ra của trình mô phỏng.
dừngLogcat
public 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.
người dùng dừng
public boolean stopUser (int userId)
Dừng một người dùng cụ thể. Nếu người dùng đã dừng hoạt động, thì phương thức này là NOOP. Không thể dừng người dùng hiện tại và người dùng hệ thống.
Tham số | |
---|---|
userId |
int : số người dùng cần dừng. |
Giá trị trả về | |
---|---|
boolean |
true nếu người dùng đã được dừng thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
người dùng dừng
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Dừng một người dùng cụ thể. Có thể cung cấp thêm cờ để chờ thao tác có hiệu lực, và buộc chấm dứt người dùng. Không thể dừng người dùng hiện tại và người dùng hệ thống.
Tham số | |
---|---|
userId |
int : số người dùng cần dừng. |
waitFlag |
boolean : sẽ thực hiện lệnh chờ cho đến khi người dùng dừng lại. |
forceFlag |
boolean : sẽ buộc người dùng dừng. |
Giá trị trả về | |
---|---|
boolean |
true nếu người dùng đã được dừng thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
SwitchToAdbTcp
public 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 | |
---|---|
DeviceNotAvailableException |
SwitchToAdbUsb
public 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 | |
---|---|
DeviceNotAvailableException |
người dùng chuyển đổi
public boolean switchUser (int userId)
Chuyển sang một userId khác có thời gian chờ mặc định. switchUser(int, long)
.
Tham số | |
---|---|
userId |
int |
Giá trị trả về | |
---|---|
boolean |
Đúng nếu userId mới khớp với nhà cung cấp userId. Nếu không thì là False. |
Gửi | |
---|---|
DeviceNotAvailableException |
người dùng chuyển đổi
public boolean switchUser (int userId, long timeout)
Hãy chuyển sang một userId khác có thời gian chờ đã cung cấp làm thời hạn. Cố gắng tắt tính năng bảo vệ bàn phím sau khi thay đổi người dùng thành công.
Tham số | |
---|---|
userId |
int |
timeout |
long : để đợi trước khi trả về giá trị false cho người dùng nút chuyển không thành công. |
Giá trị trả về | |
---|---|
boolean |
Đúng nếu userId mới khớp với nhà cung cấp userId. Nếu không thì là False. |
Gửi | |
---|---|
DeviceNotAvailableException |
SyncFiles
public 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 |
báo cáo lỗi
public Bugreport takeBugreport ()
Tạo báo cáo lỗi và trả về bên trong đối tượng Bugreport
để xử lý. Trả về giá trị rỗng
trong trường hợp có vấn đề. Bạn cần dọn dẹp tệp được tham chiếu trong đối tượng Báo cáo lỗi thông qua Bugreport.close()
.
Giá trị trả về | |
---|---|
Bugreport |
gỡ cài đặt gói
public String uninstallPackage (String packageName)
Gỡ cài đặt một gói Android khỏi thiết bị.
Tham số | |
---|---|
packageName |
String : gói Android cần gỡ cài đặt |
Giá trị trả về | |
---|---|
String |
String có mã lỗi hoặc null nếu thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
Gỡ cài đặt cho người dùng
public String uninstallPackageForUser (String packageName, int userId)
Gỡ cài đặt một gói Android khỏi thiết bị của một người dùng cụ thể.
Tham số | |
---|---|
packageName |
String : gói Android cần gỡ cài đặt |
userId |
int : mã nhận dạng người dùng là số nguyên để gỡ cài đặt. |
Giá trị trả về | |
---|---|
String |
String có mã lỗi hoặc null nếu thành công. |
Gửi | |
---|---|
DeviceNotAvailableException |
mở khoá thiết bị
public 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 |
Chờ đợiKhởi động hoàn tất
public 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 | |
---|---|
DeviceNotAvailableException |
Chờ thiết bị có sẵn
public 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 |
Chờ thiết bị có sẵn
public 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 |
Chờ đợi thiết bị có sẵnInRecoverPath
public 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 |
bộ lọc khởi động thiết bị
public 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 |
WaitForDeviceInRecovery
public 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 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 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 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ản hồi với các lệnh sau khi hoàn tất. Sử dụng
Hãy waitForDeviceAvailable()
.
Gửi | |
---|---|
DeviceNotAvailableException |
ChờChoThiết bịTrực tuyến
public 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 |
WaitForDeviceShell
public 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. |
Phương thức được bảo vệ
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Tham số | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Tạo lệnh hệ điều hành cho phiên và đối số lệnh adb shell nhất định
Tham số | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
Giá trị trả về | |
---|---|
String[] |
CheckApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Tham số | |
---|---|
feature |
String |
strictMinLevel |
int |
createRestartDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Tạo RebootDeviceAction
để dùng khi thực hiện thao tác khởi động lại.
Tham số | |
---|---|
rebootMode |
NativeDevice.RebootMode : một chế độ của quá trình khởi động lại này. |
reason |
String : cho lần khởi động lại này. |
Giá trị trả về | |
---|---|
NativeDevice.RebootDeviceAction |
RebootDeviceAction được tạo. |
Khởi động lại doAdb
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Khởi động lại adb.
Tham số | |
---|---|
rebootMode |
NativeDevice.RebootMode : một chế độ của quá trình khởi động lại này. |
reason |
String : cho lần khởi động lại này. |
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
đảm bảoRuntimePermissionsupported
protected void ensureRuntimePermissionSupported ()
phương thức trợ giúp để gửi trường hợp ngoại lệ nếu quyền khi bắt đầu chạy không được hỗ trợ
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Giá trị trả về | |
---|---|
int |
getRunUtil
protected IRunUtil getRunUtil ()
Tải thực thể RunUtil
để sử dụng.
Giá trị trả về | |
---|---|
IRunUtil |
khởi tạoKết nối
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Tham số | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
Gửi | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
nội bộ,GetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Tìm nạp một thuộc tính thiết bị từ bộ nhớ đệm ddmlib theo mặc định và quay lại phương thức "adb" shell getprop` hoặc "fastboot getvar" tuỳ thuộc vào việc thiết bị có đang ở chế độ Fastboot hay không.
Tham số | |
---|---|
propName |
String : Tên của thuộc tính thiết bị do `adb shell getprop` trả về |
fastbootVar |
String : Tên của biến khởi động nhanh tương đương để truy vấn. nếu null ,
truy vấn khởi động nhanh sẽ không được thử |
description |
String : Nội dung mô tả đơn giản về biến. Chữ cái đầu tiên phải được viết hoa. |
Giá trị trả về | |
---|---|
String |
Một chuỗi, có thể là null hoặc trống, chứa giá trị của thuộc tính đã cho |
Gửi | |
---|---|
DeviceNotAvailableException |
isInRestartCallback
protected boolean isInRebootCallback ()
Trả về xem lệnh gọi lại khởi động lại hiện có đang được thực thi hay không. Tất cả API công khai dành cho tắt tính năng khởi động lại nếu là true.
Giá trị trả về | |
---|---|
boolean |
mới hơn
protected boolean isNewer (File localFile, IFileEntry entry)
Trả về true
nếu tệp trên máy mới hơn tệp từ xa. IFileEntry
đang được
chính xác đến phút, trong trường hợp các khoảng thời gian bằng nhau, tệp sẽ được coi là mới hơn.
Tham số | |
---|---|
localFile |
File |
entry |
IFileEntry |
Giá trị trả về | |
---|---|
boolean |
Thông báo đã kết thúc khởi động lại
protected void notifyRebootEnded ()
Thông báo cho tất cả IDeviceActionReceiver
về sự kiện kết thúc khởi động lại.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notificationsStarted (thông báo đã khởi động lại)
protected void notifyRebootStarted ()
Thông báo cho tất cả IDeviceActionReceiver
về sự kiện khởi động lại.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
thực hiện hành động trên thiết bị
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Thực hiện một hành động trên thiết bị này. Cố gắng khôi phục thiết bị và thử lại lệnh nếu không thành công.
Tham số | |
---|---|
actionDescription |
String : một đoạn mô tả ngắn về hành động cần thực hiện. Dùng để ghi nhật ký
chỉ có mục đích riêng. |
action |
NativeDevice.DeviceAction : hành động cần thực hiện |
retryAttempts |
int : lần thử lại nếu không thành công nhưng khôi phục thành công |
Giá trị trả về | |
---|---|
boolean |
true nếu đã thực hiện hành động thành công |
Gửi | |
---|---|
DeviceNotAvailableException |
nếu cố gắng khôi phục không thành công hoặc số lần thử tối đa mà không có thành công |
PostAdbKhởi động lại
protected void postAdbReboot ()
Những thao tác bổ sung mà bạn có thể thực hiện sau khi khởi động lại.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Thiết lập prePostBoot
protected void prePostBootSetup ()
Cho phép từng loại thiết bị (AndroidNativeDevice, TestDevice) ghi đè phương thức này cho thiết lập khởi động bài đăng cụ thể.
Gửi | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PuyFileNội bộ
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Tham số | |
---|---|
remoteFilePath |
String |
localFile |
File |
Giá trị trả về | |
---|---|
boolean |
Gửi | |
---|---|
DeviceNotAvailableException |
đặtĐồng hồ
protected void setClock (Clock clock)
Đặt thực thể Đồng hồ để sử dụng.
Tham số | |
---|---|
clock |
Clock |
Quy trình setMicrodroid
protected void setMicrodroidProcess (Process process)
Đánh dấu TestDevice là microdroid và đặt CID.
Tham số | |
---|---|
process |
Process : Quy trình của Microdroid VM. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Tham số | |
---|---|
deviceOptions |
|
đơn giảnKhởi động nhanhCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Thực thi một lệnh khởi động nhanh đơn giản với các biến môi trường và báo cáo trạng thái của .
Tham số | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
Giá trị trả về | |
---|---|
CommandResult |
đơn giảnKhởi động nhanhCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Thực thi một lệnh khởi động nhanh đơn giản và báo cáo trạng thái của lệnh đó.
Tham số | |
---|---|
timeout |
long |
fullCmd |
String |
Giá trị trả về | |
---|---|
CommandResult |
Chờ thiết bị không có sẵn
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Chờ để xem thiết bị không hoạt động (ngừng báo cáo với adb).
Tham số | |
---|---|
operationDesc |
String : Tên của thao tác đang chờ không sử dụng được. |
time |
long : Thời gian chờ đến khi không có sẵn. |
Giá trị trả về | |
---|---|
boolean |
Đúng nếu thiết bị không hoạt động. |