Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Thiết bị kiểm tra

public class TestDevice
extends NativeDevice

java.lang.Object
↳ com.android.tradefed.device.NativeDevice
↳ com.android.tradefed.device.TestDevice

Triển khai ITestDevice cho thiết bị Android đầy đủ

Bản tóm tắt

các lớp lồng nhau

class TestDevice.MicrodroidBuilder

Trình tạo được sử dụng để tạo Thiết bị kiểm tra Microdroid.

Lĩnh vực

public static final String DISMISS_KEYGUARD_CMD

Các lệnh có thể được sử dụng để loại bỏ keyguard.

nhà thầu công cộng

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Phương thức công khai

boolean canSwitchToHeadlessSystemUser ()

Trả về liệu nó có được phép chuyển sang người dùng HỆ THỐNG không đầu hay không.

boolean clearErrorDialogs ()

Cố gắng loại bỏ mọi hộp thoại báo lỗi hiện đang hiển thị trên giao diện người dùng của thiết bị.

int createUser (String name)

Tạo người dùng có tên đã cho và cờ mặc định 0.

int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)

Tạo người dùng có tên đã cho và các cờ được cung cấp

int createUser (String name, boolean guest, boolean ephemeral)

Tạo người dùng có tên đã cho và các cờ được cung cấp

int createUserNoThrow (String name)

Tạo người dùng có tên đã cho và cờ mặc định 0.

void disableKeyguard ()

Cố gắng vô hiệu hóa keyguard.

boolean doesFileExist (String deviceFilePath)

Phương pháp trợ giúp để xác định xem tệp trên thiết bị có tồn tại hay không.

boolean doesFileExist (String deviceFilePath, int userId)

Phương thức trợ giúp để xác định xem tệp trên thiết bị có tồn tại cho một người dùng cụ thể hay không.

File dumpHeap (String process, String devicePath)

Cố gắng kết xuất đống từ system_server.

getActiveApexes ()

Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị.

getAllSettings (String namespace)

Trả về các cặp giá trị khóa của không gian tên được yêu cầu.

String getAndroidId (int userId)

Tìm và trả lại android-id được liên kết với userId, null nếu không tìm thấy.

getAndroidIds ()

Tạo Bản đồ id android được tìm thấy phù hợp với id người dùng.

PackageInfo getAppPackageInfo (String packageName)

Tìm nạp thông tin về một gói được cài đặt trên thiết bị.

getAppPackageInfos ()

Tìm nạp thông tin của các gói được cài đặt trên thiết bị.

InputStreamSource getBugreport ()

Truy xuất báo cáo lỗi từ thiết bị.

InputStreamSource getBugreportz ()

Lấy báo cáo lỗi từ thiết bị.

DeviceFoldableState getCurrentFoldableState ()

Trả về trạng thái có thể gập lại hiện tại của thiết bị hoặc trả về giá trị rỗng nếu xảy ra sự cố.

int getCurrentUser ()

Trả về id của người dùng đang chạy hiện tại.

getFoldableStates ()

Trả về danh sách các trạng thái có thể gập lại trên thiết bị.

getInstalledPackageNames ()

Tìm nạp tên gói ứng dụng có trên thiết bị.

KeyguardControllerState getKeyguardState ()

Trả về một đối tượng để lấy trạng thái hiện tại của keyguard hoặc null nếu không được hỗ trợ.

Integer getMainUserId ()

Trả về id người dùng chính.

getMainlineModuleInfo ()

Nhận thông tin về các mô-đun chính được cài đặt trên thiết bị.

int getMaxNumberOfRunningUsersSupported ()

Nhận số lượng người dùng chạy đồng thời được hỗ trợ tối đa.

int getMaxNumberOfUsersSupported ()

Nhận số lượng người dùng được hỗ trợ tối đa.

Integer getPrimaryUserId ()

Trả về id người dùng chính.

InputStreamSource getScreenshot ()

Chụp ảnh màn hình từ thiết bị.

InputStreamSource getScreenshot (String format, boolean rescale)

Chụp ảnh màn hình từ thiết bị.

InputStreamSource getScreenshot (String format)

Chụp ảnh màn hình từ thiết bị.

InputStreamSource getScreenshot (long displayId)

Lấy ảnh chụp màn hình từ id hiển thị đã cho của thiết bị.

String getSetting (String namespace, String key)

Xem getSetting(int, String, String) và thực hiện trên người dùng hệ thống.

String getSetting (int userId, String namespace, String key)

Trả về giá trị của cài đặt được yêu cầu.

getUninstallablePackageNames ()

Tìm nạp tên gói ứng dụng có thể gỡ cài đặt.

int getUserFlags (int userId)

Tìm và trả lại các cờ của một người dùng nhất định.

getUserInfos ()

Tải Bản đồ của useId tới UserInfo trên thiết bị.

int getUserSerialNumber (int userId)

Trả lại số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong mọi trường hợp khác.

boolean hasFeature (String feature)

