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

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

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 שאינם full stack.

סיכום

כיתות מוטמעות
`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)` להפעלה מחדש של מכשיר.

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

שדות
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

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

‫methods ציבוריים
`String`	`adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)` מתקינים חבילת Android במכשיר באמצעות פקודת adb.
`String`	`adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` מתקינים חבילת Android במכשיר באמצעות פקודת adb.
`void`	`batchPrefetchStartupBuildProps()` אופטימיזציה מיקרוסקופית (כ-400 אלפיות השנייה) על ידי אחזור מראש של כל המאפיינים שאנחנו צריכים, במקום לקרוא ל-adb getprop לכל אחד מהם.
`boolean`	`canSwitchToHeadlessSystemUser()` הפונקציה מחזירה את הערך True אם מותר לעבור למשתמש SYSTEM ללא ממשק גרפי, אחרת היא מחזירה את הערך False.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` בודקים אם תכונה מסוימת נתמכת כרגע ברמה נתמכת מינימלית.
`boolean`	`checkConnectivity()` בודקים שלמכשיר יש חיבור לרשת.
`boolean`	`clearErrorDialogs()` מנסים לסגור את כל תיבות הדו-שיח של השגיאות שמוצגות כרגע בממשק המשתמש של המכשיר.
`void`	`clearLastConnectedWifiNetwork()` מנקה את רשת ה-Wi-Fi האחרונה שהמכשיר התחבר אליה.
`void`	`clearLogcat()` מחיקת כל הנתונים המצטברים של logcat.
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` וריאציה של `connectToWifiNetwork(String,String)` שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)` וריאציה של `connectToWifiNetwork(String,String)` שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)` מתחבר לרשת Wi-Fi.
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)` מתחבר לרשת Wi-Fi.
`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.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` בודקים מכשיר ומחזירים מידע מפורט כשהמכשיר לא זמין.
`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 מאז התקופה מהמכשיר ומה-`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)` לנסות ליצור dump של ה-heap מ-system_server.
`boolean`	`enableAdbRoot()` מפעיל את adb root.
`boolean`	`enableNetworkMonitor()` הגדרה שמאפשרת מעקב אחרי הרשת במכשיר.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` שיטת עזר שמריצה פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`String`	`executeAdbCommand(String... cmdArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת.
`String`	`executeAdbCommand(long timeout, Map<String, String> envMap, String... cmdArgs)` שיטת עזר שמריצה פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`CommandResult`	`executeAdbV2Command(String... cmdArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת.
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> envMap, String... cmdArgs)` שיטת עזר שמריצה פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> envMap, int retryAttempts, String... cmdArgs)` שיטת עזר שמריצה פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` שיטת עזר שמריצה פקודת fastboot כפקודת מערכת עם זמן קצוב של 2 דקות כברירת מחדל.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` שיטת עזר שמבצעת פקודת fastboot כפקודת מערכת.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` שיטת עזר שמבצעת פקודת fastboot ארוכה כפקודת מערכת.
`CommandResult`	`executeLongFastbootCommand(Map<String, String> envVarMap, String... cmdArgs)` שיטת עזר שמריצה פקודת fastboot ארוכה כפקודת מערכת עם משתני סביבה של המערכת.
`String`	`executeShellCommand(String command)` שיטת עזר שמריצה פקודת adb shell ומחזירה פלט כ-`String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` מריץ את הפקודה הנתונה של adb shell, ומנסה שוב כמה פעמים אם הפקודה נכשלת.
`CommandResult`	`executeShellV2Command(String cmd)` שיטת עזר שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` מריצה פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` שיטת עזר שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריצה פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` שיטת עזר שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה וב-stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מריצה פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, IShellOutputReceiver receiver)` שיטת עזר שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`CommandResult`	`fastbootOemRamdumpNow()` שיטת עזר שמפעילה ramdump ממצב אתחול מהיר.
`CommandResult`	`fastbootWipePartition(String partition)` שיטת עזר שמנקה מחיצה במכשיר.
`Set<ITestDevice.ApexInfo>`	`getActiveApexes()` שליפת המידע על חבילות APEX שהופעלו במכשיר.
`String`	`getAdbPath()` הפונקציה מחזירה את הנתיב של קובץ ה-adb הבינארי שנמצא בשימוש.
`Map<String, String>`	`getAllSettings(String namespace)` הפונקציה מחזירה צמדי מפתח/ערך של מרחב השמות המבוקש.
`DeviceAllocationState`	`getAllocationState()` החזרת מצב ההקצאה הנוכחי של המכשיר
`String`	`getAndroidId(int userId)` הפונקציה מחפשת ומחזירה את מזהה Android שמשויך ל-userId, או null אם לא נמצא מזהה.
`Map<Integer, String>`	`getAndroidIds()` יוצרים מיפוי של מזהי Android שנמצאו שתואמים למזהי משתמשים.
`int`	`getApiLevel()` קבלת רמת ה-API של המכשיר.
`int`	`getApiLevelFull()` בדומה ל-`getApiLevel()`, אבל מחזירה את הגרסה המלאה.
`PackageInfo`	`getAppPackageInfo(String packageName)` שליפת מידע על חבילה שמותקנת במכשיר.
`List<PackageInfo>`	`getAppPackageInfos()` אחזור מידע על חבילות שמותקנות במכשיר.
`String`	`getBasebandVersion()` שיטה נוחה לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה.
`Integer`	`getBattery()` הפונקציה מחזירה את רמת הטעינה הנוכחית של הסוללה במכשיר, או Null אם רמת הטעינה לא זמינה.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` מחזירה ערך בוליאני של המאפיין שצוין.
`Map<Long, String>`	`getBootHistory()` שיטת העזרה אוספת את מפת היסטוריית ההפעלה עם זמן ההפעלה וסיבת ההפעלה.
`Map<Long, String>`	`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()` הפונקציה מחזירה את התאריך של המכשיר באלפיות שנייה מאז ראשית זמן יוניקס (Unix epoch).
`DeviceDescriptor`	`getDeviceDescriptor()` מחזירים `DeviceDescriptor` מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` מחזירים `DeviceDescriptor` מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.
`TestDeviceState`	`getDeviceState()` קבלת מצב המכשיר.
`long`	`getDeviceTimeOffset(Date date)` פונקציית עזר לקבלת הפרש השעות בין המכשיר לבין `Date` נתון.
`InputStreamSource`	`getEmulatorOutput()` קבלת הזרם של stdout ו-stderr של האמולטור
`Process`	`getEmulatorProcess()` מחזירה את ה-`Process` שמתאים לאמולטור הזה.
`final File`	`getExecuteShellCommandLog()` היומן שמכיל את כל היומנים של `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` שיטת עזר לקביעת כמות השטח הפנוי באחסון החיצוני של המכשיר.
`String`	`getFastbootPath()` הפונקציה מחזירה את הנתיב של קובץ ה-binary של fastboot שנמצא בשימוש.
`String`	`getFastbootProductType()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב אתחול מהיר.
`String`	`getFastbootProductVariant()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב אתחול מהיר.
`String`	`getFastbootSerialNumber()` מחזירה את המספר הסידורי של מצב אתחול מהיר (Fastboot).
`String`	`getFastbootVariable(String variableName)` אחזור הערך של משתנה fastboot נתון מהמכשיר.
`String`	`getFastbootVersion()` הפונקציה מחזירה את מחרוזת הגרסה של קובץ ה-fastboot הבינארי שבו נעשה שימוש.
`IFileEntry`	`getFileEntry(String path)` אחזור הפניה לקובץ מרוחק במכשיר.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` עוזר לא רשמי לקבלת `FileEntry` מנתיב שאינו נתיב הבסיס.
`Set<DeviceFoldableState>`	`getFoldableStates()` מחזירה את רשימת המצבים של מכשירים מתקפלים.
`IDevice`	`getIDevice()` מחזירה הפניה ל-ddmlib המשויך `IDevice`.
`Set<String>`	`getInstalledPackageNames()` אחזור של שמות החבילות של האפליקציות שקיימות במכשיר.
`long`	`getIntProperty(String name, long defaultValue)` הפונקציה מחזירה ערך של מספר שלם של המאפיין הנתון מהמכשיר.
`String`	`getIpAddress()` קבלת כתובת ה-IP של המכשיר.
`KeyguardControllerState`	`getKeyguardState()` מחזירה אובייקט כדי לקבל את המצב הנוכחי של מסך הנעילה, או null אם לא אפשרי.
`long`	`getLastExpectedRebootTimeMillis()` הפונקציה מחזירה את הפעם האחרונה שממשקי Tradefed API הפעילו הפעלה מחדש באלפיות השנייה מאז EPOCH, כפי שמוחזר על ידי `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` קבלת רמת ה-API של המכשיר שהושקה לראשונה.
`InputStreamSource`	`getLogcat()` משיג קובץ snapshot של נתוני logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` הפקודה יוצרת תמונת מצב של הנתונים ב-Logcat שנאספו ב-`maxBytes` השניות האחרונות.
`InputStreamSource`	`getLogcatDump()` קבלת פלט של logcat הנוכחי למכשיר.
`InputStreamSource`	`getLogcatSince(long date)` שולף זרם של תמונת מצב של נתוני logcat שתועדו החל מהתאריך שצוין.
`String`	`getMacAddress()` מחזירה את כתובת ה-MAC של המכשיר. אם השאילתה מהמכשיר נכשלת, הערך הוא null.
`Integer`	`getMainUserId()` הפונקציה מחזירה את מזהה המשתמש הראשי.
`Set<String>`	`getMainlineModuleInfo()` לקבל מידע על מודולי ה-Mainline שמותקנים במכשיר.
`int`	`getMaxNumberOfRunningUsersSupported()` קבלת המספר המקסימלי של משתמשים שנתמכים בהפעלה בו-זמנית.
`int`	`getMaxNumberOfUsersSupported(String userType)` אחזור המספר המקסימלי של משתמשים נתמכים מסוג משתמש ספציפי.
`int`	`getMaxNumberOfUsersSupported()` מקבלים את המספר המקסימלי של משתמשים שניתן להוסיף, לא כולל אורחים.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` החזרת `IDeviceStateMonitor` שמשויך למכשיר.
`String`	`getMountPoint(String mountName)` מחזירה נקודת טעינה.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` הפונקציה מחזירה את הערך `MountPointInfo` שמתאים לנתיב של נקודת הטעינה שצוין, או את הערך `null` אם לא הותקן כלום בנתיב הזה או אם הוא לא מופיע ב-‎/proc/mounts כנקודת טעינה.
`List<ITestDevice.MountPointInfo>`	`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()` קבלת מצב השחזור הנוכחי שבו נעשה שימוש במכשיר.
`int`	`getRemainingCreatableUserCount(String userType)` הפונקציה מחזירה את מספר המשתמשים מסוג המשתמש שצוין שאפשר ליצור במכשיר הזה.
`InputStreamSource`	`getScreenshot(Long displayId, String format, boolean rescale)` יוצר צילום מסך ממזהה התצוגה שצוין במכשיר בפורמט נתמך.
`InputStreamSource`	`getScreenshot(String format)` מצלם צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot(long displayId)` מצלם צילום מסך מהמכשיר לפי מזהה התצוגה שצוין.
`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 אם הוא לא זמין או שהמכשיר לא זמין.
`List<File>`	`getTombstones()` שליפה והחזרה של רשימת ה-tombstones מהמכשירים.
`long`	`getTotalMemory()` הפונקציה מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים, או -1 במקרה של שגיאה פנימית
`String`	`getTrackingSerial()` לצורך ניהול המכשיר, מקבלים את המספר הסידורי שמשמש למעקב אחרי המכשיר.
`Set<String>`	`getUninstallablePackageNames()` שליפת שמות החבילות של האפליקציות שאפשר להסיר.
`boolean`	`getUseFastbootErase()` האם להשתמש ב-fastboot erase או ב-fastboot format כדי למחוק מחיצה במכשיר.
`int`	`getUserFlags(int userId)` חיפוש הדגלים של משתמש מסוים והחזרתם.
`Map<Integer, UserInfo>`	`getUserInfos()` מקבל את המיפוי של useId ל-`UserInfo` במכשיר.
`int`	`getUserSerialNumber(int userId)` הפונקציה מחזירה את המספר הסידורי שמשויך ל-userId אם הוא נמצא, או את הערך -10000 בכל מקרה אחר.
`int`	`getUserVisibleOnDisplay(int displayId)` מחזירה את מזהה המשתמש של המשתמש הגלוי בתצוגה הנתונה.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` מעבדים את DeviceEvent שצוין. מעבדים את DeviceEvent, שיכול להיות שיעביר את המכשיר הזה למצב הקצאה חדש או לא.
`boolean`	`hasFeature(String feature)` בודקים אם תכונה מסוימת זמינה במכשיר.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)` מאתחלים את החיבור למכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקנה של חבילת Android במכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` התקנה של חבילת Android במכשיר.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר עבור משתמש מסוים.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר עבור משתמש מסוים.
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` התקנה של קובצי APK במצב מצטבר.
`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 אם המכשיר הוא ללא ראש (ללא מסך), אחרת היא מחזירה את הערך False.
`boolean`	`isHeadlessSystemUserMode()` הפונקציה מחזירה את הערך true אם המכשיר משתמש במצב משתמש ללא ממשק משתמש של מערכת, אחרת היא מחזירה את הערך false.
`boolean`	`isMainUserPermanentAdmin()` הפונקציה מחזירה ערך בוליאני שקובע אם המשתמש הראשי הוא אדמין קבוע, ואי אפשר למחוק אותו או להוריד את הרמה שלו ללא הרשאות אדמין.
`boolean`	`isMultiUserSupported()` הפונקציה מחזירה ערך בוליאני שמציין אם המכשיר תומך במספר משתמשים שאפשר לעבור ביניהם, שלכל אחד מהם יש פרטי כניסה משלו ומרחב שניתן להתאמה אישית.
`boolean`	`isPackageInstalled(String packageName, String userId)` שליחת שאילתה למכשיר לגבי שם חבילה ומזהה משתמש מסוימים כדי לבדוק אם האפליקציה מותקנת כרגע עבור המשתמש הזה.
`boolean`	`isPackageInstalled(String packageName)` שליחת שאילתה למכשיר לגבי שם חבילה מסוים כדי לבדוק אם החבילה מותקנת כרגע או לא.
`boolean`	`isRuntimePermissionSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בהענקת הרשאות בתחילת ההפעלה
`boolean`	`isShellV2Support()`
`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()` הפונקציה מחזירה את הערך true אם המשתמשים יכולים להפעיל את המכשיר כשהוא פועל ברקע ב-`ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`, אחרת היא מחזירה את הערך false.
`boolean`	`isVisibleBackgroundUsersSupported()` הפונקציה מחזירה את הערך true אם המכשיר מאפשר למשתמשים להפעיל אפליקציות ברקע, ואת הערך false אם לא.
`boolean`	`isWifiEnabled()` בודקים אם ה-Wi-Fi מופעל.
`Set<Long>`	`listDisplayIds()` אוספים את רשימת מזהי המסכים הזמינים במכשיר כפי שמדווח על ידי dumpsys SurfaceFlinger.
`Set<Integer>`	`listDisplayIdsForStartingVisibleBackgroundUsers()` מקבל את רשימת המסכים שאפשר להשתמש בהם בשביל `start a user visible in the background`.
`ArrayList<Integer>`	`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`	`pullDir(String deviceFilePath, File localDir, int userId, long timeout)` שליפת תוכן של ספריות מהמכשיר באופן רקורסיבי.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId, long timeout)` שליפת קובץ מהמכשיר.
`boolean`	`pullFile(String remoteFilePath, File localFile)` שליפת קובץ מהמכשיר.
`File`	`pullFile(String remoteFilePath, int userId)` הפקודה מאחזרת קובץ מהמכשיר, מאחסנת אותו ב-`File` זמני מקומי ומחזירה את `File`.
`File`	`pullFile(String remoteFilePath)` הפקודה מאחזרת קובץ מהמכשיר, מאחסנת אותו ב-`File` זמני מקומי ומחזירה את `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` שליפת קובץ מהמכשיר.
`String`	`pullFileContents(String remoteFilePath)` מאחזר קובץ מהמכשיר ומחזיר את התוכן שלו.
`File`	`pullFileFromExternal(String remoteFilePath)` שיטה נוחה לאחזור קובץ מהאחסון החיצוני של המכשיר, שמירה שלו ב-`File` מקומי זמני והחזרת הפניה ל-`File` הזה.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` שליחת תוכן של ספריות למכשיר באופן רקורסיבי.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, Set<String> excludedDirectories)` העברת התוכן של ספריות למכשיר באופן רקורסיבי, תוך החרגה של ספריות מסוימות שעברו סינון.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` שליחת תוכן של ספריות למכשיר באופן רקורסיבי.
`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` נתון שיישמר גם אחרי הפעלה מחדש.
`String`	`reboot(String command, String reason)` מפעיל מחדש את המכשיר באמצעות `command` שצוין.
`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, Collection<ITestLifeCycleReceiver> listeners)` מריץ בדיקות של מכשור ומספק שחזור של המכשיר.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` שיטה נוחה לביצוע `runInstrumentationTests(IRemoteAndroidTestRunner,Collection)` עם מאזין אחד או יותר שמועברים כפרמטרים.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)` זהה ל-`ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection)` אבל מריץ את הבדיקה עבור המשתמש שצוין.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` זהה ל-`ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,ITestLifeCycleReceiver...)` אבל מריץ את הבדיקה עבור משתמש מסוים.
`void`	`setAdbPath(String adbPath)` מגדירה את הנתיב לקובץ הבינארי של adb שבו צריך להשתמש.
`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`	`startTradeInModeTesting(int timeoutMs)` הפעלת מצב טרייד-אין לבדיקה.
`boolean`	`startUser(int userId)` מפעיל משתמש נתון ברקע אם הוא מושבת כרגע.
`boolean`	`startUser(int userId, boolean waitFlag)` מפעיל משתמש נתון ברקע אם הוא מושבת כרגע.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` מפעיל משתמש מסוים ברקע, שגלוי בתצוגה הנתונה (כלומר, מאפשר למשתמש להפעיל פעילויות בתצוגה הזו).
`void`	`stopEmulatorOutput()` סוגרים ומוחקים את הפלט של האמולטור.
`void`	`stopLogcat()` הפסקת הלכידה של פלט logcat מהמכשיר, וביטול הנתונים של logcat שנשמרו כרגע.
`void`	`stopTradeInModeTesting()` להפסיק את הבדיקה של מצב טרייד-אין.
`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.
`void`	`waitForDeviceFastbootD()`
`boolean`	`waitForDeviceInRecovery(long waitTime)` חסימה של המכשיר כדי שיהיה במצב 'שחזור adb' (שימו לב שהמצב הזה שונה מ`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, boolean oldShellCommand)` יוצר את פקודת מערכת ההפעלה עבור סשן וארגומנטים נתונים של פקודת 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` שבו רוצים להשתמש.
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` שליפת מאפיין של מכשיר, מתוך המטמון של ddmlib כברירת מחדל, וחזרה ל-`adb shell getprop` או ל-`fastboot getvar` בהתאם למצב המכשיר (Fastboot או לא).
`boolean`	`isInRebootCallback()` הפונקציה מחזירה את הערך true אם קריאות חוזרות להפעלה מחדש מבוצעות כרגע, אחרת היא מחזירה את הערך false.
`boolean`	`isNewer(File localFile, IFileEntry entry)` הפונקציה מחזירה `true` אם הקובץ המקומי חדש יותר מהקובץ המרוחק.
`void`	`notifyRebootEnded()` שולח לכל `IDeviceActionReceiver` הודעה על סיום ההפעלה מחדש.
`void`	`notifyRebootStarted()` שליחת הודעה לכל `IDeviceActionReceiver` על אירוע התחלת ההפעלה מחדש.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` מבצע פעולה במכשיר הזה.
`void`	`postAdbReboot(NativeDevice.RebootMode rebootMode)` פעולות נוספות שאפשר לבצע אחרי הפעלה מחדש.
`void`	`prePostBootSetup()` מאפשר לכל סוג מכשיר (AndroidNativeDevice, ‏ TestDevice) לבטל את השיטה הזו כדי להגדיר הגדרה ספציפית אחרי ההפעלה.
`boolean`	`pullFileWithAdbCommand(String remoteFilePath, File localFile, long timeout)`
`void`	`setClock(Clock clock)` מגדירים את מופע השעון שבו רוצים להשתמש.
`void`	`setMicrodroidProcess(Process process)` מסמן את TestDevice כ-microdroid ומגדיר את ה-CID שלו.
`void`	`setTestDeviceOptions(Map<String, String> deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` מפעיל פקודת fastboot פשוטה ומדווח על הסטטוס של הפקודה.
`CommandResult`	`simpleFastbootCommand(long timeout, Map<String, String> envVarMap, String[] fullCmd)` מריץ פקודת fastboot פשוטה עם משתני סביבה ומדווח על הסטטוס של הפקודה.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` מחכים לראות שהמכשיר לא זמין (הדיווח ל-adb נפסק).

ערכים קבועים

DEBUGFS_PATH

public static final String DEBUGFS_PATH

ערך קבוע: "/sys/kernel/debug"

INVALID_USER_ID

public static final int INVALID_USER_ID

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

ערך קבוע: ‎-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)

SD_CARD

protected static final String SD_CARD

ערך קבוע: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

ערך קבוע: "/storage/emulated/"

שדות

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

‫constructors ציבוריים

NativeDevice

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

יצירת TestDevice.

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

‫methods ציבוריים

adbInstallPackage

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

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

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

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

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

adbInstallPackage

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

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

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

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

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

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

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

החזרות
`boolean`

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

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

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

checkConnectivity

public boolean checkConnectivity ()

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

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

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

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

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

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

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

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

connectToWifiNetworkIfNeededWithResult

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

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

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

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

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

connectToWifiNetworkIfNeededWithResult

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

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

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

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

connectToWifiNetworkWithResult

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

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

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

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

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

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

connectToWifiNetworkWithResult

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

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

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

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

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

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

connectToWifiNetworkWithResult

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

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

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

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

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

connectToWifiNetworkWithResult

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

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

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

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

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

createUser

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

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

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

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

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

createUser

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

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

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

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

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

createUser

public int createUser (String name)

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

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

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

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

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

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

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

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

החזרות
`DeviceInspectionResult`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

deleteFile

public void deleteFile (String deviceFilePath)

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

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

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

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

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

פרמטרים
`utcEpochTime`	‫`long`: הזמן במכשיר בשניות מאז ראשית זמן יוניקס (Unix epoch).
`timeUnit`	‫`TimeUnit`: יחידת הזמן `TimeUnit` של utcEpochTime.

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

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

disableAdbRoot

public boolean disableAdbRoot ()

השבתה של adb root.

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

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

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

disableKeyguard

public void disableKeyguard ()

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

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

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

disableNetworkMonitor

public boolean disableNetworkMonitor ()

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

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

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

disconnectFromWifi

public boolean disconnectFromWifi ()

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

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

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

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

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

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

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

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

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

enableAdbRoot

public boolean enableAdbRoot ()

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

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

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

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

enableNetworkMonitor

public boolean enableNetworkMonitor ()

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

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

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

executeAdbCommand

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

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

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

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

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

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

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

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

executeAdbCommand

public String executeAdbCommand (long timeout, 
                Map<String, String> envMap, 
                String... cmdArgs)

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

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

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

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

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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

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

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

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

executeAdbV2Command

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

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

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

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

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

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

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                String... cmdArgs)

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

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

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

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

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                int retryAttempts, 
                String... cmdArgs)

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

פרמטרים
`timeout`	‫`long`: משך הזמן באלפיות השנייה לפני שהמכשיר נחשב כלא מגיב, 0L אם לא מוגדר זמן קצוב לתפוגה
`envMap`	‫`Map`: הסביבה שרוצים להגדיר לפקודה
`retryAttempts`	‫`int`: המספר המקסימלי של ניסיונות חוזרים להריץ את הפקודה אם היא נכשלת בגלל חריגה. ‫DeviceNotResponsiveException יופעל אם הפעולות `retryAttempts` לא יבוצעו בהצלחה.
`cmdArgs`	‫`String`: פקודת ה-adb והארגומנטים להרצה

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

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

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

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

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

executeFastbootCommand

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

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

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

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

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

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

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

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

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

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (Map<String, String> envVarMap, 
                String... cmdArgs)

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

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

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

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

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

executeShellCommand

public String executeShellCommand (String command)

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

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

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

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

executeShellCommand

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

מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

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

executeShellCommand

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

מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

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

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

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

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

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

executeShellV2Command

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

מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

החזרות
`CommandResult`

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

executeShellV2Command

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

מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

החזרות
`CommandResult`

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

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

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

executeShellV2Command

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

מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

החזרות
`CommandResult`

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

פרמטרים
`cmd`	‫`String`: הפקודה שצריך להריץ.
`pipeToOutput`	‫`OutputStream`: `OutputStream` לאן יופנה הפלט הרגיל, או null.

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

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

executeShellV2Command

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

מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

החזרות
`CommandResult`

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

executeShellV2Command

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

מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

החזרות
`CommandResult`

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                IShellOutputReceiver receiver)

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

פרמטרים
`cmd`	‫`String`: הפקודה שצריך להריץ.
`receiver`	‫`IShellOutputReceiver`: `IShellOutputReceiver` שאליו יופנה הפלט של המעטפת.

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

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

fastbootOemRamdumpNow

public CommandResult fastbootOemRamdumpNow ()

שיטת עזר שמפעילה ramdump ממצב אתחול מהיר.

השיטה הזו מפעילה את הפקודה oem ramdump now. בניגוד ל-ERROR(/#executeFastbootCommand()), הפקודה הזו לא מנסה לבצע שוב את הפעולה או לשחזר את המכשיר אם הפקודה נכשלת או שהסטטוס לא תקין, כי קריסת המכשיר היא התוצאה הרצויה. הפקודה הזו מיועדת לשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר.

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

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

שיטת עזר שמנקה מחיצה במכשיר.

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

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

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

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

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

getActiveApexes

public Set<ITestDevice.ApexInfo> getActiveApexes ()

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

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

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

getAdbPath

public String getAdbPath ()

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

החזרות
`String`

getAllSettings

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

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

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

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

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

getAllocationState

public DeviceAllocationState getAllocationState ()

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

החזרות
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

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

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

החזרות
`String`

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

getAndroidIds

public Map<Integer, String> getAndroidIds ()

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

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

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

getApiLevel

public int getApiLevel ()

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

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

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

getApiLevelFull

public int getApiLevelFull ()

בדומה ל-getApiLevel(), אבל מחזירה את הגרסה המלאה.

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

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

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

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

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

getAppPackageInfos

public List<PackageInfo> getAppPackageInfos ()

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

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

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

getBasebandVersion

public String getBasebandVersion ()

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

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

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

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

getBootHistory

public Map<Long, String> getBootHistory ()

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

החזרות
`Map<Long, String>`	מיפוי של זמן האתחול (שעון UTC בשניות מאז ראשית הזמן) וסיבת האתחול

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

getBootHistorySince

public Map<Long, String> getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

החזרות
`Map<Long, String>`	מיפוי של זמן האתחול (שעון UTC בשניות מאז ראשית הזמן) וסיבת האתחול

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

getBootloaderVersion

public String getBootloaderVersion ()

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

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

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

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

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

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

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

getBuildAlias

public String getBuildAlias ()

אחזור הכינוי של ה-Build שהמכשיר מריץ כרגע.

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

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

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

getBuildFlavor

public String getBuildFlavor ()

שליפה של טעם ה-Build של המכשיר.

החזרות
`String`	הטעם של הגרסה או null אם לא ניתן לאחזר אותו

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

getBuildId

public String getBuildId ()

אחזור ה-Build שהמכשיר מריץ כרגע.

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

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

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

החזרות
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

החזרות
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

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

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

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

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

getConnection

public AbstractConnection getConnection ()

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

החזרות
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

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

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

החזרות
`ContentProviderHandler`

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

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

החזרות
`DeviceFoldableState`

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

getCurrentUser

public int getCurrentUser ()

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

החזרות
`int`

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

getDeviceClass

public String getDeviceClass ()

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

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

getDeviceDate

public long getDeviceDate ()

הפונקציה מחזירה את התאריך של המכשיר באלפיות שנייה מאז ראשית זמן יוניקס (Unix epoch).

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

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

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

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

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

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

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

getFastbootPath

public String getFastbootPath ()

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

החזרות
`String`

getFastbootProductType

public String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

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

getFastbootSerialNumber

public String getFastbootSerialNumber ()

מחזירה את המספר הסידורי של מצב אתחול מהיר (Fastboot).

החזרות
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

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

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

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

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

getFastbootVersion

public String getFastbootVersion ()

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

החזרות
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

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

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

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

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

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

עוזר לא רשמי לקבלת FileEntry מנתיב שאינו נתיב הבסיס. FIXME: Refactor the FileEntry system to have it available from any path. (גם אם לא מדובר במשתמש root).

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

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

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

getFoldableStates

public Set<DeviceFoldableState> getFoldableStates ()

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

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

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

getIDevice

public IDevice getIDevice ()

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

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

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

getInstalledPackageNames

public Set<String> getInstalledPackageNames ()

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

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

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

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

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

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

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

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

getIpAddress

public String getIpAddress ()

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

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

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

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

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

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

החזרות
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

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

getLogcat

public InputStreamSource getLogcat ()

משיג קובץ snapshot של נתוני logcat.

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

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

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

החזרות
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

הפקודה יוצרת תמונת מצב של הנתונים ב-Logcat שנאספו ב-maxBytes השניות האחרונות.

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

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

החזרות
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

החיסרון הוא שלא יוחזר כלום אם אי אפשר להגיע למכשיר.

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

getLogcatSince

public InputStreamSource getLogcatSince (long date)

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

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

החזרות
`InputStreamSource`

getMacAddress

public String getMacAddress ()

מחזירה את כתובת ה-MAC של המכשיר. אם השאילתה מהמכשיר נכשלת, הערך הוא null.

החזרות
`String`

getMainUserId

public Integer getMainUserId ()

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

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

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

getMainlineModuleInfo

public Set<String> getMainlineModuleInfo ()

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

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

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

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported (String userType)

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

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

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

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

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

getMicrodroidProcess

public Process getMicrodroidProcess ()

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

getMonitor

public IDeviceStateMonitor getMonitor ()

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

החזרות
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

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

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

לא לשכוח: להעביר את ההתנהגות הזו אל IDevice.getMountPoint(String)

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

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

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

getMountPointInfo

public List<ITestDevice.MountPointInfo> getMountPointInfo ()

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

החזרות
`List<ITestDevice.MountPointInfo>`	‫`List` של `MountPointInfo` שמכיל את המידע ב-‎/proc/mounts

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

getOptions

public TestDeviceOptions getOptions ()

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

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

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

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

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

החזרות
`long`	כמות השטח הפנוי ב-KB

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

getPrimaryUserId

public Integer getPrimaryUserId ()

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

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

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

getProcessByName

public ProcessInfo getProcessByName (String processName)

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

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

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

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

getProcessPid

public String getProcessPid (String process)

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

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

החזרות
`String`

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

getProductType

public String getProductType ()

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

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

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

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

getProductVariant

public String getProductVariant ()

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

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

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

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

getProperty

public String getProperty (String name)

אחזור ערך המאפיין שצוין מהמכשיר.

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

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

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

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getRemainingCreatableUserCount

public int getRemainingCreatableUserCount (String userType)

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

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

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

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

getScreenshot

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

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

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

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

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

getScreenshot

public InputStreamSource getScreenshot (String format)

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

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

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

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

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

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

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

getScreenshot

public InputStreamSource getScreenshot ()

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

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

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

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

getSetting

public String getSetting (String namespace, 
                String key)

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

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

החזרות
`String`

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

getSimOperator

public String getSimOperator ()

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

החזרות
`String`

getSimState

public String getSimState ()

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

החזרות
`String`

getTombstones

public List<File> getTombstones ()

שליפה והחזרה של רשימת ה-tombstones מהמכשירים. נדרשת גישת root.

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

החזרות
`List<File>`	רשימה של קבצים מסוג tombstone, ריקה אם אין קובץ כזה.

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

getTotalMemory

public long getTotalMemory ()

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

החזרות
`long`

getTrackingSerial

public String getTrackingSerial ()

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

החזרות
`String`

getUninstallablePackageNames

public Set<String> getUninstallablePackageNames ()

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

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

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

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

getUserInfos

public Map<Integer, UserInfo> getUserInfos ()

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

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

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

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

החזרות
`int`

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

getUserVisibleOnDisplay

public int getUserVisibleOnDisplay (int displayId)

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

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

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

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

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.

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

initializeConnection

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

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

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

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

installPackage

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

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

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

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

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

installPackage

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

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

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

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

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

installPackageForUser

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

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

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

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

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

installPackageForUser

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

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

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

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

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

installPackageWithIncrementalMode

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

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

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

החזרות
`boolean`

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

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

החזרות
`boolean`

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

isAdbTcp

public boolean isAdbTcp ()

החזרות
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

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

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

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

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

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

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

isDebugfsMounted

public boolean isDebugfsMounted ()

בודקים אם debugfs מותקן.

החזרות
`boolean`	‫`true` אם debugfs נטען

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

isDeviceEncrypted

public boolean isDeviceEncrypted ()

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

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

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

isDirectory

public boolean isDirectory (String path)

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

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

החזרות
`boolean`

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

isEnableAdbRoot

public boolean isEnableAdbRoot ()

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

isEncryptionSupported

public boolean isEncryptionSupported ()

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

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

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

isExecutable

public boolean isExecutable (String fullPath)

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

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

החזרות
`boolean`

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

isFastbootEnabled

public boolean isFastbootEnabled ()

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

החזרות
`boolean`

isHeadless

public boolean isHeadless ()

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

החזרות
`boolean`

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

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

החזרות
`boolean`

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

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

החזרות
`boolean`

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

isMultiUserSupported

public boolean isMultiUserSupported ()

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

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

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

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

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

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

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

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

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

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

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

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

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

isShellV2Support

public boolean isShellV2Support ()

החזרות
`boolean`

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

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

החזרות
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

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

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

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

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

isUserSecondary

public boolean isUserSecondary (int userId)

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

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

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

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

isUserVisible

public boolean isUserVisible (int userId)

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

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

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

החזרות
`boolean`

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

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

החזרות
`boolean`

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

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

החזרות
`boolean`

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

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

החזרות
`boolean`

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

isWifiEnabled

public boolean isWifiEnabled ()

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

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

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

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

listDisplayIds

public Set<Long> listDisplayIds ()

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

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

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

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

listUsers

public ArrayList<Integer> listUsers ()

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

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

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

logAnrs

public boolean logAnrs (ITestLogger logger)

איסוף ותיעוד של מקרי ANR מהמכשיר.

פרמטרים
`logger`	‫`ITestLogger`: `ITestLogger` לרישום מקרי ה-ANR.

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

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

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

nonBlockingReboot

public void nonBlockingReboot ()

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

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

postAdbRootAction

public void postAdbRootAction ()

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

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

postAdbUnrootAction

public void postAdbUnrootAction ()

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

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

postBootSetup

public void postBootSetup ()

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

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

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

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

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

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

preInvocationSetup

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

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

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

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

pullDir

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

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

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

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

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

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

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

pullDir

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

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

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

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

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

pullFile

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

שליפת קובץ מהמכשיר.

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

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

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

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

שליפת קובץ מהמכשיר.

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

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

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

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

הפקודה מאחזרת קובץ מהמכשיר, מאחסנת אותו ב-File זמני מקומי ומחזירה את File.

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

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

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

pullFile

public File pullFile (String remoteFilePath)

הפקודה מאחזרת קובץ מהמכשיר, מאחסנת אותו ב-File זמני מקומי ומחזירה את File.

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

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

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

pullFile

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

שליפת קובץ מהמכשיר.

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

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

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

pullFileContents

public String pullFileContents (String remoteFilePath)

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

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

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

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

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

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

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

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

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

pushDir

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

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

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

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

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

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                Set<String> excludedDirectories)

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

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

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

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

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

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

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

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

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

pushFile

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

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

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

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

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

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

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

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

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

pushFile

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

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

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

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

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

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

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

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

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

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

הפעל מחדש

public void reboot (String reason)

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

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

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

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

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

הפעל מחדש

public String reboot (String command, 
                String reason)

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

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

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

פרמטרים
`command`	‫`String`: פקודה שמועברת אל adb. שימו לב שהיא מועברת 'כמו שהיא', ולכן על המתקשר לספק את המירכאות המתאימות אם צריך (במיוחד אם היא מכילה כמה חלקים שמופרדים ברווח).
`reason`	`String`: סיבה להפעלה מחדש, או `null` אם לא צוינה סיבה.

החזרות
`String`

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

הפעל מחדש

public void reboot ()

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

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

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

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

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

rebootIntoFastbootd

public void rebootIntoFastbootd ()

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

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

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

rebootIntoRecovery

public void rebootIntoRecovery ()

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

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

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

rebootIntoSideload

public void rebootIntoSideload ()

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

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

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

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

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

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

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

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

rebootUntilOnline

public void rebootUntilOnline ()

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

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

rebootUntilOnline

public void rebootUntilOnline (String reason)

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

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

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

rebootUserspace

public void rebootUserspace ()

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

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

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

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

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

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

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

recoverDevice

public boolean recoverDevice ()

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

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

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

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

remountSystemReadOnly

public void remountSystemReadOnly ()

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

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

remountSystemWritable

public void remountSystemWritable ()

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

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

remountVendorReadOnly

public void remountVendorReadOnly ()

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

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

remountVendorWritable

public void remountVendorWritable ()

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

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

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

removeOwners

public void removeOwners ()

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

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

removeUser

public boolean removeUser (int userId)

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

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

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

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

resetContentProviderSetup

public void resetContentProviderSetup ()

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

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                Collection<ITestLifeCycleReceiver> listeners)

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

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

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

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

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

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

runInstrumentationTests

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

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

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

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

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

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                Collection<ITestLifeCycleReceiver> listeners)

זהה ל-ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection) אבל מריץ את הבדיקה עבור המשתמש שצוין.

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

החזרות
`boolean`

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

runInstrumentationTestsAsUser

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

זהה ל-ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,ITestLifeCycleReceiver...) אבל מריץ את הבדיקה עבור משתמש מסוים.

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

החזרות
`boolean`

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

setAdbPath

public void setAdbPath (String adbPath)

מגדירה את הנתיב לקובץ הבינארי של adb שבו צריך להשתמש.

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

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`: מציינים תאריך מסוים. אם לא מציינים תאריך, המערכת תשתמש בתאריך של המארח.`null`

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

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

