החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

דף זה תורגם על ידי 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` כלי שמשמש ליצירת Microdroid TestDevice.

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

Constructors ציבוריים
`TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)`

‫methods ציבוריים
`boolean`	`canSwitchToHeadlessSystemUser()` הפונקציה מחזירה את הערך True אם מותר לעבור למשתמש המערכת ללא ממשק גרפי, אחרת היא מחזירה את הערך False.
`boolean`	`clearErrorDialogs()` מנסים לסגור את כל תיבות הדו-שיח של השגיאות שמוצגות כרגע בממשק המשתמש של המכשיר.
`int`	`createUser(String name)` יוצרים משתמש עם שם נתון ודגלי ברירת מחדל 0.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` יצירת משתמש עם שם נתון והדגלים שצוינו
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` יצירת משתמש עם שם נתון והדגלים שצוינו
`int`	`createUserNoThrow(String name)` יוצרים משתמש עם שם נתון ודגלי ברירת מחדל 0.
`void`	`disableKeyguard()` ניסיונות להשבית את מסך הנעילה.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` שיטת עזר שקובעת אם קובץ במכשיר קיים עבור משתמש מסוים.
`boolean`	`doesFileExist(String deviceFilePath)` שיטת עזר לקביעה אם קובץ קיים במכשיר.
`File`	`dumpHeap(String process, String devicePath)` לנסות ליצור dump של ה-heap מ-system_server.
	`getActiveApexes()` שליפת המידע על חבילות APEX שהופעלו במכשיר.
	`getAllSettings(String namespace)` הפונקציה מחזירה צמדי מפתח/ערך של מרחב השמות המבוקש.
`String`	`getAndroidId(int userId)` הפונקציה מחפשת ומחזירה את מזהה Android שמשויך ל-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()` קבלת מידע על מודולי ה-Mainline שמותקנים במכשיר.
`int`	`getMaxNumberOfRunningUsersSupported()` קבלת המספר המקסימלי של משתמשים שנתמכים בהרצה בו-זמנית.
`int`	`getMaxNumberOfUsersSupported()` לקבל את המספר המקסימלי של משתמשים נתמכים.
`Integer`	`getPrimaryUserId()` מחזירה את מזהה המשתמש הראשי.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` מצלם צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot(long displayId)` מצלם צילום מסך מהמכשיר לפי מזהה התצוגה שצוין.
`InputStreamSource`	`getScreenshot(String format)` מצלם צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot()` מצלם צילום מסך מהמכשיר.
`String`	`getSetting(int userId, String namespace, String key)` הפונקציה מחזירה את הערך של ההגדרה המבוקשת.
`String`	`getSetting(String namespace, String key)` מידע נוסף זמין במאמר בנושא `getSetting(int, String, String)`.
	`getUninstallablePackageNames()` שליפת שמות החבילות של האפליקציות שאפשר להסיר.
`int`	`getUserFlags(int userId)` חיפוש הדגלים של משתמש מסוים והחזרתם.
	`getUserInfos()` מקבל את המיפוי של useId אל `UserInfo` במכשיר.
`int`	`getUserSerialNumber(int userId)` הפונקציה מחזירה את המספר הסידורי שמשויך ל-userId אם הוא נמצא, או את הערך -10000 בכל מקרה אחר.
`boolean`	`hasFeature(String feature)` בודקים אם תכונה מסוימת זמינה במכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` התקנה של חבילת Android במכשיר.
`String`	`installPackage(File packageFile, File certFile, boolean reinstall, String... extraArgs)` התקנה של חבילת Android במכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקנה של חבילת Android במכשיר.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר עבור משתמש מסוים.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר עבור משתמש מסוים.
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` התקנת קובצי APK במצב מצטבר.
`String`	`installPackages( packageFiles, boolean reinstall, String... extraArgs)`
`String`	`installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)`
`String`	`installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)`
`String`	`installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)`
`String`	`installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`boolean`	`isAppEnumerationSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בספירת האפליקציות
`boolean`	`isHeadlessSystemUserMode()` הפונקציה מחזירה את הערך true אם המכשיר משתמש במצב משתמש ללא ממשק משתמש של מערכת, אחרת היא מחזירה את הערך false.
`boolean`	`isMainUserPermanentAdmin()` הפונקציה מחזירה את הערך true אם המשתמש הראשי הוא אדמין קבוע ואי אפשר למחוק אותו או להוריד את רמת ההרשאה שלו ללא אדמין.
`boolean`	`isMultiUserSupported()` קובעת אם יש תמיכה במשתמשים מרובים.
`boolean`	`isPackageInstalled(String packageName, String userId)` שליחת שאילתה למכשיר לגבי שם חבילה ומזהה משתמש מסוימים כדי לבדוק אם האפליקציה מותקנת כרגע עבור המשתמש הזה.
`boolean`	`isPackageInstalled(String packageName)` שליחת שאילתה למכשיר לגבי שם חבילה מסוים כדי לבדוק אם החבילה מותקנת כרגע או לא.
`boolean`	`isUserRunning(int userId)` בודקים אם משתמש מסוים מפעיל את האפליקציה.
`boolean`	`isUserSecondary(int userId)` הפונקציה מחזירה אם המשתמש שצוין הוא משתמש משני לפי הסימון שלו.
`boolean`	`isUserVisible(int userId)` בודקת אם המשתמש הנתון גלוי.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` בודקת אם המשתמש הנתון גלוי בתצוגה הנתונה.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` הפונקציה מחזירה את הערך true אם המשתמשים יכולים להפעיל את המכשיר כשהוא פועל ברקע ב-`ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`, אחרת היא מחזירה את הערך false.
`boolean`	`isVisibleBackgroundUsersSupported()` הפונקציה מחזירה את הערך true אם המשתמשים יכולים להפעיל את המכשיר ברקע, ואת הערך false אם לא.
	`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`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` להפסיק את השימוש של משתמש מסוים.
`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

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

