Thiết bị thử nghiệm

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Các lớp con gián tiếp đã biết IManagedTestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice IManagedTestDevice Một ITestDevice có vòng đời được quản lý.  LocalAndroidVirtualDevice Lớp dành cho các thiết bị ảo cục bộ chạy trên máy chủ TradeFed.  ManagedRemoteDevice Một thiết bị chạy bên trong máy ảo mà chúng tôi quản lý từ xa thông qua một thực thể Tradefeed bên trong máy ảo.  NativeDevice Phương thức triển khai mặc định của ITestDevice Thiết bị Android không ở trong ngăn xếp đầy đủ.  NestedRemoteDevice Hình minh hoạ thiết bị chạy trong máy ảo Mực nang từ xa.  RemoteAndroidDevice Triển khai ITestDevice cho thiết bị Android đầy đủ ngăn xếp được kết nối qua Kết nối adb.  RemoteAndroidVirtualDevice Mở rộng hành vi RemoteAndroidDevice cho thiết bị Android đầy đủ ngăn xếp chạy trong Google Compute Engine (Gce).  TestDevice (Thiết bị thử nghiệm) Triển khai ITestDevice cho thiết bị Android đầy đủ ngăn xếp

---

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

Thử lại các lệnh trên thiết bị với số tiền có thể định cấu hình và cung cấp dịch vụ khôi phục thiết bị cho các thiết bị không phản hồi.

Tóm tắt

Lớp lồng ghép
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

