דף זה תורגם על ידי 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	הכיתה של מכשירים וירטואליים מקומיים שפועלים במארח של TradeFed.
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 שמשויך למשתמש, או 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()` הפונקציה מחזירה אם המשתמש הראשי הוא אדמין קבוע ולא ניתן למחוק אותו או לשדרג לאחור את הסטטוס שלו לסטטוס 'לא אדמין'.
`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`	`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)

ניסיון לדמפ את האוסף (heap) מ-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 ()

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

החזרות
	`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 שמכיל את bugreportz, מחזירה 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`

getMaxNumberOfRunningUsersSupported

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

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

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

החזרות
`String`

זריקות
`DeviceNotAvailableException`

installPackages

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 אם החבילה מדווחת כמתקנת. אחרת, הערך יהיה false.

זריקות
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

זריקות
`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 ()

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

אם כן, אפשר לקרוא לפונקציה 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`

removeOwners

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`

setFirstBootloaderReboot

public void setFirstBootloaderReboot ()

setSetting

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

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

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

זריקות
`DeviceNotAvailableException`

setSetting

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

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

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

זריקות
`DeviceNotAvailableException`

shutdownMicrodroid

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`

תמיכה ב-Microdroid

public boolean supportsMicrodroid ()

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

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

תמיכה ב-Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

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

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

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

switchUser

public boolean switchUser (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
`userId`	`int`
`timeout`	`long`: כדי להמתין לפני החזרת הערך false במקרה של כשל במעבר משתמש.

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

זריקות
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

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

החזרות
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

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

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

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

זריקות
`DeviceNotAvailableException`

uninstallPackageForUser

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`

doAdbReboot

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

dumpHeap

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

getBugreport

getBugreportz

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getKeyguardState

getMainUserId

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getPrimaryUserId

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

hasFeature

installPackage

installPackage

installPackage

installPackageForUser

installPackageForUser

installPackages

installPackages

installPackagesForUser

installPackagesForUser

installRemotePackages

installRemotePackages

isAppEnumerationSupported

isHeadlessSystemUserMode

isMainUserPermanentAdmin

isMultiUserSupported

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

listDisplayIds

listDisplayIdsForStartingVisibleBackgroundUsers

listUsers

logBugreport

notifySnapuserd

postInvocationTearDown