Thiết bị thử nghiệm
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 đầy đủ ngăn xếp
Tóm tắt
Phương thức công khai |
boolean
|
canSwitchToHeadlessSystemUser()
Trả về việc có cho 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()
Hãy thử loại bỏ mọi hộp thoại lỗi đ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 bằng tên cụ thể và cờ mặc định là 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Tạo một người dùng bằng tên cụ thể và cờ được cung cấp
|
int
|
createUser(String name, boolean guest, boolean ephemeral)
Tạo một người dùng bằng tên cụ thể và cờ được cung cấp
|
int
|
createUserNoThrow(String name)
Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0.
|
void
|
disableKeyguard()
Cố gắng tắt tính năng bảo vệ bàn phím.
|
boolean
|
doesFileExist(String deviceFilePath)
Phương thức trợ giúp để xác định xem có tệp trên thiết bị hay không.
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Phương thức trợ giúp để xác định xem một người dùng cụ thể có tồn tại tệp trên thiết bị hay không.
|
File
|
dumpHeap(String process, String devicePath)
Thử 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ặ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 userId, null nếu không tìm thấy.
|
|
getAndroidIds()
Tạo Bản đồ các mã nhận dạng Android 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ài đặt trên thiết bị.
|
|
getAppPackageInfos()
Tìm nạp thông tin của 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 báo cáo lỗi 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 rỗng nếu xảy ra một số vấn đề.
|
int
|
getCurrentUser()
Trả về mã nhận dạng của người dùng hiện đang chạy.
|
|
getFoldableStates()
Trả về danh sách trạng thái gập 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 để nhận trạng thái hiện tại của tính năng bảo vệ bàn phím hoặc trả về 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 đường dây chính đã cài đặt trên thiết bị.
|
int
|
getMaxNumberOfRunningUsersSupported()
Nhận số lượng tối đa người dùng chạy đồng thời được hỗ trợ.
|
int
|
getMaxNumberOfUsersSupported()
Nhận số lượng người dùng được hỗ trợ tối đa.
|
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(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ó mã hiển thị được cung cấp.
|
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 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()
Tải Map of useId cho UserInfo trên thiết bị.
|
int
|
getUserSerialNumber(int userId)
Trả lại số sê-ri được liên kết với userId nếu có, -10000 trong mọi trường hợp khác.
|
boolean
|
hasFeature(String feature)
Kiểm tra xem thiết bị có tính năng nào 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, boolean reinstall, boolean grantPermissions, 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
|
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ể.
|
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
|
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ợ tính năng 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 có giao diện người dùng hay không.
|
boolean
|
isMainUserPermanentAdmin()
Trả về việc 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
không phải quản trị viên.
|
boolean
|
isMultiUserSupported()
Xác định xem có hỗ trợ nhiều người dùng hay không.
|
boolean
|
isPackageInstalled(String packageName)
Truy vấn thiết bị về một tên gói cụ thể để kiểm tra xem thiết bị đã được cài đặt hay chưa.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Truy vấn thiết bị để biết một tên gói cụ thể và mã nhận dạng người dùng được cung cấp để kiểm tra xem gói đó hiện
đã cài đặt hoặc chưa được cài đặt cho người dù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ề việc người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của ứng dụng đó.
|
boolean
|
isUserVisible(int userId)
Kiểm tra xem người dùng cụ thể có hiển thị hay không.
|
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Kiểm tra xem người dùng cụ thể có xuất hiện trên màn hình cụ thể hay không.
|
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Trả về xem thiết bị có cho phép người dùng bắt đầu xuất hiện ở chế độ nền trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) hay không.
|
boolean
|
isVisibleBackgroundUsersSupported()
Trả về xem thiết bị có cho phép người dùng bắt đầu xuất hiện ở chế độ nền hay không.
|
|
listDisplayIds()
Thu thập danh sách mã 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 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 pháp trợ giúp để báo cáo lỗi và ghi báo cáo đó cho người 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ị cụ thể sẽ được thực thi sau lệnh gọi
là xong.
|
boolean
|
removeAdmin(String componentName, int userId)
Xoá quản trị viên thiết bị đã cho trong người dùng cụ thể và trả về true nếu thành công, nếu không thì trả về false .
|
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 có thể.
|
boolean
|
removeUser(int userId)
Xoá một người dùng cụ thể khỏi thiết bị.
|
boolean
|
setDeviceOwner(String componentName, int userId)
Đặt mộ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 cụ thể.
|
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 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 cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng.
|
boolean
|
startUser(int userId, boolean waitFlag)
Bắt đầu một người dùng cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng.
|
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Bắt đầu một người dùng cụ thể ở chế độ nền, hiển thị trên 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, 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)
Hãy chuyển sang một userId khác có thời gian chờ đã cung cấp làm thời hạn.
|
Bugreport
|
takeBugreport()
Tạo báo cáo lỗi và trả về bên trong đố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ị của một người dùng cụ thể.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Trường
ĐÓNG_KEYGIZED_CMD
public static final String DISMISS_KEYGUARD_CMD
Các lệnh có thể dùng để đóng bàn phím.
Hàm khởi tạo công khai
Phương thức công khai
Người dùng canSwitchTo HeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Trả về việc có cho 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 ()
Hãy thử loại bỏ mọi hộp thoại lỗi đ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 các hộp thoại đã được xoá thành công.
false . |
Tạo người dùng
public int createUser (String name)
Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0.
Tham số |
name |
String : số người dùng được 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 |
Tạo người dùng
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Tạo một người dùng bằng tên cụ thể và cờ được cung cấp
Tham số |
name |
String : số người dùng được tạo trên thiết bị |
guest |
boolean : bật cờ người dùng – khách trong quá trình tạo |
ephemeral |
boolean : bật cờ người dùng -- tạm thời trong quá trình tạo |
forTesting |
boolean : bật cờ kiểm thử để kiểm thử trong quá trình tạo |
Giá trị trả về |
int |
mã nhận dạng 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 một người dùng bằng tên cụ thể và cờ được cung cấp
Tham số |
name |
String : số người dùng được tạo trên thiết bị |
guest |
boolean : bật cờ người dùng – khách trong quá trình tạo |
ephemeral |
boolean : bật cờ người dùng -- tạm thời trong quá trình tạo |
Giá trị trả về |
int |
mã nhận dạng của người dùng đã tạo |
createNgười dùngKhôngThrow
public int createUserNoThrow (String name)
Tạo một người dùng bằng tên cụ thể và cờ mặc định là 0.
Tham số |
name |
String : số người dùng được 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 được tạo hoặc -1 nếu bị lỗi. |
tắt tính năng Bảo vệ bàn phím
public void disableKeyguard ()
Cố gắng tắt tính năng bảo vệ bàn phím.
Trước tiên, hãy đợi việc truyền dữ liệu đầu vào sẵn sàng, điều này xảy ra cùng khoảng thời gian khi
thiết bị báo cáo BOOT_complete, có vẻ như không đồng bộ, vì khung hiện tại
Việc triển khai không thường xuyên có tình huống tương tranh. Sau đó, lệnh được gửi để đóng tính năng bảo vệ bàn phím (hoạt động
chỉ đối với những miền không an toàn)
notFileExist
public boolean doesFileExist (String deviceFilePath)
Phương thức trợ giúp để xác định xem có tệp 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, nếu không thì false . |
notFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Phương thức trợ giúp để xác định xem một người dùng cụ thể có tồn tại tệp 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 |
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, nếu không thì false . |
Tệp báo lỗi
public File dumpHeap (String process,
String devicePath)
Thử kết xuất vùng nhớ khối xếp từ system_server. Người 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ị để tệp kết xuất. |
devicePath |
String : đường dẫn trên thiết bị nơi để tệp kết xuất. Đây phải là địa điểm mà
quyền cho phép cài đặt đó. |
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ị.
getTất cả chế độ cài đặt
public getAllSettings (String namespace)
Trả về 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ề |
|
sơ đồ các cặp khoá-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 userId, null nếu không tìm thấy.
getAndroidIds
public getAndroidIds ()
Tạo Bản đồ các mã nhận dạng Android tìm thấy khớp với mã nhận dạng người dùng. Không có bảo hiểm mà mỗi người dùng
mã nhận dạng sẽ tìm thấy 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 trùng khớ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 của các gói đã cài đặt trên thiết bị.
nhận 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 đảm bảo sẽ tiếp tục hoạt động trên thiết bị không có thẻ sd
(hoặc khi thẻ sd chưa được gắn).
lỗi 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ỉ hỗ trợ cho "phiên bản adb" > 1.0.36
Nhận trạng thái có thể gập lại hiện tại
public DeviceFoldableState getCurrentFoldableState ()
Trả về trạng thái gập hiện tại của thiết bị hoặc rỗng nếu xảy ra một số vấn đề.
nhận người dùng hiện tại
public int getCurrentUser ()
Trả về mã nhận dạng của người dùng hiện đang chạy. Trong trường hợp lỗi, hãy trả về -10000.
có thể gập lạiStates
public getFoldableStates ()
Trả về danh sách trạng thái gập trên thiết bị. Có thể lấy được bằng lệnh "cmd device_state"
trạng thái in".
getInstallPackageNames
public getInstalledPackageNames ()
Tìm nạp tên gói ứng dụng có trên thiết bị.
nhận trạng thái bảo vệ phím
public KeyguardControllerState getKeyguardState ()
Trả về một đối tượng để nhận trạng thái hiện tại của tính năng bảo vệ bàn phím hoặc trả về 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 ()
Lấy thông tin về các mô-đun đường dây chính đã cài đặt trên thiết bị.
Giá trị trả về |
|
ERROR(/Set) /String mô-đun đường dây chính hiện đã được cài đặt trên thiết bị. |
public int getMaxNumberOfRunningUsersSupported ()
Nhận số lượng tối đa người dùng chạy đồng thời được hỗ trợ. Giá trị mặc định là: 0
Giá trị trả về |
int |
một số nguyên cho biết số người dùng chạy đồng thời |
public int getMaxNumberOfUsersSupported ()
Nhận số lượng người dùng được hỗ trợ tối đa. Giá trị mặc định là: 0
Giá trị trả về |
int |
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. |
getẢnh chụp màn hình
public InputStreamSource getScreenshot ()
Chụp ảnh màn hình từ thiết bị.
getẢnh chụp màn hình
public InputStreamSource getScreenshot (String format,
boolean rescale)
Chụp ảnh màn hình từ thiết bị. Nên dùng getScreenshot(String)
với mã hoá JPEG cho kích thước nhỏ hơn.
Tham số |
format |
String : PNG, JPEG được hỗ trợ |
rescale |
boolean : nếu cần điều chỉnh ảnh chụp màn hình để giảm kích thước của hình ảnh thu được |
getẢnh chụp màn hình
public InputStreamSource getScreenshot (String format)
Chụp ảnh màn hình từ thiết bị.
Bạn nên sử dụng phương thức getScreenshot(format) thay vì phương thức mã hoá JPEG cho kích thước nhỏ hơn
Tham số |
format |
String : PNG, JPEG được hỗ trợ |
getẢnh chụp màn hình
public InputStreamSource getScreenshot (long displayId)
Chụp ảnh màn hình từ thiết bị có mã hiển thị được cung cấp. Định dạng là PNG.
VIỆC CẦN LÀM: mở rộng các cách triển khai ở trên để hỗ trợ "định dạng" và "rescale"
Tham số |
displayId |
long : mã hiển thị của màn hình để lấy ảnh chụp màn hình. |
getCà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.
Tham số |
namespace |
String |
key |
String |
getCài đặt
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: {"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 không gian tên:khoá của một 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. Điều này hiện được định nghĩa 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 có thể gỡ cài đặt hiện được cài đặt trên
thiết bị. |
getUserGắn cờ
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 "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 được cung cấp nếu có, -10000 trong mọi trường hợp khác. |
getUserInfo
public getUserInfos ()
Tải Map of useId cho 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 đối tượng UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Trả lại số sê-ri được liên kết với userId nếu có, -10000 trong mọi trường hợp khác.
cóTính năng
public boolean hasFeature (String feature)
Kiểm tra xem thiết bị có tính năng nào không.
Tham số |
feature |
String : định dạng phải là "feature:" hoặc "" trực tiếp. |
Giá trị trả về |
boolean |
"True" nếu tìm thấy đối tượng, nếu không thì sẽ trả về. |
lượt cài đặt
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ần cài đặt |
reinstall |
boolean : true nếu thực hiện cài đặt lại |
extraArgs |
String : đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn
. |
Giá trị trả về |
String |
String có mã lỗi hoặc null nếu thành công. |
lượt cài đặt
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ỉ các 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 gian cài đặt sẽ gọi hàm này.
Tham số |
packageFile |
File : tệp APK cần cài đặt |
reinstall |
boolean : true nếu thực hiện cài đặt lại |
grantPermissions |
boolean : nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt |
extraArgs |
String : đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn
. |
Giá trị trả về |
String |
String có mã lỗi hoặc null nếu thành công. |
lượt cài đặt
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ỉ các 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 gian cài đặt sẽ gọi hàm này.
Tham số |
packageFile |
File : tệp APK cần cài đặt |
certFile |
File : true nếu thực hiện cài đặt lại |
reinstall |
boolean : nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt |
extraArgs |
String : đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn
. |
Giá trị trả về |
String |
String có mã lỗi hoặc null nếu thành công. |
lượt cài đặt cho người dùng gói cài đặt
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ỉ các 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 gian cài đặt sẽ gọi hàm này.
Tham số |
packageFile |
File : tệp APK cần cài đặt |
reinstall |
boolean : true nếu thực hiện cài đặt lại |
grantPermissions |
boolean : nếu phải cấp tất cả các quyền khi bắt đầu chạy tại thời điểm cài đặt |
userId |
int : mã nhận dạng người dùng dạng số nguyên cần cài đặt. |
extraArgs |
String : đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn
. |
Giá trị trả về |
String |
String có mã lỗi hoặc null nếu thành công. |
lượt cài đặt cho người dùng gói cài đặt
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ần cài đặt |
reinstall |
boolean : true nếu thực hiện cài đặt lại |
userId |
int : mã nhận dạng người dùng dạng số nguyên cần cài đặt. |
extraArgs |
String : đối số bổ sung không bắt buộc phải truyền. Xem 'adb shell pm -h' dành cho có sẵn
. |
Giá trị trả về |
String |
String có mã lỗi hoặc null nếu thành công. |
lượt cài đặt
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Tham số |
packageFiles |
|
reinstall |
boolean |
extraArgs |
String |
lượt cài đặt
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Tham số |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
extraArgs |
String |
lượt cài đặtGói cho người dùng
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Tham số |
packageFiles |
|
reinstall |
boolean |
grantPermissions |
boolean |
userId |
int |
extraArgs |
String |
lượt cài đặtGói cho người dùng
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Tham số |
packageFiles |
|
reinstall |
boolean |
userId |
int |
extraArgs |
String |
cài đặtRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Tham số |
remoteApkPaths |
|
reinstall |
boolean |
extraArgs |
String |
cài đặtRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Tham 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ợ tính năng liệt kê ứng dụng hay không
Giá trị trả về |
boolean |
True nếu liệt kê ứng dụng được hỗ trợ, false nếu không hỗ trợ |
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 có giao diện người dùng hay không.
isMainUserNgười Quản trị viên Vĩnh viễn
public boolean isMainUserPermanentAdmin ()
Trả về việc 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
không phải quản trị viên.
được MultiUser hỗ trợ
public boolean isMultiUserSupported ()
Xác định xem có hỗ trợ nhiều người dùng hay không.
Giá trị trả về |
boolean |
true nếu nhiều người dùng được hỗ trợ, false nếu không hỗ trợ nhiều người dùng |
Đã cài đặt gói isPackage
public boolean isPackageInstalled (String packageName)
Truy vấn thiết bị về một tên gói cụ thể để kiểm tra xem thiết bị đã được cài đặt hay chưa.
Tham số |
packageName |
String |
Giá trị trả về |
boolean |
Đúng nếu gói được báo cáo là đã cài đặt. Nếu không thì là False. |
Đã cài đặt gói isPackage
public boolean isPackageInstalled (String packageName,
String userId)
Truy vấn thiết bị để biết một tên gói cụ thể và mã nhận dạng người dùng được cung cấp để kiểm tra xem gói đó hiện
đã cài đặt hoặc chưa được cài đặt cho người dù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 hay chưa. Nếu rỗng, người dùng chính
0 sẽ được sử dụng. |
Giá trị trả về |
boolean |
Đúng nếu gói được báo cáo là đã cài đặt. Nếu không thì là False. |
đang chạy người dùng
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 |
"True" nếu người dùng đang chạy, "false" trong mọi trường hợp khác. |
isUserPhụ
public boolean isUserSecondary (int userId)
Trả về việc người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của ứng dụng đó.
Giá trị trả về |
boolean |
true nếu người dùng là phụ, false nếu người dùng không là phụ. |
Hiển thị người dùng
public boolean isUserVisible (int userId)
Kiểm tra xem người dùng cụ thể có hiển thị hay không.
"Hiển thị" người dùng là một người dùng tương tác với "người dùng" 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).
hiển thị người dùng trên màn hình
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Kiểm tra xem người dùng cụ thể có xuất hiện trên màn hình cụ thể hay không.
"Hiển thị" người dùng là một người dùng tương tác với "người dùng" và do đó có thể
khởi chạy các hoạt động trong màn hình đó.
Tham số |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
Thu thập danh sách mã 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. Mặc định luôn trả về màn hình mặc định 0. |
Người dùng list
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 id người dùng. |
báo cáo lỗi
public boolean logBugreport (String dataName,
ITestLogger listener)
Phương pháp trợ giúp để báo cáo lỗi và ghi báo cáo đó cho người 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 |
True nếu quá trình ghi nhật ký thành công, nếu không thì sẽ trả về false. |
notificationSnapuserd
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ị cụ thể sẽ được thực thi sau lệnh gọi
là xong.
Tham số |
exception |
Throwable : nếu có thì ngoại lệ cuối cùng do lỗi lệnh gọi phát sinh. |
removeAdmin
public boolean removeAdmin (String componentName,
int userId)
Xoá quản trị viên thiết bị đã cho trong người dùng cụ thể và trả về true
nếu thành công, nếu không thì trả về false
.
Tham số |
componentName |
String : quản trị viên thiết bị sẽ bị loại bỏ. |
userId |
int : người dùng thuộc quyền quản trị viên thiết bị. |
Giá trị trả về |
boolean |
"True" nếu thành công, nếu không thì sẽ trả lời sai. |
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 có thể.
xoá người dùng
public boolean removeUser (int userId)
Xoá một người dùng cụ thể khỏi thiết bị.
Tham số |
userId |
int : người dùng cần xoá |
Giá trị trả về |
boolean |
true nếu chúng tôi xoá được người dùng thành công, nếu không thì sẽ trả về false. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Đặt mộ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 cụ thể.
Tham số |
componentName |
String : của quản trị viên thiết bị sẽ là chủ sở hữu thiết bị. |
userId |
int : người dùng sở hữu thiết bị. |
Giá trị trả về |
boolean |
"True" nếu thành công, nếu không thì sẽ trả lời sai. |
cài đặt
public void setSetting (String namespace,
String key,
String value)
Xem setSetting(int, String, String, String)
và được thực hiện trên người dùng hệ thống.
Tham số |
namespace |
String |
key |
String |
value |
String |
cài đặt
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: {"system", "secure", "global"}
Tham số |
userId |
int |
namespace |
String |
key |
String |
value |
String |
ngừng hoạt độngMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Tắt thiết bị microdroid (nếu có).
Tham số |
microdroidDevice |
ITestDevice |
người dùng bắt đầu
public boolean startUser (int userId)
Bắt đầu một người dùng cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng. Nếu người dùng đã
chạy ở chế độ nền, phương thức này là NOOP.
Tham số |
userId |
int : số 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 trong nền. |
người dùng bắt đầu
public boolean startUser (int userId,
boolean waitFlag)
Bắt đầu một người dùng cụ thể ở chế độ nền nếu ứng dụng này hiện đang dừng. Nếu người dùng đã
chạy ở chế độ nền, phương thức này là NOOP. Có thể cung cấp thêm cờ để chờ
thao tác đó có hiệu lực.
Tham số |
userId |
int : số người dùng bắt đầu ở chế độ nền |
waitFlag |
boolean : sẽ thực hiệ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 trong nền. |
người dùng bắt đầu hiển thị
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Bắt đầu một người dùng cụ thể ở chế độ nền, hiển thị trên 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, màn hình có sẵn hay không, device supports such feature
, v.v.
Tham số |
userId |
int : số 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ẽ thực hiện lệnh chờ cho đến khi người dùng khởi động và mở khoá. |
Giá trị trả về |
boolean |
Là giá trị true nếu người dùng đã khởi động thành công và hiển thị trong nền. |
người dùng dừng
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 tài khoản 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 : số người dùng cần dừng. |
waitFlag |
boolean : sẽ thực hiệ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 người dùng đã được dừng thành công. |
người dùng dừng
public boolean stopUser (int userId)
Dừng một người dùng cụ thể. Nếu người dùng đã dừng hoạt động, thì 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 : số người dùng cần dừng. |
Giá trị trả về |
boolean |
true nếu người dùng đã được 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 điều kiện tiên quyết được thoả mãn, trả về false nếu không đáp ứng điều kiện tiên quyết. |
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 điều kiện tiên quyết được thoả mãn, trả về false nếu không đáp ứng điều kiện tiên quyết. |
người dùng chuyển đổi
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 nhà cung cấp userId. Nếu không thì là False. |
người dùng chuyển đổi
public boolean switchUser (int userId,
long timeout)
Hãy chuyển sang một userId khác có thời gian chờ đã 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.
Tham số |
userId |
int |
timeout |
long : để đợi trước khi trả về giá trị false cho người dùng nút chuyển không thành công. |
Giá trị trả về |
boolean |
Đúng nếu userId mới khớp với nhà cung cấp userId. Nếu không thì là False. |
báo cáo lỗi
public Bugreport takeBugreport ()
Tạo báo cáo lỗi và trả về bên trong đố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 Báo cáo lỗi thông qua Bugreport.close()
.
gỡ cài đặt gói
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. |
Gỡ cài đặt cho người dùng
public String uninstallPackageForUser (String packageName,
int userId)
Gỡ cài đặt một gói Android khỏi thiết bị của 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 là số nguyên 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. |
Chờ
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Tham số |
currentPhase |
SnapuserdWaitPhase |
Phương thức được bảo vệ
trình phân tích cú pháp
protected AaptParser createParser (File appFile)
Khởi động lại doAdb
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Khởi động lại adb.
Tham số |
rebootMode |
NativeDevice.RebootMode : một chế độ của quá trình khởi động lại này. |
reason |
String : cho lần khởi động lại này. |
getBáo cáo lỗi nội bộ
protected File getBugreportzInternal ()
Phương thức của Trình trợ giúp nội bộ để lấy tệp zip bugreportz dưới dạng ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Được sử dụng để kiểm thử.
getMáy chủ lưu trữ Thời gian hiện tại
protected long getHostCurrentTime ()
Được hiển thị để thử nghiệm
Thiết lập prePostBoot
protected void prePostBootSetup ()
Cho phép từng loại thiết bị (AndroidNativeDevice, TestDevice) ghi đè phương thức này cho
thiết lập khởi động bài đăng cụ thể.