מכשיר בדיקה

public class TestDevice
extends NativeDevice

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

הפונקציה מחזירה אם מותר לעבור למשתמש 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)

שיטות מוגנות

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

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

InputStreamSource getBugreportInternal()
File getBugreportzInternal()

שיטת 'עוזר דיגיטלי' עוזרת לקבל את קובץ ה-ZIP של דוח איתור הבאגים בתור ERROR(/File).

long getCheckNewUserSleep()

חשיפה לבדיקה.

long getHostCurrentTime()

חשיפה לבדיקה

void prePostBootSetup()

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

שדות

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

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

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

מכשיר בדיקה

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

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

CanSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

החזרות
boolean

קליעות
DeviceNotAvailableException

cleanErrorDialogs

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: הפעלת סימון המשתמש – אורח במהלך היצירה

ephemeral boolean: הפעלת סימון המשתמש באופן זמני במהלך היצירה

forTesting boolean: הפעלת סימון הבדיקה –לבדיקה במהלך היצירה

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

קליעות
DeviceNotAvailableException

CreateUser

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

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

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

guest boolean: הפעלת סימון המשתמש – אורח במהלך היצירה

ephemeral boolean: הפעלת סימון המשתמש באופן זמני במהלך היצירה

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

קליעות
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

קליעות
DeviceNotAvailableException

השבתה של KeyGuard

public void disableKeyguard ()

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

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

קליעות
DeviceNotAvailableException

DoFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

קליעות
DeviceNotAvailableException

DoFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int: מזהה המשתמש שבאמצעותו צריך לבדוק את קיומו של הקובץ

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

קליעות
DeviceNotAvailableException

עריסות

public File dumpHeap (String process, 
                String devicePath)

נסה למחוק את הערימה מה-system_server. באחריות המתקשר/ת לבצע ניקיון את הקובץ שהורד.

פרמטרים
process String: שם התהליך במכשיר שאליו רוצים לבצע את ה-Dumpheap.

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

החזרות
File ERROR(/File) שמכיל את הדוח. המערכת תציג ערך של null אם משהו נכשל.

קליעות
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

החזרות
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

מזהי getAndroidId

public  getAndroidIds ()

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

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

קליעות
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

פרמטרים
packageName String

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

קליעות
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

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

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

קליעות
DeviceNotAvailableException

דוח getBugreport

public InputStreamSource getBugreport ()

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

מובטח שההטמעה תמשיך לפעול במכשיר ללא כרטיס sdcard (או כשכרטיס ה-sdcard עדיין לא נטען).

החזרות
InputStreamSource InputStreamSource שיפיק את התוכן של דוח איתור הבאגים על פי דרישה. לחשבון במקרה של כשל, הפונקציה InputStreamSource תפיק ERROR(/InputStream) ריק.

getBugreportz

public InputStreamSource getBugreportz ()

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

נתמך רק עבור 'גרסת adb' > 1.0.36

החזרות
InputStreamSource InputStreamSource של קובץ ה-ZIP שמכיל את דוח הבאג, החזרת הערך null ב- במקרה של כשל.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

החזרות
DeviceFoldableState

קליעות
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

החזרות
int

קליעות
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

הפונקציה מחזירה את רשימת המצבים המתקפלים במכשיר. אפשר לקבל באמצעות הערך 'cmd device_state' מצבי הדפסה".

החזרות

קליעות
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

קליעות
DeviceNotAvailableException

getKeyGuardState

public KeyguardControllerState getKeyguardState ()

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

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

קליעות
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

הפונקציה מחזירה את מזהה המשתמש הראשי.

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

קליעות
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

קליעות
DeviceNotAvailableException

getMaxNumberOf runningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

קליעות
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

קליעות
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

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

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

קליעות
DeviceNotAvailableException

קבלת צילום מסך

public InputStreamSource getScreenshot ()

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

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

קליעות
DeviceNotAvailableException

קבלת צילום מסך

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

פרמטרים
format String: קובץ PNG נתמך, JPEG

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

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

קליעות
DeviceNotAvailableException

קבלת צילום מסך

public InputStreamSource getScreenshot (String format)

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

פרמטרים
format String: קובץ PNG נתמך, JPEG

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

קליעות
DeviceNotAvailableException

קבלת צילום מסך

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

