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

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 ציבוריים
`void`	`batchPrefetchStartupBuildProps()` אופטימיזציה מיקרוסקופית (כ-400 אלפיות השנייה) על ידי אחזור מראש של כל המאפיינים שדרושים לנו, במקום להפעיל את הפקודה adb getprop לכל אחד מהם.
`boolean`	`canSwitchToHeadlessSystemUser()` הפונקציה מחזירה את הערך True אם מותר לעבור למשתמש המערכת ללא ממשק גרפי, אחרת היא מחזירה את הערך False.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` כדי לבדוק אם תכונה מסוימת נתמכת כרגע ברמה מינימלית.
`boolean`	`checkConnectivity()` בודקים שלמכשיר יש חיבור לרשת.
`boolean`	`clearErrorDialogs()` מנסים לסגור את תיבות הדו-שיח של השגיאות שמוצגות כרגע בממשק המשתמש של המכשיר.
`void`	`clearLastConnectedWifiNetwork()` מנקה את רשת ה-Wi-Fi האחרונה שהייתה מחוברת.
`void`	`clearLogcat()` מחיקת כל הנתונים המצטברים של logcat.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` מתחבר לרשת Wi-Fi.f
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` וריאציה של `connectToWifiNetwork(String, String)` שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` וריאציה של `connectToWifiNetwork(String, String)` שמתחברת רק אם למכשיר אין כרגע קישוריות לרשת.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` יצירת משתמש עם שם נתון והדגלים שצוינו
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` יצירת משתמש עם שם נתון והדגלים שצוינו
`int`	`createUser(String name)` יוצרים משתמש עם שם נתון ודגלי ברירת מחדל 0.
`int`	`createUserNoThrow(String name)` יוצרים משתמש עם שם נתון ודגלי ברירת מחדל 0.
`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 מאז התקופה מהמכשיר ומה-`ERROR(/TimeUnit)` שלו.
`boolean`	`disableAdbRoot()` השבתה של adb root.
`void`	`disableKeyguard()` ניסיונות להשבית את מסך הנעילה.
`boolean`	`disableNetworkMonitor()` השבתה של מעקב אחרי הרשת במכשיר.
`boolean`	`disconnectFromWifi()` התנתקות מרשת Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` שיטת עזר שקובעת אם קובץ במכשיר קיים עבור משתמש מסוים.
`boolean`	`doesFileExist(String deviceFilePath)` שיטת עזר לקביעה אם קובץ קיים במכשיר.
`File`	`dumpHeap(String process, String devicePath)` לנסות ליצור dump של ה-heap מ-system_server.
`boolean`	`enableAdbRoot()` מפעיל את adb root.
`boolean`	`enableNetworkMonitor()` הגדרה שמאפשרת מעקב אחרי הרשת במכשיר.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`String`	`executeAdbCommand(String... cmdArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת.
`CommandResult`	`executeAdbV2Command(String... cmdArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת.
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`CommandResult`	`executeAdbV2Command(long timeout, envMap, String... cmdArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` שיטת עזר שמריצה פקודת fastboot כפקודת מערכת עם זמן קצוב של 2 דקות כברירת מחדל.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` שיטת עזר שמבצעת פקודת fastboot כפקודת מערכת.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` שיטת עזר שמבצעת פקודת fastboot ארוכה כפקודת מערכת.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` שיטת עזר שמריצה פקודת fastboot ארוכה כפקודת מערכת עם משתני סביבה של המערכת.
`String`	`executeShellCommand(String command)` שיטה מסייעת שמריצה פקודת adb shell ומחזירה פלט כ-`String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מריצה פקודת adb 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, OutputStream pipeToOutput)` שיטת עזר שמריצה פקודה של adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה וב-stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` שיטת עזר שמריצה פקודה של adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריצה פקודת adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` מריצה פקודת adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריצה פקודת adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריצה פקודת adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`CommandResult`	`fastbootWipePartition(String partition)` שיטת עזר שמנקה מחיצה במכשיר.
	`getActiveApexes()` שליפת המידע על חבילות APEX שהופעלו במכשיר.
`String`	`getAdbPath()` הפונקציה מחזירה את הנתיב של קובץ ה-adb הבינארי שנמצא בשימוש.
	`getAllSettings(String namespace)` הפונקציה מחזירה צמדי מפתח/ערך של מרחב השמות המבוקש.
`DeviceAllocationState`	`getAllocationState()` החזרת מצב ההקצאה הנוכחי של המכשיר
`String`	`getAndroidId(int userId)` הפונקציה מחפשת ומחזירה את מזהה Android שמשויך ל-userId, או null אם לא נמצא מזהה.
	`getAndroidIds()` יוצרים מיפוי של מזהי Android שנמצאו שתואמים למזהי משתמשים.
`int`	`getApiLevel()` קבלת רמת ה-API של המכשיר.
`PackageInfo`	`getAppPackageInfo(String packageName)` קבלת מידע על חבילה שמותקנת במכשיר.
	`getAppPackageInfos()` אחזור מידע על חבילות שמותקנות במכשיר.
`String`	`getBasebandVersion()` שיטה נוחה לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה.
`Integer`	`getBattery()` מחזירה את רמת הטעינה הנוכחית של הסוללה במכשיר, או Null אם רמת הטעינה לא זמינה.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` הפונקציה מחזירה ערך בוליאני של המאפיין שצוין.
	`getBootHistory()` שיטת העזרה אוספת את מפת היסטוריית ההפעלה עם זמן ההפעלה וסיבת ההפעלה.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` שיטת העזר אוספת את מפת היסטוריית ההפעלה עם זמן ההפעלה והסיבה להפעלה מאז הזמן שצוין מאז תקופת ה-epoch מהמכשיר ויחידת הזמן שצוינה.
`String`	`getBootloaderVersion()` שיטת נוחות לקבלת גרסת תוכנת האתחול של המכשיר הזה.
`InputStreamSource`	`getBugreport()` שליפת דוח באגים מהמכשיר.
`InputStreamSource`	`getBugreportz()` מאחזר bugreportz מהמכשיר.
`String`	`getBuildAlias()` אחזור הכינוי של ה-Build שהמכשיר מריץ כרגע.
`String`	`getBuildFlavor()` שולפים את טעם ה-Build של המכשיר.
`String`	`getBuildId()` אחזור ה-Build שפועל כרגע במכשיר.
`String`	`getBuildSigningKeys()` הפונקציה מחזירה את סוג המפתח ששימש לחתימה על תמונת המכשיר בדרך כלל, יכול להיות שמכשירי Android חתומים באמצעות מפתחות בדיקה (כמו ב-AOSP) או מפתחות הפצה (שנשלטים על ידי יצרני מכשירים ספציפיים)
`DeviceDescriptor`	`getCachedDeviceDescriptor()` מחזירה `DeviceDescriptor` שמאוחסן במטמון אם המכשיר מוקצה, אחרת מחזירה את `DeviceDescriptor` הנוכחי.
`DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` מחזירה `DeviceDescriptor` שמאוחסן במטמון אם המכשיר מוקצה, אחרת מחזירה את `DeviceDescriptor` הנוכחי.
`String[]`	`getChildren(String path)` חלופה לשימוש ב-`IFileEntry`, שלפעמים לא תפעל בגלל הרשאות.
`AbstractConnection`	`getConnection()` החיבור הנוכחי שמשויך למכשיר.
`ContentProviderHandler`	`getContentProvider(int userId)` הפונקציה מחזירה את `ContentProviderHandler` או null אם הוא לא זמין.
`DeviceFoldableState`	`getCurrentFoldableState()` מחזירה את המצב הנוכחי של המכשיר המתקפל או null אם התרחשו בעיות מסוימות.
`int`	`getCurrentUser()` החזרת המזהה של המשתמש שמריץ את הפעולה כרגע.
`String`	`getDeviceClass()` מקבלים את סוג המכשיר.
`long`	`getDeviceDate()` הפונקציה מחזירה את התאריך של המכשיר במילישניות מאז תחילת התקופה של זמן מערכת.
`DeviceDescriptor`	`getDeviceDescriptor()` מחזירים `DeviceDescriptor` מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` מחזירים `DeviceDescriptor` מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.
`TestDeviceState`	`getDeviceState()` קבלת מצב המכשיר.
`long`	`getDeviceTimeOffset(Date date)` פונקציית עזר לקבלת הפרש הזמן בין המכשיר לבין `ERROR(/Date)` נתון.
`InputStreamSource`	`getEmulatorOutput()` קבלת הזרם של stdout ו-stderr של האמולטור
`Process`	`getEmulatorProcess()` מחזירה את `Process` שמתאים לאמולטור הזה.
`final File`	`getExecuteShellCommandLog()` היומן שמכיל את כל היומנים של `executeShellCommand(String)`.
`long`	`getExternalStoreFreeSpace()` שיטת עזר לקביעת כמות השטח הפנוי באחסון החיצוני של המכשיר.
`String`	`getFastbootPath()` הפונקציה מחזירה את הנתיב של קובץ ה-binary של fastboot שנמצא בשימוש.
`String`	`getFastbootProductType()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב אתחול מהיר.
`String`	`getFastbootProductVariant()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב אתחול מהיר.
`String`	`getFastbootSerialNumber()` מחזירה את המספר הסידורי של מצב אתחול מהיר (Fastboot).
`String`	`getFastbootVariable(String variableName)` אחזור הערך של משתנה fastboot נתון מהמכשיר.
`String`	`getFastbootVersion()` הפונקציה מחזירה את מחרוזת הגרסה של קובץ ה-binary של fastboot שבו נעשה שימוש.
`IFileEntry`	`getFileEntry(String path)` אחזור הפניה לקובץ מרוחק במכשיר.
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` עוזר לא רשמי לקבלת `FileEntry` מנתיב שאינו נתיב הבסיס.
	`getFoldableStates()` מחזירה את רשימת המצבים של מכשיר מתקפל.
`IDevice`	`getIDevice()` מחזירה הפניה ל-ddmlib המשויך `IDevice`.
	`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()` קבלת קובץ dump של logcat הנוכחי למכשיר.
`InputStreamSource`	`getLogcatSince(long date)` שולף זרם של תמונת מצב של נתוני logcat שתועדו החל מהתאריך שצוין.
`String`	`getMacAddress()` מחזירה את כתובת ה-MAC של המכשיר. אם השאילתה מהמכשיר נכשלת, הערך הוא null.
`Integer`	`getMainUserId()` הפונקציה מחזירה את מזהה המשתמש הראשי.
	`getMainlineModuleInfo()` קבלת מידע על מודולי ה-Mainline שמותקנים במכשיר.
`int`	`getMaxNumberOfRunningUsersSupported()` קבלת המספר המקסימלי של משתמשים שנתמכים בהפעלה בו-זמנית.
`int`	`getMaxNumberOfUsersSupported()` לקבל את המספר המקסימלי של משתמשים נתמכים.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` החזרת `IDeviceStateMonitor` שמשויך למכשיר.
`String`	`getMountPoint(String mountName)` מחזירה נקודת טעינה.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` הפונקציה מחזירה את הערך `MountPointInfo` שמתאים לנתיב של נקודת הטעינה שצוין, או את הערך `null` אם לא הותקן כלום בנתיב הזה או אם הוא לא מופיע ב-‎/proc/mounts כנקודת טעינה.
	`getMountPointInfo()` מחזירה גרסה מנותחת של המידע ב-‎ /proc/mounts במכשיר
`TestDeviceOptions`	`getOptions()` מאחזרים את אפשרויות הבדיקה של המכשיר.
`long`	`getPartitionFreeSpace(String partition)` שיטת עזר לקביעת כמות המקום הפנוי במחיצת המכשיר.
`Integer`	`getPrimaryUserId()` מחזירה את מזהה המשתמש הראשי.
`ProcessInfo`	`getProcessByName(String processName)` שיטת העזר מריצה את הפקודות pidof ו-stat ומחזירה אובייקט `ProcessInfo` עם מזהה התהליך (PID) וזמן התחלת התהליך של התהליך הנתון.
`String`	`getProcessPid(String process)` הפונקציה מחזירה את ה-pid של השירות או null אם משהו השתבש.
`String`	`getProductType()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה.
`String`	`getProductVariant()` שיטה נוחה לקבלת וריאציית המוצר של המכשיר הזה.
`String`	`getProperty(String name)` אחזור ערך המאפיין שצוין מהמכשיר.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` קבלת מצב השחזור הנוכחי שבו המכשיר נמצא.
`InputStreamSource`	`getScreenshot(long displayId)` מצלם צילום מסך מהמכשיר לפי מזהה התצוגה שצוין.
`InputStreamSource`	`getScreenshot(String format)` מצלם צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` מצלם צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot()` מצלם צילום מסך מהמכשיר.
`String`	`getSerialNumber()` שיטה נוחה לקבלת המספר הסידורי של המכשיר הזה.
`String`	`getSetting(int userId, String namespace, String key)` הפונקציה מחזירה את הערך של ההגדרה המבוקשת.
`String`	`getSetting(String namespace, String key)` מידע נוסף זמין במאמר בנושא `getSetting(int, String, String)`.
`String`	`getSimOperator()` מחזירה את שם המפעיל של כרטיס ה-SIM או null אם הוא לא זמין או אם המכשיר לא זמין.
`String`	`getSimState()` מחזירה את מצב כרטיס ה-SIM או null אם הוא לא זמין או שהמכשיר לא זמין.
	`getTombstones()` שליפה והחזרה של רשימת ה-tombstones מהמכשירים.
`long`	`getTotalMemory()` הפונקציה מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים, או -1 במקרה של שגיאה פנימית
`String`	`getTrackingSerial()` לצורך ניהול המכשיר, מקבלים את המספר הסידורי שמשמש למעקב אחרי המכשיר.
	`getUninstallablePackageNames()` שליפת שמות החבילות של האפליקציות שאפשר להסיר.
`boolean`	`getUseFastbootErase()` האם להשתמש ב-fastboot erase או ב-fastboot format כדי למחוק מחיצה במכשיר.
`int`	`getUserFlags(int userId)` חיפוש הדגלים של משתמש מסוים והחזרתם.
	`getUserInfos()` מקבל את המיפוי של useId אל `UserInfo` במכשיר.
`int`	`getUserSerialNumber(int userId)` הפונקציה מחזירה את המספר הסידורי שמשויך ל-userId אם הוא נמצא, או את הערך -10000 בכל מקרה אחר.
`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, String... extraArgs)` התקנה של חבילת Android במכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` התקנה של חבילת Android במכשיר.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר עבור משתמש מסוים.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקנה של חבילת Android במכשיר עבור משתמש מסוים.
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` התקנת קובצי APK במצב מצטבר.
`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()` הפונקציה מחזירה את הערך true אם המשתמש הראשי הוא אדמין קבוע ואי אפשר למחוק אותו או להוריד את רמת ההרשאה שלו ללא אדמין.
`boolean`	`isMultiUserSupported()` קובעת אם יש תמיכה במשתמשים מרובים.
`boolean`	`isPackageInstalled(String packageName, String userId)` שליחת שאילתה למכשיר לגבי שם חבילה ומזהה משתמש מסוימים כדי לבדוק אם האפליקציה מותקנת כרגע עבור המשתמש הזה.
`boolean`	`isPackageInstalled(String packageName)` שליחת שאילתה למכשיר לגבי שם חבילה מסוים כדי לבדוק אם החבילה מותקנת כרגע או לא.
`boolean`	`isRuntimePermissionSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בהענקת הרשאות בזמן ריצה
`boolean`	`isStateBootloaderOrFastbootd()` הפונקציה מחזירה את הערך true אם המכשיר נמצא בסטטוס `TestDeviceState.FASTBOOT` או `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` בודקים אם משתמש מסוים מפעיל את האפליקציה.
`boolean`	`isUserSecondary(int userId)` הפונקציה מחזירה אם המשתמש שצוין הוא משתמש משני לפי הסימון שלו.
`boolean`	`isUserVisible(int userId)` בודקת אם המשתמש הנתון גלוי.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` בודקת אם המשתמש הנתון גלוי בתצוגה הנתונה.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` הפונקציה מחזירה את הערך true אם המשתמשים יכולים להפעיל את המכשיר כשהוא פועל ברקע ב-`ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`, אחרת היא מחזירה את הערך false.
`boolean`	`isVisibleBackgroundUsersSupported()` הפונקציה מחזירה את הערך true אם המשתמשים יכולים להפעיל את המכשיר ברקע, ואת הערך false אם לא.
`boolean`	`isWifiEnabled()` בודקים אם ה-Wi-Fi מופעל.
	`listDisplayIds()` אוספים את רשימת מזהי התצוגות הזמינות במכשיר כפי שמדווח על ידי dumpsys SurfaceFlinger.
	`listDisplayIdsForStartingVisibleBackgroundUsers()` מקבל את רשימת המסכים שאפשר להשתמש בהם בשביל `start a user visible in the background`.
	`listUsers()` מקבל את רשימת המשתמשים במכשיר.