Kiểm tra xem một tính năng có sẵn trên thiết bị hay không.

String installPackage (File packageFile, boolean reinstall, String... extraArgs)

Cài đặt gói Android trên thiết bị.

String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Cài đặt gói Android trên thiết bị.

String installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs)

Cài đặt gói Android trên thiết bị.

String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng nhất định.

String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng nhất định.

String installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs)

String installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

String installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)

String installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

String installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

boolean isAppEnumerationSupported ()

Kiểm tra xem nền tảng trên thiết bị có hỗ trợ liệt kê ứng dụng hay không

boolean isHeadlessSystemUserMode ()

Trả về việc thiết bị có sử dụng chế độ người dùng hệ thống không đầu hay không.

boolean isMainUserPermanentAdmin ()

Trả về liệu người dùng chính có phải là quản trị viên vĩnh viễn hay không và không thể bị xóa hoặc hạ cấp xuống trạng thái không phải quản trị viên.

boolean isMultiUserSupported ()

Xác định xem nhiều người dùng có được hỗ trợ hay không.

boolean isPackageInstalled (String packageName)

Truy vấn thiết bị cho một tên gói nhất định để kiểm tra xem nó hiện đã được cài đặt hay chưa.

boolean isPackageInstalled (String packageName, String userId)

Truy vấn thiết bị để biết tên gói nhất định và id người dùng đã cho để kiểm tra xem thiết bị hiện đã được cài đặt hay chưa cho người dùng đó.

boolean isUserRunning (int userId)

Kiểm tra xem một người dùng nhất định có đang chạy không.

boolean isUserSecondary (int userId)

Trả về xem người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của người dùng đó.

boolean isUserVisible (int userId)

Kiểm tra xem người dùng đã cho có hiển thị không.

boolean isUserVisibleOnDisplay (int userId, int displayId)

Kiểm tra xem người dùng đã cho có hiển thị trong màn hình đã cho hay không.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Trả về liệu thiết bị có cho phép bắt đầu hiển thị người dùng trong nền hay không trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

boolean isVisibleBackgroundUsersSupported ()

Trả về liệu thiết bị có cho phép bắt đầu hiển thị người dùng trong nền hay không.

listDisplayIds ()

Thu thập danh sách id hiển thị có sẵn trên thiết bị như được báo cáo bởi "dumpsys SurfaceFlinger".

listDisplayIdsForStartingVisibleBackgroundUsers ()

Nhận danh sách các màn hình có thể được sử dụng để start a user visible in the background .

listUsers ()

Lấy danh sách người dùng trên thiết bị.

boolean logBugreport (String dataName, ITestLogger listener)

Phương thức trợ giúp để lấy báo cáo lỗi và ghi lại cho người báo cáo.

void postInvocationTearDown (Throwable exception)

Các bước bổ sung để dọn dẹp theo yêu cầu cụ thể của thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất.

boolean removeAdmin (String componentName, int userId)

Xóa quản trị viên thiết bị đã cho trong người dùng đã cho và trả về true nếu thành công, nếu không thì trả về false .

void removeOwners ()

Xóa tất cả chủ sở hữu cấu hình thiết bị hiện có bằng nỗ lực cao nhất.

boolean removeUser (int userId)

Xóa một người dùng nhất định khỏi thiết bị.

boolean setDeviceOwner (String componentName, int userId)

Đặt thành phần quản trị viên thiết bị làm chủ sở hữu thiết bị trong người dùng nhất định.

void setSetting (String namespace, String key, String value)

Xem setSetting(int, String, String, String) và được thực hiện trên người dùng hệ thống.

void setSetting (int userId, String namespace, String key, String value)

Thêm một giá trị cài đặt vào không gian tên của một người dùng nhất định.

void shutdownMicrodroid ( ITestDevice microdroidDevice)

Tắt thiết bị microdroid, nếu có.

boolean startUser (int userId)

Bắt đầu một người dùng cụ thể trong nền nếu nó hiện đang bị dừng.

boolean startUser (int userId, boolean waitFlag)

Bắt đầu một người dùng cụ thể trong nền nếu nó hiện đang bị dừng.

boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)

Bắt đầu một người dùng nhất định trong nền, hiển thị trong màn hình nhất định (nghĩa là cho phép người dùng khởi chạy các hoạt động trong màn hình đó).

boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)

Dừng một người dùng nhất định.

boolean stopUser (int userId)

Dừng một người dùng nhất định.

boolean supportsMicrodroid ()

Kiểm tra các điều kiện tiên quyết để chạy một microdroid.

boolean supportsMicrodroid (boolean protectedVm)

Kiểm tra các điều kiện tiên quyết để chạy một microdroid.

boolean switchUser (int userId)

Chuyển sang userId khác với thời gian chờ mặc định.

boolean switchUser (int userId, long timeout)

Chuyển sang userId khác với thời gian chờ được cung cấp là hạn chót.

Bugreport takeBugreport ()

Lấy một báo cáo lỗi và gửi nó vào bên trong một đối tượng Bugreport để xử lý nó.