מגדיר את ערך המאפיין שצוין במכשיר. נדרש adb root הוא true.

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

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

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

setRecovery

public void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setSetting

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

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

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

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

setSetting

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

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

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

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

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.

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

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

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

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

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

startUser

public boolean startUser (int userId)

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

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

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

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

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

startVisibleBackgroundUser

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

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

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

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

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

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

stopEmulatorOutput

public void stopEmulatorOutput ()

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

stopLogcat

public void stopLogcat ()

הפסקת הלכידה של פלט logcat מהמכשיר, וביטול הנתונים של logcat שנשמרו כרגע.

לא תהיה השפעה אם פלט logcat לא נלכד.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

להפסיק את הבדיקה של מצב טרייד-אין.

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

stopUser

public boolean stopUser (int userId)

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

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

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

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

stopUser

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

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

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

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

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

switchToAdbTcp

public String switchToAdbTcp ()

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

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

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

switchToAdbUsb

public boolean switchToAdbUsb ()

מעבירים את המכשיר למצב adb over usb.

החזרות
`boolean`	‫`true` אם ההעברה בוצעה בהצלחה, `false` אחרת.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

מעבר למזהה משתמש אחר עם פסק זמן שמוגדר כברירת מחדל. switchUser(int, long).

פרמטרים
`userId`	`int`