Phương thức công khai
abstract boolean	canSwitchToHeadlessSystemUser() Trả về việc có được phép chuyển sang người dùng HỆ THỐNG không có giao diện người dùng hay không.
abstract boolean	checkConnectivity() Kiểm tra để đảm bảo rằng thiết bị có kết nối mạng.
abstract boolean	clearErrorDialogs() Hãy thử loại bỏ mọi hộp thoại lỗi đang hiển thị trên giao diện người dùng của thiết bị.
abstract void	clearLastConnectedWifiNetwork() Xoá mạng Wi-Fi kết nối gần đây nhất.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk) Kết nối với mạng Wi-Fi.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid) Kết nối với mạng Wi-Fi.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk) Kết nối với mạng Wi-Fi.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid) Kết nối với mạng Wi-Fi.
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 một người dùng bằng tên cụ thể và cờ mặc định là 0.
abstract int	createUser(String name, boolean guest, boolean ephemeral) Tạo một người dùng bằng tên cụ thể và cờ được cung cấp
abstract int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Tạo một người dùng bằng tên cụ thể và cờ được cung cấp
abstract int	createUserNoThrow(String name) Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0.
abstract void	deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Xoá IDeviceActionReceiver đã đăng ký.
abstract void	disableKeyguard() Cố gắng tắt tính năng bảo vệ bàn phím.
abstract boolean	disableNetworkMonitor() Tắt tính năng giám sát mạng trên thiết bị.
abstract boolean	disconnectFromWifi() Ngắt kết nối khỏi mạng Wi-Fi.
abstract boolean	doesFileExist(String deviceFilePath, int userId) Phương thức trợ giúp để xác định xem một người dùng cụ thể có tồn tại tệp trên thiết bị hay không.
abstract File	dumpHeap(String process, String devicePath) Thử kết xuất vùng nhớ khối xếp từ system_server.
abstract boolean	enableNetworkMonitor() Bật tính năng giám sát mạng trên thiết bị.
abstract	getActiveApexes() Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị.
abstract	getAllSettings(String namespace) Trả về cặp khoá-giá trị 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 mã nhận dạng Android tìm thấy khớp với mã nhận dạng người dùng.
abstract PackageInfo	getAppPackageInfo(String packageName) Tìm nạp thông tin về một gói đã cài đặt trên thiết bị.
abstract	getAppPackageInfos() Tìm nạp thông tin của các gói đã 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 gập hiện tại của thiết bị hoặc rỗng nếu xảy ra một số vấn đề.
abstract int	getCurrentUser() Trả về mã nhận dạng của người dùng hiện đang chạy.
abstract	getFoldableStates() Trả về danh sách trạng thái gập 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 để nhận trạng thái hiện tại của tính năng bảo vệ bàn phím hoặc trả về giá trị rỗng nếu không được hỗ trợ.
abstract Integer	getMainUserId() Trả về mã nhận dạng người dùng chính.
abstract	getMainlineModuleInfo() Lấy 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 tối đa người dùng chạy đồng thời được hỗ trợ.
abstract int	getMaxNumberOfUsersSupported() Nhận số lượng người dùng được hỗ trợ tối đa.
abstract TestDeviceOptions	getOptions() Tìm nạp các tuỳ chọn kiểm thử cho thiết bị.
abstract Integer	getPrimaryUserId() Trả về mã nhận dạng người dùng chính.
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ó mã hiển thị được cung cấp.
abstract InputStreamSource	getScreenshot() Chụp ảnh màn hình từ thiết bị.
abstract String	getSetting(int userId, String namespace, String key) Trả về giá trị của chế độ cài đặt được yêu cầu.
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	getUninstallablePackageNames() Tìm nạp tên gói ứng dụng có thể gỡ cài đặt.
abstract int	getUserFlags(int userId) Tìm và trả về cờ của một người dùng cụ thể.
abstract	getUserInfos() Tải Map of useId cho UserInfo trên thiết bị.
abstract int	getUserSerialNumber(int userId) Trả lại số sê-ri được liên kết với userId nếu có, -10000 trong mọi trường hợp khác.
abstract boolean	hasFeature(String feature) Kiểm tra xem thiết bị có tính năng nào không.
abstract String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Cài đặt một gói Android trên thiết bị.
abstract String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Cài đặt một gói Android trên thiết bị.
abstract String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Cài đặt một gói Android trên thiết bị cho một người dùng cụ thể.
abstract String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Cài đặt một gói Android trên thiết bị cho một người dùng cụ thể.
default String	installPackages( packageFiles, boolean reinstall, String... extraArgs) Cài đặt một ứng dụng Android từ nhiều tệp APK (một gói phân tách chính và một gói phân tách phụ).
default String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Cài đặt một ứng dụng Android được tạo từ nhiều tệp APK (một gói phân tách chính và một gói phân tách phụ) trên thiết bị Android.
default String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs) Cài đặt một ứng dụng Android được tạo từ nhiều tệp APK (một gói phân tách chính và một gói phân tách phụ) cho một người dùng cụ thể.
default String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Cài đặt một ứng dụng Android được tạo từ nhiều tệp APK (một gói phân tách chính và một gói phân tách phụ) cho một người dùng cụ thể.
default String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs) Cài đặt một ứng dụng Android được tạo từ nhiều tệp APK (một gói phân tách chính và một gói phân tách phụ) trên thiết bị Android.
default String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Cài đặt một ứng dụng Android được tạo từ nhiều tệp APK (một gói phân tách chính và một gói phân tách phụ) 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 có giao diện người dùng 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 vĩnh viễn và không thể bị xoá hoặc hạ cấp xuống không phải quản trị viên.
abstract boolean	isMultiUserSupported() Xác định xem có hỗ trợ nhiều người dùng hay không.
abstract boolean	isPackageInstalled(String packageName, String userId) Truy vấn thiết bị để biết một tên gói cụ thể và mã nhận dạng người dùng được cung cấp để kiểm tra xem gói đó hiện đã cài đặt hoặc chưa được cài đặt cho người dùng đó.
abstract boolean	isPackageInstalled(String packageName) Truy vấn thiết bị về một tên gói cụ thể để kiểm tra xem thiết bị đã được cài đặt hay chưa.
abstract boolean	isUserRunning(int userId) Kiểm tra xem một người dùng cụ thể có đang chạy hay không.
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ụ hay không theo cờ của ứng dụng đó.
abstract boolean	isUserVisible(int userId) Kiểm tra xem người dùng cụ thể có hiển thị hay không.
abstract boolean	isUserVisibleOnDisplay(int userId, int displayId) Kiểm tra xem người dùng cụ thể có xuất hiện trên màn hình cụ thể hay không.
abstract boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() Trả về xem thiết bị có cho phép người dùng bắt đầu xuất hiện ở chế độ nền trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) hay không.
abstract boolean	isVisibleBackgroundUsersSupported() Trả về xem thiết bị có cho phép người dùng bắt đầu xuất hiện ở chế độ nền hay không.
abstract boolean	isWifiEnabled() Kiểm tra xem Wi-Fi đã được bật chưa.
abstract	listDisplayIds() Thu thập danh sách mã màn hình có sẵn trên thiết bị theo báo cáo của "dumpsys SurfaceFlinger".
abstract	listDisplayIdsForStartingVisibleBackgroundUsers() Lấy danh sách màn hình có thể 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 để báo cáo lỗi và ghi báo cáo đó cho người báo cáo.
default void	notifySnapuserd(SnapuserdWaitPhase waitPhase) Thông báo cho thiết bị chờ hoàn tất nhanh.
abstract void	registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Đăng ký một IDeviceActionReceiver cho thiết bị này.
abstract boolean	removeAdmin(String componentName, int userId) Xoá 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, nếu không thì trả về false.
abstract void	removeOwners() Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có một cách hiệu quả nhất có thể.
abstract boolean	removeUser(int userId) Xoá một người dùng cụ thể khỏi thiết bị.
abstract boolean	setDeviceOwner(String componentName, int userId) Đặt mộ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 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 giá trị cài đặt vào không gian tên của một người dùng cụ thể.
abstract boolean	startUser(int userId) Bắt đầu một người dùng cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng.
abstract boolean	startUser(int userId, boolean waitFlag) Bắt đầu một người dùng cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng.
abstract boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) Bắt đầu một người dùng cụ thể ở chế độ nền, hiển thị trên màn hình đã cho (tức là cho phép người dùng đó để khởi chạy các hoạt động trong màn hình đó).
abstract boolean	stopUser(int userId) Dừng một người dùng cụ thể.
abstract boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Dừng một người dùng cụ thể.
abstract boolean	switchUser(int userId) Chuyển sang một userId khác có thời gian chờ mặc định.
abstract boolean	switchUser(int userId, long timeout) Hãy chuyển sang một userId khác có thời gian chờ đã cung cấp làm thời hạn.
abstract Bugreport	takeBugreport() Tạo báo cáo lỗi và trả về bên trong đối tượng Bugreport để xử lý.
abstract String	uninstallPackage(String packageName) Gỡ cài đặt một gói Android khỏi thiết bị.
abstract String	uninstallPackageForUser(String packageName, int userId) Gỡ cài đặt một gói Android khỏi thiết bị của một người dùng cụ thể.
default void	waitForSnapuserd(SnapuserdWaitPhase currentPhase) Nếu được, hãy đợi quá trình chụp nhanh hoàn tất.

