TestDevice

public class TestDevice
extends NativeDevice

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


הטמעת ITestDevice עבור מכשיר אנדרואיד מלא מחסנית

סיכום

כיתות מקוננות

class TestDevice.MicrodroidBuilder

בונה המשמש ליצירת Microdroid TestDevice.

שדות

public static final String DISMISS_KEYGUARD_CMD

פקודות שניתן להשתמש בהן כדי לבטל את מגן המקשים.

בנאים ציבוריים

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

שיטות ציבוריות

boolean clearErrorDialogs ()

נסה לבטל את כל תיבת הדו-שיח של שגיאה המוצגת כעת בממשק המשתמש של המכשיר.

int createUser (String name)

צור משתמש עם שם נתון ודגלי ברירת מחדל 0.

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

צור משתמש עם שם נתון והדגלים שסופקו

int createUserNoThrow (String name)

צור משתמש עם שם נתון ודגלי ברירת מחדל 0.

void disableKeyguard ()

ניסיונות להשבית את מגן המקשים.

boolean doesFileExist (String deviceFilePath)

שיטת עוזר כדי לקבוע אם קיים קובץ במכשיר.

boolean doesFileExist (String deviceFilePath, int userId)

שיטת עוזר לקבוע אם קיים קובץ במכשיר עבור משתמש נתון.

File dumpHeap (String process, String devicePath)

נסה לזרוק את הערימה מה-system_server.

getActiveApexes ()

אחזר את המידע על APEXs שהופעלו במכשיר.

getAllSettings (String namespace)

החזר צמדי ערכי מפתח של מרחב השמות המבוקש.

String getAndroidId (int userId)

מצא והחזר את ה-Android-ID המשויך ל-userId, null אם לא נמצא.

getAndroidIds ()

צור מפה של מזהי אנדרואיד שנמצאו מזהי משתמש תואמים.

PackageInfo getAppPackageInfo (String packageName)

אחזר מידע על חבילה המותקנת במכשיר.

getAppPackageInfos ()

אחזר מידע של חבילות המותקנות במכשיר.

DeviceFoldableState getCurrentFoldableState ()

מחזיר את המצב המתקפל הנוכחי של המכשיר או null אם התרחשו בעיות מסוימות.

int getCurrentUser ()

החזר את המזהה של המשתמש הנוכחי הפועל.

getFoldableStates ()

מחזירה את רשימת המצבים הניתנים לקיפול במכשיר.

getInstalledPackageNames ()

אחזר את שמות חבילות היישומים הקיימים במכשיר.

KeyguardControllerState getKeyguardState ()

החזר אובייקט כדי לקבל את המצב הנוכחי של מגן המקשים או null אם לא נתמך.

getMainlineModuleInfo ()

קבל את המידע על המודולים המרכזיים המותקנים במכשיר.

int getMaxNumberOfRunningUsersSupported ()

קבל את המספר המרבי של משתמשים שפועלים בו זמנית.

int getMaxNumberOfUsersSupported ()

קבל את המספר המרבי של משתמשים נתמכים.

String getMicrodroidCID ()
Integer getPrimaryUserId ()

מחזירה את מזהה המשתמש הראשי.

InputStreamSource getScreenshot ()

תופס צילום מסך מהמכשיר.

InputStreamSource getScreenshot (String format, boolean rescale)

תופס צילום מסך מהמכשיר.

InputStreamSource getScreenshot (String format)

תופס צילום מסך מהמכשיר.

InputStreamSource getScreenshot (long displayId)

תופס צילום מסך מהמכשיר שקיבל מזהה תצוגה.

String getSetting (String namespace, String key)

ראה getSetting(int, String, String) ובוצע על משתמש המערכת.

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

החזר את הערך של ההגדרה המבוקשת.

getUninstallablePackageNames ()

אחזר את שמות חבילות האפליקציות שניתן להסיר.

int getUserFlags (int userId)

