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

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

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

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

‫IManagedTestDevice, ‏ ITestDevice, ‏ LocalAndroidVirtualDevice, ‏ ManagedRemoteDevice, ‏ NativeDevice, ‏ NestedRemoteDevice, ‏ RemoteAndroidDevice, ‏ RemoteAndroidVirtualDevice, ‏ TestDevice

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

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

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

סיכום

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

‫methods ציבוריים
`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 מאז התקופה מהמכשיר ומה-`TimeUnit` שלו.
`abstract boolean`	`disableAdbRoot()` השבתה של adb root.
`abstract boolean`	`doesFileExist(String deviceFilePath)` שיטת עזר לקביעה אם קובץ קיים במכשיר.
`abstract boolean`	`enableAdbRoot()` מפעיל את adb root.
`abstract String`	`executeAdbCommand(long timeout, String... commandArgs)` שיטת עזר שמריצה פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`abstract String`	`executeAdbCommand(String... commandArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת.
`abstract String`	`executeAdbCommand(long timeout, Map<String, String> envMap, String... commandArgs)` שיטת עזר שמריצה פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`abstract CommandResult`	`executeAdbV2Command(String... commandArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת.
`abstract CommandResult`	`executeAdbV2Command(long timeout, String... commandArgs)` שיטת עזר שמריצה פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`abstract CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> envMap, int retryAttempts, String... commandArgs)` שיטת עזר שמריצה פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`abstract CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> envMap, String... commandArgs)` שיטת עזר שמריצה פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`abstract CommandResult`	`executeFastbootCommand(long timeout, String... commandArgs)` שיטת עזר שמבצעת פקודת fastboot כפקודת מערכת.
`abstract CommandResult`	`executeFastbootCommand(String... commandArgs)` שיטת עזר שמריצה פקודת fastboot כפקודת מערכת עם זמן קצוב של 2 דקות כברירת מחדל.
`abstract CommandResult`	`executeLongFastbootCommand(String... commandArgs)` שיטת עזר שמבצעת פקודת fastboot ארוכה כפקודת מערכת.
`abstract CommandResult`	`executeLongFastbootCommand(Map<String, String> envVarMap, String... commandArgs)` שיטת עזר שמריצה פקודת fastboot ארוכה כפקודת מערכת עם משתני סביבה של המערכת.
`abstract String`	`executeShellCommand(String command)` שיטת עזר שמריצה פקודת adb shell ומחזירה פלט כ-`String`.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` מריץ את הפקודה הנתונה של adb shell, ומנסה שוב כמה פעמים אם הפקודה נכשלת.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`abstract CommandResult`	`executeShellV2Command(String command)` שיטת עזר שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput)` שיטת עזר שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`abstract CommandResult`	`executeShellV2Command(String command, OutputStream pipeToOutput)` שיטת עזר שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה וב-stderr.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריץ פקודה של adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`abstract CommandResult`	`executeShellV2Command(String command, IShellOutputReceiver receiver)` שיטת עזר שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`abstract CommandResult`	`fastbootOemRamdumpNow()` שיטת עזר שמפעילה ramdump ממצב אתחול מהיר.
`abstract CommandResult`	`fastbootWipePartition(String partition)` שיטת עזר שמנקה מחיצה במכשיר.
`abstract int`	`getApiLevel()` קבלת רמת ה-API של המכשיר.
`abstract int`	`getApiLevelFull()` בדומה ל-`getApiLevel()`, אבל מחזירה את הגרסה המלאה.
`abstract String`	`getBasebandVersion()` שיטה נוחה לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה.
`abstract Integer`	`getBattery()` הפונקציה מחזירה את רמת הטעינה הנוכחית של הסוללה במכשיר, או Null אם רמת הטעינה לא זמינה.
`abstract boolean`	`getBooleanProperty(String name, boolean defaultValue)` מחזירה ערך בוליאני של המאפיין שצוין.
`abstract Map<Long, String>`	`getBootHistory()` שיטת העזרה אוספת את מפת היסטוריית ההפעלה עם זמן ההפעלה וסיבת ההפעלה.
`abstract Map<Long, String>`	`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()` הפונקציה מחזירה את התאריך של המכשיר באלפיות שנייה מאז ראשית זמן יוניקס (Unix epoch).
`abstract DeviceDescriptor`	`getDeviceDescriptor()` מחזירים `DeviceDescriptor` מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.
`abstract DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` מחזירים `DeviceDescriptor` מפרטי המכשיר כדי לקבל מידע עליו בלי להעביר את אובייקט המכשיר בפועל.
`abstract TestDeviceState`	`getDeviceState()` קבלת מצב המכשיר.
`abstract long`	`getDeviceTimeOffset(Date date)` פונקציית עזר לקבלת הפרש השעות בין המכשיר לבין `Date` נתון.
`abstract InputStreamSource`	`getEmulatorOutput()` קבלת הזרם של stdout ו-stderr של האמולטור
`abstract long`	`getExternalStoreFreeSpace()` שיטת עזר לקביעת כמות השטח הפנוי באחסון החיצוני של המכשיר.
`abstract String`	`getFastbootProductType()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב אתחול מהיר.
`abstract String`	`getFastbootProductVariant()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב אתחול מהיר.
`abstract String`	`getFastbootSerialNumber()` מחזירה את המספר הסידורי של מצב אתחול מהיר (Fastboot).
`abstract String`	`getFastbootVariable(String variableName)` אחזור הערך של משתנה fastboot נתון מהמכשיר.
`abstract IFileEntry`	`getFileEntry(String path)` אחזור הפניה לקובץ מרוחק במכשיר.
`abstract IDevice`	`getIDevice()` מחזירה הפניה ל-ddmlib המשויך `IDevice`.
`abstract long`	`getIntProperty(String name, long defaultValue)` הפונקציה מחזירה ערך של מספר שלם של המאפיין הנתון מהמכשיר.
`abstract long`	`getLastExpectedRebootTimeMillis()` הפונקציה מחזירה את הפעם האחרונה שממשקי Tradefed API הפעילו הפעלה מחדש באלפיות השנייה מאז EPOCH, כפי שמוחזר על ידי `System.currentTimeMillis()`.
`abstract int`	`getLaunchApiLevel()` קבלת רמת ה-API של המכשיר שהושקה לראשונה.
`abstract InputStreamSource`	`getLogcat()` משיג קובץ snapshot של נתוני logcat.
`abstract InputStreamSource`	`getLogcat(int maxBytes)` הפקודה יוצרת תמונת מצב של הנתונים ב-Logcat שנאספו ב-`maxBytes` השניות האחרונות.
`abstract InputStreamSource`	`getLogcatDump()` קבלת פלט של logcat הנוכחי למכשיר.
`abstract InputStreamSource`	`getLogcatSince(long date)` שולף זרם של תמונת מצב של נתוני logcat שתועדו החל מהתאריך שצוין.
`abstract String`	`getMountPoint(String mountName)` מחזירה נקודת טעינה.
`abstract ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` הפונקציה מחזירה את הערך `MountPointInfo` שמתאים לנתיב של נקודת הטעינה שצוין, או את הערך `null` אם לא הותקן כלום בנתיב הזה או אם הוא לא מופיע ב-‎/proc/mounts כנקודת טעינה.
`abstract List<ITestDevice.MountPointInfo>`	`getMountPointInfo()` מחזירה גרסה מנותחת של המידע ב-‎ /proc/mounts במכשיר
`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 List<File>`	`getTombstones()` שליפה והחזרה של רשימת ה-tombstones מהמכשירים.
`abstract long`	`getTotalMemory()` הפונקציה מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים, או -1 במקרה של שגיאה פנימית
`default String`	`getTrackingSerial()` לצורך ניהול המכשיר, מקבלים את המספר הסידורי שמשמש למעקב אחרי המכשיר.
`abstract boolean`	`getUseFastbootErase()` האם להשתמש ב-fastboot erase או ב-fastboot format כדי למחוק מחיצה במכשיר.
`abstract boolean`	`isAdbRoot()`
`abstract boolean`	`isAdbTcp()`
`abstract boolean`	`isAppEnumerationSupported()` בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
`abstract boolean`	`isBypassLowTargetSdkBlockSupported()` בודקים אם הפלטפורמה במכשיר תומכת בעקיפת החסימה של גרסת SDK נמוכה להתקנות של אפליקציות
`abstract boolean`	`isDebugfsMounted()` בודקים אם debugfs מותקן.
`abstract boolean`	`isDeviceEncrypted()` הפונקציה מחזירה ערך אם המכשיר מוצפן.
`abstract boolean`	`isDirectory(String deviceFilePath)` הפונקציה מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה, אחרת היא מחזירה את הערך False.
`abstract boolean`	`isEncryptionSupported()` הפונקציה מחזירה ערך אם ההצפנה נתמכת במכשיר.
`abstract boolean`	`isExecutable(String fullPath)` הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ הפעלה, ואת הערך False אם לא.
`abstract boolean`	`isHeadless()` הפונקציה מחזירה את הערך True אם המכשיר הוא ללא ראש (ללא מסך), אחרת היא מחזירה את הערך 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()` טוענים את debugfs.
`abstract void`	`nonBlockingReboot()` מפעיל פקודה להפעלה מחדש של המכשיר וחוזר כשהפקודה מסתיימת וכשהמכשיר כבר לא גלוי ל-adb.
`abstract void`	`postBootSetup()` מבצעים את ההוראות להגדרת המכשיר לבדיקה אחרי כל אתחול.
`default void`	`postInvocationTearDown()` השיטה הזו הוצאה משימוש. במקומה, צריך להשתמש ב-method‏ `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, long timeout)` שליפת תוכן של ספריות מהמכשיר באופן רקורסיבי.
`abstract boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` שליפת תוכן של ספריות מהמכשיר באופן רקורסיבי.
`abstract File`	`pullFile(String remoteFilePath, int userId)` הפקודה מאחזרת קובץ מהמכשיר, מאחסנת אותו ב-`File` זמני מקומי ומחזירה את `File`.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile, int userId, long timeout)` שליפת קובץ מהמכשיר.
`abstract File`	`pullFile(String remoteFilePath)` הפקודה מאחזרת קובץ מהמכשיר, מאחסנת אותו ב-`File` זמני מקומי ומחזירה את `File`.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` שליפת קובץ מהמכשיר.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile)` שליפת קובץ מהמכשיר.
`abstract String`	`pullFileContents(String remoteFilePath)` מאחזר קובץ מהמכשיר ומחזיר את התוכן שלו.
`abstract File`	`pullFileFromExternal(String remoteFilePath)` שיטה נוחה לאחזור קובץ מהאחסון החיצוני של המכשיר, שמירה שלו ב-`File` מקומי זמני והחזרת הפניה ל-`File` הזה.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, int userId)` שליחת תוכן של ספריות למכשיר באופן רקורסיבי.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, Set<String> excludedDirectories)` העברת התוכן של ספריות למכשיר באופן רקורסיבי, תוך החרגה של ספריות מסוימות שעברו סינון.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath)` שליחת תוכן של ספריות למכשיר באופן רקורסיבי.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, int userId)` דחיפת קובץ למכשיר.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)` וריאציה של `pushFile(File,String)` שיכולה להביא בחשבון את הצורך של ספק התוכן.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath)` דחיפת קובץ למכשיר.
`abstract boolean`	`pushString(String contents, String deviceFilePath)` העברת קובץ שנוצר ממחרוזת למכשיר
`abstract void`	`reboot()` מפעיל מחדש את המכשיר במצב adb.
`abstract void`	`reboot(String reason)` מפעיל מחדש את המכשיר למצב adb עם `reason` נתון שיישמר גם אחרי הפעלה מחדש.
`default String`	`reboot(String command, String reason)` מפעיל מחדש את המכשיר באמצעות `command` שצוין.
`abstract void`	`rebootIntoBootloader()` מפעיל מחדש את המכשיר במצב תוכנת אתחול.
`abstract void`	`rebootIntoFastbootd()` המכשיר מופעל מחדש למצב fastbootd.
`abstract void`	`rebootIntoRecovery()` מפעיל מחדש את המכשיר במצב שחזור של adb.
`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, Collection<ITestLifeCycleReceiver> listeners)` מריץ בדיקות של מכשור ומספק שחזור של המכשיר.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` שיטה נוחה לביצוע `runInstrumentationTests(IRemoteAndroidTestRunner,Collection)` עם מאזין אחד או יותר שמועברים כפרמטרים.
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)` זהה ל-`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 erase או ב-fastboot format כדי למחוק מחיצה במכשיר.
`abstract void`	`startLogcat()` מתחילים ללכוד את הפלט של logcat מהמכשיר ברקע.
`abstract boolean`	`startTradeInModeTesting(int timeoutMs)` הפעלת מצב טרייד-אין לבדיקה.
`abstract void`	`stopEmulatorOutput()` סוגרים ומוחקים את הפלט של האמולטור.
`abstract void`	`stopLogcat()` הפסקת הלכידה של פלט logcat מהמכשיר, וביטול הנתונים של logcat שנשמרו כרגע.
`abstract void`	`stopTradeInModeTesting()` להפסיק את הבדיקה של מצב טרייד-אין.
`abstract String`	`switchToAdbTcp()` מעבירים את המכשיר למצב adb-over-tcp.
`abstract boolean`	`switchToAdbUsb()` מעבירים את המכשיר למצב adb over usb.
`abstract boolean`	`syncFiles(File localFileDir, String deviceFilePath)` סנכרון מצטבר של התוכן של ספריית קבצים מקומית למכשיר.
`abstract boolean`	`unlockDevice()` המכשיר ייפתח אם הוא במצב מוצפן.
`abstract void`	`unmountDebugfs()` מבטלים את ההרכבה של debugfs.
`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 sideload
`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 (0xffffffff)

