INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


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

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

סיכום

קבועים

int UNKNOWN_API_LEVEL

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

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

abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

abstract void clearLogcat ()

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

abstract void deleteFile (String deviceFilePath)

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

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.

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

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

abstract String executeAdbCommand (String... commandArgs)

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

abstract String executeAdbCommand (long timeout, envMap, String... commandArgs) executeAdbCommand (long timeout, 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 ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs)

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

abstract String executeShellCommand (String command)

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

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

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

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

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

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command (String command)

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

abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

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

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

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

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

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

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

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

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

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

abstract CommandResult fastbootWipePartition (String partition)

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

abstract int getApiLevel ()

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

abstract String getBasebandVersion ()

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

abstract Integer getBattery ()

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

abstract boolean getBooleanProperty (String name, boolean defaultValue)

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

abstract getBootHistory ()

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

abstract getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

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

abstract String getBootloaderVersion ()

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

abstract String getBuildAlias ()

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

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

abstract String getBuildSigningKeys ()

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

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

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

abstract long getExternalStoreFreeSpace ()

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

abstract String getFastbootProductType ()

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

abstract String getFastbootProductVariant ()

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

abstract String getFastbootSerialNumber ()

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

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

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

abstract int getLaunchApiLevel ()

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

abstract InputStreamSource getLogcat ()

תופס זרם תמונת מצב של נתוני logcat.

abstract InputStreamSource getLogcat (int maxBytes)

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

abstract InputStreamSource getLogcatDump ()

קבל dump של ה-logcat הנוכחי עבור המכשיר.

abstract InputStreamSource getLogcatSince (long date)

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

abstract String getMountPoint (String mountName)

מחזירה נקודת הרכבה.

abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

abstract getMountPointInfo ()

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

abstract long getPartitionFreeSpace (String partition)

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

abstract ProcessInfo getProcessByName (String processName)

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

abstract String getProcessPid (String process)

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

abstract String getProductType ()

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

abstract String getProductVariant ()

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

abstract String getProperty (String name)

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

abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

abstract String getSerialNumber ()

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

abstract getTombstones ()

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

abstract long getTotalMemory ()

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

abstract boolean getUseFastbootErase ()

בדוק אם להשתמש בפורמט Fastboot Erase או Fastboot כדי למחוק מחיצה במכשיר.

abstract boolean isAdbRoot ()
abstract boolean isAdbTcp ()
abstract boolean isAppEnumerationSupported ()

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

abstract boolean isBypassLowTargetSdkBlockSupported ()

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

abstract boolean isDebugfsMounted ()

בדוק אם ניפוי באגים מותקן.

abstract boolean isDeviceEncrypted ()

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

abstract boolean isDirectory (String deviceFilePath)

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

abstract boolean isEncryptionSupported ()

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

abstract boolean isExecutable (String fullPath)

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

abstract boolean isHeadless ()

החזר אמת אם המכשיר חסר ראש (ללא מסך), אחרת שקר.

abstract boolean isRuntimePermissionSupported ()

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

abstract boolean isStateBootloaderOrFastbootd ()

מחזירה true אם המכשיר נמצא ב- TestDeviceState#FASTBOOT או TestDeviceState.FASTBOOTD .

abstract boolean logAnrs ( ITestLogger logger)

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

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

התחבר הודעה ב-logcat של המכשיר.

abstract void mountDebugfs ()

הר באגים.

abstract void nonBlockingReboot ()

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

abstract void postBootSetup ()

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

default void postInvocationTearDown ()

שיטה זו הוצאה משימוש. השתמש במקום זאת postInvocationTearDown(Throwable) .

abstract void postInvocationTearDown (Throwable invocationException)

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

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

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

abstract boolean pullDir (String deviceFilePath, File localDir)

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

abstract 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, excludedDirectories) 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 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 sideload (שים לב שזהו מצב מיוחד תחת שחזור)

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

abstract void rebootIntoSideload ()

מאתחל את המכשיר למצב adb sideload (שים לב שזהו מצב מיוחד תחת שחזור)

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

abstract void rebootUntilOnline ()

חלופי ל- reboot() שחוסם רק עד שהמכשיר מקוון כלומר גלוי ל-adb.

abstract void rebootUntilOnline (String reason)

