TestDevice
public
class
TestDevice
extends NativeDevice
Các lớp con trực tiếp đã biết
ManagedRemoteDevice |
Một thiết bị chạy bên trong máy ảo mà chúng tôi quản lý từ xa thông qua một thực thể Tradefed bên trong máy ảo.
|
NestedRemoteDevice |
Hình ảnh đại diện cho thiết bị đang chạy bên trong máy ảo Cuttlefish từ xa.
|
RemoteAndroidDevice |
Triển khai ITestDevice cho một thiết bị Android có đầy đủ ngăn xếp được kết nối thông qua adb connect.
|
|
Các lớp con gián tiếp đã biết
|
Triển khai ITestDevice
cho thiết bị Android toàn bộ ngăn xếp
Tóm tắt
Phương thức công khai |
boolean
|
canSwitchToHeadlessSystemUser()
Trả về kết quả cho biết liệu 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()
Cố gắng đó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 một người dùng có tên và cờ mặc định là 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Tạo người dùng có tên và cờ đã cung cấp
|
int
|
createUser(String name, boolean guest, boolean ephemeral)
Tạo người dùng có tên và cờ đã cung cấp
|
int
|
createUserNoThrow(String name)
Tạo một người dùng có tên và cờ mặc định là 0.
|
void
|
disableKeyguard()
Tìm cách tắt khoá phím.
|
boolean
|
doesFileExist(String deviceFilePath)
Phương thức 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 vùng nhớ khối xếp 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, 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 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à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 báo cáo lỗi từ thiết bị.
|
InputStreamSource
|
getBugreportz()
Truy xuất bugreportz từ thiết bị.
|
DeviceFoldableState
|
getCurrentFoldableState()
Trả về trạng thái gập hiện tại của thiết bị hoặc giá trị rỗng nếu có một số vấn đề xảy ra.
|
int
|
getCurrentUser()
Trả về mã nhận dạng 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 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()
Nhận 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 người dùng tối đa được hỗ trợ chạy đồng thời.
|
int
|
getMaxNumberOfUsersSupported()
Nhận 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()
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(long displayId)
Lấy ảnh chụp màn hình từ thiết bị đã cho mã màn hình.
|
InputStreamSource
|
getScreenshot(String format)
Chụp ảnh màn hình từ 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 chế độ 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ả về cờ của một người dùng cụ thể.
|
|
getUserInfos()
Lấy Bản đồ của useId đến 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ó 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 cụ thể.
|
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 cụ thể.
|
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
|
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, 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ợ liệt kê ứng dụng hay không
|
boolean
|
isHeadlessSystemUserMode()
Trả về liệu 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 và không thể bị xoá hoặc hạ cấp xuống trạng thái không phải quản trị viên hay không.
|
boolean
|
isMultiUserSupported()
Xác định xem chế độ nhiều người dùng có được hỗ trợ hay không.
|
boolean
|
isPackageInstalled(String packageName)
Truy vấn thiết bị theo tên gói nhất định để kiểm tra xem gói đó hiện đã được cài đặt hay chưa.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Truy vấn thiết bị theo tên gói và mã nhận dạng người dùng nhất định để kiểm tra xem gói đó có đang được cài đặt cho người dùng đó hay không.
|
boolean
|
isUserRunning(int userId)
Kiểm tra xem một người dùng cụ thể 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ủ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ó hiển thị trong màn hình đã cho hay không.
|
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Trả về thông tin về việc thiết bị có cho phép người dùng bắt đầu hiển thị ở chế độ nền trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) hay không.
|
boolean
|
isVisibleBackgroundUsersSupported()
Trả về kết quả cho biết thiết bị có cho phép người dùng hiển thị ở chế độ 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ị do "dumpsys SurfaceFlinger" báo cáo.
|
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Lấy danh sách 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 báo cáo lỗi và ghi báo cáo đó vào trình 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 thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất.
|
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ó một cách hiệu quả nhất.
|
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 thành phần quản trị thiết bị làm chủ sở hữu thiết bị trong người dùng đã cho.
|
void
|
setFirstBootloaderReboot()
|
void
|
setSetting(String namespace, String key, String value)
Xem setSetting(int, String, String, String) và 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 cụ thể.
|
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 người dùng đó 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 người dùng đó 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ị trong màn hình nhất định (tức là cho phép người dùng 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 cụ thể.
|
boolean
|
stopUser(int userId)
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 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 một userId khác có 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ờ đượ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áo cáo đó bên trong đối tượng Bugreport để xử lý.
|
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 một gói Android khỏi thiết bị cho một người dùng cụ thể.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Trường
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Các lệnh có thể dùng để đóng màn hình khoá.
Hàm khởi tạo công khai
Phương thức công khai
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Trả về kết quả cho biết liệu 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 ()
Cố gắng đó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.
false nếu không. |
createUser
public int createUser (String name)
Tạo một người dùng có tên và cờ mặc định là 0.
Tham số |
name |
String : của người dùng để 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,
boolean forTesting)
Tạo người dùng có tên và cờ đã cung cấp
Tham 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 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 |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
Tạo người dùng có tên và cờ đã cung cấp
Tham 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 |
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 một người dùng có tên và cờ mặc định là 0.
Tham số |
name |
String : của người dùng để 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 cho lỗi. |
disableKeyguard
public void disableKeyguard ()
Tìm cách tắt khoá phím.
Trước tiên, hãy đợi quá trình điều phối đầu vào sẵn sàng, việc này xảy ra cùng lúc 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 sẽ được gửi để đóng khoá phím (chỉ hoạt động trên các khoá phím không bảo mật)
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Phương thức trợ giúp để xác định xem tệp trên thiết bị có tồn tại 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. |
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.
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 xem tệp có tồn tại hay không |
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)
Cố gắng kết xuất vùng nhớ khối xếp 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. |
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. Rỗng nếu có lỗi. |
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ị. Rỗng nếu không hỗ trợ không gian tên. |
getAndroidId
public String getAndroidId (int userId)
Tìm và trả về android-id được liên kết với một userId, 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 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à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 tính năng này được đảm bảo sẽ tiếp tục hoạt động trên một thiết bị không có thẻ SD (hoặc khi thẻ SD chưa được gắn).
getBugreportz
public InputStreamSource getBugreportz ()
Truy xuất bugreportz từ thiết bị. Tệp báo cáo lỗi ở định dạng zip chứa tệp báo cáo lỗi chính và các tệp nhật ký khác hữu ích cho việc gỡ lỗi.
Chỉ hỗ trợ cho "phiên bản adb" > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Trả về trạng thái gập hiện tại của thiết bị hoặc giá trị rỗng nếu có một số 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. 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à rỗng 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ị.
Giá trị trả về |
|
ERROR(/Set) trong số String mô-đun chính đang được cài đặt trên thiết bị. |
public int getMaxNumberOfRunningUsersSupported ()
Lấy số lượng người dùng tối đa đượ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 ()
Nhận 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à rỗng nếu không có người dùng chính. |
getScreenshot
public InputStreamSource getScreenshot ()
Chụp ảnh màn hình từ thiết bị.
getScreenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
Chụp ảnh màn hình từ thiết bị. Bạn nên sử dụng getScreenshot(String)
thay vì mã hoá JPEG để có kích thước nhỏ hơn.
Tham số |
format |
String : PNG, JPEG được hỗ trợ |
rescale |
boolean : liệu ảnh chụp màn hình có được điều chỉnh theo tỷ lệ để giảm kích thước của hình ảnh thu được hay không |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Lấy ảnh chụp màn hình từ thiết bị đã cho mã màn hình. Định dạng là PNG.
VIỆC CẦN LÀM: mở rộng các phương thức triển khai ở trên để hỗ trợ "định dạng" và "điều chỉnh theo tỷ lệ"
Tham số |
displayId |
long : mã màn hình hiển thị của màn hình cần lấy ảnh chụp màn hình. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Chụp ảnh màn hình từ thiết bị.
Bạn nên sử dụng getScreenshot(format) với phương thức mã hoá JPEG để có kích thước nhỏ hơn
Tham số |
format |
String : PNG, JPEG được hỗ trợ |
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.
Tham số |
namespace |
String |
key |
String |
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ị liên kết với namespace:key của người dùng. Rỗng 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. Hiện tại, các gói này được xác định là gói không phải hệ thống và 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à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 cụ thể.
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 liên kết với mã nhận dạng người dùng được cung cấp nếu có, -10000 trong mọi trường hợp khác. |
getUserInfos
public getUserInfos ()
Lấy Bản đồ của useId đến 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ó 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 tính năng, sai nếu không tìm thấy. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Cài đặt gói Android trên thiết bị.
Tham số |
packageFile |
File : tệp apk cần cài đặt |
reinstall |
boolean : true nếu cần 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 tuỳ 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 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 được gọi hàm này.
Tham số |
packageFile |
File : tệp apk cần cài đặt |
reinstall |
boolean : true nếu cần cài đặt lại |
grantPermissions |
boolean : liệu tất cả các quyền khi bắt đầu chạy có được cấp tại thời điểm cài đặt hay không |
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 tuỳ 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 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 được gọi hàm này.
Tham số |
packageFile |
File : tệp apk cần cài đặt |
certFile |
File : true nếu cần cài đặt lại |
reinstall |
boolean : liệu tất cả các quyền khi bắt đầu chạy có được cấp tại thời điểm cài đặt hay không |
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 tuỳ 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 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 được gọi hàm này.
Tham số |
packageFile |
File : tệp apk cần cài đặt |
reinstall |
boolean : true nếu cần cài đặt lại |
grantPermissions |
boolean : liệu tất cả các quyền khi bắt đầu chạy có được cấp tại thời điểm cài đặt hay không |
userId |
int : mã nhận dạng người dùng dạng 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 tuỳ 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 gói Android trên thiết bị cho một người dùng cụ thể.
Tham số |
packageFile |
File : tệp apk cần cài đặt |
reinstall |
boolean : true nếu cần cài đặt lại |
userId |
int : mã nhận dạng người dùng dạng số nguyên để cà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 tuỳ chọn có sẵn. |
Giá trị trả về |
String |
String có mã lỗi hoặc null nếu thành công. |
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,
boolean grantPermissions,
int userId,
String... extraArgs)
Tham số |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
userId |
int |
extraArgs |
String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Tham số |
packageFiles |
|
reinstall |
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ợ liệt kê ứng dụng hay không
Giá trị trả về |
boolean |
Đúng nếu tính năng liệt kê ứng dụng được hỗ trợ, nếu không thì sai |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Trả về liệu 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 và không thể bị xoá hoặc hạ cấp xuống trạng thái không phải quản trị viên hay không.
isMultiUserSupported
public boolean isMultiUserSupported ()
Xác định xem chế độ nhiều người dùng có được hỗ trợ hay không.
Giá trị trả về |
boolean |
true nếu hỗ trợ nhiều người dùng, false nếu không hỗ trợ |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Truy vấn thiết bị theo tên gói nhất định để kiểm tra xem 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ì giá trị sẽ là false. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Truy vấn thiết bị theo tên gói và mã nhận dạng người dùng nhất định để kiểm tra xem gói đó có đang được cài đặt cho người dùng đó hay không.
Tham số |
packageName |
String : gói mà chúng ta đang kiểm tra xem đã được cài đặt hay chưa. |
userId |
String : Mã nhận dạng người dùng mà chúng ta đang kiểm tra gói được cài đặt. Nếu giá trị này là rỗng, hệ thống sẽ sử dụng giá trị 0 cho 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ì giá trị sẽ là false. |
isUserRunning
public boolean isUserRunning (int userId)
Kiểm tra xem một người dùng cụ thể có đang chạy hay không.
Giá trị trả về |
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ề liệu 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 đó.
Giá trị trả về |
boolean |
true nếu người dùng là người dùng phụ, false 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ể 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ể 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ị do "dumpsys SurfaceFlinger" báo cáo.
Giá trị trả về |
|
Danh sách màn hình. Giá trị mặc định 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 báo cáo lỗi và ghi báo cáo đó vào trình báo cáo.
Tham số |
dataName |
String : tên mà báo cáo lỗi sẽ được báo cáo. |
listener |
ITestLogger : ITestLogger để ghi nhật ký báo cáo lỗi. |
Giá trị trả về |
boolean |
Đúng nếu quá trình ghi nhật ký thành công, sai 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 thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất.
Tham số |
exception |
Throwable : ngoại lệ cuối cùng (nếu có) 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 ở. |
Giá trị trả về |
boolean |
Đúng nếu thành công, sai nếu không thành công. |
removeOwners
public void removeOwners ()
Xoá tất cả chủ sở hữu hồ sơ thiết bị hiện có một cách hiệu quả nhất.
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á thành công người dùng, false nếu không. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Đặt thành phần quản trị thiết bị làm chủ sở hữu thiết bị trong người dùng đã cho.
Tham số |
componentName |
String : của quản trị viên thiết bị để trở 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 |
Đúng nếu thành công, sai nếu không thành công. |
setFirstBootloaderReboot
public void setFirstBootloaderReboot ()
setSetting
public void setSetting (String namespace,
String key,
String value)
Xem setSetting(int, String, String, String)
và 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ị cài đặt vào không gian tên của một người dùng cụ thể. Một số chế độ cài đặt sẽ chỉ hoạt động sau khi khởi động lại.
không gian tên phải là một trong 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)
Bắt đầu một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang bị dừng. Nếu người dùng đang chạy ở chế độ nền, thì phương thức này 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 đã khởi động thành công ở chế độ nền. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
Bắt đầu một người dùng nhất định ở chế độ nền nếu người dùng đó hiện đang bị dừng. Nếu người dùng đang chạy ở chế độ nền, thì phương thức này là NOOP. Có thể cung cấp cờ bổ sung để chờ thao tác 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 đã 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ị trong màn hình nhất định (tức là cho phép người dùng 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ó hoạt động 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ị 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 trong nền. |
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 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à người dùng hệ thống.
Tham số |
userId |
int : của người dùng để dừng. |
waitFlag |
boolean : sẽ khiến lệnh chờ cho đến khi người dùng dừng lại. |
forceFlag |
boolean : sẽ buộc người dùng dừng. |
Giá trị trả về |
boolean |
true nếu đã dừng người dùng thành công. |
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 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 để dừng. |
Giá trị trả về |
boolean |
true nếu đã dừng người 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.
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. |
hỗ trợ Microdroid
public boolean supportsMicrodroid (boolean protectedVm)
Kiểm tra các điều kiện tiên quyết để chạy microdroid.
Tham số |
protectedVm |
boolean : true nếu microdroid dự định chạy trên máy ảo đượ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 có thời gian chờ mặc định. switchUser(int, long)
.
Giá trị trả về |
boolean |
Đúng nếu userId mới khớp với trình cung cấp userId. Nếu không thì giá trị sẽ là false. |
switchUser
public boolean switchUser (int userId,
long timeout)
Chuyển sang một userId khác với thời gian chờ được cung cấp làm thời hạn.
Cố gắng tắt khoá phím sau khi người dùng thay đổi thành công.
Tham số |
userId |
int |
timeout |
long : để chờ trước khi trả về false cho trường hợp chuyển đổi người dùng không thành công. |
Giá trị trả về |
boolean |
Đúng nếu userId mới khớp với trình cung cấp userId. Nếu không thì giá trị sẽ là false. |
takeBugreport
public Bugreport takeBugreport ()
Lấy một báo cáo lỗi và trả về báo cáo đó bên trong đối tượng Bugreport
để xử lý. Trả về giá trị rỗng trong trường hợp gặp vấn đề. Bạn cần xoá 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 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 cụ thể.
Tham số |
packageName |
String : gói Android cần gỡ cài đặt |
userId |
int : mã nhận dạng người dùng dạng 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)
Khởi động lại adb.
Tham số |
rebootMode |
NativeDevice.RebootMode : 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 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 mỗi 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.