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

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 מאז התקופה מהמכשיר ומה-`ERROR(/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, envMap, String... commandArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`abstract CommandResult`	`executeAdbV2Command(long timeout, envMap, String... commandArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת עם פסק זמן מוגדר.
`abstract CommandResult`	`executeAdbV2Command(String... commandArgs)` שיטת עזר שמבצעת פקודת adb כפקודת מערכת.
`abstract CommandResult`	`executeAdbV2Command(long timeout, 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( 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, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` מריצה פקודת adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` מריץ את הפקודה הנתונה של adb shell, ומנסה שוב כמה פעמים אם הפקודה נכשלת.
`abstract CommandResult`	`executeShellV2Command(String command)` שיטת עזר שמריצה פקודת adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`abstract CommandResult`	`executeShellV2Command(String command, OutputStream pipeToOutput)` שיטת עזר שמריצה פקודה של adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה וב-stderr.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput)` שיטת עזר שמריצה פקודה של adb shell ומחזירה את התוצאות כ-`CommandResult` שאוכלס כראוי בפלט של סטטוס הפקודה, stdout ו-stderr.
`abstract CommandResult`	`executeShellV2Command(String command, 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, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריצה פקודת adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` מריץ פקודת adb shell, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.
`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()` שיטה נוחה לקבלת סוג המוצר של המכשיר הזה כשהוא במצב אתחול מהיר.
`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()` קבלת קובץ dump של logcat הנוכחי למכשיר.
`abstract InputStreamSource`	`getLogcatSince(long date)` שולף זרם של תמונת מצב של נתוני logcat שתועדו החל מהתאריך שצוין.
`abstract String`	`getMountPoint(String mountName)` מחזירה נקודת טעינה.
`abstract ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` הפונקציה מחזירה את הערך `MountPointInfo` שמתאים לנתיב של נקודת הטעינה שצוין, או את הערך `null` אם לא הותקן כלום בנתיב הזה או אם הוא לא מופיע ב-‎/proc/mounts כנקודת טעינה.
`abstract`	`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`	`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()` השיטה הזו הוצאה משימוש. במקומה צריך להשתמש במדיניות `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()` מפעיל מחדש את המכשיר במצב שחזור של 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, ITestLifeCycleReceiver... listeners)` ‫Convenience method לביצוע `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 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.

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

clearLogcat

public abstract void clearLogcat ()

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

זריקות
`RuntimeException`	אם למכשיר יש סיבת אתחול לא תקינה
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

זריקות
`RuntimeException`	אם למכשיר יש סיבת אתחול לא תקינה
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableAdbRoot

public abstract boolean disableAdbRoot ()

השבתה של adb root.

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

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

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

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

executeAdbCommand

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

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

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

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

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

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

executeAdbCommand

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

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

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

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

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

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

executeAdbV2Command

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

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

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

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

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

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

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

executeAdbV2Command

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

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

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

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

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

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

executeFastbootCommand

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

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

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

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

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

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

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

executeLongFastbootCommand

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

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

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

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

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

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

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

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

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

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

מידע נוסף:

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

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

החזרות
`CommandResult`

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

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

החזרות
`CommandResult`

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

החזרות
`CommandResult`

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

מידע נוסף:

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

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

getApiLevel

public abstract int getApiLevel ()

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

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

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

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

זריקות
`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`, אחרת.

זריקות
`DeviceNotAvailableException`

getBootHistory

public abstract  getBootHistory ()

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

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

זריקות
`DeviceNotAvailableException`

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

זריקות
`DeviceNotAvailableException`

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

זריקות
	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[]`	מערך של מחרוזות שמכיל את כל הקבצים בנתיב במכשיר.

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

getConnection

public abstract AbstractConnection getConnection ()

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

החזרות
`AbstractConnection`

getDeviceClass

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

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

פונקציית עזר לקבלת הפרש הזמן בין המכשיר לבין 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. במקרה הזה, זו גרסה קצת יותר בטוחה משיטת getProductType() הגנרית, כי ITestDevice יודע לשחזר את המכשיר למצב אתחול מהיר אם המכשיר נמצא במצב שגוי או לא מגיב.

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

החזרות
`String`

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

זריקות
	UnsupportedOperationException
`DeviceNotAvailableException`

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

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

זריקות
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

החזרות
`long`

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

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

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

זריקות
`DeviceNotAvailableException`

מידע נוסף:

getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

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

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

זריקות
`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`: מחרוזת שם התהליך.

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

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getSerialNumber

public abstract String getSerialNumber ()

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

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

getTombstones

public abstract  getTombstones ()

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

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

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

זריקות
`DeviceNotAvailableException`

מידע נוסף:

מסמכי תיעוד של Tombstones

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`.

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

isAdbTcp

public abstract boolean isAdbTcp ()

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

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

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

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

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

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

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

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

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

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

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

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

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

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

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

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

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

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

החזרות
`boolean`

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

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

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

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

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

isExecutable

public abstract boolean isExecutable (String fullPath)

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

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

החזרות
`boolean`

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

isHeadless

public abstract boolean isHeadless ()

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

החזרות
`boolean`

זריקות
`DeviceNotAvailableException`

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

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

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

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

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

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

nonBlockingReboot

public abstract void nonBlockingReboot ()

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

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

postBootSetup

public abstract void postBootSetup ()

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

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

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

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

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

postInvocationTearDown

public void postInvocationTearDown ()

השיטה הזו הוצאה משימוש.
במקומה צריך להשתמש ב-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`: המאפיינים שמאוחסנים בהקשר של הקריאה

זריקות
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableException
`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`	אם המכשיר לא זמין אחרי הפעלה מחדש

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

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

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

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

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

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

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

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

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload ()

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

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

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

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

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

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

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

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

מידע נוסף:

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

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

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

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

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

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

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

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

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

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

remountSystemWritable

public abstract void remountSystemWritable ()

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

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

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

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

remountVendorWritable

public abstract void remountVendorWritable ()

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

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

runInstrumentationTests

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

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

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

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

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

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

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

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

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

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

stopLogcat

public abstract void stopLogcat ()

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

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

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

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

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

switchToAdbTcp

public abstract String switchToAdbTcp ()

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

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

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

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

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

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

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

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

unlockDevice

public abstract boolean unlockDevice ()

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

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

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

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

unmountDebugfs

public abstract void unmountDebugfs ()

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

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

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

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

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

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

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

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

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

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

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

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

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

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

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

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

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

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

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

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