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

NativeDevice

public class NativeDevice
extends Object implements IManagedTestDevice, IConfigurationReceiver, ITestLoggerReceiver

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

כיתות משנה ישירות ידועות

TestDevice

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

תתי-מחלקות עקיפות ידועות

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedremoteDevice, remoteAndroidDevice, remoteAndroidVirtualDevice

LocalAndroidVirtualDevice	המחלקה למכשירים וירטואליים מקומיים שפועלים ב-TrendFed host.
ManagedRemoteDevice	מכשיר שפועל במכונה וירטואלית שאנחנו מנהלים מרחוק דרך מכונה של Tradeified בתוך המכונה הווירטואלית.
NestedremoteDevice	ייצוג של המכשיר שפועל ב-VM מרחוק של Cuttlefish.
RemoteAndroidDevice	הטמעה של `ITestDevice` למכשיר Android בסטאק מלא שמחובר דרך adb Connect.
RemoteAndroidVirtualDevice	הרחבת ההתנהגות של `RemoteAndroidDevice` למכשירי Android מסוג סטאק מלא שפועל ב-Google Compute Engine (Gce).

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

סיכום

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

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

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

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

שיטות ציבוריות
`void`	`batchPrefetchStartupBuildProps()` אופטימיזציה של מיקרו (בערך 400 אלפיות השנייה) על ידי שליפה מראש של כל הרכיבים שדרושים לנו, במקום לקרוא ל-'adb getpromo' של כל אחד.
`boolean`	`canSwitchToHeadlessSystemUser()` הפונקציה מחזירה אם מותר לעבור למשתמש SYSTEM ללא GUI.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` לבדוק אם תכונה מסוימת נתמכת כרגע בהינתן רמה מינימלית של תמיכה.
`boolean`	`checkConnectivity()` חשוב לבדוק שלמכשיר יש קישוריות לרשת.
`boolean`	`clearErrorDialogs()` אפשר לנסות לסגור את כל תיבות הדו-שיח של השגיאה שמוצגות כרגע בממשק המשתמש של המכשיר.
`void`	`clearLastConnectedWifiNetwork()` ניקוי רשת ה-Wi-Fi האחרונה שחוברה.
`void`	`clearLogcat()` מחיקת כל נתוני ה-Logcat שהצטברו.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` התחברות לרשת Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` מתחבר לרשת Wi-Fi.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` וריאנט של `connectToWifiNetwork(String, String)` שמתחבר רק אם למכשיר אין כרגע קישוריות רשת.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` וריאנט של `connectToWifiNetwork(String, String)` שמתחבר רק אם למכשיר אין כרגע קישוריות רשת.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` יצירת משתמש עם שם נתון והדגלים שסופקו
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` יצירת משתמש עם שם נתון והדגלים שסופקו
`int`	`createUser(String name)` יצירת משתמש עם שם נתון ודגלי ברירת המחדל 0.
`int`	`createUserNoThrow(String name)` יצירת משתמש עם שם נתון ודגלי ברירת המחדל 0.
`void`	`deleteFile(String deviceFilePath, int userId)` שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
`void`	`deleteFile(String deviceFilePath)` שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` הסרה של `IDeviceActionReceiver` הרשום.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` שיטה שעוזרת לבדוק אם המכשיר הופעל מחדש באמצעות השוואת השרת system_server הנוכחי ל-system_server הקודם `ProcessInfo`.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` שיטה של עוזרת לבדוק אם המכשיר הופעל מחדש מאז זמן UTC מאז תחילת התקופה של ההגדרה, מהמכשיר ומ-`ERROR(/TimeUnit)`.
`boolean`	`disableAdbRoot()` משבית את שורש adb.
`void`	`disableKeyguard()` מנסה להשבית את מגן המקשים.
`boolean`	`disableNetworkMonitor()` ההגדרה משביתה ניטור רשת במכשיר.
`boolean`	`disconnectFromWifi()` המכשיר מתנתק מרשת Wi-Fi.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` שיטה עוזרת לקבוע אם קובץ במכשיר קיים למשתמש מסוים.
`boolean`	`doesFileExist(String deviceFilePath)` שיטה עוזרת לקבוע אם קובץ קיים במכשיר.
`File`	`dumpHeap(String process, String devicePath)` נסה למחוק את הערימה מה-system_server.
`boolean`	`enableAdbRoot()` הפעלת השורש של adb.
`boolean`	`enableNetworkMonitor()` הפעלת ניטור רשת במכשיר.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
`String`	`executeAdbCommand(String... cmdArgs)` שיטת עזרה שמבצעת פקודת adb כפקודת מערכת.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת, עם זמן קצוב לתפוגה של 2 דקות כברירת מחדל.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) כפקודת מערכת.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) בהרצה ארוכה כפקודת מערכת עם משתני סביבה של המערכת.
`String`	`executeShellCommand(String command)` שיטת עזרה שמפעילה פקודת מעטפת מסוג adb ומחזירה את הפלט בתור `String`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` מפעיל את פקודת המעטפת הנתונה של adb, ומנסה שוב מספר פעמים אם הפקודה נכשלת.
`CommandResult`	`executeShellV2Command(String cmd)` שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור `CommandResult`, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור `CommandResult`, שמאוכלס כראוי בפלט סטטוס הפקודה וב-stderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור `CommandResult`, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`CommandResult`	`fastbootWipePartition(String partition)` שיטה לעזרה באיפוס המחיצה של המכשיר.
	`getActiveApexes()` אחזור המידע על הפעלה של APEX במכשיר.
	`getAllSettings(String namespace)` החזרת זוגות של ערכי מפתח ממרחב שמות מבוקש.
