החל משנת 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.

ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

מחלקות משנה לא ישירות מוכרות

‫IManagedTestDevice, ‏ LocalAndroidVirtualDevice, ‏ ManagedRemoteDevice, ‏ NativeDevice, ‏ NestedRemoteDevice, ‏ RemoteAndroidDevice, ‏ RemoteAndroidVirtualDevice, ‏ TestDevice

IManagedTestDevice	ממשק ITestDevice שמחזור החיים שלו מנוהל.
LocalAndroidVirtualDevice	הסיווג של מכשירים וירטואליים מקומיים שפועלים במארח TradeFed.
ManagedRemoteDevice	מכשיר שפועל בתוך מכונה וירטואלית שאנחנו מנהלים מרחוק באמצעות מופע Tradefed בתוך המכונה הווירטואלית.
NativeDevice	הטמעה כברירת מחדל של `ITestDevice` מכשירי Android שאינם full stack.
NestedRemoteDevice	ייצוג של המכשיר שפועל במכונה וירטואלית מרוחקת של Cuttlefish.
RemoteAndroidDevice	הטמעה של `ITestDevice` במכשיר Android עם מחסנית מלאה שמחובר באמצעות adb connect.
RemoteAndroidVirtualDevice	התכונה הזו מרחיבה את ההתנהגות של `RemoteAndroidDevice` במכשיר Android עם מחסנית מלאה שפועל ב-Google Compute Engine‏ (GCE).
TestDevice	הטמעה של `ITestDevice` במכשיר Android עם מחסנית מלאה

השירות הזה מספק API אמין וברמה קצת יותר גבוהה ל-ddmlib IDevice.

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

סיכום

כיתות מוטמעות
`class`	`ITestDevice.ApexInfo` מחלקה פשוטה של struct לאחסון מידע על APEX יחיד
`class`	`ITestDevice.MountPointInfo` מחלקה פשוטה של struct לאחסון מידע על נקודת טעינה יחידה

