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

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

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

TestDevice

TestDevice הטמעה של ITestDevice במכשיר Android עם סטאק מלא

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

LocalAndroidVirtualDevice, ‏ ManagedRemoteDevice, ‏ NestedRemoteDevice, ‏ RemoteAndroidDevice, ‏ RemoteAndroidVirtualDevice

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

הטמעת ברירת המחדל של ITestDevice במכשירי Android עם סטאק חלקי.

סיכום

כיתות בתצוגת עץ
`class`	`NativeDevice.AdbAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` להרצת הפקודה 'adb ....' של מערכת ההפעלה.
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` כדי להפעיל מחדש מכשיר.

קבועים
`int`	`INVALID_USER_ID` הערך המוחזר לכל מזהה משתמש לא חוקי או לא נמצא: הערך -10000 מוגדר ב-UserHandle
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` מספר הניסיונות שמבוצעים כברירת מחדל להרצה חוזרת של הפקודה

שדות
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

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

שיטות ציבוריות
`void`	`batchPrefetchStartupBuildProps()` אופטימיזציה ברמת המיקרו (כ-400 אלפיות השנייה) על ידי אחסון מראש של כל המאפיינים שאנחנו צריכים, במקום להפעיל את 'adb getprop' לכל אחד מהם.
`boolean`	`canSwitchToHeadlessSystemUser()` הפונקציה מחזירה אם מותר לעבור למשתמש ללא ממשק גרפי במערכת.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` בדיקה אם תכונה מסוימת נתמכת כרגע בהתאם לרמה המינימלית של התמיכה.
`boolean`	`checkConnectivity()` צריך לוודא שלמכשיר יש חיבור לרשת.
`boolean`	`clearErrorDialogs()` מנסים לסגור את כל תיבות הדו-שיח של השגיאות שמוצגות כרגע בממשק המשתמש של המכשיר.
`void`	`clearLastConnectedWifiNetwork()` מחיקת רשת ה-Wi-Fi האחרונה שאליה התחברתם.
`void`	`clearLogcat()` מחיקת כל נתוני ה-logcat שנצברו.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` וריאנט של `connectToWifiNetwork(String, String)` שמתחבר רק אם אין כרגע חיבור לרשת במכשיר.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` וריאנט של `connectToWifiNetwork(String, String)` שמתחבר רק אם אין כרגע חיבור לרשת במכשיר.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` יצירת משתמש עם שם נתון והדגלים שסופקו
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` יצירת משתמש עם שם נתון והדגלים שסופקו
`int`	`createUser(String name)` יצירת משתמש עם שם נתון ודגלים שמוגדרים כברירת מחדל כ-0.
`int`	`createUserNoThrow(String name)` יצירת משתמש עם שם נתון ודגלים שמוגדרים כברירת מחדל כ-0.
`void`	`deleteFile(String deviceFilePath, int userId)` שיטה מסייעת למחיקת קובץ או ספרייה במכשיר.
`void`	`deleteFile(String deviceFilePath)` שיטה מסייעת למחיקת קובץ או ספרייה במכשיר.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` הסרת `IDeviceActionReceiver` הרשום.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` שיטה מסייעת לבדיקת הפעלה מחדש רכה של המכשיר, על ידי השוואה בין system_server הנוכחי לבין system_server הקודם `ProcessInfo`.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` שיטה מסייעת לבדיקת אם המכשיר הופעל מחדש באופן רך מאז שעון UTC מאז תחילת הזמן (epoch) מהמכשיר ומ-`ERROR(/TimeUnit)` שלו.
`boolean`	`disableAdbRoot()` השבתת adb root.
`void`	`disableKeyguard()` ניסיונות להשבית את מסך הנעילה.
`boolean`	`disableNetworkMonitor()` השבתת מעקב הרשת במכשיר.
`boolean`	`disconnectFromWifi()` ניתוק מרשת Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` שיטה מסייעת לקביעת אם קובץ קיים במכשיר של משתמש נתון.
`boolean`	`doesFileExist(String deviceFilePath)` שיטה מסייעת לקביעת אם קובץ קיים במכשיר.
`File`	`dumpHeap(String process, String devicePath)` ניסיון לדמפ את האוסף (heap) מ-system_server.
`boolean`	`enableAdbRoot()` הפעלת adb root.
`boolean`	`enableNetworkMonitor()` הפעלת מעקב אחר הרשת במכשיר.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` שיטת עזר שמפעילה פקודה של adb כפקודת מערכת עם זמן קצוב לתפוגה.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` שיטת עזר שמפעילה פקודה של adb כפקודת מערכת עם זמן קצוב לתפוגה.
`String`	`executeAdbCommand(String... cmdArgs)` שיטת עזר שמריצה פקודה של adb כפקודת מערכת.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` שיטה מסייעת שמריצה פקודת fastboot כפקודת מערכת עם זמן קצוב לתפוגה כברירת מחדל של 2 דקות.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` שיטת עזר שמריצה פקודה של fastboot כפקודת מערכת.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` שיטת עזר שמפעילה פקודה ארוכה של fastboot כפקודת מערכת.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` שיטה מסייעת שמריצה פקודה ארוכה של fastboot כפקודת מערכת עם משתני סביבה של מערכת.
`String`	`executeShellCommand(String command)` שיטה מסייעת שמפעילה פקודה של adb shell ומחזירה את הפלט כ-`String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` הפקודה מבצעת את פקודת המעטפת adb שצוינה, ומנסה שוב כמה פעמים אם הפקודה נכשלת.
`CommandResult`	`executeShellV2Command(String cmd)` שיטה מסייעת שמריצה פקודה של מעטפת adb ומחזירה את התוצאות כ-`CommandResult` שמאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` שיטה מסייעת שמפעילה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שמאוכלס כראוי בפלט של סטטוס הפקודה וב-stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` שיטה מסייעת שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שמאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.
`CommandResult`	`fastbootWipePartition(String partition)` שיטה מסייעת שמוחקת מחיצה במכשיר.
	`getActiveApexes()` אחזור המידע על ה-APEXes שהופעלו במכשיר.
	`getAllSettings(String namespace)` הפונקציה מחזירה צמדי מפתח/ערך של מרחב השמות המבוקש.
`DeviceAllocationState`	`getAllocationState()` החזרת מצב ההקצאה הנוכחי של המכשיר
`String`	`getAndroidId(int userId)` חיפוש והחזרת הערך של android-id שמשויך למשתמש, או null אם לא נמצא.
	`getAndroidIds()` יצירת מפה של מזהי Android שתאמו למזהי משתמשים.
`int`	`getApiLevel()` אחזור רמת ה-API של המכשיר.
`PackageInfo`	`getAppPackageInfo(String packageName)` אחזור מידע על חבילה שמותקנת במכשיר.
	`getAppPackageInfos()` אחזור מידע על חבילות שמותקנות במכשיר.
`String`	`getBasebandVersion()` שיטה נוחה לקבלת גרסת פס הבסיס (הרדיו) של המכשיר הזה.
`Integer`	`getBattery()` הפונקציה מחזירה את רמת הטעינה הנוכחית של הסוללה במכשיר, או Null אם רמת הטעינה לא זמינה.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` הפונקציה מחזירה את הערך הבוליאני של המאפיין הנתון.
	`getBootHistory()` שיטת העזר אוספת את המפה של היסטוריית האתחול עם זמן האתחול והסיבה לאתחול.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` שיטת העזר אוספת את המפה של היסטוריית האתחול עם זמן האתחול והסיבה לאתחול מאז הזמן שצוין מאז תחילת הזמן (epoch) מהמכשיר ומיחידת הזמן שצוינה.
`String`	`getBootloaderVersion()` שיטה נוחה לקבלת גרסת תוכנת האתחול של המכשיר הזה.
`InputStreamSource`	`getBugreport()` אחזור דוח באג מהמכשיר.
`InputStreamSource`	`getBugreportz()` אחזור של bugreportz מהמכשיר.
`String`	`getBuildAlias()` אחזור הכינוי של ה-build שפועל כרגע במכשיר.
`String`	`getBuildFlavor()` אחזור של סוג ה-build של המכשיר.
`String`	`getBuildId()` אחזור של גרסת ה-build שפועלת כרגע במכשיר.
`String`	`getBuildSigningKeys()` הפונקציה מחזירה את סוג המפתח ששימש לחתימה על קובץ האימג' של המכשיר בדרך כלל, מכשירי Android יכולים להיות חתומים באמצעות מפתחות בדיקה (כמו ב-AOSP) או מפתחות גרסה (שנשלטים על ידי יצרני המכשירים השונים).
`DeviceDescriptor`	`getCachedDeviceDescriptor()` הפונקציה מחזירה את הערך של `DeviceDescriptor` ששמור במטמון אם המכשיר הוקצה, אחרת היא מחזירה את הערך הנוכחי של `DeviceDescriptor`.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` הפונקציה מחזירה את הערך של `DeviceDescriptor` ששמור במטמון אם המכשיר הוקצה, אחרת היא מחזירה את הערך הנוכחי של `DeviceDescriptor`.
`String[]`	`getChildren(String path)` חלופה לשימוש ב-`IFileEntry`, שפעמים רבות לא עובדת בגלל הרשאות.
`AbstractConnection`	`getConnection()` החיבור הנוכחי שמשויך למכשיר.
`ContentProviderHandler`	`getContentProvider(int userId)` הפונקציה מחזירה את `ContentProviderHandler` או ערך null אם הוא לא זמין.
`DeviceFoldableState`	`getCurrentFoldableState()` הפונקציה מחזירה את המצב הנוכחי של המכשיר כמכשיר מתקפל, או null אם אירעו בעיות.
`int`	`getCurrentUser()` החזרת המזהה של המשתמש הנוכחי שפועל.
`String`	`getDeviceClass()` אחזור של סיווג המכשיר.
`long`	`getDeviceDate()` החזרת התאריך של המכשיר במיליוניות השנייה מאז תחילת התקופה של זמן המערכת.
`DeviceDescriptor`	`getDeviceDescriptor()` החזרת `DeviceDescriptor` מתוך פרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` החזרת `DeviceDescriptor` מתוך פרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.
`TestDeviceState`	`getDeviceState()` אחזור המצב של המכשיר.
`long`	`getDeviceTimeOffset(Date date)` פונקציית עזרה לקבלת הפרש השעות בין המכשיר לבין `ERROR(/Date)` נתון.
`InputStreamSource`	`getEmulatorOutput()` אחזור של הסטרים stdout ו-stderr של האמולטור
`Process`	`getEmulatorProcess()` מחזירים את הערך של `Process` התואם לאמולטור הזה.
`final File`	`getExecuteShellCommandLog()` היומן שמכיל את כל היומנים של `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` שיטה מסייעת לקביעת נפח האחסון הפנוי באחסון החיצוני של המכשיר.
`String`	`getFastbootPath()` הפונקציה מחזירה את הנתיב של קובץ ה-binary של fastboot שבו נעשה שימוש.
`String`	`getFastbootProductType()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב Fastboot.
`String`	`getFastbootProductVariant()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב אתחול מהיר.
`String`	`getFastbootSerialNumber()` הפונקציה מחזירה את המספר הסידורי של מצב האתחול המהיר.
`String`	`getFastbootVariable(String variableName)` אחזור הערך של משתנה fastboot מהמכשיר.
`String`	`getFastbootVersion()` הפונקציה מחזירה את מחרוזת הגרסה של קובץ ה-binary של fastboot שבו נעשה שימוש.
`IFileEntry`	`getFileEntry(String path)` אחזור של הפניה לקובץ מרוחק במכשיר.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` כלי עזר לא רשמי לקבלת `FileEntry` מנתיב שאינו ברמה הבסיסית (root).
	`getFoldableStates()` הפונקציה מחזירה את רשימת המצבים של המכשיר המתקפל.