`boolean`	`logAnrs(ITestLogger logger)` איסוף של מקרי ANR מהמכשיר ורישום שלהם ביומן.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` שיטת עזר ליצירת דוח על באג ולתיעוד שלו בדוחות.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` לתעד הודעה ב-logcat של המכשיר.
`void`	`mountDebugfs()` טוענים את debugfs.
`void`	`nonBlockingReboot()` מפעיל פקודה להפעלה מחדש של המכשיר ומחזיר את המכשיר כשהפקודה מסתיימת וכשהמכשיר כבר לא גלוי ל-adb.
`void`	`postAdbRootAction()` החלפת ברירת המחדל אם צריך לבצע פעולות ספציפיות במכשיר אחרי adb root ולפני שהמכשיר חוזר למצב אונליין.
`void`	`postAdbUnrootAction()` החלפת ברירת המחדל אם צריך לבצע פעולות ספציפיות במכשיר אחרי ביטול הגישה ל-root באמצעות adb ולפני שהמכשיר חוזר למצב אונליין.
`void`	`postBootSetup()` פועלים לפי ההוראות להגדרת המכשיר לבדיקה אחרי כל אתחול.
`void`	`postInvocationTearDown(Throwable exception)` שלבים נוספים לניקוי נדרש ספציפי למכשיר, שיבוצעו אחרי סיום ההפעלה.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` שלבים נוספים להגדרה הנדרשת הספציפית למכשיר, שיבוצעו במכשיר לפני זרימת ההפעלה.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` שליפת תוכן של ספריות מהמכשיר באופן רקורסיבי.
`boolean`	`pullDir(String deviceFilePath, File localDir)` שליפת תוכן של ספריות מהמכשיר באופן רקורסיבי.
`boolean`	`pullFile(String remoteFilePath, File localFile)` שליפת קובץ מהמכשיר.
`File`	`pullFile(String remoteFilePath, int userId)` הפקודה מאחזרת קובץ מהמכשיר, מאחסנת אותו ב-`ERROR(/File)` מקומי זמני ומחזירה את `File`.
`File`	`pullFile(String remoteFilePath)` הפקודה מאחזרת קובץ מהמכשיר, מאחסנת אותו ב-`ERROR(/File)` מקומי זמני ומחזירה את `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` שליפת קובץ מהמכשיר.
`String`	`pullFileContents(String remoteFilePath)` מאחזר קובץ מהמכשיר ומחזיר את התוכן שלו.
`File`	`pullFileFromExternal(String remoteFilePath)` שיטה נוחה לאחזור קובץ מהאחסון החיצוני של המכשיר, שמירה שלו ב-`ERROR(/File)` זמני מקומי והחזרת הפניה ל-`File` הזה.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` דחיפה רקורסיבית של תוכן הספריות למכשיר, תוך החרגה של ספריות מסוימות שעברו סינון.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` שליחת תוכן של ספריות למכשיר באופן רקורסיבי.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` שליחת תוכן של ספריות למכשיר באופן רקורסיבי.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` גרסה של `pushFile(File, String)` שבה אפשר לבדוק את הצורך בספק התוכן.
`boolean`	`pushFile(File localFile, String remoteFilePath)` דחיפת קובץ למכשיר.
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` דחיפת קובץ למכשיר.
`boolean`	`pushString(String contents, String remoteFilePath)` העברת קובץ שנוצר ממחרוזת למכשיר
`void`	`reboot(String reason)` מפעיל מחדש את המכשיר למצב adb עם `reason` נתון שיישמר גם אחרי הפעלה מחדש.
`void`	`reboot()` מפעיל מחדש את המכשיר במצב adb.
`void`	`rebootIntoBootloader()` מפעיל מחדש את המכשיר במצב תוכנת אתחול.
`void`	`rebootIntoFastbootd()` מפעיל מחדש את המכשיר במצב fastbootd.
`void`	`rebootIntoRecovery()` מפעיל מחדש את המכשיר במצב שחזור של adb.
`void`	`rebootIntoSideload()` מפעיל מחדש את המכשיר במצב התקנה ממקור לא ידוע באמצעות adb (שימו לב שזהו מצב מיוחד במסגרת השחזור) חסימה עד שהמכשיר עובר למצב העברה צדדית
`void`	`rebootIntoSideload(boolean autoReboot)` מפעיל מחדש את המכשיר במצב התקנה ממקור לא ידוע באמצעות adb (שימו לב שזהו מצב מיוחד במסגרת השחזור) חסימה עד שהמכשיר עובר למצב העברה צדדית
`void`	`rebootUntilOnline()` חלופה ל-`reboot()` שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר עד שהוא גלוי ל-adb.
`void`	`rebootUntilOnline(String reason)` חלופה ל-`reboot()` שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר עד שהוא גלוי ל-adb.
`void`	`rebootUserspace()` מפעיל מחדש רק את החלק של מרחב המשתמש במכשיר.
`void`	`rebootUserspaceUntilOnline()` חלופה ל-`rebootUserspace()` ()} שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
`boolean`	`recoverDevice()` מנסה לשחזר את התקשורת עם המכשיר.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` המדיניות הזו רושמת את `IDeviceActionReceiver` במכשיר הזה.
`void`	`remountSystemReadOnly()` הפיכת מחיצת המערכת במכשיר לקריאה בלבד.
`void`	`remountSystemWritable()` הופכים את מחיצת המערכת במכשיר לכזו שאפשר לכתוב בה.
`void`	`remountVendorReadOnly()` הופכים את מחיצת הספק במכשיר לקריאה בלבד.
`void`	`remountVendorWritable()` הופכים את מחיצת הספק במכשיר לכזו שאפשר לכתוב בה.
`boolean`	`removeAdmin(String componentName, int userId)` מסיר את הרשאות האדמין במכשיר שצוין אצל המשתמש שצוין ומחזיר `true` אם הפעולה הצליחה, או `false` אם היא נכשלה.
`void`	`removeOwners()` להסיר את כל הבעלים הקיימים של פרופיל המכשיר, ככל האפשר.
`boolean`	`removeUser(int userId)` הסרת משתמש מסוים מהמכשיר.
`void`	`resetContentProviderSetup()` כדי להפעיל שוב את ההגדרה, צריך לאפס את הדגל של הגדרת ספק התוכן.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` שיטה נוחה לביצוע `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` עם מאזין אחד או יותר שמועברים כפרמטרים.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` הרצת בדיקות של מכשירים ומתן אפשרות לשחזור המכשיר.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` זהה ל-`ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))` אבל מריץ את הבדיקה עבור המשתמש שצוין.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` אותו דבר כמו `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)` אבל מריץ את הבדיקה עבור משתמש מסוים.
`void`	`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)` מעדכנים את מכשיר ה-iOS שמשויך ל-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)` יוצר את פקודת מערכת ההפעלה עבור סשן וארגומנטים נתונים של פקודת 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`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` מגדירים את מופע השעון שבו רוצים להשתמש.
`void`	`setMicrodroidProcess(Process process)` מסמן את TestDevice כ-microdroid ומגדיר את ה-CID שלו.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` מריץ פקודת fastboot פשוטה עם משתני סביבה ומדווח על הסטטוס של הפקודה.
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` מפעיל פקודת fastboot פשוטה ומדווח על הסטטוס של הפקודה.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` ממתינים עד שהמכשיר לא יהיה זמין (הדיווח ל-adb ייפסק).

