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

iNativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

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

IManagedTestDevice, ITestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, remoteAndroidDevice, AndroidVirtualDevice, TestDevice

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

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

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

סיכום

קבועים
`int`	`UNKNOWN_API_LEVEL` ערך ברירת המחדל כשלא ניתן לזהות את רמת ה-API

שיטות ציבוריות
`abstract boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` לבדוק אם תכונה מסוימת נתמכת כרגע בהינתן רמה מינימלית של תמיכה.
`abstract void`	`clearLogcat()` מחיקת כל נתוני ה-Logcat שהצטברו.
`abstract void`	`deleteFile(String deviceFilePath)` שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
`abstract void`	`deleteFile(String deviceFilePath, int userId)` שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
`abstract boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` שיטה מסייעת לבדוק אם המכשיר הופעל מחדש ברכה על ידי השוואה בין השרת system_server הנוכחי השרת הקודם של system_server `ProcessInfo`.
`abstract boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` שיטה שעוזרת לבדוק אם המכשיר הופעל מחדש החל משעה UTC מאז תחילת התקופה של זמן מערכת במכשיר `ERROR(/TimeUnit)` שלו.
`abstract boolean`	`disableAdbRoot()` משבית את שורש adb.
`abstract boolean`	`doesFileExist(String deviceFilePath)` שיטה עוזרת לקבוע אם קובץ קיים במכשיר.
`abstract boolean`	`enableAdbRoot()` הפעלת השורש של adb.
`abstract String`	`executeAdbCommand(long timeout, String... commandArgs)` שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
`abstract String`	`executeAdbCommand(String... commandArgs)` שיטת עזרה שמבצעת פקודת adb כפקודת מערכת.
`abstract String`	`executeAdbCommand(long timeout, envMap, String... commandArgs)` שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
`abstract CommandResult`	`executeFastbootCommand(long timeout, String... commandArgs)` שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת.
`abstract CommandResult`	`executeFastbootCommand(String... commandArgs)` שיטת עזרה שמפעילה פקודת אתחול מהיר כפקודת מערכת, עם זמן קצוב לתפוגה שמוגדר כברירת מחדל 2 דקות.
`abstract CommandResult`	`executeLongFastbootCommand(String... commandArgs)` שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) כפקודת מערכת.
`abstract CommandResult`	`executeLongFastbootCommand( envVarMap, String... commandArgs)` שיטת עזרה המבצעת פקודת אתחול מהיר (Fastboot) שרצה במשך זמן רב כפקודת מערכת עם מערכת במשתני סביבה.
`abstract String`	`executeShellCommand(String command)` שיטת עזרה שמפעילה פקודת מעטפת מסוג adb ומחזירה את הפלט בתור `String`.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` מפעיל את פקודת המעטפת הנתונה של adb, ומנסה שוב מספר פעמים אם הפקודה נכשלת.
`abstract CommandResult`	`executeShellV2Command(String command)` שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור `CommandResult`, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
`abstract CommandResult`	`executeShellV2Command(String command, OutputStream pipeToOutput)` שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור `CommandResult`, שמאוכלס כראוי בפלט סטטוס הפקודה וב-stderr.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput)` שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור `CommandResult`, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
`abstract CommandResult`	`fastbootWipePartition(String partition)` שיטה לעזרה באיפוס המחיצה של המכשיר.
`abstract int`	`getApiLevel()` מאתרים את רמת ה-API של המכשיר.
`abstract String`	`getBasebandVersion()` שיטת הנוחות לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה.
`abstract Integer`	`getBattery()` מחזירה את רמת הטעינה הנוכחית של הסוללה של מכשיר או את הערך Null אם רמת הסוללה לא זמינה.
`abstract boolean`	`getBooleanProperty(String name, boolean defaultValue)` מחזירה ערך בוליאני של המאפיין הנתון.
`abstract`	`getBootHistory()` תכונת העזרה אוספת את המפה של היסטוריית האתחול עם זמן האתחול וסיבת האתחול.
`abstract`	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` שיטת העזרה אוספת את מפת היסטוריית האתחול עם זמן האתחול וסיבת האתחול, כי הזמן שעבר מאז epoch מהמכשיר ומיחידת הזמן שצוינה.
`abstract String`	`getBootloaderVersion()` שיטת נוחות לקבלת גרסת תוכנת האתחול של המכשיר הזה.
`abstract String`	`getBuildAlias()` מאחזרים את הכינוי של ה-build שהמכשיר פועל כרגע.
`abstract String`	`getBuildFlavor()` מאחזרים את גרסת ה-build של המכשיר.
`abstract String`	`getBuildId()` מאחזרים את גרסת ה-build שהמכשיר פועל כרגע.
`abstract String`	`getBuildSigningKeys()` פונקציה זו מחזירה את סוג המפתח המשמש לחתימה על תמונת המכשיר בדרך כלל מכשירי Android נחתמים באמצעות מפתחות בדיקה (כמו ב-AOSP) או באמצעות מפתחות הפצה (נשלטת על ידי יצרני מכשירים נפרדים)
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor()` הפונקציה מחזירה ערך `DeviceDescriptor` שנשמר במטמון אם המכשיר מוקצה, אחרת מחזירה את הערך `DeviceDescriptor` הנוכחי.
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` הפונקציה מחזירה ערך `DeviceDescriptor` שנשמר במטמון אם המכשיר מוקצה, אחרת מחזירה את הערך `DeviceDescriptor` הנוכחי.
`abstract String[]`	`getChildren(String deviceFilePath)` לחלופין, אפשר להשתמש ב-`IFileEntry` שלא עובד לפעמים בגלל הרשאות.
`abstract AbstractConnection`	`getConnection()` הפונקציה מחזירה את החיבור שמשויך למכשיר.
`abstract String`	`getDeviceClass()` מקבלים את סיווג המכשיר.
`abstract long`	`getDeviceDate()` החזרת התאריך של המכשיר באלפיות השנייה מאז נקודת ההתחלה.
`abstract DeviceDescriptor`	`getDeviceDescriptor()` החזרת `DeviceDescriptor` מהמידע במכשיר כדי לקבל מידע עליו בלי שמעבירים את האובייקט של המכשיר בפועל.
`abstract DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` החזרת `DeviceDescriptor` מהמידע במכשיר כדי לקבל מידע עליו בלי שמעבירים את האובייקט של המכשיר בפועל.
`abstract TestDeviceState`	`getDeviceState()` מאתרים את מצב המכשיר.
`abstract long`	`getDeviceTimeOffset(Date date)` עוזר לקבל את הפרש הזמנים בין המכשיר לבין `ERROR(/Date)` נתון.
`abstract InputStreamSource`	`getEmulatorOutput()` מקבלים את הסטרימינג של האמולטור stdout ו-stderr
`abstract long`	`getExternalStoreFreeSpace()` שיטה שעוזרת לקבוע את נפח האחסון הפנוי באחסון החיצוני של המכשיר.
`abstract String`	`getFastbootProductType()` שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
`abstract String`	`getFastbootProductVariant()` שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
`abstract String`	`getFastbootSerialNumber()` מחזירה את המספר הסידורי של מצב אתחול מהיר (fastboot).
`abstract String`	`getFastbootVariable(String variableName)` מאחזרים את הערך הנתון של משתנה אתחול מהיר מהמכשיר.
`abstract IFileEntry`	`getFileEntry(String path)` אחזור קובץ עזר לקובץ מרוחק במכשיר.
`abstract IDevice`	`getIDevice()` הפונקציה מחזירה הפניה ל-ddmlib `IDevice` המשויך.
`abstract long`	`getIntProperty(String name, long defaultValue)` מחזירה ערך מספר שלם של המאפיין הנתון מהמכשיר.
`abstract long`	`getLastExpectedRebootTimeMillis()` פונקציה זו מחזירה את הפעם האחרונה שבה ממשקי API של Tradeified הפעילו הפעלה מחדש באלפיות השנייה מאז EPOCH בתור הוחזרו על ידי `System.currentTimeMillis()`.
`abstract int`	`getLaunchApiLevel()` מקבלים את רמת ה-API הראשונה שהושקה במכשיר.
`abstract InputStreamSource`	`getLogcat()` תופסת רצף snapshot של נתוני ה-Logcat.
`abstract InputStreamSource`	`getLogcat(int maxBytes)` תופס זרם של תמונת מצב של `maxBytes` נתוני ה-Logcat שתועדו.
`abstract InputStreamSource`	`getLogcatDump()` אחזור של קובץ ה-Dump של ה-Logcat הנוכחי במכשיר.
`abstract InputStreamSource`	`getLogcatSince(long date)` יוצר זרם snapshot של נתוני Logcat שתועדו החל מהתאריך שצוין.
`abstract String`	`getMountPoint(String mountName)` מחזירה נקודת טעינה.
`abstract ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` הפונקציה מחזירה `MountPointInfo` שתואם לנתיב נקודת הטעינה שצוין, או `null` אם לא נטען דבר בנתיב הזה או שהוא לא מופיע /proc/Loads כנקודת טעינה.
`abstract`	`getMountPointInfo()` החזרת גרסה מנותחת של המידע ב- /proc/Loads במכשיר
`abstract long`	`getPartitionFreeSpace(String partition)` שיטה שעוזרת לקבוע את נפח האחסון הפנוי במחיצה במכשיר.
`abstract ProcessInfo`	`getProcessByName(String processName)` שיטת העזרה מפעילה את ה-"pidof" ו-stat הפקודה ומחזירה את האובייקט `ProcessInfo` עם PID ושעת ההתחלה של התהליך של התהליך הנתון.
`abstract String`	`getProcessPid(String process)` מחזירה את ה-pid של השירות או את הערך null אם משהו השתבש.
`abstract String`	`getProductType()` שיטת נוחות לקבלת סוג המוצר של המכשיר הזה.
`abstract String`	`getProductVariant()` שיטת נוחות לקבלת וריאציית המוצר של המכשיר הזה.
`abstract String`	`getProperty(String name)` מאחזרים את ערך המאפיין הנתון מהמכשיר.
`abstract ITestDevice.RecoveryMode`	`getRecoveryMode()` משתמשים במצב השחזור הנוכחי של המכשיר.
`abstract String`	`getSerialNumber()` שיטת נוחות לקבלת המספר הסידורי של המכשיר הזה.
`abstract`	`getTombstones()` מאחזרים את רשימת המצבות ומחזירים אותה מהמכשירים.
`abstract long`	`getTotalMemory()` פונקציה זו מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים או -1 במקרה של שגיאה פנימית
`default String`	`getTrackingSerial()` למטרות ניהול מכשירים, מקבלים את המספר הסידורי שמשמש למעקב אחרי המכשיר.
`abstract boolean`	`getUseFastbootErase()` בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר.
`abstract boolean`	`isAdbRoot()`
`abstract boolean`	`isAdbTcp()`
`abstract boolean`	`isAppEnumerationSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
`abstract boolean`	`isBypassLowTargetSdkBlockSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בעקיפה של חסימת SDK עם יעדים נמוכים בהתקנות של אפליקציות
`abstract boolean`	`isDebugfsMounted()` בודקים אם רכיבי ניפוי הבאגים טענו.
`abstract boolean`	`isDeviceEncrypted()` הפונקציה מחזירה אם המכשיר מוצפן.
`abstract boolean`	`isDirectory(String deviceFilePath)` פונקציה זו מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה. אחרת, הערך false.
`abstract boolean`	`isEncryptionSupported()` הפונקציה מחזירה אם המכשיר תומך בהצפנה.
`abstract boolean`	`isExecutable(String fullPath)` הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ להפעלה. אחרת, False.
`abstract boolean`	`isHeadless()` פונקציה זו מחזירה את הערך true אם המכשיר ללא GUI (ללא מסך). אחרת, הערך false.
`abstract boolean`	`isRuntimePermissionSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בהענקת הרשאות בתחילת ההפעלה
`abstract boolean`	`isStateBootloaderOrFastbootd()` הפונקציה מחזירה את הערך True אם המכשיר נמצא ב-`TestDeviceState#FASTBOOT` או ב-`TestDeviceState.FASTBOOTD`.
`abstract boolean`	`logAnrs(ITestLogger logger)` איסוף ורישום של מקרי ANR מהמכשיר.
`abstract void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` רישום הודעה ב-Logcat של המכשיר.
`abstract void`	`mountDebugfs()` טעינת ניפוי באגים.
`abstract void`	`nonBlockingReboot()` יוצר פקודה להפעלה מחדש של המכשיר וחוזרת אחרי שהפקודה הושלמה כשהמכשיר לא מחובר גלוי יותר ל-adb.
`abstract void`	`postBootSetup()` יש לפעול לפי ההוראות להגדרת המכשיר כדי לבדוק אותו לאחר כל הפעלה.
`default void`	`postInvocationTearDown()` השיטה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-`postInvocationTearDown(Throwable)`.
`abstract void`	`postInvocationTearDown(Throwable invocationException)` שלבים נוספים לניקוי הנדרש הספציפי למכשיר, שיבוצעו לאחר ההפעלה הושלמה.
`default void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` שלבים נוספים להגדרה הנדרשת ספציפית למכשיר שיבוצעו במכשיר לפני את זרימת ההפעלה.
`abstract boolean`	`pullDir(String deviceFilePath, File localDir)` שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי.
`abstract boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי.
`abstract File`	`pullFile(String remoteFilePath, int userId)` אחזור קובץ מהמכשיר, מאחסן אותו בקובץ `ERROR(/File)` מקומי זמני ומחזיר אותו `File`.
`abstract File`	`pullFile(String remoteFilePath)` אחזור קובץ מהמכשיר, מאחסן אותו בקובץ `ERROR(/File)` מקומי זמני ומחזיר אותו `File`.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile)` אחזור קובץ מהמכשיר.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` אחזור קובץ מהמכשיר.
`abstract String`	`pullFileContents(String remoteFilePath)` אחזור קובץ מהמכשיר והחזרת התוכן שלו.
`abstract File`	`pullFileFromExternal(String remoteFilePath)` שיטת נוחות לאחזור קובץ מהאחסון החיצוני של המכשיר, ומאחסנת אותו `ERROR(/File)` מקומי זמני, ולהחזיר הפניה לאותו `File`.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, int userId)` דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, excludedDirectories)` דחיפת תוכן של ספריות באופן רקורסיבי למכשיר, ולא כולל ספריות מסוימות לאחר סינון.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath)` דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)` וריאנט של `pushFile(File, String)` שיכול גם להעריך את הצורך עבור ספק התוכן.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath)` דחיפת קובץ למכשיר.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, int userId)` דחיפת קובץ למכשיר.
`abstract boolean`	`pushString(String contents, String deviceFilePath)` דחיפת קובץ שנוצר ממחרוזת למכשיר
`abstract void`	`reboot()` הפעלת המכשיר מחדש במצב adb.
`abstract void`	`reboot(String reason)` הפעלת המכשיר מחדש למצב adb עם `reason` שניתן כדי באופן רציף במהלך ההפעלה מחדש.
`abstract void`	`rebootIntoBootloader()` הפעלת המכשיר מחדש במצב תוכנת אתחול.
`abstract void`	`rebootIntoFastbootd()` הפעלת המכשיר מחדש במצב אתחול מהיר (fastbootd).
`abstract void`	`rebootIntoRecovery()` הפעלת המכשיר מחדש במצב adbrecovery.
`abstract void`	`rebootIntoSideload(boolean autoReboot)` הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור) הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע
`abstract void`	`rebootIntoSideload()` הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור) הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע
`abstract void`	`rebootUntilOnline()` חלופה ל-`reboot()` שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
`abstract void`	`rebootUntilOnline(String reason)` חלופה ל-`reboot()` שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
`abstract void`	`rebootUserspace()` מופעלת מחדש רק חלק של מרחב המשתמשים במכשיר.
`abstract void`	`rebootUserspaceUntilOnline()` חלופה ל-`rebootUserspace()` ()} שחוסמת רק עד שהמכשיר יהיה אונליין, גלויים ל-adb.
`abstract void`	`remountSystemReadOnly()` להגדיר את מחיצת המערכת במכשיר לקריאה בלבד.
`abstract void`	`remountSystemWritable()` הגדרת מחיצת המערכת במכשיר לניתנת לכתיבה.
`abstract void`	`remountVendorReadOnly()` מגדירים את מחיצת הספק במכשיר לקריאה בלבד.
`abstract void`	`remountVendorWritable()` מגדירים את מחיצת הספק במכשיר לניתנת לכתיבה.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` שיטת נוחות לביצוע `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` עם אוזן אחד או יותר שמועבר כפרמטרים.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` מריץ בדיקות אינסטרומנטציה ומספק שחזור מכשיר.
`abstract 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))`, אבל מפעיל את הבדיקה עבור המשתמש הנתון.
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` דומה ל-`ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, אבל מריץ את הבדיקה עבור משתמש נתון.
`abstract void`	`setDate(Date date)` מגדיר את התאריך במכשיר הערה: הגדרת תאריך במכשיר מחייבת הרמה הבסיסית (root)
`abstract void`	`setOptions(TestDeviceOptions options)` הגדרת `TestDeviceOptions` של המכשיר
`abstract boolean`	`setProperty(String propKey, String propValue)` מגדיר את ערך המאפיין הנתון במכשיר.
`abstract void`	`setRecovery(IDeviceRecovery recovery)` הגדרת `IDeviceRecovery` לשימוש במכשיר הזה.
`abstract void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` הגדרת מצב השחזור הנוכחי לשימוש במכשיר.
`abstract void`	`setTrackingSerial(String trackingSerial)` למטרות ניהול מכשירים, עוקבים אחרי המספר הסידורי שבו אנחנו משתמשים כדי להתייחס למכשיר.
`abstract void`	`setUseFastbootErase(boolean useFastbootErase)` הגדרה אם להשתמש בפורמט מחיקה של אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי לאפס מחיצה במכשיר.
`abstract void`	`startLogcat()` התחלת הצילום של פלט Logcat מהמכשיר ברקע.
`abstract void`	`stopEmulatorOutput()` סוגרים את הפלט של האמולטור ומוחקים אותו.
`abstract void`	`stopLogcat()` הפסקת התיעוד של פלט ה-Logcat מהמכשיר ומחיקה של נתוני ה-Logcat שנשמרו.
`abstract String`	`switchToAdbTcp()` העברת המכשיר למצב adb-over-tcp.
`abstract boolean`	`switchToAdbUsb()` העברת המכשיר למצב adb על גבי USB.
`abstract boolean`	`syncFiles(File localFileDir, String deviceFilePath)` סנכרון מצטבר של התוכן של ספריית קבצים מקומית למכשיר.
`abstract boolean`	`unlockDevice()` ביטול נעילת המכשיר אם המכשיר במצב מוצפן.
`abstract void`	`unmountDebugfs()` ניתוק של ניפוי באגים.
`abstract boolean`	`waitForBootComplete(long timeOut)` הפעולה תיחסם עד שתגדירו את התכונה הניסיונית להשלמת ההפעלה של המכשיר.
`abstract boolean`	`waitForDeviceAvailable()` בהמתנה עד שהמכשיר יגיב וזמין לבדיקה.
`abstract boolean`	`waitForDeviceAvailable(long waitTime)` בהמתנה עד שהמכשיר יגיב וזמין לבדיקה.
`abstract boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` בהמתנה עד שהמכשיר יגיב וזמין בלי להביא בחשבון את נתיב השחזור.
`abstract void`	`waitForDeviceBootloader()` חסימה עד שאפשר לראות את המכשיר באמצעות אתחול מהיר (fastboot).
`abstract boolean`	`waitForDeviceInRecovery(long waitTime)` חסימה של גישת המכשיר ל'שחזור adb' (שימו לב ששונה מ- `IDeviceRecovery`).
`abstract boolean`	`waitForDeviceInSideload(long waitTime)` חסימה של שילוב המכשיר ב-'adb offload' הסמוי הסופי
`abstract boolean`	`waitForDeviceNotAvailable(long waitTime)` חסימות כדי שהמכשיר לא יהיה זמין, כלומר חסר ב-adb
`abstract void`	`waitForDeviceOnline()` חסימה עד שהמכשיר גלוי דרך adb.
`abstract void`	`waitForDeviceOnline(long waitTime)` חסימה עד שהמכשיר גלוי דרך adb.
`abstract boolean`	`waitForDeviceShell(long waitTime)` בהמתנה עד שהמכשיר יגיב לפקודת מעטפת בסיסית של adb.

קבועים

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

ערך ברירת המחדל כשלא ניתן לזהות את רמת ה-API

ערך קבוע: 1- (0xffff)

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

CheckApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

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

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

public abstract void clearLogcat ()

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

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

DeleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

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

DeleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

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

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

קליעות
`RuntimeException`	אם יש במכשיר סיבה להפעלה חריגה
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

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

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

קליעות
`RuntimeException`	אם יש במכשיר סיבה להפעלה חריגה
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
`DeviceNotAvailableException`

השבתת AdbRoot

public abstract boolean disableAdbRoot ()

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

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

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

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

DoFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

הפעלה של AdbRoot

public abstract boolean enableAdbRoot ()

הפעלת השורש של adb. אם האפשרות Enable-root (הפעלה) היא 'false', תתועד הודעה החזרה בלי להפעיל את הרמה הבסיסית (root).

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

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

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

PerformanceAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

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

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

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

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

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

PerformanceAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

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

PerformanceAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

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

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

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

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

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

startFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

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

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

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

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

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

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

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

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

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

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

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

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

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

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

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

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

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

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

ביצועShellCommand

public abstract String executeShellCommand (String command)

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

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

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

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

ביצועShellCommand

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

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

למידע נוסף:

ביצועShellCommand

public abstract 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 abstract 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 abstract CommandResult executeShellV2Command (String command)

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

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

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

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

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

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

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

offsetShellV2Command

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

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

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

החזרות
`CommandResult`

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

למידע נוסף:

offsetShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

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

החזרות
`CommandResult`

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

למידע נוסף:

offsetShellV2Command

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

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

פרמטרים
`command`	`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 abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