`IDevice`	`getIDevice()` הפונקציה מחזירה הפניה ל-`IDevice` של ddmlib המשויך.
	`getInstalledPackageNames()` אחזור שמות החבילות של האפליקציות שנמצאות במכשיר.
`long`	`getIntProperty(String name, long defaultValue)` הפונקציה מחזירה את הערך השלם של המאפיין הנתון מהמכשיר.
`String`	`getIpAddress()` אחזור כתובת ה-IP של המכשיר.
`KeyguardControllerState`	`getKeyguardState()` הפונקציה מחזירה אובייקט כדי לקבל את המצב הנוכחי של מסך הנעילה, או ערך null אם הוא לא נתמך.
`long`	`getLastExpectedRebootTimeMillis()` הפונקציה מחזירה את הפעם האחרונה שבה ממשקי ה-API של Tradefed הפעילו הפעלה מחדש, במיליוניות השנייה מאז EPOCH, כפי שהוחזר על ידי `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` אחזור של רמת ה-API הראשונה שהמכשיר הושק איתה.
`InputStreamSource`	`getLogcat()` אחזור של קובץ snapshot של נתוני logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` יצירת סטרימינג של תמונת מצב של `maxBytes` הנתונים האחרונים של logcat שצולמו.
`InputStreamSource`	`getLogcatDump()` קבלת גרסת dump של logcat הנוכחי של המכשיר.
`InputStreamSource`	`getLogcatSince(long date)` אחזור של זרם snapshot של נתוני logcat שצולמו החל מהתאריך שצוין.
`String`	`getMacAddress()` הפונקציה מחזירה את כתובת ה-MAC של המכשיר, או null אם לא ניתן לשלוח שאילתה מהמכשיר.
`Integer`	`getMainUserId()` הפונקציה מחזירה את מזהה המשתמש הראשי.
	`getMainlineModuleInfo()` הצגת המידע על המודולים הראשיים שמותקנים במכשיר.
`int`	`getMaxNumberOfRunningUsersSupported()` הצגת המספר המקסימלי של משתמשים נתמכים שפועלים בו-זמנית.
`int`	`getMaxNumberOfUsersSupported()` לקבל את מספר המשתמשים המרבי שנתמך.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` מחזירים את הערך של `IDeviceStateMonitor` שמשויך למכשיר.
`String`	`getMountPoint(String mountName)` הפונקציה מחזירה נקודת טעינה.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` הפונקציה מחזירה את הערך `MountPointInfo` שתואם לנתיב של נקודת הטעינה שצוינה, או את הערך `null` אם לא הועמסה נקודת טעינה בנתיב הזה או אם הוא לא מופיע ב-/proc/mounts כנקודת טעינה.
	`getMountPointInfo()` הפונקציה מחזירה גרסה מנותחת של המידע שב-/proc/mounts במכשיר
`TestDeviceOptions`	`getOptions()` אחזור של אפשרויות הבדיקה למכשיר.
`long`	`getPartitionFreeSpace(String partition)` שיטה מסייעת לקביעת נפח האחסון הפנוי במחיצה של המכשיר.
`Integer`	`getPrimaryUserId()` הפונקציה מחזירה את מזהה המשתמש הראשי.
`ProcessInfo`	`getProcessByName(String processName)` שיטת העזרה מפעילה את הפקודות pidof ו-stat ומחזירה אובייקט `ProcessInfo` עם מזהה ה-PID וזמן ההתחלה של התהליך הנתון.
`String`	`getProcessPid(String process)` הפונקציה מחזירה את מזהה ה-pid של השירות, או ערך null אם משהו השתבש.
`String`	`getProductType()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה.
`String`	`getProductVariant()` שיטה נוחה לקבלת וריאציית המוצר של המכשיר הזה.
`String`	`getProperty(String name)` אחזור הערך של המאפיין הנתון מהמכשיר.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` מקבלים את סטטוס מצב השחזור הנוכחי של המכשיר.
`InputStreamSource`	`getScreenshot(long displayId)` צילום מסך מהמכשיר לפי מזהה התצוגה.
`InputStreamSource`	`getScreenshot(String format)` צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot()` צילום מסך מהמכשיר.
`String`	`getSerialNumber()` שיטה נוחה לקבלת המספר הסידורי של המכשיר הזה.
`String`	`getSetting(int userId, String namespace, String key)` החזרת הערך של ההגדרה המבוקשת.
`String`	`getSetting(String namespace, String key)` ראו `getSetting(int, String, String)` והפעולה מתבצעת על משתמש המערכת.
`String`	`getSimOperator()` מחזירים את המפעיל של כרטיס ה-SIM או null אם הוא לא זמין או אם המכשיר לא זמין.
`String`	`getSimState()` הפונקציה מחזירה את מצב כרטיס ה-SIM או null אם הכרטיס לא זמין או שהמכשיר לא זמין.
	`getTombstones()` אחזור של רשימת המכשירים מהמכשירים והחזרתה.
`long`	`getTotalMemory()` הפונקציה מחזירה את נפח הזיכרון הפיזי הכולל בבייטים, או -1 במקרה של שגיאה פנימית
`String`	`getTrackingSerial()` לצורך ניהול המכשיר, צריך לקבל את המספר הסידורי שמשמש למעקב אחרי המכשיר.
	`getUninstallablePackageNames()` אחזור שמות החבילות של האפליקציות שאפשר להסיר.
`boolean`	`getUseFastbootErase()` בודקים אם להשתמש ב-fastboot erase או ב-fastboot format כדי למחוק מחיצה במכשיר.
`int`	`getUserFlags(int userId)` חיפוש הדגלים של משתמש נתון והחזרתם.
	`getUserInfos()` הפונקציה מקבלת את המפה של useId ל-`UserInfo` במכשיר.
`int`	`getUserSerialNumber(int userId)` הפונקציה מחזירה את המספר הסידורי שמשויך למזהה המשתמש, אם הוא נמצא, או -10000 בכל מקרה אחר.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` עיבוד של האירוע DeviceEvent. מעבדים את האירוע DeviceEvent, שעשוי להעביר את המכשיר למצב הקצאה חדש או לא.
`boolean`	`hasFeature(String feature)` איך בודקים אם תכונה מסוימת זמינה במכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` התקנת חבילת Android במכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקנת חבילת Android במכשיר.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר של משתמש נתון.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר של משתמש נתון.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
`boolean`	`isBypassLowTargetSdkBlockSupported()` בדיקה אם הפלטפורמה במכשיר תומכת עקיפה של חסימה של גרסת SDK עם יעד נמוך בהתקנות של אפליקציות
`boolean`	`isDebugfsMounted()` בודקים אם ה-debugfs מוצמד.
`boolean`	`isDeviceEncrypted()` הפונקציה מחזירה אם המכשיר מוצפן.
`boolean`	`isDirectory(String path)` הפונקציה מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה, ואת הערך False במקרים אחרים.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` הפונקציה מחזירה אם ההצפנה נתמכת במכשיר.
`boolean`	`isExecutable(String fullPath)` הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ הפעלה, ואת הערך False במקרים אחרים.
`boolean`	`isFastbootEnabled()` חוזרים אם הכלי לאתחול מהיר (fastboot) זמין למכשיר.
`boolean`	`isHeadless()` הפונקציה מחזירה את הערך True אם המכשיר ללא צג (headless), ואת הערך False במקרים אחרים.
`boolean`	`isHeadlessSystemUserMode()` הפונקציה מחזירה אם המכשיר משתמש במצב משתמש ללא ממשק משתמש של מערכת.
`boolean`	`isMainUserPermanentAdmin()` הפונקציה מחזירה אם המשתמש הראשי הוא אדמין קבוע ולא ניתן למחוק אותו או לשדרג לאחור את הסטטוס שלו לסטטוס 'לא אדמין'.
`boolean`	`isMultiUserSupported()` קובע אם יש תמיכה בכמה משתמשים.
`boolean`	`isPackageInstalled(String packageName, String userId)` שולחים שאילתה למכשיר לגבי שם חבילה נתון ומזהה משתמש נתון כדי לבדוק אם החבילה מותקנת כרגע אצל המשתמש הזה.
`boolean`	`isPackageInstalled(String packageName)` שולחים שאילתה למכשיר לגבי שם חבילה נתון כדי לבדוק אם היא מותקנת כרגע או לא.
`boolean`	`isRuntimePermissionSupported()` בדיקה אם הפלטפורמה במכשיר תומכת במתן הרשאות בסביבת זמן הריצה
`boolean`	`isStateBootloaderOrFastbootd()` הפונקציה מחזירה את הערך true אם המכשיר נמצא ב-`TestDeviceState.FASTBOOT` או ב-`TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` בדיקה אם משתמש נתון פועל.
`boolean`	`isUserSecondary(int userId)` הפונקציה מחזירה אם המשתמש שצוין הוא משתמש משני, על סמך הדגלים שלו.
`boolean`	`isUserVisible(int userId)` בדיקה אם המשתמש הנתון גלוי.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` בדיקה אם המשתמש הנתון גלוי במסך הנתון.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` הפונקציה מחזירה את הערך `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` שמציין אם המכשיר מאפשר למשתמשים להופיע ברקע כשהם מופעלים.
`boolean`	`isVisibleBackgroundUsersSupported()` הפונקציה מחזירה את הערך 'true' אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע.
`boolean`	`isWifiEnabled()` בודקים אם ה-Wi-Fi מופעל.
	`listDisplayIds()` אוספים את רשימת מזהי המסכים הזמינים במכשיר, כפי שמדווח על ידי "dumpsys SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers()` הפונקציה מקבלת את רשימת המסכים שאפשר להשתמש בהם כדי `start a user visible in the background`.
	`listUsers()` הפונקציה מקבלת את רשימת המשתמשים במכשיר.