ערכים קבועים

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 ציבוריים

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

זריקות
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

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

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

זריקות
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

זריקות
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

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

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

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetwork

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

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

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

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

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

זריקות
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

זריקות
`DeviceNotAvailableException`

createUser

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

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

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

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

זריקות
`DeviceNotAvailableException`

createUser

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

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

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

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

זריקות
`DeviceNotAvailableException`

createUser

public int createUser (String name)

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

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

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

זריקות
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

זריקות
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

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

החזרות
`DeviceInspectionResult`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

זריקות
`DeviceNotAvailableException`

deleteFile

public void deleteFile (String deviceFilePath)

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

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

זריקות
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

הסרת IDeviceActionReceiver הרשום.

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

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

זריקות
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

זריקות
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

השבתה של adb root.

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

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

זריקות
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

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

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

זריקות
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

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

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

זריקות
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

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

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

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

זריקות
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

זריקות
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

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

זריקות
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

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

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

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

זריקות
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

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

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

זריקות
`DeviceNotAvailableException`

executeAdbCommand

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

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

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

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

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

זריקות
`DeviceNotAvailableException`

executeAdbCommand

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

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

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

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

זריקות
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

זריקות
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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

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

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

זריקות
`DeviceNotAvailableException`

executeAdbV2Command

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

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

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

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