חלופי ל- reboot() שחוסם רק עד שהמכשיר מקוון כלומר גלוי ל-adb.

abstract void rebootUserspace ()

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

abstract void rebootUserspaceUntilOnline ()

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

abstract void remountSystemReadOnly ()

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

abstract void remountSystemWritable ()

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

abstract void remountVendorReadOnly ()

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

abstract void remountVendorWritable ()

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

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

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

abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

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

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

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

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

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 setUseFastbootErase (boolean useFastbootErase)

הגדר אם להשתמש בפורמט Fastboot Erase או Fastboot כדי למחוק מחיצה במכשיר.

abstract void startLogcat ()

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

abstract void stopEmulatorOutput ()

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

abstract void stopLogcat ()

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

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

בטל טעינת באגים.

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 recovery' (שים לב שזה שונה מ- IDeviceRecovery ).

abstract boolean waitForDeviceInSideload (long waitTime)

חוסם שהמכשיר יהיה במצב 'עומס צד של adb'

abstract boolean waitForDeviceNotAvailable (long waitTime)

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

abstract void waitForDeviceOnline ()

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

abstract void waitForDeviceOnline (long waitTime)

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

abstract boolean waitForDeviceShell (long waitTime)

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

קבועים

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

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

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

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

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

החזרות
boolean נכון אם הרמה נתמכת. שקר אחרת.

זורק
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

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

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

מחק קובץ

public abstract void deleteFile (String deviceFilePath)

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

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

זורק
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) שלו. Soft-Restart מתייחס ל-system_server שהופעל מחדש מחוץ לאתחול קשיח של התקן (לדוגמה: אתחול מחדש מבוקש). ניתן להשיג את המכשיר הנוכחי utcEpochTime ב-Millisecond באמצעות השיטה getDeviceDate() .

פרמטרים
utcEpochTime long : זמן המכשיר בשנייה מאז התקופה.

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 אם הקובץ קיים, false אחרת.

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

מפעיל את השורש של adb. אם ההגדרה "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 כפקודת מערכת.

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

פרמטרים
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 אם החיבור למכשיר אבד ולא ניתן לשחזר אותו.

executeFastbootCommand

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

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

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

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

commandArgs String : פקודת fastboot והארגומנטים להפעלה

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

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

פרמטרים
commandArgs String : פקודת fastboot והארגומנטים להפעלה

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

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

זהה ל- executeFastbootCommand(String) למעט שימוש בפסק זמן ארוך יותר.

פרמטרים
commandArgs String : פקודת fastboot והארגומנטים להפעלה

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

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

executeLongFastbootCommand

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

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

זהה ל- executeFastbootCommand(String) למעט שימוש בפסק זמן ארוך יותר.

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

commandArgs String : פקודת fastboot והארגומנטים להפעלה

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

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

executeShellCommand

public abstract String executeShellCommand (String command)

שיטת Helper שמבצעת פקודת 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, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

פרמטרים
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, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

receiver IShellOutputReceiver : IShellOutputReceiver שאליו יש לכוון פלט מעטפת.

maxTimeoutForCommand long : הזמן הקצוב המרבי להשלמת הפקודה; יחידה כפי שצוין ב- timeUnit

maxTimeToOutputShellResponse long : משך הזמן המקסימלי שבמהלכו מותר לפקודה לא להוציא שום תגובה; יחידה כפי שצוין ב- timeUnit

timeUnit TimeUnit : יחידה עבור maxTimeToOutputShellResponse

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

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

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

pipeToOutput OutputStream : ERROR(/OutputStream) שבו הפלט std יופנה מחדש, או null.

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

שיטת Helper אשר מבצעת פקודת 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, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

maxTimeoutForCommand long : הזמן הקצוב המרבי להשלמת הפקודה; יחידה כפי שצוין ב- timeUnit

timeUnit TimeUnit : יחידה עבור maxTimeToOutputShellResponse

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

החזרות
CommandResult

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

executeShellV2Command

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

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

פרמטרים
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, עם פרמטרים נוספים לשליטה בהתנהגות הפקודה.

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

pipeAsInput File : ERROR(/File) שיועבר כקלט לפקודה, או null.

pipeToOutput OutputStream : ERROR(/OutputStream) שבו הפלט std יופנה מחדש, או null.