‫methods ציבוריים

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

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

clearLogcat

public abstract void clearLogcat ()

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`RuntimeException`	אם למכשיר יש סיבת אתחול לא תקינה
`DeviceNotAvailableException`

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`RuntimeException`	אם למכשיר יש סיבת אתחול לא תקינה
`DeviceNotAvailableException`

disableAdbRoot

public abstract boolean disableAdbRoot ()

השבתה של adb root.

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

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

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

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

executeAdbCommand

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

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

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

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

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

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

executeAdbCommand

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

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

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

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

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

executeAdbV2Command

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

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

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

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

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

executeAdbV2Command

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

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

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

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

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

executeAdbV2Command

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

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

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

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

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

executeFastbootCommand

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

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

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

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

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

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

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

executeLongFastbootCommand

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

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

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

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

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

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

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

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

executeShellCommand

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

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

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

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

מידע נוסף:

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

executeShellCommand

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

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

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

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

מידע נוסף:

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

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

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

executeShellV2Command

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

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

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

החזרות
`CommandResult`

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

מידע נוסף:

executeShellV2Command

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

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

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

החזרות
`CommandResult`

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

מידע נוסף:

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

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

executeShellV2Command

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

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

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

החזרות
`CommandResult`

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

מידע נוסף:

executeShellV2Command

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

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

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

