Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


Cung cấp API cấp độ đáng tin cậy và cao hơn một chút cho IDevice IDevice .

Thử lại các lệnh của thiết bị với số lượng có thể định cấu hình và cung cấp giao diện khôi phục thiết bị cho các thiết bị không phản hồi.

Tóm lược

Các lớp lồng nhau

class ITestDevice.ApexInfo

Một lớp cấu trúc đơn giản để lưu trữ thông tin về một APEX duy nhất

class ITestDevice.MountPointInfo

Một lớp cấu trúc đơn giản để lưu trữ thông tin về một điểm gắn kết duy nhất

enum ITestDevice.RecoveryMode

Phương pháp công khai

abstract boolean checkConnectivity ()

Kiểm tra xem thiết bị có kết nối mạng không.

abstract boolean clearErrorDialogs ()

Cố gắng loại bỏ bất kỳ hộp thoại lỗi nào hiện được hiển thị trên giao diện người dùng của thiết bị.

abstract void clearLastConnectedWifiNetwork ()

Xóa mạng wifi được kết nối gần đây nhất.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Kết nối với mạng wifi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

Kết nối với mạng wifi.

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

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

abstract int createUser (String name)

Tạo người dùng với tên đã cho và các cờ mặc định 0.

abstract int createUser (String name, boolean guest, boolean ephemeral)

Tạo người dùng với tên đã cho và các cờ được cung cấp

abstract int createUserNoThrow (String name)

Tạo người dùng với tên đã cho và các cờ mặc định 0.

abstract void disableKeyguard ()

Cố gắng tắt khóa phím.

abstract boolean disableNetworkMonitor ()

Tắt tính năng giám sát mạng trên thiết bị.

abstract boolean disconnectFromWifi ()

Ngắt kết nối khỏi mạng wifi.

abstract File dumpHeap (String process, String devicePath)

Cố gắng kết xuất heap khỏi system_server.

abstract boolean enableNetworkMonitor ()

Cho phép giám sát mạng trên thiết bị.

abstract getActiveApexes ()

Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị.

abstract getAllSettings (String namespace)

Trả về các cặp giá trị khóa của không gian tên được yêu cầu.

abstract String getAndroidId (int userId)

Tìm và trả về android-id được liên kết với userId, null nếu không tìm thấy.

abstract getAndroidIds ()

Tạo Bản đồ các id android được tìm thấy phù hợp với id người dùng.

abstract PackageInfo getAppPackageInfo (String packageName)

Tìm nạp thông tin về gói được cài đặt trên thiết bị.

abstract int getCurrentUser ()

Trả lại id của người dùng đang chạy hiện tại.

abstract getInstalledPackageNames ()

Tìm nạp các tên gói ứng dụng có trên thiết bị.

abstract String getIpAddress ()

Nhận địa chỉ IP của thiết bị.

abstract KeyguardControllerState getKeyguardState ()

Trả về một đối tượng để lấy trạng thái hiện tại của keyguard hoặc null nếu không được hỗ trợ.

abstract int getMaxNumberOfRunningUsersSupported ()

Nhận số lượng người dùng chạy đồng thời tối đa được hỗ trợ.

abstract int getMaxNumberOfUsersSupported ()

Nhận số lượng người dùng được hỗ trợ tối đa.

abstract TestDeviceOptions getOptions ()

Tìm nạp các tùy chọn kiểm tra cho thiết bị.

abstract Integer getPrimaryUserId ()

Trả về id người dùng chính.

abstract InputStreamSource getScreenshot ()

Lấy ảnh chụp màn hình từ thiết bị.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Lấy ảnh chụp màn hình từ thiết bị.

abstract InputStreamSource getScreenshot (int displayId)

Lấy ảnh chụp màn hình từ id hiển thị của thiết bị.

abstract InputStreamSource getScreenshot (String format)

Lấy ảnh chụp màn hình từ thiết bị.

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

abstract String getSetting (int userId, String namespace, String key)

Trả lại giá trị của cài đặt được yêu cầu.

abstract getUninstallablePackageNames ()

