Thiết bị ITest

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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.

Bản tóm tắt

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

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

Phương pháp công khai

abstract boolean canSwitchToHeadlessSystemUser ()

Trả về liệu nó có được phép chuyển sang người dùng HỆ THỐNG không đầu hay khô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ỏ 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ị.

abstract void clearLastConnectedWifiNetwork ()

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

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

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

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

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

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 cụ thể và cờ mặc định 0.

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

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

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

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

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Xóa IDeviceActionReceiver đã đăng ký.

abstract void disableKeyguard ()

Cố gắng 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 khỏi mạng wifi.

abstract boolean doesFileExist (String deviceFilePath, int userId)

Phương pháp trợ giúp để xác định xem tệp trên thiết bị có tồn tại đối với một người dùng nhất định hay không.

abstract File dumpHeap (String process, String devicePath)

Cố gắng kết xuất vùng nhớ heap từ 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ề 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 getAppPackageInfos ()

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

abstract InputStreamSource getBugreport ()

Truy xuất báo cáo lỗi từ thiết bị.

abstract InputStreamSource getBugreportz ()

Truy xuất báo cáo lỗi từ thiết bị.

abstract 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 trả về giá trị rỗng nếu xảy ra một số sự cố.

abstract int getCurrentUser ()

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

abstract getFoldableStates ()

Trả về danh sách các trạng thái có thể gập lại trên thiết bị.

abstract getInstalledPackageNames ()

Tìm nạp 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 để lấy trạng thái hiện tại của keyguard hoặc null nếu không được hỗ trợ.

abstract Integer getMainUserId ()

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

abstract getMainlineModuleInfo ()

Nhận thông tin về các mô-đun đường dây chính được cài đặt trên thiết bị.

abstract int getMaxNumberOfRunningUsersSupported ()

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

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

Chụp ảnh màn hình từ thiết bị.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Chụp ảnh màn hình từ thiết bị.

abstract InputStreamSource getScreenshot (String format)

Chụp ảnh màn hình từ thiết bị.

abstract InputStreamSource getScreenshot (long displayId)

Chụp ảnh màn hình từ thiết bị có id hiển thị.

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ả về cờ của một người dùng nhất định.

abstract getUserInfos ()

Nhận Bản đồ useId tới 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 xem một tính năng có sẵn trên thiết bị hay 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ừ nhiều tệp APK (một gói chia nhỏ chính và gói bổ sung).

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 phân chia chính và gói bổ sung) đang có 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ừ nhiều tệp APK (một gói chính và gói bổ sung) 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ừ nhiều tệp APK (một gói chính và gói bổ sung) cho một người dùng nhất định.

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 phân chia chính và gói bổ sung) đang có trên thiết bị Android.

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 phân chia chính và gói bổ sung) đang có trên thiết bị Android.

abstract boolean isHeadlessSystemUserMode ()

Trả về việc thiết bị có sử dụng chế độ người dùng hệ thống không đầu hay không.

abstract boolean isMainUserPermanentAdmin ()

Trả về việc người dùng chính có phải là quản trị viên thường trực hay không và không thể xóa hoặc hạ cấp xuống trạng thái không phải quản trị viên.

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ị để biế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 nhất định để kiểm tra xem nó 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 có đang chạy hay không.

abstract boolean isUserSecondary (int userId)

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

Kiểm tra xem người dùng đã cho có hiển thị hay không.

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

Kiểm tra xem người dùng nhất định có hiển thị trong màn hình nhất định hay không.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Trả về xem thiết bị có cho phép người dùng khởi động ở chế độ nền trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

abstract boolean isVisibleBackgroundUsersSupported ()

Trả về việc thiết bị có cho phép người dùng bắt đầu hiển thị ở chế độ nền hay không.

abstract boolean isWifiEnabled ()

Kiểm tra xem wifi có được bật hay không.

abstract listDisplayIds ()

Thu thập danh sách id hiển thị có sẵn trên thiết bị theo báo cáo của "dumpsys SurfaceFlinger".

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

Lấy danh sách các màn hình có thể được sử dụng để start a user visible in the background .

abstract listUsers ()

Lấy danh sách người dùng trên thiết bị.

abstract boolean logBugreport (String dataName, ITestLogger listener)

Phương pháp trợ giúp để lấy báo cáo lỗi và ghi lại cho người báo cáo.

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Đăng ký IDeviceActionReceiver cho thiết bị này.

abstract boolean removeAdmin (String componentName, int userId)

Xóa quản trị viên thiết bị nhất định trong 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 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ị 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 ở chế độ 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 ở chế độ nền nếu nó hiện đang bị dừng.

