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 void deleteFile(String deviceFilePath, int userId)

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

abstract boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

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

abstract boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command(String command)

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

abstract CommandResult executeShellV2Command(String command, OutputStream pipeToOutput)

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

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

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

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

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

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

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

abstract CommandResult fastbootWipePartition(String partition)

שיטה מסייעת שמוחקת מחיצה במכשיר.

abstract int getApiLevel()

אחזור רמת ה-API של המכשיר.

abstract String getBasebandVersion()

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

abstract Integer getBattery()

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

abstract boolean getBooleanProperty(String name, boolean defaultValue)

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

abstract getBootHistory()

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

abstract getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

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

abstract String getBootloaderVersion()

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

abstract String getBuildAlias()

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

abstract String getBuildFlavor()

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

abstract String getBuildId()

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

abstract String getBuildSigningKeys()

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

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

abstract DeviceDescriptor getCachedDeviceDescriptor()

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

abstract DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

abstract String[] getChildren(String deviceFilePath)

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

abstract AbstractConnection getConnection()

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

abstract String getDeviceClass()

אחזור של סיווג המכשיר.

abstract long getDeviceDate()

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

abstract DeviceDescriptor getDeviceDescriptor()

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

abstract DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

abstract TestDeviceState getDeviceState()

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

abstract long getDeviceTimeOffset(Date date)

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

abstract InputStreamSource getEmulatorOutput()

אחזור של הסטרים stdout ו-stderr של האמולטור

abstract long getExternalStoreFreeSpace()

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

abstract String getFastbootProductType()

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

abstract String getFastbootProductVariant()

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

abstract String getFastbootSerialNumber()

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

abstract String getFastbootVariable(String variableName)

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

abstract IFileEntry getFileEntry(String path)

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

abstract IDevice getIDevice()

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

abstract long getIntProperty(String name, long defaultValue)

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

abstract long getLastExpectedRebootTimeMillis()

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

abstract int getLaunchApiLevel()

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

abstract InputStreamSource getLogcat()

אחזור של קובץ snapshot של נתוני logcat.

abstract InputStreamSource getLogcat(int maxBytes)

יצירת סטרימינג של תמונת מצב של maxBytes הנתונים האחרונים של logcat שצולמו.

abstract InputStreamSource getLogcatDump()

קבלת גרסת dump של logcat הנוכחי של המכשיר.

abstract InputStreamSource getLogcatSince(long date)

אחזור של זרם snapshot של נתוני logcat שצולמו החל מהתאריך שצוין.

abstract String getMountPoint(String mountName)

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

abstract ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

הפונקציה מחזירה את הערך MountPointInfo שתואם לנתיב של נקודת הטעינה שצוינה, או את הערך null אם לא הועמסה נקודת טעינה בנתיב הזה או אם הוא לא מופיע ב-/proc/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()

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

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 אם המכשיר ללא צג (headless), ואת הערך 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)

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

abstract boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

הרצת בדיקות של מכשירי מדידה, ותיקון מכשירי Android.

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

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

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

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

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

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

צפוי שייעשה בו שימוש כשהמכשיר כבר נמצא במצב Fastboot.

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

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

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

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

צפוי שייעשה בו שימוש כשהמכשיר כבר נמצא במצב Fastboot.

פרמטרים
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 להרצה

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

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

executeShellCommand

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

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

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

receiver IShellOutputReceiver: ה-IShellOutputReceiver שאליו מפנים את הפלט של המעטפת.

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

timeUnit TimeUnit: היחידה של maxTimeToOutputShellResponse

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

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

executeShellCommand

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

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

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

receiver IShellOutputReceiver: ה-IShellOutputReceiver שאליו מפנים את הפלט של המעטפת.

maxTimeoutForCommand long: הזמן המקסימלי לתפוגה להשלמת הפקודה. היחידות מצוינות ב-timeUnit.

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

timeUnit TimeUnit: היחידה של maxTimeToOutputShellResponse

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

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

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

receiver IShellOutputReceiver: ה-IShellOutputReceiver שאליו מפנים את הפלט של המעטפת.

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

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 להרצה

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 להרצה

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 להרצה

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

pipeToOutput OutputStream: ERROR(/OutputStream) – היעד שאליו יועבר הפלט של std, או null.

pipeToError OutputStream: ERROR(/OutputStream) – היעד שאליו תופנה שגיאת סטנדרטית, או 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 ותצור מערכת קבצים חדשה במכשיר.

צפוי שייעשה בו שימוש כשהמכשיר כבר נמצא במצב Fastboot.

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

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

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

החזרות
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 סוג ה-build או 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) נתון. שימוש בזמן מערכת (Epoch) באופן פנימי.

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

יש להשתמש בשיטה הזו רק אם המכשיר צריך להיות במצב 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' וגם בתחביר 'system')

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

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

getIDevice

public abstract IDevice getIDevice ()

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

ייתכן ש-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 ()

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

    יצירת סטרימינג של תמונת מצב של maxBytes הנתונים האחרונים של logcat שצולמו.

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

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

    החזרות
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

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

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

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

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

    החזרות
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

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

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

    TODO: move this behavior to 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)

    שיטת העזרה מפעילה את הפקודות 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 ()

    אחזור של רשימת המכשירים מהמכשירים והחזרתה. נדרשת הרשאת root.

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

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

    זריקות
    DeviceNotAvailableException

    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.

    מידע נוסף:

    isAdbRoot

    public abstract boolean isAdbRoot ()

    החזרות
    boolean true אם במכשיר יש כרגע הרשאת root ב-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 אם המכשיר ללא צג (headless), ואת הערך 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 אם המכשיר לא זמין אחרי ההפעלה מחדש

    מידע נוסף:

    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)

    הרצת בדיקות של מכשירי מדידה, ותיקון מכשירי Android.

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

    הגדרת ערך המאפיין במכשיר. נדרש שהרשאת root ב-adb תהיה 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)

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

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

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

    מידע נוסף:

    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 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 לא ב-root תיכשל.

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

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