String uninstallPackage (String packageName)

Gỡ cài đặt gói Android khỏi thiết bị.

String uninstallPackageForUser (String packageName, int userId)

Gỡ cài đặt gói Android khỏi thiết bị cho một người dùng nhất định.

phương pháp được bảo vệ

AaptParser createParser (File appFile)
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

Thực hiện khởi động lại adb.

InputStreamSource getBugreportInternal ()
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) .

long getCheckNewUserSleep ()

Tiếp xúc để thử nghiệm.

long getHostCurrentTime ()

Tiếp xúc để thử nghiệm

void prePostBootSetup ()

Cho phép từng loại thiết bị (AndroidNativeDevice, TestDevice) ghi đè phương pháp này để thiết lập bài đăng cụ thể.

Lĩnh vực

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Các lệnh có thể được sử dụng để loại bỏ keyguard.

nhà thầu công cộng

Thiết bị kiểm tra

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Phương thức công khai

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Trả về liệu nó có được phép chuyển sang người dùng HỆ THỐNG không đầu hay không.

trả lại
boolean

ném
DeviceNotAvailableException

ClearErrorDialogs

public boolean clearErrorDialogs ()

Cố gắng loại bỏ mọi hộp thoại báo lỗi hiện đang hiển thị trên giao diện người dùng của thiết bị.

trả lại
boolean true nếu không có hộp thoại nào hoặc hộp thoại đã được xóa thành công. false khác.

ném
DeviceNotAvailableException

tạo người dùng

public int createUser (String name)

Tạo người dùng có tên đã cho và cờ mặc định 0.

Thông số
name String : của người dùng tạo trên thiết bị

trả lại
int số nguyên cho id người dùng đã tạo

ném
DeviceNotAvailableException

tạo người dùng

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Tạo người dùng có tên đã cho và các cờ được cung cấp

Thông số
name String : của người dùng tạo trên thiết bị

guest boolean : bật cờ người dùng --guest trong quá trình tạo

ephemeral boolean : bật cờ người dùng --ephemeral trong quá trình tạo

forTesting boolean : bật cờ kiểm tra --for-testing trong quá trình tạo

trả lại
int id của người dùng đã tạo

ném
DeviceNotAvailableException

tạo người dùng

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Tạo người dùng có tên đã cho và các cờ được cung cấp

Thông số
name String : của người dùng tạo trên thiết bị

guest boolean : bật cờ người dùng --guest trong quá trình tạo

ephemeral boolean : bật cờ người dùng --ephemeral trong quá trình tạo

trả lại
int id của người dùng đã tạo

ném
DeviceNotAvailableException

tạoUserNoThrow

public int createUserNoThrow (String name)

Tạo người dùng có tên đã cho và cờ mặc định 0.

Thông số
name String : của người dùng tạo trên thiết bị

trả lại
int số nguyên cho id người dùng đã tạo hoặc -1 nếu có lỗi.

ném
DeviceNotAvailableException

vô hiệu hóaKeyguard

public void disableKeyguard ()

Cố gắng vô hiệu hóa keyguard.

Trước tiên, hãy đợi công văn đầu vào sẵn sàng, điều này xảy ra cùng thời điểm khi thiết bị báo cáo BOOT_COMPLETE, rõ ràng là không đồng bộ, vì việc triển khai khung hiện tại thỉnh thoảng có tình trạng tương tranh. Sau đó, lệnh được gửi để loại bỏ keyguard (chỉ hoạt động trên những cái không an toàn)

ném
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Phương pháp trợ giúp để xác định xem tệp trên thiết bị có tồn tại hay không.

Thông số
deviceFilePath String : đường dẫn tuyệt đối của tệp trên thiết bị để kiểm tra

trả lại
boolean true nếu tệp tồn tại, false nếu không.

ném
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Phương thức trợ giúp để xác định xem tệp trên thiết bị có tồn tại cho một người dùng cụ thể hay không.

Thông số
deviceFilePath String : đường dẫn tuyệt đối của tệp trên thiết bị để kiểm tra

userId int : ID người dùng để kiểm tra sự tồn tại của tệp

trả lại
boolean true nếu tệp tồn tại, false nếu không.

ném
DeviceNotAvailableException

đổ đống

public File dumpHeap (String process, 
                String devicePath)

Cố gắng kết xuất đống từ system_server. Người gọi có trách nhiệm dọn sạch tệp bị đổ.

Thông số
process String : tên của quá trình thiết bị để dumpheap trên.

devicePath String : đường dẫn trên thiết bị nơi đặt kết xuất. Đây phải là một vị trí mà quyền cho phép nó.

trả lại
File ERROR(/File) chứa báo cáo. Null nếu một cái gì đó thất bại.

ném
DeviceNotAvailableException

getActiveApex

public  getActiveApexes ()

Tìm nạp thông tin về các APEX được kích hoạt trên thiết bị.

