các lớp lồng nhau |
---|
class | TestDevice.MicrodroidBuilder Trình tạo được sử dụng để tạo Thiết bị kiểm tra Microdroid. |
Lĩnh vực |
---|
public static final String | DISMISS_KEYGUARD_CMD Các lệnh có thể được sử dụng để loại bỏ keyguard. |
Phương thức công khai |
---|
boolean | canSwitchToHeadlessSystemUser () Trả về liệu nó có được phép chuyển sang người dùng HỆ THỐNG không đầu hay không. |
boolean | clearErrorDialogs () Cố gắng loại bỏ mọi hộp thoại báo lỗi hiện đang hiển thị trên giao diện người dùng của thiết bị. |
int | createUser (String name) Tạo người dùng có tên đã cho và cờ mặc định 0. |
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 |
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 |
int | createUserNoThrow (String name) Tạo người dùng có tên đã cho và cờ mặc định 0. |
void | disableKeyguard () Cố gắng vô hiệu hóa keyguard. |
boolean | doesFileExist (String deviceFilePath) Phương pháp trợ giúp để xác định xem tệp trên thiết bị có tồn tại hay không. |
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 cụ thể hay không. |
File | dumpHeap (String process, String devicePath) Cố gắng kết xuất đống từ system_server. |
| getActiveApexes () Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị. |
| getAllSettings (String namespace) Trả về các cặp giá trị khóa của không gian tên được yêu cầu. |
String | getAndroidId (int userId) Tìm và trả lại android-id được liên kết với userId, null nếu không tìm thấy. |
| getAndroidIds () Tạo Bản đồ id android được tìm thấy phù hợp với id người dùng. |
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ị. |
| getAppPackageInfos () Tìm nạp thông tin của các gói được cài đặt trên thiết bị. |
InputStreamSource | getBugreport () Truy xuất báo cáo lỗi từ thiết bị. |
InputStreamSource | getBugreportz () Lấy báo cáo lỗi từ thiết bị. |
DeviceFoldableState | getCurrentFoldableState () Trả về trạng thái có thể gập lại hiện tại của thiết bị hoặc trả về giá trị rỗng nếu xảy ra sự cố. |
int | getCurrentUser () Trả về id của người dùng đang chạy hiện tại. |
| getFoldableStates () Trả về danh sách các trạng thái có thể gập lại trên thiết bị. |
| getInstalledPackageNames () Tìm nạp tên gói ứng dụng có trên thiết bị. |
KeyguardControllerState | getKeyguardState () Trả về một đối tượng để lấy trạng thái hiện tại của keyguard hoặc null nếu không được hỗ trợ. |
Integer | getMainUserId () Trả về id người dùng chính. |
| getMainlineModuleInfo () Nhận thông tin về các mô-đun chính được cài đặt trên thiết bị. |
int | getMaxNumberOfRunningUsersSupported () Nhận số lượng người dùng chạy đồng thời được hỗ trợ tối đa. |
int | getMaxNumberOfUsersSupported () Nhận số lượng người dùng được hỗ trợ tối đa. |
Integer | getPrimaryUserId () Trả về id người dùng chính. |
InputStreamSource | getScreenshot () Chụp ảnh màn hình từ thiết bị. |
InputStreamSource | getScreenshot (String format, boolean rescale) Chụp ảnh màn hình từ thiết bị. |
InputStreamSource | getScreenshot (String format) Chụp ảnh màn hình từ thiết bị. |
InputStreamSource | getScreenshot (long displayId) Lấy ảnh chụp màn hình từ id hiển thị đã cho của thiết bị. |
String | getSetting (String namespace, String key) Xem getSetting(int, String, String) và thực hiện trên người dùng hệ thống. |
String | getSetting (int userId, String namespace, String key) Trả về giá trị của cài đặt được yêu cầu. |
| getUninstallablePackageNames () Tìm nạp tên gói ứng dụng có thể gỡ cài đặt. |
int | getUserFlags (int userId) Tìm và trả lại các cờ của một người dùng nhất định. |
| getUserInfos () Tải Bản đồ của useId tới UserInfo trên thiết bị. |
int | getUserSerialNumber (int userId) Trả lại số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong mọi trường hợp khác. |
boolean | hasFeature (String feature) Kiểm tra xem một tính năng có sẵn trên thiết bị hay không. |
String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Cài đặt gói Android trên thiết bị. |
String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Cài đặt gói Android trên thiết bị. |
String | installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs) Cài đặt gói Android trên thiết bị. |
String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Cài đặt gói Android trên thiết bị cho một người dùng nhất định. |
String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Cài đặt gói Android trên thiết bị cho một người dùng nhất định. |
String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) |
String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) |
boolean | isAppEnumerationSupported () Kiểm tra xem nền tảng trên thiết bị có hỗ trợ liệt kê ứng dụng hay không |
boolean | isHeadlessSystemUserMode () Trả về việc thiết bị có sử dụng chế độ người dùng hệ thống không đầu hay không. |
boolean | isMainUserPermanentAdmin () Trả về liệu 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ị xóa hoặc hạ cấp xuống trạng thái không phải quản trị viên. |
boolean | isMultiUserSupported () Xác định xem nhiều người dùng có được hỗ trợ hay không. |
boolean | isPackageInstalled (String packageName) Truy vấn thiết bị cho một tên gói nhất định để kiểm tra xem nó hiện đã được cài đặt hay chưa. |
boolean | isPackageInstalled (String packageName, String userId) Truy vấn thiết bị để biết tên gói nhất định và id người dùng đã cho để kiểm tra xem thiết bị hiện đã được cài đặt hay chưa cho người dùng đó. |
boolean | isUserRunning (int userId) Kiểm tra xem một người dùng nhất định có đang chạy không. |
boolean | isUserSecondary (int userId) Trả về xem người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của người dùng đó. |
boolean | isUserVisible (int userId) Kiểm tra xem người dùng đã cho có hiển thị không. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Kiểm tra xem người dùng đã cho có hiển thị trong màn hình đã cho hay không. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Trả về liệu thiết bị có cho phép bắt đầu hiển thị người dùng trong nền hay không trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) . |
boolean | isVisibleBackgroundUsersSupported () Trả về liệu thiết bị có cho phép bắt đầu hiển thị người dùng trong nền hay không. |
| listDisplayIds () Thu thập danh sách id hiển thị có sẵn trên thiết bị như được báo cáo bởi "dumpsys SurfaceFlinger". |
| listDisplayIdsForStartingVisibleBackgroundUsers () Nhận danh sách các màn hình có thể được sử dụng để start a user visible in the background . |
| listUsers () Lấy danh sách người dùng trên thiết bị. |
boolean | logBugreport (String dataName, ITestLogger listener) Phương thức trợ giúp để lấy báo cáo lỗi và ghi lại cho người báo cáo. |
void | postInvocationTearDown (Throwable exception) Các bước bổ sung để dọn dẹp theo yêu cầu cụ thể của thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất. |
boolean | removeAdmin (String componentName, int userId) Xóa 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, nếu không thì trả về false . |
void | removeOwners () Xóa tất cả chủ sở hữu cấu hình thiết bị hiện có bằng nỗ lực cao nhất. |
boolean | removeUser (int userId) Xóa một người dùng nhất định khỏi thiết bị. |
boolean | setDeviceOwner (String componentName, int userId) Đặt thành phần quản trị viên thiết bị làm chủ sở hữu thiết bị trong người dùng nhất định. |
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. |
void | setSetting (int userId, String namespace, String key, String value) Thêm một giá trị cài đặt vào không gian tên của một người dùng nhất định. |
void | shutdownMicrodroid ( ITestDevice microdroidDevice) Tắt thiết bị microdroid, nếu có. |
boolean | startUser (int userId) Bắt đầu một người dùng cụ thể trong nền nếu nó hiện đang bị dừng. |
boolean | startUser (int userId, boolean waitFlag) Bắt đầu một người dùng cụ thể trong nền nếu nó hiện đang bị dừng. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Bắt đầu một người dùng nhất định trong nền, hiển thị trong màn hình nhất định (nghĩa là cho phép người dùng khởi chạy các hoạt động trong màn hình đó). |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Dừng một người dùng nhất định. |
boolean | stopUser (int userId) Dừng một người dùng nhất định. |
boolean | supportsMicrodroid () Kiểm tra các điều kiện tiên quyết để chạy một microdroid. |
boolean | supportsMicrodroid (boolean protectedVm) Kiểm tra các điều kiện tiên quyết để chạy một microdroid. |
boolean | switchUser (int userId) Chuyển sang userId khác với thời gian chờ mặc định. |
boolean | switchUser (int userId, long timeout) Chuyển sang userId khác với thời gian chờ được cung cấp là hạn chót. |
Bugreport | takeBugreport () Lấy một báo cáo lỗi và gửi nó vào bên trong một đối tượng Bugreport để xử lý nó. |
String | uninstallPackage (String packageName) Gỡ cài đặt gói Android khỏi thiết bị. |
String | uninstallPackageForUser (String packageName, int userId) Gỡ cài đặt gói Android khỏi thiết bị cho một người dùng nhất định. |
Lĩnh vực
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Các lệnh có thể được sử dụng để loại bỏ keyguard.
nhà thầu công cộng
Phương thức công khai
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Trả về liệu nó có được phép chuyển sang người dùng HỆ THỐNG không đầu hay không.
ClearErrorDialogs
public boolean clearErrorDialogs ()
Cố gắng loại bỏ mọi hộp thoại báo lỗi hiện đang hiển thị trên giao diện người dùng của thiết bị.
trả lại |
---|
boolean | true nếu không có hộp thoại nào hoặc hộp thoại đã được xóa thành công. false khác. |
tạo người dùng
public int createUser (String name)
Tạo người dùng có tên đã cho và cờ mặc định 0.
Thông số |
---|
name | String : của người dùng tạo trên thiết bị |
trả lại |
---|
int | số nguyên cho id người dùng đã tạo |
tạo người dùng
public 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
Thông số |
---|
name | String : của người dùng tạo trên thiết bị |
guest | boolean : bật cờ người dùng --guest trong 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 tra --for-testing trong quá trình tạo |
trả lại |
---|
int | id của người dùng đã tạo |
tạo người dùng
public 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
Thông số |
---|
name | String : của người dùng tạo trên thiết bị |
guest | boolean : bật cờ người dùng --guest trong quá trình tạo |
ephemeral | boolean : bật cờ người dùng --ephemeral trong quá trình tạo |
trả lại |
---|
int | id của người dùng đã tạo |
tạoUserNoThrow
public int createUserNoThrow (String name)
Tạo người dùng có tên đã cho và cờ mặc định 0.
Thông số |
---|
name | String : của người dùng tạo trên thiết bị |
trả lại |
---|
int | số nguyên cho id người dùng đã tạo hoặc -1 nếu có lỗi. |
vô hiệu hóaKeyguard
public void disableKeyguard ()
Cố gắng vô hiệu hóa keyguard.
Trước tiên, hãy đợi công văn đầu vào sẵn sàng, điều này xảy ra cùng thời điểm khi thiết bị báo cáo BOOT_COMPLETE, rõ ràng là không đồng bộ, vì việc triển khai khung hiện tại thỉnh thoảng có tình trạng tương tranh. Sau đó, lệnh được gửi để loại bỏ keyguard (chỉ hoạt động trên những cái không an toàn)
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Phương pháp trợ giúp để xác định xem tệp trên thiết bị có tồn tại hay không.
Thông số |
---|
deviceFilePath | String : đường dẫn tuyệt đối của tệp trên thiết bị để kiểm tra |
trả lại |
---|
boolean | true nếu tệp tồn tại, false nếu không. |
doesFileExist
public 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 cụ thể hay không.
Thông số |
---|
deviceFilePath | String : đường dẫn tuyệt đối của tệp trên thiết bị để kiểm tra |
userId | int : ID người dùng để kiểm tra sự tồn tại của tệp |
trả lại |
---|
boolean | true nếu tệp tồn tại, false nếu không. |
đổ đống
public File dumpHeap (String process,
String devicePath)
Cố gắng kết xuất đống từ system_server. Người gọi có trách nhiệm dọn sạch tệp bị đổ.
Thông số |
---|
process | String : tên của quá trình thiết bị để dumpheap trên. |
devicePath | String : đường dẫn trên thiết bị nơi đặt kết xuất. Đây phải là một vị trí mà quyền cho phép nó. |
trả lại |
---|
File | ERROR(/File) chứa báo cáo. Null nếu một cái gì đó thất bại. |
getActiveApex
public getActiveApexes ()
Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị.
getAllSettings
public getAllSettings (String namespace)
Trả về các cặp giá trị khóa của không gian tên được yêu cầu.
Thông số |
---|
namespace | String : phải là một trong {"system", "secure", "global"} |
trả lại |
---|
| bản đồ của các cặp giá trị chính. Null nếu không gian tên không được hỗ trợ. |
getAndroidId
public String getAndroidId (int userId)
Tìm và trả lại android-id được liên kết với userId, null nếu không tìm thấy.
getAndroidId
public getAndroidIds ()
Tạo Bản đồ id android được tìm thấy phù hợp với id người dùng. Không có gì đảm bảo rằng mỗi id người dùng sẽ tìm thấy một id android được liên kết trong chức năng này, vì vậy một số id người dùng có thể khớp với giá trị rỗng.
trả lại |
---|
| Đã tìm thấy bản đồ id android phù hợp với id người dùng. |
getAppPackageInfo
public 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ị.
Thông số |
---|
packageName | String |
getAppPackageInfos
public getAppPackageInfos ()
Tìm nạp thông tin của các gói được cài đặt trên thiết bị.
getBugreport
public InputStreamSource getBugreport ()
Truy xuất báo cáo lỗi từ thiết bị.
Việc triển khai điều này được đảm bảo để tiếp tục hoạt động trên thiết bị không có thẻ sdcard (hoặc nơi thẻ sdcard chưa được gắn).
getBugreportz
public InputStreamSource getBugreportz ()
Lấy báo cáo lỗi từ thiết bị. Báo cáo lỗi định dạng zip chứa báo cáo lỗi chính và các tệp nhật ký khác hữu ích cho việc gỡ lỗi.
Chỉ được hỗ trợ cho 'adb version' > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Trả về trạng thái có thể gập lại hiện tại của thiết bị hoặc trả về giá trị rỗng nếu xảy ra sự cố.
getCurrentUser
public int getCurrentUser ()
Trả về id của người dùng đang chạy hiện tại. Trong trường hợp có lỗi, hãy trả về -10000.
getFoldableStates
public getFoldableStates ()
Trả về danh sách các trạng thái có thể gập lại trên thiết bị. Có thể thu được với "trạng thái in cmd device_state".
getInstalledPackageNames
public getInstalledPackageNames ()
Tìm nạp tên gói ứng dụng có trên thiết bị.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Trả về một đối tượng để lấy trạng thái hiện tại của keyguard hoặc null nếu không được hỗ trợ.
getMainUserId
public Integer getMainUserId ()
Trả về id người dùng chính.
trả lại |
---|
Integer | userId của người dùng chính nếu có và null nếu không có người dùng chính. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Nhận thông tin về các mô-đun chính được cài đặt trên thiết bị.
public int getMaxNumberOfRunningUsersSupported ()
Nhận số lượng người dùng chạy đồng thời được hỗ trợ tối đa. Mặc định là 0.
trả lại |
---|
int | một số nguyên cho biết số lượng người dùng đang chạy đồng thời |
public int getMaxNumberOfUsersSupported ()
Nhận số lượng người dùng được hỗ trợ tối đa. Mặc định là 0.
trả lại |
---|
int | một số nguyên cho biết số lượng người dùng được hỗ trợ |
getPrimaryUserId
public Integer getPrimaryUserId ()
Trả về id người dùng chính.
trả lại |
---|
Integer | userId của người dùng chính nếu có và null nếu không có người dùng chính. |
lấy ảnh chụp màn hình
public InputStreamSource getScreenshot ()
Chụp ảnh màn hình từ thiết bị.
lấy ảnh chụp màn hình
public InputStreamSource getScreenshot (String format,
boolean rescale)
Chụp ảnh màn hình từ thiết bị. Nên sử dụng getScreenshot(String)
thay vì mã hóa JPEG để có kích thước nhỏ hơn.
Thông số |
---|
format | String : hỗ trợ PNG, JPEG |
rescale | boolean : nếu ảnh chụp màn hình nên được thay đổi kích thước để giảm kích thước của hình ảnh kết quả |
lấy ảnh chụp màn hình
public InputStreamSource getScreenshot (String format)
Chụp ảnh màn hình từ thiết bị. Nên sử dụng getScreenshot(format) thay vì mã hóa JPEG để có kích thước nhỏ hơn
Thông số |
---|
format | String : hỗ trợ PNG, JPEG |
lấy ảnh chụp màn hình
public InputStreamSource getScreenshot (long displayId)
Lấy ảnh chụp màn hình từ id hiển thị đã cho của thiết bị. Định dạng là PNG.
VIỆC CẦN LÀM: mở rộng các triển khai ở trên để hỗ trợ 'định dạng' và 'điều chỉnh lại tỷ lệ'
Thông số |
---|
displayId | long : id hiển thị của màn hình để lấy ảnh chụp màn hình từ đó. |
getSetting
public String getSetting (String namespace,
String key)
Xem getSetting(int, String, String)
và thực hiện trên người dùng hệ thống.
Thông số |
---|
namespace | String |
key | String |
getSetting
public String getSetting (int userId,
String namespace,
String key)
Trả về giá trị của cài đặt được yêu cầu. không gian tên phải là một trong: {"system", "secure", "global"}
Thông số |
---|
userId | int |
namespace | String |
key | String |
trả lại |
---|
String | giá trị được liên kết với không gian tên: khóa của người dùng. Null nếu không tìm thấy. |
getUninstallablePackageNames
public 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 cập nhật.
getUserFlags
public int getUserFlags (int userId)
Tìm và trả lại các cờ của một người dùng nhất định. Cờ được định nghĩa trong lớp "android.content.pm.UserInfo" trong Dự án nguồn mở Android.
trả lại |
---|
int | các cờ được liên kết với userId được cung cấp nếu tìm thấy, -10000 trong mọi trường hợp khác. |
getUserInfos
public getUserInfos ()
Tải Bản đồ của useId tới UserInfo
trên thiết bị. Sẽ ném DeviceRuntimeException
nếu đầu ra từ thiết bị không như mong đợi.
trả lại |
---|
| danh sách các đối tượng UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Trả lại số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong mọi trường hợp khác.
hasFeature
public boolean hasFeature (String feature)
Kiểm tra xem một tính năng có sẵn trên thiết bị hay không.
Thông số |
---|
feature | String : định dạng nào phải là "tính năng: " hoặc " " trực tiếp. |
trả lại |
---|
boolean | Đúng nếu tính năng được tìm thấy, sai nếu không. |
cài đặt gói
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Cài đặt gói Android trên thiết bị.
Thông số |
---|
packageFile | File : file apk để cài đặt |
reinstall | boolean : true nếu cài đặt lại nên được thực hiện |
extraArgs | String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng. |
cài đặt gói
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Cài đặt gói Android trên thiết bị.
Lưu ý: Chỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy khi cài đặt mới gọi chức năng này.
Thông số |
---|
packageFile | File : file apk để cài đặt |
reinstall | boolean : true nếu cài đặt lại nên được thực hiện |
grantPermissions | boolean : nếu tất cả các quyền thời gian chạy sẽ được cấp khi cài đặt |
extraArgs | String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng. |
cài đặt gói
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Cài đặt gói Android trên thiết bị.
Lưu ý: Chỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy khi cài đặt mới gọi chức năng này.
Thông số |
---|
packageFile | File : file apk để cài đặt |
certFile | File : true nếu tiến hành cài đặt lại |
reinstall | boolean : nếu tất cả các quyền thời gian chạy sẽ được cấp khi cài đặt |
extraArgs | String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng. |
cài đặtPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Cài đặt gói Android trên thiết bị cho một người dùng nhất định.
Lưu ý: Chỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy khi cài đặt mới gọi chức năng này.
Thông số |
---|
packageFile | File : file apk để cài đặt |
reinstall | boolean : true nếu cài đặt lại nên được thực hiện |
grantPermissions | boolean : nếu tất cả các quyền thời gian chạy sẽ được cấp khi cài đặt |
userId | int : id người dùng số nguyên để cài đặt. |
extraArgs | String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng. |
cài đặtPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Cài đặt gói Android trên thiết bị cho một người dùng nhất định.
Thông số |
---|
packageFile | File : file apk để cài đặt |
reinstall | boolean : true nếu cài đặt lại nên được thực hiện |
userId | int : id người dùng số nguyên để cài đặt. |
extraArgs | String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng. |
cài đặtGói
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Thông số |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
cài đặtGói
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Thông số |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
cài đặt Gói cho người dùng
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Thông số |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
cài đặt Gói cho người dùng
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Thông số |
---|
packageFiles | |
reinstall | boolean |
userId | int |
extraArgs | String |
cài đặtGói từ xa
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Thông số |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
cài đặtGói từ xa
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Thông số |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
isAppEnumerationHỗ trợ
public boolean isAppEnumerationSupported ()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ liệt kê ứng dụng hay không
trả lại |
---|
boolean | Đúng nếu liệt kê ứng dụng được hỗ trợ, sai nếu không |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Trả về việc thiết bị có sử dụng chế độ người dùng hệ thống không đầu hay không.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Trả về liệu 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ị xóa hoặc hạ cấp xuống trạng thái không phải quản trị viên.
isMultiUserHỗ trợ
public boolean isMultiUserSupported ()
Xác định xem nhiều người dùng có được hỗ trợ hay không.
trả lại |
---|
boolean | đúng nếu nhiều người dùng được hỗ trợ, sai nếu không |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Truy vấn thiết bị cho một tên gói nhất định để kiểm tra xem nó hiện đã được cài đặt hay chưa.
Thông số |
---|
packageName | String |
trả lại |
---|
boolean | Đúng nếu gói được báo cáo là đã cài đặt. Sai nếu không. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Truy vấn thiết bị để biết tên gói nhất định và id người dùng đã cho để kiểm tra xem thiết bị hiện đã được cài đặt hay chưa cho người dùng đó.
Thông số |
---|
packageName | String : gói chúng tôi đang kiểm tra xem nó đã được cài đặt chưa. |
userId | String : Id người dùng mà chúng tôi đang kiểm tra gói đã được cài đặt. Nếu null, số 0 của người dùng chính sẽ được sử dụng. |
trả lại |
---|
boolean | Đúng nếu gói được báo cáo là đã cài đặt. Sai nếu không. |
isUserRunning
public boolean isUserRunning (int userId)
Kiểm tra xem một người dùng nhất định có đang chạy không.
trả lại |
---|
boolean | Đúng nếu người dùng đang chạy, sai trong mọi trường hợp khác. |
isUserSecondary
public boolean isUserSecondary (int userId)
Trả về xem người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của người dùng đó.
trả lại |
---|
boolean | đúng nếu người dùng là phụ, ngược lại là sai. |
isUserVisible
public boolean isUserVisible (int userId)
Kiểm tra xem người dùng đã cho có hiển thị không.
Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể khởi chạy các hoạt động khởi chạy (thường là trong màn hình mặc định).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Kiểm tra xem người dùng đã cho có hiển thị trong màn hình đã cho hay không.
Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể khởi chạy các hoạt động khởi chạy trong màn hình đó.
Thông số |
---|
userId | int |
displayId | int |
listDisplayId
public listDisplayIds ()
Thu thập danh sách id hiển thị có sẵn trên thiết bị như được báo cáo bởi "dumpsys SurfaceFlinger".
trả lại |
---|
| Danh sách hiển thị. Mặc định luôn trả về màn hình mặc định 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Nhận danh sách các màn hình có thể được sử dụng để start a user visible in the background
.
danh sách người dùng
public listUsers ()
Lấy danh sách người dùng trên thiết bị. Sẽ ném DeviceRuntimeException
nếu đầu ra từ thiết bị không như mong đợi.
trả lại |
---|
| danh sách id người dùng. |
logBáo cáo lỗi
public boolean logBugreport (String dataName,
ITestLogger listener)
Phương thức trợ giúp để lấy báo cáo lỗi và ghi lại cho người báo cáo.
Thông số |
---|
dataName | String : tên mà báo cáo lỗi sẽ được báo cáo. |
listener | ITestLogger : một ITestLogger để ghi nhật ký báo cáo lỗi. |
trả lại |
---|
boolean | Đúng nếu đăng nhập thành công, sai nếu không. |
bài đăngLời cầu nguyệnTearDown
public void postInvocationTearDown (Throwable exception)
Các bước bổ sung để dọn dẹp theo yêu cầu cụ thể của thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất.
Thông số |
---|
exception | Throwable : nếu có, ngoại lệ cuối cùng được đưa ra do lỗi gọi. |
xóaQuản trị viên
public boolean removeAdmin (String componentName,
int userId)
Xóa 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, nếu không thì trả về false
.
Thông số |
---|
componentName | String : của quản trị viên thiết bị sẽ bị xóa. |
userId | int : của người dùng mà quản trị viên thiết bị sống. |
trả lại |
---|
boolean | Đúng nếu nó thành công, sai nếu không. |
loại bỏChủ sở hữu
public void removeOwners ()
Xóa tất cả chủ sở hữu cấu hình thiết bị hiện có bằng nỗ lực cao nhất.
xóa người dùng
public boolean removeUser (int userId)
Xóa một người dùng nhất định khỏi thiết bị.
Thông số |
---|
userId | int : của người dùng để loại bỏ |
trả lại |
---|
boolean | đúng nếu chúng tôi xóa thành công người dùng, ngược lại là sai. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Đặt thành phần quản trị viên thiết bị làm chủ sở hữu thiết bị trong người dùng nhất định.
Thông số |
---|
componentName | String : của quản trị viên thiết bị là chủ sở hữu thiết bị. |
userId | int : của người dùng mà chủ sở hữu thiết bị đang sống. |
trả lại |
---|
boolean | Đúng nếu nó thành công, sai nếu không. |
thiết lậpCài đặt
public void setSetting (String namespace,
String key,
String value)
Xem setSetting(int, String, String, String)
và được thực hiện trên người dùng hệ thống.
Thông số |
---|
namespace | String |
key | String |
value | String |
thiết lậpCài đặt
public void setSetting (int userId,
String namespace,
String key,
String value)
Thêm một giá trị cài đặt vào không gian tên của một người dùng nhất định. Một số cài đặt sẽ chỉ khả dụng sau khi khởi động lại. không gian tên phải là một trong: {"system", "secure", "global"}
Thông số |
---|
userId | int |
namespace | String |
key | String |
value | String |
tắt máyMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Tắt thiết bị microdroid, nếu có.
Thông số |
---|
microdroidDevice | ITestDevice |
người dùng bắt đầu
public boolean startUser (int userId)
Bắt đầu một người dùng cụ thể trong nền nếu nó hiện đang bị dừng. Nếu người dùng đang chạy trong nền, phương pháp này là NOOP.
Thông số |
---|
userId | int : của người dùng để bắt đầu trong nền |
trả lại |
---|
boolean | true nếu người dùng đã khởi động thành công trong nền. |
người dùng bắt đầu
public boolean startUser (int userId,
boolean waitFlag)
Bắt đầu một người dùng cụ thể trong nền nếu nó hiện đang bị dừng. Nếu người dùng đang chạy trong nền, phương pháp này là NOOP. Có thể cung cấp thêm cờ để chờ thao tác có hiệu lực.
Thông số |
---|
userId | int : của người dùng để bắt đầu trong nền |
waitFlag | boolean : sẽ làm cho lệnh đợi cho đến khi người dùng bắt đầu và mở khóa. |
trả lại |
---|
boolean | true nếu người dùng đã khởi động thành công trong nền. |
startVisibleBackgroundNgười dùng
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Bắt đầu một người dùng nhất định trong nền, hiển thị trong màn hình nhất định (nghĩa là cho phép người dùng khởi chạy các hoạt động trong màn hình đó).
LƯU Ý: lệnh này không kiểm tra xem người dùng có tồn tại không, màn hình có sẵn không, device supports such feature
, v.v.
Thông số |
---|
userId | int : của người dùng để bắt đầu trong nền |
displayId | int : hiển thị để bắt đầu người dùng hiển thị trên |
waitFlag | boolean : sẽ làm cho lệnh đợi cho đến khi người dùng bắt đầu và mở khóa. |
trả lại |
---|
boolean | true nếu người dùng đã bắt đầu thành công hiển thị trong nền. |
người dùng dừng lại
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Dừng một người dùng nhất định. 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 phải chấm dứt. Không thể dừng người dùng hiện tại và hệ thống.
Thông số |
---|
userId | int : của người dùng để dừng lại. |
waitFlag | boolean : sẽ làm cho lệnh đợi cho đến khi người dùng dừng lại. |
forceFlag | boolean : sẽ buộc dừng người dùng. |
trả lại |
---|
boolean | đúng nếu người dùng đã dừng thành công. |
người dùng dừng lại
public boolean stopUser (int userId)
Dừng một người dùng nhất định. Nếu người dùng đã dừng, phương pháp này là NOOP. Không thể dừng người dùng hiện tại và hệ thống.
Thông số |
---|
userId | int : của người dùng để dừng lại. |
trả lại |
---|
boolean | đúng nếu người dùng đã dừng thành công. |
hỗ trợMicrodroid
public boolean supportsMicrodroid ()
Kiểm tra các điều kiện tiên quyết để chạy một microdroid.
trả lại |
---|
boolean | trả về true nếu các điều kiện tiên quyết được thỏa mãn, false nếu ngược lại. |
hỗ trợMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Kiểm tra các điều kiện tiên quyết để chạy một microdroid.
Thông số |
---|
protectedVm | boolean : true nếu microdroid dự định chạy trên VM được bảo vệ. |
trả lại |
---|
boolean | trả về true nếu các điều kiện tiên quyết được thỏa mãn, false nếu ngược lại. |
người dùng chuyển đổi
public boolean switchUser (int userId)
Chuyển sang userId khác với thời gian chờ mặc định. switchUser(int, long)
.
trả lại |
---|
boolean | Đúng nếu userId mới khớp với nhà cung cấp userId. Sai nếu không. |
người dùng chuyển đổi
public boolean switchUser (int userId,
long timeout)
Chuyển sang userId khác với thời gian chờ được cung cấp là hạn chót. Cố gắng vô hiệu hóa keyguard sau khi thay đổi người dùng thành công.
Thông số |
---|
userId | int |
timeout | long : đợi trước khi trả về false cho switch-user không thành công. |
trả lại |
---|
boolean | Đúng nếu userId mới khớp với nhà cung cấp userId. Sai nếu không. |
nhậnBugreport
public Bugreport takeBugreport ()
Lấy một báo cáo lỗi và gửi nó vào bên trong một đối tượng Bugreport
để xử lý nó. Trả về null trong trường hợp có vấn đề. Tệp được tham chiếu trong đối tượng Báo cáo lỗi cần được xóa thông qua Bugreport.close()
.
gỡ cài đặt Gói
public String uninstallPackage (String packageName)
Gỡ cài đặt gói Android khỏi thiết bị.
Thông số |
---|
packageName | String : gói Android cần gỡ cài đặt |
gỡ cài đặt GóiForUser
public String uninstallPackageForUser (String packageName,
int userId)
Gỡ cài đặt gói Android khỏi thiết bị cho một người dùng nhất định.
Thông số |
---|
packageName | String : gói Android cần gỡ cài đặt |
userId | int : id người dùng số nguyên để gỡ cài đặt. |
phương pháp được bảo vệ
tạoParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Thực hiện khởi động lại adb.
Thông số |
---|
rebootMode | NativeDevice.RebootMode : một chế độ khởi động lại này. |
reason | String : cho lần khởi động lại này. |
getBugreportzInternal
protected File getBugreportzInternal ()
Phương thức của Trình trợ giúp nội bộ để lấy tệp zip bugreportz dưới dạng ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Tiếp xúc để thử nghiệm.
getHostCurrentTime
protected long getHostCurrentTime ()
Tiếp xúc để thử nghiệm
prePostBootSetup
protected void prePostBootSetup ()
Cho phép từng loại thiết bị (AndroidNativeDevice, TestDevice) ghi đè phương pháp này để thiết lập bài đăng cụ thể.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2023-04-28 UTC.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Thiếu thông tin tôi cần"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Quá phức tạp/quá nhiều bước"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Đã lỗi thời"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Vấn đề về bản dịch"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Vấn đề về mẫu/mã"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Khác"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Dễ hiểu"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Giúp tôi giải quyết được vấn đề"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Khác"
}]