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

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

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

abstract String getFastbootProductVariant()

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

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)

אחזור חזרה (recursive) של תוכן הספרייה מהמכשיר.

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

אחזור חזרה (recursive) של תוכן הספרייה מהמכשיר.

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 boolean startTradeInModeTesting(int timeoutMs)

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

abstract void stopEmulatorOutput()

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

abstract void stopLogcat()

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

abstract void stopTradeInModeTesting()

מפסיקים לבדוק את מצב הטרייד-אין.

abstract String switchToAdbTcp()

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

abstract boolean switchToAdbUsb()

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

abstract boolean syncFiles(File localFileDir, String deviceFilePath)

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

abstract boolean unlockDevice()

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

abstract void unmountDebugfs()

ניתוק של debugfs.

abstract boolean waitForBootComplete(long timeOut)

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

abstract boolean waitForDeviceAvailable()

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

abstract boolean waitForDeviceAvailable(long waitTime)

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

abstract boolean waitForDeviceAvailableInRecoverPath(long waitTime)

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

abstract void waitForDeviceBootloader()

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

abstract boolean waitForDeviceInRecovery(long waitTime)

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

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