trả lại
ERROR(/Set) của ApexInfo hiện được kích hoạt trên thiết bị

ném
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

Trả về các cặp giá trị khóa của không gian tên được yêu cầu.

Thông số
namespace String : phải là một trong {"system", "secure", "global"}

trả lại
bản đồ của các cặp giá trị chính. Null nếu không gian tên không được hỗ trợ.

ném
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

Tìm và trả lại android-id được liên kết với userId, null nếu không tìm thấy.

Thông số
userId int

trả lại
String

ném
DeviceNotAvailableException

getAndroidId

public  getAndroidIds ()

Tạo Bản đồ id android được tìm thấy phù hợp với id người dùng. Không có gì đảm bảo rằng mỗi id người dùng sẽ tìm thấy một id android được liên kết trong chức năng này, vì vậy một số id người dùng có thể khớp với giá trị rỗng.

trả lại
Đã tìm thấy bản đồ id android phù hợp với id người dùng.

ném
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Tìm nạp thông tin về một gói được cài đặt trên thiết bị.

Thông số
packageName String

trả lại
PackageInfo PackageInfo hoặc null nếu không thể truy xuất thông tin

ném
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Tìm nạp thông tin của các gói được cài đặt trên thiết bị.

trả lại
ERROR(/List) của PackageInfo s được cài đặt trên thiết bị.

ném
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Truy xuất báo cáo lỗi từ thiết bị.

Việc triển khai điều này được đảm bảo để tiếp tục hoạt động trên thiết bị không có thẻ sdcard (hoặc nơi thẻ sdcard chưa được gắn).

trả lại
InputStreamSource Một InputStreamSource sẽ tạo nội dung báo cáo lỗi theo yêu cầu. Trong trường hợp không thành công, InputStreamSource sẽ tạo ra một ERROR(/InputStream) trống.

getBugreportz

public InputStreamSource getBugreportz ()

Lấy báo cáo lỗi từ thiết bị. Báo cáo lỗi định dạng zip chứa báo cáo lỗi chính và các tệp nhật ký khác hữu ích cho việc gỡ lỗi.

Chỉ được hỗ trợ cho 'adb version' > 1.0.36

trả lại
InputStreamSource một InputStreamSource của tệp zip chứa báo cáo lỗi, trả về giá trị rỗng trong trường hợp không thành công.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Trả về trạng thái có thể gập lại hiện tại của thiết bị hoặc trả về giá trị rỗng nếu xảy ra sự cố.

trả lại
DeviceFoldableState

ném
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Trả về id của người dùng đang chạy hiện tại. Trong trường hợp có lỗi, hãy trả về -10000.

trả lại
int

ném
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Trả về danh sách các trạng thái có thể gập lại trên thiết bị. Có thể thu được với "trạng thái in cmd device_state".

trả lại

ném
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

Tìm nạp tên gói ứng dụng có trên thiết bị.

trả lại
ERROR(/Set) của tên gói ERROR(/String) hiện được cài đặt trên thiết bị.

ném
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Trả về một đối tượng để lấy trạng thái hiện tại của keyguard hoặc null nếu không được hỗ trợ.

trả lại
KeyguardControllerState một KeyguardControllerState chứa ảnh chụp nhanh trạng thái của keyguard và trả về Null nếu truy vấn Keyguard không được hỗ trợ.

ném
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

Trả về id người dùng chính.

trả lại
Integer userId của người dùng chính nếu có và null nếu không có người dùng chính.

ném
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Nhận thông tin về các mô-đun chính được cài đặt trên thiết bị.

trả lại
ERROR(/Set) trong số các mô-đun dòng chính ERROR(/String) hiện được cài đặt trên thiết bị.

ném
DeviceNotAvailableException

getMaxNumberOfRunningUsersHỗ trợ

public int getMaxNumberOfRunningUsersSupported ()

Nhận số lượng người dùng chạy đồng thời được hỗ trợ tối đa. Mặc định là 0.

trả lại
int một số nguyên cho biết số lượng người dùng đang chạy đồng thời

ném
DeviceNotAvailableException

getMaxNumberOfUsersHỗ trợ

public int getMaxNumberOfUsersSupported ()

Nhận số lượng người dùng được hỗ trợ tối đa. Mặc định là 0.

trả lại
int một số nguyên cho biết số lượng người dùng được hỗ trợ

ném
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

Trả về id người dùng chính.

trả lại
Integer userId của người dùng chính nếu có và null nếu không có người dùng chính.

ném
DeviceNotAvailableException

lấy ảnh chụp màn hình

public InputStreamSource getScreenshot ()

Chụp ảnh màn hình từ thiết bị.

trả lại
InputStreamSource một InputStreamSource của ảnh chụp màn hình ở định dạng png hoặc null nếu ảnh chụp màn hình không thành công.

ném
DeviceNotAvailableException

lấy ảnh chụp màn hình

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Chụp ảnh màn hình từ thiết bị. Nên sử dụng getScreenshot(String) thay vì mã hóa JPEG để có kích thước nhỏ hơn.