`DeviceAllocationState`	`getAllocationState()` החזרת מצב ההקצאה הנוכחי של המכשיר
`String`	`getAndroidId(int userId)` חיפוש והחזרת android-id המשויך ל-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)` שיטת העזרה אוספת את מפת היסטוריית האתחול עם זמן האתחול וסיבת האתחול מאז הזמן הנתון מאז תחילת השימוש במכשיר ויחידת הזמן שצוינה.
`String`	`getBootloaderVersion()` שיטת נוחות לקבלת גרסת תוכנת האתחול של המכשיר הזה.
`InputStreamSource`	`getBugreport()` אחזור דוח על באג מהמכשיר.
`InputStreamSource`	`getBugreportz()` אחזור דוח על באג מהמכשיר.
`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()` מחזירה את הנתיב של הקובץ הבינארי של אתחול מהיר (fastboot) שבו משתמשים.
`String`	`getFastbootProductType()` שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
`String`	`getFastbootProductVariant()` שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
`String`	`getFastbootSerialNumber()` מחזירה את המספר הסידורי של מצב אתחול מהיר (fastboot).
`String`	`getFastbootVariable(String variableName)` מאחזרים את הערך הנתון של משתנה אתחול מהיר מהמכשיר.
`String`	`getFastbootVersion()` מחזירה את מחרוזת הגרסה של הקובץ הבינארי של אתחול מהיר שבו נעשה שימוש.
`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()` החזרת אובייקט כדי לקבל את המצב הנוכחי של KeyGuard או כ-null אם אין בו תמיכה.
`long`	`getLastExpectedRebootTimeMillis()` הפונקציה מחזירה את הפעם האחרונה שבה ממשקי API של Tradeified הפעילו הפעלה מחדש באלפיות השנייה, מאז EPOCH כפי שהוחזר על ידי `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` מקבלים את רמת ה-API הראשונה שהושקה במכשיר.
`InputStreamSource`	`getLogcat()` תופסת רצף snapshot של נתוני ה-Logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` תופס זרם של תמונת מצב של `maxBytes` נתוני ה-Logcat שתועדו.
`InputStreamSource`	`getLogcatDump()` אחזור של קובץ ה-Dump של ה-Logcat הנוכחי במכשיר.
`InputStreamSource`	`getLogcatSince(long date)` יוצר זרם snapshot של נתוני Logcat שתועדו החל מהתאריך שצוין.
`String`	`getMacAddress()` מחזירה את כתובת ה-MAC של המכשיר, null אם לא ניתן לשלוח שאילתה מהמכשיר.
`Integer`	`getMainUserId()` הפונקציה מחזירה את מזהה המשתמש הראשי.
	`getMainlineModuleInfo()` קבלת המידע על המודולים של השורה הראשית שמותקנים במכשיר.
`int`	`getMaxNumberOfRunningUsersSupported()` קבלת המספר המקסימלי של משתמשים פעילים נתמכים בו-זמנית.
`int`	`getMaxNumberOfUsersSupported()` קבלת המספר המקסימלי של משתמשים נתמכים.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` החזרת `IDeviceStateMonitor` המשויך למכשיר.
`String`	`getMountPoint(String mountName)` מחזירה נקודת טעינה.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` הפונקציה מחזירה ערך `MountPointInfo` שתואם לנתיב של נקודת הטעינה שצוין, או `null` אם לנתיב הזה לא נטען שום דבר או אם הוא לא מופיע ב- /proc/Loads כנקודת טעינה.
	`getMountPointInfo()` החזרת גרסה מנותחת של המידע ב- /proc/Loads במכשיר
