ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

Thử lại các lệnh của thiết bị trong một khoảng thời gian có thể định cấu hình và cung cấp giao diện khôi phục thiết bị cho những 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 duy nhất 

class ITestDevice.MountPointInfo

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

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 thiết bị có kết nối mạng.

abstract boolean clearErrorDialogs()

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

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 người dùng có tên đã cho và cờ mặc định là 0.

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

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

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

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

abstract int createUserNoThrow(String name)

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

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Xoá IDeviceActionReceiver đã đăng ký.

abstract void disableKeyguard()

Tìm cách tắt khoá màn hình.

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 tệp trên thiết bị có tồn tại cho một người dùng nhất định hay không.

abstract File dumpHeap(String process, String devicePath)

Hãy thử kết xuất 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ề các APEX được kích hoạt trên thiết bị.

abstract getAllSettings(String namespace)

Trả về các 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 một userId, trả về giá trị rỗng nếu không tìm thấy.

abstract getAndroidIds()

Tạo một Bản đồ gồm các mã nhận dạng Android được tìm thấy khớp với mã nhận dạng người dùng.

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract getAppPackageInfos()

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

abstract InputStreamSource getBugreport()

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

abstract InputStreamSource getBugreportz()

Truy xuất một bugreportz 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 giá trị rỗng nếu có vấn đề xảy ra.

abstract int getCurrentUser()

Trả về mã nhận dạng của người dùng đang chạy hiện tại.

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 khoá bảo vệ hoặc 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 chính được cài đặt trên thiết bị.

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

Phương thức này không được dùng nữa. getPrimaryUser đã ngừng hoạt động trong dịch vụ UserManager, hãy sử dụng ERROR(/android.os.UserManager#getMainUserId()) để lấy người dùng đầy đủ đầu tiên hoặc 0 cho hệ thống. Xin lưu ý rằng đối với hệ thống không có màn hình, đây không phải là người dùng đầy đủ.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

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

abstract InputStreamSource getScreenshot(long displayId)

Chụp ảnh màn hình từ thiết bị có mã nhận dạng màn hình đã cho.

abstract InputStreamSource getScreenshot(String format)

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

abstract InputStreamSource getScreenshot()

Chụp ảnh màn hình 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 cờ của một người dùng cụ thể.

abstract getUserInfos()

Nhận Bản đồ useId thành 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ó dùng được trên thiết bị hay 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ể.

abstract boolean installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)

Cài đặt APK ở chế độ tăng dần.

default String installPackages( packageFiles, 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 chính và các gói phân tách bổ sung).

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

Cài đặt một ứng dụng Android được tạo từ một số tệp APK (một gói chính và các gói phân tách bổ sung) nằm 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ừ một số tệp APK (một gói chính và các gói phân tách bổ sung) cho một người dùng nhất định.

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 chính và các gói phân tách bổ sung) cho một người dùng nhất định.

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

Cài đặt một ứng dụng Android được tạo từ một số tệp APK (một gói chính và các gói phân tách bổ sung) nằm 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ừ một số tệp APK (một gói chính và các gói phân tách bổ sung) nằm trên thiết bị Android.

abstract boolean isHeadlessSystemUserMode()

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

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

Xác định xem thiết bị 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ị theo một tên gói và mã nhận dạng người dùng nhất định để kiểm tra xem người dùng đó có đang cài đặt hay không.

abstract boolean isPackageInstalled(String packageName)

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

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

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 đã cho có xuất hiện trong màn hình đã cho hay không.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

abstract boolean isVisibleBackgroundUsersSupported()

Trả về việc thiết bị có cho phép người dùng bắt đầu thấy được trong nền hay không.

abstract boolean isWifiEnabled()

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

abstract listDisplayIds()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Lấy danh sách các 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 thức trợ giúp để lấy một báo cáo lỗi và ghi báo cáo đó vào các báo cáo.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

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

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 đã cho và trả về true nếu thành công, false nếu không.

abstract void removeOwners()

Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có bằng mọi cách có thể.

abstract boolean removeUser(int userId)

Xoá một người dùng nhất định khỏi thiết bị.

abstract boolean setDeviceOwner(String componentName, int userId)

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

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ị chế độ 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)

Khởi động một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang dừng.

abstract boolean startUser(int userId, boolean waitFlag)

Khởi động một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang dừng.

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

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

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 với thời gian chờ mặc định.

abstract boolean switchUser(int userId, long timeout)

Chuyển sang một userId khác với thời gian chờ đã cho làm thời hạn.