Phương thức công khai

Người dùng canSwitchTo HeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Trả về việc có cho phép chuyển sang người dùng HỆ THỐNG không có giao diện người dùng hay không.

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

kiểm tra kết nối

public abstract boolean checkConnectivity ()

Kiểm tra để đảm bảo rằng thiết bị có kết nối mạng.

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

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Hãy thử loại bỏ mọi hộp thoại lỗi đang hiển thị trên giao diện người dùng của thiết bị.

Giá trị trả về
boolean	true nếu không có hộp thoại nào hoặc các hộp thoại đã được xoá thành công. false.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

clearLastConnectWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Xoá mạng Wi-Fi kết nối gần đây nhất. Lệnh gọi này sẽ được gọi khi bắt đầu một lệnh gọi mới để tránh kết nối với mạng Wi-Fi được dùng trong thử nghiệm trước đó sau khi thiết bị khởi động lại.

kết nối vớiMạng Wifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Kết nối với mạng Wi-Fi.

Bật Wi-Fi và chặn cho đến khi kết nối thành công với một trong các Wi-Fi các mạng được cung cấp trong bản đồ wifiSsidToPsk. Sau khi kết nối, thực thể máy ảo sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến ITestDevice#disconnectFromWifi() hoặc ITestDevice#clearLastConnectedWifiNetwork() sẽ được gọi.

Tham số
wifiSsidToPsk	: Bản đồ các SSID của Wi-Fi đến mật khẩu.

Giá trị trả về
boolean	true nếu đã kết nối thành công với mạng Wi-Fi. false nếu không

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

kết nối vớiMạng Wifi

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Kết nối với mạng Wi-Fi.

Bật Wi-Fi và chặn cho đến khi kết nối thành công với một trong các Wi-Fi mạng được cung cấp trong bản đồ wifiSsidToPsk. Sau khi kết nối, thực thể máy ảo sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến ITestDevice#disconnectFromWifi() hoặc ITestDevice#clearLastConnectedWifiNetwork() sẽ được gọi.

Tham số
wifiSsidToPsk	: Bản đồ các SSID của Wi-Fi đến mật khẩu.
scanSsid	boolean: xem có quét tìm SSID ẩn cho mạng này hay không.

Giá trị trả về
boolean	true nếu đã kết nối thành công với mạng Wi-Fi. false nếu không

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

kết nối vớiMạng Wifi

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Kết nối với mạng Wi-Fi.

Bật Wi-Fi và chặn cho đến khi kết nối thành công với mạng Wi-Fi được chỉ định. Sau khi tạo kết nối, thực thể máy ảo này sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến ITestDevice#disconnectFromWifi() hoặc ITestDevice#clearLastConnectedWifiNetwork() sẽ được gọi.

Tham số
wifiSsid	String: ssid Wi-Fi cần kết nối
wifiPsk	String: Cụm mật khẩu PSK hoặc rỗng nếu không được mã hoá

Giá trị trả về
boolean	true nếu đã kết nối thành công với mạng Wi-Fi. false nếu không

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

kết nối vớiMạng Wifi

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

Kết nối với mạng Wi-Fi.

Bật Wi-Fi và chặn cho đến khi kết nối thành công với mạng Wi-Fi được chỉ định. Sau khi tạo kết nối, thực thể máy ảo này sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến ITestDevice#disconnectFromWifi() hoặc ITestDevice#clearLastConnectedWifiNetwork() sẽ được gọi.