`boolean`	`logAnrs(ITestLogger logger)` איסוף דיווחים על ANR מהמכשיר ורישום שלהם ביומן.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` שיטה מסייעת ליצירת דוח באג ולתיעודו ביומן של המדווחים.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` רישום הודעה ב-logcat של המכשיר.
`void`	`mountDebugfs()` מחברים את debugfs.
`void`	`nonBlockingReboot()` הפעלת פקודה להפעלה מחדש של המכשיר, והחזרה כשהפקודה תושלם וכשהמכשיר כבר לא גלוי ל-adb.
`void`	`postAdbRootAction()` משנים את ההגדרה אם צריך לבצע פעולות ספציפיות במכשיר אחרי ה-adb root ולפני שהמכשיר חוזר לאינטרנט.
`void`	`postAdbUnrootAction()` משנים את ההגדרה אם צריך לבצע פעולות ספציפיות במכשיר אחרי ביטול ה-root באמצעות adb, ולפני שהמכשיר חוזר לאינטרנט.
`void`	`postBootSetup()` פועלים לפי ההוראות להגדרת המכשיר לבדיקה אחרי כל הפעלה.
`void`	`postInvocationTearDown(Throwable exception)` שלבים נוספים לניקוי נדרש ספציפי למכשיר, שיתבצע אחרי הקריאה.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` שלבים נוספים להגדרה הנדרשת ספציפית למכשיר, שיתבצעו במכשיר לפני תהליך ההפעלה.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` אחזור היררכי של תוכן הספריות מהמכשיר.
`boolean`	`pullDir(String deviceFilePath, File localDir)` אחזור היררכי של תוכן הספריות מהמכשיר.
`boolean`	`pullFile(String remoteFilePath, File localFile)` אחזור קובץ מהמכשיר.
`File`	`pullFile(String remoteFilePath, int userId)` הפונקציה מאחזרת קובץ מהמכשיר, שומרת אותו ב-`ERROR(/File)` זמני מקומי ומחזירה את ה-`File` הזה.
`File`	`pullFile(String remoteFilePath)` הפונקציה מאחזרת קובץ מהמכשיר, שומרת אותו ב-`ERROR(/File)` זמני מקומי ומחזירה את ה-`File` הזה.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` אחזור קובץ מהמכשיר.
`String`	`pullFileContents(String remoteFilePath)` אחזור קובץ מהמכשיר והחזרת התוכן שלו.
`File`	`pullFileFromExternal(String remoteFilePath)` שיטה נוחה לאחזור קובץ מהאחסון החיצוני של המכשיר, לשמירתו ב-`ERROR(/File)` זמני מקומי ולהחזרת הפניה ל-`File` הזה.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` דחיפה רפטורית של תוכן הספריות למכשיר, תוך החרגה של ספריות מסוימות שעברו סינון.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` שליחת תוכן הספרייה למכשיר באופן רספונסיבי.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` שליחת תוכן הספרייה למכשיר באופן רספונסיבי.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` וריאנט של `pushFile(File, String)` שיכול להביא בחשבון הערכה של הצורך של ספק התוכן.
`boolean`	`pushFile(File localFile, String remoteFilePath)` העברת קובץ למכשיר.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` העברת קובץ למכשיר.
`boolean`	`pushString(String contents, String remoteFilePath)` דחיפת קובץ שנוצר ממחרונית למכשיר
`void`	`reboot(String reason)` הפעלה מחדש של המכשיר למצב adb עם `reason` נתון שיישמר לאחר ההפעלה מחדש.
`void`	`reboot()` הפעלה מחדש של המכשיר למצב adb.
`void`	`rebootIntoBootloader()` הפעלה מחדש של המכשיר למצב תוכנת אתחול.
`void`	`rebootIntoFastbootd()` הפעלה מחדש של המכשיר למצב fastbootd.
`void`	`rebootIntoRecovery()` הפעלה מחדש של המכשיר למצב שחזור adb.
`void`	`rebootIntoSideload()` הפעלה מחדש של המכשיר למצב התקנה ממקור לא ידוע ב-ADB (שימו לב: זהו מצב מיוחד במסגרת התאוששות) החסימה נמשכת עד שהמכשיר עובר למצב העברה צדדית
`void`	`rebootIntoSideload(boolean autoReboot)` הפעלה מחדש של המכשיר למצב התקנה ממקור לא ידוע ב-ADB (שימו לב: זהו מצב מיוחד במסגרת התאוששות) החסימה נמשכת עד שהמכשיר עובר למצב העברה צדדית
`void`	`rebootUntilOnline()` חלופה ל-`reboot()` שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
`void`	`rebootUntilOnline(String reason)` חלופה ל-`reboot()` שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
`void`	`rebootUserspace()` הפעלה מחדש של החלק של המכשיר שמשויך למרחב המשתמש בלבד.
`void`	`rebootUserspaceUntilOnline()` חלופה ל-`rebootUserspace()` ()} שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
`boolean`	`recoverDevice()` ניסיון לשחזור התקשורת עם המכשיר.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` הרשמה של `IDeviceActionReceiver` למכשיר הזה.
`void`	`remountSystemReadOnly()` להגדיר את מחיצת המערכת במכשיר כמחיצה לקריאה בלבד.
`void`	`remountSystemWritable()` מגדירים את מחיקת המערכת במכשיר כניתנת לכתיבה.
`void`	`remountVendorReadOnly()` להגדיר את המחיצה של הספק במכשיר כמחיצה לקריאה בלבד.
`void`	`remountVendorWritable()` מגדירים את מחיקת הספק במכשיר כמחיצה לכתיבה.
`boolean`	`removeAdmin(String componentName, int userId)` הסרת האדמין של המכשיר הנתון מהמשתמש הנתון, והחזרת הערך `true` אם הפעולה בוצעה בהצלחה, או `false` אחרת.
`void`	`removeOwners()` מסירים את כל הבעלים הקיימים של פרופילי המכשירים ככל האפשר.
`boolean`	`removeUser(int userId)` הסרת משתמש נתון מהמכשיר.
`void`	`resetContentProviderSetup()` צריך לאפס את הדגל של הגדרת ספק התוכן כדי להפעיל אותו שוב.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` שיטה נוחה לביצוע `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` עם מאזין אחד או יותר שמועברים כפרמטרים.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` הרצת בדיקות של מכשירי מדידה, ותיקון מכשירי Android.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` זהה ל-`ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))`, אבל הבדיקה מופעלת עבור המשתמש הנתון.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` זהה ל-`ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, אבל הבדיקה פועלת עבור משתמש נתון.
`void`	`setConfiguration(IConfiguration configuration)` הזרקת `IConfiguration` בשימוש.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` הגדרת התאריך במכשיר הערה: כדי להגדיר תאריך במכשיר, צריך הרשאת root
`boolean`	`setDeviceOwner(String componentName, int userId)` הגדרת רכיב של אדמין מכשיר כבעלים של המכשיר אצל משתמש נתון.
`void`	`setDeviceState(TestDeviceState deviceState)` מעדכנים את מצב המכשיר.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` במהלך הדמיה, מגדירים את `SizeLimitedOutputStream` לתיעוד הפלט
`void`	`setEmulatorProcess(Process p)` מגדיר את `Process` כשהמכשיר הזה הוא אמולטור.
`void`	`setFastbootEnabled(boolean fastbootEnabled)` מגדירים את האפשרות fastboot למכשיר.
`void`	`setFastbootPath(String fastbootPath)` הגדרת הנתיב לקובץ הבינארי של fastboot שבו צריך להשתמש.
`void`	`setIDevice(IDevice newDevice)` מעדכנים את IDevice שמשויך ל-ITestDevice הזה.
`void`	`setLogStartDelay(int delay)` הגדרת משך הזמן באלפיות שנייה להמתנה לפני תחילת הצילום של logcat במכשיר שמחובר לאינטרנט.
`void`	`setOptions(TestDeviceOptions options)` הגדרת `TestDeviceOptions` למכשיר
`boolean`	`setProperty(String propKey, String propValue)` הגדרת ערך המאפיין במכשיר.
`void`	`setRecovery(IDeviceRecovery recovery)` מגדירים את `IDeviceRecovery` לשימוש במכשיר הזה.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` מגדירים את מצב השחזור הנוכחי שישמש את המכשיר.
`void`	`setSetting(String namespace, String key, String value)` ראו `setSetting(int, String, String, String)` והפעולה מתבצעת על משתמש המערכת.
`void`	`setSetting(int userId, String namespace, String key, String value)` הוספת ערך הגדרה למרחב השמות של משתמש נתון.
`void`	`setTestLogger(ITestLogger testLogger)` החדרת המכונה `ITestLogger`
`void`	`setTrackingSerial(String trackingSerial)` לצורך ניהול המכשיר, כדאי לעקוב אחרי המספר הסידורי שאנחנו משתמשים בו כדי להפנות למכשיר.
`void`	`setUseFastbootErase(boolean useFastbootErase)` מגדירים אם להשתמש ב-fastboot erase או ב-fastboot format כדי למחוק מחיצה במכשיר.
`void`	`startLogcat()` מתחילים לתעד את הפלט של logcat מהמכשיר ברקע.
`boolean`	`startUser(int userId)` הפעלה של משתמש נתון ברקע, אם הוא מושהה כרגע.
`boolean`	`startUser(int userId, boolean waitFlag)` הפעלה של משתמש נתון ברקע, אם הוא מושהה כרגע.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` הפעלת משתמש נתון ברקע, גלוי במסך נתון (כלומר, מאפשרת למשתמש להפעיל פעילויות במסך הזה).
`void`	`stopEmulatorOutput()` סוגרים ומוחקים את הפלט של האמולטור.
`void`	`stopLogcat()` הפסקת הצילום של פלט logcat מהמכשיר, והשלכת נתוני logcat שנשמרו.
`boolean`	`stopUser(int userId)` עצירת משתמש נתון.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` להפסיק משתמש נתון.
`String`	`switchToAdbTcp()` מעבירים את המכשיר למצב adb-over-tcp.
`boolean`	`switchToAdbUsb()` מעבירים את המכשיר למצב adb over usb.
`boolean`	`switchUser(int userId)` מעבר למשתמש אחר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל.
`boolean`	`switchUser(int userId, long timeout)` עוברים למשתמש אחר עם זמן הקצאת הזמן שצוין כמועד אחרון.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` סנכרון מצטבר של תוכן ספריית קבצים מקומית עם המכשיר.
`Bugreport`	`takeBugreport()` הפונקציה מקבלת דוח באג ומחזירה אותו בתוך אובייקט `Bugreport` לטיפול.
`String`	`uninstallPackage(String packageName)` הסרת חבילת Android מהמכשיר.
`String`	`uninstallPackageForUser(String packageName, int userId)` הסרת התקנה של חבילת Android מהמכשיר של משתמש נתון.
`boolean`	`unlockDevice()` פותח את המכשיר אם הוא נעול במצב מוצפן.
`void`	`unmountDebugfs()` ניתוק של debugfs.
`boolean`	`waitForBootComplete(long timeOut)` הבלוק נמשך עד שהדגל של השלמת האתחול של המכשיר מוגדר.
`boolean`	`waitForDeviceAvailable()` המערכת ממתינה שהמכשיר יגיב ויהיה זמין לבדיקה.
`boolean`	`waitForDeviceAvailable(long waitTime)` המערכת ממתינה שהמכשיר יגיב ויהיה זמין לבדיקה.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` המערכת ממתינה שהמכשיר יגיב ויהיה זמין, בלי להביא בחשבון את נתיב השחזור.
`void`	`waitForDeviceBootloader()` החסימה נמשכת עד שהמכשיר גלוי באמצעות fastboot.
`boolean`	`waitForDeviceInRecovery(long waitTime)` החסימה מונעת מהמכשיר לעבור למצב 'adb recovery' (שימו לב שזה שונה מ-`IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` חסימת המכשיר במצב 'adb sideload'
`boolean`	`waitForDeviceNotAvailable(long waitTime)` חסימות שמונעות את הזמינות של המכשיר, למשל, המכשיר חסר ב-adb
`void`	`waitForDeviceOnline()` החסימה נמשכת עד שהמכשיר גלוי דרך adb.
`void`	`waitForDeviceOnline(long waitTime)` החסימה נמשכת עד שהמכשיר גלוי דרך adb.
`boolean`	`waitForDeviceShell(long waitTime)` הפונקציה ממתינה עד שהמכשיר יגיב לפקודה בסיסית של מעטפת adb.

שיטות מוגנות
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` יצירת פקודת OS עבור סשן הפקודה adb shell והארגומנטים שצוינו
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` יוצרים `RebootDeviceAction` שישמש לביצוע פעולת הפעלה מחדש.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` מבצעים הפעלה מחדש של adb.
`void`	`ensureRuntimePermissionSupported()` שיטה מסייעת להעלאת חריגה אם אין תמיכה בהרשאה בזמן ריצה
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` מקבלים את המכונה `RunUtil` לשימוש.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` אחזור של מאפיין מכשיר, מהמטמון של ddmlib כברירת מחדל, וחזרה ל-adb shell getprop או ל-fastboot getvar בהתאם למצב המכשיר (במצב Fastboot או לא).
`boolean`	`isInRebootCallback()` הפונקציה מחזירה אם קריאות החזרה (callbacks) להפעלה מחדש מתבצעות כרגע או לא.
`boolean`	`isNewer(File localFile, IFileEntry entry)` הפונקציה מחזירה את הערך `true` אם הקובץ המקומי חדש יותר מהקובץ המרוחק.
`void`	`notifyRebootEnded()` שליחת התראה לכל `IDeviceActionReceiver` על אירוע סיום ההפעלה מחדש.
`void`	`notifyRebootStarted()` שליחת התראה לכל `IDeviceActionReceiver` על אירוע ההתחלה של ההפעלה מחדש.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` ביצוע פעולה במכשיר הזה.
`void`	`postAdbReboot()` פעולות נוספות אפשריות שניתן לבצע אחרי הפעלה מחדש.
`void`	`prePostBootSetup()` מאפשר לכל סוג מכשיר (AndroidNativeDevice, ‏ TestDevice) לשנות את השיטה הזו להגדרה ספציפית לאחר האתחול.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` מגדירים את המכונה של Clock לשימוש.
`void`	`setMicrodroidProcess(Process process)` מסמנים את TestDevice כ-microdroid ומגדירים את ה-CID שלו.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` הפקודה מבצעת פקודת fastboot פשוטה עם משתני סביבה ומדווחת על סטטוס הפקודה.
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` הפקודה מפעילה פקודת fastboot פשוטה ומדווחת על סטטוס הפקודה.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` ממתינים עד שהמכשיר לא יהיה זמין (הדיווח ל-adb יפסק).

קבועים

INVALID_USER_ID

public static final int INVALID_USER_ID

הערך המוחזר לכל מזהה משתמש לא חוקי או לא נמצא: הערך -10000 מוגדר ב-UserHandle

ערך קבוע: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

ערך קבוע: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

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

ערך קבוע: 2 (0x00000002)

שדות

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

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

NativeDevice

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

יצירת TestDevice.

פרמטרים
`device`	`IDevice`: ה-`IDevice` המשויך
`stateMonitor`	`IDeviceStateMonitor`: מנגנון `IDeviceStateMonitor` שבו רוצים להשתמש
`allocationMonitor`	`IDeviceMonitor`: `IDeviceMonitor` כדי לעדכן על שינויים במצב ההקצאה. יכול להיות null

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

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

אופטימיזציה ברמת המיקרו (כ-400 אלפיות השנייה) על ידי אחסון מראש של כל המאפיינים שאנחנו צריכים, במקום להפעיל את 'adb getprop' לכל אחד מהם. כלומר, אחזור של כל המאפיינים מהיר באותה מידה כמו אחזור של מאפיין אחד. פונקציות כמו device.getApiLevel(), ‏ checkApiLevelAgainstNextRelease ו-getBuildAlias כוללות קריאה ל-adb getprop ברקע. אנחנו מאחזרים אותם בקריאה אחת ומפעילים את NativeDevice.setProperty. גם אם לא נעשה זאת, NativeDevice יקרא בעצמו ל-setProperty וישמיט את התוצאה במטמון לשיחות עתידיות. אנחנו פשוט עושים את זה קצת מוקדם יותר. אם המכשיר נמצא בתהליך שחזור או שיש שגיאות אחרות באחזור הנכסים, אנחנו פשוט מתעלמים מהן.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

פרמטרים
`strictMinLevel`	`int`: הרמה המינימלית הקפדנית האפשרית שתומכת בתכונה.

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

זריקות
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

צריך לוודא שלמכשיר יש חיבור לרשת.

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

זריקות
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

זריקות
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

מחיקת כל נתוני ה-logcat שנצברו.

האפשרות הזו שימושית במקרים שבהם רוצים לוודא ש-ITestDevice.getLogcat() מחזיר רק נתוני יומן שנוצרו אחרי נקודה מסוימת (למשל, אחרי שמריצים את הקובץ החדש של המכשיר, וכו').

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetwork

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

זריקות
`DeviceNotAvailableException`

createUser

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

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

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

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

זריקות
`DeviceNotAvailableException`

createUser

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

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

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

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

זריקות
`DeviceNotAvailableException`

createUser

public int createUser (String name)

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

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

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

זריקות
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

זריקות
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

שיטה מסייעת למחיקת קובץ או ספרייה במכשיר.

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

זריקות
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

שיטה מסייעת למחיקת קובץ או ספרייה במכשיר.

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

זריקות
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

הסרת IDeviceActionReceiver הרשום.

פרמטרים
`deviceActionReceiver`	`IDeviceActionReceiver`: `IDeviceActionReceiver` שיימחקו.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

שיטה מסייעת לבדיקת הפעלה מחדש רכה של המכשיר, על ידי השוואה בין system_server הנוכחי לבין system_server הקודם ProcessInfo. משתמשים ב-getProcessByName(String) ומקבלים ProcessInfo.

פרמטרים
`prevSystemServerProcess`	`ProcessInfo`: התהליך הקודם של system_server‏ `ProcessInfo`.

החזרות
`boolean`	`true` אם המכשיר הופעל מחדש באופן רך

זריקות
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

שיטה מסייעת לבדיקת אם המכשיר הופעל מחדש באופן רך מאז שעון UTC מאז תחילת הזמן (epoch) מהמכשיר ומ-ERROR(/TimeUnit) שלו. הפעלה מחדש רכה מתייחסת להפעלה מחדש של system_server מחוץ להפעלה מחדש קשיחה של המכשיר (לדוגמה: הפעלה מחדש מבוקש). אפשר לקבל את utcEpochTime הנוכחי של המכשיר במיליסקונד באמצעות השיטה getDeviceDate().

פרמטרים
`utcEpochTime`	`long`: השעה במכשיר בשניות מאז תחילת הזמן.
`timeUnit`	`TimeUnit`: יחידת הזמן `TimeUnit` עבור utcEpochTime שצוין.

החזרות
`boolean`	`true` אם המכשיר הופעל מחדש באופן רך

זריקות
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

השבתת adb root.

השבתת adb root עלולה לגרום לנתק של המכשיר מ-adb. השיטה הזו תחסום את המכשיר עד שהוא יהיה זמין.

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

זריקות
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

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

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

זריקות
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

השבתת מעקב הרשת במכשיר.

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

זריקות
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

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

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

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

זריקות
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

החזרות
`boolean`	`true` אם הקובץ קיים, `false` אחרת.

זריקות
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

שיטה מסייעת לקביעת קיומו של קובץ במכשיר.

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

החזרות
`boolean`	`true` אם הקובץ קיים, `false` אחרת.

זריקות
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

ניסיון לדמפ את האוסף (heap) מ-system_server. זהו באחריות מבצע הקריאה לנקות את הקובץ שהועתק.

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

החזרות
`File`	`ERROR(/File)` שמכיל את הדוח. Null אם משהו נכשל.

זריקות
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

הפעלת adb root. אם ההגדרה 'enable-root' היא 'false', תירשם הודעה ביומן והפונקציה תוחזר בלי להפעיל את הרשאת root.

הפעלת adb root עלולה לגרום לנתק של המכשיר מ-adb. השיטה הזו תחסום את המכשיר עד שהוא יהיה זמין.

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

זריקות
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

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

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

זריקות
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

שיטת עזר שמפעילה פקודה של adb כפקודת מערכת עם זמן קצוב לתפוגה.

כשאפשר, כדאי להשתמש ב-executeShellCommand(String) במקום זאת, כי השיטה הזו מספקת ביצועים וזיהוי כשלים טובים יותר.

פרמטרים
`timeout`	`long`: הזמן באלפיות השנייה לפני שהמכשיר נחשב לא מגיב, 0L ללא זמן קצוב לתפוגה
`cmdArgs`	`String`: הפקודה adb והארגומנטים להרצה

החזרות
`String`	הפלט של הפקודה. `null` אם הפקודה נכשלה.

זריקות
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

שיטת עזר שמפעילה פקודה של adb כפקודת מערכת עם זמן קצוב לתפוגה.

כשאפשר, כדאי להשתמש ב-executeShellCommand(String) במקום זאת, כי השיטה הזו מספקת ביצועים וזיהוי כשלים טובים יותר.

פרמטרים
`timeout`	`long`: הזמן באלפיות השנייה לפני שהמכשיר נחשב לא מגיב, 0L ללא זמן קצוב לתפוגה
`envMap`	: הסביבה להגדרה של הפקודה
`cmdArgs`	`String`: הפקודה adb והארגומנטים להרצה

החזרות
`String`	הפלט של הפקודה. `null` אם הפקודה נכשלה.

זריקות
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

שיטת עזר שמריצה פקודה של adb כפקודת מערכת.

כשאפשר, כדאי להשתמש ב-executeShellCommand(String) במקום זאת, כי השיטה הזו מספקת ביצועים וזיהוי כשלים טובים יותר.

פרמטרים
`cmdArgs`	`String`: הפקודה adb והארגומנטים להרצה

החזרות
`String`	הפלט של הפקודה. `null` אם הפקודה נכשלה.

זריקות
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

שיטה מסייעת שמריצה פקודת fastboot כפקודת מערכת עם זמן קצוב לתפוגה כברירת מחדל של 2 דקות.

צפוי שייעשה בו שימוש כשהמכשיר כבר נמצא במצב Fastboot.

פרמטרים
`cmdArgs`	`String`: הפקודה והארגומנטים של fastboot להרצה

החזרות
`CommandResult`	ה-CommandResult שמכיל את הפלט של הפקודה

זריקות
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

שיטת עזר שמריצה פקודה של fastboot כפקודת מערכת.

צפוי שייעשה בו שימוש כשהמכשיר כבר נמצא במצב Fastboot.

פרמטרים
`timeout`	`long`: הזמן באלפיות השנייה עד לתפוגת התוקף של הפקודה
`cmdArgs`	`String`: הפקודה והארגומנטים של fastboot להרצה

החזרות
`CommandResult`	ה-CommandResult שמכיל את הפלט של הפקודה

זריקות
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

שיטת עזר שמפעילה פקודה ארוכה של fastboot כפקודת מערכת.

זהה ל-executeFastbootCommand(String), מלבד הזמן הקצוב לתפוגה הארוך יותר.

פרמטרים
`cmdArgs`	`String`: הפקודה והארגומנטים של fastboot להרצה

החזרות
`CommandResult`	ה-CommandResult שמכיל את הפלט של הפקודה

זריקות
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

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

זהה ל-executeFastbootCommand(String), מלבד הזמן הקצוב לתפוגה הארוך יותר.

פרמטרים
`envVarMap`	: משתני הסביבה של המערכת שבהם פועלת הפקודה fastboot
`cmdArgs`	`String`: הפקודה והארגומנטים של fastboot להרצה

החזרות
`CommandResult`	ה-CommandResult שמכיל את הפלט של הפקודה

זריקות
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

שיטה מסייעת שמפעילה פקודה של adb shell ומחזירה את הפלט כ-String.

פרמטרים
`command`	`String`: פקודת מעטפת adb להרצה

החזרות
`String`	הפלט של המעטפת

זריקות
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.

פרמטרים
`command`	`String`: פקודת מעטפת adb להרצה
`receiver`	`IShellOutputReceiver`: ה-`IShellOutputReceiver` שאליו מפנים את הפלט של המעטפת.
`maxTimeToOutputShellResponse`	`long`: משך הזמן המקסימלי שבו מותר לפקודה לא להפיק תגובה כלשהי. היחידות הן כפי שצוינו ב-`timeUnit`.
`timeUnit`	`TimeUnit`: היחידה של `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: מספר הניסיונות המקסימלי לניסיון חוזר של הפקודה אם היא נכשלת בגלל חריג. תופיע הודעת DeviceNotResponsiveException אם הפונקציות `retryAttempts` לא יבוצעו בהצלחה.

