דף זה תורגם על ידי Cloud Translation API.

TestDevice

public class TestDevice
extends NativeDevice

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

תת-כיתות ישירות ידועות

ManagedRemoteDevice, ‏ NestedRemoteDevice, ‏ RemoteAndroidDevice

ManagedRemoteDevice	מכשיר שפועל בתוך מכונה וירטואלית שאנחנו מנהלים מרחוק באמצעות מכונה של Tradefed בתוך המכונה הווירטואלית.
NestedremoteDevice	ייצוג של המכשיר שפועל בתוך מכונה וירטואלית מרוחקת של Cuttlefish.
RemoteAndroidDevice	הטמעה של `ITestDevice` במכשיר Android עם סטאק מלא שמחובר באמצעות adb connect.

תת-כיתות עקיפות ידועות

LocalAndroidVirtualDevice, ‏ RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	המחלקה למכשירים וירטואליים מקומיים שפועלים ב-TrendFed Host.
RemoteAndroidVirtualDevice	הרחבה של התנהגות `RemoteAndroidDevice` למכשיר Android עם סטאק מלא שפועל ב-Google Compute Engine‏ (GCE).

הטמעה של 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)` ניסיון לדמפ את האוסף (heap) מ-system_server.
	`getActiveApexes()` אחזור המידע על ה-APEXes שהופעלו במכשיר.
	`getAllSettings(String namespace)` הפונקציה מחזירה צמדי מפתח/ערך של מרחב השמות המבוקש.
`String`	`getAndroidId(int userId)` חיפוש והחזרת android-id המשויך ל-userId, 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()` הפונקציה מחזירה את הערך 'true' אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע.
	`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)` בדיקת התנאים המוקדמים להרצת 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`

עריסות

public File dumpHeap (String process, 
                String devicePath)

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

פרמטרים
`process`	`String`: השם של תהליך המכשיר שבו רוצים ליצור dumpheap.
`devicePath`	`String`: הנתיב במכשיר שבו רוצים להציב את האימג'. זה חייב להיות מיקום שבו ההרשאות מאפשרות זאת.

החזרות
`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 שמשויך למשתמש, ערך 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 ()

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

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

זריקות
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

יש תמיכה רק ב-'adb version' > 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 print-states".

החזרות

זריקות
`DeviceNotAvailableException`

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

זריקות
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

החזרות
`KeyguardControllerState`	`KeyguardControllerState` שמכיל קובץ snapshot של מצב מסך הנעילה, ומחזיר Null אם השאילתה של מסך הנעילה לא נתמכת.

קליעות
`DeviceNotAvailableException`

getMainUserId

public Integer getMainUserId ()

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

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

זריקות
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

זריקות
`DeviceNotAvailableException`

getMaxNumberOfRunUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

קליעות
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

זריקות
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

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

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

קליעות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

פרמטרים
`format`	`String`: פורמטים נתמכים: PNG, ‏ JPEG
`rescale`	`boolean`: אם צריך לשנות את גודל המסך כדי להקטין את גודל התמונה שמתקבלת

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

TODO: להרחיב את ההטמעות שלמעלה כך שתהיה תמיכה ב-'format' וב-'rescale'

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

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

פרמטרים
`format`	`String`: פורמטים נתמכים: PNG, ‏ JPEG

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

קליעות
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

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

פרמטרים
`namespace`	`String`
`key`	`String`

החזרות
`String`

זריקות
`DeviceNotAvailableException`

getSetting

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

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

פרמטרים
`userId`	`int`
`namespace`	`String`
`key`	`String`

החזרות
`String`	הערך שמשויך למפתח namespace:של משתמש. הערך 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`

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

פרמטרים
`userId`	`int`

החזרות
`int`

זריקות
`DeviceNotAvailableException`

hasFeature

public boolean hasFeature (String feature)

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

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

החזרות
`boolean`	הערך True אם התכונה נמצאה, ו-False אם לא.

זריקות
`DeviceNotAvailableException`

installPackage

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`

