Các lớp lồng nhau |
---|
class | TestDevice.MicrodroidBuilder Trình tạo được sử dụng để tạo Microdroid TestDevice. |
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 pháp 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 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 với tên cụ thể và cờ mặc định 0. |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Tạo người dùng với tên cụ thể và các cờ được cung cấp |
int | createUser (String name, boolean guest, boolean ephemeral) Tạo người dùng với tên cụ thể và các cờ được cung cấp |
int | createUserNoThrow (String name) Tạo người dùng với tên cụ thể 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 pháp trợ giúp để xác định xem tệp trên thiết bị có tồn tại đối với một người dùng nhất định hay không. |
File | dumpHeap (String process, String devicePath) Cố gắng kết xuất vùng nhớ heap từ system_server. |
| getActiveApexes () Tìm nạp thông tin về 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ả về android-id được liên kết với userId, null nếu không tìm thấy. |
| getAndroidIds () Tạo Bản đồ các 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ề gói được cài đặt trên thiết bị. |
| getAppPackageInfos () Lấy thông tin 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 () Truy xuất 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 một số sự cố. |
int | getCurrentUser () Trả về id của người dùng đang chạy. |
| 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 đường dây chính được cài đặt trên thiết bị. |
int | getMaxNumberOfRunningUsersSupported () Nhận số lượng người dùng đang 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) Chụp ảnh màn hình từ thiết bị có id hiển thị. |
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. |
String | getSetting (int userId, String namespace, String key) Trả về giá trị của cài đặt được yêu cầu. |
| getUninstallablePackageNames () Lấy tên gói ứng dụng có thể được gỡ cài đặt. |
int | getUserFlags (int userId) Tìm và trả về cờ của một người dùng nhất định. |
| getUserInfos () Nhận Bản đồ useId tới UserInfo trên thiết bị. |
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. |
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ề việc người dùng chính có phải là quản trị viên thường trực hay không và không thể xóa hoặc hạ cấp xuống trạng thái không phải quản trị viên. |
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ị để biế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 nhất định để kiểm tra xem nó 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 hay 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 nó. |
boolean | isUserVisible (int userId) Kiểm tra xem người dùng đã cho có hiển thị hay không. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Kiểm tra xem người dùng nhất định có hiển thị trong màn hình nhất định hay không. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Trả về xem thiết bị có cho phép người dùng khởi động ở chế độ nền trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) . |
boolean | isVisibleBackgroundUsersSupported () Trả về việc thiết bị có cho phép người dùng bắt đầu hiển thị ở chế độ nền hay không. |
| listDisplayIds () Thu thập danh sách id hiển thị có sẵn trên thiết bị theo báo cáo của "dumpsys SurfaceFlinger". |
| listDisplayIdsForStartingVisibleBackgroundUsers () Lấy danh sách các màn hình có thể được sử dụng để start a user visible in the background . |
| listUsers () Lấy danh sách người dùng trên thiết bị. |
boolean | logBugreport (String dataName, ITestLogger listener) Phương pháp trợ giúp để lấy báo cáo lỗi và ghi lại cho người báo cáo. |
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 thực hiện xong lệnh gọi. |
boolean | removeAdmin (String componentName, int userId) Xóa quản trị viên thiết bị nhất định trong người dùng nhất định và trả về true nếu thành công, ngược lại là false . |
void | removeOwners () Xóa tất cả chủ sở hữu hồ sơ thiết bị hiện có bằng nỗ lực tốt nhất. |
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 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 nhất định ở chế độ 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 nhất định ở chế độ 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 ở chế độ nền, hiển thị trên màn hình nhất định (nghĩa là cho phép người dùng khởi chạy các hoạt động trong màn hình đó). |
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 microdroid. |
boolean | supportsMicrodroid (boolean protectedVm) Kiểm tra các điều kiện tiên quyết để chạy 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àm thời hạn. |
Bugreport | takeBugreport () Lấy một báo cáo lỗi và trả về bên trong đối tượng Bugreport để xử lý nó. |
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 xây dựng công cộng
Phương pháp 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 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 . |
tạo người dùng
public int createUser (String name)
Tạo người dùng với tên cụ thể và cờ mặc định 0.
Thông số |
---|
name | String : của người dùng tạo trên thiết bị |
Trả lại |
---|
int | số nguyên cho id người dùng được tạo |
tạo người dùng
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Tạo người dùng với tên cụ thể và các cờ được cung cấp
Thông số |
---|
name | String : của người dùng tạo trên thiết bị |
guest | boolean : bật cờ người dùng --guest trong khi tạo |
ephemeral | boolean : bật cờ người dùng --ephemeral trong quá trình tạo |
forTesting | boolean : bật cờ kiểm tra --for-testing trong quá trình tạo |
Trả lại |
---|
int | id của người dùng đã tạo |
tạo người dùng
public int createUser (String name,
boolean guest,
boolean ephemeral)
Tạo người dùng với tên cụ thể và các cờ được cung cấp
Thông số |
---|
name | String : của người dùng tạo trên thiết bị |
guest | boolean : bật cờ người dùng --guest trong khi tạo |
ephemeral | boolean : bật cờ người dùng --ephemeral trong quá trình tạo |
Trả lại |
---|
int | id của người dùng đã tạo |
tạoUserNoThrow
public int createUserNoThrow (String name)
Tạo người dùng với tên cụ thể và cờ mặc định 0.
Thông số |
---|
name | String : của người dùng tạo trên thiết bị |
Trả lại |
---|
int | số nguyên cho id người dùng đã tạo hoặc -1 nếu có lỗi. |
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 lúc khi thiết bị báo cáo BOOT_COMPLETE, dường như không đồng bộ, vì việc triển khai khung hiện tại thỉnh thoảng có điều kiện chạy đua. Sau đó, lệnh được gửi để loại bỏ keyguard (chỉ hoạt động trên những key không bảo mật)
khôngFileExist
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 file trên thiết bị cần kiểm tra |
Trả lại |
---|
boolean | true nếu tập tin tồn tại, false nếu không. |
khôngFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Phương pháp trợ giúp để xác định xem tệp trên thiết bị có tồn tại đối với một người dùng nhất định hay không.
Thông số |
---|
deviceFilePath | String : đường dẫn tuyệt đối của file trên thiết bị cần kiểm tra |
userId | int : ID người dùng để kiểm tra sự tồn tại của tệp |
Trả lại |
---|
boolean | true nếu tập tin tồn tại, false nếu không. |
đổ đống
public File dumpHeap (String process,
String devicePath)
Cố gắng kết xuất vùng nhớ heap từ system_server. Trách nhiệm của người gọi là dọn sạch tệp bị đổ.
Thông số |
---|
process | String : tên của tiến trình thiết bị cần dumpheap. |
devicePath | String : đường dẫn trên thiết bị nơi đặt kết xuất. Đây phải là vị trí mà quyền cho phép. |
Trả lại |
---|
File | ERROR(/File) chứa báo cáo. Null nếu có gì đó không thành công. |
getActiveApexes
public getActiveApexes ()
Tìm nạp thông tin về 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 số {"system", "secure", "global"} |
Trả lại |
---|
| bản đồ của các cặp giá trị khóa. Null nếu không gian tên không được hỗ trợ. |
lấy ID Android
public String getAndroidId (int userId)
Tìm và trả về android-id được liên kết với userId, null nếu không tìm thấy.
lấy ID Android
public getAndroidIds ()
Tạo Bản đồ các id android được tìm thấy phù hợp với id người dùng. Không có gì đảm bảo rằng mỗi id người dùng sẽ tìm thấy một id android được liên kết với chức năng này nên một số id người dùng có thể khớp với giá trị rỗng.
Trả lại |
---|
| Bản đồ các id android được tìm thấy phù hợp với id người dùng. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Tìm nạp thông tin về gói được cài đặt trên thiết bị.
Thông số |
---|
packageName | String |
getAppPackageInfos
public getAppPackageInfos ()
Lấy thông tin các gói được cài đặt trên thiết bị.
nhận được báo cáo lỗi
public InputStreamSource getBugreport ()
Truy xuất báo cáo lỗi từ thiết bị.
Việc triển khai tính năng này được đảm bảo sẽ tiếp tục hoạt động trên thiết bị không có thẻ sdcard (hoặc nơi chưa gắn thẻ sdcard).
lấy báo cáo lỗi
public InputStreamSource getBugreportz ()
Truy xuất báo cáo lỗi từ thiết bị. Báo cáo lỗi định dạng Zip chứa báo cáo lỗi chính và các tệp nhật ký khác hữu ích cho việc gỡ lỗi.
Chỉ được hỗ trợ cho 'phiên bản adb' > 1.0.36
get CurrentFoldableState
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 một số sự cố.
getCurrentUser
public int getCurrentUser ()
Trả về id của người dùng đang chạy. Trong trường hợp có lỗi, trả về -10000.
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 bằng "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 đường dây chính được cài đặt trên thiết bị.
public int getMaxNumberOfRunningUsersSupported ()
Nhận số lượng người dùng đang chạy đồng thời được hỗ trợ tối đa. Mặc định là 0.
Trả lại |
---|
int | một số nguyên biểu thị số lượng người dùng đang chạy đồng thời |
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ị. Khuyến nghị sử dụng getScreenshot(String)
thay vì mã hóa JPEG để có kích thước nhỏ hơn.
Thông số |
---|
format | String : được hỗ trợ PNG, JPEG |
rescale | boolean : nếu ảnh chụp màn hình cần được thay đổi kích thước để giảm kích thước của hình ảnh thu được |
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ị. Khuyến nghị sử dụng getScreenshot(format) thay vì mã hóa JPEG để có kích thước nhỏ hơn
Thông số |
---|
format | String : được hỗ trợ PNG, JPEG |
lấy Ảnh chụp màn hình
public InputStreamSource getScreenshot (long displayId)
Chụp ảnh màn hình từ thiết bị có id hiển thị. Định dạng là PNG.
VIỆC CẦN LÀM: mở rộng việc triển khai ở trên để hỗ trợ 'định dạng' và 'tỷ lệ lại'
Thông số |
---|
displayId | long : id hiển thị của màn hình để lấy ảnh chụp màn hình. |
cài đặt
public String getSetting (String namespace,
String key)
Xem getSetting(int, String, String)
và được thực hiện trên người dùng hệ thống.
Thông số |
---|
namespace | String |
key | String |
cài đặt
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 ()
Lấy tên gói ứng dụng có thể được gỡ cài đặt. Điều này hiện được định nghĩa là các gói phi hệ thống và các gói hệ thống được cập nhật.
Trả lại |
---|
| ERROR(/Set) tên gói String có thể gỡ cài đặt hiện được cài đặt trên thiết bị. |
getUserFlags
public int getUserFlags (int userId)
Tìm và trả về cờ của một người dùng nhất định. Cờ được xác định trong lớp "android.content.pm.UserInfo" trong Dự án mã nguồn mở Android.
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. |
lấy thông tin người dùng
public getUserInfos ()
Nhận Bản đồ useId tới UserInfo
trên thiết bị. Sẽ ném DeviceRuntimeException
nếu đầu ra từ thiết bị không như mong đợi.
Trả lại |
---|
| danh sách các đối tượng UserInfo. |
getUserSerialNumber
public 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.
có tính năng
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 sẽ là "feature: " hoặc " " trực tiếp. |
Trả lại |
---|
boolean | Đúng nếu tìm thấy đặc điểm, nếu không thì sai. |
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ần cài đặt |
reinstall | boolean : true nếu cài đặt lại nên được thực hiện |
extraArgs | String : đối số bổ sung tùy chọn cần chuyển. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn. |
Trả lại |
---|
String | một String có mã lỗi hoặc null nếu thành công. |
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 nên gọi hàm này.
Thông số |
---|
packageFile | File : file apk cần cài đặt |
reinstall | boolean : true nếu cài đặt lại nên được thực hiện |
grantPermissions | boolean : nếu tất cả các quyền thời gian chạy phải được cấp vào lúc cài đặt |
extraArgs | String : đối số bổ sung tùy chọn cần chuyển. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn. |
Trả lại |
---|
String | một String có mã lỗi hoặc null nếu thành công. |
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 nên gọi hàm này.
Thông số |
---|
packageFile | File : file apk cần cài đặt |
certFile | File : true nếu cần thực hiện cài đặt lại |
reinstall | boolean : nếu tất cả các quyền thời gian chạy phải được cấp vào lúc cài đặt |
extraArgs | String : đối số bổ sung tùy chọn cần chuyển. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn. |
Trả lại |
---|
String | một String có mã lỗi hoặc null nếu thành công. |
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 nên gọi hàm này.
Thông số |
---|
packageFile | File : file apk cần cài đặt |
reinstall | boolean : true nếu cài đặt lại nên được thực hiện |
grantPermissions | boolean : nếu tất cả các quyền thời gian chạy phải được cấp vào lúc cài đặt |
userId | int : id người dùng số nguyên để cài đặt. |
extraArgs | String : đối số bổ sung tùy chọn cần chuyển. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn. |
Trả lại |
---|
String | một String có mã lỗi hoặc null nếu thành công. |
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ần cài đặt |
reinstall | boolean : true nếu cài đặt lại nên được thực hiện |
userId | int : id người dùng số nguyên để cài đặt. |
extraArgs | String : đối số bổ sung tùy chọn cần truyền. Xem 'adb shell pm -h' để biết các tùy chọn có sẵn. |
Trả lại |
---|
String | một String có mã lỗi hoặc null nếu thành công. |
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 đặtGóiForUser
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 đặtGóiForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Thông số |
---|
packageFiles | |
reinstall | boolean |
userId | int |
extraArgs | String |
cài đặtRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Thông số |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
cài đặtRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Thông số |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
isAppEnumerationĐược hỗ 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ợ, nếu không thì sai |
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ề việc người dùng chính có phải là quản trị viên thường trực hay không và không thể xóa hoặc hạ cấp xuống trạng thái không phải quản trị viên.
isMultiUserĐược hỗ 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 |
isPackageĐã cài đặt
public boolean isPackageInstalled (String packageName)
Truy vấn thiết bị để biết tên gói nhất định để kiểm tra xem nó hiện đã được cài đặt hay chưa.
Thông số |
---|
packageName | String |
Trả lại |
---|
boolean | Đúng nếu gói được báo cáo là đã cài đặt. Sai nếu không. |
isPackageĐã cài đặt
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 nhất định để kiểm tra xem nó hiện đã được cài đặt hay chưa cho người dùng đó.
Thông số |
---|
packageName | String : gói chúng tôi đang kiểm tra xem nó đã được cài đặt chưa. |
userId | String : Id người dùng mà chúng tôi đang kiểm tra gói đã được cài đặt chưa. Nếu null, số 0 của người dùng chính sẽ được sử dụng. |
Trả lại |
---|
boolean | Đúng nếu gói được báo cáo là đã cài đặt. Sai nếu không. |
isUserRunning
public boolean isUserRunning (int userId)
Kiểm tra xem một người dùng nhất định có đang chạy hay 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 nó.
Trả lại |
---|
boolean | đúng nếu người dùng là phụ, sai nếu không. |
isUserVisible
public boolean isUserVisible (int userId)
Kiểm tra xem người dùng đã cho có hiển thị hay không.
Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể khởi chạy các hoạt động khởi chạy (thường ở màn hình mặc định).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Kiểm tra xem người dùng nhất định có hiển thị trong màn hình nhất định hay không.
Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể khởi chạy các hoạt động khởi chạy trong màn hình đó.
Thông số |
---|
userId | int |
displayId | int |
danh sáchId hiển thị
public listDisplayIds ()
Thu thập danh sách id hiển thị có sẵn trên thiết bị theo báo cáo của "dumpsys SurfaceFlinger".
Trả lại |
---|
| Danh sách hiển thị. Mặc định luôn trả về hiển thị mặc định 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Lấy danh sách các màn hình có thể được sử dụng để start a user visible in the background
.
danh sáchNgườ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 pháp trợ giúp để lấy báo cáo lỗi và ghi lại cho người báo cáo.
Thông số |
---|
dataName | String : tên mà báo cáo lỗi sẽ được báo cáo. |
listener | ITestLogger : ITestLogger để ghi lại báo cáo lỗi. |
Trả lại |
---|
boolean | Đúng nếu ghi nhật ký thành công, ngược lại là sai. |
postInvocationTearDown
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 thực hiện xong lệnh gọi.
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ị nhất định trong người dùng nhất định và trả về true
nếu thành công, ngược lại là false
.
Thông số |
---|
componentName | String : của quản trị viên thiết bị sẽ bị xóa. |
userId | int : của người dùng mà quản trị viên thiết bị đang sống. |
Trả lại |
---|
boolean | Đúng nếu thành công, ngược lại là sai. |
xóaChủ sở hữu
public void removeOwners ()
Xóa tất cả chủ sở hữu hồ sơ thiết bị hiện có bằng nỗ lực tốt nhất.
xóaNgườ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 cần xóa |
Trả lại |
---|
boolean | đúng nếu chúng tôi xóa thành công người dùng, nếu không thì sai. |
setChủ sở hữu thiết bị
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 thành công, ngược lại là sai. |
setSetting
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 |
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)
Thêm giá trị cài đặt vào không gian tên của một người dùng nhất định. Một số cài đặt sẽ chỉ khả dụng sau khi khởi động lại. không gian tên phải là một trong: {"system", "secure", "global"}
Thông số |
---|
userId | int |
namespace | String |
key | String |
value | String |
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 nhất định ở chế độ nền nếu nó hiện đang bị dừng. Nếu người dùng đã chạy ở chế độ nền thì phương pháp này là NOOP.
Thông số |
---|
userId | int : của người dùng để bắt đầu ở chế độ nền |
Trả lại |
---|
boolean | đúng nếu người dùng đã khởi động thành công ở chế độ nền. |
người dùng bắt đầu
public boolean startUser (int userId,
boolean waitFlag)
Bắt đầu một người dùng nhất định ở chế độ nền nếu nó hiện đang bị dừng. Nếu người dùng đã chạy ở chế độ nền thì phương pháp này là NOOP. Có thể cung cấp thêm cờ để chờ thao tác có hiệu lực.
Thông số |
---|
userId | int : của người dùng để bắt đầu ở chế độ nền |
waitFlag | boolean : sẽ khiến lệnh đợi cho đến khi người dùng khởi động và mở khóa. |
Trả lại |
---|
boolean | đúng nếu người dùng đã khởi động thành công ở chế độ nền. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Bắt đầu một người dùng nhất định ở chế độ nền, hiển thị trên màn hình nhất định (nghĩa là cho phép người dùng khởi chạy các hoạt động trong màn hình đó).
LƯU Ý: lệnh này không kiểm tra xem người dùng có tồn tại hay không, màn hình có khả dụng hay không, device supports such feature
, v.v.
Thông số |
---|
userId | int : của người dùng để bắt đầu ở chế độ nền |
displayId | int : hiển thị để bắt đầu hiển thị người dùng trên |
waitFlag | boolean : sẽ khiến lệnh đợi cho đến khi người dùng khởi động và mở khóa. |
Trả lại |
---|
boolean | true nếu người dùng đã khởi động thành công ở chế độ nền. |
dừng lạiNgười dùng
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 thêm cờ để chờ thao tác có hiệu lực và buộc chấm dứt người dùng. Không thể dừng người dùng hiện tại và hệ thống.
Thông số |
---|
userId | int : của người dùng dừng lại. |
waitFlag | boolean : sẽ khiến lệnh đợi cho đến khi người dùng dừng lại. |
forceFlag | boolean : sẽ buộc người dùng dừng lại. |
Trả lại |
---|
boolean | đúng nếu người dùng đã dừng thành công. |
dừng lạiNgười dùng
public boolean stopUser (int userId)
Dừng một người dùng nhất định. Nếu người dùng đã bị dừng thì phương pháp này là NOOP. Không thể dừng người dùng hiện tại và hệ thống.
Thông số |
---|
userId | int : của người dùng dừng lại. |
Trả lại |
---|
boolean | đúng nếu người dùng đã dừng thành công. |
hỗ trợMicrodroid
public boolean supportsMicrodroid ()
Kiểm tra các điều kiện tiên quyết để chạy 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, nếu không thì trả về false. |
hỗ trợMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Kiểm tra các điều kiện tiên quyết để chạy microdroid.
Thông số |
---|
protectedVm | boolean : đúng nếu microdroid được thiết kế để chạy trên máy ảo đượ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, nếu không thì trả về false. |
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àm thời hạn. Cố gắng tắt tính năng bảo vệ bàn phím sau khi thay đổi người dùng thành công.
Thông số |
---|
userId | int |
timeout | long : chờ trước khi trả về false cho người dùng chuyển đổi không thành công. |
Trả lại |
---|
boolean | Đúng nếu userId mới khớp với nhà cung cấp userId. Sai nếu không. |
lấy báo cáo lỗi
public Bugreport takeBugreport ()
Lấy một báo cáo lỗi và trả về bên trong đối tượng Bugreport
để xử lý nó. Trả về null trong trường hợp có vấn đề. Tệp được tham chiếu trong đối tượng Bugreport cần được xóa thông qua Bugreport.close()
.
gỡ cài đặtGó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 |
Trả lại |
---|
String | một String có mã lỗi hoặc null nếu thành công. |
gỡ cài đặtPackageForUser
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 cần gỡ cài đặt. |
Trả lại |
---|
String | một String có mã lỗi hoặc null nếu thành công. |
Phương pháp được bảo vệ
tạoParser
protected AaptParser createParser (File appFile)
doAdbKhởi động lại
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. |
getBugreportzNội bộ
protected File getBugreportzInternal ()
Phương thức 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 thức này để thiết lập sau khi khở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-12-01 UTC.
[]
[]