Tìm nạp tên gói ứng dụng có thể được gỡ cài đặt.

abstract int getUserFlags (int userId)

Tìm và trả về các cờ của một người dùng nhất định.

abstract getUserInfos ()

Đưa Map of useId sang UserInfo trên thiết bị.

abstract int getUserSerialNumber (int userId)

Trả lại số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong bất kỳ trường hợp nào khác.

abstract boolean hasFeature (String feature)

Kiểm tra xem một tính năng có sẵn trên thiết bị không.

abstract String installPackage (File packageFile, boolean reinstall, String... extraArgs)

Cài đặt gói Android trên thiết bị.

abstract String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Cài đặt gói Android trên thiết bị.

abstract String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng nhất định.

abstract String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng nhất định.

default String installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ).

default String installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) đang ở trên thiết bị Android.

default String installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) cho một người dùng nhất định.

default String installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) cho một người dùng nhất định.

default String installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) đang ở trên thiết bị Android.

default String installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) đang ở trên thiết bị Android.

abstract boolean isMultiUserSupported ()

Xác định xem nhiều người dùng có được hỗ trợ hay không.

abstract boolean isPackageInstalled (String packageName)

Truy vấn thiết bị cho một tên gói nhất định để kiểm tra xem nó hiện đã được cài đặt hay chưa.

abstract boolean isPackageInstalled (String packageName, String userId)

Truy vấn thiết bị để biết tên gói nhất định và id người dùng đã cho để kiểm tra xem thiết bị hiện đã được cài đặt hay chưa cho người dùng đó.

abstract boolean isUserRunning (int userId)

Kiểm tra xem một người dùng nhất định đang chạy.

abstract boolean isUserSecondary (int userId)

Trả lại xem người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của nó.

abstract boolean isWifiEnabled ()

Kiểm tra xem đã bật wifi chưa.

abstract listDisplayIds ()

Thu thập danh sách id hiển thị có sẵn trên thiết bị như được báo cáo bởi "bãi thải SurfaceFlinger".

abstract listUsers ()

Nhận danh sách người dùng trên thiết bị.

abstract boolean removeAdmin (String componentName, int userId)

Xóa quản trị viên thiết bị đã cho ở người dùng nhất định và trả về true nếu thành công, ngược lại là false .

abstract void removeOwners ()

Xóa tất cả chủ sở hữu hồ sơ thiết bị hiện có bằng nỗ lực cao nhất.

abstract boolean removeUser (int userId)

Xóa một người dùng nhất định khỏi thiết bị.

abstract boolean setDeviceOwner (String componentName, int userId)

Đặt thành phần quản trị thiết bị làm chủ sở hữu thiết bị trong người dùng nhất định.

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

abstract void setSetting (int userId, String namespace, String key, String value)

Thêm giá trị cài đặt vào không gian tên của một người dùng nhất định.

abstract boolean startUser (int userId)

Bắt đầu một người dùng nhất định trong nền nếu nó hiện đang bị dừng.

abstract boolean startUser (int userId, boolean waitFlag)

Bắt đầu một người dùng nhất định trong nền nếu nó hiện đang bị dừng.

abstract boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)

Dừng một người dùng nhất định.

abstract boolean stopUser (int userId)

Dừng một người dùng nhất định.

abstract boolean switchUser (int userId)

Chuyển sang userId khác với thời gian chờ mặc định.

abstract boolean switchUser (int userId, long timeout)

Chuyển sang userId khác với thời gian chờ được cung cấp làm thời hạn.

abstract String uninstallPackage (String packageName)

Gỡ cài đặt gói Android khỏi thiết bị.

Phương pháp công khai

checkConnectivity

public abstract boolean checkConnectivity ()

Kiểm tra xem thiết bị có kết nối mạng không.

Lợi nhuận
boolean true nếu thiết bị có kết nối mạng hoạt động, ngược lại false .

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Cố gắng loại bỏ bất kỳ hộp thoại lỗi nào hiện được hiển thị trên giao diện người dùng của thiết bị.