החזרות
`boolean`	הערך הוא True אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, הפלט הוא False.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

מעבר למזהה משתמש אחר עם זמן קצוב לתפוגה שסופק כמועד אחרון. ניסיון להשבית את נעילת המסך אחרי שהמשתמש השתנה בהצלחה.

פרמטרים
`userId`	`int`
`timeout`	‫`long`: להמתנה לפני החזרת הערך false אם הפעולה switch-user נכשלה.

החזרות
`boolean`	הערך הוא True אם מזהה המשתמש החדש תואם לספק מזהה המשתמש. אחרת, הפלט הוא False.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

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 לא נמצא בשורש תיכשל

החזרות
`boolean`	‫`true` אם הקבצים סונכרנו בהצלחה. `false` אחרת.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

יוצר דוח באגים ומחזיר אותו בתוך אובייקט Bugreport כדי לטפל בו. הפונקציה מחזירה ערך null במקרה של בעיה. צריך לנקות את הקובץ שאליו יש הפניה באובייקט Bugreport באמצעות Bugreport.close().

החזרות
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

הסרת חבילת Android מהמכשיר.

פרמטרים
`packageName`	‫`String`: חבילת Android להסרה

החזרות
`String`	קוד שגיאה `String` או `null` אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

הסרת חבילת Android מהמכשיר עבור משתמש מסוים.

