NativeDevice
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
| java.lang.Object | |
| ↳ | com.android.tradefed.device.NativeDevice |
Cách triển khai mặc định của ITestDevice Thiết bị Android không có 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ố | |
|---|---|
String |
DEBUGFS_PATH
|
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ử lại lệnh mặc định cần thực hiện |
String |
SD_CARD
|
String |
STORAGE_EMULATED
|
Trường | |
|---|---|
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 thuộc tính chúng ta cần thay vì gọi "adb getprop" cho từng thuộc tính. |
boolean
|
canSwitchToHeadlessSystemUser()
Trả về việc có được 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 có được hỗ trợ hay không ở cấp độ hỗ trợ tối thiểu. |
boolean
|
checkConnectivity()
Kiểm tra để đảm bảo thiết bị có kết nối mạng. |
boolean
|
clearErrorDialogs()
Thử đóng mọi hộp thoại lỗi hiện đ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ạ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 người dùng có tên đã cho và các cờ được cung cấp |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Tạo người dùng có tên đã cho và các cờ được cung cấp |
int
|
createUser(String name)
Tạo người dùng có tên đã cho và cờ mặc định là 0. |
int
|
createUserNoThrow(String name)
Tạo người dùng có tên đã cho và cờ mặc định là 0. |
DeviceInspectionResult
|
debugDeviceNotAvailable()
Kiểm tra một thiết bị và trả về thông tin chi tiết khi thiết bị không hoạt động. |
void
|
deleteFile(String deviceFilePath, int userId)
Phương thức trợ giúp để xoá một tệp hoặc thư mục trên thiết bị. |
void
|
deleteFile(String deviceFilePath)
Phương thức trợ giúp để xoá một tệp hoặc thư mục trên thiết bị. |
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 phần mềm bằng cách so sánh system_server hiện tại với system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Phương thức trợ giúp để kiểm tra xem thiết bị có khởi động lại phần mềm kể từ thời gian UTC tính từ thời gian bắt đầu của hệ thống từ thiết bị và |
boolean
|
disableAdbRoot()
Tắt quyền truy cập của adb vào thư mục gốc. |
void
|
disableKeyguard()
Tìm cách tắt khoá màn hình. |
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 tệp trên thiết bị có tồn tại cho một người dùng nhất định hay không. |
boolean
|
doesFileExist(String deviceFilePath)
Phương thức hỗ trợ để xác định xem tệp có tồn tại trên thiết bị hay không. |
File
|
dumpHeap(String process, String devicePath)
Hãy thử kết xuất heap từ system_server. |
boolean
|
enableAdbRoot()
Bật quyền truy cập adb root. |
boolean
|
enableNetworkMonitor()
Cho phép giám sát mạng trên thiết bị. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định. |
String
|
executeAdbCommand(long timeout,
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định. |
String
|
executeAdbCommand(String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống. |
CommandResult
|
executeAdbV2Command(String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống. |
CommandResult
|
executeAdbV2Command(long timeout, String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định. |
CommandResult
|
executeAdbV2Command(long timeout,
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh fastboot dưới dạng lệnh hệ thống với thời gian chờ mặc định là 2 phút. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh fastboot dưới dạng lệnh hệ thống. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh fastboot chạy trong thời gian dài dưới dạng lệnh hệ thống. |
CommandResult
|
executeLongFastbootCommand(
Phương thức trợ giúp thực thi một lệnh fastboot chạy trong thời gian dài dưới dạng lệnh hệ thống với các biến môi trường hệ thống. |
String
|
executeShellCommand(String command)
Phương thức trợ giúp thực thi một lệnh adb shell và trả về đầu ra dưới dạng |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh. |
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 thực thi một 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 thực thi một lệnh adb shell và trả về kết quả dưới dạng |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Phương thức trợ giúp thực thi một lệnh shell adb và trả về kết quả dưới dạng |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh. |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh. |
CommandResult
|
fastbootWipePartition(String partition)
Phương thức trợ giúp xoá 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ị. |
String
|
getAdbPath()
Trả về đường dẫn của tệp nhị phân adb đang được dùng. |
|
getAllSettings(String namespace)
Trả về các 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 một userId, trả về giá trị rỗng nếu không tìm thấy. |
|
getAndroidIds()
Tạo một Bản đồ gồm các mã nhận dạng Android được 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 cài đặt trên thiết bị. |
|
getAppPackageInfos()
Tìm nạp thông tin về các gói đã cài đặt trên thiết bị. |
String
|
getBasebandVersion()
Phương thức thuận tiện để lấy phiên bản băng tần cơ sở (đài) của thiết bị này. |
Integer
|
getBattery()
Trả về mức pin hiện tại của thiết bị hoặc giá trị rỗng nếu không có thông tin về mức pin. |
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 cùng với 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 với thời gian khởi động và lý do khởi động kể từ thời gian đã cho kể từ thời điểm bắt đầu tính thời gian trên thiết bị và đơn vị thời gian được chỉ định. |
String
|
getBootloaderVersion()
Phương thức thuận tiện để lấy phiên bản trình tải khởi động của thiết bị này. |
InputStreamSource
|
getBugreport()
Truy xuất một báo cáo lỗi từ thiết bị. |
InputStreamSource
|
getBugreportz()
Truy xuất một bugreportz từ thiết bị. |
String
|
getBuildAlias()
Truy xuất biệt hiệu của bản dựng mà thiết bị hiện đang chạy. |
String
|
getBuildFlavor()
Truy xuất hương vị bản dựng cho thiết bị. |
String
|
getBuildId()
Truy xuất bản dựng mà thiết bị hiện đ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 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ề |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Trả về |
String[]
|
getChildren(String path)
Giải pháp thay thế cho việc sử dụng |
AbstractConnection
|
getConnection()
Mối 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 có thể gập lại hiện tại của thiết bị hoặc giá trị rỗng nếu có vấn đề xảy ra. |
int
|
getCurrentUser()
Trả về mã nhận dạng của người dùng đang chạy hiện tại. |
String
|
getDeviceClass()
Lấy lớp thiết bị. |
long
|
getDeviceDate()
Trả về ngày của thiết bị theo mili giây kể từ thời gian bắt đầu của hệ thống. |
DeviceDescriptor
|
getDeviceDescriptor()
Trả về một |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Trả về một |
TestDeviceState
|
getDeviceState()
Lấy trạng thái của thiết bị. |
long
|
getDeviceTimeOffset(Date date)
Trợ giúp để biết sự khác biệt về thời gian giữa thiết bị và một |
InputStreamSource
|
getEmulatorOutput()
Lấy 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 thức trợ giúp để xác định lượng dung lượng trống trên bộ nhớ ngoài của thiết bị. |
String
|
getFastbootPath()
Trả về đường dẫn của tệp nhị phân fastboot đang được 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ế độ fastboot. |
String
|
getFastbootProductVariant()
Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này khi thiết bị ở chế độ fastboot. |
String
|
getFastbootSerialNumber()
Trả về số sê-ri ở chế độ fastboot. |
String
|
getFastbootVariable(String variableName)
Truy xuất giá trị biến fastboot đã cho từ thiết bị. |
String
|
getFastbootVersion()
Trả về chuỗi phiên bản của tệp nhị phân fastboot đang được dùng. |
IFileEntry
|
getFileEntry(String path)
Truy xuất thông tin tham chiếu đến một tệp từ xa trên thiết bị. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Trợ lý không chính thức để lấy |
|
getFoldableStates()
Trả về danh sách các trạng thái có thể gập lại trên thiết bị. |
IDevice
|
getIDevice()
Trả về một giá trị tham chiếu đến ddmlib |
|
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 để lấy trạng thái hiện tại của khoá bảo vệ hoặc giá trị rỗng nếu không được hỗ trợ. |
long
|
getLastExpectedRebootTimeMillis()
Trả về lần cuối cùng các API Tradefed kích hoạt một lần khởi động lại tính bằng mili giây kể từ EPOCH do |
int
|
getLaunchApiLevel()
Nhận Cấp độ API được khởi chạy lần đầu của thiết bị. |
InputStreamSource
|
getLogcat()
Lấy một luồng thông tin tổng quan nhanh về dữ liệu logcat. |
InputStreamSource
|
getLogcat(int maxBytes)
Lấy một luồng ảnh chụp nhanh của |
InputStreamSource
|
getLogcatDump()
Nhận một bản kết xuất logcat hiện tại cho thiết bị. |
InputStreamSource
|
getLogcatSince(long date)
Lấy một luồng ảnh chụp nhanh của dữ liệu logcat đã ghi lại, bắt đầu từ ngày được cung cấp. |
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 chính được cài đặt trên thiết bị. |
int
|
getMaxNumberOfRunningUsersSupported()
Lấy số lượng tối đa người dùng được hỗ trợ chạy đồng thời. |
int
|
getMaxNumberOfUsersSupported()
Lấy số lượng người dùng tối đa được hỗ trợ. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Trả về |
String
|
getMountPoint(String mountName)
Trả về một điểm gắn kết. |
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/mounts trên thiết bị |
TestDeviceOptions
|
getOptions()
Tìm nạp các lựa chọn kiểm thử cho thiết bị. |
long
|
getPartitionFreeSpace(String partition)
Phương thức trợ giúp để xác định lượng dung lượng trống trên phân vùng thiết bị. |
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 chạy lệnh "pidof" và "stat", đồng thời 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 có sự cố xảy ra. |
String
|
getProductType()
Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này. |
String
|
getProductVariant()
Phương thức thuận tiện để lấy biến thể sản phẩm của thiết bị này. |
String
|
getProperty(String name)
Truy xuất giá trị thuộc tính đã cho từ thiết bị. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Lấy chế độ khôi phục hiện tại được dùng cho thiết bị. |
InputStreamSource
|
getScreenshot(long displayId)
Chụp ảnh màn hình từ thiết bị có mã nhận dạng màn hình đã cho. |
InputStreamSource
|
getScreenshot(String format)
Chụp ảnh màn hình thiết bị. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Chụp ảnh màn hình thiết bị. |
InputStreamSource
|
getScreenshot()
Chụp ảnh màn hình 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à mạng của thẻ SIM hoặc giá trị rỗng nếu không có hoặc nếu thiết bị không có. |
String
|
getSimState()
Trả về trạng thái thẻ SIM hoặc giá trị rỗng nếu không có hoặc thiết bị không có. |
|
getTombstones()
Tìm nạp và trả về danh sách các tệp đánh dấu xoá khỏi thiết bị. |
long
|
getTotalMemory()
Trả về tổng kích thước bộ nhớ vật lý tính bằng byte hoặc -1 trong trường hợp xảy ra lỗi nội bộ |
String
|
getTrackingSerial()
Để 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()
Lấy thông tin về việc có sử dụng lệnh xoá fastboot hay định dạng fastboot để xoá một phân vùng trên thiết bị hay không. |
int
|
getUserFlags(int userId)
Tìm và trả về các cờ của một người dùng cụ thể. |
|
getUserInfos()
Nhận Bản đồ useId thành |
int
|
getUserSerialNumber(int userId)
Trả về số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong mọi trường hợp khác. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Xử lý DeviceEvent đã cho. Xử lý DeviceEvent, có thể hoặc không chuyển thiết bị này sang trạng thái phân bổ mới. |
boolean
|
hasFeature(String feature)
Kiểm tra xem một tính năng có dùng được trên thiết bị hay không. |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
Khởi tạo kết nối với thiết bị. |
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ể. |
boolean
|
installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)
Cài đặt APK ở chế độ tăng dần. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc liệt kê ứng dụng hay không |
boolean
|
isBypassLowTargetSdkBlockSupported()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc bỏ qua khối sdk mục tiêu thấp khi cài đặt ứng dụng hay không |
boolean
|
isDebugfsMounted()
Kiểm tra xem debugfs đã được gắn 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, trả về false nếu không. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Trả về nếu thiết bị có hỗ trợ mã hoá. |
boolean
|
isExecutable(String fullPath)
Trả về True nếu đường dẫn tệp trên thiết bị là một tệp thực thi, trả về false trong trường hợp ngược lại. |
boolean
|
isFastbootEnabled()
Trả về nếu thiết bị có chế độ khởi động nhanh. |
boolean
|
isHeadless()
Trả về true nếu thiết bị không có màn hình, nếu không thì trả về false. |
boolean
|
isHeadlessSystemUserMode()
Trả về xem 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ề giá trị cho biết người dùng chính có phải là quản trị viên vĩnh viễn hay không và không thể bị xoá hoặc hạ cấp xuống trạng thái không phải là quản trị viên. |
boolean
|
isMultiUserSupported()
Xác định xem thiết bị có hỗ trợ nhiều người dùng hay không. |
boolean
|
isPackageInstalled(String packageName, String userId)
Truy vấn thiết bị theo một tên gói và mã nhận dạng người dùng nhất định để kiểm tra xem người dùng đó có đang cài đặt hay không. |
boolean
|
isPackageInstalled(String packageName)
Truy vấn thiết bị theo một tên gói nhất định để kiểm tra xem tên gói đó hiện đã đượ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ợ việc cấp quyền trong thời gian chạy hay không |
boolean
|
isStateBootloaderOrFastbootd()
Trả về true nếu thiết bị ở trạng thái |
boolean
|
isUserRunning(int userId)
Kiểm tra xem một người dùng nhất định có đang chạy hay không. |
boolean
|
isUserSecondary(int userId)
Trả về liệu người dùng được chỉ định có phải là người dùng phụ hay không theo các cờ của người dùng đó. |
boolean
|
isUserVisible(int userId)
Kiểm tra xem người dùng đã cho có hiển thị hay không. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Kiểm tra xem người dùng đã cho có xuất hiện trong màn hình đã cho hay không. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Trả về việc thiết bị có cho phép người dùng bắt đầu thấy được trong nền trong |
boolean
|
isVisibleBackgroundUsersSupported()
Trả về việc thiết bị có cho phép người dùng bắt đầu thấy được trong nền hay không. |
boolean
|
isWifiEnabled()
Kiểm tra xem Wi-Fi đã bật hay chưa. |
|
listDisplayIds()
Thu thập danh sách mã nhận dạng 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 các 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 lại lỗi ANR trên thiết bị. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Phương thức trợ giúp để lấy một báo cáo lỗi và ghi báo cáo đó vào các báo cáo. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Ghi nhật ký một thông báo trong logcat của thiết bị. |
void
|
mountDebugfs()
Gắn debugfs. |
void
|
nonBlockingReboot()
Đưa ra lệnh khởi động lại thiết bị và trả về khi lệnh hoàn tất và khi thiết bị không còn xuất hiện trên adb nữa. |
void
|
postAdbRootAction()
Ghi đè nếu thiết bị cần thực hiện một số thao tác cụ thể sau khi adb root và trước khi thiết bị kết nối 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 adb unroot và trước khi thiết bị kết nối lại với mạng. |
void
|
postBootSetup()
Thực hiện hướng dẫn để định cấu hình thiết bị cho việc kiểm thử sau mỗi lần khởi động. |
void
|
postInvocationTearDown(Throwable exception)
Các bước bổ sung để dọn dẹp bắt buộc theo từng thiết bị cụ thể sẽ được thực thi sau khi hoàn tất lệnh gọi. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Các bước bổ sung cho chế độ thiết lập bắt buộc dành riêng cho thiết bị sẽ được thực thi trên thiết bị trước quy trình gọi. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Truy xuất nội dung thư mục từ thiết bị theo cách đệ quy. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Truy xuất nội dung thư mục từ thiết bị theo cách đệ quy. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Truy xuất một tệp khỏi thiết bị. |
File
|
pullFile(String remoteFilePath, int userId)
Truy xuất một tệp khỏi thiết bị, lưu trữ tệp đó trong |
File
|
pullFile(String remoteFilePath)
Truy xuất một tệp khỏi thiết bị, lưu trữ tệp đó trong |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Truy xuất một tệp khỏi thiết bị. |
String
|
pullFileContents(String remoteFilePath)
Truy xuất một tệp trên 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 mộ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 nội dung thư mục một cách đệ quy vào thiết bị trong khi loại trừ một số thư mục được lọc. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Đẩy nội dung thư mục vào thiết bị theo cách đệ quy. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Đẩy nội dung thư mục vào thiết bị theo cách đệ quy. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Biến thể của |
boolean
|
pushFile(File localFile, String remoteFilePath)
Đẩy một tệp đến thiết bị. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Đẩy một tệp đến thiết bị. |
boolean
|
pushString(String contents, String remoteFilePath)
Đẩy tệp được tạo từ một chuỗi sang thiết bị |
void
|
reboot(String reason)
Khởi động lại thiết bị ở chế độ adb với |
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ế độ fastbootd. |
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ế độ cài đặt không qua cửa hàng adb (lưu ý rằng đây là một chế độ đặc biệt trong chế độ khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ tải qua một bên |
void
|
rebootIntoSideload(boolean autoReboot)
Khởi động lại thiết bị ở chế độ cài đặt không qua cửa hàng adb (lưu ý rằng đây là một chế độ đặc biệt trong chế độ khôi phục) Chặn cho đến khi thiết bị chuyển sang chế độ tải qua một bên |
void
|
rebootUntilOnline()
Một lựa chọn thay thế cho |
void
|
rebootUntilOnline(String reason)
Một lựa chọn thay thế cho |
void
|
rebootUserspace()
Chỉ khởi động lại phần 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 giao tiếp với thiết bị. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Đăng ký một |
void
|
remountSystemReadOnly()
Chuyển phân vùng hệ thống trên thiết bị sang chế độ chỉ đọc. |
void
|
remountSystemWritable()
Đặt phân vùng hệ thống trên thiết bị ở chế độ có thể ghi. |
void
|
remountVendorReadOnly()
Thiết lập phân vùng nhà cung cấp trên thiết bị ở chế độ chỉ đọc. |
void
|
remountVendorWritable()
Cho phép ghi vào phân vùng nhà cung cấp trên thiết bị. |
boolean
|
removeAdmin(String componentName, int userId)
Xoá quản trị viên thiết bị đã cho trong người dùng đã cho và trả về |
void
|
removeOwners()
Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có bằng mọi cách có thể. |
boolean
|
removeUser(int userId)
Xoá một người dùng nhất định 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ờ này. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Phương thức thuận tiện để thực hiện |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Chạy kiểm thử đo lường và cung cấp khả năng khôi phục thiết bị. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Tương tự như |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Tương tự như |
void
|
setAdbPath(String adbPath)
Đặt đường dẫn đến tệp nhị phân adb sẽ được dùng. |
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 ý: bạn cần có quyền truy cập vào hệ thống để đặt ngày trên thiết bị |
boolean
|
setDeviceOwner(String componentName, int userId)
Đặt một thành phần quản trị thiết bị làm chủ sở hữu thiết bị cho người dùng đã cho. |
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 lựa chọn fastboot cho thiết bị. |
void
|
setFastbootPath(String fastbootPath)
Đặt đường dẫn đến tệp nhị phân fastboot sẽ được 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 ghi lại 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ị chế độ cài đặt vào không gian tên của một người dùng nhất định. |
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 tôi dùng để tham chiếu thiết bị. |
void
|
setUseFastbootErase(boolean useFastbootErase)
Đặt xem có sử dụng lệnh fastboot erase hay fastboot format để xoá một phân vùng trên thiết bị hay không. |
void
|
startLogcat()
Bắt đầu ghi lại đầu ra logcat từ thiết bị ở chế độ nền. |
boolean
|
startTradeInModeTesting(int timeoutMs)
Bật chế độ kiểm thử giao dịch thu cũ đổi mới. |
boolean
|
startUser(int userId)
Khởi động một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang dừng. |
boolean
|
startUser(int userId, boolean waitFlag)
Khởi động một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang dừng. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Khởi động một người dùng nhất định ở chế độ nền, hiển thị trong 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á đầ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 được lưu. |
void
|
stopTradeInModeTesting()
Dừng kiểm thử chế độ đổi cũ lấy mới. |
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 chế độ adb qua USB. |
boolean
|
switchUser(int userId)
Chuyển sang một userId khác với thời gian chờ mặc định. |
boolean
|
switchUser(int userId, long timeout)
Chuyển sang một userId khác với thời gian chờ đã cho làm thời hạn. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Đồng bộ hoá nội dung của một thư mục tệp cục bộ với thiết bị theo từng bước. |
Bugreport
|
takeBugreport()
Lấy một báo cáo lỗi và trả về báo cáo đó trong một đố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ị cho một người dùng nhất định. |
boolean
|
unlockDevice()
Mở khoá thiết bị nếu thiết bị đang ở trạng thái được mã hoá. |
void
|
unmountDebugfs()
Huỷ gắn debugfs. |
boolean
|
waitForBootComplete(long timeOut)
Chặn cho đến khi cờ hoàn tất quá trình khởi động của thiết bị được đặt. |
boolean
|
waitForDeviceAvailable()
Chờ thiết bị phản hồi và sẵn sàng cho việc kiểm thử. |
boolean
|
waitForDeviceAvailable(long waitTime)
Chờ thiết bị phản hồi và sẵn sàng cho việc kiểm thử. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Chờ thiết bị phản hồi và có sẵn mà không cần xem xét đường dẫn khôi phục. |
void
|
waitForDeviceBootloader()
Chặn cho đến khi thiết bị xuất hiện qua fastboot. |
void
|
waitForDeviceFastbootD()
|
boolean
|
waitForDeviceInRecovery(long waitTime)
Các khối để thiết bị ở trạng thái "adb recovery" (lưu ý rằng trạng thái này khác với |
boolean
|
waitForDeviceInSideload(long waitTime)
Chặn thiết bị ở trạng thái "adb sideload" |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Các khối để thiết bị không hoạt động, tức là không có 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 một lệnh cơ bản của adb shell. |
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 lệnh adb shell và các đối số đã cho |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Tạo một |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Thực hiện lệnh khởi động lại adb. |
void
|
ensureRuntimePermissionSupported()
phương thức trợ giúp để đưa ra ngoại lệ nếu không hỗ trợ quyền trong thời gian chạy |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Lấy thực thể |
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Tìm nạp một thuộc tính thiết bị, theo mặc định là từ bộ nhớ đệm ddmlib và quay lại "adb shell getprop" hoặc "fastboot getvar" tuỳ thuộc vào việc thiết bị có ở chế độ Fastboot hay không. |
boolean
|
isInRebootCallback()
Trả về trạng thái cho biết lệnh gọi lại khởi động lại 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 thao tác trên thiết bị này. |
void
|
postAdbReboot(NativeDevice.RebootMode rebootMode)
Các thao tác bổ sung 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 để thiết lập cụ thể sau khi khởi động. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Đặt phiên bản Đồng hồ để sử dụng. |
void
|
setMicrodroidProcess(Process process)
Đánh dấu TestDevice là microdroid và đặt CID của thiết bị. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Thực thi một lệnh fastboot đơn giản bằng các biến môi trường và báo cáo trạng thái của lệnh. |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Thực thi một lệnh fastboot đơn giản và báo cáo trạng thái của lệnh đó. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Chờ cho đến khi thiết bị không hoạt động (ngừng báo cáo cho adb). |
Hằng số
DEBUGFS_PATH
public static final String DEBUGFS_PATH
Giá trị không đổi: "/sys/kernel/debug"
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ị hằng số: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Giá trị hằng số: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
số lần thử lại lệnh mặc định cần thực hiện
Giá trị hằng số: 2 (0x00000002)
SD_CARD
protected static final String SD_CARD
Giá trị không đổi: "/sdcard/"
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
Giá trị không đổi: "/storage/emulated/"
Trường
Hàm khởi tạo công khai
NativeDevice
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 cần sử dụng |
allocationMonitor |
IDeviceMonitor: IDeviceMonitor để thông báo về các thay đổi trạng thái phân bổ.
Có thể có giá trị rỗng |
Phương thức công khai
batchPrefetchStartupBuildProps
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 thuộc tính chúng ta cần thay vì gọi "adb getprop" cho từng thuộc tính. tức là việc tìm nạp tất cả các thuộc tính cũng nhanh như tìm nạp một thuộc tính. Những thứ như device.getApiLevel(), checkApiLevelAgainstNextRelease và getBuildAlias đều gọi "adb getprop" ở chế độ nền. Chúng tôi tìm nạp các thuộc tính này trong một lệnh gọi và gọi NativeDevice.setProperty. Ngay cả khi chúng ta không làm điều này, NativeDevice sẽ tự gọi setProperty và lưu kết quả vào bộ nhớ đệm cho các lệnh 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 ở chế độ khôi phục hoặc có các lỗi khác khi tìm nạp các đạo cụ, chúng ta chỉ cần bỏ qua chúng.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Trả về việc có được 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 có được hỗ trợ hay không ở cấp độ hỗ trợ tối thiểu. Phương thức này vẫn chưa tính đến các tính năng chưa phát hành, trước khi cấp độ API được nâng lên.
| Tham số | |
|---|---|
strictMinLevel |
int: Cấp độ tối thiểu có thể hỗ trợ tính năng này. |
| Giá trị trả về | |
|---|---|
boolean |
Đúng nếu cấp độ được hỗ trợ. Nếu không thì trả về giá trị false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
checkConnectivity
public boolean checkConnectivity ()
Kiểm tra để đảm bảo 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 nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
clearErrorDialogs
public boolean clearErrorDialogs ()
Thử đóng mọi hộp thoại lỗi hiện đ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 hộp thoại đã được xoá thành công.
Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Xoá mạng Wi-Fi đã kết nối gần đây nhất. Bạn nên gọi phương thức này 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.
clearLogcat
public void clearLogcat ()
Xoá mọi dữ liệu logcat đã tích luỹ.
Điều này hữu ích trong trường hợp bạn muốn đảm bảo ITestDevice.getLogcat() chỉ trả về dữ liệu nhật ký được tạo sau một thời điểm nhất định (chẳng hạn như sau khi cài đặt bản dựng thiết bị mới, v.v.).
connectToWifiNetwork
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 mạng Wi-Fi được cung cấp trong bản đồ wifiSsidToPsk. Sau khi kết nối, phiên bản sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.
| Tham số | |
|---|---|
wifiSsidToPsk |
: Bản đồ SSID Wi-Fi đến mật khẩu. |
scanSsid |
boolean: có quét các 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 |
|
connectToWifiNetwork
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 đã chỉ định.
Sau khi kết nối, phiên bản sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.
| Tham số | |
|---|---|
wifiSsid |
String: ssid wifi để kết nối |
wifiPsk |
String: Cụm mật khẩu PSK hoặc giá trị 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 |
|
connectToWifiNetwork
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 mạng Wi-Fi được cung cấp trong bản đồ wifiSsidToPsk. Sau khi kết nối, phiên bản sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.f
| Tham số | |
|---|---|
wifiSsidToPsk |
: Bản đồ SSID 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 |
|
connectToWifiNetwork
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 đã chỉ định.
Sau khi kết nối, phiên bản sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.
| Tham số | |
|---|---|
wifiSsid |
String: ssid wifi để kết nối |
wifiPsk |
String: Cụm mật khẩu PSK hoặc giá trị rỗng nếu không được mã hoá |
scanSsid |
boolean: có quét 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 |
|
connectToWifiNetworkIfNeeded
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 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 |
|
connectToWifiNetworkIfNeeded
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 |
|
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)Tạo người dùng có tên đã cho và các cờ được cung cấp
| Tham số | |
|---|---|
name |
String: của người dùng cần tạo trên thiết bị |
guest |
boolean: cho phép cờ người dùng --guest trong quá trình tạo |
ephemeral |
boolean: bật cờ người dùng --ephemeral 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 |
|
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)Tạo người dùng có tên đã cho và các cờ được cung cấp
| Tham số | |
|---|---|
name |
String: của người dùng cần tạo trên thiết bị |
guest |
boolean: cho phép cờ người dùng --guest trong quá trình tạo |
ephemeral |
boolean: bật cờ người dùng --ephemeral trong quá trình tạo |
forTesting |
boolean: bật cờ kiểm thử --for-testing 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 |
|
createUser
public int createUser (String name)
Tạo người dùng có tên đã cho và cờ mặc định là 0.
| Tham số | |
|---|---|
name |
String: của người dùng cần 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 |
|
createUserNoThrow
public int createUserNoThrow (String name)
Tạo người dùng có tên đã cho và cờ mặc định là 0.
| Tham số | |
|---|---|
name |
String: của người dùng cần 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 hoặc -1 nếu xảy ra lỗi. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
debugDeviceNotAvailable
public DeviceInspectionResult debugDeviceNotAvailable ()
Kiểm tra một thiết bị và trả về thông tin chi tiết khi thiết bị không hoạt động.
| Giá trị trả về | |
|---|---|
DeviceInspectionResult |
|
deleteFile
public void deleteFile (String deviceFilePath,
int userId)Phương thức trợ giúp để xoá một tệp hoặc thư mục trên thiết bị.
| Tham số | |
|---|---|
deviceFilePath |
String: Đường dẫn tuyệt đối của tệp trên thiết bị. |
userId |
int: Mã nhận dạng người dùng cần xoá |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
deleteFile
public void deleteFile (String deviceFilePath)
Phương thức trợ giúp để xoá một tệp hoặc thư mục trên thiết bị.
| Tham số | |
|---|---|
deviceFilePath |
String: Đường dẫn tuyệt đối của tệp trên thiết bị. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
deregisterDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Xoá IDeviceActionReceiver đã đăng ký.
| Tham số | |
|---|---|
deviceActionReceiver |
IDeviceActionReceiver: Một IDeviceActionReceiver sẽ bị xoá. |
deviceSoftRestarted
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 phần mềm bằng cách so sánh system_server hiện tại với system_server ProcessInfo trước đó hay không. Dùng getProcessByName(String) để hưởng ProcessInfo.
| Tham số | |
|---|---|
prevSystemServerProcess |
ProcessInfo: quy trình system_server trước đó ProcessInfo. |
| Giá trị trả về | |
|---|---|
boolean |
true nếu thiết bị khởi động lại phần mềm |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
deviceSoftRestartedSince
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 phần mềm kể từ thời gian UTC tính từ thời gian bắt đầu của hệ thống từ thiết bị và ERROR(/TimeUnit) của thiết bị hay không. Khởi động lại phần mềm là hệ thống_máy chủ được khởi động lại bên ngoài quá trình khởi động lại cứng thiết bị (ví dụ: yêu cầu khởi động lại). Bạn có thể lấy utcEpochTime hiện tại của thiết bị theo Mili giây bằng phương thức getDeviceDate().
| Tham số | |
|---|---|
utcEpochTime |
long: thời gian của thiết bị tính bằng giây kể từ thời gian bắt đầu của hệ thống. |
timeUnit |
TimeUnit: đơn vị thời gian TimeUnit cho utcEpochTime đã cho. |
| Giá trị trả về | |
|---|---|
boolean |
true nếu thiết bị khởi động lại phần mềm |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
disableAdbRoot
public boolean disableAdbRoot ()
Tắt quyền truy cập của adb vào thư mục gốc.
Việc tắt quyền truy cập của adb vào thư mục gốc có thể khiến thiết bị ngắt kết nối với adb. Phương thức này sẽ chặn cho đến khi thiết bị có sẵn.
| Giá trị trả về | |
|---|---|
boolean |
true nếu thành công. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
disableKeyguard
public void disableKeyguard ()
Tìm cách tắt khoá màn hình.
Trước tiên, hãy đợi quá trình truyền dữ liệu đầu vào sẵn sàng. Quá trình này diễn ra cùng lúc khi thiết bị báo cáo BOOT_COMPLETE, rõ ràng là không đồng bộ, vì quá trình triển khai khung hiện tại đôi khi có điều kiện xung đột. Sau đó, lệnh sẽ được gửi để đóng khoá bảo vệ (chỉ hoạt động trên các khoá không bảo mật)
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
disableNetworkMonitor
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 thành công tính năng giám sát. false nếu không thành công. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
disconnectFromWifi
public boolean disconnectFromWifi ()
Ngắt kết nối khỏi mạng Wi-Fi.
Xoá 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 khỏi mạng Wi-Fi thành công. false
nếu không ngắt kết nối được. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)Phương thức trợ giúp để xác định xem tệp trên thiết bị có tồn tại cho một người dùng nhất định 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, false nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Phương thức hỗ trợ để xác định xem tệp có tồn tại trên thiết bị hay không.
| Tham số | |
|---|---|
deviceFilePath |
String: đường dẫn tuyệt đối của tệp trên thiết bị cần kiểm tra |
| Giá trị trả về | |
|---|---|
boolean |
true nếu tệp tồn tại, false nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
dumpHeap
public File dumpHeap (String process,
String devicePath)Hãy thử kết xuất heap từ system_server. Phương thức 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ị để kết xuất heap. |
devicePath |
String: đường dẫn trên thiết bị để đặt tệp kết xuất. Đây phải là vị trí mà bạn có quyền truy cập. |
| 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 quyền truy cập adb root. Nếu chế độ cài đặt "enable-root" là "false", thì sẽ ghi nhật ký một thông báo và trả về mà không bật quyền truy cập vào thư mục gốc.
Việc bật quyền truy cập gốc adb có thể khiến thiết bị ngắt kết nối với adb. Phương thức này sẽ chặn cho đến khi thiết bị có sẵn.
| Giá trị trả về | |
|---|---|
boolean |
true nếu thành công. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
enableNetworkMonitor
public boolean enableNetworkMonitor ()
Cho phép giám sát mạng trên thiết bị.
| Giá trị trả về | |
|---|---|
boolean |
true nếu bạn bật thành công chế độ giám sát. false nếu không thành công. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeAdbCommand
public String executeAdbCommand (long timeout,
String... cmdArgs)Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định.
Bạn nên dùng executeShellCommand(String) thay thế bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và cải thiện hiệu suất tốt hơn.
| Tham số | |
|---|---|
timeout |
long: thời gian tính bằng mili giây trước khi thiết bị được coi là không phản hồi, 0L nếu không có thời gian chờ |
cmdArgs |
String: lệnh adb và các đối số cần chạy |
| Giá trị trả về | |
|---|---|
String |
stdout từ lệnh. null nếu không thực thi được lệnh. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeAdbCommand
public String executeAdbCommand (long timeout,
envMap,
String... cmdArgs) Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định.
Bạn nên dùng executeShellCommand(String) thay thế bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và cải thiện hiệu suất tốt hơn.
| Tham số | |
|---|---|
timeout |
long: thời gian tính bằng mili giây trước khi thiết bị được coi là không phản hồi, 0L nếu không có thời gian chờ |
envMap |
: môi trường cần đặt cho lệnh |
cmdArgs |
String: lệnh adb và các đối số cần chạy |
| Giá trị trả về | |
|---|---|
String |
stdout từ lệnh. null nếu không thực thi được lệnh. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeAdbCommand
public String executeAdbCommand (String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống.
Bạn nên dùng executeShellCommand(String) thay thế bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và cải thiện hiệu suất tốt hơn.
| Tham số | |
|---|---|
cmdArgs |
String: lệnh adb và các đối số cần chạy |
| Giá trị trả về | |
|---|---|
String |
stdout từ lệnh. null nếu không thực thi được lệnh. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống.
Bạn nên dùng executeShellCommand(String) thay thế bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và cải thiện hiệu suất tốt hơn.
| Tham số | |
|---|---|
cmdArgs |
String: lệnh adb và các đối số cần chạy |
| Giá trị trả về | |
|---|---|
CommandResult |
CommandResult chứa đầu ra của lệnh. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (long timeout, String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định.
Bạn nên dùng executeShellCommand(String) thay thế bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và cải thiện hiệu suất tốt hơn.
| Tham số | |
|---|---|
timeout |
long: thời gian tính bằng mili giây trước khi thiết bị được coi là không phản hồi, 0L nếu không có thời gian chờ |
cmdArgs |
String: lệnh adb và các đối số cần chạy |
| Giá trị trả về | |
|---|---|
CommandResult |
CommandResult chứa đầu ra của lệnh. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (long timeout,envMap, String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh adb dưới dạng lệnh hệ thống với thời gian chờ được chỉ định.
Bạn nên dùng executeShellCommand(String) thay thế bất cứ khi nào có thể, vì phương thức đó giúp phát hiện lỗi và cải thiện hiệu suất tốt hơn.
| Tham số | |
|---|---|
timeout |
long: thời gian tính bằng mili giây trước khi thiết bị được coi là không phản hồi, 0L nếu không có thời gian chờ |
envMap |
: môi trường cần đặt cho lệnh |
cmdArgs |
String: lệnh adb và các đối số cần chạy |
| Giá trị trả về | |
|---|---|
CommandResult |
CommandResult chứa đầu ra của lệnh. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh fastboot dưới dạng lệnh hệ thống với thời gian chờ mặc định là 2 phút.
Dự kiến được dùng khi thiết bị đã ở chế độ fastboot.
| Tham số | |
|---|---|
cmdArgs |
String: lệnh fastboot và các đối số để chạy |
| Giá trị trả về | |
|---|---|
CommandResult |
CommandResult chứa đầu ra của lệnh |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh fastboot dưới dạng lệnh hệ thống.
Dự kiến được dùng khi thiết bị đã ở chế độ fastboot.
| Tham số | |
|---|---|
timeout |
long: thời gian tính bằng mili giây trước khi lệnh hết hạn |
cmdArgs |
String: lệnh fastboot và các đối số để chạy |
| Giá trị trả về | |
|---|---|
CommandResult |
CommandResult chứa đầu ra của lệnh |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh fastboot chạy trong thời gian dài dưới dạng lệnh hệ thống.
Tương tự như executeFastbootCommand(String), ngoại trừ việc sử dụng thời gian chờ lâu hơn.
| Tham số | |
|---|---|
cmdArgs |
String: lệnh fastboot và các đối số để chạy |
| Giá trị trả về | |
|---|---|
CommandResult |
CommandResult chứa đầu ra của lệnh |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Phương thức trợ giúp thực thi một lệnh fastboot chạy trong thời gian dài dưới dạng lệnh hệ thống với các biến môi trường hệ thống.
Tương tự như executeFastbootCommand(String), ngoại trừ việc sử dụng thời gian chờ lâu hơn.
| Tham số | |
|---|---|
envVarMap |
: các biến môi trường hệ thống mà lệnh fastboot chạy cùng |
cmdArgs |
String: lệnh fastboot và các đối số để chạy |
| Giá trị trả về | |
|---|---|
CommandResult |
CommandResult chứa đầu ra của lệnh |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
public String executeShellCommand (String command)
Phương thức trợ giúp thực thi một lệnh adb shell và trả về đầu ra dưới dạng String.
| Tham số | |
|---|---|
command |
String: lệnh shell adb để chạy |
| Giá trị trả về | |
|---|---|
String |
đầu ra của shell |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeToOutputShellResponse,
TimeUnit timeUnit,
int retryAttempts)Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
| Tham số | |
|---|---|
command |
String: lệnh shell adb để chạy |
receiver |
IShellOutputReceiver: IShellOutputReceiver để chuyển hướng đầu ra của shell đến. |
maxTimeToOutputShellResponse |
long: khoảng thời gian tối đa mà lệnh được phép không đưa ra bất kỳ phản hồi nào; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit: đơn vị cho maxTimeToOutputShellResponse |
retryAttempts |
int: số lần tối đa để thử lại lệnh nếu lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeoutForCommand,
long maxTimeToOutputShellResponse,
TimeUnit timeUnit,
int retryAttempts)Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
| Tham số | |
|---|---|
command |
String: lệnh shell adb để chạy |
receiver |
IShellOutputReceiver: IShellOutputReceiver để chuyển hướng đầu ra của shell đến. |
maxTimeoutForCommand |
long: thời gian chờ tối đa để lệnh hoàn tất; đơn vị như được chỉ định trong timeUnit |
maxTimeToOutputShellResponse |
long: khoảng thời gian tối đa mà lệnh không được phép đưa ra bất kỳ phản hồi nào; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit: đơn vị cho maxTimeToOutputShellResponse |
retryAttempts |
int: số lần tối đa để thử lại lệnh nếu lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
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 dạng đơn giản hơn của executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) với các giá trị mặc định.
| Tham số | |
|---|---|
command |
String: lệnh shell adb để chạy |
receiver |
IShellOutputReceiver: IShellOutputReceiver để chuyển hướng đầu ra của shell đến. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd)
Phương thức trợ giúp thực thi một lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền đúng cách bằng đầu ra trạng thái lệnh, stdout và stderr.
| Tham số | |
|---|---|
cmd |
String: Lệnh cần chạy. |
| Giá trị trả về | |
|---|---|
CommandResult |
Kết quả bằng CommandResult. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Phương thức trợ giúp thực thi một lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền đúng cách bằng đầu ra trạng thái lệnh và stderr. stdout được chuyển hướng đến luồng được chỉ định.
| Tham số | |
|---|---|
cmd |
String: Lệnh cần chạy. |
pipeToOutput |
OutputStream: ERROR(/OutputStream) nơi đầu ra chuẩn sẽ được chuyển hướng hoặc giá trị rỗng. |
| Giá trị trả về | |
|---|---|
CommandResult |
Kết quả bằng CommandResult. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Phương thức trợ giúp thực thi một lệnh shell adb và trả về kết quả dưới dạng CommandResult được điền đúng cách bằng đầu ra trạng thái lệnh, stdout và stderr.
| Tham số | |
|---|---|
cmd |
String: Lệnh cần chạy. |
pipeAsInput |
File: Một ERROR(/File) sẽ được chuyển hướng làm dữ liệu đầu vào cho lệnh hoặc giá trị rỗng. |
| Giá trị trả về | |
|---|---|
CommandResult |
Kết quả bằng CommandResult. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
| Tham số | |
|---|---|
cmd |
String: lệnh shell adb để chạy |
maxTimeoutForCommand |
long: thời gian chờ tối đa để lệnh hoàn tất; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit: đơn vị cho maxTimeToOutputShellResponse |
retryAttempts |
int: số lần tối đa để thử lại lệnh nếu lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được. |
| Giá trị trả về | |
|---|---|
CommandResult |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
| Tham số | |
|---|---|
cmd |
String: lệnh shell adb để chạy |
maxTimeoutForCommand |
long: thời gian chờ tối đa để lệnh hoàn tất; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit: đơn vị cho maxTimeToOutputShellResponse |
| Giá trị trả về | |
|---|---|
CommandResult |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
| Tham số | |
|---|---|
cmd |
String: lệnh shell adb để chạy |
pipeAsInput |
File: Một ERROR(/File) sẽ được chuyển hướng làm dữ liệu đầu vào cho lệnh hoặc giá trị rỗng. |
pipeToOutput |
OutputStream: ERROR(/OutputStream) nơi đầu ra chuẩn sẽ được chuyển hướng hoặc giá trị rỗng. |
maxTimeoutForCommand |
long: thời gian chờ tối đa để lệnh hoàn tất; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit: đơn vị cho maxTimeToOutputShellResponse |
retryAttempts |
int: số lần tối đa để thử lại lệnh nếu lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được. |
| Giá trị trả về | |
|---|---|
CommandResult |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Thực thi một lệnh adb shell, với nhiều tham số hơn để kiểm soát hành vi của lệnh.
| Tham số | |
|---|---|
cmd |
String: lệnh shell adb để chạy |
pipeAsInput |
File: Một ERROR(/File) sẽ được chuyển hướng làm dữ liệu đầu vào cho lệnh hoặc giá trị rỗng. |
pipeToOutput |
OutputStream: ERROR(/OutputStream) nơi đầu ra chuẩn sẽ được chuyển hướng hoặc giá trị rỗng. |
pipeToError |
OutputStream: ERROR(/OutputStream) nơi lỗi std sẽ được chuyển hướng hoặc giá trị rỗng. |
maxTimeoutForCommand |
long: thời gian chờ tối đa để lệnh hoàn tất; đơn vị như được chỉ định trong timeUnit |
timeUnit |
TimeUnit: đơn vị cho maxTimeToOutputShellResponse |
retryAttempts |
int: số lần tối đa để thử lại lệnh nếu lệnh không thành công do một ngoại lệ. DeviceNotResponsiveException sẽ được gửi nếu retryAttempts không thực hiện được. |
| Giá trị trả về | |
|---|---|
CommandResult |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
fastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
Phương thức trợ giúp xoá một phân vùng cho thiết bị.
Nếu getUseFastbootErase() là true, thì lệnh xoá fastboot sẽ được dùng để xoá phân vùng. Sau đó, thiết bị phải tạo một hệ thống tệp vào lần khởi động tiếp theo.
Nếu không, hệ thống sẽ sử dụng định dạng fastboot để tạo một hệ thống tệp mới trên thiết bị.
Dự kiến được dùng khi thiết bị đã ở chế độ fastboot.
| Tham số | |
|---|---|
partition |
String: phân vùng cần xoá |
| Giá trị trả về | |
|---|---|
CommandResult |
CommandResult chứa đầu ra của lệnh |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
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ề | |
|---|---|
|
Hiện có ERROR(/Set)/ApexInfo được kích hoạt trên thiết bị |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getAdbPath
public String getAdbPath ()
Trả về đường dẫn của tệp nhị phân adb đang được dùng.
| Giá trị trả về | |
|---|---|
String |
|
getAllSettings
publicgetAllSettings (String namespace)
Trả về các 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ề | |
|---|---|
|
bản đồ của các cặp khoá-giá trị. 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 một userId, trả về giá trị rỗng nếu không tìm thấy.
| Tham số | |
|---|---|
userId |
int |
| Giá trị trả về | |
|---|---|
String |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getAndroidIds
publicgetAndroidIds ()
Tạo một Bản đồ gồm các mã nhận dạng Android được tìm thấy khớp với mã nhận dạng người dùng. Không có gì đảm bảo rằng mỗi mã nhận dạng người dùng sẽ tìm thấy một 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 phù hợp. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getApiLevel
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 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 truy xuất được thông tin |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getAppPackageInfos
publicgetAppPackageInfos ()
Tìm nạp thông tin về các gói đã cài đặt trên thiết bị.
| Giá trị trả về | |
|---|---|
|
ERROR(/List) của PackageInfo đã được cài đặt trên thiết bị. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getBasebandVersion
public String getBasebandVersion ()
Phương thức thuận tiện để lấy phiên bản băng tần cơ sở (đài) của thiết bị này. Việc lấy phiên bản radio là dành riêng cho từng thiết bị, vì vậy, có thể thông tin trả về không chính xác cho tất cả các thiết bị. Phương thức này dựa vào thuộc tính gsm.version.baseband để trả về thông tin phiên bản chính xác.
Thông tin này không chính xác đối với một số thiết bị CDMA và phiên bản được trả về ở đây có thể không khớp với phiên bản được báo cáo từ fastboot và có thể không trả về phiên bản cho đài CDMA.
Tóm lại, phương thức này chỉ báo cáo phiên bản chính xác nếu thuộc tính gsm.version.baseband giống với phiên bản do fastboot getvar version-baseband trả về.
| Giá trị trả về | |
|---|---|
String |
phiên bản băng tần cơ sở String hoặc null nếu không xác định được (thiết bị không có đài hoặc không đọc được chuỗi phiên bản) |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getBattery
public Integer getBattery ()
Trả về mức pin hiện tại của thiết bị hoặc giá trị rỗng nếu không có thông tin về mức pin.
| Giá trị trả về | |
|---|---|
Integer |
|
getBooleanProperty
public boolean getBooleanProperty (String name,
boolean defaultValue)Trả về giá trị boolean của thuộc tính đã cho.
| Tham số | |
|---|---|
name |
String: tên thuộc tính |
defaultValue |
boolean: giá trị mặc định để trả về nếu thuộc tính trống hoặc không tồn tại. |
| Giá trị trả về | |
|---|---|
boolean |
true nếu thuộc tính có giá trị "1", "y", "yes", "on" hoặc "true", false nếu thuộc tính có giá trị "0", "n", "no", "off", "false" hoặc defaultValue trong trường hợp khác. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getBootHistory
publicgetBootHistory ()
Phương thức trợ giúp thu thập bản đồ nhật ký khởi động cùng với thời gian khởi động và lý do khởi động.
| Giá trị trả về | |
|---|---|
|
Bản đồ thời gian khởi động (thời gian UTC tính bằng giây kể từ thời gian bắt đầu của hệ thống) và lý do khởi động |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getBootHistorySince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Phương thức trợ giúp thu thập bản đồ nhật ký khởi động với thời gian khởi động và lý do khởi động kể từ thời gian đã cho kể từ thời điểm bắt đầu tính thời gian trên thiết bị và đơn vị thời gian được chỉ định. Bạn có thể lấy utcEpochTime hiện tại của thiết bị tính bằng mili giây bằng phương thức getDeviceDate().
| Tham số | |
|---|---|
utcEpochTime |
long: thời gian của thiết bị kể từ Epoch. |
timeUnit |
TimeUnit: đơn vị thời gian TimeUnit. |
| Giá trị trả về | |
|---|---|
|
Bản đồ thời gian khởi động (thời gian UTC tính bằng giây kể từ thời gian bắt đầu của hệ thống) và lý do khởi động |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getBootloaderVersion
public String getBootloaderVersion ()
Phương thức thuận tiện để lấy phiên bản trình tải khởi động của thiết bị này.
Sẽ cố gắng truy xuất phiên bản trình tải khởi động từ trạng thái hiện tại của thiết bị. (tức là nếu thiết bị ở chế độ fastboot, thì thiết bị sẽ cố gắng truy xuất phiên bản từ fastboot)
| Giá trị trả về | |
|---|---|
String |
phiên bản trình tải khởi động String hoặc null nếu không tìm thấy |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getBugreport
public InputStreamSource getBugreport ()
Truy xuất một báo cáo lỗi từ thiết bị.
Việc triển khai này được đảm bảo sẽ tiếp tục hoạt động trên thiết bị không có thẻ nhớ (hoặc khi thẻ nhớ chưa được gắn).
| Giá trị trả về | |
|---|---|
InputStreamSource |
Một 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. |
getBugreportz
public InputStreamSource getBugreportz ()
Truy xuất một bugreportz 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ỉ được hỗ trợ cho "adb version" > 1.0.36
| Giá trị trả về | |
|---|---|
InputStreamSource |
InputStreamSource của tệp zip chứa bugreportz, trả về giá trị rỗng trong trường hợp thất bại. |
getBuildAlias
public String getBuildAlias ()
Truy xuất biệt hiệu của bản dựng mà thiết bị hiện đang chạy.
Bí danh bản dựng thường là một chuỗi dễ đọc hơn so với mã nhận dạng bản dựng (thường là một số cho các bản dựng Nexus). Ví dụ: bản phát hành Android 4.2 cuối cùng có bí danh bản dựng là JDQ39 và mã nhận dạng bản dựng là 573038
| Giá trị trả về | |
|---|---|
String |
bí danh bản dựng hoặc quay lại mã nhận dạng bản dựng nếu không truy xuất được |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getBuildFlavor
public String getBuildFlavor ()
Truy xuất hương vị bản dựng cho thiết bị.
| Giá trị trả về | |
|---|---|
String |
phiên bản dựng hoặc giá trị rỗng nếu không truy xuất được |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getBuildId
public String getBuildId ()
Truy xuất bản dựng mà thiết bị hiện đang chạy.
| Giá trị trả về | |
|---|---|
String |
mã bản dựng hoặc IBuildInfo.UNKNOWN_BUILD_ID nếu không truy xuất được |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getBuildSigningKeys
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 khoá kiểm thử (như trong AOSP) hoặc khoá phát hành (do từng nhà sản xuất thiết bị kiểm soát)
| Giá trị trả về | |
|---|---|
String |
Khoá ký (nếu tìm thấy), nếu không thì là giá trị rỗng. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Trả về DeviceDescriptor đã lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không thì trả về DeviceDescriptor hiện tại.
| Giá trị trả về | |
|---|---|
DeviceDescriptor |
|
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Trả về DeviceDescriptor đã lưu vào bộ nhớ đệm nếu thiết bị được phân bổ, nếu không thì trả về DeviceDescriptor hiện tại.
| Tham số | |
|---|---|
shortDescriptor |
boolean: Có giới hạn nội dung mô tả ở mức tối thiểu hay không |
| Giá trị trả về | |
|---|---|
DeviceDescriptor |
|
getChildren
public String[] getChildren (String path)
Giải pháp thay thế cho việc sử dụng IFileEntry. Đôi khi, giải pháp này sẽ không hoạt động do vấn đề về quyền.
| Tham số | |
|---|---|
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 ()
Mối 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ó sẵn.
Bạn có thể dùng lại trình cung cấp nội dung nếu đã tạo trình cung cấp này trước đó bằng cùng một userId.
| Tham số | |
|---|---|
userId |
int: mã nhận dạng người dùng để khởi chạy trình cung cấp nội dung. |
| Giá trị trả về | |
|---|---|
ContentProviderHandler |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Trả về trạng thái có thể gập lại hiện tại của thiết bị hoặc giá trị rỗng nếu có vấn đề xảy ra.
| Giá trị trả về | |
|---|---|
DeviceFoldableState |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getCurrentUser
public int getCurrentUser ()
Trả về mã nhận dạng của người dùng đang chạy hiện tại. Trong trường hợp xảy ra 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. |
getDeviceDate
public long getDeviceDate ()
Trả về ngày của thiết bị theo mili giây kể từ thời gian bắt đầu của hệ thống.
| Giá trị trả về | |
|---|---|
long |
ngày của thiết bị ở định dạng thời gian bắt đầu của hệ thống. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
Trả về một DeviceDescriptor từ thông tin thiết bị để nhận thông tin về thiết bị mà không cần truyền đối tượng thiết bị thực tế.
| Giá trị trả về | |
|---|---|
DeviceDescriptor |
|
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Trả về một DeviceDescriptor từ thông tin thiết bị để nhận thông tin về thiết bị mà không cần truyền đối tượng thiết bị thực tế.
| Tham số | |
|---|---|
shortDescriptor |
boolean: Có giới hạn nội dung mô tả ở mức tối thiểu hay không |
| Giá trị trả về | |
|---|---|
DeviceDescriptor |
|
getDeviceState
public TestDeviceState getDeviceState ()
Lấy trạng thái của thiết bị.
| Giá trị trả về | |
|---|---|
TestDeviceState |
|
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Trợ giúp để biết sự khác biệt về thời gian giữa thiết bị và một ERROR(/Date) nhất định. Sử dụng Epoch time nội bộ.
| Tham số | |
|---|---|
date |
Date |
| Giá trị trả về | |
|---|---|
long |
mức chênh lệch tính bằng mili giây |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Lấy luồng stdout và stderr của trình mô phỏng
| Giá trị trả về | |
|---|---|
InputStreamSource |
đầu ra của trình mô phỏng |
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 thức trợ giúp để xác định lượng dung lượng trống trên bộ nhớ ngoài của thiết bị.
| Giá trị trả về | |
|---|---|
long |
lượng dung lượng trống tính bằng KB |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getFastbootPath
public String getFastbootPath ()
Trả về đường dẫn của tệp nhị phân fastboot đang được dùng.
Bạn vẫn cần đặt isFastbootEnabled() thành true để bật các chức năng fastboot.
| Giá trị trả về | |
|---|---|
String |
|
getFastbootProductType
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ế độ fastboot.
Bạn chỉ nên sử dụng phương thức này nếu thiết bị cần ở chế độ fastboot. Đây là một biến thể an toàn hơn một chút so với phương thức getProductType() chung trong trường hợp này, vì ITestDevice sẽ biết cách khôi phục thiết bị vào chế độ fastboot nếu thiết bị ở trạng thái không chính xác hoặc không phản hồi.
| Giá trị trả về | |
|---|---|
String |
tên loại sản phẩm String hoặc null nếu không xác định được |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
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ế độ fastboot.
Bạn chỉ nên sử dụng phương thức này nếu thiết bị cần ở chế độ fastboot. Đây là một biến thể an toàn hơn một chút so với phương thức getProductType() chung trong trường hợp này, vì ITestDevice sẽ biết cách khôi phục thiết bị vào chế độ fastboot nếu thiết bị ở trạng thái không chính xác hoặc không phản hồi.
| Giá trị trả về | |
|---|---|
String |
tên loại sản phẩm String hoặc null nếu không xác định được |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Trả về số sê-ri ở chế độ fastboot.
| Giá trị trả về | |
|---|---|
String |
|
getFastbootVariable
public String getFastbootVariable (String variableName)
Truy xuất giá trị biến fastboot đã cho từ thiết bị.
| Tham số | |
|---|---|
variableName |
String: tên biến |
| Giá trị trả về | |
|---|---|
String |
giá trị thuộc tính hoặc null nếu thuộc tính đó không tồn tại |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getFastbootVersion
public String getFastbootVersion ()
Trả về chuỗi phiên bản của tệp nhị phân fastboot đang được dùng. Hoặc giá trị rỗng nếu có lỗi xảy ra.
| Giá trị trả về | |
|---|---|
String |
|
getFileEntry
public IFileEntry getFileEntry (String path)
Truy xuất thông tin tham chiếu đến một tệp từ xa trên thiết bị.
| Tham số | |
|---|---|
path |
String: đường dẫn tệp cần truy xuất. Có thể là đường dẫn tuyệt đối hoặc đường dẫn tương đối so với "/". (tức là cả cú pháp "/system" và "system" đều được hỗ trợ) |
| Giá trị trả về | |
|---|---|
IFileEntry |
IFileEntry hoặc null nếu không tìm thấy tệp tại path đã cho |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Trợ lý không chính thức để lấy FileEntry từ một đường dẫn không phải là đường dẫn gốc. FIXME: Tái cấu trúc hệ thống FileEntry để có thể truy cập từ mọi đường dẫn. (ngay cả khi không phải là người dùng root).
| 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 |
|
getFoldableStates
publicgetFoldableStates ()
Trả về danh sách các trạng thái có thể gập lại trên thiết bị. Có thể lấy bằng lệnh "cmd device_state print-states".
| Giá trị trả về | |
|---|---|
|
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getIDevice
public IDevice getIDevice ()
Trả về một giá trị tham chiếu đến ddmlib IDevice được liên kết.
DDMS có thể phân bổ một IDevice mới mỗi khi thiết bị ngắt kết nối và kết nối lại với adb. Do đó, người gọi không nên giữ lại thông tin tham chiếu đến IDevice, vì thông tin tham chiếu đó có thể trở nên lỗi thời.
| Giá trị trả về | |
|---|---|
IDevice |
IDevice |
getInstalledPackageNames
publicgetInstalledPackageNames ()
Tìm nạp tên gói ứng dụng có trên thiết bị.
| Giá trị trả về | |
|---|---|
|
ERROR(/Set) tên gói String 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 |
|
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Trả về một đối tượng để lấy trạng thái hiện tại của khoá bảo vệ hoặc giá trị rỗng nếu không được hỗ trợ.
| Giá trị trả về | |
|---|---|
KeyguardControllerState |
KeyguardControllerState chứa ảnh chụp nhanh trạng thái của khoá bảo vệ và trả về giá trị Null nếu truy vấn Keyguard không được hỗ trợ. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getLastExpectedRebootTimeMillis
public long getLastExpectedRebootTimeMillis ()
Trả về lần cuối cùng các API Tradefed kích hoạt một lần khởi động lại tính bằng mili giây kể từ EPOCH do System.currentTimeMillis() trả về.
| Giá trị trả về | |
|---|---|
long |
|
getLaunchApiLevel
public int getLaunchApiLevel ()
Nhận Cấp độ API được khởi chạy lần đầu của thiết bị. Giá trị mặc định là UNKNOWN_API_LEVEL.
| Giá trị trả về | |
|---|---|
int |
một số nguyên cho biết Cấp độ API đầu tiên mà thiết bị đã chạy |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getLogcat
public InputStreamSource getLogcat ()
Lấy một luồng thông tin tổng quan nhanh về dữ liệu logcat.
Hoạt động ở 2 chế độ:
TestDeviceOptions.getMaxLogcatDataSize() byte nội dung hiện tại của quá trình ghi lại logcat ở chế độ nền
| Giá trị trả về | |
|---|---|
InputStreamSource |
|
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Lấy một luồng ảnh chụp nhanh của maxBytes dữ liệu logcat đã chụp gần đây nhất.
Hữu ích trong trường hợp bạn muốn chụp ảnh chụp nhanh thường xuyên về dữ liệu logcat đã chụp mà không phải chịu mức phạt có thể là rất lớn về dung lượng ổ đĩa khi lấy toàn bộ ảnh chụp nhanh getLogcat().
| Tham số | |
|---|---|
maxBytes |
int: lượng dữ liệu tối đa cần trả về. Phải là một số lượng có thể phù hợp với bộ nhớ |
| Giá trị trả về | |
|---|---|
InputStreamSource |
|
getLogcatDump
public InputStreamSource getLogcatDump ()
Nhận một bản kết xuất logcat hiện tại cho thiết bị. Không giống như getLogcat(), phương thức này sẽ luôn trả về một bản kết xuất tĩnh của logcat.
Có nhược điểm là không trả về gì nếu không truy cập được vào thiết bị.
| Giá trị trả về | |
|---|---|
InputStreamSource |
InputStreamSource của dữ liệu logcat. Một luồng trống sẽ được trả về nếu không chụp được dữ liệu logcat. |
getLogcatSince
public InputStreamSource getLogcatSince (long date)
Lấy một luồng ảnh chụp nhanh của dữ liệu logcat đã ghi lại, bắt đầu từ ngày được cung cấp. Bạn nên sử dụng thời gian trên thiết bị getDeviceDate().
| Tham số | |
|---|---|
date |
long: tính bằng mili giây kể từ thời gian bắt đầu của hệ thống cho đến thời điểm hiện tại.
(có thể lấy bằng cách sử dụng "date +%s") |
| Giá trị trả về | |
|---|---|
InputStreamSource |
|
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à giá trị null 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 chính được cài đặt trên thiết bị.
| Giá trị trả về | |
|---|---|
|
ERROR(/Set) trong số String mô-đun chính hiện được cài đặt trên thiết bị. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Lấy số lượng tối đa người dùng được hỗ trợ chạy đồng thời. Giá trị mặc định là: 0
| Giá trị trả về | |
|---|---|
int |
một số nguyên cho biết số lượng người dùng đang chạy đồng thời |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
Lấy số lượng người dùng tối đa được hỗ trợ. Giá trị mặc định là: 0
| Giá trị trả về | |
|---|---|
int |
một 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 VM Microdroid. Nếu TestDevice không phải là Microdroid, hãy trả về giá trị 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 kết.
Truy vấn trực tiếp thiết bị nếu không có thông tin được lưu vào bộ nhớ đệm trong IDevice.
TODO: move this behavior to IDevice.getMountPoint(String)
| Tham số | |
|---|---|
mountName |
String: tên của điểm gắn |
| Giá trị trả về | |
|---|---|
String |
điểm gắn hoặc null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Trả về một MountPointInfo tương ứng với đường dẫn đến điểm gắn đã chỉ định hoặc null nếu đường dẫn đó không có gì được gắn hoặc không xuất hiện trong /proc/mounts dưới dạng một điểm gắn.
| Tham số | |
|---|---|
mountpoint |
String |
| Giá trị trả về | |
|---|---|
ITestDevice.MountPointInfo |
Một ERROR(/List) của MountPointInfo chứa thông tin trong "/proc/mounts" |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getMountPointInfo
publicgetMountPointInfo ()
Trả về phiên bản đã phân tích cú pháp của thông tin trong /proc/mounts trên thiết bị
| Giá trị trả về | |
|---|---|
|
Một ERROR(/List) của MountPointInfo chứa thông tin trong "/proc/mounts" |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getOptions
public TestDeviceOptions getOptions ()
Tìm nạp các lựa 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 thức trợ giúp để xác định lượng dung lượng trống trên phân vùng thiết bị.
| Tham số | |
|---|---|
partition |
String |
| Giá trị trả về | |
|---|---|
long |
lượng dung lượng trống tính bằng KB |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
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à giá trị 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 chạy lệnh "pidof" và "stat", đồng thời trả về đối tượng ProcessInfo có PID và thời gian bắt đầu xử lý của quy trình đã cho.
| Tham số | |
|---|---|
processName |
String: tên quy trình String. |
| Giá trị trả về | |
|---|---|
ProcessInfo |
ProcessInfo của processName đã cho |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getProcessPid
public String getProcessPid (String process)
Trả về pid của dịch vụ hoặc giá trị rỗng nếu có sự cố xảy ra.
| Tham số | |
|---|---|
process |
String: Chuỗi tên quy trình. |
| Giá trị trả về | |
|---|---|
String |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getProductType
public String getProductType ()
Phương thức thuận tiện để lấy loại sản phẩm của thiết bị này.
Phương thức này sẽ hoạt động nếu thiết bị ở chế độ adb hoặc fastboot.
| Giá trị trả về | |
|---|---|
String |
tên loại sản phẩm String. Không được rỗng |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getProductVariant
public String getProductVariant ()
Phương thức thuận tiện để lấy biến thể sản phẩm của thiết bị này.
Phương thức này sẽ hoạt động nếu thiết bị ở chế độ adb hoặc fastboot.
| Giá trị trả về | |
|---|---|
String |
tên biến thể sản phẩm String hoặc null nếu không xác định được |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getProperty
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 thuộc tính đó không tồn tại |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Lấy chế độ khôi phục hiện tại được dùng cho thiết bị.
| Giá trị trả về | |
|---|---|
ITestDevice.RecoveryMode |
chế độ khôi phục hiện tại được dùng cho thiết bị. |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Chụp ảnh màn hình từ thiết bị có mã nhận dạng màn hình đã cho. Định dạng là PNG.
CẦN LÀM: mở rộng các cách triển khai ở trên để hỗ trợ "format" (định dạng) và "rescale" (điều chỉnh tỷ lệ)
| Tham số | |
|---|---|
displayId |
long: mã nhận dạng 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 ảnh chụp màn hình không thành công. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getScreenshot
public InputStreamSource getScreenshot (String format)
Chụp ảnh màn hình thiết bị. Bạn nên sử dụng getScreenshot(format) thay vì mã hoá JPEG để có kích thước nhỏ hơn
| Tham số | |
|---|---|
format |
String: hỗ trợ PNG, JPEG |
| 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 |
|
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Chụp ảnh màn hình thiết bị. Bạn nên sử dụng getScreenshot(String) thay thế bằng phương thức mã hoá JPEG để có kích thước nhỏ hơn.
| Tham số | |
|---|---|
format |
String: hỗ trợ PNG, JPEG |
rescale |
boolean: nếu cần đổi tỷ lệ ảnh chụp màn hình để giảm kích thước của hình ảnh kết quả |
| 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 |
|
getScreenshot
public InputStreamSource getScreenshot ()
Chụp ảnh màn hình 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 |
getSetting
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 các giá trị sau: {"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 namespace:key của một người dùng. Giá trị rỗng nếu không tìm thấy. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getSetting
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à mạng của thẻ SIM hoặc giá trị rỗng nếu không có hoặc nếu thiết bị không có.
| Giá trị trả về | |
|---|---|
String |
|
getSimState
public String getSimState ()
Trả về trạng thái thẻ SIM hoặc giá trị rỗng nếu không có hoặc thiết bị không có.
| Giá trị trả về | |
|---|---|
String |
|
getTombstones
publicgetTombstones ()
Tìm nạp và trả về danh sách các tệp đánh dấu xoá khỏi thiết bị. Yêu cầu quyền truy cập vào thư mục gốc.
phương thức là phương thức cố gắng hết sức, vì vậy, nếu không thể kéo một bia đánh dấu nào vì bất kỳ lý do gì, thì bia đánh dấu đó sẽ bị thiếu trong danh sách. Chỉ có DeviceNotAvailableException mới kết thúc phương thức sớm.
| Giá trị trả về | |
|---|---|
|
Danh sách các tệp đánh dấu xoá, trống nếu không có tệp đánh dấu xoá. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getTotalMemory
public long getTotalMemory ()
Trả về tổng kích thước bộ nhớ vật lý tính bằng byte hoặc -1 trong trường hợp xảy ra lỗi nội bộ
| Giá trị trả về | |
|---|---|
long |
|
getTrackingSerial
public String getTrackingSerial ()
Để quản lý thiết bị, hãy lấy số sê-ri dùng để theo dõi thiết bị.
| Giá trị trả về | |
|---|---|
String |
|
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
Tìm nạp tên gói ứng dụng có thể gỡ cài đặt. Hiện tại, điều này được xác định 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 không thể gỡ cài đặt hiện được cài đặt trên thiết bị. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getUseFastbootErase
public boolean getUseFastbootErase ()
Lấy thông tin về việc có sử dụng lệnh xoá fastboot hay định dạng fastboot để xoá một phân vùng trên thiết bị hay không.
| Giá trị trả về | |
|---|---|
boolean |
true nếu bạn sẽ dùng lệnh xoá fastboot hoặc false nếu bạn sẽ dùng lệnh định dạng fastboot. |
getUserFlags
public int getUserFlags (int userId)
Tìm và trả về các cờ của một người dùng cụ thể. Các cờ được xác định trong lớp "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 đã cung cấp (nếu có), -10000 trong mọi trường hợp khác. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getUserInfos
publicgetUserInfos ()
Nhận Bản đồ useId thành 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 các đối tượng UserInfo. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
getUserSerialNumber
public int getUserSerialNumber (int userId)
Trả về số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong mọi trường hợp khác.
| Tham số | |
|---|---|
userId |
int |
| Giá trị trả về | |
|---|---|
int |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
handleAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Xử lý DeviceEvent đã cho. Có thể chuyển thiết bị sang trạng thái mới. Sẽ thông báo cho IDeviceMonitor về mọi trạng thái chuyển đổi.
Xử lý DeviceEvent, có thể hoặc không chuyển thiết bị này sang trạng thái phân bổ mới.
| Tham số | |
|---|---|
event |
DeviceEvent |
| Giá trị trả về | |
|---|---|
IManagedTestDevice.DeviceEventResponse |
|
hasFeature
public boolean hasFeature (String feature)
Kiểm tra xem một tính năng có dùng được trên thiết bị hay không.
| Tham số | |
|---|---|
feature |
String: định dạng phải là "feature: |
| Giá trị trả về | |
|---|---|
boolean |
Đúng nếu tìm thấy đối tượng, sai nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
initializeConnection
public void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Khởi tạo kết nối với thiết bị. Phương thức này được gọi bằng preInvocationSetup nhưng trong một số ít trường hợp, bạn có thể cần gọi riêng khi tạo kết nối trong quá trình thiết lập thiết bị.
| Tham số | |
|---|---|
info |
IBuildInfo |
attributes |
MultiMap |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
installPackage
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ài đặt |
reinstall |
boolean: true nếu cần thực hiện quy trình cài đặt lại |
extraArgs |
String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn 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 |
|
installPackage
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ỉ những 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 điểm cài đặt mới nên gọi hàm này.
| Tham số | |
|---|---|
packageFile |
File: tệp apk để cài đặt |
reinstall |
boolean: true nếu cần thực hiện quy trình cài đặt lại |
grantPermissions |
boolean: nếu tất cả các quyền trong thời gian chạy đều được cấp tại thời điểm cài đặt |
extraArgs |
String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn 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 |
|
installPackageForUser
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ài đặt |
reinstall |
boolean: true nếu cần thực hiện quy trình cài đặt lại |
userId |
int: mã nhận dạng người dùng là số nguyên để cài đặt. |
extraArgs |
String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn 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 |
|
installPackageForUser
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ỉ những 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 điểm cài đặt mới nên gọi hàm này.
| Tham số | |
|---|---|
packageFile |
File: tệp apk để cài đặt |
reinstall |
boolean: true nếu cần thực hiện quy trình cài đặt lại |
grantPermissions |
boolean: nếu tất cả các quyền trong thời gian chạy đều được cấp tại thời điểm cài đặt |
userId |
int: mã nhận dạng người dùng là số nguyên để cài đặt. |
extraArgs |
String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn 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 |
|
installPackageWithIncrementalMode
public boolean installPackageWithIncrementalMode (File[] apkFiles,
String[] extraArgs,
String userId)Cài đặt APK ở chế độ tăng dần.
| Tham số | |
|---|---|
apkFiles |
File: các tệp apk cần cài đặt. |
extraArgs |
String |
userId |
String |
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
| Giá trị trả về | |
|---|---|
boolean |
|
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc liệt kê ứng dụng hay không
| Giá trị trả về | |
|---|---|
boolean |
True nếu tính năng liệt kê ứng dụng được hỗ trợ, false nếu không |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc bỏ qua khối sdk mục tiêu thấp khi cài đặt ứng dụng hay không
| Giá trị trả về | |
|---|---|
boolean |
True nếu được hỗ trợ bỏ qua khối sdk mục tiêu thấp, false nếu không |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isDebugfsMounted
public boolean isDebugfsMounted ()
Kiểm tra xem debugfs đã được gắn hay chưa.
| Giá trị trả về | |
|---|---|
boolean |
true nếu debugfs được gắn |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isDeviceEncrypted
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, trả về false nếu không.
| Tham số | |
|---|---|
path |
String |
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isEnableAdbRoot
public boolean isEnableAdbRoot ()
| Giá trị trả về | |
|---|---|
boolean |
true nếu bạn nên bật quyền truy cập gốc adb trên thiết bị |
isEncryptionSupported
public boolean isEncryptionSupported ()
Trả về nếu thiết bị có hỗ trợ mã hoá.
| Giá trị trả về | |
|---|---|
boolean |
true nếu thiết bị hỗ trợ tính năng mã hoá. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isExecutable
public boolean isExecutable (String fullPath)
Trả về True nếu đường dẫn tệp trên thiết bị là một tệp thực thi, trả về false trong trường hợp ngược lại.
| Tham số | |
|---|---|
fullPath |
String |
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isFastbootEnabled
public boolean isFastbootEnabled ()
Trả về nếu thiết bị có chế độ khởi động nhanh.
| Giá trị trả về | |
|---|---|
boolean |
|
isHeadless
public boolean isHeadless ()
Trả về true nếu thiết bị không có màn hình, nếu không thì trả về false.
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Trả về xem 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 |
|
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Trả về giá trị cho biết người dùng chính có phải là quản trị viên vĩnh viễn hay không và không thể bị xoá hoặc hạ cấp xuống trạng thái không phải là quản trị viên.
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isMultiUserSupported
public boolean isMultiUserSupported ()
Xác định xem thiết bị có hỗ trợ nhiều người dùng hay không.
| Giá trị trả về | |
|---|---|
boolean |
true nếu được hỗ trợ nhiều người dùng, false nếu không |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)Truy vấn thiết bị theo một tên gói và mã nhận dạng người dùng nhất định để kiểm tra xem người dùng đó có đang cài đặt hay không.
| Tham số | |
|---|---|
packageName |
String: gói mà chúng ta đang kiểm tra xem đã cài đặt hay chưa. |
userId |
String: Mã nhận dạng người dùng mà chúng tôi đang kiểm tra xem gói đã được cài đặt hay chưa. Nếu giá trị này là rỗng, hệ thống sẽ dùng giá trị 0 của người dùng chính. |
| Giá trị trả về | |
|---|---|
boolean |
True nếu gói được báo cáo là đã cài đặt. Nếu không thì trả về giá trị false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Truy vấn thiết bị theo một tên gói nhất định để kiểm tra xem tên gói đó hiện đã được cài đặt hay chưa.
| Tham số | |
|---|---|
packageName |
String |
| Giá trị trả về | |
|---|---|
boolean |
True nếu gói được báo cáo là đã cài đặt. Nếu không thì trả về giá trị false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isRuntimePermissionSupported
public boolean isRuntimePermissionSupported ()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc cấp quyền trong thời gian chạy hay không
| Giá trị trả về | |
|---|---|
boolean |
True nếu quyền trong thời gian chạy được hỗ trợ, false nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Trả về true nếu thiết bị ở trạng thái TestDeviceState.FASTBOOT hoặc TestDeviceState.FASTBOOTD.
| Giá trị trả về | |
|---|---|
boolean |
|
isUserRunning
public boolean isUserRunning (int userId)
Kiểm tra xem một người dùng nhất định 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 |
|
isUserSecondary
public boolean isUserSecondary (int userId)
Trả về liệu người dùng được chỉ định có phải là người dùng phụ hay không theo các cờ của người dùng đó.
| Tham số | |
|---|---|
userId |
int |
| Giá trị trả về | |
|---|---|
boolean |
true nếu người dùng là người dùng phụ, ngược lại là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isUserVisible
public boolean isUserVisible (int userId)
Kiểm tra xem người dùng đã cho có hiển thị hay không.
Người dùng "có thể nhìn thấy" là người dùng đang tương tác với người dùng "thực" 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 |
|
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)Kiểm tra xem người dùng đã cho có xuất hiện trong màn hình đã cho hay không.
Người dùng "có thể nhìn thấy" là người dùng đang tương tác với người dùng "thực" và do đó có thể chạy các hoạt động khởi chạy trong màn hình đó.
| Tham số | |
|---|---|
userId |
int |
displayId |
int |
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Trả về việc thiết bị có cho phép người dùng bắt đầu thấy được trong 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 do listDisplayIdsForStartingVisibleBackgroundUsers() trả về (màn hình này phải có ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Trả về việc thiết bị có cho phép người dùng bắt đầu thấy được trong nền hay không.
Nếu có, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean), truyền một màn hình do listDisplayIdsForStartingVisibleBackgroundUsers() trả về.
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
isWifiEnabled
public boolean isWifiEnabled ()
Kiểm tra xem Wi-Fi đã bật hay chưa.
Kiểm tra xem thiết bị có bật Wi-Fi hay không. Hữu ích khi xác nhận trạng thái Wi-Fi trước các kiểm thử không nên chạy với Wi-Fi, ví dụ: kiểm thử dữ liệu di động.
| Giá trị trả về | |
|---|---|
boolean |
true nếu Wi-Fi đang bật. false nếu bị vô hiệu hoá |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
listDisplayIds
publiclistDisplayIds ()
Thu thập danh sách mã nhận dạng 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. Default luôn trả về màn hình mặc định 0. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Lấy danh sách các màn hình có thể dùng để start a user visible in the background.
| Giá trị trả về | |
|---|---|
|
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
listUsers
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 mã nhận dạng người dùng. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
logAnrs
public boolean logAnrs (ITestLogger logger)
Thu thập và ghi lại lỗi ANR trên thiết bị.
| Tham số | |
|---|---|
logger |
ITestLogger: một ITestLogger để ghi lại các lỗi ANR. |
| Giá trị trả về | |
|---|---|
boolean |
True nếu quá trình ghi nhật ký thành công, false nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)Phương thức trợ giúp để lấy một báo cáo lỗi và ghi báo cáo đó vào các báo cáo.
| Tham số | |
|---|---|
dataName |
String: tên mà theo đó bugreport sẽ được báo cáo. |
listener |
ITestLogger: một 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, false nếu không. |
logOnDevice
public void logOnDevice (String tag,
Log.LogLevel level,
String format,
Object... args)Ghi nhật ký một thông báo trong logcat của thiết bị. Đây là một lệnh gọi an toàn và sẽ không gửi ngay cả khi quá trình ghi nhật ký không thành công.
| Tham số | |
|---|---|
tag |
String: Thẻ mà chúng ta dùng để ghi thông báo vào logcat. |
level |
Log.LogLevel: Cấp gỡ lỗi của thông báo trong logcat. |
format |
String: Định dạng thư. |
args |
Object: các đối số sẽ được thay thế thông qua String.format(). |
nonBlockingReboot
public void nonBlockingReboot ()
Đưa ra lệnh khởi động lại thiết bị và trả về khi lệnh hoàn tất và khi thiết bị không còn xuất hiện trên adb nữa.
| Gửi | |
|---|---|
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 khi adb root và trước khi thiết bị kết nối lại. Phương thức triển khai mặc định không bao gồm bất kỳ thao tác bổ sung nào. adb root không đảm bảo được bật ở 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 adb unroot và trước khi thiết bị kết nối lại với mạng. Hoạt động triển khai mặc định không bao gồm bất kỳ thao tác bổ sung nào. Không đảm bảo rằng adb root sẽ bị vô hiệu hoá ở giai đoạn này.
| Gửi | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
postBootSetup
public void postBootSetup ()
Thực hiện hướng dẫn để định cấu hình thiết bị cho việc kiểm thử sau mỗi lần khởi động.
Phải được gọi sau khi thiết bị khởi động/sẵn sàng hoàn toàn
Trong trường hợp bình thường, bạn không cần gọi phương thức này một cách rõ ràng, vì các hoạt động triển khai sẽ tự động thực hiện các bước này khi khởi động lại.
Bạn có thể cần gọi lệnh này khi thiết bị khởi động lại do các sự kiện khác (ví dụ: khi lệnh cập nhật fastboot đã hoàn tất)
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Các bước bổ sung để dọn dẹp bắt buộc theo từng thiết bị cụ thể sẽ được thực thi sau khi hoàn tất lệnh gọi.
| Tham số | |
|---|---|
exception |
Throwable: nếu có, ngoại lệ cuối cùng do lỗi gọi gây ra. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Các bước bổ sung cho chế độ thiết lập bắt buộc dành riêng cho thiết bị sẽ được thực thi trên thiết bị trước quy trình gọi.
| Tham số | |
|---|---|
info |
IBuildInfo: IBuildInfo của thiết bị. |
attributes |
MultiMap: Các thuộc tính được lưu trữ trong ngữ cảnh gọi |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
pullDir
public boolean pullDir (String deviceFilePath,
File localDir,
int userId)Truy xuất nội dung thư mục từ thiết bị theo cách đệ quy.
| Tham số | |
|---|---|
deviceFilePath |
String: đường dẫn tuyệt đối đến tệp của nguồn từ xa |
localDir |
File: thư mục cục bộ để kéo tệp vào |
userId |
int: mã người dùng cần lấy |
| Giá trị trả về | |
|---|---|
boolean |
true nếu tệp được kéo thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pullDir
public boolean pullDir (String deviceFilePath,
File localDir)Truy xuất nội dung thư mục từ thiết bị theo cách đệ quy.
| Tham số | |
|---|---|
deviceFilePath |
String: đường dẫn tuyệt đối đến tệp của nguồn từ xa |
localDir |
File: thư mục cục bộ để kéo tệp vào |
| Giá trị trả về | |
|---|---|
boolean |
true nếu tệp được kéo thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public boolean pullFile (String remoteFilePath,
File localFile)Truy xuất một tệp khỏi thiết bị.
| Tham số | |
|---|---|
remoteFilePath |
String: đường dẫn tuyệt đối đến tệp trên thiết bị. |
localFile |
File: tệp cục bộ để lưu trữ nội dung. Nếu không trống, nội dung sẽ được thay thế. |
| Giá trị trả về | |
|---|---|
boolean |
true nếu truy xuất tệp thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public File pullFile (String remoteFilePath,
int userId)Truy xuất một tệp khỏi thiết bị, lưu trữ tệp đó trong ERROR(/File) tạm thời cục bộ và trả về File đó.
| Tham số | |
|---|---|
remoteFilePath |
String: đường dẫn tuyệt đối đến tệp trên thiết bị. |
userId |
int: Mã nhận dạng người dùng cần lấy |
| Giá trị trả về | |
|---|---|
File |
ERROR(/File) chứa nội dung của tệp thiết bị hoặc null nếu bản sao không thành công vì bất kỳ lý do nào (kể cả vấn đề với hệ thống tệp máy chủ) |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public File pullFile (String remoteFilePath)
Truy xuất một tệp khỏi thiết bị, lưu trữ tệp đó trong ERROR(/File) tạm thời cục bộ và trả về File đó.
| Tham số | |
|---|---|
remoteFilePath |
String: đường dẫn tuyệt đối đến tệp trên thiết bị. |
| Giá trị trả về | |
|---|---|
File |
ERROR(/File) chứa nội dung của tệp thiết bị hoặc null nếu bản sao không thành công vì bất kỳ lý do nào (kể cả vấn đề với hệ thống tệp máy chủ) |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public boolean pullFile (String remoteFilePath,
File localFile,
int userId)Truy xuất một tệp khỏi thiết bị.
| Tham số | |
|---|---|
remoteFilePath |
String: đường dẫn tuyệt đối đến tệp trên thiết bị. |
localFile |
File: tệp cục bộ để lưu trữ nội dung. Nếu không trống, nội dung sẽ được thay thế. |
userId |
int: Mã nhận dạng người dùng cần lấy |
| Giá trị trả về | |
|---|---|
boolean |
true nếu truy xuất tệp thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pullFileContents
public String pullFileContents (String remoteFilePath)
Truy xuất một tệp trên thiết bị và trả về nội dung.
| Tham số | |
|---|---|
remoteFilePath |
String: đường dẫn tuyệt đối đến tệp trên thiết bị. |
| Giá trị trả về | |
|---|---|
String |
String chứa nội dung của tệp thiết bị hoặc null nếu bản sao không thành công vì bất kỳ lý do nào (kể cả vấn đề với hệ thống tệp máy chủ) |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
Một phương thức thuận tiện để truy xuất một tệp từ bộ nhớ ngoài của thiết bị, lưu trữ tệp đó trong ERROR(/File) tạm thời cục bộ và trả về một thông tin tham chiếu đến File đó.
| Tham số | |
|---|---|
remoteFilePath |
String: đường dẫn đến tệp trên thiết bị, tương ứng với điểm gắn kết bộ nhớ ngoài của thiết bị |
| Giá trị trả về | |
|---|---|
File |
ERROR(/File) chứa nội dung của tệp thiết bị hoặc null nếu bản sao không thành công vì bất kỳ lý do nào (kể cả vấn đề với hệ thống tệp máy chủ) |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath,
excludedDirectories) Đẩy nội dung thư mục một cách đệ quy vào thiết bị trong khi loại trừ một số thư mục được lọc.
| Tham số | |
|---|---|
localFileDir |
File: thư mục cục bộ để đẩy |
deviceFilePath |
String: đường dẫn tuyệt đối đến tệp của đích đến từ xa |
excludedDirectories |
: Tập hợp các tên thư mục bị loại trừ không được đẩy. |
| Giá trị trả về | |
|---|---|
boolean |
true nếu tệp được truyền thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath)Đẩy nội dung thư mục vào thiết bị theo cách đệ quy.
| Tham số | |
|---|---|
localFileDir |
File: thư mục cục bộ để đẩy |
deviceFilePath |
String: đường dẫn tuyệt đối đến tệp của đích đến từ xa |
| Giá trị trả về | |
|---|---|
boolean |
true nếu tệp được truyền thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath,
int userId)Đẩy nội dung thư mục vào thiết bị theo cách đệ quy.
| Tham số | |
|---|---|
localFileDir |
File: thư mục cục bộ để đẩy |
deviceFilePath |
String: đường dẫn tuyệt đối đến tệp của đích đến từ xa |
userId |
int: mã nhận dạng người dùng để đẩy đến |
| Giá trị trả về | |
|---|---|
boolean |
true nếu tệp được truyền thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pushFile
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 của nhà cung cấp nội dung (không bắt buộc).
| Tham số | |
|---|---|
localFile |
File: tệp cục bộ cần đẩy |
remoteFilePath |
String: đường dẫn tuyệt đối đến tệp đích từ xa |
evaluateContentProviderNeeded |
boolean: liệu có cần kiểm tra xem chúng tôi có cần nhà cung cấp nội dung hay không |
| Giá trị trả về | |
|---|---|
boolean |
true nếu tệp được truyền thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pushFile
public boolean pushFile (File localFile,
String remoteFilePath)Đẩy một tệp đến thiết bị. Theo mặc định, sử dụng một trình cung cấp nội dung.
| Tham số | |
|---|---|
localFile |
File: tệp cục bộ cần đẩy |
remoteFilePath |
String: đường dẫn tuyệt đối đến tệp đích từ xa |
| Giá trị trả về | |
|---|---|
boolean |
true nếu tệp được truyền thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pushFile
public boolean pushFile (File localFile,
String remoteFilePath,
int userId)Đẩy một tệp đến thiết bị. Theo mặc định, sử dụng một trình cung cấp nội dung.
| Tham số | |
|---|---|
localFile |
File: tệp cục bộ cần đẩy |
remoteFilePath |
String: đường dẫn tuyệt đối đến tệp đích từ xa |
userId |
int: mã người dùng để đẩy đến |
| Giá trị trả về | |
|---|---|
boolean |
true nếu tệp được truyền thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
pushString
public boolean pushString (String contents,
String remoteFilePath)Đẩy tệp được tạo từ một chuỗi sang thiết bị
| Tham số | |
|---|---|
contents |
String: nội dung của tệp cần đẩy |
remoteFilePath |
String: đường dẫn tuyệt đối đến tệp đích từ xa |
| Giá trị trả về | |
|---|---|
boolean |
true nếu chuỗi được đẩy thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
khởi động lại
public void reboot (String reason)
Khởi động lại thiết bị ở chế độ adb với reason đã cho để duy trì trong quá trình khởi động lại.
Chặn cho đến khi thiết bị có sẵn.
Bạn có thể truy vấn thuộc tính sys.boot.reason để biết lý do khởi động lại lần gần đây nhất.
| Tham số | |
|---|---|
reason |
String: lý do cho lần khởi động lại này hoặc null nếu không có lý do nào được chỉ định. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
khởi động lại
public void reboot ()
Khởi động lại thiết bị ở chế độ adb.
Chặn cho đến khi thiết bị có sẵn.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoBootloader
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 |
|
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Khởi động lại thiết bị ở chế độ fastbootd.
Chặn cho đến khi thiết bị ở chế độ fastbootd.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoRecovery
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 chế độ khôi phục
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoSideload
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à một chế độ đặc biệt trong chế độ khôi phục)
Chặn cho đến khi thiết bị chuyển sang chế độ tải qua một bên
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoSideload
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à một chế độ đặc biệt trong chế độ khôi phục)
Chặn cho đến khi thiết bị chuyển sang chế độ tải qua một bên
| Tham số | |
|---|---|
autoReboot |
boolean: có tự động khởi động lại thiết bị sau khi cài đặt từ nguồn bên ngoài hay không |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
rebootUntilOnline
public void rebootUntilOnline ()
Một lựa chọn thay thế cho reboot(), chỉ chặn cho đến khi thiết bị kết nối mạng, tức là adb có thể nhìn thấy.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
rebootUntilOnline
public void rebootUntilOnline (String reason)
Một lựa chọn thay thế cho reboot(), chỉ chặn cho đến khi thiết bị kết nối mạng, tức là adb có thể nhìn thấy.
| Tham số | |
|---|---|
reason |
String: lý do cho lần khởi động lại này hoặc null nếu không có lý do nào được chỉ định. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
rebootUserspace
public void rebootUserspace ()
Chỉ khởi động lại phần không gian người dùng của thiết bị.
Chặn cho đến khi thiết bị có sẵn.
CẢNH BÁO. Tính năng khởi động lại không gian người dùng hiện đang trong quá trình phát triển, hãy tự chịu rủi ro khi sử dụng.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
Một lựa chọn thay thế cho rebootUserspace() ()} chỉ chặn cho đến khi thiết bị trực tuyến, tức là có thể thấy được đối với adb.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
recoverDevice
public boolean recoverDevice ()
Cố gắng khôi phục giao tiếp với thiết bị.
| Giá trị trả về | |
|---|---|
boolean |
True nếu quá trình khôi phục đã được thực hiện 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 dùng được nữa |
registerDeviceActionReceiver
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 một thao tác trên thiết bị bắt đầu và sau khi thao tác đó kết thúc.
| Tham số | |
|---|---|
deviceActionReceiver |
IDeviceActionReceiver: Một IDeviceActionReceiver sẽ được đăng ký. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Chuyển phân vùng hệ thống trên thiết bị sang chế độ chỉ đọc. Có thể khởi động lại thiết bị.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
remountSystemWritable
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 |
|
remountVendorReadOnly
public void remountVendorReadOnly ()
Thiết lập phân vùng nhà cung cấp trên thiết bị ở chế độ chỉ đọc. Có thể khởi động lại thiết bị.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
remountVendorWritable
public void remountVendorWritable ()
Cho phép ghi vào phân vùng nhà cung cấp trên thiết bị. Có thể khởi động lại thiết bị.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
removeAdmin
public boolean removeAdmin (String componentName,
int userId)Xoá quản trị viên thiết bị đã cho trong người dùng đã cho và trả về true nếu thành công, false nếu không.
| Tham số | |
|---|---|
componentName |
String: của quản trị viên thiết bị cần xoá. |
userId |
int: của người dùng mà quản trị viên thiết bị đang sử dụng. |
| Giá trị trả về | |
|---|---|
boolean |
True nếu thành công, false nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
removeOwners
public void removeOwners ()
Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có bằng mọi cách có thể.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
removeUser
public boolean removeUser (int userId)
Xoá một người dùng nhất định khỏi thiết bị.
| Tham số | |
|---|---|
userId |
int: của người dùng cần xoá |
| Giá trị trả về | |
|---|---|
boolean |
true nếu chúng ta xoá người dùng thành công, false nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
resetContentProviderSetup
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ờ này.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Phương thức thuận tiện để thực hiện ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) với một hoặc nhiều trình nghe được truyền dưới dạng tham số.
| Tham số | |
|---|---|
runner |
IRemoteAndroidTestRunner: IRemoteAndroidTestRunner chạy các kiểm thử |
listeners |
ITestLifeCycleReceiver: (các) trình nghe kết quả kiểm thử |
| Giá trị trả về | |
|---|---|
boolean |
true nếu lệnh kiểm thử đã hoàn tất. false nếu không hoàn tất được nhưng đã khôi phục thành công |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Chạy kiểm thử đo lường và cung cấp khả năng khôi phục thiết bị.
Nếu mất kết nối với thiết bị trước khi quá trình chạy thử nghiệm hoàn tất và quá trình khôi phục thành công, thì tất cả các trình nghe sẽ được thông báo về testRunFailed và "false" sẽ được trả về. Lệnh kiểm thử sẽ không chạy lại. Người gọi có thể thử lại nếu cần.
Nếu mất kết nối với thiết bị trước khi quá trình chạy thử nghiệm hoàn tất và quá trình khôi phục không thành công, thì tất cả các trình nghe sẽ được thông báo về testRunFailed và DeviceNotAvailableException sẽ được gửi.
| Tham số | |
|---|---|
runner |
IRemoteAndroidTestRunner: IRemoteAndroidTestRunner chạy các kiểm thử |
listeners |
: trình nghe kết quả kiểm thử |
| Giá trị trả về | |
|---|---|
boolean |
true nếu lệnh kiểm thử đã hoàn tất. false nếu không hoàn tất được do ngoại lệ giao tiếp của thiết bị, nhưng đã khôi phục thành công |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Tương tự như ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) nhưng chạy thử nghiệm cho người dùng đã cho.
| Tham số | |
|---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Tương tự như ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...) nhưng chạy kiểm thử cho một người dùng cụ thể.
| Tham số | |
|---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
setAdbPath
public void setAdbPath (String adbPath)
Đặt đường dẫn đến tệp nhị phân adb sẽ được dùng.
| Tham số | |
|---|---|
adbPath |
String |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Chèn IConfiguration đang dùng.
| Tham số | |
|---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
| Tham số | |
|---|---|
avdInfo |
GceAvdInfo |
setDate
public void setDate (Date date)
Đặt ngày trên thiết bị
Lưu ý: bạn cần có quyền truy cập vào hệ thống để đặt ngày trên thiết bị
| Tham số | |
|---|---|
date |
Date: chỉ định một ngày cụ thể; sẽ sử dụng ngày của máy chủ nếu null |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)Đặt một thành phần quản trị thiết bị làm chủ sở hữu thiết bị cho người dùng đã cho.
| Tham số | |
|---|---|
componentName |
String: của quản trị viên thiết bị thành chủ sở hữu thiết bị. |
userId |
int: của người dùng mà chủ sở hữu thiết bị sinh sống. |
| Giá trị trả về | |
|---|---|
boolean |
True nếu thành công, false nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
setDeviceState
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 để ghi nhật ký đầu ra
| Tham số | |
|---|---|
output |
SizeLimitedOutputStream: để ghi lại đầu ra |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Đặt Process khi thiết bị này là một trình mô phỏng.
| Tham số | |
|---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Đặt lựa chọn fastboot cho thiết bị. Bạn nên đặt khi thiết bị được phân bổ lần đầu.
| Tham số | |
|---|---|
fastbootEnabled |
boolean: thiết bị có hỗ trợ fastboot hay không |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Đặt đường dẫn đến tệp nhị phân fastboot sẽ được dùng.
Bạn vẫn cần đặt isFastbootEnabled() thành true để bật các chức năng fastboot.
| Tham số | |
|---|---|
fastbootPath |
String |
setIDevice
public void setIDevice (IDevice newDevice)
Cập nhật IDevice được liên kết với ITestDevice này.
IDevice mới phải tham chiếu đến cùng một 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 ghi lại 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 adb root là true.
| Tham số | |
|---|---|
propKey |
String: Khoá được nhắm đến để đặt. |
propValue |
String: Giá trị thuộc tính cần đặt. |
| Giá trị trả về | |
|---|---|
boolean |
trả về True nếu lệnh setprop thành công, nếu không thì trả về False. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Đặt IDeviceRecovery để sử dụng cho thiết bị này. Bạn nên đặt khi thiết bị được phân bổ lần đầu.
| Tham số | |
|---|---|
recovery |
IDeviceRecovery: IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Đặt chế độ khôi phục hiện tại để sử dụng cho thiết bị.
Dùng để kiểm soát phương thức khôi phục sẽ dùng khi gặp phải vấn đề về giao tiếp của thiết bị. Bạn chỉ nên sử dụng phương thức này một cách hạn chế khi cần (ví dụ: khi khung gặp sự cố, v.v.)
| Tham số | |
|---|---|
mode |
ITestDevice.RecoveryMode: có nên bật chế độ "chỉ khôi phục cho đến khi trực tuyến" hay không. |
setSetting
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 |
|
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)Thêm giá trị chế độ cài đặt vào không gian tên của một người dùng nhất định. Một số chế độ cài đặt sẽ chỉ dùng được sau khi khởi động lại. không gian tên phải là một trong các giá trị sau: {"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 tôi dùng để tham chiếu thiết bị.
| Tham số | |
|---|---|
trackingSerial |
String |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
Đặt xem có sử dụng lệnh fastboot erase hay fastboot format để xoá một phân vùng trên thiết bị hay không.
| Tham số | |
|---|---|
useFastbootErase |
boolean: true nếu bạn nên sử dụng lệnh xoá fastboot hoặc false nếu bạn nên sử dụng lệnh định dạng fastboot. |
startLogcat
public void startLogcat ()
Bắt đầu ghi lại đầu ra logcat từ thiết bị ở chế độ nền.
Sẽ không có hiệu lực nếu đầu ra logcat đã được ghi lại. Sau này, bạn có thể truy xuất dữ liệu thông qua getLogcat.
Khi không còn sử dụng thiết bị nữa, bạn phải gọi stopLogcat().
startLogcat() và stopLogcat() thường không cần được gọi khi nằm trong ngữ cảnh gọi TF, vì khung TF sẽ bắt đầu và dừng logcat.
startTradeInModeTesting
public boolean startTradeInModeTesting (int timeoutMs)
Bật chế độ kiểm thử giao dịch thu cũ đổi mới. Thiết bị sẽ bị xoá sạch dữ liệu và khởi động lại.
| Tham số | |
|---|---|
timeoutMs |
int |
| Giá trị trả về | |
|---|---|
boolean |
True nếu thành công, false nếu không |
| Gửi | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
startUser
public boolean startUser (int userId)
Khởi động một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang dừng. Nếu người dùng đã chạy ở chế độ nền, thì phương thức này sẽ là NOOP.
| Tham số | |
|---|---|
userId |
int: của người dùng để bắt đầu ở chế độ nền |
| Giá trị trả về | |
|---|---|
boolean |
true nếu người dùng đã bắt đầu thành công trong nền. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
startUser
public boolean startUser (int userId,
boolean waitFlag)Khởi động một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang dừng. Nếu người dùng đã chạy ở chế độ nền, thì phương thức này sẽ là NOOP. Có thể cung cấp cờ bổ sung để chờ hoạt động có hiệu lực.
| Tham số | |
|---|---|
userId |
int: của người dùng để bắt đầu ở chế độ nền |
waitFlag |
boolean: sẽ khiế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 đã bắt đầu thành công trong nền. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)Khởi động một người dùng nhất định ở chế độ nền, hiển thị trong 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 hay không, có màn hình hay không, device supports such feature, v.v.
| Tham số | |
|---|---|
userId |
int: của người dùng để bắt đầu ở chế độ nền |
displayId |
int: màn hình để bắt đầu hiển thị cho người dùng |
waitFlag |
boolean: sẽ khiế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 đã bắt đầu thành công và có thể thấy trong nền. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
stopEmulatorOutput
public void stopEmulatorOutput ()
Đóng và xoá đầu ra của trình mô phỏng.
stopLogcat
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 được lưu.
Sẽ không có hiệu lực nếu đầu ra logcat không được ghi lại.
stopTradeInModeTesting
public void stopTradeInModeTesting ()
Dừng thử nghiệm chế độ đổi cũ lấy mới.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
stopUser
public boolean stopUser (int userId)
Dừng một người dùng cụ thể. Nếu người dùng đã dừng, phương thức này sẽ 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: của người dùng cần dừng. |
| Giá trị trả về | |
|---|---|
boolean |
true nếu người dùng đã dừng thành công. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)Dừng một người dùng cụ thể. Có thể cung cấp các cờ bổ sung để chờ thao tác có hiệu lực và buộc người dùng chấm dứt. 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: của người dùng cần dừng. |
waitFlag |
boolean: sẽ khiến lệnh chờ cho đến khi người dùng dừng. |
forceFlag |
boolean: sẽ buộc người dùng dừng. |
| Giá trị trả về | |
|---|---|
boolean |
true nếu người dùng đã 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 chuyển được thiết bị |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
switchToAdbUsb
public boolean switchToAdbUsb ()
Chuyển thiết bị sang chế độ adb qua USB.
| Giá trị trả về | |
|---|---|
boolean |
true nếu chuyển đổi thành công, false nếu không. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
switchUser
public boolean switchUser (int userId)
Chuyển sang một userId khác với thời gian chờ mặc định. switchUser(int, long).
| Tham số | |
|---|---|
userId |
int |
| Giá trị trả về | |
|---|---|
boolean |
Giá trị là true nếu userId mới khớp với nhà cung cấp userId. Nếu không thì trả về giá trị false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
switchUser
public boolean switchUser (int userId,
long timeout)Chuyển sang một userId khác với thời gian chờ đã cho làm thời hạn. Thử tắt khoá màn hình sau khi người dùng thay đổi thành công.
| Tham số | |
|---|---|
userId |
int |
timeout |
long: để chờ trước khi trả về giá trị false cho trường hợp chuyển đổi người dùng không thành công. |
| Giá trị trả về | |
|---|---|
boolean |
Giá trị là true nếu userId mới khớp với nhà cung cấp userId. Nếu không thì trả về giá trị false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
syncFiles
public boolean syncFiles (File localFileDir,
String deviceFilePath)Đồng bộ hoá nội dung của một thư mục tệp cục bộ với thiết bị theo từng bước.
Quyết định những tệp cần đẩy bằng cách so sánh dấu thời gian của các tệp cục bộ với các tệp tương đương từ xa. Chỉ những tệp "mới hơn" hoặc không tồn tại mới được chuyển đến thiết bị. Do đó, mức hao tổn sẽ tương đối nhỏ nếu bộ tệp trên thiết bị đã được cập nhật.
Các tệp ẩn (có tên bắt đầu bằng ".") sẽ bị bỏ qua.
Ví dụ về cách sử dụng: syncFiles("/tmp/files", "/sdcard") sẽ tạo thư mục /sdcard/files nếu thư mục này chưa tồn tại và đẩy đệ quy nội dung /tmp/files vào /sdcard/files.
| Tham số | |
|---|---|
localFileDir |
File: thư mục tệp cục bộ chứa các tệp cần đẩy đệ quy. |
deviceFilePath |
String: đường dẫn tuyệt đối đến thư mục gốc của tệp đích từ xa. Bạn phải đọc được tất cả các thư mục trong đường dẫn tệp đó. Tức là việc đẩy đến /data/local/tmp khi adb không phải là gốc sẽ không thành công |
| Giá trị trả về | |
|---|---|
boolean |
true nếu các tệp được đồng bộ hoá thành công. Nếu không thì là false. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
takeBugreport
public Bugreport takeBugreport ()
Lấy một báo cáo lỗi và trả về báo cáo đó trong một đố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 Bugreport thông qua Bugreport.close().
| Giá trị trả về | |
|---|---|
Bugreport |
|
uninstallPackage
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 |
|
uninstallPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)Gỡ cài đặt một gói Android khỏi thiết bị cho một người dùng nhất định.
| 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 |
|
unlockDevice
public boolean unlockDevice ()
Mở khoá thiết bị nếu thiết bị đang ở trạng thái được mã hoá.
Phương thức này có thể khởi động lại khung nhưng sẽ không gọipostBootSetup(). Do đó, thiết bị có thể chưa sẵn sàng hoàn toàn để được kiểm thử khi phương thức này trả về.
| Giá trị trả về | |
|---|---|
boolean |
true nếu thành công hoặc nếu thiết bị không được mã hoá. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Chặn cho đến khi cờ hoàn tất quá trình khởi động của thiết bị được đặt.
| Tham số | |
|---|---|
timeOut |
long: thời gian chờ tính bằng mili giây để đặt cờ |
| Giá trị trả về | |
|---|---|
boolean |
true nếu cờ hoàn tất quy trình khởi động của thiết bị được đặt trong thời gian chờ |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Chờ thiết bị phản hồi và sẵn sàng cho việc kiểm thử. Sử dụng thời gian chờ mặc định.
| Giá trị trả về | |
|---|---|
boolean |
True nếu thiết bị có sẵn, False nếu chế độ khôi phục bị tắt và không dùng được. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Chờ thiết bị phản hồi và sẵn sàng cho việc kiểm thử.
| Tham số | |
|---|---|
waitTime |
long: thời gian chờ tính bằng mili giây |
| Giá trị trả về | |
|---|---|
boolean |
True nếu thiết bị có sẵn, False nếu chế độ khôi phục bị tắt và không dùng được. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Chờ thiết bị phản hồi và có sẵn mà không cần xem xét đường dẫn khôi phục.
| Tham số | |
|---|---|
waitTime |
long |
| Giá trị trả về | |
|---|---|
boolean |
True nếu thiết bị có sẵn, False nếu không có sẵn. |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Chặn cho đến khi thiết bị xuất hiện qua fastboot. Sử dụng thời gian chờ mặc định.
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Các khối để thiết bị ở trạng thái "adb recovery" (lưu ý rằng trạng thái này khác với IDeviceRecovery).
| Tham số | |
|---|---|
waitTime |
long: thời gian chờ tính bằng mili giây |
| Giá trị trả về | |
|---|---|
boolean |
true nếu thiết bị khởi động vào chế độ khôi phục trước khi hết thời gian.
Nếu không thì là false |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Chặn thiết bị ở trạng thái "adb sideload"
| Tham số | |
|---|---|
waitTime |
long: thời gian chờ tính bằng mili giây |
| Giá trị trả về | |
|---|---|
boolean |
true nếu thiết bị khởi động vào chế độ cài đặt không qua cửa hàng trước khi hết thời gian. Nếu không thì là false
|
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Các khối để thiết bị không hoạt động, tức là không có trong adb
| Tham số | |
|---|---|
waitTime |
long: thời gian chờ tính bằng mili giây |
| Giá trị trả về | |
|---|---|
boolean |
true nếu thiết bị không hoạt động trước khi hết thời gian.
Nếu không thì là false |
waitForDeviceOnline
public void waitForDeviceOnline ()
Chặn cho đến khi thiết bị hiển thị qua adb. Sử dụng thời gian chờ mặc định
Xin lưu ý rằng thiết bị có thể không phản hồi các lệnh sau khi hoàn tất. Thay vào đó, hãy sử dụng waitForDeviceAvailable().
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
Chặn cho đến khi thiết bị hiển thị qua adb.
Xin lưu ý rằng thiết bị có thể không phản hồi các lệnh sau khi hoàn tất. Thay vào đó, hãy sử dụng waitForDeviceAvailable().
| Tham số | |
|---|---|
waitTime |
long: thời gian chờ tính bằng mili giây |
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Chờ thiết bị phản hồi một lệnh cơ bản của adb shell.
| Tham số | |
|---|---|
waitTime |
long: thời gian chờ tính bằng mili giây |
| Giá trị trả về | |
|---|---|
boolean |
true nếu thiết bị phản hồi trước khi waitTime trôi qua. |
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 lệnh adb shell và các đối số đã cho
| 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 |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Tạo một 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 lần 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 đã tạo. |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Thực hiện lệnh khởi động lại adb.
| Tham số | |
|---|---|
rebootMode |
NativeDevice.RebootMode: một chế độ của lần 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 |
|
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
phương thức trợ giúp để đưa ra ngoại lệ nếu không hỗ trợ quyền trong thời gian chạy
| Gửi | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getApiLevelSafe
protected int getApiLevelSafe ()
| Giá trị trả về | |
|---|---|
int |
|
getRunUtil
protected IRunUtil getRunUtil ()
Lấy thực thể RunUtil để sử dụng.
| Giá trị trả về | |
|---|---|
IRunUtil |
|
internalGetProperty
protected String internalGetProperty (String propName,
String fastbootVar,
String description)Tìm nạp một thuộc tính thiết bị, theo mặc định là từ bộ nhớ đệm ddmlib và quay lại "adb shell getprop" hoặc "fastboot getvar" tuỳ thuộc vào việc thiết bị có ở 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 fastboot tương đương cần truy vấn. nếu null, thì fastboot sẽ không cố gắng truy vấn |
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 |
|
isInRebootCallback
protected boolean isInRebootCallback ()
Trả về trạng thái cho biết lệnh gọi lại khởi động lại có đang được thực thi hay không. Tất cả các API công khai để khởi động lại đều phải bị vô hiệu hoá nếu đúng.
| Giá trị trả về | |
|---|---|
boolean |
|
isNewer
protected boolean isNewer (File localFile,
IFileEntry entry)Trả về true nếu tệp cục bộ mới hơn tệp từ xa. IFileEntry chính xác đến từng phút. Trong trường hợp 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 |
|
notifyRebootEnded
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 |
|
notifyRebootStarted
protected void notifyRebootStarted ()
Thông báo cho tất cả IDeviceActionReceiver về sự kiện bắt đầu khởi động lại.
| Gửi | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
performDeviceAction
protected boolean performDeviceAction (String actionDescription,
NativeDevice.DeviceAction action,
int retryAttempts)Thực hiện một thao tác trên thiết bị này. Cố gắng khôi phục thiết bị và tuỳ ý thử lại lệnh nếu thao tác không thành công.
| Tham số | |
|---|---|
actionDescription |
String: nội dung mô tả ngắn về hành động cần thực hiện. Chỉ dùng cho mục đích ghi nhật ký. |
action |
NativeDevice.DeviceAction: hành động cần thực hiện |
retryAttempts |
int: số lần thử lại để thực hiện hành động nếu hành động đó không thành công nhưng quá trình khôi phục thành công |
| Giá trị trả về | |
|---|---|
boolean |
true nếu thao tác được thực hiện thành công |
| Gửi | |
|---|---|
DeviceNotAvailableException |
nếu không khôi phục được hoặc đã thử tối đa số lần mà không thành công |
postAdbReboot
protected void postAdbReboot (NativeDevice.RebootMode rebootMode)
Các thao tác bổ sung có thể thực hiện sau khi khởi động lại.
| Tham số | |
|---|---|
rebootMode |
NativeDevice.RebootMode |
| Gửi | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
prePostBootSetup
protected void prePostBootSetup ()
Cho phép từng loại thiết bị (AndroidNativeDevice, TestDevice) ghi đè phương thức này để thiết lập cụ thể sau khi khởi động.
| Gửi | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath,
File localFile)| Tham số | |
|---|---|
remoteFilePath |
String |
localFile |
File |
| Giá trị trả về | |
|---|---|
boolean |
|
| Gửi | |
|---|---|
DeviceNotAvailableException |
|
setClock
protected void setClock (Clock clock)
Đặt phiên bản Đồng hồ để sử dụng.
| Tham số | |
|---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Đánh dấu TestDevice là microdroid và đặt CID của thiết bị.
| Tham số | |
|---|---|
process |
Process: Quy trình của Microdroid VM. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
| Tham số | |
|---|---|
deviceOptions |
|
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Thực thi một lệnh fastboot đơn giản bằng các biến môi trường và báo cáo trạng thái của lệnh.
| Tham số | |
|---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
| Giá trị trả về | |
|---|---|
CommandResult |
|
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Thực thi một lệnh fastboot đơ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 |
|
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc,
long time)Chờ cho đến khi thiết bị không hoạt động (ngừng báo cáo cho adb).
| Tham số | |
|---|---|
operationDesc |
String: Tên của thao tác đang chờ không có sẵn. |
time |
long: Thời gian chờ cho đến khi trạng thái không có sẵn xảy ra. |
| Giá trị trả về | |
|---|---|
boolean |
Đúng nếu thiết bị không hoạt động. |