קליעות
DeviceNotAvailableException

הגדרה

public String getSetting (String namespace, 
                String key)

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

פרמטרים
namespace String

key String

החזרות
String

קליעות
DeviceNotAvailableException

הגדרה

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

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

פרמטרים
userId int

namespace String

key String

החזרות
String הערך שמשויך למפתח namespace:של משתמש. המערכת תציג ערך של null אם לא ניתן למצוא אותו.

קליעות
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

קליעות
DeviceNotAvailableException

getUserflags

public int getUserFlags (int userId)

למצוא ולהחזיר את הדגלים של משתמש נתון. הסימונים מוגדרים ב-"android.content.pm.UserInfo" בכיתה בפרויקט קוד פתוח של Android.

פרמטרים
userId int

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

קליעות
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

החזרות
את הרשימה של UserInfo.

קליעות
DeviceNotAvailableException

getUserSeriesNumber

public int getUserSerialNumber (int userId)

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

פרמטרים
userId int

החזרות
int

קליעות
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

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

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

החזרות
boolean True אם התכונה נמצאת, אחרת False.

קליעות
DeviceNotAvailableException

חבילת התקנה

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 אם הפעולה בוצעה בהצלחה.

קליעות
DeviceNotAvailableException

חבילת התקנה

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 אם הפעולה בוצעה בהצלחה.

קליעות
DeviceNotAvailableException

חבילת התקנה

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 אם הפעולה בוצעה בהצלחה.

קליעות
DeviceNotAvailableException

התקנה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 אם הפעולה בוצעה בהצלחה.

קליעות
DeviceNotAvailableException

התקנה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 אם הפעולה בוצעה בהצלחה.

קליעות
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, 
                String... extraArgs)

פרמטרים
remoteApkPaths

reinstall boolean

extraArgs String

החזרות
String

קליעות
DeviceNotAvailableException

התקנה RemotePackages

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

פרמטרים
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

החזרות
String

קליעות
DeviceNotAvailableException

isAppEnumeration נתמך

public boolean isAppEnumerationSupported ()

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

החזרות
boolean True אם יש תמיכה בספירת אפליקציות, FALSE אם לא יש תמיכה בספירת אפליקציות

קליעות
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

מחזירה אם המכשיר משתמש במצב משתמש במערכת ללא GUI.

החזרות
boolean

קליעות
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

החזרות
boolean

קליעות
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

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

החזרות
boolean true אם יש תמיכה בריבוי משתמשים, FALSE אם יש תמיכה בריבוי משתמשים, אחרת

קליעות
DeviceNotAvailableException

isPackageInstalled (בהתקנה)

public boolean isPackageInstalled (String packageName)

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

פרמטרים
packageName String

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

קליעות
DeviceNotAvailableException

isPackageInstalled (בהתקנה)

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

קליעות
DeviceNotAvailableException

isUser running

public boolean isUserRunning (int userId)

בודקים אם משתמש מסוים פועל.

פרמטרים
userId int

החזרות
boolean הערך הוא True אם המשתמש פועל, בכל מקרה אחר הערך False.

קליעות
DeviceNotAvailableException

isUsersecondary

public boolean isUserSecondary (int userId)

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

פרמטרים
userId int

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

קליעות
DeviceNotAvailableException

isUserצג

public boolean isUserVisible (int userId)

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

A "גלוי" הוא משתמש שמקיים אינטראקציה עם ולכן הוא יכול להפעיל פעילויות הפעלה (בדרך כלל בתצוגת ברירת המחדל).

פרמטרים
userId int

החזרות
boolean

קליעות
DeviceNotAvailableException

isUserVisibilityOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

פרמטרים
userId int

displayId int

החזרות
boolean

קליעות
DeviceNotAvailableException

isdisplayBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

הפונקציה מחזירה אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע ב-ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