פרמטרים
`packageName`	‫`String`: חבילת Android להסרה
`userId`	‫`int`: מזהה המשתמש כמספר שלם שרוצים להסיר את ההתקנה שלו.

החזרות
`String`	קוד שגיאה `String` או `null` אם הפעולה הצליחה.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

המכשיר ייפתח אם הוא במצב מוצפן.

יכול להיות שה-method הזו תפעיל מחדש את המסגרת, אבל היא לא תפעיל את postBootSetup(). לכן, יכול להיות שהמכשיר לא יהיה מוכן לגמרי לבדיקה כשהשיטה הזו תחזיר ערך.

החזרות
`boolean`	‫`true` אם הפעולה הצליחה או אם המכשיר לא מוצפן.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`
`UnsupportedOperationException`

unmountDebugfs

public void unmountDebugfs ()

מבטלים את ההרכבה של debugfs.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

הפונקציה חוסמת עד שהדגל של השלמת האתחול של המכשיר מוגדר.

פרמטרים
`timeOut`	‫`long`: משך הזמן באלפיות השנייה להמתנה להגדרת הדגל

החזרות
`boolean`	true אם הדגל של השלמת האתחול של המכשיר מוגדר בתוך הזמן הקצוב לתפוגה

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

הכלי ממתין עד שהמכשיר יגיב ויהיה זמין לבדיקה. השימוש הוא בערך הזמן הקצוב לתפוגה שמוגדר כברירת מחדל.

החזרות
`boolean`	הפונקציה מחזירה True אם המכשיר זמין, ו-False אם השחזור מושבת ולא זמין.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

הכלי ממתין עד שהמכשיר יגיב ויהיה זמין לבדיקה.

פרמטרים
`waitTime`	‫`long`: משך הזמן להמתנה באלפיות השנייה

החזרות
`boolean`	הפונקציה מחזירה True אם המכשיר זמין, ו-False אם השחזור מושבת ולא זמין.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

ממתין שהמכשיר יגיב ויהיה זמין בלי להתחשב בנתיב השחזור.

פרמטרים
`waitTime`	`long`

החזרות
`boolean`	הערך True אם המכשיר זמין, הערך False אם המכשיר לא זמין.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

הפקודה נחסמת עד שהמכשיר גלוי דרך Fastboot. שימוש בערך ברירת המחדל של הזמן הקצוב לתפוגה.

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForDeviceFastbootD

public void waitForDeviceFastbootD ()

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

חסימה של המכשיר במצב 'שחזור adb' (שימו לב שהמצב הזה שונה מ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().

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

החסימה נמשכת עד שהמכשיר גלוי דרך adb.

שימו לב: יכול להיות שהמכשיר לא יגיב לפקודות אחרי השלמת הפעולה. במקום זאת, אתם צריכים להשתמש ב-waitForDeviceAvailable().

פרמטרים
`waitTime`	‫`long`: משך הזמן להמתנה באלפיות השנייה

הקפצת הודעות שגיאה (throw)
`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, 
                boolean oldShellCommand)

