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 ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) để chạy lệnh "adb ...." của hệ điều hành. 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) để khởi động lại thiết bị. 

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 TestDevice.

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( wifiSsidToPsk, boolean scanSsid)

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( wifiSsidToPsk)

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 connectToWifiNetwork(String, String) chỉ kết nối nếu thiết bị hiện không có kết nối mạng.

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.

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á IDeviceActionReceiver đã đăng ký.

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.

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.

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, 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.

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, 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.

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( 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.

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.

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 được điền đúng cách bằng đầu ra trạng thái lệnh, stdout và stderr.

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 được điền đúng cách bằng đầu ra trạng thái lệnh và stderr.

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.

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 đã 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.

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.

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.

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ề ContentProviderHandler hoặc giá trị rỗng nếu không có sẵn.

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 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ế.

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ế.

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 ERROR(/Date) nhất định.

InputStreamSource getEmulatorOutput()

Lấy luồng stdout và stderr của trình mô phỏng

Process getEmulatorProcess()

Trả về Process tương ứng với trình mô phỏng này.

final File getExecuteShellCommandLog()

Nhật ký chứa tất cả nhật ký executeShellCommand(String).

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 FileEntry từ một đường dẫn không phải là đường dẫn gốc.

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 IDevice được liên kết.

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 System.currentTimeMillis() trả về.

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 maxBytes dữ liệu logcat đã chụp gần đây nhất.

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ề IDeviceStateMonitor được liên kết với thiết bị.

String getMountPoint(String mountName)

Trả về một điểm gắn kết.

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.

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 ProcessInfo có PID và thời gian bắt đầu xử lý của quy trình đã cho.

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 getSetting(int, String, String) và được thực hiện trên người dùng hệ thống.

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 UserInfo trên thiết bị.

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 TestDeviceState.FASTBOOT hoặc TestDeviceState.FASTBOOTD.

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 ERROR(/java.android.view.Display#DEFAULT_DISPLAY) hay không.

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 để start a user visible in the background.

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 ERROR(/File) tạm thời cục bộ và trả về File đó.

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 đó.

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 ERROR(/File) tạm thời cục bộ và trả về một thông tin tham chiếu đến File đó.

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.

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 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).

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 reason đã cho để duy trì trong quá trình khởi động lạ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 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.

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.

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 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.

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 IDeviceActionReceiver cho thiết bị này.

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ề true nếu thành công, false nếu không.

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 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ố.

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ị.

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.

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ể.

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 IConfiguration đang dùng.

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 SizeLimitedOutputStream để ghi nhật ký đầu ra

void setEmulatorProcess(Process p)

Đặt Process khi thiết bị này là một trình mô phỏng.

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 TestDeviceOptions cho thiết bị

boolean setProperty(String propKey, String propValue)

Đặt giá trị thuộc tính đã cho trên thiết bị.

void setRecovery(IDeviceRecovery recovery)

Đặt IDeviceRecovery để sử dụng cho thiết bị này.

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 setSetting(int, String, String, String) và được thực hiện trên người dùng hệ thống.

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ể ITestLogger

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 Bugreport để xử lý.

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 IDeviceRecovery).

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 RebootDeviceAction để dùng khi thực hiện thao tác khởi động lại.

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ể RunUtil để sử dụng.

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ề true nếu tệp cục bộ mới hơn tệp từ xa.

void notifyRebootEnded()

Thông báo cho tất cả IDeviceActionReceiver về sự kiện kết thúc khởi động lại.

void notifyRebootStarted()

Thông báo cho tất cả IDeviceActionReceiver về sự kiện bắt đầu khởi động lại.

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( deviceOptions)
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.

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

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

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()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

public  getActiveApexes ()

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

public  getAllSettings (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

public  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. 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

public  getAppPackageInfos ()

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

public  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.

Giá trị trả về
Bản đồ thời gian khởi động (thời gian UTC tính bằng giây kể từ thời gian bắt đầu của hệ thống) và lý do khởi động

Gửi
DeviceNotAvailableException

getBootHistorySince

public  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. 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

public  getFoldableStates ()

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

public  getInstalledPackageNames ()

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ế độ:

  • Nếu logcat hiện đang được ghi lại ở chế độ nền, thì sẽ trả về tối đa TestDeviceOptions.getMaxLogcatDataSize() byte nội dung hiện tại của quá trình ghi lại logcat ở chế độ nền
  • Nếu không, sẽ trả về một bản kết xuất tĩnh của dữ liệu logcat nếu thiết bị hiện đang phản hồi

    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

    public  getMainlineModuleInfo ()

    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

    public  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ị

    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

    public  getTombstones ()

    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

    public  getUninstallablePackageNames ()

    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

    public  getUserInfos ()

    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:" hoặc "" trực tiếp.

    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 ()

    isAdbRoot

    public boolean isAdbRoot ()

    Giá trị trả về
    boolean

    Gửi
    DeviceNotAvailableException

    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

    public  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".

    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

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

    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

    public  listUsers ()

    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().

    mountDebugfs

    public void mountDebugfs ()

    Gắn debugfs.

    Gửi
    DeviceNotAvailableException

    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()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ọi postBootSetup(). 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

    unmountDebugfs

    public void unmountDebugfs ()

    Huỷ gắn debugfs.

    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

    waitForDeviceFastbootD

    public void waitForDeviceFastbootD ()

    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.

    createRunUtil

    protected IRunUtil createRunUtil ()

    Giá trị trả về
    IRunUtil

    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

    getLogger

    protected ITestLogger getLogger ()

    Giá trị trả về
    ITestLogger

    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.