`TestDeviceOptions`	`getOptions()` מאחזרים את אפשרויות הבדיקה של המכשיר.
`long`	`getPartitionFreeSpace(String partition)` שיטה שעוזרת לקבוע את נפח האחסון הפנוי במחיצה במכשיר.
`Integer`	`getPrimaryUserId()` מחזירה את מזהה המשתמש הראשי.
`ProcessInfo`	`getProcessByName(String processName)` שיטת ה-Assistant מריצה את הפקודות pidof ו-stat ומחזירה אובייקט `ProcessInfo` עם PID ושעת ההתחלה של התהליך של התהליך הנתון.
`String`	`getProcessPid(String process)` מחזירה את ה-pid של השירות או את הערך null אם משהו השתבש.
`String`	`getProductType()` שיטת נוחות לקבלת סוג המוצר של המכשיר הזה.
`String`	`getProductVariant()` שיטה נוחות לקבלת וריאציית המוצר של המכשיר הזה.
`String`	`getProperty(String name)` מאחזרים את ערך המאפיין הנתון מהמכשיר.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` משתמשים במצב השחזור הנוכחי של המכשיר.
`InputStreamSource`	`getScreenshot(String format)` מצלם צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot(long displayId)` מצלם צילום מסך מהמכשיר שצוין למזהה התצוגה.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` מצלם צילום מסך מהמכשיר.
`InputStreamSource`	`getScreenshot()` מצלם צילום מסך מהמכשיר.
`String`	`getSerialNumber()` שיטת נוחות לקבלת המספר הסידורי של המכשיר הזה.
`String`	`getSetting(int userId, String namespace, String key)` מחזירה את הערך של ההגדרה המבוקשת.
`String`	`getSetting(String namespace, String key)` הצגת `getSetting(int, String, String)` ובוצעה במשתמש מערכת.
`String`	`getSimOperator()` יש להחזיר את המפעיל של כרטיס ה-SIM או אם הוא לא זמין או אם המכשיר לא זמין.
`String`	`getSimState()` החזרת מצב כרטיס ה-SIM או אפס אם לא זמין או שהמכשיר לא זמין.
	`getTombstones()` מאחזרים את רשימת המצבות ומחזירים אותה מהמכשירים.
`long`	`getTotalMemory()` פונקציה זו מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים או -1 במקרה של שגיאה פנימית
	`getUninstallablePackageNames()` מאחזרים את שמות החבילות של האפליקציות שאפשר להסיר.
`boolean`	`getUseFastbootErase()` בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר.
`int`	`getUserFlags(int userId)` למצוא ולהחזיר את הדגלים של משתמש נתון.
	`getUserInfos()` הפונקציה מקבלת את מפת useId אל `UserInfo` במכשיר.
`int`	`getUserSerialNumber(int userId)` אם נמצא, יש להחזיר את המספר הסידורי שמשויך למזהה המשתמש, -10000 במקרים אחרים.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` מעבדים את ה-DeviceEvent הנתון. עיבוד ה-DeviceEvent, שעשוי להעביר את המכשיר הזה למצב הקצאה חדש, אבל לא בהכרח.
`boolean`	`hasFeature(String feature)` בודקים אם התכונה זמינה במכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` מתקינים חבילת Android במכשיר.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` מתקינים חבילת Android במכשיר.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` התקנת חבילת Android במכשיר של משתמש מסוים.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` התקנת חבילת Android במכשיר של משתמש מסוים.
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
`boolean`	`isBypassLowTargetSdkBlockSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בעקיפת חסימת SDK עם יעדים נמוכים בהתקנות של אפליקציות
`boolean`	`isDebugfsMounted()` בודקים אם רכיבי ניפוי הבאגים טענו.
`boolean`	`isDeviceEncrypted()` הפונקציה מחזירה אם המכשיר מוצפן.
`boolean`	`isDirectory(String path)` פונקציה זו מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה. אחרת, הערך false.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` הפונקציה מחזירה אם המכשיר תומך בהצפנה.
`boolean`	`isExecutable(String fullPath)` הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ להפעלה. אחרת, False.
`boolean`	`isFastbootEnabled()` צריך לחזור אם התכונה 'אתחול מהיר' זמינה במכשיר.
`boolean`	`isHeadless()` פונקציה זו מחזירה את הערך true אם המכשיר ללא GUI (ללא מסך). אחרת, הערך false.
`boolean`	`isHeadlessSystemUserMode()` מחזירה אם המכשיר משתמש במצב משתמש במערכת ללא GUI.
`boolean`	`isMainUserPermanentAdmin()` הפונקציה מחזירה אם המשתמש הראשי הוא אדמין קבוע ולא ניתן למחוק או לשדרג לאחור לסטטוס שאינו אדמין.
`boolean`	`isMultiUserSupported()` המדיניות קובעת אם יש תמיכה בריבוי משתמשים.
`boolean`	`isPackageInstalled(String packageName, String userId)` שולחים למכשיר שאילתה על שם חבילה נתון ומזהה משתמש כדי לבדוק אם היא מותקנת או לא אצל המשתמש הזה.
`boolean`	`isPackageInstalled(String packageName)` שולחים למכשיר שאילתה על שם חבילה מסוים כדי לבדוק אם הוא מותקן כרגע או לא.
`boolean`	`isRuntimePermissionSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בהענקת הרשאות בתחילת ההפעלה
`boolean`	`isStateBootloaderOrFastbootd()` הפונקציה מחזירה את הערך True אם המכשיר נמצא ב-`TestDeviceState#FASTBOOT` או ב-`TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` בודקים אם משתמש מסוים פועל.
`boolean`	`isUserSecondary(int userId)` מחזירה אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.
`boolean`	`isUserVisible(int userId)` הפונקציה בודקת אם המשתמש הנתון גלוי.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` הפונקציה בודקת אם המשתמש הנתון גלוי במסך הנתון.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` הפונקציה מחזירה אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע ב-`ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` הפונקציה מחזירה אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע.
`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()` טעינת ניפוי באגים.
`void`	`nonBlockingReboot()` יוצר פקודה להפעלה מחדש של המכשיר וחוזרת אחרי שהפקודה הושלמה וכשהמכשיר כבר לא גלוי ל-adb.
`void`	`postAdbRootAction()` המדיניות הזו מאפשרת לקבוע אם המכשיר צריך לבצע פעולות ספציפיות אחרי הרמה הבסיסית (root) ולפני שהמכשיר מתחבר שוב לאינטרנט.
`void`	`postAdbUnrootAction()` המדיניות הזו קובעת אם צריך לבצע פעולות ספציפיות במכשיר אחרי ביטול ה-adb Root ולפני שהמכשיר יחובר לאינטרנט.
`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()` הפעלת המכשיר מחדש במצב adbrecovery.
`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`	`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)` מגדיר את הנתיב לקובץ הבינארי של אתחול מהיר שבו יש להשתמש.
`void`	`setIDevice(IDevice newDevice)` עדכון ה-IDevice המשויך ל-ITestDevice הזה.
`void`	`setLogStartDelay(int delay)` הגדרת משך הזמן באלפיות השנייה לפני התחלת צילום Logcat במכשיר אונליין.
`void`	`setOptions(TestDeviceOptions options)` הגדרת `TestDeviceOptions` של המכשיר
`boolean`	`setProperty(String propKey, String propValue)` מגדיר את ערך המאפיין הנתון במכשיר.
`void`	`setRecovery(IDeviceRecovery recovery)` הגדרת `IDeviceRecovery` לשימוש במכשיר הזה.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` הגדרת מצב השחזור הנוכחי לשימוש במכשיר.
`void`	`setSetting(String namespace, String key, String value)` הצגת `setSetting(int, String, String, String)` ובוצעה במשתמש מערכת.
`void`	`setSetting(int userId, String namespace, String key, String value)` אתם יכולים להוסיף ערך הגדרה למרחב השמות של משתמש נתון.
`void`	`setTestLogger(ITestLogger testLogger)` החדרה של המכונה `ITestLogger`
`void`	`setUseFastbootErase(boolean useFastbootErase)` הגדרה אם להשתמש בפורמט מחיקה של אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי לאפס מחיצה במכשיר.
`void`	`startLogcat()` התחלת הצילום של פלט Logcat מהמכשיר ברקע.
`boolean`	`startUser(int userId)` מפעיל משתמש מסוים ברקע אם הוא מופסק כרגע.
`boolean`	`startUser(int userId, boolean waitFlag)` מפעיל משתמש מסוים ברקע אם הוא מופסק כרגע.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` מפעיל משתמש מסוים ברקע, גלוי במסך הנתון (כלומר, מאפשר למשתמש להפעיל פעילויות במסך הזה).
`void`	`stopEmulatorOutput()` סוגרים את הפלט של האמולטור ומוחקים אותו.
`void`	`stopLogcat()` הפסקת התיעוד של פלט ה-Logcat מהמכשיר ומחיקת נתוני ה-Logcat שנשמרו.
`boolean`	`stopUser(int userId)` עוצר משתמש נתון.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` עצירה של משתמש נתון.
`String`	`switchToAdbTcp()` העברת המכשיר למצב adb-over-tcp.
`boolean`	`switchToAdbUsb()` העברת המכשיר למצב adb על גבי USB.
`boolean`	`switchUser(int userId)` צריך לעבור ל-User-ID אחר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל.
`boolean`	`switchUser(int userId, long timeout)` עוברים ל-User-ID אחר עם הזמן הקצוב לתפוגה שצוין כתאריך היעד.
`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()` ניתוק של ניפוי באגים.
`boolean`	`waitForBootComplete(long timeOut)` הפעולה תיחסם עד שתגדירו את התכונה הניסיונית להשלמת ההפעלה של המכשיר.
`boolean`	`waitForDeviceAvailable()` בהמתנה עד שהמכשיר יגיב וזמין לבדיקה.
`boolean`	`waitForDeviceAvailable(long waitTime)` בהמתנה עד שהמכשיר יגיב וזמין לבדיקה.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` בהמתנה עד שהמכשיר יגיב וזמין בלי להביא בחשבון את נתיב השחזור.
`void`	`waitForDeviceBootloader()` חסימה עד שניתן לראות את המכשיר באמצעות אתחול מהיר (fastboot).
`boolean`	`waitForDeviceInRecovery(long waitTime)` חסימת המכשיר למצב 'שחזור adb' (שים לב לכך שהוא שונה מ- `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` חסימה כדי שהמכשיר יהיה במצב 'adb offload'
`boolean`	`waitForDeviceNotAvailable(long waitTime)` חסימות כדי שהמכשיר לא יהיה זמין, כלומר חסר ב-adb
`void`	`waitForDeviceOnline()` חסימה עד שהמכשיר גלוי דרך adb.
`void`	`waitForDeviceOnline(long waitTime)` חסימה עד שהמכשיר גלוי דרך adb.
`boolean`	`waitForDeviceShell(long waitTime)` בהמתנה עד שהמכשיר יגיב לפקודת מעטפת בסיסית של adb.

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

קבועים

INVALID_USER_ID

public static final int INVALID_USER_ID

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

ערך קבוע: -10,000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

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

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

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

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

שדות

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

אפשרויות MOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

בנאים ציבוריים

NativeDevice

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

ייווצר TestDevice.

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

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

אצווהPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

CanSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

קליעות
`DeviceNotAvailableException`

בדיקת קישוריות

public boolean checkConnectivity ()

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

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

קליעות
`DeviceNotAvailableException`

cleanErrorDialogs

public boolean clearErrorDialogs ()

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

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

קליעות
`DeviceNotAvailableException`

cleanLastConnectedWi-FiNetwork

public void clearLastConnectedWifiNetwork ()

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

ניקוי הרישום ביומן

public void clearLogcat ()

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

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

ConnectToWi-FiNetwork

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`

ConnectToWi-FiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

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

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

קליעות
`DeviceNotAvailableException`

ConnectToWi-FiNetwork

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`

ConnectToWi-FiNetwork

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

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

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

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

קליעות
`DeviceNotAvailableException`

ConnectToWi-FiNetworkIf Needed

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

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

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

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

קליעות
`DeviceNotAvailableException`

ConnectToWi-FiNetworkIf Needed

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`: הפעלת סימון המשתמש – אורח במהלך היצירה
`ephemeral`	`boolean`: הפעלת סימון המשתמש באופן זמני במהלך היצירה

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

קליעות
`DeviceNotAvailableException`

CreateUser

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

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

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

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

קליעות
`DeviceNotAvailableException`

CreateUser

public int createUser (String name)

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

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

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

קליעות
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

קליעות
`DeviceNotAvailableException`

DeleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

קליעות
`DeviceNotAvailableException`

DeleteFile

public void deleteFile (String deviceFilePath)

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

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

קליעות
`DeviceNotAvailableException`

ביטול הרישוםDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

הסרה של IDeviceActionReceiver הרשום.

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

המכשיר הופעל מחדש

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

קליעות
`DeviceNotAvailableException`

מכשירSoftאתחול מאז

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

קליעות
`DeviceNotAvailableException`

השבתתAdbRoot

public boolean disableAdbRoot ()

משבית את שורש adb.

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

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

קליעות
`DeviceNotAvailableException`

השבתה של KeyGuard

public void disableKeyguard ()

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

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

קליעות
`DeviceNotAvailableException`

השבתת NetworkMonitor

public boolean disableNetworkMonitor ()

ההגדרה משביתה ניטור רשת במכשיר.

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

קליעות
`DeviceNotAvailableException`

התנתקות מ-Wi-Fi

public boolean disconnectFromWifi ()

המכשיר מתנתק מרשת Wi-Fi.

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

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

קליעות
`DeviceNotAvailableException`

DoFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

קליעות
`DeviceNotAvailableException`

DoFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

קליעות
`DeviceNotAvailableException`

עריסות

public File dumpHeap (String process, 
                String devicePath)

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

פרמטרים
`process`	`String`: שם התהליך במכשיר שאליו רוצים לבצע את ה-Dumpheap.
`devicePath`	`String`: הנתיב במכשיר שבו צריך למקם את קובץ ה-Dump. זה חייב להיות המיקום שבו ההרשאות מאפשרות זאת.

החזרות
`File`	`ERROR(/File)` שמכיל את הדוח. המערכת תציג ערך של null אם משהו נכשל.

קליעות
`DeviceNotAvailableException`

הפעלתAdbRoot

public boolean enableAdbRoot ()

הפעלת השורש של adb. אם ההגדרה Enable-root היא False, תופיע הודעה ביומן ותוחזר בלי להפעיל Root.

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

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

קליעות
`DeviceNotAvailableException`

הפעלת NetworkMonitor

public boolean enableNetworkMonitor ()

הפעלת ניטור רשת במכשיר.

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

קליעות
`DeviceNotAvailableException`

PerformanceAdbCommand

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

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

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

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

החזרות
`String`	את ה-stdout מהפקודה. `null` אם הפעלת הפקודה נכשלה.

קליעות
`DeviceNotAvailableException`

PerformanceAdbCommand

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

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

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

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

החזרות
`String`	את ה-stdout מהפקודה. `null` אם הפעלת הפקודה נכשלה.

קליעות
`DeviceNotAvailableException`

PerformanceAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

החזרות
`String`	את ה-stdout מהפקודה. `null` אם הפעלת הפקודה נכשלה.

קליעות
`DeviceNotAvailableException`

הפעלה מהירה אתחול פקודה

public CommandResult executeFastbootCommand (String... cmdArgs)

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

אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).

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

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

קליעות
`DeviceNotAvailableException`

הפעלה מהירה אתחול פקודה

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

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

אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).

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

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

קליעות
`DeviceNotAvailableException`

הפעלת לונגבאתחול מהיר

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

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

קליעות
`DeviceNotAvailableException`

הפעלת לונגבאתחול מהיר

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

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

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

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

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

קליעות
`DeviceNotAvailableException`

ביצועShellCommand

public String executeShellCommand (String command)

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

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

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

קליעות
`DeviceNotAvailableException`

ביצועShellCommand

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

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

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

קליעות
`DeviceNotAvailableException`

ביצועShellCommand

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

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

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

קליעות
`DeviceNotAvailableException`

ביצועShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

קליעות
`DeviceNotAvailableException`

offsetShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

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

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

קליעות
`DeviceNotAvailableException`

offsetShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

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

קליעות
`DeviceNotAvailableException`

offsetShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

קליעות
`DeviceNotAvailableException`

offsetShellV2Command

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

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

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

החזרות
`CommandResult`

קליעות
`DeviceNotAvailableException`

offsetShellV2Command

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

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

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

החזרות
`CommandResult`

קליעות
`DeviceNotAvailableException`

offsetShellV2Command

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

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

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

החזרות
`CommandResult`

קליעות
`DeviceNotAvailableException`

offsetShellV2Command

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

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

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

החזרות
`CommandResult`

קליעות
`DeviceNotAvailableException`

מחיצה לאתחול מהיר (fastbootWipePartition)

public CommandResult fastbootWipePartition (String partition)

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

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

אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).

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

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

קליעות
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

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

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

קליעות
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

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

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

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

קליעות
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

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

החזרות
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

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

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

החזרות
`String`

קליעות
`DeviceNotAvailableException`

מזהי getAndroidId

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`

גרסת getBaseband

public String getBasebandVersion ()

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

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

קליעות
`DeviceNotAvailableException`

הורדת הסוללה

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`

getBootHistoryHistory

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

קליעות
`DeviceNotAvailableException`

גרסה getBootloaderVersion

public String getBootloaderVersion ()

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

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

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

קליעות
`DeviceNotAvailableException`

דוח getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

נתמכת רק ב-'adb version' > 1.0.36

החזרות
`InputStreamSource`	`InputStreamSource` של קובץ ה-ZIP שמכיל את דוח הבאג, החזרת הערך null במקרה של כשל.

getBuildAlias

public String getBuildAlias ()

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

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

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

קליעות
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

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

החזרות
`String`	טעם ה-build או אפס אם לא ניתן לאחזר אותו

קליעות
`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`	את התאריך של המכשיר בפורמט תקופה של זמן מערכת.

קליעות
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

החזרות
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

החזרות
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

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

החזרות
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

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

פרמטרים
`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 ()

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

החזרות
`String`

getFastbootProductType

public String getFastbootProductType ()

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

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

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

קליעות
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

קליעות
`DeviceNotAvailableException`

getFastbootSeriesNumber

public String getFastbootSerialNumber ()

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

החזרות
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

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

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

החזרות
`String`	ערך הנכס או `null` אם הוא לא קיים

קליעות
`DeviceNotAvailableException`

גרסת getFastbootVersion

public String getFastbootVersion ()

מחזירה את מחרוזת הגרסה של הקובץ הבינארי של אתחול מהיר שבו נעשה שימוש. השדה הזה יכול גם להיות 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: ארגון מחדש של מערכת FileEntry כך שהיא תהיה זמינה מכל נתיב. (גם לא ברמה הבסיסית)

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

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`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 ()

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

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

קליעות
`DeviceNotAvailableException`

getLastExpectedDefaultTimeMillis

public long getLastExpectedRebootTimeMillis ()

הפונקציה מחזירה את הפעם האחרונה שבה ממשקי API של Tradeified הפעילו הפעלה מחדש באלפיות השנייה, מאז 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 ברקע

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

החזרות
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

תופס זרם של תמונת מצב של maxBytes נתוני ה-Logcat שתועדו.

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

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

החזרות
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

אחזור של קובץ ה-Dump של ה-Logcat הנוכחי במכשיר. בניגוד ל-getLogcat(), השיטה הזו תמיד תחזיר תמונת מצב סטטית של ה-Logcat.

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

החזרות
`InputStreamSource`	`InputStreamSource` של נתוני ה-Logcat. אם הנתונים של Logcat לא ייקלטו, מוחזר זרם ריק.

getLogcatAfter

public InputStreamSource getLogcatSince (long date)

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

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

החזרות
`InputStreamSource`

getMacAddress

public String getMacAddress ()

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

החזרות
`String`

getMainUserId

public Integer getMainUserId ()

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

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

קליעות
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

קליעות
`DeviceNotAvailableException`

getMaxNumberOf runningUsersSupported

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 לא זמין.

TODO: העברת ההתנהגות הזו אל IDevice#getMountPoint(String)

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

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

קליעות
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

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

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

קליעות
`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)

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

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

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