maxTimeoutForCommand long : הזמן הקצוב המרבי להשלמת הפקודה; יחידה כפי שצוין ב- timeUnit

timeUnit TimeUnit : יחידה עבור maxTimeToOutputShellResponse

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

החזרות
CommandResult

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

executeShellV2Command

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

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

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

pipeAsInput File : ERROR(/File) שיועבר כקלט לפקודה, או null.

pipeToOutput OutputStream : ERROR(/OutputStream) שבו הפלט std יופנה מחדש, או null.

pipeToError OutputStream : ERROR(/OutputStream) שבו השגיאה std תופנה מחדש, או null.

maxTimeoutForCommand long : הזמן הקצוב המרבי להשלמת הפקודה; יחידה כפי שצוין ב- timeUnit

timeUnit TimeUnit : יחידה עבור maxTimeToOutputShellResponse

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

החזרות
CommandResult

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

פרמטרים
partition String : המחיצה לניגוב

החזרות
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. TL;DR שיטה זו מדווחת רק על גרסה מדויקת אם המאפיין gsm.version.baseband זהה לגרסה המוחזרת על ידי fastboot getvar version-baseband .

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

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

getBattery

public abstract Integer getBattery ()

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

החזרות
Integer

get BooleanProperty

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 בשנייה מאז Epoch) וסיבת האתחול

זורק
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

פרמטרים
utcEpochTime long : זמן המכשיר מאז Epoch.

timeUnit TimeUnit : יחידת הזמן TimeUnit .

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

זורק
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

זורק
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

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

החזרות
String טעם המבנה או ריק אם לא ניתן היה לאחזר אותו

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

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

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

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

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

זורק
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) . השתמש ב- Epoch Time באופן פנימי.

פרמטרים
date Date

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

זורק
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

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

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

החזרות
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" וגם "מערכת" נתמך)

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

זורק
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIDvice

public abstract IDevice getIDevice ()

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

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

החזרות
IDevice ה- IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

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

זורק
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

מחזירים בפעם האחרונה ש- APIs Tradefed עוררו אתחול מחדש באלפיות השנייה מאז התקופה שהוחזר על ידי 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 ()

תופס זרם תמונת מצב של נתוני Logcat.