זריקות
`DeviceNotAvailableException`

executeAdbV2Command

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

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

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

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

זריקות
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

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

זריקות
`DeviceNotAvailableException`

executeFastbootCommand

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

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

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

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

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

זריקות
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

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

זריקות
`DeviceNotAvailableException`

executeLongFastbootCommand

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

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

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

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

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

זריקות
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

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

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

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

זריקות
`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`

זריקות
`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`: מספר הפעמים המקסימלי לניסיון חוזר של הפקודה אם היא נכשלת בגלל חריגה. אם הפעולות `retryAttempts` לא יבוצעו בהצלחה, תופעל חריגה מסוג DeviceNotResponsiveException.

זריקות
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

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

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

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

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

זריקות
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

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

זריקות
`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`: מספר הפעמים המקסימלי לניסיון חוזר של הפקודה אם היא נכשלת בגלל חריגה. אם הפעולות `retryAttempts` לא יבוצעו בהצלחה, תופעל חריגה מסוג DeviceNotResponsiveException.

החזרות
`CommandResult`

זריקות
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

החזרות
`CommandResult`

זריקות
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

החזרות
`CommandResult`

זריקות
`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`: `ERROR(/File)` שיועבר כקלט לפקודה, או null.
`pipeToOutput`	‫`OutputStream`: `ERROR(/OutputStream)` לאן יופנה הפלט הרגיל, או null.
`pipeToError`	‫`OutputStream`: `ERROR(/OutputStream)` לאן יופנה ה-stderr, או null.
`maxTimeoutForCommand`	‫`long`: הזמן המקסימלי להמתנה עד לסיום הפקודה. היחידה מצוינת ב-`timeUnit`
`timeUnit`	`TimeUnit`: יחידה ל`maxTimeToOutputShellResponse`
`retryAttempts`	‫`int`: מספר הפעמים המקסימלי לניסיון חוזר של הפקודה אם היא נכשלת בגלל חריגה. אם הפעולות `retryAttempts` לא יבוצעו בהצלחה, תופעל חריגה מסוג DeviceNotResponsiveException.