מצא והחזר את הדגלים של משתמש נתון.

getUserInfos ()

מקבל את מפת useId ל- UserInfo במכשיר.

int getUserSerialNumber (int userId)

החזר את המספר הסידורי המשויך ל-userId אם נמצא, -10000 בכל מקרה אחר.

boolean hasFeature (String feature)

בדוק אם תכונה זמינה במכשיר.

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

התקן חבילת אנדרואיד במכשיר.

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

התקן חבילת אנדרואיד במכשיר.

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

התקן חבילת אנדרואיד במכשיר.

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

התקן חבילת אנדרואיד במכשיר עבור משתמש נתון.

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

התקן חבילת אנדרואיד במכשיר עבור משתמש נתון.

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, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

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

boolean isAppEnumerationSupported ()

בדוק אם הפלטפורמה במכשיר תומכת בספירת אפליקציות

boolean isMultiUserSupported ()

קובע אם ריבוי משתמשים נתמך.

boolean isPackageInstalled (String packageName)

שאל את המכשיר עבור שם חבילה נתון כדי לבדוק אם הוא מותקן כעת או לא.

boolean isPackageInstalled (String packageName, String userId)

שאל את המכשיר עבור שם חבילה נתון ומזהה משתמש נתון כדי לבדוק אם הוא מותקן כעת או לא עבור אותו משתמש.

boolean isUserRunning (int userId)

בדוק אם משתמש נתון פועל.

boolean isUserSecondary (int userId)

החזר אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.

listDisplayIds ()

אסוף את הרשימה של מזהה תצוגות זמין במכשיר כפי שדווח על ידי "dumpsys SurfaceFlinger".

listUsers ()

מקבל את רשימת המשתמשים במכשיר.

void postInvocationTearDown (Throwable exception)

שלבים נוספים עבור ניקוי נדרש ספציפי למכשיר שיבוצעו לאחר ביצוע ההזמנה.

boolean removeAdmin (String componentName, int userId)

הסר מנהל מכשיר נתון במשתמש נתון והחזר true אם זה מצליח, false אחרת.

void removeOwners ()

הסר את כל בעלי פרופיל המכשירים הקיימים במאמץ הטוב ביותר.

boolean removeUser (int userId)

הסר משתמש נתון מהמכשיר.

boolean setDeviceOwner (String componentName, int userId)

הגדר רכיב ניהול מכשיר כבעל מכשיר במשתמש נתון.

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

ראה setSetting(int, String, String, String) ובוצע על משתמש המערכת.

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

הוסף ערך הגדרה למרחב השמות של משתמש נתון.

void shutdownMicrodroid ( ITestDevice microdroidDevice)

מכבה את מכשיר ה-microdroid, אם קיים.

boolean startUser (int userId)

מפעיל משתמש נתון ברקע אם הוא נעצר כעת.

boolean startUser (int userId, boolean waitFlag)

מפעיל משתמש נתון ברקע אם הוא נעצר כעת.

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

עצור משתמש נתון.

boolean stopUser (int userId)

עוצר משתמש נתון.

boolean supportsMicrodroid ()

בודק את התנאים המוקדמים להפעלת microdroid.

boolean supportsMicrodroid (boolean protectedVm)

בודק את התנאים המוקדמים להפעלת microdroid.

boolean switchUser (int userId)

עבור ל-userId אחר עם פסק זמן ברירת מחדל.

boolean switchUser (int userId, long timeout)

עבור ל-userId אחר עם הזמן הקצוב שסופק כתאריך יעד.

String uninstallPackage (String packageName)

הסר התקנה של חבילת אנדרואיד מהמכשיר.

String uninstallPackageForUser (String packageName, int userId)

הסר התקנה של חבילת אנדרואיד מהמכשיר עבור משתמש נתון.

שיטות מוגנות

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

בצע אתחול של adb.

long getCheckNewUserSleep ()

נחשף לבדיקה.

