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