החל משנת 2026, כדי להתאים למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור ולתרום ל-AOSP, צריך להשתמש ב-android-latest-release. הענף android-latest-release manifest תמיד יפנה לגרסה האחרונה שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 ציבוריים
`String`	`adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)` מתקינים חבילת Android במכשיר באמצעות פקודת adb.
`String`	`adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` מתקינים חבילת Android במכשיר באמצעות פקודת adb.
`boolean`	`canSwitchToHeadlessSystemUser()` הפונקציה מחזירה את הערך True אם מותר לעבור למשתמש SYSTEM ללא ממשק גרפי, אחרת היא מחזירה את הערך 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.
`Set<ITestDevice.ApexInfo>`	`getActiveApexes()` שליפת המידע על חבילות APEX שהופעלו במכשיר.
`Map<String, String>`	`getAllSettings(String namespace)` הפונקציה מחזירה צמדי מפתח/ערך של מרחב השמות המבוקש.
`String`	`getAndroidId(int userId)` הפונקציה מחפשת ומחזירה את מזהה Android שמשויך ל-userId, או null אם לא נמצא מזהה.
`Map<Integer, String>`	`getAndroidIds()` יוצרים מיפוי של מזהי Android שנמצאו שתואמים למזהי משתמשים.
`PackageInfo`	`getAppPackageInfo(String packageName)` שליפת מידע על חבילה שמותקנת במכשיר.
`List<PackageInfo>`	`getAppPackageInfos()` אחזור מידע על חבילות שמותקנות במכשיר.
`InputStreamSource`	`getBugreport()` הפעולה מאחזרת דוח באגים מהמכשיר.
`InputStreamSource`	`getBugreportz()` מאחזר bugreportz מהמכשיר.
`DeviceFoldableState`	`getCurrentFoldableState()` מחזירה את המצב הנוכחי של המכשיר המתקפל או null אם התרחשו בעיות מסוימות.
`int`	`getCurrentUser()` החזרת המזהה של המשתמש שמפעיל את הפונקציה.
`Set<DeviceFoldableState>`	`getFoldableStates()` מחזירה את רשימת המצבים של מכשירים מתקפלים.
`Set<String>`	`getInstalledPackageNames()` אחזור של שמות החבילות של האפליקציות שקיימות במכשיר.
`KeyguardControllerState`	`getKeyguardState()` מחזירה אובייקט כדי לקבל את המצב הנוכחי של מסך הנעילה, או null אם לא אפשרי.
`Integer`	`getMainUserId()` הפונקציה מחזירה את מזהה המשתמש הראשי.
`Set<String>`	`getMainlineModuleInfo()` לקבל מידע על מודולי ה-Mainline שמותקנים במכשיר.
`int`	`getMaxNumberOfRunningUsersSupported()` קבלת המספר המקסימלי של משתמשים שנתמכים בהפעלה בו-זמנית.
`int`	`getMaxNumberOfUsersSupported(String userType)` אחזור המספר המקסימלי של משתמשים נתמכים מסוג משתמש ספציפי.
`int`	`getMaxNumberOfUsersSupported()` מקבלים את המספר המקסימלי של משתמשים שניתן להוסיף, לא כולל אורחים.
`Integer`	`getPrimaryUserId()` הפונקציה מחזירה את מזהה המשתמש הראשי.
`int`	`getRemainingCreatableUserCount(String userType)` הפונקציה מחזירה את מספר המשתמשים מסוג המשתמש שצוין שאפשר ליצור במכשיר הזה.
`InputStreamSource`	`getScreenshot(Long displayId, String format, boolean rescale)` יוצר צילום מסך ממזהה התצוגה שצוין במכשיר בפורמט נתמך.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` מצלם צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot(String format)` מצלם צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot(long displayId)` מצלם צילום מסך מהמכשיר לפי מזהה התצוגה שצוין.
`InputStreamSource`	`getScreenshot()` מצלם צילום מסך מהמכשיר.
`String`	`getSetting(int userId, String namespace, String key)` הפונקציה מחזירה את הערך של ההגדרה המבוקשת.
`String`	`getSetting(String namespace, String key)` אפשר לראות את `getSetting(int,String,String)` שבוצעה על משתמש המערכת.
`Set<String>`	`getUninstallablePackageNames()` שליפת שמות החבילות של האפליקציות שאפשר להסיר.
`int`	`getUserFlags(int userId)` חיפוש הדגלים של משתמש מסוים והחזרתם.
`Map<Integer, UserInfo>`	`getUserInfos()` מקבל את המיפוי של useId ל-`UserInfo` במכשיר.
`int`	`getUserSerialNumber(int userId)` הפונקציה מחזירה את המספר הסידורי שמשויך ל-userId אם הוא נמצא, או את הערך -10000 בכל מקרה אחר.
`int`	`getUserVisibleOnDisplay(int displayId)` מחזירה את מזהה המשתמש של המשתמש הגלוי בתצוגה הנתונה.
`boolean`	`hasFeature(String feature)` בודקים אם תכונה מסוימת זמינה במכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקנה של חבילת Android במכשיר.
`String`	`installPackage(File packageFile, 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 במכשיר עבור משתמש מסוים.
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` התקנה של קובצי APK במצב מצטבר.
`String`	`installPackages(List<File> packageFiles, boolean reinstall, String... extraArgs)`
`String`	`installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)`
`String`	`installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)`
`String`	`installPackagesForUser(List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)`
`boolean`	`isAppEnumerationSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
`boolean`	`isHeadlessSystemUserMode()` הפונקציה מחזירה את הערך true אם המכשיר משתמש במצב משתמש ללא ממשק משתמש של מערכת, אחרת היא מחזירה את הערך false.
`boolean`	`isMainUserPermanentAdmin()` הפונקציה מחזירה ערך בוליאני שקובע אם המשתמש הראשי הוא אדמין קבוע, ואי אפשר למחוק אותו או להוריד את הרמה שלו ללא הרשאות אדמין.
`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 אם לא.
`Set<Long>`	`listDisplayIds()` אוספים את רשימת מזהי המסכים הזמינים במכשיר כפי שמדווח על ידי dumpsys SurfaceFlinger.
`Set<Integer>`	`listDisplayIdsForStartingVisibleBackgroundUsers()` מקבל את רשימת המסכים שאפשר להשתמש בהם בשביל `start a user visible in the background`.
`ArrayList<Integer>`	`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 כ-`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 ציבוריים

adbInstallPackage

public String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

מתקינים חבילת Android במכשיר באמצעות פקודת adb.

פרמטרים
`packageFile`	‫`File`: קובץ ה-APK להתקנה
`reinstall`	`boolean`: `true` אם צריך לבצע התקנה מחדש
`extraArgs`	‫`String`: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm -h.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

adbInstallPackage

public String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

מתקינים חבילת Android במכשיר באמצעות פקודת adb.

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

פרמטרים
`packageFile`	‫`File`: קובץ ה-APK להתקנה
`reinstall`	`boolean`: `true` אם צריך לבצע התקנה מחדש
`grantPermissions`	‫`boolean`: אם צריך להעניק את כל ההרשאות בזמן הריצה בזמן ההתקנה
`extraArgs`	‫`String`: ארגומנטים נוספים אופציונליים להעברה. אפשר לעיין באפשרויות הזמינות באמצעות הפקודה adb shell pm -h.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

createUser

public int createUser (String name)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`
`IllegalStateException`