זריקות
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.

פרמטרים
`command`	`String`: פקודת מעטפת adb להרצה
`receiver`	`IShellOutputReceiver`: ה-`IShellOutputReceiver` שאליו מפנים את הפלט של המעטפת.
`maxTimeoutForCommand`	`long`: הזמן המקסימלי לתפוגה להשלמת הפקודה. היחידות מצוינות ב-`timeUnit`.
`maxTimeToOutputShellResponse`	`long`: משך הזמן המקסימלי שבו מותר לפקודה לא להפיק תגובה כלשהי. היחידות הן כפי שצוינו ב-`timeUnit`.
`timeUnit`	`TimeUnit`: היחידה של `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: מספר הניסיונות המקסימלי לניסיון חוזר של הפקודה אם היא נכשלת בגלל חריג. תופיע הודעת DeviceNotResponsiveException אם הפעולות של `retryAttempts` לא יבוצעו בהצלחה.

זריקות
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

צורה פשוטה יותר של executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) עם ערכי ברירת מחדל.

פרמטרים
`command`	`String`: פקודת מעטפת adb להרצה
`receiver`	`IShellOutputReceiver`: ה-`IShellOutputReceiver` שאליו מפנים את הפלט של המעטפת.

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

שיטה מסייעת שמריצה פקודה של מעטפת adb ומחזירה את התוצאות כ-CommandResult שמאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.

פרמטרים
`cmd`	`String`: הפקודה שצריך להריץ.

החזרות
`CommandResult`	התוצאה ב-`CommandResult`.

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

שיטה מסייעת שמפעילה את הפקודה adb shell ומחזירה את התוצאות כ-CommandResult שמאוכלס כראוי בפלט של סטטוס הפקודה וב-stderr. הפלט של stdout מופנה לזרם שצוין.

פרמטרים
`cmd`	`String`: הפקודה שצריך להריץ.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` – היעד שאליו יועבר הפלט של std, או null.