long getHostCurrentTime ()

נחשף לבדיקה

void prePostBootSetup ()

מאפשר לכל סוג מכשיר (AndroidNativeDevice, TestDevice) לעקוף שיטה זו עבור הגדרה ספציפית לאחר האתחול.

שדות

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

פקודות שניתן להשתמש בהן כדי לבטל את מגן המקשים.

בנאים ציבוריים

TestDevice

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

שיטות ציבוריות

clearErrorDialogs

public boolean clearErrorDialogs ()

נסה לבטל את כל תיבת הדו-שיח של שגיאה המוצגת כעת בממשק המשתמש של המכשיר.

החזרות
boolean true אם לא היו תיבות דו-שיח או אם תיבות דו-שיח נוקו בהצלחה. false אחרת.

זורק
DeviceNotAvailableException

צור משתמש

public int createUser (String name)

צור משתמש עם שם נתון ודגלי ברירת מחדל 0.

פרמטרים
name String : של המשתמש ליצור במכשיר

החזרות
int המספר השלם עבור מזהה המשתמש שנוצר

זורק
DeviceNotAvailableException

צור משתמש

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

צור משתמש עם שם נתון והדגלים שסופקו

פרמטרים
name String : של המשתמש ליצור במכשיר

guest boolean : אפשר את דגל המשתמש --guest במהלך היצירה

ephemeral boolean : אפשר את דגל המשתמש - ארעית במהלך היצירה

החזרות
int מזהה המשתמש שנוצר

זורק
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

צור משתמש עם שם נתון ודגלי ברירת מחדל 0.

פרמטרים
name String : של המשתמש ליצור במכשיר

החזרות
int המספר השלם עבור מזהה המשתמש שנוצר או -1 עבור שגיאה.

זורק
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

ניסיונות להשבית את מגן המקשים.

ראשית יש להמתין לשליחת הקלט כדי להיות מוכנה, זה קורה בערך באותו זמן כאשר המכשיר מדווח על BOOT_COMPLETE, ככל הנראה באופן אסינכרוני, מכיוון שליישום המסגרת הנוכחי יש מצב מרוץ מדי פעם. לאחר מכן נשלחת הפקודה כדי לבטל את שמירת המקשים (עובד על אלה שאינם מאובטחים בלבד)

זורק
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

שיטת עוזר כדי לקבוע אם קיים קובץ במכשיר.

פרמטרים
deviceFilePath String : הנתיב המוחלט של הקובץ במכשיר שיש לבדוק

החזרות
boolean true אם הקובץ קיים, false אחרת.

זורק
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

שיטת עוזר לקבוע אם קיים קובץ במכשיר עבור משתמש נתון.

פרמטרים
deviceFilePath String : הנתיב המוחלט של הקובץ במכשיר שיש לבדוק

userId int : מזהה המשתמש שכנגדו יש לבדוק את קיום הקובץ

החזרות
boolean true אם הקובץ קיים, false אחרת.

זורק
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

נסה לזרוק את הערימה מה-system_server. באחריות המתקשר לנקות את הקובץ שנזרק.

פרמטרים
process String : שם תהליך ההתקן שעליו dumpheap.

devicePath String : הנתיב במכשיר שבו לשים את המזבלה. זה חייב להיות מיקום שבו ההרשאות מאפשרות זאת.

החזרות
File ה- ERROR(/File) המכילה את הדוח. ריק אם משהו נכשל.

זורק
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

אחזר את המידע על APEXs שהופעלו במכשיר.

החזרות
ERROR(/Set) של ApexInfo מופעל כעת במכשיר

זורק
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

החזר צמדי ערכי מפתח של מרחב השמות המבוקש.

פרמטרים
namespace String : חייבת להיות אחת מ-{"system", "secure", "global"}

החזרות
המפה של צמדי ערכי מפתח. Null אם מרחב השמות אינו נתמך.

זורק
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