abstract boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)

Bắt đầu một người dùng nhất định ở chế độ nền, hiển thị trên màn hình nhất định (nghĩa là cho phép người dùng khởi chạy các hoạt động trong màn hình đó).

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

Lấy một báo cáo lỗi và trả về bên trong đối tượng Bugreport để xử lý nó.

abstract String uninstallPackage (String packageName)

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

abstract String uninstallPackageForUser (String packageName, int userId)

Gỡ cài đặt gói Android khỏi thiết bị cho một người dùng nhất định.

Phương pháp công khai

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Trả về liệu nó có được phép chuyển sang người dùng HỆ THỐNG không đầu hay không.

Trả lại
boolean

Ném
DeviceNotAvailableException

kiểm traKết nối

public abstract boolean checkConnectivity ()

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

Trả lại
boolean true nếu thiết bị có kết nối mạng đang hoạt động, false hoàn toàn.

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.

ClearErrorDialogs

public abstract boolean clearErrorDialogs ()

Cố gắng loại bỏ 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ị.

Trả lại
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 .

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.

clearLastConnectedWifiMạng

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 lệnh gọi mới để tránh kết nối với mạng wifi được sử dụng trong lần kiểm tra trước sau khi thiết bị khởi động lại.

kết nốiToWifiMạng

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                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ột trong các mạng wifi được cung cấp trong bản đồ wifiSsidToPsk. 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() hoặc ITestDevice#clearLastConnectedWifiNetwork() được gọi.

Thông số
wifiSsidToPsk : Bản đồ SSID wifi tới mật khẩu.

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

Trả lại
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 được.

kết nốiToWifiMạng

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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ột trong các mạng wifi được cung cấp trong bản đồ wifiSsidToPsk. 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() hoặc ITestDevice#clearLastConnectedWifiNetwork() được gọi.

Thông số
wifiSsidToPsk : Bản đồ SSID wifi tới mật khẩu.

Trả lại
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 được.

kết nốiToWifiMạ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 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() 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

Trả lại
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 được.

kết nốiToWifiMạ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 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() 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.

Trả lại
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 được.

kết nốiToWifiNetworkIfNeeded

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ả lại
boolean true nếu kết nối với mạng wifi thành công. false khác

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

kết nốiToWifiNetworkIfNeeded

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ả lại
boolean true nếu kết nối với mạng wifi thành công. false khác

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

tạo người dùng

public abstract int createUser (String name)

Tạo người dùng với tên cụ thể 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ả lại
int số nguyên cho id người dùng được tạo

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

tạo người dùng

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

Tạo người dùng với 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 --guest trong khi 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 tra --for-testing trong quá trình tạo

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

Ném
com.android.tradefed.device.DeviceNotAvailableException
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 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 --guest trong khi tạo

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

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

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

tạoUserNoThrow

public abstract int createUserNoThrow (String name)

Tạo người dùng với tên cụ thể 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ả lại
int số nguyên cho id người dùng đã tạo hoặc -1 nếu có lỗi.

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

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Xóa IDeviceActionReceiver đã đăng ký.

Thông số
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver sẽ bị xóa.

vô hiệu hóaKeyguard

public abstract void disableKeyguard ()

Cố gắng vô hiệu hóa keyguard.

Trước 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, dường 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 bảo mật)

Ném
DeviceNotAvailableException

vô hiệu hóaNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

Trả lại
boolean true nếu việc giám sát bị vô hiệu hóa thành công. false nếu nó 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 được.

ngắt kết nốiTừWifi

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 mạng đã biết và tắt wifi.

Trả lại
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ể phục hồi được.

khôngFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

Phương pháp trợ giúp để xác định xem tệp trên thiết bị có tồn tại đối với một người dùng nhất định hay không.

Thông số
deviceFilePath String : đường dẫn tuyệt đối của file trên thiết bị cần kiểm tra

userId int : ID người dùng để kiểm tra sự tồn tại của tệp

Trả lại
boolean true nếu tập tin tồn tại, false nếu khô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.

đổ đống

public abstract File dumpHeap (String process, 
                String devicePath)

Cố gắng kết xuất vùng nhớ heap từ system_server. Trách nhiệm của người gọi là dọn sạch tệp bị đổ.

Thông số
process String : tên của tiến trình thiết bị cần dumpheap.

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

Trả lại
File ERROR(/File) chứa báo cáo. Null nếu có gì đó không thành công.

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

kích hoạtNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