‫methods ציבוריים
`abstract String`	`adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)` מתקינים חבילת Android במכשיר באמצעות פקודת adb.
`abstract String`	`adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` מתקינים חבילת Android במכשיר באמצעות פקודת adb.
`abstract boolean`	`canSwitchToHeadlessSystemUser()` הפונקציה מחזירה את הערך True אם מותר לעבור למשתמש SYSTEM ללא ממשק גרפי, אחרת היא מחזירה את הערך False.
`abstract boolean`	`checkConnectivity()` בודקים שלמכשיר יש חיבור לרשת.
`abstract boolean`	`clearErrorDialogs()` מנסים לסגור את כל תיבות הדו-שיח של השגיאות שמוצגות כרגע בממשק המשתמש של המכשיר.
`abstract void`	`clearLastConnectedWifiNetwork()` מנקה את רשת ה-Wi-Fi האחרונה שהמכשיר התחבר אליה.
`default boolean`	`connectToWifiNetwork(Map<String, String> wifiSsidToPsk, boolean scanSsid)` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `connectToWifiNetworkWithResult(Map,boolean)`.
`default boolean`	`connectToWifiNetwork(Map<String, String> wifiSsidToPsk)` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `connectToWifiNetworkWithResult(Map)`.
`default boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `connectToWifiNetworkWithResult(String,String)`.
`default boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `connectToWifiNetworkWithResult(String,String,boolean)`.
`default boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` השיטה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב-`connectToWifiNetworkIfNeededWithResult(String,String,boolean)`.
`default boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `connectToWifiNetworkIfNeededWithResult(String,String)`.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` וריאציה של `connectToWifiNetwork(String,String)` שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)` וריאציה של `connectToWifiNetwork(String,String)` שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)` מתחבר לרשת Wi-Fi.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`abstract IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)` מתחבר לרשת Wi-Fi.
`abstract int`	`createUser(String name)` יוצרים משתמש עם שם נתון ודגלי ברירת מחדל 0.
`abstract int`	`createUser(String name, boolean guest, boolean ephemeral)` יצירת משתמש עם שם נתון והדגלים שצוינו
`abstract int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` יצירת משתמש עם שם נתון והדגלים שצוינו
`abstract int`	`createUserNoThrow(String name)` יוצרים משתמש עם שם נתון ודגלי ברירת מחדל 0.
`abstract void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` הסרת `IDeviceActionReceiver` הרשום.
`abstract void`	`disableKeyguard()` ניסיונות להשבית את מסך הנעילה.
`abstract boolean`	`disableNetworkMonitor()` השבתה של מעקב אחרי הרשת במכשיר.
`abstract boolean`	`disconnectFromWifi()` התנתקות מרשת Wi-Fi.
`abstract boolean`	`doesFileExist(String deviceFilePath, int userId)` שיטת עזר לקביעה אם קובץ במכשיר קיים עבור משתמש נתון.
`abstract File`	`dumpHeap(String process, String devicePath)` לנסות ליצור dump של ה-heap מ-system_server.
`abstract boolean`	`enableNetworkMonitor()` הגדרה שמאפשרת מעקב אחרי הרשת במכשיר.
`abstract Set<ITestDevice.ApexInfo>`	`getActiveApexes()` שליפת המידע על חבילות APEX שהופעלו במכשיר.
`abstract Map<String, String>`	`getAllSettings(String namespace)` הפונקציה מחזירה צמדי מפתח/ערך של מרחב השמות המבוקש.
`abstract String`	`getAndroidId(int userId)` הפונקציה מחפשת ומחזירה את מזהה Android שמשויך ל-userId, או null אם לא נמצא מזהה.
`abstract Map<Integer, String>`	`getAndroidIds()` יוצרים מיפוי של מזהי Android שנמצאו שתואמים למזהי משתמשים.
`abstract PackageInfo`	`getAppPackageInfo(String packageName)` שליפת מידע על חבילה שמותקנת במכשיר.
`abstract List<PackageInfo>`	`getAppPackageInfos()` אחזור מידע על חבילות שמותקנות במכשיר.
`abstract InputStreamSource`	`getBugreport()` הפעולה מאחזרת דוח באגים מהמכשיר.
`abstract InputStreamSource`	`getBugreportz()` מאחזר bugreportz מהמכשיר.
`abstract DeviceFoldableState`	`getCurrentFoldableState()` מחזירה את המצב הנוכחי של המכשיר המתקפל או null אם התרחשו בעיות מסוימות.
`abstract int`	`getCurrentUser()` החזרת המזהה של המשתמש שמפעיל את הפונקציה.
`abstract Set<DeviceFoldableState>`	`getFoldableStates()` מחזירה את רשימת המצבים של מכשירים מתקפלים.
`abstract Set<String>`	`getInstalledPackageNames()` אחזור של שמות החבילות של האפליקציות שקיימות במכשיר.
`abstract String`	`getIpAddress()` קבלת כתובת ה-IP של המכשיר.
`abstract KeyguardControllerState`	`getKeyguardState()` מחזירה אובייקט כדי לקבל את המצב הנוכחי של מסך הנעילה, או null אם לא אפשרי.
`abstract Integer`	`getMainUserId()` הפונקציה מחזירה את מזהה המשתמש הראשי.
`abstract Set<String>`	`getMainlineModuleInfo()` לקבל מידע על מודולי ה-Mainline שמותקנים במכשיר.
`abstract int`	`getMaxNumberOfRunningUsersSupported()` קבלת המספר המקסימלי של משתמשים שנתמכים בהפעלה בו-זמנית.
`abstract int`	`getMaxNumberOfUsersSupported(String userType)` אחזור המספר המקסימלי של משתמשים נתמכים מסוג משתמש ספציפי.
`abstract int`	`getMaxNumberOfUsersSupported()` השיטה הזו הוצאה משימוש. ‫use getMaxNumberOfUsersSupported(String userType) to obtain the max number of supported users for a given user type.
`abstract TestDeviceOptions`	`getOptions()` מאחזרים את אפשרויות הבדיקה של המכשיר.
`abstract Integer`	`getPrimaryUserId()` השיטה הזו הוצאה משימוש. הפונקציה getPrimaryUser הוצאה משימוש בשירות UserManager. צריך להשתמש בפונקציה `ERROR(/android.os.UserManager#getMainUserId())` כדי לקבל את המשתמש המלא הראשון או 0 למערכת. הערה: במערכת ללא ראש, המשתמש לא מלא.
`abstract int`	`getRemainingCreatableUserCount(String userType)` הפונקציה מחזירה את מספר המשתמשים מסוג המשתמש שצוין שאפשר ליצור במכשיר הזה.
`abstract InputStreamSource`	`getScreenshot(Long displayId, String format, boolean rescale)` יוצר צילום מסך ממזהה התצוגה שצוין במכשיר בפורמט נתמך.
`abstract InputStreamSource`	`getScreenshot(String format, boolean rescale)` מצלם צילום מסך מהמכשיר.
`abstract InputStreamSource`	`getScreenshot(String format)` מצלם צילום מסך מהמכשיר.
`abstract InputStreamSource`	`getScreenshot(long displayId)` מצלם צילום מסך מהמכשיר לפי מזהה התצוגה שצוין.
`abstract InputStreamSource`	`getScreenshot()` מצלם צילום מסך מהמכשיר.
`abstract String`	`getSetting(int userId, String namespace, String key)` הפונקציה מחזירה את הערך של ההגדרה המבוקשת.
`abstract String`	`getSetting(String namespace, String key)` מידע נוסף על `getSetting(int,String,String)` ועל פעולות שמתבצעות על משתמש מערכת
`abstract Set<String>`	`getUninstallablePackageNames()` שליפת שמות החבילות של האפליקציות שאפשר להסיר.
`abstract int`	`getUserFlags(int userId)` חיפוש הדגלים של משתמש מסוים והחזרתם.
`abstract Map<Integer, UserInfo>`	`getUserInfos()` מקבל את המיפוי של useId ל-`UserInfo` במכשיר.
`abstract int`	`getUserSerialNumber(int userId)` הפונקציה מחזירה את המספר הסידורי שמשויך ל-userId אם הוא נמצא, או את הערך -10000 בכל מקרה אחר.
`abstract int`	`getUserVisibleOnDisplay(int displayId)` מחזירה את מזהה המשתמש של המשתמש הגלוי בתצוגה הנתונה.
`abstract boolean`	`hasFeature(String feature)` בודקים אם תכונה מסוימת זמינה במכשיר.
`abstract String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקנה של חבילת Android במכשיר.
`abstract String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` התקנה של חבילת Android במכשיר.
`abstract String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר עבור משתמש מסוים.
`abstract String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר עבור משתמש מסוים.
`abstract boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` התקנה של קובצי APK במצב מצטבר.
`default String`	`installPackages(List<File> packageFiles, boolean reinstall, String... extraArgs)` התקנה של אפליקציה ל-Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות פיצול נוספות).
`default String`	`installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקנה של אפליקציה ל-Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות פיצול נוספות) שנמצאים במכשיר Android.
`default String`	`installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)` התקנה של אפליקציה ל-Android שמורכבת מכמה קובצי APK (אחד ראשי וחבילות פיצול נוספות) עבור משתמש מסוים.
`default String`	`installPackagesForUser(List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקנה של אפליקציה ל-Android שמורכבת מכמה קובצי APK (אחד ראשי וחבילות פיצול נוספות) עבור משתמש מסוים.
`abstract boolean`	`isHeadlessSystemUserMode()` הפונקציה מחזירה את הערך true אם המכשיר משתמש במצב משתמש ללא ממשק משתמש של מערכת, אחרת היא מחזירה את הערך false.
`abstract boolean`	`isMainUserPermanentAdmin()` הפונקציה מחזירה ערך בוליאני שקובע אם המשתמש הראשי הוא אדמין קבוע, ואי אפשר למחוק אותו או להוריד את הרמה שלו ללא הרשאות אדמין.
`abstract boolean`	`isMultiUserSupported()` הפונקציה מחזירה ערך בוליאני שמציין אם המכשיר תומך במספר משתמשים שאפשר לעבור ביניהם, שלכל אחד מהם יש פרטי כניסה משלו ומרחב שניתן להתאמה אישית.
`abstract boolean`	`isPackageInstalled(String packageName, String userId)` שליחת שאילתה למכשיר לגבי שם חבילה ומזהה משתמש מסוימים כדי לבדוק אם האפליקציה מותקנת כרגע עבור המשתמש הזה.
`abstract boolean`	`isPackageInstalled(String packageName)` שליחת שאילתה למכשיר לגבי שם חבילה מסוים כדי לבדוק אם החבילה מותקנת כרגע או לא.
`abstract boolean`	`isUserRunning(int userId)` בודקים אם משתמש מסוים מפעיל את האפליקציה.
`abstract boolean`	`isUserSecondary(int userId)` הפונקציה מחזירה אם המשתמש שצוין הוא משתמש משני לפי הסימון שלו.
`abstract boolean`	`isUserVisible(int userId)` בודקת אם המשתמש הנתון גלוי.
`abstract boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` בודקת אם המשתמש שצוין גלוי בתצוגה שצוינה.
`abstract boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` הפונקציה מחזירה את הערך true אם המשתמשים יכולים להפעיל את המכשיר כשהוא פועל ברקע ב-`ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`, אחרת היא מחזירה את הערך false.
`abstract boolean`	`isVisibleBackgroundUsersSupported()` הפונקציה מחזירה את הערך true אם המכשיר מאפשר למשתמשים להפעיל אפליקציות ברקע, ואת הערך false אם לא.
`abstract boolean`	`isWifiEnabled()` בודקים אם ה-Wi-Fi מופעל.
`abstract Set<Long>`	`listDisplayIds()` אוספים את רשימת מזהי המסכים הזמינים במכשיר כפי שמדווח על ידי dumpsys SurfaceFlinger.
`abstract Set<Integer>`	`listDisplayIdsForStartingVisibleBackgroundUsers()` מקבל את רשימת המסכים שאפשר להשתמש בהם בשביל `start a user visible in the background`.
`abstract ArrayList<Integer>`	`listUsers()` מקבל את רשימת המשתמשים במכשיר.
`abstract boolean`	`logBugreport(String dataName, ITestLogger listener)` שיטת עזר ליצירת דוח על באג ולתיעוד שלו בדוחות.
`default void`	`notifySnapuserd(SnapuserdWaitPhase waitPhase)` שולחים למכשיר הודעה להמתין לסיום של snapuserd.
`abstract void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` המדיניות הזו רושמת את `IDeviceActionReceiver` במכשיר הזה.
`abstract boolean`	`removeAdmin(String componentName, int userId)` מסיר את הרשאות האדמין במכשיר שצוין אצל המשתמש שצוין ומחזיר `true` אם הפעולה הצליחה, או `false` אם היא נכשלה.
`abstract void`	`removeOwners()` הסרת כל הבעלים הקיימים של פרופיל המכשיר, ככל האפשר.
`abstract boolean`	`removeUser(int userId)` הסרת משתמש מסוים מהמכשיר.
`abstract boolean`	`setDeviceOwner(String componentName, int userId)` הגדרה של רכיב אדמין במכשיר כבעלים של המכשיר אצל משתמש נתון.
`abstract void`	`setSetting(String namespace, String key, String value)` מידע נוסף על `setSetting(int,String,String,String)` ועל פעולות שמתבצעות על משתמש מערכת
`abstract void`	`setSetting(int userId, String namespace, String key, String value)` מוסיפים ערך הגדרה למרחב השמות של משתמש נתון.
`abstract boolean`	`startUser(int userId)` מפעיל משתמש נתון ברקע אם הוא מושבת כרגע.
`abstract boolean`	`startUser(int userId, boolean waitFlag)` מפעיל משתמש נתון ברקע אם הוא מושבת כרגע.
`abstract boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` מפעיל משתמש מסוים ברקע, שגלוי בתצוגה הנתונה (כלומר, מאפשר למשתמש להפעיל פעילויות בתצוגה הזו).
`abstract boolean`	`stopUser(int userId)` הפסקת השימוש של משתמש מסוים.
`abstract boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` להפסיק את השימוש של משתמש מסוים.
`abstract boolean`	`switchUser(int userId)` מעבר למזהה משתמש אחר עם פסק זמן שמוגדר כברירת מחדל.
`abstract boolean`	`switchUser(int userId, long timeout)` מעבר למזהה משתמש אחר עם זמן קצוב לתפוגה שסופק כמועד אחרון.
`abstract Bugreport`	`takeBugreport()` יוצר דוח באגים ומחזיר אותו בתוך אובייקט `Bugreport` כדי לטפל בו.
`abstract String`	`uninstallPackage(String packageName)` הסרת חבילת Android מהמכשיר.
`abstract String`	`uninstallPackageForUser(String packageName, int userId)` הסרת חבילת Android מהמכשיר עבור משתמש מסוים.
`default void`	`waitForSnapuserd(SnapuserdWaitPhase currentPhase)` אם זה צפוי, מחכים עד ש-snapuserd יסיים את הפעולה.

‫methods ציבוריים

adbInstallPackage

public abstract 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 abstract 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 abstract boolean canSwitchToHeadlessSystemUser ()

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

החזרות
`boolean`

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

checkConnectivity

public abstract boolean checkConnectivity ()

בודקים שלמכשיר יש חיבור לרשת.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-connectToWifiNetworkWithResult(Map,boolean).

מתחבר לרשת Wi-Fi.

מפעיל את ה-Wi-Fi וחוסם עד שנוצר חיבור מוצלח לאחת מרשתות ה-Wi-Fi שמופיעות במפה wifiSsidToPsk. אחרי שנוצר חיבור, המופע ינסה לשחזר את החיבור אחרי כל הפעלה מחדש עד שמתבצעת קריאה ל-ITestDevice.disconnectFromWifi() או ל-ITestDevice.clearLastConnectedWifiNetwork().

פרמטרים
`wifiSsidToPsk`	‫`Map`: מפה של מזהי SSID של רשתות Wi-Fi לסיסמאות.
`scanSsid`	‫`boolean`: האם לסרוק SSID מוסתרים ברשת הזו.

החזרות
`boolean`	‫`true` אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. `false` אחרת

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetwork

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-connectToWifiNetworkWithResult(Map).

מתחבר לרשת Wi-Fi.

פרמטרים
`wifiSsidToPsk`	‫`Map`: מפה של מזהי SSID של רשתות Wi-Fi לסיסמאות.

החזרות
`boolean`	‫`true` אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. `false` אחרת

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-connectToWifiNetworkWithResult(String,String).

מתחבר לרשת Wi-Fi.

מפעיל את ה-Wi-Fi וחוסם עד שנוצר חיבור מוצלח לרשת ה-Wi-Fi שצוינה. אחרי שנוצר חיבור, המופע ינסה לשחזר את החיבור אחרי כל הפעלה מחדש עד שמתבצעת קריאה ל-ITestDevice.disconnectFromWifi() או ל-ITestDevice.clearLastConnectedWifiNetwork().

פרמטרים
`wifiSsid`	‫`String`: מזהה ה-SSID של רשת ה-Wi-Fi שאליה רוצים להתחבר
`wifiPsk`	‫`String`: ביטוי הגישה של PSK או null אם לא מוצפן

החזרות
`boolean`	‫`true` אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. `false` אחרת

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-connectToWifiNetworkWithResult(String,String,boolean).

מתחבר לרשת Wi-Fi.

מפעיל את ה-Wi-Fi וחוסם עד שנוצר חיבור מוצלח לרשת ה-Wi-Fi שצוינה. אחרי שנוצר חיבור, המופע ינסה לשחזר את החיבור אחרי כל הפעלה מחדש עד שתתבצע קריאה ל-ITestDevice.disconnectFromWifi() או ל-ITestDevice.clearLastConnectedWifiNetwork().

פרמטרים
`wifiSsid`	‫`String`: מזהה ה-SSID של רשת ה-Wi-Fi שאליה רוצים להתחבר
`wifiPsk`	‫`String`: ביטוי הגישה של PSK או null אם לא מוצפן
`scanSsid`	‫`boolean`: האם לסרוק SSID מוסתר ברשת הזו.

החזרות
`boolean`	‫`true` אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. `false` אחרת

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-connectToWifiNetworkIfNeededWithResult(String,String,boolean).

וריאציה של connectToWifiNetwork(String,String) שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.

פרמטרים
`scanSsid`	‫`boolean`: האם לסרוק SSID מוסתר ברשת הזו

החזרות
`boolean`	‫`true` אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. `false` אחרת

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

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב-connectToWifiNetworkIfNeededWithResult(String,String).

וריאציה של connectToWifiNetwork(String,String) שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.

החזרות
`boolean`	‫`true` אם החיבור לרשת ה-Wi-Fi בוצע בהצלחה. `false` אחרת

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

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

וריאציה של connectToWifiNetwork(String,String) שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.

פרמטרים
`scanSsid`	‫`boolean`: האם לסרוק SSID מוסתר ברשת הזו

החזרות
`IWifiHelper.WifiConnectionResult`	הסמל `WifiConnectionResult` מציין את סטטוס החיבור.

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

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

וריאציה של connectToWifiNetwork(String,String) שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.

החזרות
`IWifiHelper.WifiConnectionResult`	הסמל `WifiConnectionResult` מציין את סטטוס החיבור.

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

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

מתחבר לרשת Wi-Fi.

פרמטרים
`wifiSsid`	‫`String`: מזהה ה-SSID של רשת ה-Wi-Fi שאליה רוצים להתחבר
`wifiPsk`	‫`String`: ביטוי הגישה של PSK או null אם לא מוצפן
`scanSsid`	‫`boolean`: האם לסרוק SSID מוסתר ברשת הזו.

החזרות
`IWifiHelper.WifiConnectionResult`	הסמל `WifiConnectionResult` מציין את סטטוס החיבור.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

מתחבר לרשת Wi-Fi.

מפעיל את ה-Wi-Fi וחוסם עד שנוצר חיבור מוצלח לאחת מרשתות ה-Wi-Fi שמופיעות במפה wifiSsidToPsk. אחרי שנוצר חיבור, המופע ינסה לשחזר את החיבור אחרי כל הפעלה מחדש עד שמבצעים קריאה ל-ITestDevice.disconnectFromWifi() או ל-ITestDevice.clearLastConnectedWifiNetwork().

פרמטרים
`wifiSsidToPsk`	‫`Map`: מפה של מזהי SSID של רשתות Wi-Fi לסיסמאות.

החזרות
`IWifiHelper.WifiConnectionResult`	הסמל `WifiConnectionResult` מציין את סטטוס החיבור.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

מתחבר לרשת Wi-Fi.

פרמטרים
`wifiSsidToPsk`	‫`Map`: מפה של מזהי SSID של רשתות Wi-Fi לסיסמאות.
`scanSsid`	‫`boolean`: האם לסרוק SSID מוסתרים ברשת הזו.

החזרות
`IWifiHelper.WifiConnectionResult`	הסמל `WifiConnectionResult` מציין את סטטוס החיבור.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

מתחבר לרשת Wi-Fi.

פרמטרים
`wifiSsid`	‫`String`: מזהה ה-SSID של רשת ה-Wi-Fi שאליה רוצים להתחבר
`wifiPsk`	‫`String`: ביטוי הגישה של PSK או null אם לא מוצפן

החזרות
`IWifiHelper.WifiConnectionResult`	הסמל `WifiConnectionResult` מציין את סטטוס החיבור.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

createUser

public abstract int createUser (String name)

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

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

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

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

createUser

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

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

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

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

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

createUser

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

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

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

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

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

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

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

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

הסרת IDeviceActionReceiver הרשום.

פרמטרים
`deviceActionReceiver`	‫`IDeviceActionReceiver`: `IDeviceActionReceiver` שיוסר.

disableKeyguard

public abstract void disableKeyguard ()

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

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

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

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

השבתה של מעקב אחרי הרשת במכשיר.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

התנתקות מרשת Wi-Fi.

מסיר את כל הרשתות מרשימת הרשתות המוכרות ומשבית את ה-Wi-Fi.

החזרות
`boolean`	‫`true` אם ההתנתקות מרשת ה-Wi-Fi הצליחה. `false` אם הניתוק נכשל.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

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

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

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

הגדרה שמאפשרת מעקב אחרי הרשת במכשיר.

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getActiveApexes

public abstract Set<ITestDevice.ApexInfo> getActiveApexes ()

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

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

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

getAllSettings

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

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

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

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

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

getAndroidId

public abstract String getAndroidId (int userId)

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

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

החזרות
`String`

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

getAndroidIds

public abstract Map<Integer, String> getAndroidIds ()

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

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

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

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

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

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

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

getAppPackageInfos

public abstract List<PackageInfo> getAppPackageInfos ()

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

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

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

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

החזרות
`DeviceFoldableState`

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

getCurrentUser

public abstract int getCurrentUser ()

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

החזרות
`int`

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

getFoldableStates

public abstract Set<DeviceFoldableState> getFoldableStates ()

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

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

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

getInstalledPackageNames

public abstract Set<String> getInstalledPackageNames ()

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

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

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

getIpAddress

public abstract String getIpAddress ()

קבלת כתובת ה-IP של המכשיר.

החזרות
`String`	כתובת ה-IP של המכשיר, או `null` אם למכשיר אין כתובת IP

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

getMainUserId

public abstract Integer getMainUserId ()

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

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

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceRuntimeException`	אם הפלט מהמכשיר לא תואם לציפיות.
`DeviceNotAvailableException`