מצא והחזר את ה-Android-ID המשויך ל-userId, null אם לא נמצא.

פרמטרים
userId int

החזרות
String

זורק
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

צור מפה של מזהי אנדרואיד שנמצאו מזהי משתמש תואמים. אין ביטוח שכל מזהה משתמש ימצא מזהה אנדרואיד המשויך לפונקציה הזו, כך שחלק מזהי המשתמש עשויים להתאים ל-null.

החזרות
מפה של מזהי אנדרואיד שנמצאו תואמים מזהי משתמש.

זורק
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

אחזר מידע על חבילה המותקנת במכשיר.

פרמטרים
packageName String

החזרות
PackageInfo PackageInfo או null אם לא ניתן היה לאחזר מידע

זורק
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

אחזר מידע של חבילות המותקנות במכשיר.

החזרות
ERROR(/List) של PackageInfo המותקנים במכשיר.

זורק
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

מחזיר את המצב המתקפל הנוכחי של המכשיר או null אם התרחשו בעיות מסוימות.

החזרות
DeviceFoldableState

זורק
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

החזר את המזהה של המשתמש הנוכחי הפועל. במקרה של שגיאה, החזר -10000.

החזרות
int

זורק
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

מחזירה את רשימת המצבים הניתנים לקיפול במכשיר. ניתן להשיג עם "cmd device_state print-states".

החזרות

זורק
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

אחזר את שמות חבילות היישומים הקיימים במכשיר.

החזרות
ERROR(/Set) של שמות חבילות String המותקנות כעת במכשיר.

זורק
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

החזר אובייקט כדי לקבל את המצב הנוכחי של מגן המקשים או null אם לא נתמך.

החזרות
KeyguardControllerState KeyguardControllerState המכיל תמונת מצב של המקלדת ומחזירה Null אם שאילתת Keyguard אינה נתמכת.

זורק
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

קבל את המידע על המודולים המרכזיים המותקנים במכשיר.

החזרות
ERROR(/Set) של מודולי String mainline המותקנים כעת במכשיר.

זורק
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

קבל את המספר המרבי של משתמשים שפועלים בו זמנית. ברירת המחדל היא 0.

החזרות
int מספר שלם המציין את מספר המשתמשים הפועלים בו זמנית

זורק
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

קבל את המספר המרבי של משתמשים נתמכים. ברירת המחדל היא 0.

החזרות
int מספר שלם המציין את מספר המשתמשים הנתמכים

זורק
DeviceNotAvailableException

getMicrodroidCID

public String getMicrodroidCID ()

החזרות
String מחזיר את ה-CID של ה-microdroid vm. אם TestDevice אינו microdroid, החזר null.

getPrimaryUserId

public Integer getPrimaryUserId ()

מחזירה את מזהה המשתמש הראשי.

החזרות
Integer userId של המשתמש הראשי אם קיים אחד, ו-null אם אין משתמש ראשי.

זורק
DeviceNotAvailableException

get Screenshot

public InputStreamSource getScreenshot ()

תופס צילום מסך מהמכשיר.

החזרות
InputStreamSource a InputStreamSource של צילום המסך בפורמט png, או null אם צילום המסך לא הצליח.

זורק
DeviceNotAvailableException

get Screenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

תופס צילום מסך מהמכשיר. מומלץ להשתמש ב- getScreenshot(String) במקום עם קידוד JPEG לגודל קטן יותר.

פרמטרים
format String : נתמך PNG, JPEG

rescale boolean : אם יש לשנות את קנה המידה של צילום המסך כדי להקטין את גודל התמונה המתקבלת

החזרות
InputStreamSource a InputStreamSource של צילום המסך בפורמט, או null אם צילום המסך לא הצליח.

זורק
DeviceNotAvailableException

get Screenshot

public InputStreamSource getScreenshot (String format)