Trả lại
boolean true nếu giám sát được kích hoạt thành công. false nếu nó 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 được.

getActiveApexes

public abstract  getActiveApexes ()

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

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

Ném
com.android.tradefed.device.DeviceNotAvailableException
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 số {"system", "secure", "global"}

Trả lại
bản đồ của các cặp giá trị khóa. Null nếu không gian tên không được hỗ trợ.

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

lấy ID Android

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

Trả lại
String

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

lấy ID Android

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ó gì đảm bảo rằng mỗi id người dùng sẽ tìm thấy một id android được liên kết với chức năng này nên một số id người dùng có thể khớp với giá trị rỗng.

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

Ném
com.android.tradefed.device.DeviceNotAvailableException
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

Trả lại
PackageInfo PackageInfo hoặc null nếu không thể truy xuất thông tin

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

Trả lại
ERROR(/List) của PackageInfo được cài đặt trên thiết bị.

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

nhận được báo cáo lỗi

public abstract InputStreamSource getBugreport ()

Truy xuất báo cáo lỗi từ thiết bị.

Việc triển khai tính năng này được đảm bảo sẽ tiếp tục hoạt động trên thiết bị không có thẻ sdcard (hoặc nơi chưa gắn thẻ sdcard).

Trả lại
InputStreamSource Một InputStreamSource sẽ tạo ra nội dung báo cáo lỗi theo yêu cầu. Trong trường hợp thất bại, InputStreamSource sẽ tạo ra một ERROR(/InputStream) trống.

lấy báo cáo lỗi

public abstract InputStreamSource getBugreportz ()

Truy xuất báo cáo lỗi từ thiết bị. Báo cáo lỗi định dạng Zip chứa báo cáo lỗi chính và các tệp nhật ký khác hữu ích cho việc gỡ lỗi.

Chỉ được hỗ trợ cho 'phiên bản adb' > 1.0.36

Trả lại
InputStreamSource InputStreamSource của tệp zip chứa bugreportz, trả về null trong trường hợp không thành công.

get CurrentFoldableState

public abstract 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 trả về giá trị rỗng nếu xảy ra một số sự cố.

Trả lại
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

Trả về id của người dùng đang chạy. Trong trường hợp có lỗi, trả về -10000.

Trả lại
int

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

getFoldableStates

public abstract  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ể thu được bằng "trạng thái in cmd device_state".

Trả lại

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

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

lấy địa chỉ Ip

public abstract String getIpAddress ()

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

Trả lại
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 đượ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ợ.

Trả lại
KeyguardControllerState 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 được.

getMainUserId

public abstract Integer getMainUserId ()

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

Trả lại
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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Nhận thông tin về các mô-đun đường dây chính được cài đặt trên thiết bị.

Trả lại
ERROR(/Set) của mô-đun dòng chính String hiện được cài đặt trên thiết bị.

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

getMaxNumberOfRunningUsersĐược hỗ trợ

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Trả lại
int một số nguyên biểu thị số lượng người dùng đang chạy đồng thời

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

getMaxNumberOfUsersĐược hỗ trợ

public abstract int getMaxNumberOfUsersSupported ()

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

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

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

getOptions

public abstract TestDeviceOptions getOptions ()

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

Trả lại
TestDeviceOptions TestDeviceOptions liên quan đến thiết bị đang được thử nghiệm.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

Trả lại
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

lấy Ảnh chụp màn hình

public abstract InputStreamSource getScreenshot ()

Chụp ảnh màn hình từ thiết bị.

Trả lại
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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

lấy Ảnh chụp màn hình

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Chụp ảnh màn hình từ thiết bị. 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 : được hỗ trợ PNG, JPEG

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

Trả lại
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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

lấy Ảnh chụp màn hình

public abstract InputStreamSource getScreenshot (String format)

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

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

Trả lại
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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

lấy Ảnh chụp màn hình

public abstract InputStreamSource getScreenshot (long displayId)

Chụp ảnh màn hình từ thiết bị có id hiển thị. Định dạng là PNG.

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

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

Trả lại
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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

cài đặ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ả lại
String

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

cài đặ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", "secure", "global"}

Thông số
userId int

namespace String

key String

Trả lại
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
com.android.tradefed.device.DeviceNotAvailableException
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ả lại
ERROR(/Set) tên gói String có thể gỡ cài đặt hiện được cài đặt trên thiết bị.

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

getUserFlags

public abstract int getUserFlags (int userId)

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

Thông số
userId int

Trả lại
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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

lấy thông tin người dùng

public abstract  getUserInfos ()

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

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