החזרות
`CommandResult`

זריקות
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

זריקות
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

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

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

זריקות
`DeviceNotAvailableException`

getAdbPath

public String getAdbPath ()

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

החזרות
`String`

getAllSettings

public  getAllSettings (String namespace)

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

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

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

זריקות
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

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

החזרות
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

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

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

החזרות
`String`

זריקות
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

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

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

זריקות
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

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

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

זריקות
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

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

זריקות
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

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

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

זריקות
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

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

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

זריקות
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

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

החזרות
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

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

זריקות
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

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

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

זריקות
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

זריקות
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

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

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

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

זריקות
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

התמיכה קיימת רק בגרסה של adb שגדולה מ-1.0.36

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

getBuildAlias

public String getBuildAlias ()

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

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

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

זריקות
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

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

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

זריקות
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

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

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

זריקות
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

זריקות
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

החזרות
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

החזרות
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

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

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

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

זריקות
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

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

החזרות
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

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

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

החזרות
`ContentProviderHandler`

זריקות
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

החזרות
`DeviceFoldableState`

זריקות
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

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

החזרות
`int`

זריקות
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

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

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

getDeviceDate

public long getDeviceDate ()

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

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

זריקות
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

החזרות
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

החזרות
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

קבלת מצב המכשיר.

החזרות
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

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

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

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