תופס צילום מסך מהמכשיר. מומלץ להשתמש ב-getScreenshot(פורמט) במקום עם קידוד JPEG לגודל קטן יותר

פרמטרים
format String : נתמך PNG, JPEG

החזרות
InputStreamSource a InputStreamSource של צילום המסך בפורמט, או null אם צילום המסך לא הצליח.

זורק
DeviceNotAvailableException

get Screenshot

public InputStreamSource getScreenshot (long displayId)

תופס צילום מסך מהמכשיר שקיבל מזהה תצוגה. הפורמט הוא PNG.

TODO: הרחב את ההטמעות לעיל כדי לתמוך ב'פורמט' ו'שינוי קנה מידה'

פרמטרים
displayId long : מזהה התצוגה של המסך שממנו ניתן לקבל צילום מסך.

החזרות
InputStreamSource a InputStreamSource של צילום המסך בפורמט, או null אם צילום המסך לא הצליח.

זורק
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

ראה getSetting(int, String, String) ובוצע על משתמש המערכת.

פרמטרים
namespace String

key String

החזרות
String

זורק
DeviceNotAvailableException

getSetting

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

החזר את הערך של ההגדרה המבוקשת. מרחב השמות חייב להיות אחד מ: {"system", "secure", "global"}

פרמטרים
userId int

namespace String

key String

החזרות
String הערך המשויך ל-namespace:key של משתמש. ריק אם לא נמצא.

זורק
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

אחזר את שמות חבילות האפליקציות שניתן להסיר. זה מוגדר כיום כחבילות שאינן מערכת, וחבילות מערכת מעודכנות.

החזרות
ERROR(/Set) של שמות חבילות String שלא ניתנות להתקנה המותקנות כעת במכשיר.

זורק
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

מצא והחזר את הדגלים של משתמש נתון. דגלים מוגדרים בכיתה "android.content.pm.UserInfo" ב-Android Open Source Project.

פרמטרים
userId int

החזרות
int הדגלים המשויכים ל-userId שסופק אם נמצאו, -10000 בכל מקרה אחר.

זורק
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

מקבל את מפת useId ל- UserInfo במכשיר. יזרוק DeviceRuntimeException אם הפלט מהמכשיר אינו כצפוי.

החזרות
רשימת אובייקטי UserInfo.

זורק
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

החזר את המספר הסידורי המשויך ל-userId אם נמצא, -10000 בכל מקרה אחר.

פרמטרים
userId int

החזרות
int

זורק
DeviceNotAvailableException

יש תכונה

public boolean hasFeature (String feature)

בדוק אם תכונה זמינה במכשיר.

פרמטרים
feature String : איזה פורמט צריך להיות "תכונה: "או" " בצורה ישירה.

החזרות
boolean נכון אם תכונה נמצאה, false אחרת.

זורק
DeviceNotAvailableException

חבילת התקנה

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

התקן חבילת אנדרואיד במכשיר.

פרמטרים
packageFile File : קובץ ה-apk להתקנה

reinstall boolean : true אם יש לבצע התקנה מחדש

extraArgs String : ארגומנטים נוספים אופציונליים להעביר. ראה 'adb shell pm -h' לאפשרויות זמינות.

החזרות
String String עם קוד שגיאה, או null אם היא מצליחה.

זורק
DeviceNotAvailableException

חבילת התקנה

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

התקן חבילת אנדרואיד במכשיר.

הערה: רק מקרי שימוש הדורשים שליטה מפורשת במתן הרשאת זמן ריצה בזמן ההתקנה צריכים לקרוא לפונקציה זו.

פרמטרים
packageFile File : קובץ ה-apk להתקנה

certFile File : true אם יש לבצע התקנה מחדש

reinstall boolean : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה

extraArgs String : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

החזרות
String String עם קוד שגיאה, או null אם היא מצליחה.

זורק
DeviceNotAvailableException

חבילת התקנה

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

התקן חבילת אנדרואיד במכשיר.