קליעות
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

מחזירה את ה-pid של השירות או את הערך null אם משהו השתבש.

פרמטרים
`process`	`String`: מחרוזת שם הפרויקט (proces).

החזרות
`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`	מצב השחזור הנוכחי שמשמש את המכשיר.

קבלת צילום מסך

public InputStreamSource getScreenshot (String format)

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

פרמטרים
`format`	`String`: קובץ PNG נתמך, JPEG

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

קליעות
`DeviceNotAvailableException`

קבלת צילום מסך

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

קליעות
`DeviceNotAvailableException`

קבלת צילום מסך

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

קליעות
`DeviceNotAvailableException`

קבלת צילום מסך

public InputStreamSource getScreenshot ()

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

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

קליעות
`DeviceNotAvailableException`

getSeriesNumber

public String getSerialNumber ()

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

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

הגדרה

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

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

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

החזרות
`String`	הערך שמשויך למפתח namespace:של משתמש. המערכת תציג ערך של null אם לא ניתן למצוא אותו.

קליעות
`DeviceNotAvailableException`

הגדרה

public String getSetting (String namespace, 
                String key)

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

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

החזרות
`String`

קליעות
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

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

החזרות
`String`

getSimState

public String getSimState ()

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

החזרות
`String`

getTombstones

public  getTombstones ()

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

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

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