abstract Bugreport takeBugreport()

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

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ị cho một người dùng nhất định.

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Nếu cần, hãy đợi snapuserd hoàn tất.

Phương thức công khai

canSwitchToHeadlessSystemUser

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

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

Giá trị trả về
boolean true nếu thiết bị có kết nối mạng đang hoạt động, false nếu không.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

Giá trị trả về
boolean true nếu không có hộp thoại nào hoặc hộp thoại đã được xoá thành công. Nếu không thì là false.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

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 mạng Wi-Fi được cung cấp trong bản đồ wifiSsidToPsk. Sau khi kết nối, phiên bản sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.

Tham số
wifiSsidToPsk : Bản đồ SSID Wi-Fi đến mật khẩu.
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 mất kết nối với thiết bị và không thể khôi phục.

connectToWifiNetwork

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 mạng Wi-Fi được cung cấp trong bản đồ wifiSsidToPsk. Sau khi kết nối, phiên bản sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.

Tham số
wifiSsidToPsk : Bản đồ SSID Wi-Fi đến mật khẩu.
scanSsid boolean: có quét các SSID ẩn cho mạng này hay không.
Giá trị trả về
boolean true nếu kết nối thành công với mạng Wi-Fi. false nếu không
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

connectToWifiNetwork

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 đã chỉ định. Sau khi kết nối, phiên bản sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.

Tham số
wifiSsid String: ssid wifi để kết nối
wifiPsk String: Cụm mật khẩu PSK hoặc giá trị rỗng nếu không được mã hoá
Giá trị trả về
boolean true nếu kết nối thành công với mạng Wi-Fi. false nếu không
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

connectToWifiNetwork

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 đã chỉ định. Sau khi kết nối, phiên bản sẽ cố gắng khôi phục kết nối sau mỗi lần khởi động lại cho đến khi ITestDevice.disconnectFromWifi() hoặc ITestDevice.clearLastConnectedWifiNetwork() được gọi.

Tham số
wifiSsid String: ssid wifi để kết nối
wifiPsk String: Cụm mật khẩu PSK hoặc giá trị rỗng nếu không được mã hoá
scanSsid boolean: có quét SSID ẩn cho mạng này hay không.
Giá trị trả về
boolean true nếu kết nối thành công với mạng Wi-Fi. false nếu không
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

connectToWifiNetworkIfNeeded

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

Một biến thể của connectToWifiNetwork(String, String) chỉ kết nối nếu thiết bị hiện không có kết nối mạng.

Tham số
scanSsid boolean: có quét SSID ẩn cho mạng này hay không
Giá trị trả về
boolean true nếu kết nối thành công với mạng Wi-Fi. false nếu không
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Một biến thể của connectToWifiNetwork(String, String) chỉ kết nối nếu thiết bị hiện không có kết nối mạng.

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

createUser

public abstract int createUser (String name)

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

Tham số
name String: của người dùng cần tạo trên thiết bị
Giá trị trả về
int số nguyên cho mã nhận dạng người dùng đã tạo
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

Tham số
name String: của người dùng cần tạo trên thiết bị
guest boolean: cho phép cờ người dùng --guest trong quá trình tạo
ephemeral boolean: bật cờ người dùng --ephemeral trong quá trình tạo
Giá trị trả về
int mã nhận dạng của người dùng đã tạo
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

Tham số
name String: của người dùng cần tạo trên thiết bị
guest boolean: cho phép cờ người dùng --guest trong quá trình tạo
ephemeral boolean: bật cờ người dùng --ephemeral trong quá trình tạo
forTesting boolean: bật cờ kiểm thử --for-testing trong quá trình tạo
Giá trị trả về
int mã nhận dạng của người dùng đã tạo
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

Tham số
name String: của người dùng cần tạo trên thiết bị
Giá trị trả về
int số nguyên cho mã nhận dạng người dùng đã tạo hoặc -1 nếu xảy ra lỗi.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Xoá IDeviceActionReceiver đã đăng ký.

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

disableKeyguard

public abstract void disableKeyguard ()

Tìm cách tắt khoá màn hình.

Trước tiên, hãy đợi quá trình truyền dữ liệu đầu vào sẵn sàng. Quá trình này diễn ra cùng lúc khi thiết bị báo cáo BOOT_COMPLETE, rõ ràng là không đồng bộ, vì quá trình triển khai khung hiện tại đôi khi có điều kiện xung đột. Sau đó, lệnh sẽ được gửi để đóng khoá bảo vệ (chỉ hoạt động trên các khoá không bảo mật)

