TestDevice

public class TestDevice
extends NativeDevice

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

הטמעה של ITestDevice במכשיר Android עם סטאק מלא

סיכום

כיתות בתצוגת עץ

class TestDevice.MicrodroidBuilder

ה-builder שמשמש ליצירת Microdroid TestDevice. 

שדות

public static final String DISMISS_KEYGUARD_CMD

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

קונסטרוקטורים גלויים לכולם

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

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

boolean canSwitchToHeadlessSystemUser()

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

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()

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

getAllSettings(String namespace)

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

String getAndroidId(int userId)

חיפוש והחזרת הערך של android-id שמשויך למשתמש, או null אם לא נמצא.

getAndroidIds()

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

PackageInfo getAppPackageInfo(String packageName)

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

getAppPackageInfos()

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

InputStreamSource getBugreport()

אחזור דוח באג מהמכשיר.

InputStreamSource getBugreportz()

אחזור של bugreportz מהמכשיר.

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(long displayId)

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

InputStreamSource getScreenshot(String format)

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

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()

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

boolean isMainUserPermanentAdmin()

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

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 setFirstBootloaderReboot()
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()

בדיקת התנאים המוקדמים להרצת microdroid.

boolean supportsMicrodroid(boolean protectedVm)

בדיקת התנאים המוקדמים להרצת microdroid.

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

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

Bugreport takeBugreport()

הפונקציה מקבלת דוח באג ומחזירה אותו בתוך אובייקט Bugreport לטיפול.

String uninstallPackage(String packageName)

הסרת חבילת Android מהמכשיר.

String uninstallPackageForUser(String packageName, int userId)

הסרת חבילה של Android מהמכשיר של משתמש נתון.

void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

שיטות מוגנות

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

מבצעים הפעלה מחדש של adb.

InputStreamSource getBugreportInternal()
File getBugreportzInternal()

שיטה פנימית מסייעת לקבלת קובץ ה-zip של bugreportz כ-ERROR(/File).

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)

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

החזרות
boolean

זריקות
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

createUser

public int createUser (String name)

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

פרמטרים
name String: של המשתמש שייווצר במכשיר
החזרות
int המספר השלם של מזהה המשתמש שנוצר
זריקות
DeviceNotAvailableException

createUser

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

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

פרמטרים
name String: של המשתמש שייווצר במכשיר
guest boolean: הפעלת הדגל --guest של המשתמש במהלך היצירה
ephemeral boolean: הפעלת הדגל של המשתמש --ephemeral במהלך היצירה
forTesting boolean: הפעלת דגל הבדיקה --for-testing במהלך היצירה
החזרות
int המזהה של המשתמש שנוצר
זריקות
DeviceNotAvailableException

createUser

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

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

פרמטרים
name String: של המשתמש שייווצר במכשיר
guest boolean: הפעלת הדגל --guest של המשתמש במהלך היצירה
ephemeral boolean: הפעלת הדגל של המשתמש --ephemeral במהלך היצירה
החזרות
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) שמכיל את הדוח. Null אם משהו נכשל.
זריקות
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

getAllSettings

public  getAllSettings (String namespace)

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

פרמטרים
namespace String: חייב להיות אחד מהערכים הבאים: {"system", "secure", "global"}
החזרות
המפה של צמדי המפתחות/הערכים. Null אם מרחב השמות לא נתמך.
זריקות
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

חיפוש והחזרת הערך של android-id שמשויך למשתמש, או null אם לא נמצא.

פרמטרים
userId int

החזרות
String

זריקות
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

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

החזרות
מפה של מזהי Android שמצאו מזהי משתמשים תואמים.
זריקות
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

פרמטרים
packageName String

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

getAppPackageInfos

public  getAppPackageInfos ()

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

החזרות