זריקות
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

קבלת הזרם של stdout ו-stderr של האמולטור

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

getEmulatorProcess

public Process getEmulatorProcess ()

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

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

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

החזרות
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

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

זריקות
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

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

החזרות
`String`

getFastbootProductType

public String getFastbootProductType ()

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

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

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

זריקות
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

זריקות
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

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

החזרות
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

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

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

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

זריקות
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

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

החזרות
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

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

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

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

זריקות
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

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

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

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

getFoldableStates

public  getFoldableStates ()

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

החזרות

זריקות
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

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

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

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

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

זריקות
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

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

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

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

זריקות
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

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

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

זריקות
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

זריקות
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

החזרות
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

זריקות
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

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

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

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

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

החזרות
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

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

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

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

החזרות
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

קבלת קובץ dump של 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 אם אין משתמש ראשי.

זריקות
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

זריקות
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

זריקות
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

זריקות
`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`	‫`ERROR(/List)` של `MountPointInfo` שמכיל את המידע ב-‎/proc/mounts

זריקות
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

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

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

זריקות
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

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

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

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

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

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

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

זריקות
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

מחזירה את מזהה המשתמש הראשי.

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

זריקות
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

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

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

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

זריקות
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

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

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

החזרות
`String`

זריקות
`DeviceNotAvailableException`

