Google cam kết thúc đẩy công bằng chủng tộc cho các cộng đồng Đen. Xem thế nào.
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 cộng

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 hiện đang hiển thị trên giao diện người dùng thiết bị.

abstract void clearLastConnectedWifiNetwork ()

Xóa mạng wifi được kết nối lần cuối.

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ờ mặc định 0.

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

Tạo người dùng với một tên cụ thể 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ờ mặc định 0.

abstract void disableKeyguard ()

Nỗ lực vô hiệu hóa keyguard.

abstract boolean disableNetworkMonitor ()

Vô hiệu hóa giám sát mạng trên thiết bị.

abstract boolean disconnectFromWifi ()

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

abstract File dumpHeap (String process, String devicePath)

Cố gắng đổ đống từ máy chủ system_server.

abstract boolean enableNetworkMonitor ()

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

abstract getActiveApexes ()

Lấy thông tin về APEX được kích hoạt trên thiết bị.

abstract getAllSettings (String namespace)

Trả về 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ả lại id android được liên kết với userId, null nếu không tìm thấy.

abstract getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

Lấy thông tin về một gói được cài đặt trên thiết bị.

abstract int getCurrentUser ()

Trả về id của người dùng đang chạy.

abstract getInstalledPackageNames ()

Lấy tên gói ứng dụng có trên thiết bị.

abstract String getIpAddress ()

Lấy địa chỉ IP của thiết bị.

abstract KeyguardControllerState getKeyguardState ()

Trả về một đối tượng để có 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 tối đa người dùng được hỗ trợ chạy đồng thời.

abstract int getMaxNumberOfUsersSupported ()

Lấy số lượng người dùng được hỗ trợ tối đa.

abstract TestDeviceOptions getOptions ()

Lấy 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 một ảnh chụp màn hình từ thiết bị.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (int displayId)

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

abstract InputStreamSource getScreenshot (String format)

Lấy một ả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ả về giá trị của cài đặt được yêu cầu.

abstract getUninstallablePackageNames ()

Lấy tên gói ứng dụng có thể được gỡ cài đặt.

abstract int getUserFlags (int userId)

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

abstract getUserInfos ()

Nhận Bản đồ sử dụngId đến UserInfo trên thiết bị.

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

abstract boolean hasFeature (String feature)

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

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 chia chính và 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 chia chính và phụ) đang ngồi 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 chia nhỏ) 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 chia nhỏ) 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 chia chính và phụ) đang ngồi 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 chia chính và phụ) đang ngồi trên thiết bị Android.

abstract boolean isMultiUserSupported ()

Xác định nếu nhiều người dùng được hỗ trợ.

abstract boolean isPackageInstalled (String packageName)

Truy vấn thiết bị để biết tên gói đã cho để kiểm tra xem nó có được cài đặt hay không.

abstract boolean isPackageInstalled (String packageName, String userId)

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

abstract boolean isUserRunning (int userId)

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

abstract boolean isUserSecondary (int userId)

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

abstract boolean isWifiEnabled ()

Kiểm tra nếu wifi được kích hoạt.

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 "dumpsys SurfaceFlinger".

abstract listUsers ()

Lấy 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 trong người dùng cụ thể và trả về true nếu thành công, false nếu không.

abstract void removeOwners ()

Xóa tất cả các chủ sở hữu hồ sơ thiết bị hiện có với nỗ lực tốt 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ị viên thiết bị làm chủ sở hữu thiết bị ở người dùng cụ thể.

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 một 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 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 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 một userId khác với thời gian chờ được cung cấp là 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 cộng

kiểm tra kết nối

public abstract boolean checkConnectivity ()

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

Trả về
boolean true nếu thiết bị có kết nối mạng hoạt động, false quá mức.

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

xóaErrorDialogs

public abstract boolean clearErrorDialogs ()

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

Trả về
boolean true nếu không có hộp thoại nào xuất hiện 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ể phục hồi.

xóaLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Xóa mạng wifi được kết nối lần cuối. Điều này nên đượ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.

kết nối với mạng

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 được thực hiện với mạng wifi được chỉ định. Khi một kết nối được tạo, cá thể 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.

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

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