createUser

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

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`
`IllegalStateException`

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`	המזהה של המשתמש שנוצר

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`
`IllegalStateException`

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

ניסיונות להשבית את מסך הנעילה.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

לנסות ליצור dump של ה-heap מ-system_server. באחריות המתקשר לנקות את הקובץ שנוצר.

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

החזרות
`File`	השדה `File` שמכיל את הדוח. ‫Null אם משהו נכשל.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getActiveApexes

public Set<ITestDevice.ApexInfo> getActiveApexes ()

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

החזרות
`Set<ITestDevice.ApexInfo>`	`Set` מתוך `ApexInfo` מופעלים כרגע במכשיר

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getAllSettings

public Map<String, String> getAllSettings (String namespace)

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

פרמטרים
`namespace`	‫`String`: הערך חייב להיות אחד מהערכים הבאים: {"system", "secure", "global"}

החזרות
`Map<String, String>`	המפה של צמדי מפתח/ערך. הערך הוא Null אם מרחב השמות לא נתמך.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getAndroidId

public String getAndroidId (int userId)

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

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

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getAndroidIds

public Map<Integer, String> getAndroidIds ()

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

החזרות
`Map<Integer, String>`	מפה של מזהי Android שנמצאו בהתאמה למזהי משתמשים.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getAppPackageInfos

public List<PackageInfo> getAppPackageInfos ()

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

החזרות
`List<PackageInfo>`	`List` מתוך `PackageInfo` אפליקציות מותקנות במכשיר.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

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

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

החזרות
`InputStreamSource`	קובץ `InputStreamSource` שייצור את תוכן דוח הבאגים לפי דרישה. במקרה של כשל, הפונקציה `InputStreamSource` תיצור מחרוזת ריקה `InputStream`.

getBugreportz

public InputStreamSource getBugreportz ()

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

התמיכה קיימת רק בגרסה 'adb version' > 1.0.36

החזרות
`InputStreamSource`	‫`InputStreamSource` של קובץ ה-ZIP שמכיל את bugreportz, מחזירה null במקרה של כשל.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

החזרות
`DeviceFoldableState`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

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

החזרות
`int`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getFoldableStates

public Set<DeviceFoldableState> getFoldableStates ()

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

החזרות
`Set<DeviceFoldableState>`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getInstalledPackageNames

public Set<String> getInstalledPackageNames ()

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

החזרות
`Set<String>`	‫`Set` מתוך `String` שמות חבילות שמותקנות כרגע במכשיר.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getMainUserId

public Integer getMainUserId ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getMainlineModuleInfo

public Set<String> getMainlineModuleInfo ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported (String userType)

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

פרמטרים
`userType`	‫`String`: סוג המשתמש, כפי שמוגדר ב-UserManager, למשל ‫android.os.usertype.full.SECONDARY.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

מקבלים את המספר המקסימלי של משתמשים שניתן להוסיף, לא כולל אורחים. אחרי גרסה 36 של ה-API, לא כולל משתמשים שלא ניתן להחליף (כמו פרופילים). ברירת המחדל היא 0.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getRemainingCreatableUserCount

public int getRemainingCreatableUserCount (String userType)

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

פרמטרים
`userType`	‫`String`: סוג המשתמש, כפי שמוגדר ב-UserManager, למשל ‫android.os.usertype.full.SECONDARY.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

TODO: extend the implementations above to support 'format' and 'rescale'

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getSetting

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

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

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

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

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getUninstallablePackageNames

public Set<String> getUninstallablePackageNames ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getUserFlags

public int getUserFlags (int userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getUserInfos

public Map<Integer, UserInfo> getUserInfos ()

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

החזרות
`Map<Integer, UserInfo>`	רשימת אובייקטים של UserInfo.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

החזרות
`int`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

getUserVisibleOnDisplay

public int getUserVisibleOnDisplay (int displayId)

מחזירה את מזהה המשתמש של המשתמש הגלוי בתצוגה הנתונה.

פרמטרים
`displayId`	‫`int`: מזהה המסך.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

hasFeature

public boolean hasFeature (String feature)

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

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

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

הקפצת הודעות שגיאה (throw)
`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` אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
`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` אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
`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` אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
`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` אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

installPackageWithIncrementalMode

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

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

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

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                String... extraArgs)

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

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

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

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

פרמטרים
`packageFiles`	`List`
`reinstall`	`boolean`
`grantPermissions`	`boolean`
`userId`	`int`
`extraArgs`	`String`

החזרות
`String`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

החזרות
`boolean`	הערך True אם ספירת האפליקציות נתמכת, אחרת הערך False

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

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

שימו לב: גם אם המדיניות מוגדרת כ-False, יכול להיות שעדיין אפשר יהיה להשתמש בכמה משתמשים, כל עוד לא נדרש ממשק משתמש לכניסה. לדוגמה, יכול להיות שעדיין תהיה תמיכה בפרופילים, כי הם לא דורשים ממשק משתמש לכניסה.

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

החזרות
`boolean`	האם המכשיר תומך בכמה משתמשים שאפשר לעבור ביניהם.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isUserRunning

public boolean isUserRunning (int userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

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

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

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

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`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`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

listDisplayIds

public Set<Long> listDisplayIds ()

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

החזרות
`Set<Long>`	רשימת המסכים. הפונקציה Default תמיד מחזירה את תצוגת ברירת המחדל 0.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

החזרות
`Set<Integer>`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

listUsers

public ArrayList<Integer> listUsers ()

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

החזרות
`ArrayList<Integer>`	רשימת מזהי המשתמשים.

הקפצת הודעות שגיאה (throw)
`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.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