Tham số
wifiSsid	String: ssid Wi-Fi cần kết nối
wifiPsk	String: Cụm mật khẩu PSK hoặc rỗng nếu không được mã hoá
scanSsid	boolean: xem có quét tìm SSID ẩn cho mạng này hay không.

Giá trị trả về
boolean	true nếu đã kết nối thành công với mạng Wi-Fi. false nếu không

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

kết nối vớiWi-FiMạng nếu cần

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.

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

Giá trị trả về
boolean	true nếu đã kết nối thành công với mạng Wi-Fi. false nếu không

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

kết nối vớiWi-FiMạng nếu cần

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.

Giá trị trả về
boolean	true nếu đã kết nối thành công với mạng Wi-Fi. false nếu không

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Tạo người dùng

public abstract int createUser (String name)

Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0.

Tham số
name	String: số người dùng được tạo trên thiết bị

Giá trị trả về
int	số nguyên cho mã nhận dạng người dùng đã tạo

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Tạo người dùng

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

Tạo một người dùng bằng tên cụ thể và cờ được cung cấp

Tham số
name	String: số người dùng được tạo trên thiết bị
guest	boolean: bật cờ người dùng – khách trong quá trình tạo
ephemeral	boolean: bật cờ người dùng -- tạm thời trong quá trình tạo

Giá trị trả về
int	mã nhận dạng của người dùng đã tạo

Gửi
	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 một người dùng bằng tên cụ thể và cờ được cung cấp

Tham số
name	String: số người dùng được tạo trên thiết bị
guest	boolean: bật cờ người dùng – khách trong quá trình tạo
ephemeral	boolean: bật cờ người dùng -- tạm thời trong quá trình tạo
forTesting	boolean: bật cờ kiểm thử để kiểm thử trong quá trình tạo

Giá trị trả về
int	mã nhận dạng của người dùng đã tạo

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Tạo người dùngKhông có hoạt động

public abstract int createUserNoThrow (String name)

Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0.

Tham số
name	String: số người dùng được tạo trên thiết bị

Giá trị trả về
int	số nguyên cho mã nhận dạng người dùng được tạo hoặc -1 nếu bị lỗi.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

huỷ đăng kýDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Xoá IDeviceActionReceiver đã đăng ký.

Tham số
deviceActionReceiver	IDeviceActionReceiver: Một IDeviceActionReceiver sẽ bị xoá.

tắt tính năng Bảo vệ bàn phím

public abstract void disableKeyguard ()

Cố gắng tắt tính năng bảo vệ bàn phím.

Trước tiên, hãy đợi việc truyền dữ liệu đầu vào sẵn sàng, điều này xảy ra cùng khoảng thời gian khi thiết bị báo cáo BOOT_complete, có vẻ như không đồng bộ, vì khung hiện tại Việc triển khai không thường xuyên có tình huống tương tranh. Sau đó, lệnh được gửi để đóng tính năng bảo vệ bàn phím (hoạt động chỉ đối với những miền không an toàn)

Gửi
DeviceNotAvailableException

vô hiệu hoáNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

Giá trị trả về
boolean	true nếu bạn tắt tính năng giám sát thành công. false nếu không thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

ngắt kết nối TừWifi

public abstract boolean disconnectFromWifi ()

Ngắt kết nối khỏi mạng Wi-Fi.

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

Giá trị trả về
boolean	true nếu đã ngắt kết nối thành công khỏi mạng Wi-Fi. false nếu ngắt kết nối không thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

notFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Tham số
deviceFilePath	String: đường dẫn tuyệt đối của tệp trên thiết bị cần kiểm tra
userId	int: Mã nhận dạng người dùng để kiểm tra sự tồn tại của tệp

Giá trị trả về
boolean	true nếu tệp tồn tại, nếu không thì false.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

Tệp báo lỗi

public abstract File dumpHeap (String process, 
                String devicePath)

Thử kết xuất vùng nhớ khối xếp từ system_server. Người gọi có trách nhiệm dọn dẹp tệp kết xuất.

Tham số
process	String: tên của quy trình thiết bị để tệp kết xuất.
devicePath	String: đường dẫn trên thiết bị nơi để tệp kết xuất. Đây phải là địa điểm mà quyền cho phép cài đặt đó.

Giá trị trả về
File	ERROR(/File) chứa báo cáo. Giá trị rỗng nếu có lỗi xảy ra.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

bậtNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

Giá trị trả về
boolean	true nếu tính năng giám sát được bật thành công. false nếu không thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

getActiveApexes

public abstract  getActiveApexes ()

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

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

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getTất cả chế độ cài đặt

public abstract  getAllSettings (String namespace)

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

Tham số
namespace	String: phải là một trong các giá trị {"system", "secure", "global"}

Giá trị trả về
	sơ đồ các cặp khoá-giá trị. Rỗng nếu không gian tên không được hỗ trợ.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

Tham số
userId	int