Trả về
boolean true nếu kết nối với mạng wifi 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ể phục hồi.

kết nối với mạng

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 được thực hiện với mạng wifi được chỉ định. Khi một kết nối được tạo, cá thể 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.

Thông số
wifiSsid String : ssid wifi để kết nối vớ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 không.

Trả về
boolean true nếu kết nối với mạng wifi 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ể phục hồi.

kết nối vớiWifiNetwork IfNeeded

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

Trả về
boolean true nếu kết nối với mạng wifi thành công. false khác

Ném
DeviceNotAvailableException

kết nối vớiWifiNetwork IfNeeded

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.

Trả về
boolean true nếu kết nối với mạng wifi thành công. 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ờ mặc định 0.

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

Trả về
int số nguyên cho id người dùng được 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 một tên cụ thể 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 - bảo vệ trong khi tạo

ephemeral boolean : bật cờ người dùng - thận trọng trong khi tạo

Trả về
int id của người dùng đã tạo

Ném
DeviceNotAvailableException

tạoUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

Trả về
int số nguyên cho id người dùng được tạo hoặc -1 cho lỗi.

Ném
DeviceNotAvailableException

vô hiệu hóa

public abstract void disableKeyguard ()

Nỗ lực vô hiệu hóa keyguard.

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

Ném
DeviceNotAvailableException

vô hiệu hóa NetworkMonitor

public abstract boolean disableNetworkMonitor ()

Vô hiệu hóa giám sát mạng trên thiết bị.

Trả về
boolean true nếu giám sát bị vô hiệu hóa thành công. false nếu thất bại.

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

ngắt kết nối từ xa

public abstract boolean disconnectFromWifi ()

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

Loại bỏ tất cả các mạng khỏi danh sách mạng đã biết và vô hiệu hóa wifi.

Trả về
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 thất bại.

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

bãi rác

public abstract File dumpHeap (String process, 
                String devicePath)

Cố gắng đổ đống từ máy chủ system_server. Người gọi có trách nhiệm dọn dẹp tập tin bị đổ.

Thông số
process String : tên của quá trình thiết bị để dumpheap trên.

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

Trả về
File ERROR(/File) có chứa báo cáo. Null nếu một cái 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ị.

Trả về
boolean true nếu giám sát được kích hoạt thành công. false nếu thất bại.

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

getActiveApexes

public abstract  getActiveApexes ()

Lấy thông tin về APEX được kích hoạt trên thiết bị.

Trả về
ApexInfo ERROR(/Set) của ApexInfo hiện được kích hoạt trên thiết bị

Ném
DeviceNotAvailableException

get ALLS Settings

public abstract  getAllSettings (String namespace)

Trả về 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", "an toàn", "toàn cầu"}

Trả về
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ả lại id android được liên kết với userId, null nếu không tìm thấy.

Thông số
userId int

Trả về
String

Ném
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Tạo một bản đồ của các id android 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 để một số id người dùng có thể khớp với null.

Trả về
Bản đồ của id android tìm thấy phù hợp với id người dùng.

Ném
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Lấy thông tin về một gói được cài đặt trên thiết bị.

Thông số
packageName String

Trả về
PackageInfo PackageInfo hoặc null nếu không thể lấy thông tin

Ném
DeviceNotAvailableException

getCienUser

public abstract int getCurrentUser ()

Trả về id của người dùng đang chạy.

Trả về
int

Ném
DeviceNotAvailableException
DeviceRuntimeException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Lấy tên gói ứng dụng có trên thiết bị.

Trả về
ERROR(/Set) của tên gói String hiện được cài đặt trên thiết bị.

Ném
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Lấy địa chỉ IP của thiết bị.

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

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

Trả về
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ể phục hồi.

getMaxNumberOfRastyUsers Được hỗ trợ

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Trả về
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

getMaxNumberOfUsers Được hỗ trợ

public abstract int getMaxNumberOfUsersSupported ()

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

Trả về
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 ()

Lấy các tùy chọn kiểm tra cho thiết bị.

Trả về
TestDeviceOptions TestDeviceOptions liên quan đến thiết bị được thử nghiệm.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

Trả về
Integer userId của người dùng chính nếu có một và null nếu không có người dùng chính.

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