הערה: רק מקרי שימוש הדורשים שליטה מפורשת במתן הרשאת זמן ריצה בזמן ההתקנה צריכים לקרוא לפונקציה זו.

פרמטרים
packageFile File : קובץ ה-apk להתקנה

reinstall boolean : true אם יש לבצע התקנה מחדש

grantPermissions boolean : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה

extraArgs String : ארגומנטים נוספים אופציונליים להעביר. ראה 'adb shell pm -h' לאפשרויות זמינות.

החזרות
String String עם קוד שגיאה, או null אם היא מצליחה.

זורק
DeviceNotAvailableException

installPackageForUser

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

התקן חבילת אנדרואיד במכשיר עבור משתמש נתון.

הערה: רק מקרי שימוש הדורשים שליטה מפורשת במתן הרשאת זמן ריצה בזמן ההתקנה צריכים לקרוא לפונקציה זו.

פרמטרים
packageFile File : קובץ ה-apk להתקנה

reinstall boolean : true אם יש לבצע התקנה מחדש

grantPermissions boolean : אם יש להעניק את כל הרשאות זמן הריצה בזמן ההתקנה

userId int : מזהה המשתמש השלם שיש להתקין עבורו.

extraArgs String : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

החזרות
String String עם קוד שגיאה, או null אם היא מצליחה.

זורק
DeviceNotAvailableException

installPackageForUser

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

התקן חבילת אנדרואיד במכשיר עבור משתמש נתון.

פרמטרים
packageFile File : קובץ ה-apk להתקנה

reinstall boolean : true אם יש לבצע התקנה מחדש

userId int : מזהה המשתמש השלם שיש להתקין עבורו.

extraArgs String : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות.

החזרות
String String עם קוד שגיאה, או null אם היא מצליחה.

זורק
DeviceNotAvailableException

התקנת חבילות

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

פרמטרים
packageFiles

reinstall boolean

extraArgs String

החזרות
String

זורק
DeviceNotAvailableException

התקנת חבילות

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

פרמטרים
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

החזרות
String

זורק
DeviceNotAvailableException

installPackagesForUser

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

פרמטרים
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

החזרות
String

זורק
DeviceNotAvailableException

installPackagesForUser

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

פרמטרים
packageFiles

reinstall boolean

userId int

extraArgs String

החזרות
String

זורק
DeviceNotAvailableException

התקן RemotePackages

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

פרמטרים
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

החזרות
String

זורק
DeviceNotAvailableException

התקן RemotePackages

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

פרמטרים
remoteApkPaths

reinstall boolean

extraArgs String

החזרות
String

זורק
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

בדוק אם הפלטפורמה במכשיר תומכת בספירת אפליקציות

החזרות
boolean נכון אם ספירת האפליקציה נתמכת, לא נכון אחרת

זורק
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

קובע אם ריבוי משתמשים נתמך.

החזרות
boolean true אם ריבוי משתמשים נתמך, false אחרת

זורק
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

שאל את המכשיר עבור שם חבילה נתון כדי לבדוק אם הוא מותקן כעת או לא.

פרמטרים
packageName String

החזרות
boolean נכון אם החבילה מדווחת כמותקנת. שקר אחרת.

זורק
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

שאל את המכשיר עבור שם חבילה נתון ומזהה משתמש נתון כדי לבדוק אם הוא מותקן כעת או לא עבור אותו משתמש.

פרמטרים
packageName String : החבילה שאנו בודקים אם היא מותקנת.

userId String : מזהה המשתמש שאנו בודקים עבורו מותקן החבילה. אם null, המשתמש הראשי אפס ישמש.

החזרות
boolean נכון אם החבילה מדווחת כמותקנת. שקר אחרת.

זורק
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

בדוק אם משתמש נתון פועל.

פרמטרים
userId int

החזרות
boolean נכון אם המשתמש פועל, שקר בכל מקרים אחרים.

זורק
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