Giá trị trả về
String

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Tạo Bản đồ các mã nhận dạng Android tìm thấy khớp với mã nhận dạng người dùng. Không có bảo hiểm mà mỗi người dùng mã nhận dạng sẽ tìm thấy mã nhận dạng Android được liên kết trong hàm này, vì vậy, một số mã nhận dạng người dùng có thể khớp với giá trị rỗng.

Giá trị trả về
	Bản đồ mã nhận dạng Android tìm thấy mã nhận dạng người dùng trùng khớp.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Tham số
packageName	String

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

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Tìm nạp thông tin của các gói đã cài đặt trên thiết bị.

Giá trị trả về
	Đã cài đặt ERROR(/List)/PackageInfo trên thiết bị.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

nhận 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 đảm bảo sẽ tiếp tục hoạt động trên thiết bị không có thẻ sd (hoặc khi thẻ sd chưa được gắn).

Giá trị trả về
InputStreamSource	InputStreamSource sẽ tạo nội dung báo cáo lỗi theo yêu cầu. Ngang bằng trường hợp không thành công, InputStreamSource sẽ tạo ra một ERROR(/InputStream) trống.

lỗi 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ỉ hỗ trợ cho "phiên bản adb" > 1.0.36

Giá trị trả về
InputStreamSource	InputStreamSource của tệp zip chứa báo cáo lỗi, trả về giá trị rỗng trong trường hợp không thành công.

Nhận trạng thái có thể gập lại hiện tại

public abstract DeviceFoldableState getCurrentFoldableState ()

Trả về trạng thái gập hiện tại của thiết bị hoặc rỗng nếu xảy ra một số vấn đề.

Giá trị trả về
DeviceFoldableState

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

nhận người dùng hiện tại

public abstract int getCurrentUser ()

Trả về mã nhận dạng của người dùng hiện đang chạy. Trong trường hợp lỗi, hãy trả về -10000.

Giá trị trả về
int

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

có thể gập lạiStates

public abstract  getFoldableStates ()

Trả về danh sách trạng thái gập trên thiết bị. Có thể lấy được bằng lệnh "cmd device_state" trạng thái in".

Giá trị trả về

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstallPackageNames

public abstract  getInstalledPackageNames ()

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

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

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

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

Giá trị trả về
String	địa chỉ IP của thiết bị hoặc null nếu thiết bị không có địa chỉ IP

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

nhận trạng thái bảo vệ phím

public abstract KeyguardControllerState getKeyguardState ()

Trả về một đối tượng để nhận trạng thái hiện tại của tính năng bảo vệ bàn phím hoặc trả về giá trị rỗng nếu không được hỗ trợ.

Giá trị trả về
KeyguardControllerState	KeyguardControllerState chứa thông tin tổng quan nhanh về trạng thái của tính năng khoá bàn phím và trả về giá trị Null nếu truy vấn Bàn phím không được hỗ trợ.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

getMainUserId

public abstract Integer getMainUserId ()

Trả về mã nhận dạng người dùng chính.

Giá trị trả về
Integer	userId của người dùng chính nếu có và rỗng nếu không có người dùng chính.

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

Giá trị trả về
	ERROR(/Set)/String mô-đun đường dây chính hiện đã được cài đặt trên thiết bị.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningNgười dùng được hỗ trợ

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Giá trị trả về
int	một số nguyên cho biết số người dùng chạy đồng thời

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

Giá trị trả về
int	số nguyên cho biết số lượng người dùng được hỗ trợ

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Tìm nạp các tuỳ chọn kiểm thử cho thiết bị.

Giá trị trả về
TestDeviceOptions	TestDeviceOptions liên quan đến thiết bị đang được kiểm thử.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Trả về mã nhận dạng người dùng chính.

Giá trị trả về
Integer	userId của người dùng chính nếu có và rỗng nếu không có người dùng chính.

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

getẢ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ị. Nên dùng getScreenshot(String) với mã hoá JPEG cho kích thước nhỏ hơn.

Tham số
format	String: PNG, JPEG được hỗ trợ
rescale	boolean: nếu cần điều chỉnh ảnh chụp màn hình để giảm kích thước của hình ảnh thu được

Giá trị trả về
InputStreamSource	InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu chụp ảnh màn hình không thành công.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getẢnh chụp màn hình

public abstract InputStreamSource getScreenshot (String format)

Chụp ảnh màn hình từ thiết bị. Bạn nên sử dụng phương thức getScreenshot(format) thay vì phương thức mã hoá JPEG cho kích thước nhỏ hơn

Tham số
format	String: PNG, JPEG được hỗ trợ

Giá trị trả về
InputStreamSource	InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu ảnh chụp màn hình không thành công.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getẢ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ó mã hiển thị được cung cấp. Định dạng là PNG.

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

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

Giá trị trả về
InputStreamSource	InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu chụp ảnh màn hình không thành công.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getẢnh chụp màn hình