getSc mãi

public abstract InputStreamSource getScreenshot ()

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

Trả về
InputStreamSource một 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

getSc mãi

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

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.

Ném
DeviceNotAvailableException

getSc mãi

public abstract InputStreamSource getScreenshot (int displayId)

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

TODO: mở rộng các triển khai ở trên để hỗ trợ 'định dạng' và 'hủy bỏ'

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

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.

Ném
DeviceNotAvailableException

getSc mãi

public abstract InputStreamSource getScreenshot (String format)

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

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

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.

Ném
DeviceNotAvailableException

nhận đặt

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

Trả về
String

Ném
DeviceNotAvailableException

nhận đặt

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

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

Thông số
userId int

namespace String

key String

Trả về
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 ()

Lấy 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 phi hệ thống và các gói hệ thống được cập nhật.

Trả về
ERROR(/Set) tên gói String 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ả lại 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 mã nguồn mở Android.

Thông số
userId int

Trả về
int các cờ được liên kết với userId được cung cấp nếu tìm thấy, -10000 trong mọi trường hợp khác.

Ném
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

Nhận Bản đồ sử dụngId đến UserInfo trên thiết bị. Sẽ ném DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.

Trả về
danh sách các đối tượng UserInfo.

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

getUserSerialNumber

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

Thông số
userId int

Trả về
int

Ném
DeviceNotAvailableException

có tính năng

public abstract boolean hasFeature (String feature)

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

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

Trả về
boolean Đúng nếu tính năng được tìm thấy, sai khác.

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ài đặt lại nên được thực hiện

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.

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ỉ sử dụng các trường hợp yêu cầu kiểm soát rõ ràng về việc cấp quyền thời gian chạy khi cài đặt 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ài đặt lại nên được thực hiện

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

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.
UnsupportedOperationException nếu sự cho phép thời gian chạy không được hỗ trợ bởi nền tảng trên thiết bị.

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ỉ sử dụng các trường hợp yêu cầu kiểm soát rõ ràng về việc cấp quyền thời gian chạy khi cài đặt 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ài đặt lại nên được thực hiện

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

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

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.
UnsupportedOperationException nếu sự cho phép thời gian chạy không được hỗ trợ bởi nền tảng trên thiết bị.

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ài đặt lại nên được thực hiện

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

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.

gói cài đặt

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 chia chính và phụ). Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách phân chia apk thành nhiều tệp.

Thông số
packageFiles : tập tin apk cục bộ

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

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.
UnsupportedOperationException nếu sự cho phép thời gian chạy không được hỗ trợ bởi nền tảng trên thiết bị.

gói cài đặt

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 chia chính và phụ) đang ngồi trên thiết bị Android. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách phân chia apk thành nhiều tệp.

Lưu ý: Chỉ sử dụng các trường hợp yêu cầu kiểm soát rõ ràng về việc cấp quyền thời gian chạy khi cài đặt 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ài đặt lại nên được thực hiện

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

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.
UnsupportedOperationException nếu sự cho phép thời gian chạy không được hỗ trợ bởi nền tảng trên thiết bị.

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 chia nhỏ) cho một người dùng nhất định. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách phân chia apk thành nhiều tệp.

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

Thông số
packageFiles : tập tin apk cục bộ

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

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

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

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.
UnsupportedOperationException nếu sự cho phép thời gian chạy không được hỗ trợ bởi nền tảng trên thiết bị.

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 chia nhỏ) cho một người dùng nhất định. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách phân chia apk thành nhiều tệp.

Thông số
packageFiles : tập tin apk cục bộ

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

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

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.
UnsupportedOperationException nếu sự cho phép thời gian chạy không được hỗ trợ bởi nền tảng trên thiết bị.

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 chia chính và phụ) đang ngồi trên thiết bị Android. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách phân chia apk thành nhiều tệp.

Lưu ý: Chỉ sử dụng các trường hợp yêu cầu kiểm soát rõ ràng về việc cấp quyền thời gian chạy khi cài đặt 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ài đặt lại nên được thực hiện

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

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.
UnsupportedOperationException nếu sự cho phép thời gian chạy không được hỗ trợ bởi nền tảng trên thiết bị.

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 chia chính và phụ) đang ngồi trên thiết bị Android. Xem "https://developer.android.com/studio/build/configure-apk-splits" về cách phân 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ài đặt lại nên được thực hiện