החזרות
`CommandResult`	התוצאה ב-`CommandResult`.

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

פרמטרים
`cmd`	`String`: הפקודה שצריך להריץ.
`pipeAsInput`	`File`: ערך `ERROR(/File)` שיעבור צינור כקלט לפקודה, או ערך null.

החזרות
`CommandResult`	התוצאה ב-`CommandResult`.

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.

פרמטרים
`cmd`	`String`: פקודת מעטפת adb להרצה
`maxTimeoutForCommand`	`long`: הזמן המקסימלי לתפוגה להשלמת הפקודה. היחידות מצוינות ב-`timeUnit`.
`timeUnit`	`TimeUnit`: היחידה של `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: מספר הניסיונות המקסימלי לניסיון חוזר של הפקודה אם היא נכשלת בגלל חריג. תופיע הודעת DeviceNotResponsiveException אם הפעולות של `retryAttempts` לא יבוצעו בהצלחה.

החזרות
`CommandResult`

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.

פרמטרים
`cmd`	`String`: פקודת מעטפת adb להרצה
`maxTimeoutForCommand`	`long`: הזמן המקסימלי לתפוגה להשלמת הפקודה. היחידות מצוינות ב-`timeUnit`.
`timeUnit`	`TimeUnit`: היחידה של `maxTimeToOutputShellResponse`

החזרות
`CommandResult`

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.

פרמטרים
`cmd`	`String`: פקודת מעטפת adb להרצה
`pipeAsInput`	`File`: ערך `ERROR(/File)` שיעבור צינור כקלט לפקודה, או ערך null.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` – היעד שאליו יועבר הפלט של std, או null.
`maxTimeoutForCommand`	`long`: הזמן המקסימלי לתפוגה להשלמת הפקודה. היחידות מצוינות ב-`timeUnit`.
`timeUnit`	`TimeUnit`: היחידה של `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: מספר הניסיונות המקסימלי לניסיון חוזר של הפקודה אם היא נכשלת בגלל חריג. תופיע הודעת DeviceNotResponsiveException אם הפעולות של `retryAttempts` לא יבוצעו בהצלחה.

החזרות
`CommandResult`

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

הפעלת פקודת מעטפת adb עם פרמטרים נוספים לצורך בקרה על התנהגות הפקודה.

פרמטרים
`cmd`	`String`: פקודת מעטפת adb להרצה
`pipeAsInput`	`File`: ערך `ERROR(/File)` שיעבור צינור כקלט לפקודה, או ערך null.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` – היעד שאליו יועבר הפלט של std, או null.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` – היעד שאליו תופנה שגיאת סטנדרטית, או null.
`maxTimeoutForCommand`	`long`: הזמן המקסימלי לתפוגה להשלמת הפקודה. היחידות מצוינות ב-`timeUnit`.
`timeUnit`	`TimeUnit`: היחידה של `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: מספר הניסיונות המקסימלי לניסיון חוזר של הפקודה אם היא נכשלת בגלל חריג. תופיע הודעת DeviceNotResponsiveException אם הפעולות של `retryAttempts` לא יבוצעו בהצלחה.

החזרות
`CommandResult`

זריקות
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

שיטה מסייעת שמוחקת מחיצה במכשיר.

אם הערך של getUseFastbootErase() הוא true, המערכת תשתמש בפקודה fastboot erase כדי למחוק את המחיצה. לאחר מכן, המכשיר יצטרך ליצור מערכת קבצים בפעם הבאה שהוא יופעל. אחרת, המערכת תשתמש בפורמט fastboot ותצור מערכת קבצים חדשה במכשיר.

צפוי שייעשה בו שימוש כשהמכשיר כבר נמצא במצב Fastboot.

פרמטרים
`partition`	`String`: המחיצה שרוצים למחוק

החזרות
`CommandResult`	ה-CommandResult שמכיל את הפלט של הפקודה

זריקות
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

אחזור המידע על ה-APEXes שהופעלו במכשיר.

החזרות
	`ERROR(/Set)` מתוך `ApexInfo` הופעלו כרגע במכשיר

זריקות
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

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

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

החזרות
	המפה של צמדי המפתחות/הערכים. הערך Null אם מרחב השמות לא נתמך.

זריקות
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

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

החזרות
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

חיפוש והחזרת הערך של android-id שמשויך למשתמש, או null אם לא נמצא.

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

החזרות
`String`

זריקות
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

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

החזרות
	מפה של מזהי Android שמצאו מזהי משתמשים תואמים.

זריקות
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

אחזור רמת ה-API של המכשיר. ברירת המחדל היא UNKNOWN_API_LEVEL.

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

זריקות
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

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

זריקות
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

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

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

זריקות
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

שיטה נוחה לקבלת גרסת פס הבסיס (הרדיו) של המכשיר הזה. אחזור גרסת הרדיו ספציפי למכשיר, ולכן יכול להיות שהמידע לא יוחזר בצורה נכונה בכל המכשירים. השיטה הזו מסתמכת על המאפיין gsm.version.baseband כדי להחזיר את פרטי הגרסה הנכונים. הנתון הזה לא מדויק במכשירי CDMA מסוימים, וייתכן שהגרסה שתוחזר כאן לא תתאים לגרסה שדווחה מ-fastboot, וייתכן שהיא לא תחזיר את הגרסה של הרדיו ב-CDMA. אמ;לק: השיטה הזו מדווחת על גרסה מדויקת רק אם המאפיין gsm.version.baseband זהה לגרסה שמוחזרת על ידי fastboot getvar version-baseband.

החזרות
`String`	גרסת פס הבסיס `String` או `null` אם לא ניתן לקבוע אותה (אין מכשיר רדיו או ששרשור הגרסה לא ניתן לקריאה)

זריקות
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

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

החזרות
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

פרמטרים
`name`	`String`: שם הנכס
`defaultValue`	`boolean`: ערך ברירת המחדל להחזרה אם המאפיין ריק או לא קיים.

החזרות
`boolean`	`true` אם הערך של המאפיין הוא `"1"`,‏ `"y"`,‏ `"yes"`,‏ `"on"` או `"true"`,‏ `false` אם הערך של המאפיין הוא `"0"`,‏ `"n"`,‏ `"no"`,‏ `"off"`,‏ `"false"` או `defaultValue` במקרים אחרים.

זריקות
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

שיטת העזר אוספת את המפה של היסטוריית האתחול עם זמן האתחול והסיבה לאתחול.

החזרות
	מפה של זמן האתחול (שעון UTC בשניות מאז תחילת הזמן) ושל הסיבה לאתחול

זריקות
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

שיטת העזר אוספת את המפה של היסטוריית האתחול עם זמן האתחול והסיבה לאתחול מאז הזמן שצוין מאז תחילת הזמן (epoch) מהמכשיר ומיחידת הזמן שצוינה. אפשר לקבל את utcEpochTime הנוכחי של המכשיר במיליסיקון באמצעות השיטה getDeviceDate().

פרמטרים
`utcEpochTime`	`long`: השעה במכשיר מאז Epoch.
`timeUnit`	`TimeUnit`: יחידת הזמן `TimeUnit`.

החזרות
	מפה של זמן האתחול (שעון UTC בשניות מאז תחילת הזמן) ושל הסיבה לאתחול

זריקות
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

שיטה נוחה לקבלת גרסת תוכנת האתחול של המכשיר הזה.

המערכת תנסה לאחזר את גרסת האתחול מהמצב הנוכחי של המכשיר. (כלומר, אם המכשיר נמצא במצב Fastboot, הוא ינסה לאחזר את הגרסה מ-Fastboot)

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

זריקות
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

יש תמיכה רק ב-'adb version' > 1.0.36

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

getBuildAlias

public String getBuildAlias ()

אחזור הכינוי של ה-build שפועל כרגע במכשיר.

בדרך כלל, הכינוי של ה-build הוא מחרוזת שקל יותר לקרוא מאשר מזהה ה-build (בדרך כלל מספר ל-builds של Nexus). לדוגמה, לגרסה הסופית של Android 4.2 יש כינוי build‏ JDQ39 ומזהה build‏ 573038

החזרות
`String`	הכינוי של ה-build, או חזרה למזהה ה-build אם לא ניתן היה לאחזר אותו

זריקות
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

אחזור של סוג ה-build של המכשיר.

החזרות
`String`	סוג ה-build או null אם לא ניתן היה לאחזר אותו

זריקות
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

אחזור של גרסת ה-build שפועלת כרגע במכשיר.

החזרות
`String`	מזהה ה-build או `IBuildInfo.UNKNOWN_BUILD_ID` אם לא ניתן היה לאחזר אותו

זריקות
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

החזרות
`String`	מפתח החתימה אם הוא נמצא, null אחרת.

זריקות
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

החזרות
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

פרמטרים
`shortDescriptor`	`boolean`: האם להגביל את התיאור למידע מינימלי בלבד

החזרות
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

חלופה לשימוש ב-IFileEntry, שפעמים רבות לא עובדת בגלל הרשאות.

פרמטרים
`path`	`String`: הנתיב במכשיר שבו מתבצע החיפוש

החזרות
`String[]`	מערך של מחרוזת שמכיל את כל הקובץ בנתיב במכשיר.

זריקות
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

החיבור הנוכחי שמשויך למכשיר.

החזרות
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

הפונקציה מחזירה את ContentProviderHandler או ערך null אם הוא לא זמין.

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

פרמטרים
`userId`	`int`: מזהה המשתמש שמשמש לאינטליקציה של ספק התוכן.

החזרות
`ContentProviderHandler`

זריקות
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

החזרות
`DeviceFoldableState`

זריקות
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

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

החזרות
`int`

זריקות
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

אחזור של סיווג המכשיר.

החזרות
`String`	סוג המכשיר `String`.

getDeviceDate

public long getDeviceDate ()

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

החזרות
`long`	התאריך של המכשיר בפורמט epoch.

זריקות
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

החזרת DeviceDescriptor מתוך פרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.

החזרות
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

החזרת DeviceDescriptor מתוך פרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.

פרמטרים
`shortDescriptor`	`boolean`: האם להגביל את התיאור למידע מינימלי בלבד

החזרות
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

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

החזרות
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

פונקציית עזרה לקבלת הפרש השעות בין המכשיר לבין ERROR(/Date) נתון. שימוש בזמן מערכת (Epoch) באופן פנימי.

פרמטרים
`date`	`Date`

החזרות
`long`	ההפרש באלפיות השנייה

זריקות
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

אחזור של הזרם של stdout ו-stderr של האמולטור

החזרות
`InputStreamSource`	פלט של אמולטור

getEmulatorProcess

public Process getEmulatorProcess ()

מחזירים את הערך של Process התואם לאמולטור הזה.