Lợi nhuận
boolean true nếu không có hộp thoại nào hoặc hộp thoại đã được xóa thành công. false khác.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Xóa mạng wifi được kết nối gần đây nhất. Điều này sẽ được gọi khi bắt đầu một lệnh gọi mới để tránh kết nối với mạng wifi được sử dụng trong thử nghiệm trước đó sau khi thiết bị khởi động lại.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Kết nối với mạng wifi.

Bật wifi và chặn cho đến khi kết nối thành công với mạng wifi được chỉ định. Sau khi kết nối được thực hiện, 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() đến ITestDevice#disconnectFromWifi() hoặc ITestDevice#clearLastConnectedWifiNetwork() .

Thông số
wifiSsid String : ssid wifi để kết nối

wifiPsk String : Cụm mật khẩu PSK hoặc null nếu không được mã hóa

Lợi nhuận
boolean true nếu kết nối thành công mạng wifi. false khác

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Kết nối với mạng wifi.

Bật wifi và chặn cho đến khi kết nối thành công với mạng wifi được chỉ định. Khi một kết nối được thực hiện, ví dụ sẽ cố gắng để khôi phục lại 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.

Thông số
wifiSsid String : ssid wifi để kết nối

wifiPsk String : Cụm mật khẩu PSK hoặc null nếu không được mã hóa

scanSsid boolean : có quét SSID ẩn cho mạng này hay không.

Lợi nhuận
boolean true nếu kết nối thành công mạng wifi. false khác

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

connectToWifiNetworkIfNeeded

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

Thông số
scanSsid boolean : có quét SSID ẩn cho mạng này không

Lợi nhuận
boolean true nếu kết nối thành công mạng wifi. false khác

Ném
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

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

Lợi nhuận
boolean true nếu kết nối thành công mạng wifi. false khác

Ném
DeviceNotAvailableException

tạo người dùng

public abstract int createUser (String name)

Tạo người dùng với tên đã cho và các cờ mặc định 0.

Thông số
name String : của người dùng tạo trên thiết bị

Lợi nhuận
int số nguyên cho id người dùng đã tạo

Ném
DeviceNotAvailableException

tạo người dùng

public abstract int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Tạo người dùng với tên đã cho và các cờ được cung cấp

Thông số
name String : của người dùng tạo trên thiết bị

guest boolean : bật cờ người dùng - hướng dẫn trong quá trình tạo

ephemeral boolean : bật cờ người dùng --ephemeral trong quá trình tạo

Lợi nhuận
int id của người dùng đã tạo

Ném
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

Tạo người dùng với tên đã cho và các cờ mặc định 0.

Thông số
name String : của người dùng tạo trên thiết bị

Lợi nhuận
int số nguyên cho id người dùng đã tạo hoặc -1 cho lỗi.

Ném
DeviceNotAvailableException

disableKeyguard

public abstract void disableKeyguard ()

Cố gắng tắt khóa phím.

Đầu tiên, hãy đợi công văn đầu vào sẵn sàng, điều này xảy ra cùng lúc khi thiết bị báo cáo BOOT_COMPLETE, có vẻ như không đồng bộ, vì việc triển khai khung hiện tại thỉnh thoảng có điều kiện chạy đua. Sau đó, lệnh được gửi để loại bỏ keyguard (chỉ hoạt động trên những key không an toàn)

Ném
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Tắt tính năng giám sát mạng trên thiết bị.

Lợi nhuận
boolean true nếu tính năng giám sát bị tắt thành công. false nếu nó không thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

ngắt kết nốiFromWifi

public abstract boolean disconnectFromWifi ()

Ngắt kết nối khỏi mạng wifi.

Xóa tất cả các mạng khỏi danh sách các mạng đã biết và tắt wifi.

Lợi nhuận
boolean true nếu ngắt kết nối mạng wifi thành công. false nếu ngắt kết nối không thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Cố gắng kết xuất heap khỏi system_server. Người gọi có trách nhiệm dọn dẹp tệp đã kết xuất.

Thông số
process String : tên của tiến trình thiết bị để kết xuất trên bản đồ.

devicePath String : đường dẫn trên thiết bị nơi đặt bãi chứa. Đây phải là một vị trí mà quyền cho phép nó.

