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 הקודם |
abstract
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
שיטה מסייעת לבדיקת אם המכשיר הופעל מחדש באופן רך מאז שעון UTC מאז תחילת הזמן (epoch) מהמכשיר ומ- |
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,
שיטת עזר שמפעילה פקודה של 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(
שיטה מסייעת שמריצה פקודה ארוכה של fastboot כפקודת מערכת עם משתני סביבה של מערכת. |
abstract
String
|
executeShellCommand(String command)
שיטה מסייעת שמפעילה פקודה של adb shell ומחזירה את הפלט כ- |
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 ומחזירה את התוצאות כ- |
abstract
CommandResult
|
executeShellV2Command(String command, OutputStream pipeToOutput)
שיטה מסייעת שמפעילה פקודת adb shell ומחזירה את התוצאות כ- |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput)
שיטה מסייעת שמריצה פקודת adb shell ומחזירה את התוצאות כ- |
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()
הפונקציה מחזירה את הערך של |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
הפונקציה מחזירה את הערך של |
abstract
String[]
|
getChildren(String deviceFilePath)
חלופה לשימוש ב- |
abstract
AbstractConnection
|
getConnection()
הפונקציה מחזירה את החיבור שמשויך למכשיר. |
abstract
String
|
getDeviceClass()
אחזור של סיווג המכשיר. |
abstract
long
|
getDeviceDate()
החזרת התאריך של המכשיר במיליוניות השנייה מאז תחילת התקופה של זמן המערכת. |
abstract
DeviceDescriptor
|
getDeviceDescriptor()
החזרת |
abstract
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
החזרת |
abstract
TestDeviceState
|
getDeviceState()
אחזור המצב של המכשיר. |
abstract
long
|
getDeviceTimeOffset(Date 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()
הפונקציה מחזירה הפניה ל- |
abstract
long
|
getIntProperty(String name, long defaultValue)
הפונקציה מחזירה את הערך השלם של המאפיין הנתון מהמכשיר. |
abstract
long
|
getLastExpectedRebootTimeMillis()
הפונקציה מחזירה את הפעם האחרונה שבה ממשקי ה-API של Tradefed גרמו להפעלה מחדש, במיליוניות השנייה מאז EPOCH, כפי שהוחזר על ידי |
abstract
int
|
getLaunchApiLevel()
אחזור של רמת ה-API הראשונה שהמכשיר הושק איתה. |
abstract
InputStreamSource
|
getLogcat()
אחזור של קובץ snapshot של נתוני logcat. |
abstract
InputStreamSource
|
getLogcat(int maxBytes)
יצירת סטרימינג של תמונת מצב של |
abstract
InputStreamSource
|
getLogcatDump()
קבלת גרסת dump של logcat הנוכחי של המכשיר. |
abstract
InputStreamSource
|
getLogcatSince(long date)
אחזור של זרם snapshot של נתוני logcat שצולמו החל מהתאריך שצוין. |
abstract
String
|
getMountPoint(String mountName)
הפונקציה מחזירה נקודת טעינה. |
abstract
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
הפונקציה מחזירה את הערך |
abstract
|
getMountPointInfo()
הפונקציה מחזירה גרסה מנותחת של המידע שב-/proc/mounts במכשיר |
abstract
long
|
getPartitionFreeSpace(String partition)
שיטה מסייעת לקביעת נפח האחסון הפנוי במחיצה של המכשיר. |
abstract
ProcessInfo
|
getProcessByName(String processName)
שיטת העזרה מפעילה את הפקודות pidof ו-stat ומחזירה אובייקט |
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 אם המכשיר נמצא ב- |
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()
השיטה הזו הוצאה משימוש.
במקום זאת, צריך להשתמש ב- |
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)
הפונקציה מאחזרת קובץ מהמכשיר, שומרת אותו ב- |
abstract
File
|
pullFile(String remoteFilePath)
הפונקציה מאחזרת קובץ מהמכשיר, שומרת אותו ב- |
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)
שיטה נוחה לאחזור קובץ מהאחסון החיצוני של המכשיר, לשמירתו ב- |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath, int userId)
שליחת תוכן הספרייה למכשיר באופן רספונסיבי. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath,
דחיפה רפרסיבית של תוכן הספריות למכשיר, תוך החרגה של ספריות מסוימות שעברו סינון. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath)
שליחת תוכן הספרייה למכשיר באופן רספונסיבי. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
וריאנט של |
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 עם |
abstract
void
|
rebootIntoBootloader()
הפעלה מחדש של המכשיר למצב תוכנת אתחול. |
abstract
void
|
rebootIntoFastbootd()
הפעלה מחדש של המכשיר למצב fastbootd. |
abstract
void
|
rebootIntoRecovery()
הפעלה מחדש של המכשיר למצב שחזור adb. |
abstract
void
|
rebootIntoSideload(boolean autoReboot)
הפעלה מחדש של המכשיר למצב התקנה ממקור לא ידוע ב-ADB (שימו לב: זהו מצב מיוחד במסגרת התאוששות) החסימה נמשכת עד שהמכשיר עובר למצב העברה צדדית |
abstract
void
|
rebootIntoSideload()
הפעלה מחדש של המכשיר למצב התקנה ממקור לא ידוע ב-ADB (שימו לב: זהו מצב מיוחד במסגרת התאוששות) החסימה נמשכת עד שהמכשיר עובר למצב העברה צדדית |
abstract
void
|
rebootUntilOnline()
חלופה ל- |
abstract
void
|
rebootUntilOnline(String reason)
חלופה ל- |
abstract
void
|
rebootUserspace()
הפעלה מחדש של החלק של המכשיר שמשויך למרחב המשתמש בלבד. |
abstract
void
|
rebootUserspaceUntilOnline()
חלופה ל- |
abstract
void
|
remountSystemReadOnly()
להגדיר את מחיצת המערכת במכשיר כמחיצה לקריאה בלבד. |
abstract
void
|
remountSystemWritable()
מגדירים את מחיקת המערכת במכשיר כניתנת לכתיבה. |
abstract
void
|
remountVendorReadOnly()
להגדיר את המחיצה של הספק במכשיר כמחיצה לקריאה בלבד. |
abstract
void
|
remountVendorWritable()
מגדירים את מחיקת הספק במכשיר כמחיצה לכתיבה. |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
שיטה נוחה לביצוע |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
הרצת בדיקות של מכשירי מדידה, ותיקון מכשירי Android. |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
זהה ל- |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
זהה ל- |
abstract
void
|
setDate(Date date)
הגדרת התאריך במכשיר הערה: כדי להגדיר תאריך במכשיר, צריך הרשאת root |
abstract
void
|
setOptions(TestDeviceOptions options)
הגדרת |
abstract
boolean
|
setProperty(String propKey, String propValue)
הגדרת ערך המאפיין במכשיר. |
abstract
void
|
setRecovery(IDeviceRecovery recovery)
מגדירים את |
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' (שימו לב שזה שונה מ- |
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 abstractgetBootHistory ()
שיטת העזר אוספת את המפה של היסטוריית האתחול עם זמן האתחול והסיבה לאתחול.
החזרות | |
---|---|
|
מפה של זמן האתחול (שעון UTC בשניות מאז תחילת הזמן) ושל הסיבה לאתחול |
זריקות | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
public abstractgetBootHistorySince (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.
הוא פועל בשני מצבים:
TestDeviceOptions.getMaxLogcatDataSize()
בייטים מהתוכן הנוכחי של התיעוד של ה-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 abstractgetMountPointInfo ()
הפונקציה מחזירה גרסה מנותחת של המידע שב-/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 abstractgetTombstones ()
אחזור של רשימת המכשירים מהמכשירים והחזרתה. נדרשת הרשאת 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. |