החזר אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.

פרמטרים
userId int

החזרות
boolean נכון אם המשתמש הוא משני, false אחרת.

זורק
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

אסוף את הרשימה של מזהה תצוגות זמין במכשיר כפי שדווח על ידי "dumpsys SurfaceFlinger".

החזרות
רשימת התצוגות. ברירת המחדל תמיד מחזירה את תצוגת ברירת המחדל 0.

זורק
DeviceNotAvailableException

רשימת משתמשים

public  listUsers ()

מקבל את רשימת המשתמשים במכשיר. יזרוק DeviceRuntimeException אם הפלט מהמכשיר אינו כצפוי.

החזרות
רשימת מזהי המשתמשים.

זורק
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

שלבים נוספים עבור ניקוי נדרש ספציפי למכשיר שיבוצעו לאחר ביצוע ההתקשרות.

פרמטרים
exception Throwable : אם קיים, החריג האחרון שהועלה עקב כישלון הפנייה.

הסר אדמין

public boolean removeAdmin (String componentName, 
                int userId)

הסר מנהל מכשיר נתון במשתמש נתון והחזר true אם זה הצליח, אחרת false .

פרמטרים
componentName String : של מנהל המכשיר להסרה.

userId int : של המשתמש שמנהל המכשיר גר בו.

החזרות
boolean נכון אם זה מצליח, לא נכון אחרת.

זורק
DeviceNotAvailableException

להסיר בעלים

public void removeOwners ()

הסר את כל בעלי פרופיל המכשירים הקיימים במאמץ הטוב ביותר.

זורק
DeviceNotAvailableException

הסר משתמש

public boolean removeUser (int userId)

הסר משתמש נתון מהמכשיר.

פרמטרים
userId int : של המשתמש להסרה

החזרות
boolean נכון אם הצלחנו להסיר את המשתמש, false אחרת.

זורק
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

הגדר רכיב ניהול מכשיר כבעל מכשיר במשתמש נתון.

פרמטרים
componentName String : של מנהל המכשיר להיות הבעלים של המכשיר.

userId int : של המשתמש שבו מתגורר בעל המכשיר.

החזרות
boolean נכון אם זה מצליח, לא נכון אחרת.

זורק
DeviceNotAvailableException

setSetting

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

ראה setSetting(int, String, String, String) ובוצע על משתמש המערכת.

פרמטרים
namespace String

key String

value String

זורק
DeviceNotAvailableException

setSetting

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

הוסף ערך הגדרה למרחב השמות של משתמש נתון. חלק מההגדרות יהיו זמינות רק לאחר אתחול מחדש. מרחב השמות חייב להיות אחד מ: {"system", "secure", "global"}

פרמטרים
userId int

namespace String

key String

value String

זורק
DeviceNotAvailableException

כיבוי מיקרודרואיד

public void shutdownMicrodroid (ITestDevice microdroidDevice)

מכבה את מכשיר ה-microdroid, אם קיים.

פרמטרים
microdroidDevice ITestDevice

זורק
DeviceNotAvailableException

startUser

public boolean startUser (int userId)

מפעיל משתמש נתון ברקע אם הוא נעצר כעת. אם המשתמש כבר פועל ברקע, שיטה זו היא NOOP.

פרמטרים
userId int : של המשתמש להתחיל ברקע

החזרות
boolean נכון אם המשתמש הופעל בהצלחה ברקע.

זורק
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

מפעיל משתמש נתון ברקע אם הוא נעצר כעת. אם המשתמש כבר פועל ברקע, שיטה זו היא NOOP. אפשר לספק דגל נוסף להמתנה לביצוע הפעולה.

פרמטרים
userId int : של המשתמש להתחיל ברקע

waitFlag boolean : יגרום לפקודה להמתין עד שהמשתמש יופעל וייפתח.

החזרות
boolean נכון אם המשתמש הופעל בהצלחה ברקע.