Lợi nhuận
File ERROR(/File) chứa báo cáo. Vô hiệu nếu điều gì đó thất bại.

Ném
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Cho phép giám sát mạng trên thiết bị.

Lợi nhuận
boolean true nếu kích hoạt giám sát thành công. false nếu nó không thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

getActiveApexes

public abstract  getActiveApexes ()

Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị.

Lợi nhuận
ERROR(/Set) ApexInfo hiện được kích hoạt trên thiết bị

Ném
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

Trả về các cặp giá trị khóa của không gian tên được yêu cầu.

Thông số
namespace String : phải là một trong {"system", "secure", "global"}

Lợi nhuận
bản đồ của các cặp giá trị chính. Null nếu không gian tên không được hỗ trợ.

Ném
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Tìm và trả về android-id được liên kết với userId, null nếu không tìm thấy.

Thông số
userId int

Lợi nhuận
String

Ném
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Tạo Bản đồ các id android được tìm thấy phù hợp với id người dùng. Không có bảo hiểm rằng mỗi id người dùng sẽ tìm thấy một id android được liên kết trong chức năng này vì vậy một số id người dùng có thể khớp với null.

Lợi nhuận
Bản đồ các id android được tìm thấy phù hợp với id người dùng.

Ném
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Tìm nạp thông tin về gói được cài đặt trên thiết bị.

Thông số
packageName String

Lợi nhuận
PackageInfo PackageInfo hoặc null nếu không thể truy xuất thông tin

Ném
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Trả lại id của người dùng đang chạy hiện tại.

Lợi nhuận
int

Ném
DeviceNotAvailableException
DeviceRuntimeException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Tìm nạp các tên gói ứng dụng có trên thiết bị.

Lợi nhuận
ERROR(/Set) tên góiString hiện được cài đặt trên thiết bị.

Ném
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Nhận địa chỉ IP của thiết bị.

Lợi nhuận
String địa chỉ IP của thiết bị hoặc null nếu thiết bị không có địa chỉ IP

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Trả về một đối tượng để lấy trạng thái hiện tại của keyguard hoặc null nếu không được hỗ trợ.

Lợi nhuận
KeyguardControllerState một KeyguardControllerState chứa ảnh chụp nhanh trạng thái của keyguard và trả về Null nếu truy vấn Keyguard không được hỗ trợ.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Nhận số lượng người dùng chạy đồng thời tối đa được hỗ trợ. Mặc định là 0.

Lợi nhuận
int một số nguyên cho biết số lượng người dùng đang chạy đồng thời

Ném
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Nhận số lượng người dùng được hỗ trợ tối đa. Mặc định là 0.

Lợi nhuận
int một số nguyên cho biết số lượng người dùng được hỗ trợ

Ném
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Tìm nạp các tùy chọn kiểm tra cho thiết bị.

Lợi nhuận
TestDeviceOptions TestDeviceOptions liên quan đến thiết bị được kiểm tra.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Trả về id người dùng chính.

Lợi nhuận
Integer userId của người dùng chính nếu có và null nếu không có người dùng chính.

Ném
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Lấy ảnh chụp màn hình từ thiết bị.

Lợi nhuận
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.

Ném
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Lấy ảnh chụp màn hình từ thiết bị. Được khuyến nghị sử dụng getScreenshot(String) thay vì mã hóa JPEG để có kích thước nhỏ hơn.

Thông số
format String : PNG, JPEG được hỗ trợ

rescale boolean : nếu ảnh chụp màn hình nên được thay đổi tỷ lệ để giảm kích thước của hình ảnh kết quả

Lợi nhuận
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.

Ném
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (int displayId)

Lấy ảnh chụp màn hình từ id hiển thị của thiết bị. Định dạng là PNG.

VIỆC CẦN LÀM: mở rộng các triển khai ở trên để hỗ trợ 'định dạng' và 'bán lại'

Thông số
displayId int : id hiển thị của màn hình để lấy ảnh chụp màn hình.

Lợi nhuận
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.