getProductType

public String getProductType ()

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

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

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

זריקות
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

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

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

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

זריקות
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

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

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

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

זריקות
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

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

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

זריקות
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

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

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

זריקות
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

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

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

getSetting

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

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

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

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

זריקות
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

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

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

החזרות
`String`

זריקות
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

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

החזרות
`String`

getSimState

public String getSimState ()

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

החזרות
`String`

getTombstones

public  getTombstones ()

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

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

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

זריקות
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

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

החזרות
`long`

getTrackingSerial

public String getTrackingSerial ()

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

החזרות
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

זריקות
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

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

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

getUserFlags

public int getUserFlags (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

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

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

זריקות
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

החזרות
`int`

זריקות
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

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

החזרות
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

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

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

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

זריקות
`DeviceNotAvailableException`

initializeConnection

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

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

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

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

installPackage

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

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

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

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

זריקות
`DeviceNotAvailableException`

installPackage

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

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

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

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

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

זריקות
`DeviceNotAvailableException`

installPackageForUser

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

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

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

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

זריקות
`DeviceNotAvailableException`

installPackageForUser

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

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

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

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

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

זריקות
`DeviceNotAvailableException`

installPackageWithIncrementalMode

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

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

החזרות
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

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

זריקות
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

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

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

זריקות
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

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

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

זריקות
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

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

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

זריקות
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

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

isEncryptionSupported

public boolean isEncryptionSupported ()

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

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

זריקות
`DeviceNotAvailableException`

isExecutable

public boolean isExecutable (String fullPath)

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

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

החזרות
`boolean`

isHeadless

public boolean isHeadless ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

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

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

זריקות
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

זריקות
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

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

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

זריקות
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

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

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

זריקות
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

החזרות
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

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

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

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

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

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

זריקות
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

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

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

זריקות
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

החזרות

זריקות
`DeviceNotAvailableException`

listUsers

public  listUsers ()

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

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

זריקות
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

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

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

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

זריקות
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

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

logOnDevice

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

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

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

mountDebugfs

public void mountDebugfs ()

טוענים את debugfs.

זריקות
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

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

זריקות
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

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

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

postAdbUnrootAction

public void postAdbUnrootAction ()

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

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

postBootSetup

public void postBootSetup ()

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

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

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

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

זריקות
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

preInvocationSetup

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

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

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

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

pullDir

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

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

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

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

זריקות
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

זריקות
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

זריקות
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

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

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

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

זריקות
`DeviceNotAvailableException`

pullFile

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

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

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

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

זריקות
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

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

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

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

זריקות
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

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

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

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

זריקות
`DeviceNotAvailableException`

pushDir

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

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

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

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

זריקות
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

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

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

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

זריקות
`DeviceNotAvailableException`

pushDir

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

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

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

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

זריקות
`DeviceNotAvailableException`

pushFile

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

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

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

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

זריקות
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

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

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

זריקות
`DeviceNotAvailableException`

pushFile

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

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

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

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

זריקות
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

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

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

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

זריקות
`DeviceNotAvailableException`

הפעלה מחדש

public void reboot (String reason)

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

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

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

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

זריקות
`DeviceNotAvailableException`

הפעלה מחדש

public void reboot ()

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

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

זריקות
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

זריקות
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

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

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

זריקות
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

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

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

זריקות
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

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

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

זריקות
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

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

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

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

זריקות
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

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

זריקות
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

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

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

זריקות
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

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

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

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

זריקות
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

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

זריקות
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

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

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

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

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

remountSystemReadOnly

public void remountSystemReadOnly ()

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

זריקות
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

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

זריקות
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

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

זריקות
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

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

זריקות
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

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

זריקות
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

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

runInstrumentationTests

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

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

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

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

זריקות
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

זריקות
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

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

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

אותו דבר כמו ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) אבל מריץ את הבדיקה עבור משתמש מסוים.

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

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`

זריקות
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

עדכון מצב המכשיר.

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

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

לסימון פלט לרישום ביומן עבור אמולטורSizeLimitedOutputStream

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

setEmulatorProcess

public void setEmulatorProcess (Process p)

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

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

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

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

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

setFastbootPath

public void setFastbootPath (String fastbootPath)

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

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

setIDevice

public void setIDevice (IDevice newDevice)

מעדכנים את מכשיר ה-iOS שמשויך ל-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.

זריקות
`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`

זריקות
`DeviceNotAvailableException`

setSetting

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

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

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

זריקות
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

החדרת המופע ITestLogger

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

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

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

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

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

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

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

startLogcat

public void startLogcat ()

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

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

כשמפסיקים להשתמש במכשיר, צריך להפעיל את stopLogcat().

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

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

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

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

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

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

startUser

public boolean startUser (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

זריקות
`DeviceNotAvailableException`

startVisibleBackgroundUser

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

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

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

פרמטרים
`userId`	‫`int`: של המשתמש כדי להתחיל ברקע
`displayId`	‫`int`: display to start user visible on
`waitFlag`	‫`boolean`: הפקודה תמתין עד שהמשתמש יופעל וייפתח.

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

זריקות
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

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

stopLogcat

public void stopLogcat ()

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

לא תהיה השפעה אם פלט logcat לא נלכד.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

להפסיק את הבדיקה של מצב טרייד-אין.

זריקות
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

stopUser

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

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

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

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

זריקות
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

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

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

זריקות
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

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

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

זריקות
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

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

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

זריקות
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

המערכת תתעלם מקבצים מוסתרים (ששמותיהם מתחילים בנקודה '.').

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

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

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

זריקות
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

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

החזרות
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

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

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

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

זריקות
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

זריקות
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

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

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

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

זריקות
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

מבטלים את הטעינה של debugfs.

זריקות
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

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

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

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

זריקות
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

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

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

זריקות
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

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

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

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

זריקות
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

זריקות
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

זריקות
`DeviceNotAvailableException`

waitForDeviceFastbootD

public void waitForDeviceFastbootD ()

זריקות
`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().