עובד בשני מצבים:

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

    החזרות
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

    החזרות
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

    החזרות
    InputStreamSource InputStreamSource של נתוני Logcat. זרם ריק מוחזר אם לא מצליח ללכוד נתוני logcat.

    getLogcatsince

    public abstract InputStreamSource getLogcatSince (long date)

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

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

    החזרות
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

    מחזיר נקודת הרכבה.

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

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

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

    החזרות
    String נקודת הר או null

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    פרמטרים
    mountpoint String

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

    זורק
    DeviceNotAvailableException

    ראה גם:

    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)

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

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

    החזרות
    ProcessInfo תהליך של שם תהליך נתון

    זורק
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    מחזיר את PID של השירות או NULL אם משהו ישתבש.

    פרמטרים
    process String : מחרוזת השם Proces.

    החזרות
    String

    זורק
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

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

    שיטה זו תעבוד אם המכשיר נמצא במצב ADB או FastBoot.

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

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

    getProductVariant

    public abstract String getProductVariant ()

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

    שיטה זו תעבוד אם המכשיר נמצא במצב ADB או FastBoot.

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

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

    GetProperty

    public abstract String getProperty (String name)

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

    פרמטרים
    name String : שם המאפיין

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

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getSerialNumber

    public abstract String getSerialNumber ()

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

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

    GetTombstones

    public abstract  getTombstones ()

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

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

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

    זורק
    DeviceNotAvailableException

    ראה גם:

    getTotalMemory

    public abstract long getTotalMemory ()

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

    החזרות
    long

    getUseFastBooterase

    public abstract boolean getUseFastbootErase ()

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

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

    ISADBROOT

    public abstract boolean isAdbRoot ()

    החזרות
    boolean true אם למכשיר יש כרגע שורש ADB, false אחרת.

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

    ISADBTCP

    public abstract boolean isAdbTcp ()

    החזרות
    boolean true אם המכשיר מחובר ל- ADB-Over-TCP, false אחרת.

    ISAPPENUMERATIONS נתמך

    public abstract boolean isAppEnumerationSupported ()

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

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

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    isbypasslowtargetsdkblocksupported

    public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

    החזרות
    boolean נכון אם עוקף חסימת SDK יעד נמוך, שקר אחרת

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

    ISDIREPTORY

    public abstract boolean isDirectory (String deviceFilePath)

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

    פרמטרים
    deviceFilePath String

    החזרות
    boolean

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    isencryptionsupport

    public abstract boolean isEncryptionSupported ()

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

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

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    ניתן להבחין

    public abstract boolean isExecutable (String fullPath)

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

    פרמטרים
    fullPath String

    החזרות
    boolean

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    חסר ראש

    public abstract boolean isHeadless ()

    חזור נכון אם המכשיר חסר ראש (ללא מסך), לא נכון.

    החזרות
    boolean

    זורק
    DeviceNotAvailableException

    ISRUNTIMEPERMISSISSUPERIDED

    public abstract boolean isRuntimePermissionSupported ()

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

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

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    isstateBootloaderorFastBootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    מחזיר נכון אם המכשיר נמצא ב- TestDeviceState#FASTBOOT או TestDeviceState.FASTBOOTD .

    החזרות
    boolean

    Loganrs

    public abstract boolean logAnrs (ITestLogger logger)

    אוסף ויומן ANR מהמכשיר.

    פרמטרים
    logger ITestLogger : ITestLogger לרישום ה- ANRS.

    החזרות
    boolean נכון אם הרישום היה מוצלח, לא נכון אחרת.

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

    הר באגים.

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    NonblockingRoot

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

    Pullfile

    public abstract File pullFile (String remoteFilePath, 
                    int userId)

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

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

    userId int : מזהה המשתמש שישתולל ממנו

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

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

    Pullfile

    public abstract File pullFile (String remoteFilePath)

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

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

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

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

    Pullfile

    public abstract boolean pullFile (String remoteFilePath, 
                    File localFile)

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

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

    localFile File : הקובץ המקומי לאחסון תוכן. אם לא ריק, התוכן יוחלף.

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

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

    Pullfile

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

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

    פרמטרים
    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, 
                     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 אם החיבור עם המכשיר אבוד ולא ניתן לשחזר אותו.

    קובץ דחיפה

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

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

    פרמטרים
    localFile File : הקובץ המקומי לדחוף

    deviceFilePath String : נתיב הקובץ המוחלט של היעד המרוחק

    evaluateContentProviderNeeded boolean : האם לבדוק אם אנו זקוקים לספק התוכן

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

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

    קובץ דחיפה

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

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

    פרמטרים
    localFile File : הקובץ המקומי לדחוף

    deviceFilePath String : נתיב הקובץ המוחלט של היעד המרוחק

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

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

    דחיפה

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

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

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

    Broeptointobootloader

    public abstract void rebootIntoBootloader ()

    אתר מחדש את המכשיר למצב Bootloader.

    חוסם עד שההתקן נמצא במצב Lootloader.

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

    rebroetintofastBootd

    public abstract void rebootIntoFastbootd ()

    אתר מחדש את המכשיר למצב FastBootd.

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

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

    הפעלה מחדש את Covercovery

    public abstract void rebootIntoRecovery ()

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

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

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

    הפעל מחדש את ה- DiledIde

    public abstract void rebootIntoSideload (boolean autoReboot)

    אתר מחדש את המכשיר למצב HADID ADB (שימו לב שמדובר במצב מיוחד בשחזור)

    חוסם עד שהתקן נכנס למצב מטען צדדי

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

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

    הפעל מחדש את ה- DiledIde

    public abstract void rebootIntoSideload ()

    אתר מחדש את המכשיר למצב HADID ADB (שימו לב שמדובר במצב מיוחד בשחזור)

    חוסם עד שהתקן נכנס למצב מטען צדדי

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

    REBOETUNTILONLINE

    public abstract void rebootUntilOnline ()

    חלופה reboot() שחוסמת רק עד שהמכשיר מקוון, כלומר גלוי ל- ADB.

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

    REBOETUNTILONLINE

    public abstract void rebootUntilOnline (String reason)

    חלופה reboot() שחוסמת רק עד שהמכשיר מקוון, כלומר גלוי ל- ADB.

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

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

    ראה גם:

    אתחול מחדש של Space

    public abstract void rebootUserspace ()

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

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

    אַזהָרָה. Outpace Reboop מחדש נמצא כעת תחת פיתוח פעיל, השתמש בו על אחריותך בלבד.

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

    REBOOTUSERSPACEUNTILONLINE

    public abstract void rebootUserspaceUntilOnline ()

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

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

    REMOUNTSYSTEMREADONLY

    public abstract void remountSystemReadOnly ()

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

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    REMOUNTSYSTERTRIFT

    public abstract void remountSystemWritable ()

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

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    RemountVendorReadonly

    public abstract void remountVendorReadOnly ()

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

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    REMOUNTVENDORWRIFT

    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 : מאזיני תוצאות המבחן

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

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

    RuninstrumentationTests

    public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

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

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

    פרמטרים
    runner IRemoteAndroidTestRunner : IRemoteAndroidTestRunner שמנהל את הבדיקות

    listeners : מאזיני תוצאות המבחן

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

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

    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

    קבע תאריך

    public abstract void setDate (Date date)

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

    הערה: תאריך הגדרת המכשיר דורש שורש

    פרמטרים
    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 נכון.

    פרמטרים
    propKey String : המפתח הממוקד לקבוע.

    propValue String : ערך המאפיין שיוגדר.

    החזרות
    boolean חוזר True אם הפקודה SetProp הייתה מוצלחת, שקרית אחרת.

    זורק
    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 : בין אם 'התאושש עד מקוון בלבד' צריך להיות על או לא.

    setUseFastBooterase

    public abstract void setUseFastbootErase (boolean useFastbootErase)

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

    פרמטרים
    useFastbootErase boolean : true אם יש להשתמש במחיקה מהירה או false אם יש להשתמש בפורמט FastBoot.

    StartLogcat

    public abstract void startLogcat ()

    התחל לתפוס את פלט Logcat מההתקן ברקע.

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

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

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

    StopeMulatorOutput

    public abstract void stopEmulatorOutput ()

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

    StopLogcat

    public abstract void stopLogcat ()

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

    לא ישפיע אם פלט Logcat לא נלכד.

    SwitchToadBtcp

    public abstract String switchToAdbTcp ()

    החלף התקן למצב ADB-Over-TCP.

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

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    switchtoadbusb

    public abstract boolean switchToAdbUsb ()

    החלף התקן ל- ADB על מצב USB.

    החזרות
    boolean true אם המתג היה מוצלח, false אחרת.

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    סינכרון

    public abstract boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

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

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

    שימוש בדוגמה: SyncFiles ("/TMP/FILES", "/SDCARD") יצר ספריית A/SDCARD/קבצים אם הוא כבר לא קיים, ודחף מחדש את תוכן/TMP/קבצים ל-/SDCARD/קבצים.

    פרמטרים
    localFileDir File : ספריית הקבצים המקומית המכילה קבצים לדחיפה רקורסיבית.

    deviceFilePath String : שורש נתיב הקובץ המוחלט של היעד המרוחק. כל הספריות בנתיב הקובץ THOS חייבות להיות קריאות. כלומר דחיפה ל/נתונים/מקומיים/TMP כאשר ADB אינו שורש ייכשל

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

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

    ביטול נעילה

    public abstract boolean unlockDevice ()

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

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

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

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

    unmountdebugfs

    public abstract void unmountDebugfs ()

    Unmount Debugfs.

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    WaitforBootComplete

    public abstract boolean waitForBootComplete (long timeOut)

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

    פרמטרים
    timeOut long : זמן ב- MSECs כדי לחכות שהדגל יוגדר

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

    זורק
    com.android.tradefed.device.devicenotavailableException
    DeviceNotAvailableException

    WaitfordeVicailaiable

    public abstract boolean waitForDeviceAvailable ()

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

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

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

    WaitfordeVicailaiable

    public abstract boolean waitForDeviceAvailable (long waitTime)

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

    פרמטרים
    waitTime long : הזמן בטרשת נפוצה לחכות

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

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

    WaitfordeVicailableInrecoverpath

    public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    פרמטרים
    waitTime long

    החזרות
    boolean נכון אם מכשיר זמין, שווא אם אינו זמין.

    זורק
    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 Sideed Thape'

    פרמטרים
    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 .