Ném
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Lấy ảnh chụp màn hình từ thiết bị. Khuyến nghị sử dụng getScreenshot (định dạng) thay vì mã hóa JPEG cho kích thước nhỏ hơn

Thông số
format String : PNG, JPEG được hỗ trợ

Lợi nhuận
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.

Ném
DeviceNotAvailableException

getSetting

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

Thông số
namespace String

key String

Lợi nhuận
String

Ném
DeviceNotAvailableException

getSetting

public abstract String getSetting (int userId, 
                String namespace, 
                String key)

Trả lại giá trị của cài đặt được yêu cầu. không gian tên phải là một trong: {"system", "secure", "global"}

Thông số
userId int

namespace String

key String

Lợi nhuận
String giá trị được liên kết với không gian tên: khóa của người dùng. Null nếu không tìm thấy.

Ném
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Tìm nạp tên gói ứng dụng có thể được gỡ cài đặt. Điều này hiện được định nghĩa là các gói không thuộc hệ thống và các gói hệ thống được cập nhật.

Lợi nhuận
ERROR(/Set) tên góiString gỡ cài đặt hiện được cài đặt trên thiết bị.

Ném
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Tìm và trả về các cờ của một người dùng nhất định. Cờ được định nghĩa trong lớp "android.content.pm.UserInfo" trong Dự án nguồn mở Android.

Thông số
userId int

Lợi nhuận
int các cờ được liên kết với userId được cung cấp nếu tìm thấy, -10000 trong bất kỳ trường hợp nào khác.

Ném
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Đưa Map of useId sang UserInfo trên thiết bị. Sẽ ném DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.

Lợi nhuận
danh sách các đối tượng UserInfo.

Ném
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Trả lại số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong bất kỳ trường hợp nào khác.

Thông số
userId int

Lợi nhuận
int

Ném
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

Kiểm tra xem một tính năng có sẵn trên thiết bị không.

Thông số
feature String : định dạng nên là "tính năng: ".

Lợi nhuận
boolean Đúng nếu tính năng được tìm thấy, nếu không thì sai.

Ném
DeviceNotAvailableException

cài đặt gói

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị.

Thông số
packageFile File : tệp apk để cài đặt

reinstall boolean : true nếu cần thực hiện cài đặt lại

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

cài đặt gói

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị.

Lưu ý: Chỉ các trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy tại thời điểm cài đặt mới nên gọi hàm này.

Thông số
packageFile File : tệp apk để cài đặt

reinstall boolean : true nếu cần thực hiện cài đặt lại

grantPermissions boolean : nếu tất cả các quyền thời gian chạy phải được cấp tại thời điểm cài đặt

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng nhất định.

Lưu ý: Chỉ các trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy tại thời điểm cài đặt mới nên gọi hàm này.

Thông số
packageFile File : tệp apk để cài đặt

reinstall boolean : true nếu cần thực hiện cài đặt lại

grantPermissions boolean : nếu tất cả các quyền thời gian chạy phải được cấp tại thời điểm cài đặt

userId int : id người dùng số nguyên để cài đặt.

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

installPackageForUser

public abstract String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng nhất định.

Thông số
packageFile File : tệp apk để cài đặt

reinstall boolean : true nếu cần thực hiện cài đặt lại

userId int : id người dùng số nguyên để cài đặt.

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ). Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách chia apk thành nhiều tệp.

Thông số
packageFiles : các tệp apk cục bộ

reinstall boolean : true nếu cần thực hiện cài đặt lại

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) đang ở trên thiết bị Android. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách chia apk thành nhiều tệp.

Lưu ý: Chỉ các trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy tại thời điểm cài đặt mới nên gọi hàm này.

Thông số
packageFiles : đường dẫn tệp apk từ xa để cài đặt

reinstall boolean : true nếu cần thực hiện cài đặt lại

grantPermissions boolean : nếu tất cả các quyền thời gian chạy phải được cấp tại thời điểm cài đặt

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) cho một người dùng nhất định. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách chia apk thành nhiều tệp.

Lưu ý: Chỉ các trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy tại thời điểm cài đặt mới nên gọi hàm này.