החזרות
`Process`	`Process` או `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

היומן שמכיל את כל היומנים של executeShellCommand(String).

החזרות
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

החזרות
`long`	נפח האחסון הפנוי ב-KB

זריקות
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

הפונקציה מחזירה את הנתיב של קובץ ה-binary של fastboot שבו נעשה שימוש. עדיין צריך שהערך של isFastbootEnabled() יהיה true כדי להפעיל את הפונקציות של fastboot.

החזרות
`String`

getFastbootProductType

public String getFastbootProductType ()

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

יש להשתמש בשיטה הזו רק אם המכשיר צריך להיות במצב fastboot. זוהי וריאנט בטוח יותר מהשיטה הגנרית getProductType() במקרה הזה, כי ITestDevice תדע לשחזר את המכשיר למצב fastboot אם המכשיר נמצא במצב שגוי או לא מגיב.

החזרות
`String`	שם סוג המוצר `String` או `null` אם לא ניתן לקבוע אותו

זריקות
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב Fastboot.

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

החזרות
`String`	שם סוג המוצר `String` או `null` אם לא ניתן לקבוע אותו

זריקות
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

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

החזרות
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

אחזור הערך של משתנה fastboot מהמכשיר.

פרמטרים
`variableName`	`String`: שם המשתנה

החזרות
`String`	ערך המאפיין או `null` אם הוא לא קיים

זריקות
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

הפונקציה מחזירה את מחרוזת הגרסה של קובץ ה-binary של fastboot שבו נעשה שימוש. או null אם משהו משתבש.

החזרות
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

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

פרמטרים
`path`	`String`: נתיב הקובץ לאחזור. יכול להיות נתיב מוחלט או נתיב יחסי ל-'‎/'. (כלומר, יש תמיכה בתחביר '‎/system' וגם בתחביר 'system')

החזרות
`IFileEntry`	`IFileEntry` או `null` אם לא ניתן למצוא את הקובץ ב-`path`

זריקות
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

פרמטרים
`entry`	`FileListingService.FileEntry`: `FileEntry` לא חייב להיות ברמה הבסיסית (root) כפי שנדרש ב-Ddmlib.

החזרות
`IFileEntry`	אובייקט FileEntryWrapper שמייצג את FileEntry.

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

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

החזרות

זריקות
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

הפונקציה מחזירה הפניה ל-IDevice של ddmlib המשויך.

ייתכן ש-DDMS תקצה IDevice חדש בכל פעם שהמכשיר יתנתק ויתחבר מחדש ל-adb. לכן, מבצעי הקריאה החוזרת לא צריכים לשמור הפניה ל-IDevice, כי ההפניה הזו עשויה להיות לא עדכנית.

החזרות
`IDevice`	`IDevice`

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

זריקות
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

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

פרמטרים
`name`	`String`: שם הנכס
`defaultValue`	`long`: ערך ברירת המחדל להחזרה אם המאפיין ריק או לא קיים.

החזרות
`long`	ערך המאפיין או `defaultValue` אם המאפיין ריק, לא קיים או שאין לו ערך שלם.

זריקות
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

אחזור כתובת ה-IP של המכשיר.

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

זריקות
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

זריקות
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

הפונקציה מחזירה את הפעם האחרונה שבה ממשקי ה-API של Tradefed גרמו להפעלה מחדש, במיליוניות השנייה מאז EPOCH, כפי שהוחזר על ידי System.currentTimeMillis().

החזרות
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

אחזור של רמת ה-API הראשונה שהמכשיר הושק איתה. ברירת המחדל היא UNKNOWN_API_LEVEL.

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

זריקות
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

אחזור של קובץ snapshot של נתוני logcat.

הוא פועל בשני מצבים:

אם ה-logcat מתועד כרגע ברקע, הפונקציה מחזירה עד TestDeviceOptions.getMaxLogcatDataSize() בייטים מהתוכן הנוכחי של התיעוד של ה-logcat ברקע

אחרת, אם המכשיר מגיב כרגע, תוחזר גרסת dump סטטית של נתוני logcat

החזרות
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

יצירת סטרימינג של תמונת מצב של maxBytes הנתונים האחרונים של logcat שצולמו.

האפשרות הזו שימושית במקרים שבהם רוצים לצלם קובצי snapshot תכופים של נתוני logcat שנאספו, בלי לשלם את העונש הגדול שעלול להיות על נפח האחסון בדיסק בגלל יצירת קובץ ה-snapshot המלא של getLogcat().

פרמטרים
`maxBytes`	`int`: כמות הנתונים המקסימלית להחזרה. צריך להיות סכום שיכול להיכנס בנוחות לזיכרון

החזרות
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

קבלת גרסת dump של logcat הנוכחי של המכשיר. בניגוד ל-getLogcat(), השיטה הזו תמיד תחזיר דמפ סטטי של logcat.

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

החזרות
`InputStreamSource`	`InputStreamSource` של נתוני logcat. אם לא ניתן לתעד את נתוני logcat, יוחזר מקור נתונים ריק.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

אחזור של זרם snapshot של נתוני logcat שצולמו החל מהתאריך שצוין. צריך להשתמש בשעון של המכשיר getDeviceDate().

פרמטרים
`date`	`long`: בפורמט של אלפיות שנייה מאז תחילת הזמן (epoch) של יצירת קובץ ה-snapshot ועד היום. (אפשר לקבל אותו באמצעות 'date +%s')

החזרות
`InputStreamSource`

getMacAddress

public String getMacAddress ()

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

החזרות
`String`

getMainUserId

public Integer getMainUserId ()

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

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

זריקות
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

זריקות
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

זריקות
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

זריקות
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

החזרות
`Process`	הפונקציה מחזירה את התהליך של מכונה וירטואלית של Microdroid. אם TestDevice הוא לא Microdroid, הפונקציה מחזירה את הערך null.

getMonitor

public IDeviceStateMonitor getMonitor ()

מחזירים את הערך של IDeviceStateMonitor שמשויך למכשיר.

החזרות
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

הפונקציה מחזירה נקודת טעינה.

שולחת שאילתה ישירות למכשיר אם המידע ששמור במטמון ב-IDevice לא זמין.

TODO: move this behavior to IDevice.getMountPoint(String)

פרמטרים
`mountName`	`String`: שם נקודת הטעינה

החזרות
`String`	נקודת הטעינה או `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

החזרות
`ITestDevice.MountPointInfo`	`ERROR(/List)` של `MountPointInfo` שמכיל את המידע שב-"/proc/mounts"

זריקות
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

הפונקציה מחזירה גרסה מפוענחת של המידע שב-/proc/mounts במכשיר

החזרות
	`ERROR(/List)` של `MountPointInfo` שמכיל את המידע בקובץ ‎/proc/mounts

זריקות
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

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

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

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

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

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

החזרות
`long`	נפח האחסון הפנוי ב-KB

זריקות
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

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

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

זריקות
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

שיטת העזרה מפעילה את הפקודות pidof ו-stat ומחזירה אובייקט ProcessInfo עם PID וזמן ההתחלה של התהליך הנתון.

פרמטרים
`processName`	`String`: מחרוזת שם התהליך.

החזרות
`ProcessInfo`	ProcessInfo של processName נתון

זריקות
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

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

פרמטרים
`process`	`String`: מחרוזת שם התהליך.

החזרות
`String`

זריקות
`DeviceNotAvailableException`

getProductType

public String getProductType ()

שיטה נוחה לקבלת סוג המוצר של המכשיר הזה.

השיטה הזו תפעל אם המכשיר נמצא במצב adb או במצב Fastboot.

החזרות
`String`	שם סוג המוצר `String`. לא יהיה null

זריקות
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

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

השיטה הזו תפעל אם המכשיר נמצא במצב adb או במצב Fastboot.

החזרות
`String`	שם הווריאציה של המוצר `String` או `null` אם לא ניתן לקבוע אותו

זריקות
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

אחזור הערך של המאפיין הנתון מהמכשיר.

פרמטרים
`name`	`String`: שם הנכס

החזרות
`String`	ערך המאפיין או `null` אם הוא לא קיים

זריקות
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

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

החזרות
`ITestDevice.RecoveryMode`	מצב השחזור הנוכחי שבו המכשיר נמצא.

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

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

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

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

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

זריקות
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

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

החזרות
`String`	המספר הסידורי `String`

getSetting

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

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

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

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

זריקות
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

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

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

החזרות
`String`

זריקות
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

מחזירים את המפעיל של כרטיס ה-SIM או null אם הוא לא זמין או אם המכשיר לא זמין.

החזרות
`String`

getSimState

public String getSimState ()

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

החזרות
`String`

getTombstones

public  getTombstones ()

אחזור של רשימת המכשירים מהמכשירים והחזרתה. נדרשת הרשאת root.

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

החזרות
	רשימה של קובצי tombstone, ריקה אם אין קובץ tombstone.

זריקות
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

הפונקציה מחזירה את נפח הזיכרון הפיזי הכולל בבייטים, או -1 במקרה של שגיאה פנימית

החזרות
`long`

getTrackingSerial

public String getTrackingSerial ()

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

החזרות
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

זריקות
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

בודקים אם להשתמש ב-fastboot erase או ב-fastboot format כדי למחוק מחיצה במכשיר.

החזרות
`boolean`	`true` אם ייעשה שימוש ב-fastboot erase או `false` אם ייעשה שימוש ב-fastboot format.

getUserFlags

public int getUserFlags (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

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

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

זריקות
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

החזרות
`int`

זריקות
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

עיבוד של האירוע DeviceEvent. יכול להיות שהמכשיר יועבר למצב חדש. תודיע ל-IDeviceMonitor על כל מעבר מצב.

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

פרמטרים
`event`	`DeviceEvent`

החזרות
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

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

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

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

זריקות
`DeviceNotAvailableException`

installPackage

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

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

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

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

זריקות
`DeviceNotAvailableException`

installPackage

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

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

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

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

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

זריקות
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

התקנה של חבילת Android במכשיר של משתמש נתון.

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

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

זריקות
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

התקנה של חבילת Android במכשיר של משתמש נתון.

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

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

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

זריקות
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

החזרות
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

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

זריקות
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

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

החזרות
`boolean`	הערך הוא True אם יש תמיכה בניתוב סבבי של חסימה של גרסת SDK עם יעד נמוך, ו-False אחרת

זריקות
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

בודקים אם ה-debugfs מוצמד.

החזרות
`boolean`	`true` אם המערכת מותקנת ב-debugfs

זריקות
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

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

החזרות
`boolean`	`true` אם המכשיר מוצפן.

זריקות
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

החזרות
`boolean`	`true` אם צריך להפעיל את adb root במכשיר

isEncryptionSupported

public boolean isEncryptionSupported ()

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

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

זריקות
`DeviceNotAvailableException`

isExecutable

public boolean isExecutable (String fullPath)

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

חוזרים אם הכלי לאתחול מהיר (fastboot) זמין למכשיר.

החזרות
`boolean`

isHeadless

public boolean isHeadless ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

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

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

זריקות
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

זריקות
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

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

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

זריקות
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

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

החזרות
`boolean`	הערך TRUE אם יש תמיכה בהרשאות בזמן ריצה, ו-FALSE אחרת.

זריקות
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

הפונקציה מחזירה את הערך true אם המכשיר נמצא ב-TestDeviceState.FASTBOOT או ב-TestDeviceState.FASTBOOTD.

החזרות
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

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

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

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

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

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

זריקות
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

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

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

זריקות
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

החזרות

זריקות
`DeviceNotAvailableException`

listUsers

public  listUsers ()

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

החזרות
	רשימת מזהי המשתמשים.

זריקות
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

איסוף דיווחים על ANR מהמכשיר ורישום שלהם ביומן.

פרמטרים
`logger`	`ITestLogger`: `ITestLogger` לתיעוד מקרי ה-ANR.

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

זריקות
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

שיטה מסייעת ליצירת דוח באג ולתיעודו ביומן של המדווחים.

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

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

logOnDevice

public void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

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

פרמטרים
`tag`	`String`: התג שבו אנחנו מתעדים את ההודעה ב-logcat.
`level`	`Log.LogLevel`: רמת ניפוי הבאגים של ההודעה ב-logcat.
`format`	`String`: פורמט ההודעה.
`args`	`Object`: הארגומנטים שרוצים להחליף באמצעות String.format().

mountDebugfs

public void mountDebugfs ()

מחברים את debugfs.

זריקות
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

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

זריקות
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

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

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postAdbUnrootAction

public void postAdbUnrootAction ()

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

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public void postBootSetup ()

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

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

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

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

זריקות
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

preInvocationSetup

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

שלבים נוספים להגדרה הנדרשת ספציפית למכשיר, שיתבצעו במכשיר לפני תהליך ההפעלה.

פרמטרים
`info`	`IBuildInfo`: ה-`IBuildInfo` של המכשיר.
`attributes`	`MultiMap`: המאפיינים שמאוחסנים בהקשר של הקריאה

זריקות
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

אחזור חזרה (recursive) של תוכן הספרייה מהמכשיר.

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

החזרות
`boolean`	`true` אם הקובץ נשלף בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

אחזור חזרה (recursive) של תוכן הספרייה מהמכשיר.

פרמטרים
`deviceFilePath`	`String`: הנתיב המוחלט של קובץ המקור המרוחק
`localDir`	`File`: הספרייה המקומית שאליה יישלפו הקבצים

החזרות
`boolean`	`true` אם הקובץ נשלף בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

אחזור קובץ מהמכשיר.

פרמטרים
`remoteFilePath`	`String`: הנתיב המוחלט לקובץ במכשיר.
`localFile`	`File`: הקובץ המקומי שבו יישמרו התוכן. אם הוא לא ריק, התוכן יוחלף.

החזרות
`boolean`	`true` אם הקובץ אוחזר בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

הפונקציה מאחזרת קובץ מהמכשיר, שומרת אותו ב-ERROR(/File) זמני מקומי ומחזירה את ה-File הזה.

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

החזרות
`File`	`ERROR(/File)` שמכיל את תוכן קובץ המכשיר, או `null` אם ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח)