הסרת משתמש מסוים מהמכשיר.

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

החזרות
`boolean`	‫True אם הפעולה הצליחה, אחרת False.

הקפצת הודעות שגיאה (throw)
`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`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

setSetting

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

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

פרמטרים
`microdroidDevice`	`ITestDevice`

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

הקפצת הודעות שגיאה (throw)
`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` אם המשתמש התחיל בהצלחה את הצפייה ברקע.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

stopUser

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

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

supportsMicrodroid

public boolean supportsMicrodroid ()

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

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

הקפצת הודעות שגיאה (throw)
`Exception`

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
`userId`	`int`
`timeout`	‫`long`: להמתנה לפני החזרת הערך false אם הפעולה switch-user נכשלה.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

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

החזרות
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

פרמטרים
`packageName`	‫`String`: חבילת Android להסרה
`userId`	‫`int`: מזהה המשתמש כמספר שלם שרוצים להסיר את ההתקנה שלו.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

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

הקפצת הודעות שגיאה (throw)
`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`: להפעלה מחדש הזו.

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

החזרות
`InputStreamSource`

getBugreportzInternal

protected File getBugreportzInternal ()

שיטת עזר פנימית לקבלת קובץ ה-ZIP של bugreportz כ-File.

החזרות
`File`

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

חשוף לבדיקה.