Ném
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.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ả lại
int

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

có tính năng

public abstract boolean hasFeature (String feature)

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

Thông số
feature String : định dạng nào sẽ là "feature: " hoặc " " trực tiếp.

Trả lại
boolean Đúng nếu tìm thấy đặc điểm, nếu không thì sai.

Ném
com.android.tradefed.device.DeviceNotAvailableException
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 : file apk cần cài đặt

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

extraArgs String : đối số bổ sung tùy chọn cần truyền. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.

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ỉ 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 thời gian chạy khi cài đặt mới nên gọi hàm này.

Thông số
packageFile File : file apk cần 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 phải được cấp vào lúc cài đặt

extraArgs String : đối số bổ sung tùy chọn cần truyền. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

cài đặtPackageForUser

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ỉ 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 thời gian chạy khi cài đặt mới nên gọi hàm này.

Thông số
packageFile File : file apk cần 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 phải được cấp vào lúc cài đặt

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

extraArgs String : đối số bổ sung tùy chọn cần truyền. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

cài đặtPackageForUser

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 : file apk cần 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.

extraArgs String : đối số bổ sung tùy chọn cần truyền. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.

cài đặtGói

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

Cài đặt ứng dụng Android được tạo từ nhiều tệp APK (một gói chia nhỏ chính và gói bổ sung). 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 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ố bổ sung tùy chọn cần truyền. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

cài đặtGói

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 phân chia chính và gói bổ sung) đang có 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ỉ 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 thời gian chạy khi 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à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 phải được cấp vào lúc cài đặt

extraArgs String : đối số bổ sung tùy chọn cần truyền. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

cài đặtGóiForUser

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

Cài đặt ứng dụng Android được tạo từ nhiều tệp APK (một gói chính và gói bổ sung) 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ỉ 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 thời gian chạy khi cài đặt mới nên gọi hàm này.

Thông số
packageFiles : các 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 phải được cấp vào lúc cài đặt

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

extraArgs String : đối số bổ sung tùy chọn cần chuyển. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

cài đặtGóiForUser

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

Cài đặt ứng dụng Android được tạo từ nhiều tệp APK (một gói chính và gói bổ sung) 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 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.

extraArgs String : đối số bổ sung tùy chọn cần chuyển. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

cài đặtRemotePackages

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 phân chia chính và gói bổ sung) đang có 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ài đặt lại nên được thực hiện

extraArgs String : đối số bổ sung tùy chọn cần chuyển. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

cài đặtRemotePackages

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 phân chia chính và gói bổ sung) đang có 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ỉ 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 thời gian chạy khi 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à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 phải được cấp vào lúc cài đặt

extraArgs String : đối số bổ sung tùy chọn cần chuyển. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn.

Trả lại
String một 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.
UnsupportedOperationException nếu quyền thời gian chạy không được nền tảng trên thiết bị hỗ trợ.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Trả về việc thiết bị có sử dụng chế độ người dùng hệ thống không đầu hay không.

Trả lại
boolean

Ném
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Trả về việc người dùng chính có phải là quản trị viên thường trực hay không và không thể xóa hoặc hạ cấp xuống trạng thái không phải quản trị viên.

Trả lại
boolean

Ném
DeviceNotAvailableException

isMultiUserĐược hỗ trợ

public abstract boolean isMultiUserSupported ()

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

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

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

isPackageĐã cài đặt

public abstract boolean isPackageInstalled (String packageName)

Truy vấn thiết bị để biế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

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

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

isPackageĐã cài đặt

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 nhất định để kiểm tra xem nó 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 chưa. Nếu null, số 0 của người dùng chính sẽ được sử dụng.

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

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

isUserRunning

public abstract boolean isUserRunning (int userId)

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

Thông số
userId int

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

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Trả lại
boolean đúng nếu người dùng là phụ, sai nếu không.

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

isUserVisible

public abstract boolean isUserVisible (int userId)

Kiểm tra xem người dùng đã cho có hiển thị hay không.

Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể khởi chạy các hoạt động khởi chạy (thường ở màn hình mặc định).

Thông số
userId int

Trả lại
boolean

Ném
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Kiểm tra xem người dùng nhất định có hiển thị trong màn hình nhất định hay không.

Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể khởi chạy các hoạt động khởi chạy trong màn hình đó.

Thông số
userId int

displayId int

Trả lại
boolean

Ném
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplayĐược hỗ trợ

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Trả về xem thiết bị có cho phép người dùng khởi động ở chế độ nền trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