יוצר את פקודת מערכת ההפעלה עבור סשן וארגומנטים נתונים של פקודת adb shell

פרמטרים
`command`	`String`
`forceExitStatusDetection`	`boolean`
`oldShellCommand`	`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`: להפעלה מחדש הזו.

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

שיטת עזר להצגת חריגה אם אין תמיכה בהרשאה בתחילת ההפעלה

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getApiLevelSafe

protected int getApiLevelSafe ()

החזרות
`int`

getLogger

protected ITestLogger getLogger ()

החזרות
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

מקבלים את המופע של RunUtil שבו רוצים להשתמש.

החזרות
`IRunUtil`

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` או ריקה, שמכילה את הערך של המאפיין הנתון

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`
`UnsupportedOperationException`

isInRebootCallback

protected boolean isInRebootCallback ()

הפונקציה מחזירה את הערך true אם קריאות חוזרות להפעלה מחדש מבוצעות כרגע, אחרת היא מחזירה את הערך false. אם הערך הוא true, כל ממשקי ה-API הציבוריים להפעלה מחדש צריכים להיות מושבתים.

החזרות
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

הפונקציה מחזירה true אם הקובץ המקומי חדש יותר מהקובץ המרוחק. IFileEntry מדויק עד לרמת הדקה. אם השעות שוות, הקובץ ייחשב כחדש יותר.

