כיתות מקוננות |
---|
class | TestDevice.MicrodroidBuilder בונה המשמש ליצירת Microdroid TestDevice. |
שדות |
---|
public static final String | DISMISS_KEYGUARD_CMD פקודות שניתן להשתמש בהן כדי לבטל את מגן המקשים. |
שיטות ציבוריות |
---|
boolean | canSwitchToHeadlessSystemUser () מחזירה אם מותר לעבור למשתמש SYSTEM ללא ראש. |
boolean | clearErrorDialogs () נסה לבטל את כל תיבת הדו-שיח של שגיאה המוצגת כעת בממשק המשתמש של המכשיר. |
int | createUser (String name) צור משתמש עם שם נתון ודגלי ברירת מחדל 0. |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) צור משתמש עם שם נתון והדגלים שסופקו |
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 () אחזר מידע של חבילות המותקנות במכשיר. |
InputStreamSource | getBugreport () מאחזר דוח באג מהמכשיר. |
InputStreamSource | getBugreportz () מאחזר דיווח באג מהמכשיר. |
DeviceFoldableState | getCurrentFoldableState () מחזיר את המצב המתקפל הנוכחי של המכשיר או null אם התרחשו בעיות מסוימות. |
int | getCurrentUser () החזר את המזהה של המשתמש הנוכחי הפועל. |
| getFoldableStates () מחזירה את רשימת המצבים הניתנים לקיפול במכשיר. |
| getInstalledPackageNames () אחזר את שמות חבילות היישומים הקיימים במכשיר. |
KeyguardControllerState | getKeyguardState () החזר אובייקט כדי לקבל את המצב הנוכחי של מגן המקשים או null אם לא נתמך. |
Integer | getMainUserId () מחזירה את מזהה המשתמש הראשי. |
| getMainlineModuleInfo () קבל את המידע על המודולים המרכזיים המותקנים במכשיר. |
int | getMaxNumberOfRunningUsersSupported () קבל את המספר המרבי של משתמשים שפועלים בו זמנית. |
int | getMaxNumberOfUsersSupported () קבל את המספר המרבי של משתמשים נתמכים. |
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, boolean reinstall, boolean grantPermissions, String... extraArgs) התקן חבילת אנדרואיד במכשיר. |
String | installPackage (File packageFile, File certFile, boolean reinstall, 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, 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 () בדוק אם הפלטפורמה במכשיר תומכת בספירת אפליקציות |
boolean | isHeadlessSystemUserMode () מחזירה אם המכשיר משתמש במצב משתמש מערכת ללא ראש. |
boolean | isMainUserPermanentAdmin () מחזירה אם המשתמש הראשי הוא מנהל קבוע ולא ניתן למחוק אותו או לשדרג לאחור למצב שאינו מנהל. |
boolean | isMultiUserSupported () קובע אם ריבוי משתמשים נתמך. |
boolean | isPackageInstalled (String packageName) שאל את המכשיר עבור שם חבילה נתון כדי לבדוק אם הוא מותקן כעת או לא. |
boolean | isPackageInstalled (String packageName, String userId) שאל את המכשיר עבור שם חבילה נתון ומזהה משתמש נתון כדי לבדוק אם הוא מותקן כעת או לא עבור אותו משתמש. |
boolean | isUserRunning (int userId) בדוק אם משתמש נתון פועל. |
boolean | isUserSecondary (int userId) החזר אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו. |
boolean | isUserVisible (int userId) בודק אם המשתמש הנתון גלוי. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) בודק אם המשתמש הנתון גלוי בתצוגה הנתונה. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () מחזירה אם המכשיר מאפשר הפעלת משתמשים גלויים ברקע ב- ERROR(/java.android.view.Display#DEFAULT_DISPLAY) . |
boolean | isVisibleBackgroundUsersSupported () מחזירה אם המכשיר מאפשר הפעלת משתמשים גלויים ברקע. |
| listDisplayIds () אסוף את הרשימה של מזהה תצוגות זמין במכשיר כפי שדווח על ידי "dumpsys SurfaceFlinger". |
| listDisplayIdsForStartingVisibleBackgroundUsers () מקבל את רשימת הצגים שניתן להשתמש בהם כדי start a user visible in the background . |
| listUsers () מקבל את רשימת המשתמשים במכשיר. |
boolean | logBugreport (String dataName, ITestLogger listener) שיטת עוזר לקחת דוח באג ולהתחבר לכתבים. |
void | notifySnapuserd ( SnapuserdWaitPhase waitPhase) |
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) מכבה את מכשיר המיקרודרויד, אם קיים. |
boolean | startUser (int userId) מפעיל משתמש נתון ברקע אם הוא מופסק כעת. |
boolean | startUser (int userId, boolean waitFlag) מפעיל משתמש נתון ברקע אם הוא מופסק כעת. |
boolean | startVisibleBackgroundUser (int userId, int displayId, 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 אחר עם הזמן הקצוב שסופק כתאריך יעד. |
Bugreport | takeBugreport () קח דוח באג ומחזיר אותו בתוך אובייקט Bugreport כדי לטפל בו. |
String | uninstallPackage (String packageName) הסר התקנה של חבילת אנדרואיד מהמכשיר. |
String | uninstallPackageForUser (String packageName, int userId) הסר התקנה של חבילת אנדרואיד מהמכשיר עבור משתמש נתון. |
void | waitForSnapuserd ( SnapuserdWaitPhase currentPhase) |
שדות
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
פקודות שניתן להשתמש בהן כדי לבטל את מגן המקשים.
בנאים ציבוריים
שיטות ציבוריות
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
מחזירה אם מותר לעבור למשתמש SYSTEM ללא ראש.
clearErrorDialogs
public boolean clearErrorDialogs ()
נסה לבטל את כל תיבת הדו-שיח של שגיאה המוצגת כעת בממשק המשתמש של המכשיר.
החזרות |
---|
boolean | true אם לא היו תיבות דו-שיח או אם תיבות דו-שיח נוקו בהצלחה. false אחרת. |
צור משתמש
public int createUser (String name)
צור משתמש עם שם נתון ודגלי ברירת מחדל 0.
פרמטרים |
---|
name | String : של המשתמש ליצור במכשיר |
החזרות |
---|
int | המספר השלם עבור מזהה המשתמש שנוצר |
צור משתמש
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
צור משתמש עם שם נתון והדגלים שסופקו
פרמטרים |
---|
name | String : של המשתמש ליצור במכשיר |
guest | boolean : אפשר את דגל המשתמש --guest במהלך היצירה |
ephemeral | boolean : אפשר את דגל המשתמש - ארעית במהלך היצירה |
forTesting | boolean : אפשר את דגל הבדיקה --לבדיקה במהלך היצירה |
החזרות |
---|
int | מזהה המשתמש שנוצר |
צור משתמש
public int createUser (String name,
boolean guest,
boolean ephemeral)
צור משתמש עם שם נתון והדגלים שסופקו
פרמטרים |
---|
name | String : של המשתמש ליצור במכשיר |
guest | boolean : אפשר את דגל המשתמש --guest במהלך היצירה |
ephemeral | boolean : אפשר את דגל המשתמש - ארעית במהלך היצירה |
החזרות |
---|
int | מזהה המשתמש שנוצר |
createUserNoThrow
public int createUserNoThrow (String name)
צור משתמש עם שם נתון ודגלי ברירת מחדל 0.
פרמטרים |
---|
name | String : של המשתמש ליצור במכשיר |
החזרות |
---|
int | המספר השלם עבור מזהה המשתמש שנוצר או -1 עבור שגיאה. |
disableKeyguard
public void disableKeyguard ()
ניסיונות להשבית את מגן המקשים.
ראשית יש להמתין לשליחת הקלט כדי להיות מוכנה, זה קורה בערך באותו זמן כאשר המכשיר מדווח על BOOT_COMPLETE, ככל הנראה באופן אסינכרוני, מכיוון שליישום המסגרת הנוכחי יש מצב מרוץ מדי פעם. לאחר מכן נשלחת הפקודה כדי לבטל את שמירת המקשים (עובד על אלה שאינם מאובטחים בלבד)
doesFileExist
public boolean doesFileExist (String deviceFilePath)
שיטת עוזר לקבוע אם קיים קובץ במכשיר.
פרמטרים |
---|
deviceFilePath | String : הנתיב המוחלט של הקובץ במכשיר שיש לבדוק |
החזרות |
---|
boolean | true אם הקובץ קיים, false אחרת. |
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
שיטת עוזר לקבוע אם קיים קובץ במכשיר עבור משתמש נתון.
פרמטרים |
---|
deviceFilePath | String : הנתיב המוחלט של הקובץ במכשיר שיש לבדוק |
userId | int : מזהה המשתמש שכנגדו יש לבדוק את קיום הקובץ |
החזרות |
---|
boolean | true אם הקובץ קיים, false אחרת. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
נסה לזרוק את הערימה מה-system_server. באחריות המתקשר לנקות את הקובץ שנזרק.
פרמטרים |
---|
process | String : שם תהליך ההתקן שעליו dumpheap. |
devicePath | String : הנתיב במכשיר שבו לשים את המזבלה. זה חייב להיות מיקום שבו ההרשאות מאפשרות זאת. |
החזרות |
---|
File | ה- ERROR(/File) המכילה את הדוח. ריק אם משהו נכשל. |
getActiveApexes
public getActiveApexes ()
אחזר את המידע על APEXs שהופעלו במכשיר.
getAllSettings
public getAllSettings (String namespace)
החזר צמדי ערכי מפתח של מרחב השמות המבוקש.
פרמטרים |
---|
namespace | String : חייבת להיות אחת מ-{"system", "secure", "global"} |
החזרות |
---|
| המפה של צמדי ערכי מפתח. Null אם מרחב השמות אינו נתמך. |
getAndroidId
public String getAndroidId (int userId)
מצא והחזר את ה-Android-ID המשויך ל-userId, null אם לא נמצא.
getAndroidIds
public getAndroidIds ()
צור מפה של מזהי אנדרואיד שנמצאו תואמים מזהי משתמש. אין ביטוח שכל מזהה משתמש ימצא מזהה אנדרואיד המשויך לפונקציה הזו, כך שחלק מזהי המשתמש עשויים להתאים ל-null.
החזרות |
---|
| מפה של מזהי אנדרואיד שנמצאו תואמים מזהי משתמש. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
אחזר מידע על חבילה המותקנת במכשיר.
פרמטרים |
---|
packageName | String |
getAppPackageInfos
public getAppPackageInfos ()
אחזר מידע של חבילות המותקנות במכשיר.
getBugreport
public InputStreamSource getBugreport ()
מאחזר דוח באג מהמכשיר.
היישום של זה מובטח להמשיך לעבוד על מכשיר ללא sdcard (או היכן שה-sdcard עדיין לא מותקן).
getBugreportz
public InputStreamSource getBugreportz ()
מאחזר דיווח באג מהמכשיר. דוח באגים בפורמט Zip מכיל את דוח הבאגים הראשי וקובצי יומן אחרים המועילים לניפוי באגים.
נתמך רק עבור 'גרסת adb' > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
מחזיר את המצב המתקפל הנוכחי של המכשיר או null אם התרחשו בעיות מסוימות.
getCurrentUser
public int getCurrentUser ()
החזר את המזהה של המשתמש הנוכחי הפועל. במקרה של שגיאה, החזר -10000.
getFoldableStates
public getFoldableStates ()
מחזירה את רשימת המצבים הניתנים לקיפול במכשיר. ניתן להשיג עם "cmd device_state print-states".
getInstalledPackageNames
public getInstalledPackageNames ()
אחזר את שמות חבילות היישומים הקיימים במכשיר.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
החזר אובייקט כדי לקבל את המצב הנוכחי של מגן המקשים או null אם לא נתמך.
getMainUserId
public Integer getMainUserId ()
מחזירה את מזהה המשתמש הראשי.
החזרות |
---|
Integer | userId של המשתמש הראשי אם קיים אחד, ו-null אם אין משתמש ראשי. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
קבל את המידע על המודולים המרכזיים המותקנים במכשיר.
public int getMaxNumberOfRunningUsersSupported ()
קבל את המספר המרבי של משתמשים שפועלים בו זמנית. ברירת המחדל היא 0.
החזרות |
---|
int | מספר שלם המציין את מספר המשתמשים הפועלים בו זמנית |
public int getMaxNumberOfUsersSupported ()
קבל את המספר המרבי של משתמשים נתמכים. ברירת המחדל היא 0.
החזרות |
---|
int | מספר שלם המציין את מספר המשתמשים הנתמכים |
getPrimaryUserId
public Integer getPrimaryUserId ()
מחזירה את מזהה המשתמש הראשי.
החזרות |
---|
Integer | userId של המשתמש הראשי אם קיים אחד, ו-null אם אין משתמש ראשי. |
get Screenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
תופס צילום מסך מהמכשיר. מומלץ להשתמש getScreenshot(String)
במקום עם קידוד JPEG לגודל קטן יותר.
פרמטרים |
---|
format | String : נתמך PNG, JPEG |
rescale | boolean : אם יש לשנות את קנה המידה של צילום המסך כדי להקטין את גודל התמונה המתקבלת |
get Screenshot
public InputStreamSource getScreenshot (String format)
תופס צילום מסך מהמכשיר. מומלץ להשתמש ב-getScreenshot(פורמט) במקום עם קידוד JPEG לגודל קטן יותר
פרמטרים |
---|
format | String : נתמך PNG, JPEG |
get Screenshot
public InputStreamSource getScreenshot (long displayId)
תופס צילום מסך מהמכשיר שקיבל מזהה תצוגה. הפורמט הוא PNG.
TODO: הרחב את ההטמעות לעיל כדי לתמוך ב'פורמט' ו'שינוי קנה מידה'
פרמטרים |
---|
displayId | long : מזהה התצוגה של המסך שממנו ניתן לקבל צילום מסך. |
getSetting
public String getSetting (String namespace,
String key)
ראה getSetting(int, String, String)
ובוצע על משתמש מערכת.
פרמטרים |
---|
namespace | String |
key | String |
getSetting
public String getSetting (int userId,
String namespace,
String key)
החזר את הערך של ההגדרה המבוקשת. מרחב השמות חייב להיות אחד מ: {"system", "secure", "global"}
פרמטרים |
---|
userId | int |
namespace | String |
key | String |
החזרות |
---|
String | הערך המשויך ל-namespace:key של משתמש. ריק אם לא נמצא. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
אחזר את שמות חבילות האפליקציות שניתן להסיר. זה מוגדר כיום כחבילות שאינן מערכת, וחבילות מערכת מעודכנות.
getUserFlags
public int getUserFlags (int userId)
מצא והחזר את הדגלים של משתמש נתון. דגלים מוגדרים בכיתה "android.content.pm.UserInfo" ב-Android Open Source Project.
החזרות |
---|
int | הדגלים המשויכים ל-userId שסופק אם נמצאו, -10000 בכל מקרה אחר. |
getUserInfos
public getUserInfos ()
מקבל את מפת useId ל- UserInfo
במכשיר. יזרוק DeviceRuntimeException
אם הפלט מהמכשיר אינו כצפוי.
החזרות |
---|
| רשימת אובייקטי UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
החזר את המספר הסידורי המשויך ל-userId אם נמצא, -10000 בכל מקרה אחר.
יש תכונה
public boolean hasFeature (String feature)
בדוק אם תכונה זמינה במכשיר.
פרמטרים |
---|
feature | String : איזה פורמט צריך להיות "תכונה: "או" " באופן ישיר. |
החזרות |
---|
boolean | נכון אם תכונה נמצאה, false אחרת. |
חבילת התקנה
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
התקן חבילת אנדרואיד במכשיר.
פרמטרים |
---|
packageFile | File : קובץ ה-apk להתקנה |
reinstall | boolean : true אם יש לבצע התקנה מחדש |
extraArgs | String : ארגומנטים נוספים אופציונליים להעברת. ראה 'adb shell pm -h' לאפשרויות זמינות. |
החזרות |
---|
String | String עם קוד שגיאה, או null אם היא מצליחה. |
חבילת התקנה
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 אם היא מצליחה. |
חבילת התקנה
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 אם היא מצליחה. |
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 אם היא מצליחה. |
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 אם היא מצליחה. |
התקנת חבילות
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
פרמטרים |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
התקנת חבילות
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
פרמטרים |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
פרמטרים |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
פרמטרים |
---|
packageFiles | |
reinstall | boolean |
userId | int |
extraArgs | String |
התקן RemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
פרמטרים |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
התקן RemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
פרמטרים |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
בדוק אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
החזרות |
---|
boolean | נכון אם ספירת האפליקציה נתמכת, לא נכון אחרת |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
מחזירה אם המכשיר משתמש במצב משתמש מערכת ללא ראש.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
מחזירה אם המשתמש הראשי הוא מנהל קבוע ולא ניתן למחוק אותו או לשדרג לאחור למצב שאינו מנהל.
isMultiUserSupported
public boolean isMultiUserSupported ()
קובע אם ריבוי משתמשים נתמך.
החזרות |
---|
boolean | true אם ריבוי משתמשים נתמך, false אחרת |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
שאל את המכשיר עבור שם חבילה נתון כדי לבדוק אם הוא מותקן כעת או לא.
פרמטרים |
---|
packageName | String |
החזרות |
---|
boolean | נכון אם החבילה מדווחת כמותקנת. שקר אחרת. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
שאל את המכשיר עבור שם חבילה נתון ומזהה משתמש נתון כדי לבדוק אם הוא מותקן כעת או לא עבור אותו משתמש.
פרמטרים |
---|
packageName | String : החבילה שאנו בודקים אם היא מותקנת. |
userId | String : מזהה המשתמש שאנו בודקים עבורו מותקן החבילה. אם null, המשתמש הראשי אפס ישמש. |
החזרות |
---|
boolean | נכון אם החבילה מדווחת כמותקנת. שקר אחרת. |
isUserRunning
public boolean isUserRunning (int userId)
בדוק אם משתמש נתון פועל.
החזרות |
---|
boolean | נכון אם המשתמש פועל, שקר בכל מקרים אחרים. |
isUserSecondary
public boolean isUserSecondary (int userId)
החזר אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.
החזרות |
---|
boolean | נכון אם המשתמש הוא משני, false אחרת. |
isUserVisible
public boolean isUserVisible (int userId)
בודק אם המשתמש הנתון גלוי.
משתמש "גלוי" הוא משתמש שמקיים אינטראקציה עם המשתמש ה"אנושי" ומכאן שהוא מסוגל להפעיל פעילויות השקה (בדרך כלל בתצוגת ברירת המחדל).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
בודק אם המשתמש הנתון גלוי בתצוגה הנתונה.
משתמש "גלוי" הוא משתמש שמקיים אינטראקציה עם המשתמש ה"אנושי", ומכאן שהוא מסוגל להפעיל פעילויות השקה בתצוגה זו.
פרמטרים |
---|
userId | int |
displayId | int |
listDisplayIds
public listDisplayIds ()
אסוף את הרשימה של מזהה תצוגות זמין במכשיר כפי שדווח על ידי "dumpsys SurfaceFlinger".
החזרות |
---|
| רשימת התצוגות. ברירת המחדל תמיד מחזירה את תצוגת ברירת המחדל 0. |
רשימת משתמשים
public listUsers ()
מקבל את רשימת המשתמשים במכשיר. יזרוק DeviceRuntimeException
אם הפלט מהמכשיר אינו כצפוי.
החזרות |
---|
| רשימת מזהי המשתמשים. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
שיטת עוזר לקחת דוח באג ולהתחבר לכתבים.
פרמטרים |
---|
dataName | String : שם תחתיו ידווח דיווח הבאג. |
listener | ITestLogger : ITestLogger לרישום של דוח הבאג. |
החזרות |
---|
boolean | נכון אם הרישום הצליח, לא נכון אחרת. |
הודע לSnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
פרמטרים |
---|
waitPhase | SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
שלבים נוספים עבור ניקוי נדרש ספציפי למכשיר שיבוצעו לאחר ביצוע ההזמנה.
פרמטרים |
---|
exception | Throwable : אם קיים, החריג האחרון שהועלה על ידי כשל הפנייה. |
הסר אדמין
public boolean removeAdmin (String componentName,
int userId)
הסר מנהל מכשיר נתון במשתמש נתון והחזר true
אם זה מצליח, false
אחרת.
פרמטרים |
---|
componentName | String : של מנהל המכשיר להסרה. |
userId | int : של המשתמש שמנהל המכשיר גר בו. |
החזרות |
---|
boolean | נכון אם זה מצליח, לא נכון אחרת. |
להסיר בעלים
public void removeOwners ()
הסר את כל בעלי פרופיל המכשירים הקיימים במאמץ הטוב ביותר.
הסר משתמש
public boolean removeUser (int userId)
הסר משתמש נתון מהמכשיר.
פרמטרים |
---|
userId | int : של המשתמש להסרה |
החזרות |
---|
boolean | נכון אם הצלחנו להסיר את המשתמש, false אחרת. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
הגדר רכיב ניהול מכשיר כבעל מכשיר במשתמש נתון.
פרמטרים |
---|
componentName | String : של מנהל המכשיר להיות הבעלים של המכשיר. |
userId | int : של המשתמש שבו מתגורר בעל המכשיר. |
החזרות |
---|
boolean | נכון אם זה מצליח, לא נכון אחרת. |
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)
הוסף ערך הגדרה למרחב השמות של משתמש נתון. חלק מההגדרות יהיו זמינות רק לאחר אתחול מחדש. מרחב השמות חייב להיות אחד מ: {"system", "secure", "global"}
פרמטרים |
---|
userId | int |
namespace | String |
key | String |
value | String |
כיבוי מיקרודרואיד
public void shutdownMicrodroid (ITestDevice microdroidDevice)
מכבה את מכשיר ה-microdroid, אם קיים.
פרמטרים |
---|
microdroidDevice | ITestDevice |
startUser
public boolean startUser (int userId)
מפעיל משתמש נתון ברקע אם הוא מופסק כעת. אם המשתמש כבר פועל ברקע, שיטה זו היא NOOP.
פרמטרים |
---|
userId | int : של המשתמש להתחיל ברקע |
החזרות |
---|
boolean | נכון אם המשתמש הופעל בהצלחה ברקע. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
מפעיל משתמש נתון ברקע אם הוא מופסק כעת. אם המשתמש כבר פועל ברקע, שיטה זו היא NOOP. אפשר לספק דגל נוסף להמתנה לביצוע הפעולה.
פרמטרים |
---|
userId | int : של המשתמש להתחיל ברקע |
waitFlag | boolean : יגרום לפקודה להמתין עד שהמשתמש יופעל וייפתח. |
החזרות |
---|
boolean | נכון אם המשתמש הופעל בהצלחה ברקע. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
מפעיל משתמש נתון ברקע, גלוי בתצוגה הנתונה (כלומר, מאפשר למשתמש להפעיל פעילויות בתצוגה זו).
הערה: פקודה זו אינה בודקת אם המשתמש קיים, התצוגה זמינה, device supports such feature
וכו'.
פרמטרים |
---|
userId | int : של המשתמש להתחיל ברקע |
displayId | int : תצוגה כדי להתחיל משתמש גלוי ב |
waitFlag | boolean : יגרום לפקודה להמתין עד שהמשתמש יופעל וייפתח. |
החזרות |
---|
boolean | true אם המשתמש הופעל בהצלחה גלוי ברקע. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
עצור משתמש נתון. אפשר לספק דגלים נוספים כדי להמתין עד שהפעולה תיכנס לתוקף, ולאלץ לסיים את המשתמש. לא ניתן לעצור את המשתמש הנוכחי והמערכת.
פרמטרים |
---|
userId | int : של המשתמש לעצור. |
waitFlag | boolean : יגרום לפקודה להמתין עד שהמשתמש יופסק. |
forceFlag | boolean : יאלץ לעצור את המשתמש. |
החזרות |
---|
boolean | נכון אם המשתמש הופסק בהצלחה. |
stopUser
public boolean stopUser (int userId)
עוצר משתמש נתון. אם המשתמש כבר נעצר, שיטה זו היא NOOP. לא ניתן לעצור את המשתמש הנוכחי והמערכת.
פרמטרים |
---|
userId | int : של המשתמש לעצור. |
החזרות |
---|
boolean | נכון אם המשתמש הופסק בהצלחה. |
תומך ב-Microdroid
public boolean supportsMicrodroid ()
בודק את התנאים המוקדמים להפעלת microdroid.
החזרות |
---|
boolean | מחזירה true אם התנאים המוקדמים מתקיימים, false אחרת. |
תומך ב-Microdroid
public boolean supportsMicrodroid (boolean protectedVm)
בודק את התנאים המוקדמים להפעלת microdroid.
פרמטרים |
---|
protectedVm | boolean : נכון אם microdroid מיועד לפעול ב-VM מוגן. |
החזרות |
---|
boolean | מחזירה true אם התנאים המוקדמים מתקיימים, false אחרת. |
החלף משתמש
public boolean switchUser (int userId)
עבור ל-userId אחר עם פסק זמן ברירת מחדל. switchUser(int, long)
.
החזרות |
---|
boolean | נכון אם ה-userId החדש תואם לספק ה-userId. שקר אחרת. |
החלף משתמש
public boolean switchUser (int userId,
long timeout)
עבור ל-userId אחר עם הזמן הקצוב שסופק כתאריך יעד. נסה להשבית את שמירת המקשים לאחר ששינוי המשתמש הצליח.
פרמטרים |
---|
userId | int |
timeout | long : להמתין לפני החזרת false עבור מתג-משתמש נכשלה. |
החזרות |
---|
boolean | נכון אם ה-userId החדש תואם לספק ה-userId. שקר אחרת. |
קח דיווח על שגיאות
public Bugreport takeBugreport ()
קח דוח באג ומחזיר אותו בתוך אובייקט Bugreport
כדי לטפל בו. החזר לאפס במקרה של בעיה. יש לנקות את הקובץ שאליו יש הפניה באובייקט Bugreport באמצעות Bugreport.close()
.
הסר את חבילת ההתקנה
public String uninstallPackage (String packageName)
הסר התקנה של חבילת אנדרואיד מהמכשיר.
פרמטרים |
---|
packageName | String : חבילת אנדרואיד להסרת ההתקנה |
החזרות |
---|
String | String עם קוד שגיאה, או null אם היא מצליחה. |
הסר את ההתקנה שלPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
הסר התקנה של חבילת אנדרואיד מהמכשיר עבור משתמש נתון.
פרמטרים |
---|
packageName | String : חבילת אנדרואיד להסרת ההתקנה |
userId | int : מזהה המשתמש השלם שיש להסיר עבורו. |
החזרות |
---|
String | String עם קוד שגיאה, או null אם היא מצליחה. |
לחכות לSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
פרמטרים |
---|
currentPhase | SnapuserdWaitPhase |
שיטות מוגנות
createParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
בצע אתחול של adb.
פרמטרים |
---|
rebootMode | NativeDevice.RebootMode : מצב של אתחול זה. |
reason | String : עבור אתחול מחדש זה. |
getBugreportzInternal
protected File getBugreportzInternal ()
שיטת עוזר פנימי לקבל את קובץ ה-zip bugreportz כ- ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
נחשף לבדיקה.
getHostCurrentTime
protected long getHostCurrentTime ()
נחשף לבדיקה
prePostBootSetup
protected void prePostBootSetup ()
מאפשר לכל סוג מכשיר (AndroidNativeDevice, TestDevice) לעקוף שיטה זו עבור הגדרה ספציפית לאחר האתחול.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-04-02 (שעון UTC).
[]
[]
{
"last_modified": "עדכון אחרון: 2024-04-02 (שעון UTC).",
"state": ""
}