ערך קבוע: ‎"input keyevent 82"‎

Constructors ציבוריים

TestDevice

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

‫methods ציבוריים

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

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

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

פרמטרים
`name`	‫`String`: של המשתמש שרוצים ליצור במכשיר
`guest`	‫`boolean`: הפעלת דגל המשתמש --guest במהלך היצירה
`ephemeral`	‫`boolean`: הפעלת דגל המשתמש ‎--ephemeral במהלך היצירה

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

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, 
                int userId)

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

פרמטרים
`deviceFilePath`	‫`String`: הנתיב המוחלט של הקובץ במכשיר לבדיקה
`userId`	`int`: מזהה המשתמש שביחס אליו צריך לבדוק אם הקובץ קיים

החזרות
`boolean`	‫`true` if file exists, `false` otherwise.

זריקות
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

החזרות
`boolean`	‫`true` if file exists, `false` otherwise.

זריקות
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

לנסות ליצור dump של ה-heap מ-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 שמשויך ל-userId, או 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 שגדולה מ-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` שמכיל תמונת מצב של מסך הנעילה, ומחזירה Null אם שאילתת מסך הנעילה לא נתמכת.

זריקות
`DeviceNotAvailableException`

getMainUserId

public Integer getMainUserId ()

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

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

זריקות
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

זריקות
`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 (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: extend the implementations above to support 'format' and 'rescale'

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

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

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

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

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

זריקות
`DeviceNotAvailableException`

getSetting

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

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

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

החזרות
`String`	הערך שמשויך למרחב השמות:מפתח של משתמש. אם לא נמצא, הערך הוא Null.

זריקות
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

מידע נוסף זמין במאמר בנושא getSetting(int, String, String).

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

החזרות
`String`

זריקות
`DeviceNotAvailableException`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

זריקות
`DeviceNotAvailableException`

getUserFlags

public int getUserFlags (int userId)

חיפוש הדגלים של משתמש מסוים והחזרתם. הדגלים מוגדרים במחלקה android.content.pm.UserInfo בפרויקט הקוד הפתוח של Android.

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

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

זריקות
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

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

החזרות
	רשימת אובייקטים של UserInfo.

זריקות
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

הפונקציה מחזירה את המספר הסידורי שמשויך ל-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, 
                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`

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`

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`

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`

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

התקנת קובצי APK במצב מצטבר.

פרמטרים
`apkFiles`	‫`File`: קובצי ה-APK להתקנה.
`extraArgs`	`String`
`userId`	`String`

החזרות
`boolean`

זריקות
`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, 
                int userId, 
                String... extraArgs)

פרמטרים
`packageFiles`
`reinstall`	`boolean`
`userId`	`int`
`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`

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

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

החזרות
`boolean`	הערך הוא true אם יש תמיכה בריבוי משתמשים, אחרת הוא false

זריקות
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

זריקות
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

פרמטרים
`packageName`	`String`

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

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

אם כן, אפשר לקרוא לפונקציה 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`: display to start user visible on
`waitFlag`	‫`boolean`: הפקודה תמתין עד שהמשתמש יופעל וייפתח.

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

זריקות
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

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

פרמטרים
`userId`	‫`int`: של המשתמש שרוצים לעצור.

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

זריקות
`DeviceNotAvailableException`

stopUser

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

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

פרמטרים
`userId`	‫`int`: של המשתמש שרוצים לעצור.
`waitFlag`	‫`boolean`: הפקודה תמתין עד שהמשתמש יופסק.
`forceFlag`	‫`boolean`: יגרום לסגירה בכוח של המשתמש.

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

זריקות
`DeviceNotAvailableException`

supportsMicrodroid

public boolean supportsMicrodroid ()

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

החזרות
`boolean`	הפונקציה מחזירה True אם התנאים המוקדמים מתקיימים, אחרת היא מחזירה False.

supportsMicrodroid

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 אם הפעולה switch-user נכשלה.

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

סיכום

כיתות במבנה היררכי

ערכים קבועים

Constructors ציבוריים

‫methods ציבוריים

שיטות מוגנות

ערכים קבועים

DISMISS_KEYGUARD_CMD

Constructors ציבוריים

TestDevice

‫methods ציבוריים

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

installPackageWithIncrementalMode

installPackages

installPackages

installPackagesForUser

installPackagesForUser

installRemotePackages

installRemotePackages

isAppEnumerationSupported

isHeadlessSystemUserMode

isMainUserPermanentAdmin

isMultiUserSupported

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

listDisplayIds

listDisplayIdsForStartingVisibleBackgroundUsers

listUsers

logBugreport

notifySnapuserd