extraArgs String : đối số phụ tùy chọn để vượt qua. Xem 'adb shell pm install --help' để biết các tùy chọn khả dụng.

Trả về
String String 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ể phục hồi.
UnsupportedOperationException nếu sự cho phép thời gian chạy không được hỗ trợ bởi nền tảng trên thiết bị.

isMultiUser Được hỗ trợ

public abstract boolean isMultiUserSupported ()

Xác định nếu nhiều người dùng được hỗ trợ.

Trả về
boolean đúng nếu nhiều người dùng được hỗ trợ, sai khác

Ném
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Truy vấn thiết bị để biết tên gói đã cho để kiểm tra xem nó có được cài đặt hay không.

Thông số
packageName String

Trả về
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ị cho một tên gói nhất định và id người dùng đã cho để kiểm tra xem nó có được cài đặt hay không cho người dùng đó.

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

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

Trả về
boolean Đúng nếu gói được báo cáo là đã cài đặt. Sai khác.

Ném
DeviceNotAvailableException

isUserRucky

public abstract boolean isUserRunning (int userId)

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

Thông số
userId int

Trả về
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ả về việc người dùng được chỉ định có phải là người dùng phụ theo các cờ của nó hay không.

Thông số
userId int

Trả về
boolean đúng nếu người dùng là thứ yếu, sai khác.

Ném
DeviceNotAvailableException

isWifiEnables

public abstract boolean isWifiEnabled ()

Kiểm tra nếu wifi được kích hoạt.

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

Trả về
boolean true nếu wifi được kích hoạ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ể phục hồi.

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 "dumpsys SurfaceFlinger".

Trả về
Danh sách các màn hình. Mặc định luôn trả về màn hình mặc định 0.

Ném
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Lấy 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.

Trả về
danh sách id người dùng.

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

xóaAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Xóa quản trị viên thiết bị đã cho trong người dùng cụ thể và trả về true nếu thành công, false nếu không.

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ị sống.

Trả về
boolean Đúng nếu nó thành công, sai khác.

Ném
DeviceNotAvailableException

loại bỏ

public abstract void removeOwners ()

Xóa tất cả các chủ sở hữu hồ sơ thiết bị hiện có với nỗ lực tốt nhất.

Ném
DeviceNotAvailableException

gỡ bỏ người dùng

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ỏ

Trả về
boolean đúng nếu chúng ta đã thành công trong việc loại bỏ người dùng, sai thì ngược lại.

Ném
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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ị sống.

Trả về
boolean Đúng nếu nó thành công, sai khác.

Ném
DeviceNotAvailableException

thiết lập

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

thiết lập

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

Thêm một 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", "safe", "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 trong nền, phương thức này là NOOP.

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

Trả về
boolean đúng nếu người dùng đã bắt đầu 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 dừng. Nếu người dùng đã chạy trong nền, phương thức này là NOOP. Có thể cung cấp thêm cờ để chờ hoạt động 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ẽ làm cho lệnh chờ cho đến khi người dùng được khởi động và mở khóa.

Trả về
boolean đúng nếu người dùng đã bắt đầu thành công trong nền.

Ném
DeviceNotAvailableException

người dùng dừng

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ờ hoạt động 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 lại.

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

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

Trả về
boolean đúng nếu người dùng đã dừng thành công.

Ném
DeviceNotAvailableException

người dùng dừng

public abstract boolean stopUser (int userId)

Dừng một người dùng nhất định. Nếu người dùng đã dừng, phương thức 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.

Trả về
boolean đúng nếu người dùng đã dừng thành công.

Ném
DeviceNotAvailableException

chuyển đổi người dùng

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

Trả về
boolean Đúng nếu userId mới khớp với nhà cung cấp userId. Sai khác.

Ném
DeviceNotAvailableException

chuyển đổi người dùng

public abstract boolean switchUser (int userId, 
                long timeout)

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

Thông số
userId int

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

Trả về
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 để gỡ cài đặt

Trả về
String String 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ể phục hồi.