Thông số
packageFiles : các tệp apk cục bộ

reinstall boolean : true nếu cần thực hiện cài đặt lại

grantPermissions boolean : nếu tất cả các quyền thời gian chạy phải được cấp tại thời điểm cài đặt

userId int : id người dùng số nguyên để cài đặt.

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) cho một người dùng nhất định. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách chia apk thành nhiều tệp.

Thông số
packageFiles : các tệp apk cục bộ

reinstall boolean : true nếu cần thực hiện cài đặt lại

userId int : id người dùng số nguyên để cài đặt.

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) đang ở trên thiết bị Android. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách chia apk thành nhiều tệp.

Lưu ý: Chỉ các trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy tại thời điểm cài đặt mới nên gọi hàm này.

Thông số
remoteApkPaths : đường dẫn tệp apk từ xa

reinstall boolean : true nếu cần thực hiện cài đặt lại

grantPermissions boolean : nếu tất cả các quyền thời gian chạy phải được cấp tại thời điểm cài đặt

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Cài đặt ứng dụng Android được tạo từ một số tệp APK (một gói chính và gói phụ) đang ở trên thiết bị Android. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách chia apk thành nhiều tệp.

Thông số
remoteApkPaths : đường dẫn tệp apk từ xa

reinstall boolean : true nếu cần thực hiện cài đặt lại

extraArgs String : đối số phụ tùy chọn để chuyển. Xem 'adb shell pm install --help' để biết các tùy chọn có sẵn.

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Xác định xem nhiều người dùng có được hỗ trợ hay không.

Lợi nhuận
boolean true nếu nhiều người dùng được hỗ trợ, false nếu không

Ném
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Truy vấn thiết bị cho một tên gói nhất định để kiểm tra xem nó hiện đã được cài đặt hay chưa.

Thông số
packageName String

Lợi nhuận
boolean Đúng nếu gói được báo cáo là đã cài đặt. Sai khác.

Ném
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Truy vấn thiết bị để biết tên gói nhất định và id người dùng đã cho để kiểm tra xem thiết bị hiện đã được cài đặt hay chưa cho người dùng đó.

Thông số
packageName String : gói chúng tôi đang kiểm tra xem nó đã được cài đặt chưa.

userId String : Id người dùng mà chúng tôi đang kiểm tra gói được cài đặt. Nếu null, số không của người dùng chính sẽ được sử dụng.

Lợi nhuận
boolean Đúng nếu gói được báo cáo là đã cài đặt. Sai khác.

Ném
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Kiểm tra xem một người dùng nhất định đang chạy.

Thông số
userId int

Lợi nhuận
boolean Đúng nếu người dùng đang chạy, sai trong mọi trường hợp khác.

Ném
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

Trả lại xem người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của nó.

Thông số
userId int

Lợi nhuận
boolean true nếu người dùng là phụ, ngược lại là false.

Ném
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Kiểm tra xem đã bật wifi chưa.

Kiểm tra xem đã bật wifi trên thiết bị chưa. Hữu ích để xác nhận trạng thái wifi trước các bài kiểm tra không chạy với wifi, ví dụ: kiểm tra dữ liệu di động.

Lợi nhuận
boolean true nếu wifi được bật. false nếu bị vô hiệu hóa

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.

listDisplayIds

public abstract  listDisplayIds ()

Thu thập danh sách id hiển thị có sẵn trên thiết bị như được báo cáo bởi "bãi thải SurfaceFlinger".

Lợi nhuận
Danh sách hiển thị. Mặc định luôn trả về hiển thị mặc định 0.

Ném
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Nhận danh sách người dùng trên thiết bị. Sẽ ném DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.

Lợi nhuận
danh sách id người dùng.

Ném
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException
DeviceNotAvailableException

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Xóa quản trị viên thiết bị đã cho ở người dùng nhất định và trả về true nếu thành công, ngược lại là false .

Thông số
componentName String : của quản trị viên thiết bị sẽ bị xóa.

userId int : của người dùng mà quản trị viên thiết bị đang sống.

Lợi nhuận
boolean Đúng nếu nó thành công, sai nếu không.