קליעות
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

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

החזרות
`long`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

קליעות
`DeviceNotAvailableException`

getUseFastbootdelete

public boolean getUseFastbootErase ()

בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר.

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

getUserflags

public int getUserFlags (int userId)

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

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

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

קליעות
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

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

החזרות
	את הרשימה של UserInfo.

קליעות
`DeviceNotAvailableException`

getUserSeriesNumber

public int getUserSerialNumber (int userId)

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

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

החזרות
`int`

קליעות
`DeviceNotAvailableException`

headAllocationEvent

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`

חבילת התקנה

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`

חבילת התקנה

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`

התקנהPackageForUser

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`

התקנהPackageForUser

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`

inOAuthPropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

החזרות
`boolean`

isAppEnumeration נתמך

public boolean isAppEnumerationSupported ()

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

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

קליעות
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

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

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

קליעות
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

בודקים אם רכיבי ניפוי הבאגים טענו.

החזרות
`boolean`	`true` אם רכיבי ניפוי הבאגים נטענים

קליעות
`DeviceNotAvailableException`

isDeviceEncrypt

public boolean isDeviceEncrypted ()

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

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

קליעות
`DeviceNotAvailableException`

הוא ספרייה

public boolean isDirectory (String path)

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

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

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

isEncryptionsupported

public boolean isEncryptionSupported ()

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

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

קליעות
`DeviceNotAvailableException`

ניתן להפעלה

public boolean isExecutable (String fullPath)

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

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

הפרמטר isFastbootEnabled

public boolean isFastbootEnabled ()

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

החזרות
`boolean`

ללא GUI

public boolean isHeadless ()

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

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

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

קליעות
`DeviceNotAvailableException`

isPackageInstalled (בהתקנה)

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

קליעות
`DeviceNotAvailableException`

isPackageInstalled (בהתקנה)

public boolean isPackageInstalled (String packageName)

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

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

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

קליעות
`DeviceNotAvailableException`

נתמך

public boolean isRuntimePermissionSupported ()

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

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

קליעות
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

החזרות
`boolean`

isUserRun

public boolean isUserRunning (int userId)

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

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

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

קליעות
`DeviceNotAvailableException`

isUsersecondary

public boolean isUserSecondary (int userId)

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

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

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

קליעות
`DeviceNotAvailableException`

isUserצפי

public boolean isUserVisible (int userId)

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

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

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

isUserVisibilityOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

isdisplayBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

is visibilityBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

תואם ל-Wi-Fi

public boolean isWifiEnabled ()

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

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

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

קליעות
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

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

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

קליעות
`DeviceNotAvailableException`

listDisplayIdsForSTART visibleBackgroundUsers

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().

טעינת ניפוי באגים

public void mountDebugfs ()

טעינת ניפוי באגים.

קליעות
`DeviceNotAvailableException`

ללא חסימה מחדש

public void nonBlockingReboot ()

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

קליעות
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

postAdbUnrootAction

public void postAdbUnrootAction ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

הגדרת PostBoot

public void postBootSetup ()

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

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

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

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

קליעות
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

הגדרת הפעלה מראש

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`