installPackage

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`

installPackage

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`

installPackageForUser

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`

installPackageForUser

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`

installRemotePackages

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

פרמטרים
`remoteApkPaths`
`reinstall`	`boolean`
`extraArgs`	`String`

החזרות
`String`

זריקות
`DeviceNotAvailableException`

installRemotePackages

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

פרמטרים
`remoteApkPaths`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`extraArgs`	`String`

החזרות
`String`

זריקות
`DeviceNotAvailableException`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

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

זריקות
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

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

isUserRunning

public boolean isUserRunning (int userId)

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

פרמטרים
`userId`	`int`

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

זריקות
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

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

פרמטרים
`userId`	`int`

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

זריקות
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

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

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

פרמטרים
`userId`	`int`

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

פרמטרים
`userId`	`int`
`displayId`	`int`

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

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

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

זריקות
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

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.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

פרמטרים
`waitPhase`	`SnapuserdWaitPhase`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

פרמטרים
`exception`	`Throwable`: אם יש כזה, חריגה סופית שהופיעה כתוצאה מהכשל בהפעלה.

removeAdmin

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`

setSetting

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.DeviceNotAvailableException
`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`

startVisibleBackgroundUser

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`

supportsMicrodroid

public boolean supportsMicrodroid ()

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

החזרות
`boolean`	מחזירה True אם התנאים המוקדמים מתקיימים, ו-false אם לא.

תמיכה ב-Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

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

פרמטרים
`protectedVm`	`boolean`: true אם microdroid מיועד לפעול במכונה וירטואלית מוגנת.

החזרות
`boolean`	הפונקציה מחזירה את הערך true אם התנאים המוקדמים מתקיימים, ואת הערך false אחרת.

מתג משתמש

public boolean switchUser (int userId)

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

פרמטרים
`userId`	`int`

החזרות
`boolean`	הערך True אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, הערך יהיה False.

זריקות
`DeviceNotAvailableException`

מתג משתמש

public boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
`userId`	`int`
`timeout`	`long`: כדי להמתין לפני החזרת הערך false עבור switch-user failed.

החזרות
`boolean`	הערך True אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, הערך יהיה False.

זריקות
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

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

החזרות
`Bugreport`

uninstallPackage

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`

waitForSnapuserd

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.DeviceNotAvailableException
`DeviceNotAvailableException`

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

החזרות
`InputStreamSource`

getBugreportzinternal

protected File getBugreportzInternal ()

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

החזרות
`File`

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

חשוף לבדיקה.

החזרות
`long`

getHostCurrentTime

protected long getHostCurrentTime ()

חשיפה לצורך בדיקה

החזרות
`long`

prePostBootSetup

protected void prePostBootSetup ()

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

זריקות
`DeviceNotAvailableException`

TestDevice

סיכום

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

שדות

יוצרים ציבוריים

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

שיטות מוגנות

שדות

DISMISS_KEYGUARD_CMD

יוצרים ציבוריים

TestDevice

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

canSwitchToHeadlessSystemUser

clearErrorDialogs

createUser

CreateUser

CreateUser

createUserNoThrow

disableKeyguard

doesFileExist

doesFileExist

עריסות

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

getBugreport

getBugreportz

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getKeyguardState

getMainUserId

getMainlineModuleInfo

getMaxNumberOfRunUsersSupported

getMaxNumberOfUsersSupported

getPrimaryUserId

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

hasFeature

installPackage

installPackage

installPackage

installPackageForUser

installPackageForUser

חבילות התקנה

חבילות התקנה

installPackagesForUser

installPackagesForUser

installRemotePackages

installRemotePackages

isAppEnumerationSupported

isHeadlessSystemUserMode

isMainUserPermanentAdmin

isMultiUserSupported

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

listDisplayIds

listDisplayIdsForStartingVisibleBackgroundUsers

listUsers

logBugreport

notifySnapuserd

postInvocationTearDown