getMainlineModuleInfo

public abstract Set<String> getMainlineModuleInfo ()

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

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported (String userType)

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

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

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

השיטה הזו הוצאה משימוש.
‫use getMaxNumberOfUsersSupported(String userType) to obtain the max number of supported users for a given user type.

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

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

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

getOptions

public abstract TestDeviceOptions getOptions ()

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

החזרות
`TestDeviceOptions`	‫`TestDeviceOptions` שקשורות למכשיר שנבדק.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

השיטה הזו הוצאה משימוש.
הפונקציה getPrimaryUser הוצאה משימוש בשירות UserManager. צריך להשתמש בפונקציה ERROR(/android.os.UserManager#getMainUserId()) כדי לקבל את המשתמש המלא הראשון או 0 למערכת. שימו לב: במערכת ללא ראש, המשתמש לא מלא.

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

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

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceRuntimeException`	אם הפלט מהמכשיר לא תואם לציפיות.
`DeviceNotAvailableException`

getRemainingCreatableUserCount

public abstract int getRemainingCreatableUserCount (String userType)

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

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

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

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

getScreenshot

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

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

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

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

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

getSetting

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

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

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

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

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

מידע נוסף על getSetting(int,String,String) ועל פעולות שמתבצעות על משתמש מערכת

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

החזרות
`String`

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

getUninstallablePackageNames

public abstract Set<String> getUninstallablePackageNames ()

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

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

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

getUserFlags

public abstract int getUserFlags (int userId)

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

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

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

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

getUserInfos

public abstract Map<Integer, UserInfo> getUserInfos ()

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

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

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

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

החזרות
`int`

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

getUserVisibleOnDisplay

public abstract int getUserVisibleOnDisplay (int displayId)

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

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

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

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

hasFeature

public abstract boolean hasFeature (String feature)

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

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

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

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

installPackage

public abstract 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 abstract 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 abstract 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 abstract 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 abstract boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

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

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

החזרות
`boolean`

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

installPackages

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

התקנה של אפליקציה ל-Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות פיצול נוספות). במאמר https://developer.android.com/studio/build/configure-apk-splits מוסבר איך לפצל קובץ APK לכמה קבצים.

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.
`UnsupportedOperationException`	אם הפלטפורמה במכשיר לא תומכת בהרשאה בתחילת ההפעלה.

installPackages

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

התקנה של אפליקציה ל-Android שמורכבת מכמה קובצי APK (קובץ ראשי וחבילות פיצול נוספות) שנמצאים במכשיר Android. במאמר https://developer.android.com/studio/build/configure-apk-splits מוסבר איך לפצל קובץ APK לכמה קבצים.

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.
`UnsupportedOperationException`	אם הפלטפורמה במכשיר לא תומכת בהרשאה בתחילת ההפעלה.

installPackagesForUser

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

התקנה של אפליקציה ל-Android שמורכבת מכמה קובצי APK (אחד ראשי וחבילות פיצול נוספות) עבור משתמש מסוים. במאמר https://developer.android.com/studio/build/configure-apk-splits מוסבר איך לפצל קובץ APK לכמה קבצים.

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.
`UnsupportedOperationException`	אם הפלטפורמה במכשיר לא תומכת בהרשאה בתחילת ההפעלה.

installPackagesForUser

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.
`UnsupportedOperationException`	אם הפלטפורמה במכשיר לא תומכת בהרשאה בתחילת ההפעלה.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

החזרות
`boolean`

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

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

החזרות
`boolean`

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

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

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

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

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

isUserRunning

public abstract boolean isUserRunning (int userId)

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

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

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

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

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

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

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

isUserVisible

public abstract boolean isUserVisible (int userId)

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

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

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

החזרות
`boolean`

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

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

החזרות
`boolean`

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

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract 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 abstract boolean isVisibleBackgroundUsersSupported ()

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

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

החזרות
`boolean`

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

isWifiEnabled

public abstract boolean isWifiEnabled ()

בודקים אם ה-Wi-Fi מופעל.

בודק אם ה-Wi-Fi מופעל במכשיר. הפקודה שימושית כדי לקבוע את סטטוס ה-Wi-Fi לפני בדיקות שלא אמורות לפעול עם Wi-Fi, למשל בדיקות של חבילת גלישה.

החזרות
`boolean`	‫`true` אם ה-Wi-Fi מופעל. `false` אם ההגדרה מושבתת

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

listDisplayIds

public abstract Set<Long> listDisplayIds ()

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

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

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

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

listUsers

public abstract ArrayList<Integer> listUsers ()

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

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

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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

שיטת עזר ליצירת דוח על באג ולתיעוד שלו בדוחות.

פרמטרים
`dataName`	‫`String`: השם שיופיע בדוח על באג.
`listener`	‫`ITestLogger`: `ITestLogger` כדי לרשום את דוח הבאגים.

החזרות
`boolean`	‫True אם הרישום ביומן הצליח, אחרת False.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

שולחים למכשיר הודעה להמתין לסיום של snapuserd.

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

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

פרמטרים
`deviceActionReceiver`	‫`IDeviceActionReceiver`: `IDeviceActionReceiver` שיירשם.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

removeOwners

public abstract void removeOwners ()

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

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

removeUser

public abstract boolean removeUser (int userId)

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

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

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

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

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

setSetting

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

מידע נוסף על setSetting(int,String,String,String) ועל פעולות שמתבצעות על משתמש מערכת

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

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

setSetting

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

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

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

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

startUser

public abstract boolean startUser (int userId)

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

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

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

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

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

startVisibleBackgroundUser

public abstract 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 abstract boolean stopUser (int userId)

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

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

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

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

stopUser

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

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

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

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

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

switchUser

public abstract boolean switchUser (int userId)

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

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

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

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

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

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

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

takeBugreport

public abstract Bugreport takeBugreport ()

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

החזרות
`Bugreport`

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם החיבור למכשיר אבד ואי אפשר לשחזר אותו.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

אם זה צפוי, מחכים עד ש-snapuserd יסיים את הפעולה.

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

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

ITestDevice

סיכום

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

‫methods ציבוריים

‫methods ציבוריים

adbInstallPackage

adbInstallPackage

canSwitchToHeadlessSystemUser

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

createUser

createUser

createUser

createUserNoThrow

deregisterDeviceActionReceiver

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

dumpHeap

enableNetworkMonitor

getActiveApexes

getAllSettings

getAndroidId

getAndroidIds

getAppPackageInfo

getAppPackageInfos

getBugreport

getBugreportz

getCurrentFoldableState

getCurrentUser

getFoldableStates

getInstalledPackageNames

getIpAddress

getKeyguardState

getMainUserId

getMainlineModuleInfo

getMaxNumberOfRunningUsersSupported

getMaxNumberOfUsersSupported

getMaxNumberOfUsersSupported

getOptions

getPrimaryUserId

getRemainingCreatableUserCount

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getScreenshot

getSetting

getSetting

getUninstallablePackageNames

getUserFlags

getUserInfos

getUserSerialNumber

getUserVisibleOnDisplay

hasFeature

installPackage

installPackage

installPackageForUser

installPackageForUser

installPackageWithIncrementalMode

installPackages

installPackages

installPackagesForUser

installPackagesForUser

isHeadlessSystemUserMode

isMainUserPermanentAdmin