public abstract InputStreamSource getScreenshot ()

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

Giá trị trả về
InputStreamSource	InputStreamSource của ảnh chụp màn hình ở định dạng png hoặc null nếu ảnh chụp màn hình không thành công.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCài đặt

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

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

Tham số
userId	int
namespace	String
key	String

Giá trị trả về
String	giá trị được liên kết với không gian tên:khoá của một người dùng. Rỗng nếu không tìm thấy.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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

Tham số
namespace	String
key	String

Giá trị trả về
String

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

Giá trị trả về
	ERROR(/Set) tên gói String có thể gỡ cài đặt hiện được cài đặt trên thiết bị.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserflag

public abstract int getUserFlags (int userId)

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

Tham số
userId	int

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

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfo

public abstract  getUserInfos ()

Tải Map of useId cho UserInfo trên thiết bị. Sẽ gửi DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.

Giá trị trả về
	danh sách đối tượng UserInfo.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Trả lại số sê-ri được liên kết với userId nếu có, -10000 trong mọi trường hợp khác.

Tham số
userId	int

Giá trị trả về
int

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

cóTính năng

public abstract boolean hasFeature (String feature)

Kiểm tra xem thiết bị có tính năng nào không.

Tham số
feature	String: định dạng phải là "feature:" hoặc "" trực tiếp.

Giá trị trả về
boolean	"True" nếu tìm thấy đối tượng, nếu không thì sẽ trả về.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

lượt cài đặt

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

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

Tham số
packageFile	File: tệp APK cần cài đặt
reinstall	boolean: true nếu thực hiện cài đặt lại
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

lượt cài đặt

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

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

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

Tham số
packageFile	File: tệp APK cần cài đặt
reinstall	boolean: true nếu thực hiện cài đặt lại
grantPermissions	boolean: nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.
UnsupportedOperationException	nếu nền tảng không hỗ trợ quyền khi bắt đầu chạy trên thiết bị.

installPackageForUser

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

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

Tham số
packageFile	File: tệp APK cần cài đặt
reinstall	boolean: true nếu cần cài đặt lại
userId	int: mã nhận dạng người dùng dạng số nguyên cần cài đặt.
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

installPackageForUser

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

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

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

Tham số
packageFile	File: tệp APK cần cài đặt
reinstall	boolean: true nếu thực hiện cài đặt lại
grantPermissions	boolean: nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt
userId	int: mã nhận dạng người dùng dạng số nguyên cần cài đặt.
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.
UnsupportedOperationException	nếu nền tảng không hỗ trợ quyền khi bắt đầu chạy trên thiết bị.

lượt cài đặt

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

Cài đặt một ứng dụng Android từ nhiều tệp APK (một gói phân tách chính và một gói phân tách phụ). Hãy xem bài viết "https://developer.android.com/studio/build/configure-apk-parses" về cách chia apk thành nhiều tệp.

Tham số
packageFiles	: tệp APK cục bộ
reinstall	boolean: true nếu cần cài đặt lại
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.
UnsupportedOperationException	nếu nền tảng không hỗ trợ quyền khi bắt đầu chạy trên thiết bị.

lượt cài đặt

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

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

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

Tham số
packageFiles	: đường dẫn tệp APK từ xa để cài đặt
reinstall	boolean: true nếu cần cài đặt lại
grantPermissions	boolean: nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.
UnsupportedOperationException	nếu nền tảng không hỗ trợ quyền khi bắt đầu chạy trên thiết bị.

lượt cài đặtGói cho người dùng

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

Cài đặt một ứng dụng Android được tạo từ nhiều tệp APK (một gói phân tách chính và một gói phân tách phụ) cho một người dùng cụ thể. Hãy xem bài viết "https://developer.android.com/studio/build/configure-apk-parses" về cách chia apk thành nhiều tệp.

Tham số
packageFiles	: tệp APK cục bộ
reinstall	boolean: true nếu cần cài đặt lại
userId	int: mã nhận dạng người dùng dạng số nguyên cần cài đặt.
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.
UnsupportedOperationException	nếu nền tảng không hỗ trợ quyền khi bắt đầu chạy trên thiết bị.

lượt cài đặtGói cho người dùng

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

Cài đặt một ứng dụng Android được tạo từ nhiều tệp APK (một gói phân tách chính và một gói phân tách phụ) cho một người dùng cụ thể. Hãy xem bài viết "https://developer.android.com/studio/build/configure-apk-parses" về cách chia apk thành nhiều tệp.

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

Tham số
packageFiles	: tệp APK cục bộ
reinstall	boolean: true nếu cần cài đặt lại
grantPermissions	boolean: nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt
userId	int: mã nhận dạng người dùng dạng số nguyên cần cài đặt.
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.
UnsupportedOperationException	nếu nền tảng không hỗ trợ quyền khi bắt đầu chạy trên thiết bị.