Nếu đúng như vậy, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean) , chuyển một màn hình được trả về bởi listDisplayIdsForStartingVisibleBackgroundUsers() (cần bao gồm ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

Trả lại
boolean

Ném
DeviceNotAvailableException

isVisibleBackgroundUsersĐược hỗ trợ

public abstract boolean isVisibleBackgroundUsersSupported ()

Trả về việc thiết bị có cho phép người dùng bắt đầu hiển thị ở chế độ nền hay không.

Nếu đúng như vậy, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean) , chuyển một màn hình được trả về bởi listDisplayIdsForStartingVisibleBackgroundUsers() .

Trả lại
boolean

Ném
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Kiểm tra xem wifi có được bật hay không.

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

Trả lại
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ể phục hồi được.

danh sáchId hiển thị

public abstract  listDisplayIds ()

Thu thập danh sách id hiển thị có sẵn trên thiết bị theo báo cáo của "dumpsys SurfaceFlinger".

Trả lại
Danh sách hiển thị. Mặc định luôn trả về hiển thị mặc định 0.

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Lấy danh sách các màn hình có thể được sử dụng để start a user visible in the background .

Trả lại

Ném
DeviceNotAvailableException

danh sáchNgười dùng

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ả lại
danh sách id người dùng.

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

logBáo cáo lỗi

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Phương pháp trợ giúp để lấy báo cáo lỗi và ghi lại cho người báo cáo.

Thông số
dataName String : tên mà báo cáo lỗi sẽ được báo cáo.

listener ITestLogger : ITestLogger để ghi lại báo cáo lỗi.

Trả lại
boolean Đúng nếu ghi nhật ký thành công, ngược lại là sai.

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Đăng ký IDeviceActionReceiver cho thiết bị này.

Tất cả các IDeviceActionReceiver đã đăng ký sẽ được thông báo trước khi hành động của thiết bị bắt đầu và sau khi hành động của thiết bị kết thúc.

Thông số
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver sẽ được đăng ký.

xóaQuản trị viên

public abstract boolean removeAdmin (String componentName, 
                int userId)

Xóa quản trị viên thiết bị nhất định trong 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.

Trả lại
boolean Đúng nếu thành công, ngược lại là sai.

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

xóaChủ sở hữu

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 tốt nhất.

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

xóaNgườ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 cần xóa

Trả lại
boolean đúng nếu chúng tôi xóa thành công người dùng, nếu không thì sai.

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

setChủ sở hữu thiết bị

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

Trả lại
boolean Đúng nếu thành công, ngược lại là sai.

Ném
com.android.tradefed.device.DeviceNotAvailableException
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
com.android.tradefed.device.DeviceNotAvailableException
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
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

người dùng bắt đầu

public abstract boolean startUser (int userId)

Bắt đầu một người dùng nhất định ở chế độ 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.

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

Trả lại
boolean đúng nếu người dùng đã khởi động thành công ở chế độ nền.

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

người dùng bắt đầu

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Bắt đầu một người dùng nhất định ở chế độ 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 ở chế độ nền

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

Trả lại
boolean đúng nếu người dùng đã khởi động thành công ở chế độ nền.

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

startVisibleBackgroundUser

public abstract boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Bắt đầu một người dùng nhất định ở chế độ nền, hiển thị trên màn hình nhất định (nghĩa 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, màn hình có khả dụng hay không, device supports such feature , v.v.

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

displayId int : hiển thị để bắt đầu hiển thị người dùng trên

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

Trả lại
boolean true nếu người dùng đã khởi động thành công ở chế độ nền.

Ném
DeviceNotAvailableException

dừng lạiNgười 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ờ 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 lại.

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

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

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

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

dừng lạiNgười 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 đã bị dừng thì 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.

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

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

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

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ả lại
boolean Đúng nếu userId mới khớp với nhà cung cấp userId. Sai nếu không.

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

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

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 tính năng bảo vệ bàn phím 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ả lại
boolean Đúng nếu userId mới khớp với nhà cung cấp userId. Sai nếu không.

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

lấy báo cáo lỗi

public abstract Bugreport takeBugreport ()

Lấy một báo cáo lỗi và trả về bên trong đối tượng Bugreport để xử lý nó. Trả về null trong trường hợp có vấn đề. Tệp được tham chiếu trong đối tượng Bugreport cần được xóa thông qua Bugreport.close() .

Trả lại
Bugreport

gỡ cài đặtGói

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ả lại
String một 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.

UninstallpackageForuser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Gỡ cài đặt gói Android khỏi thiết bị cho một người dùng nhất định.

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

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

Trả lại
String một 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.