זריקות
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

הפונקציה מאחזרת קובץ מהמכשיר, שומרת אותו ב-ERROR(/File) זמני מקומי ומחזירה את ה-File הזה.

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

החזרות
`File`	`ERROR(/File)` שמכיל את תוכן קובץ המכשיר, או `null` אם ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח)

זריקות
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

אחזור קובץ מהמכשיר.

פרמטרים
`remoteFilePath`	`String`: הנתיב המוחלט לקובץ במכשיר.
`localFile`	`File`: הקובץ המקומי שבו יישמרו התוכן. אם הוא לא ריק, התוכן יוחלף.
`userId`	`int`: מזהה המשתמש שממנו רוצים למשוך את הנתונים

החזרות
`boolean`	`true` אם הקובץ אוחזר בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

אחזור קובץ מהמכשיר והחזרת התוכן.

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

החזרות
`String`	`String` שמכיל את תוכן קובץ המכשיר, או `null` אם ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח)

זריקות
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

שיטה נוחה לאחזור קובץ מהאחסון החיצוני של המכשיר, לשמירתו ב-ERROR(/File) זמני מקומי ולהחזרת הפניה ל-File הזה.

פרמטרים
`remoteFilePath`	`String`: הנתיב לקובץ במכשיר, ביחס לנקודת הטעינה של האחסון החיצוני במכשיר

החזרות
`File`	`ERROR(/File)` שמכיל את תוכן קובץ המכשיר, או `null` אם ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח)

זריקות
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

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

פרמטרים
`localFileDir`	`File`: הספרייה המקומית שרוצים לדחוף
`deviceFilePath`	`String`: נתיב הקובץ המוחלט של היעד המרוחק
`excludedDirectories`	: קבוצה של שמות של ספריות שלא נכללות, שאין לדחוף אותן.

החזרות
`boolean`	`true` אם הקובץ הועבר בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

שליחת תוכן הספרייה למכשיר באופן רספונסיבי.

פרמטרים
`localFileDir`	`File`: הספרייה המקומית שרוצים לדחוף
`deviceFilePath`	`String`: נתיב הקובץ המוחלט של היעד המרוחק

החזרות
`boolean`	`true` אם הקובץ הועבר בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

שליחת תוכן הספרייה למכשיר באופן רספונסיבי.

פרמטרים
`localFileDir`	`File`: הספרייה המקומית שרוצים לדחוף
`deviceFilePath`	`String`: נתיב הקובץ המוחלט של היעד המרוחק
`userId`	`int`: מזהה המשתמש שרוצים לדחוף אליו

החזרות
`boolean`	`true` אם הקובץ הועבר בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

וריאנט של pushFile(File, String) שיכול להביא בחשבון הערכה של הצורך של ספק התוכן.

פרמטרים
`localFile`	`File`: הקובץ המקומי שרוצים לדחוף
`remoteFilePath`	`String`: הנתיב המוחלט של הקובץ ביעד המרוחק
`evaluateContentProviderNeeded`	`boolean`: האם לבדוק אם אנחנו זקוקים לספק התוכן

החזרות
`boolean`	`true` אם הקובץ הועבר בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

פרמטרים
`localFile`	`File`: הקובץ המקומי שרוצים לדחוף
`remoteFilePath`	`String`: הנתיב המוחלט של הקובץ ביעד המרוחק

החזרות
`boolean`	`true` אם הקובץ הועבר בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                int userId)

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

פרמטרים
`localFile`	`File`: הקובץ המקומי שרוצים לדחוף
`remoteFilePath`	`String`: הנתיב המוחלט של הקובץ ביעד המרוחק
`userId`	`int`: מזהה המשתמש שרוצים לדחוף אליו

החזרות
`boolean`	`true` אם הקובץ הועבר בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

דחיפת קובץ שנוצר ממחרונית למכשיר

פרמטרים
`contents`	`String`: תוכן הקובץ שרוצים לדחוף
`remoteFilePath`	`String`: הנתיב המוחלט של הקובץ ביעד המרוחק

החזרות
`boolean`	`true` אם המחרוזת הועברה בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

הפעלה מחדש

public void reboot (String reason)

הפעלה מחדש של המכשיר למצב adb עם reason נתון שיישמר לאחר ההפעלה מחדש.

החסימה נמשכת עד שהמכשיר זמין.

אפשר לקבל את הסיבה האחרונה להפעלה מחדש על ידי שליחת שאילתה לנכס sys.boot.reason.

פרמטרים
`reason`	`String`: הסיבה להפעלה מחדש הזו, או `null` אם לא צוינה סיבה.

זריקות
`DeviceNotAvailableException`

הפעלה מחדש

public void reboot ()

הפעלה מחדש של המכשיר למצב adb.

החסימה נמשכת עד שהמכשיר זמין.

זריקות
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

זריקות
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

הפעלה מחדש של המכשיר למצב fastbootd.

החסימה נמשכת עד שהמכשיר נמצא במצב fastbootd.

זריקות
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

הפעלה מחדש של המכשיר למצב שחזור adb.

החסימה נמשכת עד שהמכשיר נכנס למצב שחזור

זריקות
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

הפעלה מחדש של המכשיר למצב התקנה ממקור לא ידוע ב-ADB (שימו לב: זהו מצב מיוחד במסגרת התאוששות)

החסימה נמשכת עד שהמכשיר עובר למצב העברה צדדית

זריקות
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

הפעלה מחדש של המכשיר למצב התקנה ממקור לא ידוע ב-ADB (שימו לב: זהו מצב מיוחד במסגרת התאוששות)

החסימה נמשכת עד שהמכשיר עובר למצב העברה צדדית

פרמטרים
`autoReboot`	`boolean`: האם להפעיל מחדש את המכשיר באופן אוטומטי אחרי התקנה צדדית

זריקות
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

חלופה ל-reboot() שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.

זריקות
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

חלופה ל-reboot() שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.

פרמטרים
`reason`	`String`: הסיבה להפעלה מחדש הזו, או `null` אם לא צוינה סיבה.

זריקות
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

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

החסימה נמשכת עד שהמכשיר זמין.

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

זריקות
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

חלופה ל-rebootUserspace() ()} שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.

זריקות
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

ניסיון לשחזור התקשורת עם המכשיר.

החזרות
`boolean`	הפונקציה מחזירה את הערך True אם בוצע ניסיון לשחזור והוא הצליח, והיא מחזירה את הערך False אם השחזור דלג

זריקות
`DeviceNotAvailableException`	אם המכשיר כבר לא זמין

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

הרשמה של IDeviceActionReceiver למכשיר הזה.

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

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

remountSystemReadOnly

public void remountSystemReadOnly ()

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

זריקות
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

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

זריקות
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

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

זריקות
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

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

זריקות
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

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

זריקות
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

הסרת משתמש נתון מהמכשיר.

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

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

זריקות
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

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

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                ITestLifeCycleReceiver... listeners)

שיטה נוחה לביצוע ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) עם מאזין אחד או יותר שמועברים כפרמטרים.

פרמטרים
`runner`	`IRemoteAndroidTestRunner`: ה-`IRemoteAndroidTestRunner` שמריץ את הבדיקות
`listeners`	`ITestLifeCycleReceiver`: פונקציות ה-listener של תוצאות הבדיקה

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

זריקות
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

הרצת בדיקות של מכשירי מדידה, ותיקון מכשירי Android.

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

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

פרמטרים
`runner`	`IRemoteAndroidTestRunner`: ה-`IRemoteAndroidTestRunner` שמריץ את הבדיקות
`listeners`	: פונקציות ה-listener של תוצאות הבדיקה

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

זריקות
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                 listeners)

זהה ל-ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), אבל הבדיקה מופעלת עבור המשתמש הנתון.

פרמטרים
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

זהה ל-ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), אבל הבדיקה פועלת עבור משתמש נתון.

פרמטרים
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

setConfiguration

public void setConfiguration (IConfiguration configuration)

הזרקת IConfiguration בשימוש.

פרמטרים
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

פרמטרים
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

הגדרת התאריך במכשיר

הערה: כדי להגדיר תאריך במכשיר, צריך הרשאת root

פרמטרים
`date`	`Date`: ציון תאריך מסוים. אם לא יצוין `Date`, המערכת תשתמש בתאריך של המארח.`null`

זריקות
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

מעדכנים את מצב המכשיר.

פרמטרים
`deviceState`	`TestDeviceState`: `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

במהלך הדמיה, מגדירים את SizeLimitedOutputStream לתיעוד הפלט

פרמטרים
`output`	`SizeLimitedOutputStream`: כדי לתעד את הפלט ביומן

setEmulatorProcess

public void setEmulatorProcess (Process p)

מגדיר את Process כשהמכשיר הזה הוא אמולטור.

פרמטרים
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

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

פרמטרים
`fastbootEnabled`	`boolean`: האם הכלי לאתחול מהיר (fastboot) זמין במכשיר או לא

setFastbootPath

public void setFastbootPath (String fastbootPath)

הגדרת הנתיב לקובץ הבינארי של fastboot שבו צריך להשתמש. עדיין צריך שהערך של isFastbootEnabled() יהיה true כדי להפעיל את הפונקציות של fastboot.

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

setIDevice

public void setIDevice (IDevice newDevice)

מעדכנים את IDevice שמשויך ל-ITestDevice הזה.

מכשיר ה-IDevice החדש צריך להפנות לאותו מכשיר פיזי כמו ההפניה הנוכחית. השיטה הזו תופעל אם DDMS הקצתה IDevice חדש

פרמטרים
`newDevice`	`IDevice`: `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

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