cài đặtRemotePackages

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

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

Tham số
remoteApkPaths	: đường dẫn tệp APK từ xa
reinstall	boolean: true nếu cần cài đặt lại
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.
UnsupportedOperationException	nếu nền tảng không hỗ trợ quyền khi bắt đầu chạy trên thiết bị.

cài đặtRemotePackages

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

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

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

Tham số
remoteApkPaths	: đường dẫn tệp APK từ xa
reinstall	boolean: true nếu cần cài đặt lại
grantPermissions	boolean: nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt
extraArgs	String: đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn .

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.
UnsupportedOperationException	nếu nền tảng không hỗ trợ quyền khi bắt đầu chạy trên thiết bị.

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 có giao diện người dùng hay không.

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isMainUserNgười Quản trị viên Vĩnh viễn

public abstract boolean isMainUserPermanentAdmin ()

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

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

được MultiUser hỗ trợ

public abstract boolean isMultiUserSupported ()

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

Giá trị trả về
boolean	true nếu nhiều người dùng được hỗ trợ, false nếu không hỗ trợ nhiều người dùng

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Đã cài đặt gói isPackage

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Truy vấn thiết bị để biết một tên gói cụ thể và mã nhận dạng người dùng được cung cấp để kiểm tra xem gói đó hiện đã cài đặt hoặc chưa được cài đặt cho người dùng đó.

Tham số
packageName	String: gói mà chúng ta đang kiểm tra xem đã được cài đặt hay chưa.
userId	String: Mã nhận dạng người dùng mà chúng ta đang kiểm tra gói đã được cài đặt hay chưa. Nếu rỗng, người dùng chính 0 sẽ được sử dụng.

Giá trị trả về
boolean	Đúng nếu gói được báo cáo là đã cài đặt. Nếu không thì là False.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Đã cài đặt gói isPackage

public abstract boolean isPackageInstalled (String packageName)

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

Tham số
packageName	String

Giá trị trả về
boolean	Đúng nếu gói được báo cáo là đã cài đặt. Nếu không thì là False.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

đang chạy người dùng

public abstract boolean isUserRunning (int userId)

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

Tham số
userId	int

Giá trị trả về
boolean	"True" nếu người dùng đang chạy, "false" trong mọi trường hợp khác.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserPhụ

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ụ hay không theo cờ của ứng dụng đó.

Tham số
userId	int

Giá trị trả về
boolean	true nếu người dùng là phụ, false nếu người dùng không là phụ.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Hiển thị người dùng

public abstract boolean isUserVisible (int userId)

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

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

Tham số
userId	int

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

hiển thị người dùng trên màn hình

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Kiểm tra xem người dùng cụ thể có xuất hiện trên màn hình cụ thể hay không.

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

Tham số
userId	int
displayId	int

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isHiển thịBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

Nếu có, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean), truyền màn hình được listDisplayIdsForStartingVisibleBackgroundUsers() trả về.

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Kiểm tra xem Wi-Fi đã được bật chưa.

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

Giá trị trả về
boolean	true nếu Wi-Fi đã bật. false nếu đã tắt

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

listDisplayIds

public abstract  listDisplayIds ()

Thu thập danh sách mã màn hình có sẵn trên thiết bị theo báo cáo của "dumpsys SurfaceFlinger".

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

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForĐể Khởi độngHiển thịNgười dùngNền

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Giá trị trả về

Gửi
DeviceNotAvailableException

Người dùng list

public abstract  listUsers ()

Lấy danh sách người dùng trên thiết bị. Sẽ gửi DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.

Giá trị trả về
	danh sách id người dùng.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

báo cáo lỗi

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

Tham số
dataName	String: tên mà báo cáo lỗi sẽ được báo cáo.
listener	ITestLogger: ITestLogger để ghi nhật ký báo cáo lỗi.

Giá trị trả về
boolean	True nếu quá trình ghi nhật ký thành công, nếu không thì sẽ trả về false.

notificationSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Thông báo cho thiết bị chờ hoàn tất nhanh.

Tham số
waitPhase	SnapuserdWaitPhase

subscriptionDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

Tham số
deviceActionReceiver	IDeviceActionReceiver: Một IDeviceActionReceiver sẽ được đăng ký.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Xoá 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, nếu không thì trả về false.

Tham số
componentName	String: quản trị viên thiết bị sẽ bị loại bỏ.
userId	int: người dùng thuộc quyền quản trị viên thiết bị.

Giá trị trả về
boolean	"True" nếu thành công, nếu không thì sẽ trả lời sai.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có một cách hiệu quả nhất có thể.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

xoá người dùng

public abstract boolean removeUser (int userId)

Xoá một người dùng cụ thể khỏi thiết bị.

Tham số
userId	int: số người dùng cần xoá