Ném
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Xóa tất cả chủ sở hữu hồ sơ thiết bị hiện có bằng nỗ lực cao nhất.

Ném
DeviceNotAvailableException

removeUser

public abstract boolean removeUser (int userId)

Xóa một người dùng nhất định khỏi thiết bị.

Thông số
userId int : của người dùng để loại bỏ

Lợi nhuận
boolean true nếu chúng tôi xóa người dùng thành công, ngược lại là false.

Ném
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Đặt thành phần quản trị thiết bị làm chủ sở hữu thiết bị trong người dùng nhất định.

Thông số
componentName String : của quản trị viên thiết bị là chủ sở hữu thiết bị.

userId int : của người dùng mà chủ sở hữu thiết bị đang sống.

Lợi nhuận
boolean Đúng nếu nó thành công, sai nếu không.

Ném
DeviceNotAvailableException

setSetting

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

Thông số
namespace String

key String

value String

Ném
DeviceNotAvailableException

setSetting

public abstract void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Thêm giá trị cài đặt vào không gian tên của một người dùng nhất định. Một số cài đặt sẽ chỉ khả dụng sau khi khởi động lại. không gian tên phải là một trong: {"system", "secure", "global"}

Thông số
userId int

namespace String

key String

value String

Ném
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

Bắt đầu một người dùng nhất định trong nền nếu nó hiện đang dừng. Nếu người dùng đã chạy ở chế độ nền, thì phương pháp này là NOOP.

Thông số
userId int : của người dùng để bắt đầu trong nền

Lợi nhuận
boolean true nếu người dùng đã được khởi động thành công trong nền.

Ném
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Bắt đầu một người dùng nhất định trong nền nếu nó hiện đang bị dừng. Nếu người dùng đã chạy ở chế độ nền, thì phương pháp này là NOOP. Có thể cung cấp thêm cờ để chờ thao tác có hiệu lực.

Thông số
userId int : của người dùng để bắt đầu trong nền

waitFlag boolean : sẽ thực hiện lệnh đợi cho đến khi người dùng được khởi động và mở khóa.

Lợi nhuận
boolean true nếu người dùng đã được khởi động thành công trong nền.

Ném
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Dừng một người dùng nhất định. Có thể cung cấp thêm cờ để chờ thao tác có hiệu lực và buộc chấm dứt người dùng. Không thể dừng người dùng hiện tại và hệ thống.

Thông số
userId int : của người dùng để dừng.

waitFlag boolean : sẽ làm cho lệnh đợi cho đến khi người dùng bị dừng.

forceFlag boolean : sẽ buộc dừng người dùng.

Lợi nhuận
boolean true nếu người dùng đã được dừng thành công.

Ném
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Dừng một người dùng nhất định. Nếu người dùng đã bị dừng, phương pháp này là NOOP. Không thể dừng người dùng hiện tại và hệ thống.

Thông số
userId int : của người dùng để dừng.

Lợi nhuận
boolean true nếu người dùng đã được dừng thành công.

Ném
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Chuyển sang userId khác với thời gian chờ mặc định. switchUser(int, long) .

Thông số
userId int

Lợi nhuận
boolean Đúng nếu userId mới khớp với nhà cung cấp userId. Sai khác.

Ném
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Chuyển sang userId khác với thời gian chờ được cung cấp làm thời hạn. Cố gắng tắt khóa phím sau khi thay đổi người dùng thành công.

Thông số
userId int

timeout long : để đợi trước khi trả về false cho người dùng chuyển đổi không thành công.

Lợi nhuận
boolean Đúng nếu userId mới khớp với nhà cung cấp userId. Sai khác.

Ném
DeviceNotAvailableException

gỡ cài đặt

public abstract String uninstallPackage (String packageName)

Gỡ cài đặt gói Android khỏi thiết bị.

Thông số
packageName String : gói Android cần gỡ cài đặt

Lợi nhuận
String mộtString có mã lỗi hoặc null nếu thành công.

Ném
DeviceNotAvailableException nếu kết nối với thiết bị bị mất và không thể khôi phục được.