החזרות
`CommandResult`

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

מידע נוסף:

executeShellV2Command

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

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

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

החזרות
`CommandResult`

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

מידע נוסף:

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

fastbootOemRamdumpNow

public abstract CommandResult fastbootOemRamdumpNow ()

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

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

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

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

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

getApiLevel

public abstract int getApiLevel ()

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

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

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

getApiLevelFull

public abstract int getApiLevelFull ()

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

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

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

מידע נוסף:

ERROR(/frameworks/base/core/java/android/os/Build.java#parseFullVersion(String, String))

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBattery

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`, אחרת.

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

getBootHistory

public abstract Map<Long, String> getBootHistory ()

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

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

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

getBootHistorySince

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

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

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

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

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

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

הקפצת הודעות שגיאה (throw)
	com.android.tradefed.device.DeviceNotAvailableException
`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[]`	מערך של מחרוזות שמכיל את כל הקבצים בנתיב במכשיר.

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

getConnection

public abstract AbstractConnection getConnection ()

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

החזרות
`AbstractConnection`

getDeviceClass

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

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

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

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

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

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

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

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

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

החזרות
`String`

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

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

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

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

getIDevice

public abstract IDevice getIDevice ()

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

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

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

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

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

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

החזרות
`long`

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

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

getLogcat

public abstract InputStreamSource getLogcat ()

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

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

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

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

החזרות
`InputStreamSource`

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

החזרות
`InputStreamSource`

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

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

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

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

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

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

החזרות
`InputStreamSource`

getMountPoint

public abstract String getMountPoint (String mountName)

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

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

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

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

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

מידע נוסף:

IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

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

מידע נוסף:

getMountPointInfo()

getMountPointInfo

public abstract List<ITestDevice.MountPointInfo> getMountPointInfo ()

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

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

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

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

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

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

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

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

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

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

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

getProcessPid

public abstract String getProcessPid (String process)

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

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

החזרות
`String`

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

getProductType

public abstract String getProductType ()

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

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

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

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

getProductVariant

public abstract String getProductVariant ()

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

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

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

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

getProperty

public abstract String getProperty (String name)

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

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

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

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

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getSerialNumber

public abstract String getSerialNumber ()

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

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

getTombstones

public abstract List<File> getTombstones ()

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

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

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

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

מידע נוסף:

מסמכי תיעוד בנושא פריטי Tombstone

getTotalMemory

public abstract long getTotalMemory ()

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

החזרות
`long`

getTrackingSerial

public String getTrackingSerial ()

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

החזרות
`String`

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

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

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

מידע נוסף:

fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

החזרות
`boolean`	‫`true` אם למכשיר יש כרגע הרשאת רוט ל-adb, אחרת `false`.

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

isAdbTcp

public abstract boolean isAdbTcp ()

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

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

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

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

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

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

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

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

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

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

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

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

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

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

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

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

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

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

החזרות
`boolean`

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

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

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

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

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

isExecutable

public abstract boolean isExecutable (String fullPath)

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

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

החזרות
`boolean`

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

isHeadless

public abstract boolean isHeadless ()

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

החזרות
`boolean`

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

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

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

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

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

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

mountDebugfs

public abstract void mountDebugfs ()

טוענים את debugfs.

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

nonBlockingReboot

public abstract void nonBlockingReboot ()

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

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

postBootSetup

public abstract void postBootSetup ()

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

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

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

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

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

postInvocationTearDown

public void postInvocationTearDown ()

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

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

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

preInvocationSetup

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

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

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

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

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

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

pullDir

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

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

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

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

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

pullDir

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

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

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

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

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

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

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

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

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

pullFile

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

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

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

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

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

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

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

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

pullFile

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

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

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

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

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

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

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

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

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

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

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

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

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

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

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

pushDir

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

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

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

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

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

pushDir

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

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

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

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

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

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

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

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

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

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

pushFile

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

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

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

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

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

pushFile

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

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

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

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

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

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

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

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

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

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

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

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

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

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

הפעל מחדש

public abstract void reboot ()

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

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

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

הפעל מחדש

public abstract void reboot (String reason)

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

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

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

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

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

הפעל מחדש

public String reboot (String command, 
                String reason)

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

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

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

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

החזרות
`String`

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

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

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

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

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

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

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

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

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

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload ()

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

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

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

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

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

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

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

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

מידע נוסף:

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

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

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

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

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

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

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

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

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

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

remountSystemWritable

public abstract void remountSystemWritable ()

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

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

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

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

remountVendorWritable

public abstract void remountVendorWritable ()

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

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

runInstrumentationTests

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

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

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

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

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

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

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

runInstrumentationTests

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

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

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

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

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

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                Collection<ITestLifeCycleReceiver> listeners)

זהה ל-ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection) אבל מריץ את הבדיקה עבור המשתמש שצוין.

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

החזרות
`boolean`

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

runInstrumentationTestsAsUser

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

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

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

החזרות
`boolean`

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

setDate

public abstract void setDate (Date date)

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

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

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

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

setOptions

public abstract void setOptions (TestDeviceOptions options)

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

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

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

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

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

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

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

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

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

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

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

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

מידע נוסף:

fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

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

startTradeInModeTesting

public abstract boolean startTradeInModeTesting (int timeoutMs)

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

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

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

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

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

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

stopLogcat

public abstract void stopLogcat ()

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

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

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

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

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

switchToAdbTcp

public abstract String switchToAdbTcp ()

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

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

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

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

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

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

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

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

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

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

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

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

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

unlockDevice

public abstract boolean unlockDevice ()

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

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

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

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

unmountDebugfs

public abstract void unmountDebugfs ()

מבטלים את ההרכבה של debugfs.

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

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

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

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

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

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

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

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

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

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

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

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

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

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

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

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

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

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

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

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

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

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

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

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

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

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

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

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

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