TestDevice
public
class
TestDevice
extends NativeDevice
Các lớp con trực tiếp đã biết
|
Các lớp con gián tiếp đã biết
|
Triển khai ITestDevice cho thiết bị Android full stack
Tóm tắt
Phương thức công khai |
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.
|
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ị.
|
int
|
createUser(String name)
Tạo người dùng có tên đã cho và cờ mặc định là 0.
|
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
|
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
|
createUserNoThrow(String name)
Tạo người dùng có tên đã cho và cờ mặc định là 0.
|
void
|
disableKeyguard()
Tìm cách tắt khoá màn hình.
|
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.
|
boolean
|
doesFileExist(String deviceFilePath)
Phương thức hỗ trợ để xác định xem tệp có tồn tại trên thiết bị hay không.
|
File
|
dumpHeap(String process, String devicePath)
Hãy thử kết xuất heap 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 khoá-giá trị 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 một userId, trả về giá trị rỗng nếu không tìm thấy.
|
|
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.
|
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 về các gói đã cài đặt trên thiết bị.
|
InputStreamSource
|
getBugreport()
Truy xuất một báo cáo lỗi từ thiết bị.
|
InputStreamSource
|
getBugreportz()
Truy xuất một bugreportz 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 giá trị rỗng nếu có vấn đề xảy ra.
|
int
|
getCurrentUser()
Trả về mã nhận dạng 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 khoá bảo vệ hoặc giá trị rỗng nếu không được hỗ trợ.
|
Integer
|
getMainUserId()
Trả về mã nhận dạng người dùng chính.
|
|
getMainlineModuleInfo()
Lấy thông tin về các mô-đun chính được cài đặt trên thiết bị.
|
int
|
getMaxNumberOfRunningUsersSupported()
Lấy số lượng tối đa người dùng được hỗ trợ chạy đồng thời.
|
int
|
getMaxNumberOfUsersSupported()
Lấy số lượng người dùng tối đa được hỗ trợ.
|
Integer
|
getPrimaryUserId()
Trả về mã nhận dạng người dùng chính.
|
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Chụp ảnh màn hình thiết bị.
|
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.
|
InputStreamSource
|
getScreenshot(String format)
Chụp ảnh màn hình thiết bị.
|
InputStreamSource
|
getScreenshot()
Chụp ảnh màn hình thiết bị.
|
String
|
getSetting(int userId, String namespace, String key)
Trả về giá trị của chế độ cài đặt được yêu cầu.
|
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.
|
|
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ả về các cờ của một người dùng cụ thể.
|
|
getUserInfos()
Nhận Bản đồ useId thành 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ó dùng được trên thiết bị hay không.
|
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Cài đặt một gói Android trên thiết bị.
|
String
|
installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)
Cài đặt một gói Android trên thiết bị.
|
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Cài đặt một gói Android trên thiết bị.
|
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ể.
|
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ể.
|
boolean
|
installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)
Cài đặt APK ở chế độ tăng dần.
|
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
|
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
|
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
|
String
|
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ợ việc liệt kê ứng dụng hay không
|
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.
|
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.
|
boolean
|
isMultiUserSupported()
Xác định xem thiết bị có hỗ trợ nhiều người dùng hay không.
|
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.
|
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.
|
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ề 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 đó.
|
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 đã cho có xuất hiện trong màn hình đã cho hay không.
|
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.
|
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.
|
|
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".
|
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Lấy danh sách các màn hình có thể 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 một báo cáo lỗi và ghi báo cáo đó vào các báo cáo.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Các bước bổ sung để dọn dẹp bắt buộc theo từng thiết bị cụ thể sẽ được thực thi sau khi hoàn tất lệnh gọi.
|
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.
|
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ể.
|
boolean
|
removeUser(int userId)
Xoá một người dùng nhất định khỏi thiết bị.
|
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.
|
void
|
setFirstBootloaderReboot()
|
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ị chế độ 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)
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.
|
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.
|
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 đó).
|
boolean
|
stopUser(int userId)
Dừng một người dùng cụ thể.
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Dừng một người dùng cụ thể.
|
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 một userId khác với thời gian chờ mặc định.
|
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.
|
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ý.
|
String
|
uninstallPackage(String packageName)
Gỡ cài đặt một gói Android khỏi thiết bị.
|
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.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Hằng số
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Các lệnh có thể dùng để đóng khoá bảo vệ.
Giá trị không đổi:
"input keyevent 82"
Hàm khởi tạo công khai
Phương thức công khai
canSwitchToHeadlessSystemUser
public 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.
clearErrorDialogs
public 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. |
createUser
public 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 |
createUser
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
| 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 |
createUser
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
| 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 |
createUserNoThrow
public 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. |
disableKeyguard
public 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)
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 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. |
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Phương thức hỗ trợ để xác định xem tệp có tồn tại trên thiết bị hay không.
| Tham số |
deviceFilePath |
String: đường dẫn tuyệt đối của tệp trên thiết bị cần kiểm tra |
| Giá trị trả về |
boolean |
true nếu tệp tồn tại, false nếu không. |
dumpHeap
public 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. |
getActiveApexes
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 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ợ. |
getAndroidId
public 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.
getAndroidIds
public 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. |
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ị.
| Tham số |
packageName |
String |
getAppPackageInfos
public getAppPackageInfos ()
Tìm nạp thông tin về các gói đã 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 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).
getBugreportz
public 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
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 giá trị rỗng nếu có vấn đề xảy ra.
getCurrentUser
public 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.
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ể lấy bằng lệnh "cmd device_state
print-states".
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 khoá bảo vệ hoặc giá trị rỗng nếu không được hỗ trợ.
getMainUserId
public 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. |
getMainlineModuleInfo
public 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ị. |
public 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 |
public 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ợ |
getPrimaryUserId
public Integer getPrimaryUserId ()
Trả về mã nhận dạng người dùng chính.
| Giá trị trả về |
Integer |
userId của người dùng chính (nếu có) và giá trị rỗng (nếu không có người dùng chính). |
getScreenshot
public 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ả |
getScreenshot
public 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. |
getScreenshot
public 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 |
getSetting
public 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. |
getSetting
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.
| Tham số |
namespace |
String |
key |
String |
getUninstallablePackageNames
public 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ị. |
getUserFlags
public 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.
| 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. |
getUserInfos
public 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. |
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.
hasFeature
public 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. |
installPackage
public 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. |
installPackage
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
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 |
certFile |
File: true nếu cần thực hiện quy trình cài đặt lại |
reinstall |
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. |
installPackage
public 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. |
installPackageForUser
public 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. |
installPackageForUser
public 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. |
installPackageWithIncrementalMode
public 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 |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
| Tham số |
packageFiles |
|
reinstall |
boolean |
extraArgs |
String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
| Tham số |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
| Tham số |
packageFiles |
|
reinstall |
boolean |
userId |
int |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
| Tham số |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
userId |
int |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
| Tham số |
remoteApkPaths |
|
reinstall |
boolean |
extraArgs |
String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
| Tham số |
remoteApkPaths |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Kiểm tra xem nền tảng trên thiết bị có hỗ trợ việc liệt kê ứng dụng hay không
| Giá trị trả về |
boolean |
True nếu tính năng liệt kê ứng dụng được hỗ trợ, false nếu không |
isHeadlessSystemUserMode
public 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.
isMainUserPermanentAdmin
public 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.
isMultiUserSupported
public 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 |
isPackageInstalled
public 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. |
isPackageInstalled
public 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. |
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.
| 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. |
isUserSecondary
public 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 đó.
| Giá trị trả về |
boolean |
true nếu người dùng là người dùng phụ, ngược lại là false. |
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 "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).
isUserVisibleOnDisplay
public 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 |
listDisplayIds
public 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. |
listUsers
public 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. |
logBugreport
public 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)
| Tham số |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Các bước bổ sung để dọn dẹp bắt buộc theo từng thiết bị cụ thể sẽ được thực thi sau khi hoàn tất lệnh gọi.
| Tham số |
exception |
Throwable: nếu có, ngoại lệ cuối cùng do lỗi gọi gây ra. |
removeAdmin
public 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. |
removeOwners
public 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ể.
removeUser
public 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. |
setDeviceOwner
public 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. |
setFirstBootloaderReboot
public void setFirstBootloaderReboot ()
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.
| Tham số |
namespace |
String |
key |
String |
value |
String |
setSetting
public 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 |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Tắt thiết bị microdroid (nếu có).
| Tham số |
microdroidDevice |
ITestDevice |
startUser
public 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. |
startUser
public 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. |
startVisibleBackgroundUser
public 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. |
stopUser
public 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. |
stopUser
public 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. |
supportsMicrodroid
public boolean supportsMicrodroid ()
Kiểm tra các điều kiện tiên quyết để chạy một microdroid.
| Giá trị trả về |
boolean |
trả về true nếu các điều kiện tiên quyết được đáp ứng, trả về false nếu không. |
supportsMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Kiểm tra các điều kiện tiên quyết để chạy một microdroid.
| Tham số |
protectedVm |
boolean: true nếu microdroid dự kiến chạy trên VM được bảo vệ. |
| Giá trị trả về |
boolean |
trả về true nếu các điều kiện tiên quyết được đáp ứng, trả về false nếu không. |
switchUser
public boolean switchUser (int userId)
Chuyển sang một userId khác với thời gian chờ mặc định. switchUser(int, long).
| 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. |
switchUser
public 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. |
takeBugreport
public 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().
uninstallPackage
public 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. |
uninstallPackageForUser
public 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. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
| Tham số |
currentPhase |
SnapuserdWaitPhase |
Phương thức được bảo vệ
createParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Thực hiện lệnh khởi động lại adb.
| Tham số |
rebootMode |
NativeDevice.RebootMode: một chế độ của lần 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 Trợ giúp nội bộ để lấy tệp zip bugreportz dưới dạng ERROR(/File).
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Được hiển thị để kiểm thử.
getHostCurrentTime
protected long getHostCurrentTime ()
Được hiển thị để kiểm thử
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 cụ thể sau khi khởi động.