זורק
DeviceNotAvailableException

stopUser

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

עצור משתמש נתון. אפשר לספק דגלים נוספים כדי להמתין עד שהפעולה תיכנס לתוקף, ולאלץ לסיים את המשתמש. לא ניתן לעצור את המשתמש הנוכחי והמערכת.

פרמטרים
userId int : של המשתמש לעצור.

waitFlag boolean : יגרום לפקודה לחכות עד שהמשתמש יופסק.

forceFlag boolean : יאלץ לעצור את המשתמש.

החזרות
boolean נכון אם המשתמש הופסק בהצלחה.

זורק
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

עוצר משתמש נתון. אם המשתמש כבר נעצר, שיטה זו היא NOOP. לא ניתן לעצור את המשתמש הנוכחי והמערכת.

פרמטרים
userId int : של המשתמש לעצור.

החזרות
boolean נכון אם המשתמש הופסק בהצלחה.

זורק
DeviceNotAvailableException

תומך ב-Microdroid

public boolean supportsMicrodroid ()

בודק את התנאים המוקדמים להפעלת microdroid.

החזרות
boolean מחזירה true אם מתקיימים התנאים המוקדמים, אחרת שקר.

תומך ב-Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

בודק את התנאים המוקדמים להפעלת microdroid.

פרמטרים
protectedVm boolean : נכון אם microdroid מיועד לפעול ב-VM מוגן.

החזרות
boolean מחזירה true אם מתקיימים התנאים המוקדמים, אחרת שקר.

החלף משתמש

public boolean switchUser (int userId)

עבור ל-userId אחר עם פסק זמן ברירת מחדל. switchUser(int, long) .

פרמטרים
userId int

החזרות
boolean נכון אם ה-userId החדש תואם לספק ה-userId. שקר אחרת.

זורק
DeviceNotAvailableException

החלף משתמש

public boolean switchUser (int userId, 
                long timeout)

עבור ל-userId אחר עם הזמן הקצוב שסופק כתאריך יעד. נסה להשבית את שמירת המקשים לאחר ששינוי המשתמש הצליח.

פרמטרים
userId int

timeout long : להמתין לפני החזרת false עבור משתמש מתג נכשל.

החזרות
boolean נכון אם ה-userId החדש תואם לספק ה-userId. שקר אחרת.

זורק
DeviceNotAvailableException

הסר את חבילת ההתקנה

public String uninstallPackage (String packageName)

הסר התקנה של חבילת אנדרואיד מהמכשיר.

פרמטרים
packageName String : חבילת אנדרואיד להסרת ההתקנה

החזרות
String String עם קוד שגיאה, או null אם היא מצליחה.

זורק
DeviceNotAvailableException

הסר את ההתקנה שלPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

הסר התקנה של חבילת אנדרואיד מהמכשיר עבור משתמש נתון.

פרמטרים
packageName String : חבילת אנדרואיד להסרת ההתקנה

userId int : מזהה המשתמש השלם שיש להסיר עבורו.

החזרות
String String עם קוד שגיאה, או null אם היא מצליחה.

זורק
DeviceNotAvailableException

שיטות מוגנות

createParser

protected AaptParser createParser (File appFile)

פרמטרים
appFile File

החזרות
AaptParser

doAdbReboot

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

בצע אתחול של adb.

פרמטרים
rebootMode NativeDevice.RebootMode : מצב של אתחול מחדש זה.

reason String : לאתחול מחדש זה.

זורק
DeviceNotAvailableException

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

נחשף לבדיקה.

החזרות
long

getHostCurrentTime

protected long getHostCurrentTime ()

נחשף לבדיקה

החזרות
long

prePostBootSetup

protected void prePostBootSetup ()

מאפשר לכל סוג מכשיר (AndroidNativeDevice, TestDevice) לעקוף שיטה זו עבור הגדרה ספציפית לאחר האתחול.

זורק
DeviceNotAvailableException