Thông số
format String : hỗ trợ PNG, JPEG

rescale boolean : nếu ảnh chụp màn hình nên được thay đổi kích thước để giảm kích thước của hình ảnh kết quả

trả lại
InputStreamSource một InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu ảnh chụp màn hình không thành công.

ném
DeviceNotAvailableException

lấy ảnh chụp màn hình

public InputStreamSource getScreenshot (String format)

Chụp ảnh màn hình từ thiết bị. Nên sử dụng getScreenshot(format) thay vì mã hóa JPEG để có kích thước nhỏ hơn

Thông số
format String : hỗ trợ PNG, JPEG

trả lại
InputStreamSource một InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu ảnh chụp màn hình không thành công.

ném
DeviceNotAvailableException

lấy ảnh chụp màn hình

public InputStreamSource getScreenshot (long displayId)

Lấy ảnh chụp màn hình từ id hiển thị đã cho của thiết bị. Định dạng là PNG.

VIỆC CẦN LÀM: mở rộng các triển khai ở trên để hỗ trợ 'định dạng' và 'điều chỉnh lại tỷ lệ'

Thông số
displayId long : id hiển thị của màn hình để lấy ảnh chụp màn hình từ đó.

trả lại
InputStreamSource một InputStreamSource của ảnh chụp màn hình ở định dạng hoặc null nếu ảnh chụp màn hình không thành công.

ném
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

Xem getSetting(int, String, String) và thực hiện trên người dùng hệ thống.

Thông số
namespace String

key String

trả lại
String

ném
DeviceNotAvailableException

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

Trả về giá trị của cài đặt được yêu cầu. không gian tên phải là một trong: {"system", "secure", "global"}

Thông số
userId int

namespace String

key String

trả lại
String giá trị được liên kết với không gian tên: khóa của người dùng. Null nếu không tìm thấy.

ném
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Tìm nạp tên gói ứng dụng có thể gỡ cài đặt. Điều này hiện được định nghĩa là các gói không thuộc hệ thống và các gói hệ thống được cập nhật.

trả lại
ERROR(/Set) tên gói ERROR(/String) có thể gỡ cài đặt hiện được cài đặt trên thiết bị.

ném
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

Tìm và trả lại các cờ của một người dùng nhất định. Cờ được định nghĩa trong lớp "android.content.pm.UserInfo" trong Dự án nguồn mở Android.

Thông số
userId int

trả lại
int các cờ được liên kết với userId được cung cấp nếu tìm thấy, -10000 trong mọi trường hợp khác.

ném
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

Tải Bản đồ của useId tới UserInfo trên thiết bị. Sẽ ném DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.

trả lại
danh sách các đối tượng UserInfo.

ném
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

Trả lại số sê-ri được liên kết với userId nếu tìm thấy, -10000 trong mọi trường hợp khác.

Thông số
userId int

trả lại
int

ném
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

Kiểm tra xem một tính năng có sẵn trên thiết bị hay không.

Thông số
feature String : định dạng nào phải là "tính năng: " hoặc " " trực tiếp.

trả lại
boolean Đúng nếu tính năng được tìm thấy, sai nếu không.

ném
DeviceNotAvailableException

cài đặt gói

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị.

Thông số
packageFile File : file apk để cài đặt

reinstall boolean : true nếu cài đặt lại nên được thực hiện

extraArgs String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng.

trả lại
String một ERROR(/String) có mã lỗi hoặc null nếu thành công.

ném
DeviceNotAvailableException

cài đặt gói

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị.

Lưu ý: Chỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy khi cài đặt mới gọi chức năng này.

Thông số
packageFile File : file apk để cài đặt

reinstall boolean : true nếu cài đặt lại nên được thực hiện

grantPermissions boolean : nếu tất cả các quyền thời gian chạy sẽ được cấp khi cài đặt

extraArgs String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng.

trả lại
String một ERROR(/String) có mã lỗi hoặc null nếu thành công.

ném
DeviceNotAvailableException

cài đặt gói