פרמטרים
`command`	`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 abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

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

getApiLevel"

public abstract int getApiLevel ()

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

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

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

גרסת getBaseband

public abstract String getBasebandVersion ()

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

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

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

הורדת הסוללה

public abstract Integer getBattery ()

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

החזרות
`Integer`

getBooleanProperty

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

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

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

קליעות
`DeviceNotAvailableException`

getBootHistoryHistory

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

קליעות
`DeviceNotAvailableException`

גרסה getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

החזרות
`DeviceDescriptor`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

החזרות
`DeviceDescriptor`

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

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

getConnection

public abstract AbstractConnection getConnection ()

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

החזרות
`AbstractConnection`

getDeviceClass

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

החזרות
`DeviceDescriptor`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

החזרות
`DeviceDescriptor`

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

החזרות
`TestDeviceState`

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

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

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

קליעות
`DeviceNotAvailableException`

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

מקבלים את הסטרימינג של האמולטור stdout ו-stderr

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

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

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

getFastbootSeriesNumber

public abstract String getFastbootSerialNumber ()

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

החזרות
`String`

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

קליעות
	supportedOperationError
`DeviceNotAvailableException`

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

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

getIDevice

public abstract IDevice getIDevice ()

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

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

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

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

קליעות
`DeviceNotAvailableException`

getLastExpectedDefaultTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

החזרות
`long`

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

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

getLogcat

public abstract InputStreamSource getLogcat ()

תופסת רצף snapshot של נתוני ה-Logcat.

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

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

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

החזרות
`InputStreamSource`

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

החזרות
`InputStreamSource`

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

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

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

getLogcatAfter

public abstract InputStreamSource getLogcatSince (long date)

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

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

החזרות
`InputStreamSource`

getMountPoint

public abstract String getMountPoint (String mountName)

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

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

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

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

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

למידע נוסף:

IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

קליעות
`DeviceNotAvailableException`

למידע נוסף:

getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

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

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

קליעות
`DeviceNotAvailableException`

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

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

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

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

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

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

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

קליעות
`DeviceNotAvailableException`

getProcessPid

public abstract String getProcessPid (String process)

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

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

החזרות
`String`

קליעות
`DeviceNotAvailableException`

getProductType

public abstract String getProductType ()

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

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

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

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

getProductVariant

public abstract String getProductVariant ()

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

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

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

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

getProperty

public abstract String getProperty (String name)

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

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

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

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

getrecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getSeriesNumber

public abstract String getSerialNumber ()

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

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

getTombstones

public abstract  getTombstones ()

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

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

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

קליעות
`DeviceNotAvailableException`

למידע נוסף:

מסמכי תיעוד של אתר קבורה

getTotalMemory

public abstract long getTotalMemory ()

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

החזרות
`long`

getTrackingENTER

public String getTrackingSerial ()

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

החזרות
`String`

getUseFastbootdelete

public abstract boolean getUseFastbootErase ()

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

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

למידע נוסף:

fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

החזרות
`boolean`	`true` אם המכשיר נמצא כרגע ברמה הבסיסית (root) של adb, אחרת `false`.

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

isAdbTcp

public abstract boolean isAdbTcp ()

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

isAppEnumeration נתמך

public abstract boolean isAppEnumerationSupported ()

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

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

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

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

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

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

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

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

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

isDeviceEncrypt

public abstract boolean isDeviceEncrypted ()

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

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

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

הוא ספרייה

public abstract boolean isDirectory (String deviceFilePath)

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

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

החזרות
`boolean`

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

isEncryptionsupported

public abstract boolean isEncryptionSupported ()

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

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

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

ניתן להפעלה

public abstract boolean isExecutable (String fullPath)

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

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

החזרות
`boolean`

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

ללא GUI

public abstract boolean isHeadless ()

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

נתמך

public abstract boolean isRuntimePermissionSupported ()

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

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

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

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

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

החזרות
`boolean`

LogAnrs

public abstract boolean logAnrs (ITestLogger logger)

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

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

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

קליעות
`DeviceNotAvailableException`

LogOnDevice

public abstract 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 abstract void mountDebugfs ()

טעינה של ניפוי באגים.

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

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

public abstract void nonBlockingReboot ()

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

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

הגדרת PostBoot

public abstract void postBootSetup ()

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

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

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

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

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

postInvocationTearDown

public void postInvocationTearDown ()

השיטה הזו הוצאה משימוש.
במקום זאת, אתם צריכים להשתמש ב-postInvocationTearDown(Throwable).

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

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

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

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

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

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

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

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

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

pullDir

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

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

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

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

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

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

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

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

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

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

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

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

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

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

pullFile

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

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

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

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

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

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

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

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

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

קליעות
`DeviceNotAvailableException`

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

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

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

PushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

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

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

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

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

PushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

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

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

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

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

PushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

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

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

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

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

קובץ PushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

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

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

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

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

קובץ PushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

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

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

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

קובץ PushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

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

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

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

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

PushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

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

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

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

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

להפעיל מחדש

public abstract void reboot ()

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

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

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

להפעיל מחדש

public abstract void reboot (String reason)

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

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

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

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

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

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

public abstract void rebootIntoBootloader ()

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

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

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

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

public abstract void rebootIntoFastbootd ()

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

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

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

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

public abstract void rebootIntoRecovery ()

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

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

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

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

public abstract void rebootIntoSideload (boolean autoReboot)

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

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

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

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

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

public abstract void rebootIntoSideload ()

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

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

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

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

public abstract void rebootUntilOnline ()

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

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

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

public abstract void rebootUntilOnline (String reason)

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

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

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

למידע נוסף:

reboot(String)

substituteUserspace

public abstract void rebootUserspace ()

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

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

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

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

substituteUserspaceBeforeOnline

public abstract void rebootUserspaceUntilOnline ()

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

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

reloadSystemReadOnly

public abstract void remountSystemReadOnly ()

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

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

ל-reloadSystemWritable

public abstract void remountSystemWritable ()

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

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

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

public abstract void remountVendorReadOnly ()

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

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

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

public abstract void remountVendorWritable ()

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

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

בדיקות runInstrumentationTest

public abstract 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 abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

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

runInstrumentationTestsAsUser

public abstract 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 abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

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

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

החזרות
`boolean`

קליעות
`DeviceNotAvailableException`

setDate (תאריך הגדרה)

public abstract void setDate (Date date)

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

הערה: הגדרת תאריך במכשיר מחייבת הרמה הבסיסית (root)

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

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

setOptions

public abstract void setOptions (TestDeviceOptions options)

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

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

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

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

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

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

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

הגדרה לשחזור

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

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

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setTrackingENTER

public abstract void setTrackingSerial (String trackingSerial)

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

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

setUseFastbootdelete

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

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

למידע נוסף:

fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

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

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

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

stopLogcat

public abstract void stopLogcat ()

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

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

מעבר ל-AdbTcp

public abstract String switchToAdbTcp ()

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

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

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

מעבר ל-AdbUsb

public abstract boolean switchToAdbUsb ()

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

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

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

SyncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

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

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

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

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

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

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

public abstract boolean unlockDevice ()

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

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

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

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

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

public abstract void unmountDebugfs ()

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

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

pendingForBootcomplete

public abstract boolean waitForBootComplete (long timeOut)

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

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

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

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

pendingForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

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

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

pendingForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

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

ListenForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

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

startForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

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

WaitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

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

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

ListenForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

חסימה של שילוב המכשיר ב-'adb offload' הסמוי הסופי

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

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

startForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

להמתיןForDeviceOnline

public abstract void waitForDeviceOnline ()

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

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

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

להמתיןForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

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

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

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

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

startForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

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

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