פרמטרים
`localFile`	`File`
`entry`	`IFileEntry`

החזרות
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

שולח לכל IDeviceActionReceiver הודעה על סיום ההפעלה מחדש.

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

notifyRebootStarted

protected void notifyRebootStarted ()

שליחת הודעה לכל IDeviceActionReceiver על אירוע התחלת ההפעלה מחדש.

הקפצת הודעות שגיאה (throw)
	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` אם הפעולה בוצעה בהצלחה

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`	אם ניסיון השחזור נכשל או שהגעתם למספר המרבי של הניסיונות ללא הצלחה

postAdbReboot

protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

פעולות נוספות שאפשר לבצע אחרי הפעלה מחדש.

פרמטרים
`rebootMode`	`NativeDevice.RebootMode`

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

prePostBootSetup

protected void prePostBootSetup ()

מאפשר לכל סוג מכשיר (AndroidNativeDevice, ‏ TestDevice) לבטל את השיטה הזו כדי להגדיר הגדרה ספציפית אחרי ההפעלה.

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pullFileWithAdbCommand

protected boolean pullFileWithAdbCommand (String remoteFilePath, 
                File localFile, 
                long timeout)

פרמטרים
`remoteFilePath`	`String`
`localFile`	`File`
`timeout`	`long`