Gửi
DeviceNotAvailableException

disableNetworkMonitor

public 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 thành công tính năng giám sát. false nếu không thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

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

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

Giá trị trả về
boolean true nếu ngắt kết nối khỏi mạng Wi-Fi thành công. false nếu không ngắt kết nối được.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Tham số
deviceFilePath String: đường dẫn tuyệt đối của tệp trên thiết bị cần kiểm tra
userId int: Mã nhận dạng người dùng để kiểm tra sự tồn tại của tệp
Giá trị trả về
boolean true nếu tệp tồn tại, false nếu không.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Hãy thử kết xuất heap từ system_server. Phương thức gọi có trách nhiệm dọn dẹp tệp đã kết xuất.

Tham số
process String: tên của quy trình thiết bị để kết xuất heap.
devicePath String: đường dẫn trên thiết bị để đặt tệp kết xuất. Đây phải là vị trí mà bạn có quyền truy cập.
Giá trị trả về
File ERROR(/File) chứa báo cáo. Giá trị rỗng nếu có lỗi xảy ra.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

Giá trị trả về
boolean true nếu bạn bật thành công chế độ giám sát. false nếu không thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị 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ề
Hiện có ERROR(/Set)/ApexInfo được kích hoạt trên thiết bị
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

Tham số
namespace String: phải là một trong các giá trị {"system", "secure", "global"}
Giá trị trả về
bản đồ của các cặp khoá-giá trị. Giá trị rỗng nếu không gian tên không được hỗ trợ.
Gửi
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 một userId, trả về giá trị rỗng nếu không tìm thấy.

Tham số
userId int

Giá trị trả về
String

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

getAndroidIds

public abstract  getAndroidIds ()

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

Giá trị trả về
Bản đồ mã nhận dạng Android tìm thấy mã nhận dạng người dùng phù hợp.
Gửi
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 cài đặt trên thiết bị.

Tham số
packageName String

Giá trị trả về
PackageInfo PackageInfo hoặc null nếu không truy xuất được thông tin
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

Giá trị trả về
ERROR(/List) của PackageInfo đã được cài đặt trên thiết bị.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

Chỉ được hỗ trợ cho "adb version" > 1.0.36

Giá trị trả về
InputStreamSource InputStreamSource của tệp zip chứa bugreportz, trả về giá trị rỗng trong trường hợp thất bại.

getCurrentFoldableState

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 giá trị rỗng nếu có vấn đề xảy ra.

Giá trị trả về
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

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

Giá trị trả về
int

Gửi
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ể lấy bằng lệnh "cmd device_state print-states".

Giá trị trả về
Gửi
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ị.

Giá trị trả về
ERROR(/Set) tên gói String 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 mất kết nối với thiết bị và không thể khôi phụ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 khoá bảo vệ hoặc giá trị rỗng nếu không được hỗ trợ.

Giá trị trả về
KeyguardControllerState KeyguardControllerState chứa ảnh chụp nhanh trạng thái của khoá bảo vệ và trả về giá trị Null nếu truy vấn Keyguard không được hỗ trợ.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị 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à giá trị null nếu không có người dùng chính.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException nếu đầu ra của thiết bị không như mong đợi.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

Giá trị trả về
ERROR(/Set) trong số String mô-đun chính hiện được cài đặt trên thiết bị.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Giá trị trả về
int một số nguyên cho biết số lượng người dùng đang chạy đồng thời
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