החזרות
`long`

getHostCurrentTime

protected long getHostCurrentTime ()

נחשפו לבדיקה

החזרות
`long`

prePostBootSetup

protected void prePostBootSetup ()

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

TestDevice

סיכום

כיתות מוטמעות

ערכים קבועים

‫constructors ציבוריים

‫methods ציבוריים

שיטות מוגנות

ערכים קבועים

DISMISS_KEYGUARD_CMD

‫constructors ציבוריים

TestDevice

‫methods ציבוריים

adbInstallPackage

adbInstallPackage

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

getMaxNumberOfUsersSupported

getPrimaryUserId

getRemainingCreatableUserCount

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

getUserVisibleOnDisplay

hasFeature

installPackage

installPackage

installPackageForUser

installPackageForUser

installPackageWithIncrementalMode

installPackages

installPackages

installPackagesForUser

installPackagesForUser

isAppEnumerationSupported

isHeadlessSystemUserMode

isMainUserPermanentAdmin

isMultiUserSupported

isPackageInstalled

isPackageInstalled

isUserRunning

isUserSecondary

isUserVisible

isUserVisibleOnDisplay

isVisibleBackgroundUsersOnDefaultDisplaySupported

isVisibleBackgroundUsersSupported

listDisplayIds

listDisplayIdsForStartingVisibleBackgroundUsers