החזרות
`boolean`

הקפצת הודעות שגיאה (throw)
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

מגדירים את מופע השעון שבו רוצים להשתמש.

פרמטרים
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

מסמן את TestDevice כ-microdroid ומגדיר את ה-CID שלו.

פרמטרים
`process`	‫`Process`: התהליך של מכונת Microdroid הווירטואלית.

setTestDeviceOptions

protected void setTestDeviceOptions (Map<String, String> deviceOptions)

פרמטרים
`deviceOptions`	`Map`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

מפעיל פקודת fastboot פשוטה ומדווח על הסטטוס של הפקודה.

פרמטרים
`timeout`	`long`
`fullCmd`	`String`

החזרות
`CommandResult`

הקפצת הודעות שגיאה (throw)
`UnsupportedOperationException`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                Map<String, String> envVarMap, 
                String[] fullCmd)

מריץ פקודת fastboot פשוטה עם משתני סביבה ומדווח על הסטטוס של הפקודה.

פרמטרים
`timeout`	`long`
`envVarMap`	`Map`
`fullCmd`	`String`

החזרות
`CommandResult`

הקפצת הודעות שגיאה (throw)
`UnsupportedOperationException`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

מחכים לראות שהמכשיר לא זמין (הדיווח ל-adb נפסק).

פרמטרים
`operationDesc`	`String`: השם של הפעולה שממתינה לזמינות.
`time`	‫`long`: משך הזמן להמתנה עד להופעת הסטטוס 'לא זמין'.

החזרות
`boolean`	‫True אם המכשיר הפך ללא זמין.

NativeDevice

סיכום

כיתות מוטמעות

ערכים קבועים

שדות

‫constructors ציבוריים

‫methods ציבוריים

שיטות מוגנות

ערכים קבועים

DEBUGFS_PATH

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

SD_CARD

STORAGE_EMULATED

שדות

mOptions

mStateMonitor

‫constructors ציבוריים

NativeDevice

‫methods ציבוריים

adbInstallPackage

adbInstallPackage

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootOemRamdumpNow