מכשיר בדיקה
public
class
TestDevice
extends NativeDevice
מחלקות משנה ישירות ידועות
|
הטמעה של ITestDevice
למכשיר Android בסטאק מלא
סיכום
שדות |
public
static
final
String |
DISMISS_KEYGUARD_CMD
פקודות שאפשר להשתמש בהן כדי לסגור את מגן המקשים.
|
שיטות ציבוריות |
boolean
|
canSwitchToHeadlessSystemUser()
הפונקציה מחזירה אם מותר לעבור למשתמש SYSTEM ללא GUI.
|
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()
אחזור המידע על הפעלה של APEX במכשיר.
|
|
getAllSettings(String namespace)
החזרת זוגות של ערכי מפתח ממרחב השמות המבוקש.
|
String
|
getAndroidId(int userId)
חיפוש והחזרת android-id המשויך ל-userId, null אם לא נמצא.
|
|
getAndroidIds()
יצירת מפה של מזהי Android שנמצאו במזהי משתמשים תואמים.
|
PackageInfo
|
getAppPackageInfo(String packageName)
אחזור מידע על חבילה שמותקנת במכשיר.
|
|
getAppPackageInfos()
אחזור מידע על החבילות שמותקנות במכשיר.
|
InputStreamSource
|
getBugreport()
אחזור דוח על באג מהמכשיר.
|
InputStreamSource
|
getBugreportz()
אחזור דוח על באג מהמכשיר.
|
DeviceFoldableState
|
getCurrentFoldableState()
מחזירה את מצב המכשיר המתקפל הנוכחי של המכשיר או ערך null אם התרחשו בעיות מסוימות.
|
int
|
getCurrentUser()
החזרת המזהה של המשתמש הפעיל הנוכחי.
|
|
getFoldableStates()
הפונקציה מחזירה את רשימת המצבים המתקפלים במכשיר.
|
|
getInstalledPackageNames()
אחזר את שמות החבילות של האפליקציות שקיימים במכשיר.
|
KeyguardControllerState
|
getKeyguardState()
החזרת אובייקט כדי לקבל את המצב הנוכחי של KeyGuard או כ-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)
אם נמצא, יש להחזיר את המספר הסידורי שמשויך למזהה המשתמש, -10000 במקרים אחרים.
|
boolean
|
hasFeature(String feature)
בודקים אם התכונה זמינה במכשיר.
|
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
מתקינים חבילת Android במכשיר.
|
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
מתקינים חבילת Android במכשיר.
|
String
|
installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)
מתקינים חבילת Android במכשיר.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
התקנת חבילת Android במכשיר של משתמש מסוים.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
התקנת חבילת Android במכשיר של משתמש מסוים.
|
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
|
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
|
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
|
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
boolean
|
isAppEnumerationSupported()
בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
|
boolean
|
isHeadlessSystemUserMode()
מחזירה אם המכשיר משתמש במצב משתמש במערכת ללא GUI.
|
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)
מכבה את מכשיר ה-microdroid, אם יש כזה.
|
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()
בודקת את התנאים המוקדמים להפעלת מיקרו-דרואיד.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
בודקת את התנאים המוקדמים להפעלת מיקרו-דרואיד.
|
boolean
|
switchUser(int userId)
מעבר למזהה משתמש אחר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל.
|
boolean
|
switchUser(int userId, long timeout)
עוברים ל-User-ID אחר עם הזמן הקצוב לתפוגה שצוין כתאריך היעד.
|
Bugreport
|
takeBugreport()
יוצרים דוח על באג ומחזירים אותו בתוך אובייקט Bugreport כדי לטפל בו.
|
String
|
uninstallPackage(String packageName)
מסירים חבילת Android מהמכשיר.
|
String
|
uninstallPackageForUser(String packageName, int userId)
הסרה של חבילת Android מהמכשיר של משתמש מסוים.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
שדות
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
פקודות שאפשר להשתמש בהן כדי לסגור את מגן המקשים.
בנאים ציבוריים
שיטות ציבוריות
CanSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
הפונקציה מחזירה אם מותר לעבור למשתמש SYSTEM ללא GUI.
cleanErrorDialogs
public boolean clearErrorDialogs ()
אפשר לנסות לסגור את כל תיבות הדו-שיח של השגיאה שמוצגות כרגע בממשק המשתמש של המכשיר.
החזרות |
boolean |
true אם לא קיימות תיבות דו-שיח, או אם תיבות הדו-שיח נוקו.
אחרת, false . |
CreateUser
public int createUser (String name)
יצירת משתמש עם שם נתון ודגלי ברירת המחדל 0.
פרמטרים |
name |
String : של המשתמש שצריך ליצור במכשיר |
החזרות |
int |
המספר השלם של מזהה המשתמש שנוצר |
CreateUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
יצירת משתמש עם שם נתון והדגלים שסופקו
פרמטרים |
name |
String : של המשתמש שצריך ליצור במכשיר |
guest |
boolean : הפעלת סימון המשתמש – אורח במהלך היצירה |
ephemeral |
boolean : הפעלת סימון המשתמש באופן זמני במהלך היצירה |
forTesting |
boolean : הפעלת סימון הבדיקה –לבדיקה במהלך היצירה |
החזרות |
int |
המזהה של המשתמש שנוצר |
CreateUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
יצירת משתמש עם שם נתון והדגלים שסופקו
פרמטרים |
name |
String : של המשתמש שצריך ליצור במכשיר |
guest |
boolean : הפעלת סימון המשתמש – אורח במהלך היצירה |
ephemeral |
boolean : הפעלת סימון המשתמש באופן זמני במהלך היצירה |
החזרות |
int |
המזהה של המשתמש שנוצר |
createUserNoThrow
public int createUserNoThrow (String name)
יצירת משתמש עם שם נתון ודגלי ברירת המחדל 0.
פרמטרים |
name |
String : של המשתמש שצריך ליצור במכשיר |
החזרות |
int |
המספר השלם של מזהה המשתמש שנוצר, או 1- לשגיאה. |
השבתה של KeyGuard
public void disableKeyguard ()
מנסה להשבית את מגן המקשים.
קודם כל צריך להמתין עד ששליחה הקלט תהיה מוכנה, זה מתרחש בערך באותו זמן כאשר
המכשיר מדווח על BOOT_COMPLETE, באופן אסינכרוני, כי המסגרת הנוכחית
יש מרוץ תהליכים מדי פעם. לאחר מכן נשלחת פקודה לסגירת מקש KeyGuard (פועל
בתנועה לא מאובטחת בלבד)
DoFileExist
public boolean doesFileExist (String deviceFilePath)
שיטה עוזרת לקבוע אם קובץ קיים במכשיר.
פרמטרים |
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר לבדיקה |
החזרות |
boolean |
true אם הקובץ קיים, אחרת false . |
DoFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
שיטה עוזרת לקבוע אם קובץ במכשיר קיים למשתמש מסוים.
פרמטרים |
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר לבדיקה |
userId |
int : מזהה המשתמש שבאמצעותו צריך לבדוק את קיומו של הקובץ |
החזרות |
boolean |
true אם הקובץ קיים, אחרת false . |
עריסות
public File dumpHeap (String process,
String devicePath)
נסה למחוק את הערימה מה-system_server. באחריות המתקשר/ת לבצע ניקיון
את הקובץ שהורד.
פרמטרים |
process |
String : שם התהליך במכשיר שאליו רוצים לבצע את ה-Dumpheap. |
devicePath |
String : הנתיב במכשיר שבו צריך למקם את קובץ ה-Dump. המיקום הזה חייב להיות מיקום שבו
ההרשאות מאפשרות זאת. |
החזרות |
File |
ERROR(/File) שמכיל את הדוח. המערכת תציג ערך של null אם משהו נכשל. |
getActiveApexes
public getActiveApexes ()
אחזור המידע על הפעלה של APEX במכשיר.
getAllSettings
public getAllSettings (String namespace)
החזרת זוגות של ערכי מפתח ממרחב השמות המבוקש.
פרמטרים |
namespace |
String : חייב להיות אחד מהערכים {"system", "secure", "global"} |
החזרות |
|
המפה של צמדי המפתח. המערכת תציג ערך של null אם אין תמיכה במרחב השמות. |
getAndroidId
public String getAndroidId (int userId)
חיפוש והחזרת android-id המשויך ל-userId, null אם לא נמצא.
מזהי getAndroidId
public getAndroidIds ()
יצירת מפה של מזהי Android שנמצאו במזהי משתמשים תואמים. אין ביטוח שכל משתמש
הפרמטר id ימצא מזהה android המשויך לפונקציה הזו, כך שחלק ממזהי המשתמש עשויים להתאים ל-null.
החזרות |
|
מפה של מזהי Android שנמצאו במזהי משתמשים תואמים. |
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'
מצבי הדפסה".
getInstalledPackageNames
public getInstalledPackageNames ()
אחזר את שמות החבילות של האפליקציות שקיימים במכשיר.
getKeyGuardState
public KeyguardControllerState getKeyguardState ()
החזרת אובייקט כדי לקבל את המצב הנוכחי של KeyGuard או כ-null אם אין תמיכה בו.
getMainUserId
public Integer getMainUserId ()
הפונקציה מחזירה את מזהה המשתמש הראשי.
החזרות |
Integer |
מזהה המשתמש של המשתמש הראשי אם קיים, ו-null אם אין משתמש ראשי. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
קבלת המידע על המודולים של השורה הראשית שמותקנים במכשיר.
public int getMaxNumberOfRunningUsersSupported ()
קבלת המספר המקסימלי של משתמשים פעילים נתמכים בו-זמנית. ברירת המחדל היא 0.
החזרות |
int |
מספר שלם שמציין את מספר המשתמשים הפעילים בו-זמנית |
public int getMaxNumberOfUsersSupported ()
קבלת המספר המקסימלי של משתמשים נתמכים. ברירת המחדל היא 0.
החזרות |
int |
מספר שלם שמציין את מספר המשתמשים הנתמכים |
getPrimaryUserId
public Integer getPrimaryUserId ()
מחזירה את מזהה המשתמש הראשי.
החזרות |
Integer |
מזהה המשתמש של המשתמש הראשי אם קיים, ו-null אם אין משתמש ראשי. |
קבלת צילום מסך
public InputStreamSource getScreenshot (String format,
boolean rescale)
מצלם צילום מסך מהמכשיר. מומלץ להשתמש במקום זאת ב-getScreenshot(String)
עם קידוד JPEG לגודל קטן יותר.
פרמטרים |
format |
String : קובץ PNG נתמך, JPEG |
rescale |
boolean : אם צריך לשנות את גודל המסך כדי להקטין את גודל התמונה שמתקבלת |
קבלת צילום מסך
public InputStreamSource getScreenshot (String format)
מצלם צילום מסך מהמכשיר.
כדי להקטין את הגודל, מומלץ להשתמש במקום זאת בקידוד JPEG(פורמט getצילום מסך) עם קידוד JPEG
פרמטרים |
format |
String : קובץ PNG נתמך, JPEG |
קבלת צילום מסך
public InputStreamSource getScreenshot (long displayId)
מצלם צילום מסך מהמכשיר שצוין למזהה התצוגה. הפורמט הוא PNG.
TODO: הרחבת ההטמעות שלמעלה כדי לתמוך ב-'format' ו'קנה מידה'
פרמטרים |
displayId |
long : מזהה התצוגה של המסך שממנו רוצים לצלם את המסך. |
הגדרה
public String getSetting (String namespace,
String key)
הצגת getSetting(int, String, String)
ובוצעה במשתמש מערכת.
פרמטרים |
namespace |
String |
key |
String |
הגדרה
public String getSetting (int userId,
String namespace,
String key)
מחזירה את הערך של ההגדרה המבוקשת.
מרחב השמות חייב להיות אחד מהערכים הבאים: {"system", "secure", "global"}
פרמטרים |
userId |
int |
namespace |
String |
key |
String |
החזרות |
String |
הערך שמשויך למפתח namespace:של משתמש. המערכת תציג ערך של null אם לא ניתן למצוא אותו. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
מאחזרים את שמות החבילות של האפליקציות שאפשר להסיר. כרגע הוא מוגדר כך
חבילות שאינן של מערכת וחבילות מערכת מעודכנות.
getUserflags
public int getUserFlags (int userId)
למצוא ולהחזיר את הדגלים של משתמש נתון.
הסימונים מוגדרים ב-"android.content.pm.UserInfo" בכיתה בפרויקט קוד פתוח של Android.
החזרות |
int |
הדגלים המשויכים למזהה המשתמש שצוין, אם נמצא, -10000 במקרים אחרים. |
getUserInfos
public getUserInfos ()
הפונקציה מקבלת את מפת useId אל UserInfo
במכשיר. הפעולה תקפיץ DeviceRuntimeException
אם הפלט מהמכשיר לא תקין.
החזרות |
|
את הרשימה של UserInfo. |
getUserSeriesNumber
public int getUserSerialNumber (int userId)
אם נמצא, יש להחזיר את המספר הסידורי שמשויך למזהה המשתמש, -10000 במקרים אחרים.
hasFeature
public boolean hasFeature (String feature)
בודקים אם התכונה זמינה במכשיר.
פרמטרים |
feature |
String : איזה פורמט צריך להיות "feature:" או "" ישירות. |
החזרות |
boolean |
True אם התכונה נמצאת, אחרת False. |
חבילת התקנה
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
מתקינים חבילת Android במכשיר.
פרמטרים |
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)
מתקינים חבילת Android במכשיר.
הערה: רק תרחישים לדוגמה שדורשים שליטה מפורשת בהענקת הרשאה בתחילת ההפעלה ב
צריך להפעיל את הפונקציה הזו בזמן ההתקנה.
פרמטרים |
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)
מתקינים חבילת Android במכשיר.
הערה: רק תרחישים לדוגמה שדורשים שליטה מפורשת בהענקת הרשאה בתחילת ההפעלה ב
צריך להפעיל את הפונקציה הזו בזמן ההתקנה.
פרמטרים |
packageFile |
File : קובץ ה-APK להתקנה |
certFile |
File : true אם יש לבצע התקנה מחדש |
reinstall |
boolean : אם צריך להעניק את כל ההרשאות בזמן הריצה בזמן ההתקנה |
extraArgs |
String : ארגומנטים נוספים שרוצים להעביר. למידע נוסף: 'adb Shell pm -h' עבור זמינים
אפשרויות. |
החזרות |
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
התקנהPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
התקנת חבילת Android במכשיר של משתמש מסוים.
הערה: רק תרחישים לדוגמה שדורשים שליטה מפורשת בהענקת הרשאה בתחילת ההפעלה ב
צריך להפעיל את הפונקציה הזו בזמן ההתקנה.
פרמטרים |
packageFile |
File : קובץ ה-APK להתקנה |
reinstall |
boolean : true אם יש לבצע התקנה מחדש |
grantPermissions |
boolean : אם צריך להעניק את כל ההרשאות בזמן הריצה בזמן ההתקנה |
userId |
int : מספר המשתמש השלם שרוצים להתקין. |
extraArgs |
String : ארגומנטים נוספים שרוצים להעביר. למידע נוסף: 'adb Shell pm -h' עבור זמינים
אפשרויות. |
החזרות |
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
התקנהPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
התקנת חבילת Android במכשיר של משתמש מסוים.
פרמטרים |
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 |
isAppEnumeration נתמך
public boolean isAppEnumerationSupported ()
בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
החזרות |
boolean |
True אם יש תמיכה בספירת אפליקציות, FALSE אם לא יש תמיכה בספירת אפליקציות |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
מחזירה אם המכשיר משתמש במצב משתמש במערכת ללא GUI.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
הפונקציה מחזירה אם המשתמש הראשי הוא אדמין קבוע ולא ניתן למחוק או לשדרג אותו לאחור ל-
ללא הרשאת אדמין.
isMultiUserSupported
public boolean isMultiUserSupported ()
המדיניות קובעת אם יש תמיכה בריבוי משתמשים.
החזרות |
boolean |
true אם יש תמיכה בריבוי משתמשים, FALSE אם יש תמיכה בריבוי משתמשים, אחרת |
isPackageInstalled (בהתקנה)
public boolean isPackageInstalled (String packageName)
שולחים למכשיר שאילתה על שם חבילה מסוים כדי לבדוק אם הוא מותקן כרגע או לא.
פרמטרים |
packageName |
String |
החזרות |
boolean |
הערך יהיה True אם החבילה מדווחת כאפליקציה שהותקנה. אחרת, שקרית. |
isPackageInstalled (בהתקנה)
public boolean isPackageInstalled (String packageName,
String userId)
שולחים למכשיר שאילתות לגבי שם חבילה נתון ומזהה משתמש כדי לבדוק אם החבילה הנוכחית
מותקנת או לא עבור המשתמש הזה.
פרמטרים |
packageName |
String : החבילה שאנחנו בודקים אם היא מותקנת. |
userId |
String : מזהה המשתמש שאנחנו בודקים שהחבילה מותקנת עבורו. אם הערך הוא null, המשתמש הראשי
המערכת תשתמש באפס. |
החזרות |
boolean |
הערך יהיה True אם החבילה מדווחת כאפליקציה שהותקנה. אחרת, שקרית. |
isUser running
public boolean isUserRunning (int userId)
בודקים אם משתמש מסוים פועל.
החזרות |
boolean |
הערך הוא True אם המשתמש פועל, בכל מקרה אחר הערך False. |
isUsersecondary
public boolean isUserSecondary (int userId)
מחזירה אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.
החזרות |
boolean |
true אם המשתמש הוא משני, אחרת false. |
isUserצג
public boolean isUserVisible (int userId)
הפונקציה בודקת אם המשתמש הנתון גלוי.
A "גלוי" הוא משתמש שמקיים אינטראקציה עם ולכן הוא יכול
להפעיל פעילויות הפעלה (בדרך כלל בתצוגת ברירת המחדל).
isUserVisibilityOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
הפונקציה בודקת אם המשתמש הנתון גלוי במסך הנתון.
A "גלוי" הוא משתמש שמקיים אינטראקציה עם ולכן הוא יכול
להשיק פעילויות בתצוגה הזאת.
פרמטרים |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
איסוף רשימת מזהי המסכים הזמינים במכשיר, כפי שדווח על ידי dumpsys
SurfaceFlinger".
החזרות |
|
רשימת המסכים. ברירת המחדל תמיד מחזירה את הערך 0 שמוגדר כברירת המחדל. |
listUsers
public listUsers ()
קבלת רשימת המשתמשים במכשיר. המערכת תיקח DeviceRuntimeException
אם הפלט
מהמכשיר, זה לא כצפוי.
החזרות |
|
הרשימה של מזהי המשתמשים. |
דוח LogBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
שיטה עוזרת לתעד דוח על באג ולרשום אותו למדווחים.
פרמטרים |
dataName |
String : השם שתחתיו ידווח הדוח על הבאג. |
listener |
ITestLogger : ITestLogger לרישום הדוח על הבאג. |
החזרות |
boolean |
הערך הוא True אם הרישום ביומן בוצע בהצלחה, אחרת False. |
התרת 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 |
True אם היא מצליחה, אחרת False. |
הסרת בעלים
public void removeOwners ()
אתם יכולים להסיר את כל בעלי הפרופילים הקיימים של המכשיר בלי להתאמץ.
removeUser
public boolean removeUser (int userId)
להסיר משתמש נתון מהמכשיר.
פרמטרים |
userId |
int : מהמשתמש שרוצים להסיר |
החזרות |
boolean |
true אם נצליח להסיר את המשתמש, false אם לא נצליח להסיר את המשתמש. |
setDeviceOwner (הבעלים של המכשיר)
public boolean setDeviceOwner (String componentName,
int userId)
הגדרת רכיב של מנהל מכשיר כבעלים של המכשיר במשתמש הנתון.
פרמטרים |
componentName |
String : של אדמין המכשיר להיות הבעלים של המכשיר. |
userId |
int : של המשתמש שבו גר בעל המכשיר. |
החזרות |
boolean |
True אם היא מצליחה, אחרת False. |
הגדרה
public void setSetting (int userId,
String namespace,
String key,
String value)
אתם יכולים להוסיף ערך הגדרה למרחב השמות של משתמש נתון. רק חלק מההגדרות יהיו זמינות
לאחר הפעלה מחדש.
מרחב השמות חייב להיות אחד מהערכים הבאים: {"system", "secure", "global"}
פרמטרים |
userId |
int |
namespace |
String |
key |
String |
value |
String |
כיבוי של Microdroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
מכבה את מכשיר ה-microdroid, אם יש כזה.
פרמטרים |
microdroidDevice |
ITestDevice |
startUser
public boolean startUser (int userId)
מפעיל משתמש מסוים ברקע אם הוא מופסק כרגע. אם המשתמש כבר
פועלת ברקע, השיטה הזו היא NOOP.
פרמטרים |
userId |
int : מהמשתמש להתחיל ברקע |
החזרות |
boolean |
true אם המשתמש הופעל בהצלחה ברקע. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
מפעיל משתמש מסוים ברקע אם הוא מופסק כרגע. אם המשתמש כבר
פועלת ברקע, השיטה הזו היא NOOP. ניתן לספק סימון נוסף שצריך להמתין
לפעולה שמשפיעה.
פרמטרים |
userId |
int : מהמשתמש להתחיל ברקע |
waitFlag |
boolean : יגרום לפקודה להמתין עד שהמשתמש יתחיל לפעול ויבטל את הנעילה שלו. |
החזרות |
boolean |
true אם המשתמש הופעל בהצלחה ברקע. |
start visibilityBackgroundUser
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 |
true אם המשתמש הופסק בהצלחה. |
stopUser
public boolean stopUser (int userId)
עוצר משתמש נתון. אם המשתמש כבר הופסק, השיטה הזו היא NOOP.
לא ניתן להפסיק את המשתמש הנוכחי ואת המשתמש של המערכת.
פרמטרים |
userId |
int : של המשתמש כדי להפסיק. |
החזרות |
boolean |
true אם המשתמש הופסק בהצלחה. |
תמיכה ב-Microdroid
public boolean supportsMicrodroid ()
בודקת את התנאים המוקדמים להפעלת מיקרו-דרואיד.
החזרות |
boolean |
מחזירה True אם התנאים המוקדמים מתקיימים, ו-false אם לא. |
תמיכה ב-Microdroid
public boolean supportsMicrodroid (boolean protectedVm)
בודקת את התנאים המוקדמים להפעלת מיקרו-דרואיד.
פרמטרים |
protectedVm |
boolean : True אם המיקרו-דריום מיועד לפעול במכונה וירטואלית מוגנת. |
החזרות |
boolean |
מחזירה True אם התנאים המוקדמים מתקיימים, ו-false אם לא. |
מתג משתמש
public boolean switchUser (int userId)
מעבר למזהה משתמש אחר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל. switchUser(int, long)
.
החזרות |
boolean |
הערך הוא True אם ה-User-ID החדש תואם לספק ה-User-ID. אחרת, שקרית. |
מתג משתמש
public boolean switchUser (int userId,
long timeout)
עוברים ל-User-ID אחר עם הזמן הקצוב לתפוגה שצוין כתאריך היעד.
ניסיון להשבית את נעילת המקשים לאחר שינוי המשתמש בהצלחה.
פרמטרים |
userId |
int |
timeout |
long : להמתין לפני החזרת FALSE למשתמש-החלפה נכשלה. |
החזרות |
boolean |
הערך הוא True אם ה-User-ID החדש תואם לספק ה-User-ID. אחרת, שקרית. |
takeBugreport
public Bugreport takeBugreport ()
יוצרים דוח על באג ומחזירים אותו בתוך אובייקט Bugreport
כדי לטפל בו. החזרה ריקה
במקרה של בעיה. צריך לנקות את הקובץ שמצוין באובייקט הדוח על הבאג דרך Bugreport.close()
.
הסרת החבילה
public String uninstallPackage (String packageName)
מסירים חבילת Android מהמכשיר.
פרמטרים |
packageName |
String : חבילת Android שיש להסיר |
החזרות |
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
removePackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
הסרה של חבילת Android מהמכשיר של משתמש מסוים.
פרמטרים |
packageName |
String : חבילת Android שיש להסיר |
userId |
int : מספר המשתמש השלם שרוצים להסיר. |
החזרות |
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
להמתין ל-Snapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
פרמטרים |
currentPhase |
SnapuserdWaitPhase |
שיטות מוגנות
CreateParser
protected AaptParser createParser (File appFile)
doAdbRe
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
צריך לבצע הפעלה מחדש של adb.
פרמטרים |
rebootMode |
NativeDevice.RebootMode : מצב של ההפעלה מחדש. |
reason |
String : להפעלה מחדש. |
getBugreportzinternal
protected File getBugreportzInternal ()
שיטת 'עוזר דיגיטלי' עוזרת לקבל את קובץ ה-ZIP של דוח איתור הבאגים בתור ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
חשיפה לבדיקה.
getHostCurrentTime
protected long getHostCurrentTime ()
חשיפה לבדיקה
הגדרת טרום-PostBoot
protected void prePostBootSetup ()
המדיניות מאפשרת לכל סוג מכשיר (AndroidNativeDevice, TestDevice) לשנות את השיטה הזו בשביל
לאחר הפעלה ספציפית.