public String installPackage (File packageFile, 
                File certFile, 
                boolean reinstall, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị.

Lưu ý: Chỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy khi cài đặt mới gọi chức năng này.

Thông số
packageFile File : file apk để cài đặt

certFile File : true nếu tiến hành cài đặt lại

reinstall boolean : nếu tất cả các quyền thời gian chạy sẽ được cấp khi cài đặt

extraArgs String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng.

trả lại
String một ERROR(/String) có mã lỗi hoặc null nếu thành công.

ném
DeviceNotAvailableException

cài đặtPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng nhất định.

Lưu ý: Chỉ những trường hợp sử dụng yêu cầu kiểm soát rõ ràng việc cấp quyền thời gian chạy khi cài đặt mới gọi chức năng này.

Thông số
packageFile File : file apk để cài đặt

reinstall boolean : true nếu cài đặt lại nên được thực hiện

grantPermissions boolean : nếu tất cả các quyền thời gian chạy sẽ được cấp khi cài đặt

userId int : id người dùng số nguyên để cài đặt.

extraArgs String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng.

trả lại
String một ERROR(/String) có mã lỗi hoặc null nếu thành công.

ném
DeviceNotAvailableException

cài đặtPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Cài đặt gói Android trên thiết bị cho một người dùng nhất định.

Thông số
packageFile File : file apk để cài đặt

reinstall boolean : true nếu cài đặt lại nên được thực hiện

userId int : id người dùng số nguyên để cài đặt.

extraArgs String : đối số bổ sung tùy chọn để vượt qua. Xem 'adb shell pm -h' để biết các tùy chọn khả dụng.

trả lại
String một ERROR(/String) có mã lỗi hoặc null nếu thành công.

ném
DeviceNotAvailableException

cài đặtGói

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Thông số
packageFiles

reinstall boolean

extraArgs String

trả lại
String

ném
DeviceNotAvailableException

cài đặtGói

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Thông số
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

trả lại
String

ném
DeviceNotAvailableException

cài đặt Gói cho người dùng

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Thông số
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

trả lại
String

ném
DeviceNotAvailableException

cài đặt Gói cho người dùng

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Thông số
packageFiles

reinstall boolean

userId int

extraArgs String

trả lại
String

ném
DeviceNotAvailableException

cài đặtGói từ xa

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Thông số
remoteApkPaths

reinstall boolean

extraArgs String

trả lại
String

ném
DeviceNotAvailableException

cài đặtGói từ xa

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Thông số
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

trả lại
String

ném
DeviceNotAvailableException

isAppEnumerationHỗ trợ

public boolean isAppEnumerationSupported ()

Kiểm tra xem nền tảng trên thiết bị có hỗ trợ liệt kê ứng dụng hay không

trả lại
boolean Đúng nếu liệt kê ứng dụng được hỗ trợ, sai nếu không

ném
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Trả về việc thiết bị có sử dụng chế độ người dùng hệ thống không đầu hay không.

trả lại
boolean

ném
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Trả về liệu người dùng chính có phải là quản trị viên vĩnh viễn hay không và không thể bị xóa hoặc hạ cấp xuống trạng thái không phải quản trị viên.

trả lại
boolean

ném
DeviceNotAvailableException

isMultiUserHỗ trợ

public boolean isMultiUserSupported ()

Xác định xem nhiều người dùng có được hỗ trợ hay không.

trả lại
boolean đúng nếu nhiều người dùng được hỗ trợ, sai nếu không

ném
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Truy vấn thiết bị cho một tên gói nhất định để kiểm tra xem nó hiện đã được cài đặt hay chưa.

Thông số
packageName String

trả lại
boolean Đúng nếu gói được báo cáo là đã cài đặt. Sai nếu không.

ném
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Truy vấn thiết bị để biết tên gói nhất định và id người dùng đã cho để kiểm tra xem thiết bị hiện đã được cài đặt hay chưa cho người dùng đó.

Thông số
packageName String : gói chúng tôi đang kiểm tra xem nó đã được cài đặt chưa.

userId String : Id người dùng mà chúng tôi đang kiểm tra gói đã được cài đặt. Nếu null, số 0 của người dùng chính sẽ được sử dụng.

trả lại
boolean Đúng nếu gói được báo cáo là đã cài đặt. Sai nếu không.

ném
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

Kiểm tra xem một người dùng nhất định có đang chạy không.

Thông số
userId int

trả lại
boolean Đúng nếu người dùng đang chạy, sai trong mọi trường hợp khác.

ném
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

Trả về xem người dùng được chỉ định có phải là người dùng phụ hay không theo cờ của người dùng đó.

Thông số
userId int

trả lại
boolean đúng nếu người dùng là phụ, ngược lại là sai.

ném
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

Kiểm tra xem người dùng đã cho có hiển thị không.

Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể khởi chạy các hoạt động khởi chạy (thường là trong màn hình mặc định).

Thông số
userId int

trả lại
boolean

ném
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Kiểm tra xem người dùng đã cho có hiển thị trong màn hình đã cho hay không.

Người dùng "hiển thị" là người dùng đang tương tác với người dùng "con người" và do đó có thể khởi chạy các hoạt động khởi chạy trong màn hình đó.

Thông số
userId int

displayId int

trả lại
boolean

ném
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Trả về liệu thiết bị có cho phép bắt đầu hiển thị người dùng trong nền hay không trong ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

Nếu đúng như vậy, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean) , chuyển một màn hình được trả về bởi listDisplayIdsForStartingVisibleBackgroundUsers() (bao gồm ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

trả lại
boolean

ném
DeviceNotAvailableException

isVisibleBackgroundNgười dùng được hỗ trợ

public boolean isVisibleBackgroundUsersSupported ()

Trả về liệu thiết bị có cho phép bắt đầu hiển thị người dùng trong nền hay không.

Nếu đúng như vậy, bạn có thể gọi startVisibleBackgroundUser(int, int, boolean) , chuyển một màn hình được trả về bởi listDisplayIdsForStartingVisibleBackgroundUsers() .

trả lại
boolean

ném
DeviceNotAvailableException

listDisplayId

public  listDisplayIds ()

Thu thập danh sách id hiển thị có sẵn trên thiết bị như được báo cáo bởi "dumpsys SurfaceFlinger".

trả lại
Danh sách hiển thị. Mặc định luôn trả về màn hình mặc định 0.

ném
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Nhận danh sách các màn hình có thể được sử dụng để start a user visible in the background .

trả lại

ném
DeviceNotAvailableException

danh sách người dùng

public  listUsers ()

Lấy danh sách người dùng trên thiết bị. Sẽ ném DeviceRuntimeException nếu đầu ra từ thiết bị không như mong đợi.

trả lại
danh sách id người dùng.

ném
DeviceNotAvailableException

logBáo cáo lỗi

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Phương thức trợ giúp để lấy báo cáo lỗi và ghi lại cho người báo cáo.

Thông số
dataName String : tên mà báo cáo lỗi sẽ được báo cáo.

listener ITestLogger : một ITestLogger để ghi nhật ký báo cáo lỗi.

trả lại
boolean Đúng nếu đăng nhập thành công, sai nếu không.

bài đăngLời cầu nguyệnTearDown

public void postInvocationTearDown (Throwable exception)

Các bước bổ sung để dọn dẹp theo yêu cầu cụ thể của thiết bị sẽ được thực thi sau khi lệnh gọi hoàn tất.

Thông số
exception Throwable : nếu có, ngoại lệ cuối cùng được đưa ra do lỗi gọi.

xóaQuản trị viên

public boolean removeAdmin (String componentName, 
                int userId)

Xóa quản trị viên thiết bị đã cho trong người dùng đã cho và trả về true nếu thành công, nếu không thì trả về false .

Thông số
componentName String : của quản trị viên thiết bị sẽ bị xóa.

userId int : của người dùng mà quản trị viên thiết bị sống.

trả lại
boolean Đúng nếu nó thành công, sai nếu không.

ném
DeviceNotAvailableException

loại bỏChủ sở hữu

public void removeOwners ()

Xóa tất cả chủ sở hữu cấu hình thiết bị hiện có bằng nỗ lực cao nhất.

ném
DeviceNotAvailableException

xóa người dùng

public boolean removeUser (int userId)

Xóa một người dùng nhất định khỏi thiết bị.

Thông số
userId int : của người dùng để loại bỏ

trả lại
boolean đúng nếu chúng tôi xóa thành công người dùng, ngược lại là sai.

ném
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Đặt thành phần quản trị viên thiết bị làm chủ sở hữu thiết bị trong người dùng nhất định.

Thông số
componentName String : của quản trị viên thiết bị là chủ sở hữu thiết bị.

userId int : của người dùng mà chủ sở hữu thiết bị đang sống.

trả lại
boolean Đúng nếu nó thành công, sai nếu không.

ném
DeviceNotAvailableException

thiết lậpCài đặt

public void setSetting (String namespace, 
                String key, 
                String value)

Xem setSetting(int, String, String, String) và được thực hiện trên người dùng hệ thống.

Thông số
namespace String

key String

value String

ném
DeviceNotAvailableException

thiết lậpCài đặt

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Thêm một giá trị cài đặt vào không gian tên của một người dùng nhất định. Một số cài đặt sẽ chỉ khả dụng sau khi khởi động lại. không gian tên phải là một trong: {"system", "secure", "global"}

Thông số
userId int

namespace String

key String

value String

ném
DeviceNotAvailableException

tắt máyMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Tắt thiết bị microdroid, nếu có.

Thông số
microdroidDevice ITestDevice

ném
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

người dùng bắt đầu

public boolean startUser (int userId)

Bắt đầu một người dùng cụ thể trong nền nếu nó hiện đang bị dừng. Nếu người dùng đang chạy trong nền, phương pháp này là NOOP.

Thông số
userId int : của người dùng để bắt đầu trong nền

trả lại
boolean true nếu người dùng đã khởi động thành công trong nền.

ném
DeviceNotAvailableException

người dùng bắt đầu

public boolean startUser (int userId, 
                boolean waitFlag)

Bắt đầu một người dùng cụ thể trong nền nếu nó hiện đang bị dừng. Nếu người dùng đang chạy trong nền, phương pháp này là NOOP. Có thể cung cấp thêm cờ để chờ thao tác có hiệu lực.

Thông số
userId int : của người dùng để bắt đầu trong nền

waitFlag boolean : sẽ làm cho lệnh đợi cho đến khi người dùng bắt đầu và mở khóa.

trả lại
boolean true nếu người dùng đã khởi động thành công trong nền.

ném
DeviceNotAvailableException

startVisibleBackgroundNgười dùng

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Bắt đầu một người dùng nhất định trong nền, hiển thị trong màn hình nhất định (nghĩa là cho phép người dùng khởi chạy các hoạt động trong màn hình đó).

LƯU Ý: lệnh này không kiểm tra xem người dùng có tồn tại không, màn hình có sẵn không, device supports such feature , v.v.

Thông số
userId int : của người dùng để bắt đầu trong nền

displayId int : hiển thị để bắt đầu người dùng hiển thị trên

waitFlag boolean : sẽ làm cho lệnh đợi cho đến khi người dùng bắt đầu và mở khóa.

trả lại
boolean true nếu người dùng đã bắt đầu thành công hiển thị trong nền.

ném
DeviceNotAvailableException

người dùng dừng lại

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Dừng một người dùng nhất định. Có thể cung cấp các cờ bổ sung để chờ thao tác có hiệu lực và buộc người dùng phải chấm dứt. Không thể dừng người dùng hiện tại và hệ thống.

Thông số
userId int : của người dùng để dừng lại.

waitFlag boolean : sẽ làm cho lệnh đợi cho đến khi người dùng dừng lại.

forceFlag boolean : sẽ buộc dừng người dùng.

trả lại
boolean đúng nếu người dùng đã dừng thành công.

ném
DeviceNotAvailableException

người dùng dừng lại

public boolean stopUser (int userId)

Dừng một người dùng nhất định. Nếu người dùng đã dừng, phương pháp này là NOOP. Không thể dừng người dùng hiện tại và hệ thống.

Thông số
userId int : của người dùng để dừng lại.

trả lại
boolean đúng nếu người dùng đã dừng thành công.

ném
DeviceNotAvailableException

hỗ trợMicrodroid

public boolean supportsMicrodroid ()

Kiểm tra các điều kiện tiên quyết để chạy một microdroid.

trả lại
boolean trả về true nếu các điều kiện tiên quyết được thỏa mãn, false nếu ngược lại.

hỗ trợMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Kiểm tra các điều kiện tiên quyết để chạy một microdroid.

Thông số
protectedVm boolean : true nếu microdroid dự định chạy trên VM được bảo vệ.

trả lại
boolean trả về true nếu các điều kiện tiên quyết được thỏa mãn, false nếu ngược lại.

người dùng chuyển đổi

public boolean switchUser (int userId)

Chuyển sang userId khác với thời gian chờ mặc định. switchUser(int, long) .

Thông số
userId int

trả lại
boolean Đúng nếu userId mới khớp với nhà cung cấp userId. Sai nếu không.

ném
DeviceNotAvailableException

người dùng chuyển đổi

public boolean switchUser (int userId, 
                long timeout)

Chuyển sang userId khác với thời gian chờ được cung cấp là hạn chót. Cố gắng vô hiệu hóa keyguard sau khi thay đổi người dùng thành công.

Thông số
userId int

timeout long : đợi trước khi trả về false cho switch-user không thành công.

trả lại
boolean Đúng nếu userId mới khớp với nhà cung cấp userId. Sai nếu không.

ném
DeviceNotAvailableException

nhậnBugreport

public Bugreport takeBugreport ()

Lấy một báo cáo lỗi và gửi nó vào bên trong một đối tượng Bugreport để xử lý nó. Trả về null trong trường hợp có vấn đề. Tệp được tham chiếu trong đối tượng Báo cáo lỗi cần được xóa thông qua Bugreport.close() .

trả lại
Bugreport

gỡ cài đặt Gói

public String uninstallPackage (String packageName)

Gỡ cài đặt gói Android khỏi thiết bị.

Thông số
packageName String : gói Android cần gỡ cài đặt

trả lại
String một ERROR(/String) có mã lỗi hoặc null nếu thành công.

ném
DeviceNotAvailableException

gỡ cài đặt GóiForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Gỡ cài đặt gói Android khỏi thiết bị cho một người dùng nhất định.

Thông số
packageName String : gói Android cần gỡ cài đặt

userId int : id người dùng số nguyên để gỡ cài đặt.

trả lại
String một ERROR(/String) có mã lỗi hoặc null nếu thành công.

ném
DeviceNotAvailableException

phương pháp được bảo vệ

tạoParser

protected AaptParser createParser (File appFile)

Thông số
appFile File

trả lại
AaptParser

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Thực hiện khởi động lại adb.

Thông số
rebootMode NativeDevice.RebootMode : một chế độ khởi động lại này.

reason String : cho lần khởi động lại này.

ném
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

trả lại
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

Phương thức của Trình trợ giúp nội bộ để lấy tệp zip bugreportz dưới dạng ERROR(/File) .

trả lại
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Tiếp xúc để thử nghiệm.

trả lại
long

getHostCurrentTime

protected long getHostCurrentTime ()

Tiếp xúc để thử nghiệm

trả lại
long

prePostBootSetup

protected void prePostBootSetup ()

Cho phép từng loại thiết bị (AndroidNativeDevice, TestDevice) ghi đè phương pháp này để thiết lập bài đăng cụ thể.

ném
DeviceNotAvailableException