זריקות
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

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

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

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

זריקות
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

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

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

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

שיטות מוגנות

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

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

buildAdbShellCommand

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

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

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

החזרות
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

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

createRebootDeviceAction

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

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

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

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

createRunUtil

protected IRunUtil createRunUtil ()

החזרות
`IRunUtil`

doAdbReboot

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

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

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

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

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

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

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

getApiLevelSafe

protected int getApiLevelSafe ()

החזרות
`int`

getLogger

protected ITestLogger getLogger ()

החזרות
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

משיגים את מופע RunUtil שרוצים להשתמש בו.

החזרות
`IRunUtil`

internalGetProperty

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

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

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

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

זריקות
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

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

החזרות
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

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

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

החזרות
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

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

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

notifyRebootStarted

protected void notifyRebootStarted ()

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

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

performDeviceAction

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

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

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

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

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

postAdbReboot

protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

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

פרמטרים
`rebootMode`	`NativeDevice.RebootMode`

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

prePostBootSetup

protected void prePostBootSetup ()

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

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

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

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

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

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

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

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

פרמטרים
`deviceOptions`

simpleFastbootCommand

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

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

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

החזרות
`CommandResult`

simpleFastbootCommand

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

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

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

החזרות
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

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

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

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

NativeDevice

סיכום

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

ערכים קבועים

שדות

Constructors ציבוריים

‫methods ציבוריים

שיטות מוגנות

ערכים קבועים

DEBUGFS_PATH

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

SD_CARD

STORAGE_EMULATED

שדות

mOptions

mStateMonitor

Constructors ציבוריים

NativeDevice

‫methods ציבוריים

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

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

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAdbPath

getAllSettings

getAllocationState

getAndroidId