Giá trị trả về
boolean	true nếu chúng tôi xoá được người dùng thành công, nếu không thì sẽ trả về false.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Đặt mộ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 cụ thể.

Tham số
componentName	String: của quản trị viên thiết bị sẽ là chủ sở hữu thiết bị.
userId	int: người dùng sở hữu thiết bị.

Giá trị trả về
boolean	"True" nếu thành công, nếu không thì sẽ trả lời sai.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

cài đặt

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.

Tham số
namespace	String
key	String
value	String

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

cài đặt

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 cụ thể. Một số chế độ cài đặt sẽ chỉ hoạt động sau khi khởi động lại. không gian tên phải là một trong: {"system", "secure", "global"}

Tham số
userId	int
namespace	String
key	String
value	String

Gửi
	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 cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng. Nếu người dùng đã chạy ở chế độ nền, phương thức này là NOOP.

Tham số
userId	int: số người dùng bắt đầu ở chế độ nền

Giá trị trả về
boolean	true nếu người dùng đã khởi động thành công trong nền.

Gửi
	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 cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng. Nếu người dùng đã chạy ở chế độ nền, phương thức này là NOOP. Có thể cung cấp thêm cờ để chờ thao tác đó có hiệu lực.

Tham số
userId	int: số người dùng bắt đầu ở chế độ nền
waitFlag	boolean: sẽ thực hiện lệnh chờ cho đến khi người dùng khởi động và mở khoá.

Giá trị trả về
boolean	true nếu người dùng đã khởi động thành công trong nền.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

người dùng bắt đầu hiển thị

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

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

LƯU Ý: lệnh này không kiểm tra xem người dùng có tồn tại, màn hình có sẵn hay không, device supports such feature, v.v.

Tham số
userId	int: số người dùng bắt đầu ở chế độ nền
displayId	int: màn hình để bắt đầu hiển thị người dùng
waitFlag	boolean: sẽ thực hiện lệnh chờ cho đến khi người dùng khởi động và mở khoá.

Giá trị trả về
boolean	Là giá trị true nếu người dùng đã khởi động thành công và hiển thị trong nền.

Gửi
DeviceNotAvailableException

người dùng dừng

public abstract boolean stopUser (int userId)

Dừng một người dùng cụ thể. Nếu người dùng đã dừng hoạt động, thì phương thức này là NOOP. Không thể dừng người dùng hiện tại và người dùng hệ thống.

Tham số
userId	int: số người dùng cần dừng.

Giá trị trả về
boolean	true nếu người dùng đã được dừng thành công.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
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 cụ thể. Có thể cung cấp thêm cờ để chờ thao tác có hiệu lực, và buộc chấm dứt tài khoản người dùng. Không thể dừng người dùng hiện tại và người dùng hệ thống.

Tham số
userId	int: số người dùng cần dừng.
waitFlag	boolean: sẽ thực hiện lệnh chờ cho đến khi người dùng dừng lại.
forceFlag	boolean: sẽ buộc người dùng dừng.

Giá trị trả về
boolean	true nếu người dùng đã được dừng thành công.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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

public abstract boolean switchUser (int userId)

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

Tham số
userId	int

Giá trị trả về
boolean	Đúng nếu userId mới khớp với nhà cung cấp userId. Nếu không thì là False.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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

public abstract boolean switchUser (int userId, 
                long timeout)

Hãy chuyển sang một userId khác có thời gian chờ đã 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.

Tham số
userId	int
timeout	long: để đợi trước khi trả về giá trị false cho người dùng nút chuyển không thành công.

Giá trị trả về
boolean	Đúng nếu userId mới khớp với nhà cung cấp userId. Nếu không thì là False.

Gửi
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

báo cáo lỗi

public abstract Bugreport takeBugreport ()

Tạo báo cáo lỗi và trả về bên trong đối tượng Bugreport để xử lý. Trả về giá trị rỗng trong trường hợp có vấn đề. Bạn cần dọn dẹp tệp được tham chiếu trong đối tượng Báo cáo lỗi thông qua Bugreport.close().

Giá trị trả về
Bugreport

gỡ cài đặt gói

public abstract String uninstallPackage (String packageName)

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

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

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

Gỡ cài đặt cho người dùng

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Gỡ cài đặt một gói Android khỏi thiết bị của một người dùng cụ thể.

Tham số
packageName	String: gói Android cần gỡ cài đặt
userId	int: mã nhận dạng người dùng là số nguyên cần gỡ cài đặt.

Giá trị trả về
String	String có mã lỗi hoặc null nếu thành công.

Gửi
DeviceNotAvailableException	nếu kết nối với thiết bị bị mất và không thể đã khôi phục.

Chờ

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Nếu được, hãy đợi quá trình chụp nhanh hoàn tất.

Tham số
currentPhase	SnapuserdWaitPhase

Gửi
DeviceNotAvailableException