אם כן, אפשר להתקשר אל startVisibleBackgroundUser(int, int, boolean), להעביר תצוגה שהוחזרה על ידי listDisplayIdsForStartingVisibleBackgroundUsers() (ש צריך לכלול את ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

החזרות
boolean

קליעות
DeviceNotAvailableException

isViewBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

אם כן, אפשר להתקשר אל startVisibleBackgroundUser(int, int, boolean), להעביר תצוגה שהוחזרה על ידי listDisplayIdsForStartingVisibleBackgroundUsers().

החזרות
boolean

קליעות
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

איסוף רשימת מזהי המסכים הזמינים במכשיר, כפי שדווח על ידי dumpsys SurfaceFlinger".

החזרות
רשימת המסכים. ברירת המחדל תמיד מחזירה את הערך 0 שמוגדר כברירת המחדל.

קליעות
DeviceNotAvailableException

listDisplayIdsForOutboundצגBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

קבלת רשימת המסכים שבהם אפשר להשתמש כדי start a user visible in the background.

החזרות

קליעות
DeviceNotAvailableException

listUsers

public  listUsers ()

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

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

קליעות
DeviceNotAvailableException

דוח 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.

קליעות
DeviceNotAvailableException

הסרת בעלים

public void removeOwners ()

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

קליעות
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

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

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

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

קליעות
DeviceNotAvailableException

setDeviceOwner (הבעלים של המכשיר)

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

החזרות
boolean True אם היא מצליחה, אחרת False.

קליעות
DeviceNotAvailableException

הגדרה

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

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

פרמטרים
namespace String

key String

value String

קליעות
DeviceNotAvailableException

הגדרה

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

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

פרמטרים
userId int

namespace String

key String

value String

קליעות
DeviceNotAvailableException

כיבוי של Microdroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

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

פרמטרים
microdroidDevice ITestDevice

קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

startUser

public boolean startUser (int userId)

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

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

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

קליעות
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

קליעות
DeviceNotAvailableException

start visibilityBackgroundUser

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

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

הערה: הפקודה הזו לא בודקת אם המשתמש קיים, שהתצוגה זמינה, device supports such feature וכו'.

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

displayId int: תצוגה שהמשתמשים יכולים להתחיל לראות בה

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

החזרות
boolean true אם המשתמש הופעל ברקע.

קליעות
DeviceNotAvailableException

stopUser

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

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

פרמטרים
userId int: של המשתמש כדי להפסיק.

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

forceFlag boolean: סגירה ידנית של פעולת המשתמש.

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

קליעות
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

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

פרמטרים
userId int: של המשתמש כדי להפסיק.

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

קליעות
DeviceNotAvailableException

תמיכה ב-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).

פרמטרים
userId int

החזרות
boolean הערך הוא True אם ה-User-ID החדש תואם לספק ה-User-ID. אחרת, שקרית.

קליעות
DeviceNotAvailableException

מתג משתמש

public boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
userId int

timeout long: להמתין לפני החזרת FALSE למשתמש-החלפה נכשלה.

החזרות
boolean הערך הוא True אם ה-User-ID החדש תואם לספק ה-User-ID. אחרת, שקרית.

קליעות
DeviceNotAvailableException

takeBugreport

public Bugreport takeBugreport ()

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

החזרות
Bugreport

הסרת החבילה

public String uninstallPackage (String packageName)

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

פרמטרים
packageName String: חבילת Android שיש להסיר

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

קליעות
DeviceNotAvailableException

removePackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

פרמטרים
packageName String: חבילת Android שיש להסיר

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

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

קליעות
DeviceNotAvailableException

להמתין ל-Snapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

פרמטרים
currentPhase SnapuserdWaitPhase

קליעות
DeviceNotAvailableException

שיטות מוגנות

CreateParser

protected AaptParser createParser (File appFile)

פרמטרים
appFile File

החזרות
AaptParser

doAdbRe

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

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

פרמטרים
rebootMode NativeDevice.RebootMode: מצב של ההפעלה מחדש.

reason String: להפעלה מחדש.

קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getBugreportפנימי

protected InputStreamSource getBugreportInternal ()

החזרות
InputStreamSource

getBugreportzinternal

protected File getBugreportzInternal ()

שיטת 'עוזר דיגיטלי' עוזרת לקבל את קובץ ה-ZIP של דוח איתור הבאגים בתור ERROR(/File).

החזרות
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

חשיפה לבדיקה.

החזרות
long

getHostCurrentTime

protected long getHostCurrentTime ()

חשיפה לבדיקה

החזרות
long

הגדרת טרום-PostBoot

protected void prePostBootSetup ()

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

קליעות
DeviceNotAvailableException