Giá trị trả về
int một số nguyên cho biết số lượng người dùng được hỗ trợ
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Phương thức này không được dùng nữa.
getPrimaryUser đã ngừng hoạt động trong dịch vụ UserManager, hãy dùng ERROR(/android.os.UserManager#getMainUserId()) để lấy người dùng đầy đủ đầu tiên hoặc 0 cho hệ thống. Xin lưu ý rằng đối với hệ thống không có màn hình, đây không phải là người dùng đầy đủ.

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

Giá trị trả về
Integer userId của người dùng chính (nếu có) và giá trị rỗng (nếu không có người dùng chính).
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException nếu đầu ra của thiết bị không như mong đợi.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Tham số
format String: hỗ trợ PNG, JPEG
rescale boolean: nếu cần đổi tỷ lệ ảnh chụp màn hình để giảm kích thước của hình ảnh kết quả
Giá trị trả về
InputStreamSource InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu ảnh chụp màn hình không thành công.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Chụp ảnh màn hình từ thiết bị có mã nhận dạng màn hình đã cho. Định dạng là PNG.

CẦN LÀM: mở rộng các cách triển khai ở trên để hỗ trợ "format" (định dạng) và "rescale" (điều chỉnh tỷ lệ)

Tham số
displayId long: mã nhận dạng màn hình để lấy ảnh chụp màn hình.
Giá trị trả về
InputStreamSource InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu ảnh chụp màn hình không thành công.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

Tham số
format String: hỗ trợ PNG, JPEG
Giá trị trả về
InputStreamSource InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu ảnh chụp màn hình không thành công.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

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

getSetting

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 các giá trị sau: {"system", "secure", "global"}

Tham số
userId int

namespace String

key String

Giá trị trả về
String giá trị được liên kết với namespace:key của một người dùng. Giá trị rỗng nếu không tìm thấy.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Xem getSetting(int, String, String) và được thực hiện trên người dùng hệ thống.

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. Hiện tại, điều này được xác định là các gói không phải hệ thống và các gói hệ thống đã cập nhật.

Giá trị trả về
ERROR(/Set) tên gói String không thể gỡ cài đặt hiện được cài đặt trên thiết bị.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

Tham số
userId int

Giá trị trả về
int các cờ được liên kết với userId đã cung cấp (nếu có), -10000 trong mọi trường hợp khác.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

Giá trị trả về
danh sách các đối tượng UserInfo.
Gửi
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.

Tham số
userId int

Giá trị trả về
int

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

hasFeature

public abstract boolean hasFeature (String feature)

Kiểm tra xem một tính năng có dùng được trên thiết bị hay không.

Tham số
feature String: định dạng phải là "feature:" hoặc "" trực tiếp.
Giá trị trả về
boolean Đúng nếu tìm thấy đối tượng, sai nếu không.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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ài đặt
reinstall boolean: true nếu cần thực hiện quy trình cài đặt lại
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

installPackage

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ỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền khi bắt đầu chạy tại thời điểm cài đặt mới nên gọi hàm này.

Tham số
packageFile File: tệp apk để cài đặt
reinstall boolean: true nếu cần thực hiện quy trình cài đặt lại
grantPermissions boolean: nếu tất cả các quyền trong thời gian chạy đều được cấp tại thời điểm cài đặt
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.
UnsupportedOperationException nếu nền tảng không hỗ trợ quyền trong thời gian 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ài đặt
reinstall boolean: true nếu cần thực hiện quy trình cài đặt lại
userId int: mã nhận dạng người dùng là số nguyên để cài đặt.
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị 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ỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền khi bắt đầu chạy tại thời điểm cài đặt mới nên gọi hàm này.

Tham số
packageFile File: tệp apk để cài đặt
reinstall boolean: true nếu cần thực hiện quy trình cài đặt lại
grantPermissions boolean: nếu tất cả các quyền trong thời gian chạy đều được cấp tại thời điểm cài đặt
userId int: mã nhận dạng người dùng là số nguyên để cài đặt.
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.
UnsupportedOperationException nếu nền tảng trên thiết bị không hỗ trợ quyền trong thời gian chạy.

installPackageWithIncrementalMode

public abstract boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

Cài đặt APK ở chế độ tăng dần.

Tham số
apkFiles File: các tệp apk cần cài đặt.
extraArgs String

userId String

Giá trị trả về
boolean

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

installPackages

public String installPackages ( packageFiles, 
                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 chính và các gói phân tách bổ sung). Xem "https://developer.android.com/studio/build/configure-apk-splits" để biết cách chia tệp apk thành nhiều tệp.

Tham số
packageFiles : tệp apk cục bộ
reinstall boolean: true nếu cần thực hiện quy trình cài đặt lại
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.
UnsupportedOperationException nếu nền tảng trên thiết bị không hỗ trợ quyền trong thời gian chạy.

installPackages

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

Cài đặt một ứng dụng Android được tạo từ một số tệp APK (một gói chính và các gói phân tách bổ sung) nằm trên thiết bị Android. Xem "https://developer.android.com/studio/build/configure-apk-splits" để biết cách chia tệp 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 khi bắt đầu chạy tại thời điểm cài đặt mới nên gọi hàm này.

Tham số
packageFiles : đường dẫn tệp apk từ xa để cài đặt
reinstall boolean: true nếu cần thực hiện quy trình cài đặt lại
grantPermissions boolean: nếu tất cả các quyền trong thời gian chạy đều được cấp tại thời điểm cài đặt
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.
UnsupportedOperationException nếu nền tảng không hỗ trợ quyền trong thời gian chạy trên thiết bị.

installPackagesForUser

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

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

Tham số
packageFiles : tệp apk cục bộ
reinstall boolean: true nếu cần thực hiện quy trình cài đặt lại
userId int: mã nhận dạng người dùng là số nguyên để cài đặt.
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.
UnsupportedOperationException nếu nền tảng không hỗ trợ quyền trong thời gian chạy trên thiết bị.

installPackagesForUser

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ừ một số tệp APK (một gói chính và các gói phân tách bổ sung) cho một người dùng nhất định. Xem "https://developer.android.com/studio/build/configure-apk-splits" để biết cách chia tệp 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 khi bắt đầu chạy tại thời điểm cài đặt mới nên gọi hàm này.

Tham số
packageFiles : tệp apk cục bộ
reinstall boolean: true nếu cần thực hiện quy trình cài đặt lại
grantPermissions boolean: nếu tất cả các quyền trong thời gian chạy đều được cấp tại thời điểm cài đặt
userId int: mã nhận dạng người dùng là số nguyên để cài đặt.
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.
UnsupportedOperationException nếu nền tảng không hỗ trợ quyền trong thời gian chạy trên thiết bị.

installRemotePackages

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

Cài đặt một ứng dụng Android được tạo từ một số tệp APK (một gói chính và các gói phân tách bổ sung) nằm trên thiết bị Android. Xem "https://developer.android.com/studio/build/configure-apk-splits" để biết cách chia tệp 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 thực hiện quy trình cài đặt lại
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.
UnsupportedOperationException nếu nền tảng không hỗ trợ quyền trong thời gian chạy trên thiết bị.

installRemotePackages

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

Cài đặt một ứng dụng Android được tạo từ một số tệp APK (một gói chính và các gói phân tách bổ sung) nằm trên thiết bị Android. Xem "https://developer.android.com/studio/build/configure-apk-splits" để biết cách chia tệp 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 khi bắt đầu chạy tại thời điểm cài đặt mới nên gọi hàm này.

Tham số
remoteApkPaths : đường dẫn tệp apk từ xa
reinstall boolean: true nếu cần thực hiện quy trình cài đặt lại
grantPermissions boolean: nếu tất cả các quyền trong thời gian chạy đều được cấp tại thời điểm cài đặt
extraArgs String: các đối số bổ sung không bắt buộc để truyền. Hãy xem "adb shell pm -h" để biết các lựa chọn có sẵn.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.
UnsupportedOperationException nếu nền tảng không hỗ trợ quyền trong thời gian chạy trên thiết bị.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

Giá trị trả về
boolean true nếu được hỗ trợ nhiều người dùng, false nếu không
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

Tham số
packageName String: gói mà chúng ta đang kiểm tra xem đã cài đặt hay chưa.
userId String: Mã nhận dạng người dùng mà chúng tôi đang kiểm tra xem gói đã được cài đặt hay chưa. Nếu giá trị này là rỗng, hệ thống sẽ dùng giá trị 0 của người dùng chính.
Giá trị trả về
boolean True nếu gói được báo cáo là đã cài đặt. Nếu không thì trả về giá trị false.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Tham số
packageName String

Giá trị trả về
boolean True nếu gói được báo cáo là đã cài đặt. Nếu không thì trả về giá trị false.
Gửi
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.

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Tham số
userId int

Giá trị trả về
boolean true nếu người dùng là người dùng phụ, ngược lại là false.
Gửi
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 "có thể nhìn thấy" là người dùng đang tương tác với người dùng "thực" và do đó có thể khởi chạy các hoạt động khởi chạy (thường là trong màn hình mặc định).

Tham số
userId int

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Tham số
userId int

displayId int

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Trả về việc thiết bị có cho phép người dùng bắt đầu thấy được trong nền hay không.

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

Giá trị trả về
boolean

Gửi
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

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

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

Giá trị trả về
boolean true nếu Wi-Fi đang bật. false nếu bị vô hiệu hoá
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

listDisplayIds

public abstract  listDisplayIds ()

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

Giá trị trả về
Danh sách màn hình. Default luôn trả về màn hình mặc định 0.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Giá trị trả về
Gửi
DeviceNotAvailableException

listUsers

public 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 mã nhận dạng người dùng.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Phương thức trợ giúp để lấy một báo cáo lỗi và ghi báo cáo đó vào các báo cáo.

Tham số
dataName String: tên mà theo đó bugreport sẽ được báo cáo.
listener ITestLogger: một ITestLogger để ghi nhật ký báo cáo lỗi.
Giá trị trả về
boolean True nếu quá trình ghi nhật ký thành công, false nếu không.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

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

Tham số
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

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 một thao tác trên thiết bị bắt đầu và sau khi thao tác đó kết thúc.

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

Tham số
componentName String: của quản trị viên thiết bị cần xoá.
userId int: của người dùng mà quản trị viên thiết bị đang sử dụng.
Giá trị trả về
boolean True nếu thành công, false nếu không.
Gửi
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ó bằng mọi cách có thể.

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

removeUser

public abstract boolean removeUser (int userId)

Xoá một người dùng nhất định khỏi thiết bị.

Tham số
userId int: của người dùng cần xoá
Giá trị trả về
boolean true nếu chúng ta xoá người dùng thành công, false nếu không.
Gửi
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ị thiết bị làm chủ sở hữu thiết bị cho người dùng đã cho.

Tham số
componentName String: của quản trị viên thiết bị thành chủ sở hữu thiết bị.
userId int: của người dùng mà chủ sở hữu thiết bị sinh sống.
Giá trị trả về
boolean True nếu thành công, false nếu không.
Gửi
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.

Tham số
namespace String

key String

value String

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

setSetting

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

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

Tham số
userId int

namespace String

key String

value String

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

startUser

public abstract boolean startUser (int userId)

Khởi động một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang dừng. Nếu người dùng đã chạy ở chế độ nền, thì phương thức này sẽ là NOOP.

Tham số
userId int: của người dùng để bắt đầu ở chế độ nền
Giá trị trả về
boolean true nếu người dùng đã bắt đầu thành công trong nền.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Khởi động một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang dừng. Nếu người dùng đã chạy ở chế độ nền, thì phương thức này sẽ là NOOP. Có thể cung cấp cờ bổ sung để chờ hoạt động có hiệu lực.

Tham số
userId int: của người dùng để bắt đầu ở chế độ nền
waitFlag boolean: sẽ khiến lệnh chờ cho đến khi người dùng khởi động và mở khoá.
Giá trị trả về
boolean true nếu người dùng đã bắt đầu thành công trong nền.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

Tham số
userId int: của người dùng để bắt đầu ở chế độ nền
displayId int: màn hình để bắt đầu hiển thị cho người dùng
waitFlag boolean: sẽ khiến lệnh chờ cho đến khi người dùng khởi động và mở khoá.
Giá trị trả về
boolean true nếu người dùng đã bắt đầu thành công và có thể thấy trong nền.
Gửi
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

Tham số
userId int: của người dùng cần dừng.
Giá trị trả về
boolean true nếu người dùng đã dừng thành công.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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 các cờ bổ sung để chờ thao tác có hiệu lực và buộc người dùng chấm dứt. Không thể dừng người dùng hiện tại và người dùng hệ thống.

Tham số
userId int: của người dùng cần dừng.
waitFlag boolean: sẽ khiến lệnh chờ cho đến khi người dùng dừng.
forceFlag boolean: sẽ buộc người dùng dừng.
Giá trị trả về
boolean true nếu người dùng đã dừng thành công.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

Tham số
userId int

Giá trị trả về
boolean Giá trị là true nếu userId mới khớp với nhà cung cấp userId. Nếu không thì trả về giá trị false.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Chuyển sang một userId khác với thời gian chờ đã cho làm thời hạn. Thử tắt khoá màn hình sau khi người dùng thay đổi thành công.

Tham số
userId int

timeout long: để chờ trước khi trả về giá trị false cho trường hợp chuyển đổi người dùng không thành công.
Giá trị trả về
boolean Giá trị là true nếu userId mới khớp với nhà cung cấp userId. Nếu không thì trả về giá trị false.
Gửi
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

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

Giá trị trả về
Bugreport

uninstallPackage

public 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 mất kết nối với thiết bị và không thể khôi phục.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Tham số
packageName String: gói Android cần gỡ cài đặt
userId int: mã nhận dạng người dùng là số nguyên để gỡ cài đặt.
Giá trị trả về
String String có mã lỗi hoặc null nếu thành công.
Gửi
DeviceNotAvailableException nếu mất kết nối với thiết bị và không thể khôi phục.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Nếu cần, hãy đợi snapuserd hoàn tất.

Tham số
currentPhase SnapuserdWaitPhase

Gửi
DeviceNotAvailableException