הפעלה מחדש של IntoBootloader

public void rebootIntoBootloader ()

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

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

קליעות
`DeviceNotAvailableException`

הפעלה מחדש שלIntoFastbootd

public void rebootIntoFastbootd ()

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

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

קליעות
`DeviceNotAvailableException`

הפעלה מחדש של התאוששות מאסון

public void rebootIntoRecovery ()

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

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

קליעות
`DeviceNotAvailableException`

הפעלה מחדש של IntoSideload

public void rebootIntoSideload ()

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

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

קליעות
`DeviceNotAvailableException`

הפעלה מחדש של IntoSideload

public void rebootIntoSideload (boolean autoReboot)

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

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

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

קליעות
`DeviceNotAvailableException`

הפעלה מחדש עדאונליין

public void rebootUntilOnline ()

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

קליעות
`DeviceNotAvailableException`

הפעלה מחדש עדאונליין

public void rebootUntilOnline (String reason)

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

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

קליעות
`DeviceNotAvailableException`

substituteUserspace

public void rebootUserspace ()

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

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

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

קליעות
`DeviceNotAvailableException`

מחדשים UserspaceBeforeOnline

public void rebootUserspaceUntilOnline ()

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

קליעות
`DeviceNotAvailableException`

שחזור מכשיר

public boolean recoverDevice ()

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

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

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

רישוםDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

reloadSystemReadOnly

public void remountSystemReadOnly ()

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

קליעות
`DeviceNotAvailableException`

ל-reloadSystemWritable

public void remountSystemWritable ()

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

קליעות
`DeviceNotAvailableException`

טעינה מחדש של ספק קריאה בלבד

public void remountVendorReadOnly ()

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

קליעות
`DeviceNotAvailableException`

ספק טעינה מחדש

public void remountVendorWritable ()

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

קליעות
`DeviceNotAvailableException`

הסרת אדמין

public boolean removeAdmin (String componentName, 
                int userId)

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

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

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

קליעות
`DeviceNotAvailableException`

הסרת בעלים

public void removeOwners ()

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

קליעות
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

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

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

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

קליעות
`DeviceNotAvailableException`

איפוסContentProviderSetup

public void resetContentProviderSetup ()

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

בדיקות runInstrumentationTest

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

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

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

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

קליעות
`DeviceNotAvailableException`

בדיקות runInstrumentationTest

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

החזרות
`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`

הגדרה

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`: אם התכונה 'אתחול מהיר' זמינה למכשיר או לא

setFastbootPath

public void setFastbootPath (String fastbootPath)

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

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

setIDevice

public void setIDevice (IDevice newDevice)

עדכון ה-IDevice המשויך ל-ITestDevice הזה.

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

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

setLogStartDelay

public void setLogStartDelay (int delay)

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

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

setOptions

public void setOptions (TestDeviceOptions options)

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

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

setProperty

public boolean setProperty (String propKey, 
                String propValue)

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

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

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

קליעות
`DeviceNotAvailableException`

הגדרה לשחזור

public void setRecovery (IDeviceRecovery recovery)

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

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

הגדרה לשחזור מצב

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

הגדרה

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

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

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

קליעות
`DeviceNotAvailableException`

הגדרה

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`

setUseFastbootdelete

public void setUseFastbootErase (boolean useFastbootErase)

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

פרמטרים
`useFastbootErase`	`boolean`: `true` אם צריך להשתמש במחיקה של אתחול מהיר (fastboot), או `false` אם יש להשתמש בפורמט אתחול מהיר (fastboot).

startLogcat

public void startLogcat ()

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

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

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

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

startUser

public boolean startUser (int userId)

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

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

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

קליעות
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

קליעות
`DeviceNotAvailableException`

start visibilityBackgroundUser

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

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

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

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

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

קליעות
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

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

stopLogcat

public void stopLogcat ()

הפסקת התיעוד של פלט ה-Logcat מהמכשיר ומחיקת נתוני ה-Logcat שנשמרו.

לא תהיה לכך השפעה אם לא יתועד פלט Logcat.

stopUser

public boolean stopUser (int userId)

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

פרמטרים
`userId`	`int`: מהמשתמש כדי להפסיק.

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

קליעות
`DeviceNotAvailableException`

stopUser

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

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

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

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

קליעות
`DeviceNotAvailableException`

מעבר ל-AdbTcp

public String switchToAdbTcp ()

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

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

קליעות
`DeviceNotAvailableException`

מעבר ל-AdbUsb

public boolean switchToAdbUsb ()

העברת המכשיר למצב adb על גבי USB.

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

קליעות
`DeviceNotAvailableException`

מתג משתמש

public boolean switchUser (int userId)

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

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

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

קליעות
`DeviceNotAvailableException`

מתג משתמש

public boolean switchUser (int userId, 
                long timeout)

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

פרמטרים
`userId`	`int`
`timeout`	`long`: להמתין לפני החזרת FALSE למשתמש-החלפה נכשלה.

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

קליעות
`DeviceNotAvailableException`

SyncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

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

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

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

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

קליעות
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

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

החזרות
`Bugreport`

הסרת החבילה

public String uninstallPackage (String packageName)

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

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

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

קליעות
`DeviceNotAvailableException`

removePackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