פרמטרים
`delay`	`int`: העיכוב במילישניות

setOptions

public void setOptions (TestDeviceOptions options)

הגדרת TestDeviceOptions למכשיר

פרמטרים
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

הגדרת ערך המאפיין במכשיר. נדרש שהרשאת root ב-adb תהיה True.

פרמטרים
`propKey`	`String`: המפתח שרוצים להגדיר.
`propValue`	`String`: ערך המאפיין שרוצים להגדיר.

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

זריקות
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

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

פרמטרים
`recovery`	`IDeviceRecovery`: `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

משמש לקביעת שיטת השחזור שתופעל כשמתרחשת בעיה בתקשורת עם המכשיר. מומלץ להשתמש בשיטה הזו רק במקרים שבהם יש צורך (למשל, כשה-framework מושבת וכו').

פרמטרים
`mode`	`ITestDevice.RecoveryMode`: האם צריך להפעיל את המצב 'שחזור עד אופליין בלבד'.

setSetting

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

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

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

זריקות
`DeviceNotAvailableException`

setSetting

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

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

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

זריקות
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

החדרת המכונה ITestLogger

פרמטרים
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

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

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

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

מגדירים אם להשתמש ב-fastboot erase או ב-fastboot format כדי למחוק מחיצה במכשיר.

פרמטרים
`useFastbootErase`	`boolean`: `true` אם צריך להשתמש ב-fastboot erase או `false` אם צריך להשתמש ב-fastboot format.

startLogcat

public void startLogcat ()

מתחילים לתעד את הפלט של logcat מהמכשיר ברקע.

לא תהיה לה השפעה אם הפלט של logcat כבר מתועד. אפשר לאחזר את הנתונים מאוחר יותר באמצעות getLogcat.

כשהמכשיר לא בשימוש, צריך לבצע קריאה ל-stopLogcat().

בדרך כלל אין צורך לקרוא לפונקציות startLogcat() ו-stopLogcat() בהקשר של קריאה ל-TF, כי מסגרת TF תפעיל ותפסיק את logcat.

startUser

public boolean startUser (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

זריקות
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

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

הערה: הפקודה הזו לא בודקת אם המשתמש קיים, אם המסך זמין, device supports such feature וכו'.

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

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

זריקות
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

סוגרים ומוחקים את הפלט של האמולטור.

stopLogcat

public void stopLogcat ()

הפסקת הצילום של פלט logcat מהמכשיר, והשלכת נתוני logcat שנשמרו.

לא תהיה לה השפעה אם הפלט של logcat לא מתועד.

stopUser

public boolean stopUser (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

stopUser

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

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

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

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

זריקות
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

מעבירים את המכשיר למצב adb-over-tcp.

החזרות
`String`	המספר הסידורי של ה-TCP או `null` אם לא ניתן היה להעביר את המכשיר

זריקות
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

מעבירים את המכשיר למצב adb over usb.

החזרות
`boolean`	`true` אם ההעברה בוצעה בהצלחה, `false` אחרת.

זריקות
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

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

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

זריקות
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

סנכרון מצטבר של תוכן ספריית קבצים מקומית עם המכשיר.

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

המערכת תתעלם מקבצים מוסתרים (ששמותיהם מתחילים ב-".‎").

דוגמה לשימוש: syncFiles("‎/tmp/files", "‎/sdcard") תיצור ספרייה ‎ /sdcard/files אם היא עדיין לא קיימת, ותדחוף באופן רקורסיבי את התוכן של ‎ /tmp/files אל ‎ /sdcard/files.

פרמטרים
`localFileDir`	`File`: ספריית הקבצים המקומית שמכילה קבצים שרוצים לדחוף באופן רפלוקטיבי.
`deviceFilePath`	`String`: שורש הנתיב המוחלט של הקובץ ביעד המרוחק. כל הספריות בנתיב הקובץ הזה חייבות להיות קריאות. לדוגמה, דחיפה אל ‎ /data/local/tmp כש-adb לא ב-root תיכשל.

החזרות
`boolean`	`true` אם הקבצים סונכרנו בהצלחה. `false` אחרת.

זריקות
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

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

החזרות
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

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

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

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

זריקות
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

הסרת התקנה של חבילת Android מהמכשיר של משתמש נתון.

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

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

זריקות
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

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

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

החזרות
`boolean`	`true` אם הפעולה הושלמה או אם המכשיר לא מוצפן.

זריקות
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

ניתוק של debugfs.

זריקות
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

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

פרמטרים
`timeOut`	`long`: משך הזמן באלפיות שנייה להמתנה להגדרת הדגל

החזרות
`boolean`	true אם הדגל של סיום האתחול של המכשיר מוגדר לפני חלוף הזמן הקצוב לתפוגה

זריקות
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

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

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

זריקות
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

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

פרמטרים
`waitTime`	`long`: משך ההמתנה, באלפיות שנייה

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

זריקות
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

המערכת ממתינה שהמכשיר יגיב ויהיה זמין, בלי להביא בחשבון את נתיב השחזור.

פרמטרים
`waitTime`	`long`

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

זריקות
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

זריקות
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

החסימה מונעת מהמכשיר לעבור למצב 'adb recovery' (שימו לב שזה שונה מ-IDeviceRecovery).

פרמטרים
`waitTime`	`long`: משך ההמתנה, באלפיות שנייה

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

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

חסימת המכשיר במצב 'adb sideload'

פרמטרים
`waitTime`	`long`: משך ההמתנה, באלפיות שנייה

החזרות
`boolean`	`true` אם המכשיר מופעל לטעינה צדדית לפני שפג התוקף. אחרת `false`

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

חסימות שמונעות את הזמינות של המכשיר, למשל, חסימות ב-adb

פרמטרים
`waitTime`	`long`: משך ההמתנה, באלפיות שנייה

החזרות
`boolean`	`true` אם המכשיר לא יהיה זמין לפני שתוקף הזמן יפוג. אחרת `false`

waitForDeviceOnline

public void waitForDeviceOnline ()

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

לתשומת ליבכם: יכול להיות שהמכשיר לא יגיב לפקודות בסיום. במקום זאת, אתם צריכים להשתמש ב-waitForDeviceAvailable().

זריקות
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

החסימה נמשכת עד שהמכשיר גלוי דרך adb.

לתשומת ליבכם: יכול להיות שהמכשיר לא יגיב לפקודות בסיום. במקום זאת, אתם צריכים להשתמש ב-waitForDeviceAvailable().

פרמטרים
`waitTime`	`long`: משך ההמתנה, באלפיות שנייה

זריקות
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

הפונקציה ממתינה עד שהמכשיר יגיב לפקודה בסיסית של מעטפת adb.

פרמטרים
`waitTime`	`long`: משך ההמתנה, באלפיות שנייה

החזרות
`boolean`	`true` אם המכשיר מגיב לפני שחולף הזמן `waitTime`.

שיטות מוגנות

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

פרמטרים
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

יצירת פקודת OS עבור סשן הפקודה adb shell והארגומנטים שצוינו

פרמטרים
`command`	`String`
`forceExitStatusDetection`	`boolean`

החזרות
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

פרמטרים
`feature`	`String`
`strictMinLevel`	`int`

createRebootDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

יוצרים RebootDeviceAction שישמש לביצוע פעולת הפעלה מחדש.

פרמטרים
`rebootMode`	`NativeDevice.RebootMode`: מצב ההפעלה מחדש.
`reason`	`String`: להפעלה מחדש הזו.

החזרות
`NativeDevice.RebootDeviceAction`	`RebootDeviceAction` שנוצר.

createRunUtil

protected IRunUtil createRunUtil ()

החזרות
`IRunUtil`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

מבצעים הפעלה מחדש של adb.

פרמטרים
`rebootMode`	`NativeDevice.RebootMode`: מצב ההפעלה מחדש.
`reason`	`String`: להפעלה מחדש הזו.

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

שיטה מסייעת להעלאת חריגה אם אין תמיכה בהרשאה בזמן ריצה

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getApiLevelSafe

protected int getApiLevelSafe ()

החזרות
`int`

getLogger

protected ITestLogger getLogger ()

החזרות
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

מקבלים את המכונה RunUtil לשימוש.

החזרות
`IRunUtil`

initializeConnection

protected void initializeConnection (IBuildInfo info, 
                MultiMap<String, String> attributes)

פרמטרים
`info`	`IBuildInfo`
`attributes`	`MultiMap`

זריקות
`DeviceNotAvailableException`
`TargetSetupError`

internalGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

אחזור של מאפיין מכשיר, מהמטמון של ddmlib כברירת מחדל, וחזרה ל-adb shell getprop או ל-fastboot getvar בהתאם למצב המכשיר (במצב Fastboot או לא).

פרמטרים
`propName`	`String`: השם של מאפיין המכשיר כפי שהוא מוחזר על ידי 'adb shell getprop'
`fastbootVar`	`String`: השם של משתנה fastboot המקביל לשאילתה. אם `null`, לא תתבצע ניסיון להריץ שאילתה ב-fastboot
`description`	`String`: תיאור פשוט של המשתנה. האות הראשונה צריכה להיות אות רישית.

החזרות
`String`	מחרוזת, שעשויה להיות `null` או ריקה, שמכילה את הערך של המאפיין הנתון

זריקות
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

הפונקציה מחזירה אם קריאות החזרה (callbacks) להפעלה מחדש מתבצעות כרגע או לא. אם הערך הוא true, צריך להשבית את כל ממשקי ה-API הציבוריים להפעלה מחדש.

החזרות
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

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

פרמטרים
`localFile`	`File`
`entry`	`IFileEntry`

החזרות
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

שליחת התראה לכל IDeviceActionReceiver על אירוע סיום ההפעלה מחדש.

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

notifyRebootStarted

protected void notifyRebootStarted ()

שליחת התראה לכל IDeviceActionReceiver על אירוע ההתחלה של ההפעלה מחדש.

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

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

פרמטרים
`actionDescription`	`String`: תיאור קצר של הפעולה שרוצים לבצע. משמש לצורכי רישום ביומן בלבד.
`action`	`NativeDevice.DeviceAction`: הפעולה שרוצים לבצע
`retryAttempts`	`int`: הניסיון החוזר מנסה לבצע את הפעולה אם היא נכשלת אבל השחזור מצליח

החזרות
`boolean`	`true` אם הפעולה בוצעה בהצלחה

זריקות
`DeviceNotAvailableException`	אם ניסיון השחזור נכשל או אם בוצעו כל הניסיונות ללא הצלחה

postAdbReboot

protected void postAdbReboot ()

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

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

prePostBootSetup

protected void prePostBootSetup ()

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

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

פרמטרים
`remoteFilePath`	`String`
`localFile`	`File`

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

מגדירים את המכונה של Clock לשימוש.

פרמטרים
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

מסמנים את TestDevice כ-microdroid ומגדירים את ה-CID שלו.

פרמטרים
`process`	`Process`: התהליך של המכונה הווירטואלית של Microdroid.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

פרמטרים
`deviceOptions`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

הפקודה מבצעת פקודה פשוטה של fastboot עם משתני סביבה ומדווחת על סטטוס הפקודה.

פרמטרים
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

החזרות
`CommandResult`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

הפקודה הזו מפעילה פקודת fastboot פשוטה ומדווחת על סטטוס הפקודה.

פרמטרים
`timeout`	`long`
`fullCmd`	`String`

החזרות
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

ממתינים עד שהמכשיר לא יהיה זמין (הדיווח ל-adb יפסק).

פרמטרים
`operationDesc`	`String`: השם של הפעולה שממתינה לזמינות.
`time`	`long`: משך הזמן להמתנה עד לאירוע 'לא זמין'.

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

NativeDevice

סיכום

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

קבועים

שדות

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

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

שיטות מוגנות

קבועים

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

שדות

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

mOptions

mStateMonitor

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

NativeDevice

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

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos

getBasebandVersion