פרמטרים
`packageName`	`String`: חבילת Android שיש להסיר
`userId`	`int`: מספר המשתמש השלם שרוצים להסיר.

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

קליעות
`DeviceNotAvailableException`

ביטול נעילת המכשיר

public boolean unlockDevice ()

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

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

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

קליעות
`DeviceNotAvailableException`

ניתוק ניפוי באגים

public void unmountDebugfs ()

ניתוק של ניפוי באגים.

קליעות
`DeviceNotAvailableException`

pendingForBootcomplete

public boolean waitForBootComplete (long timeOut)

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

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

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

קליעות
`DeviceNotAvailableException`

pendingForDeviceAvailable

public boolean waitForDeviceAvailable ()

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

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

קליעות
`DeviceNotAvailableException`

pendingForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

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

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

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

קליעות
`DeviceNotAvailableException`

ListenForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

קליעות
`DeviceNotAvailableException`

startForDeviceBootloader

public void waitForDeviceBootloader ()

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

קליעות
`DeviceNotAvailableException`

WaitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

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

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

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

ListenForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

חסימה כדי שהמכשיר יהיה במצב 'adb offload'

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

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

startForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

להמתיןForDeviceOnline

public void waitForDeviceOnline ()

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

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

קליעות
`DeviceNotAvailableException`

להמתיןForDeviceOnline

public void waitForDeviceOnline (long waitTime)

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

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

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

קליעות
`DeviceNotAvailableException`

startForDeviceShell

public boolean waitForDeviceShell (long waitTime)

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

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

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

שיטות מוגנות

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

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

buildAdbShellCommand

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

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

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

החזרות
`String[]`

CheckApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

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

createInitialDeviceAction

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

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

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

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

createRunUtil

protected IRunUtil createRunUtil ()

החזרות
`IRunUtil`

doAdbאתחול

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

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

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

להבטיח RuntimePermissionssupported

protected void ensureRuntimePermissionSupported ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

getApiLevelSafe

protected int getApiLevelSafe ()

החזרות
`int`

getLogger

protected ITestLogger getLogger ()

החזרות
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

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

החזרות
`IRunUtil`

אתחול חיבור

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

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

קליעות
`DeviceNotAvailableException`
`TargetSetupError`

InternalGetProperty

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

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

פרמטרים
`propName`	`String`: השם של מאפיין המכשיר כפי שהוחזר על ידי 'adb Shell getpro'
`fastbootVar`	`String`: השם של משתנה אתחול מהיר (fastboot) המקביל לשאילתה. אם `null` לא יתבצע ניסיון אתחול מהיר (fastboot)
`description`	`String`: תיאור פשוט של המשתנה. האות הראשונה צריכה להיות אותיות רישיות.

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

קליעות
`DeviceNotAvailableException`

הפעלה מחדש של קריאה חוזרת

protected boolean isInRebootCallback ()

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

החזרות
`boolean`

חדש יותר

protected boolean isNewer (File localFile, 
                IFileEntry entry)

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

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

החזרות
`boolean`

ההודעה להפעלה מחדש הסתיימה

protected void notifyRebootEnded ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

ההודעה הופעלה מחדש

protected void notifyRebootStarted ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

ביצוע פעולה

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

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

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

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

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

לאחר ההפעלה מחדש

protected void postAdbReboot ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

הגדרת טרום-PostBoot

protected void prePostBootSetup ()

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

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

pullFile פנימי

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

הגדרת השעון

protected void setClock (Clock clock)

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

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

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

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

פרמטרים
`process`	`Process`: תהליך ה-VM של ה-Microdroid.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

פרמטרים
`deviceOptions`

אתחול מהיר פשוט

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

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

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

החזרות
`CommandResult`

אתחול מהיר פשוט

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

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

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

החזרות
`CommandResult`

startForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

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

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

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

NativeDevice

סיכום

מחלקות מקוננות

קבועים

שדות

בנאים ציבוריים

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

שיטות מוגנות

קבועים

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

שדות

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

אפשרויות MOptions

mStateMonitor

בנאים ציבוריים

NativeDevice

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

אצווהPrefetchStartupBuildProps

CanSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

בדיקת קישוריות

cleanErrorDialogs

cleanLastConnectedWi-FiNetwork

ניקוי הרישום ביומן

ConnectToWi-FiNetwork

ConnectToWi-FiNetwork

ConnectToWi-FiNetwork

ConnectToWi-FiNetwork

ConnectToWi-FiNetworkIf Needed

ConnectToWi-FiNetworkIf Needed

CreateUser

CreateUser

CreateUser

createUserNoThrow

DeleteFile

DeleteFile

ביטול הרישוםDeviceActionReceiver

המכשיר הופעל מחדש

מכשירSoftאתחול מאז

השבתתAdbRoot

השבתה של KeyGuard

השבתת NetworkMonitor

התנתקות מ-Wi-Fi

DoFileExist

DoFileExist

עריסות

הפעלתAdbRoot

הפעלת NetworkMonitor

PerformanceAdbCommand

PerformanceAdbCommand

PerformanceAdbCommand

הפעלה מהירה אתחול פקודה

הפעלה מהירה אתחול פקודה

הפעלת לונגבאתחול מהיר

הפעלת לונגבאתחול מהיר

ביצועShellCommand

ביצועShellCommand

ביצועShellCommand

ביצועShellCommand

offsetShellV2Command

offsetShellV2Command

offsetShellV2Command

offsetShellV2Command

offsetShellV2Command

offsetShellV2Command

offsetShellV2Command

מחיצה לאתחול מהיר (fastbootWipePartition)

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

מזהי getAndroidId

getApiLevel"

getAppPackageInfo

getAppPackageInfos

גרסת getBaseband