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
מאז תחילת התקופה של ההגדרה,
מהמכשיר ומ- |
abstract
boolean
|
disableAdbRoot()
משבית את שורש adb. |
abstract
boolean
|
doesFileExist(String deviceFilePath)
שיטה עוזרת לקבוע אם קובץ קיים במכשיר. |
abstract
boolean
|
enableAdbRoot()
הפעלת השורש של adb. |
abstract
String
|
executeAdbCommand(long timeout, String... commandArgs)
שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה. |
abstract
String
|
executeAdbCommand(String... commandArgs)
שיטת עזרה שמבצעת פקודת adb כפקודת מערכת. |
abstract
String
|
executeAdbCommand(long timeout,
שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה. |
abstract
CommandResult
|
executeFastbootCommand(long timeout, String... commandArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת. |
abstract
CommandResult
|
executeFastbootCommand(String... commandArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת, עם זמן קצוב לתפוגה של 2 דקות כברירת מחדל. |
abstract
CommandResult
|
executeLongFastbootCommand(String... commandArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) כפקודת מערכת. |
abstract
CommandResult
|
executeLongFastbootCommand(
שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) בהרצה ארוכה כפקודת מערכת עם משתני סביבה של המערכת. |
abstract
String
|
executeShellCommand(String command)
שיטת עזרה שמפעילה פקודת מעטפת מסוג adb ומחזירה את הפלט בתור |
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 ומחזירה את התוצאות בתור |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור |
abstract
CommandResult
|
executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
abstract
CommandResult
|
executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
abstract
CommandResult
|
fastbootWipePartition(String partition)
שיטה לעזרה באיפוס המחיצה של המכשיר. |
abstract
int
|
getApiLevel()
מאתרים את רמת ה-API של המכשיר. |
abstract
String
|
getBasebandVersion()
שיטת הנוחות לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה. |
abstract
Integer
|
getBattery()
מחזירה את רמת הטעינה הנוכחית של הסוללה של מכשיר או את הערך Null אם רמת הסוללה לא זמינה. |
abstract
boolean
|
getBooleanProperty(String name, boolean defaultValue)
מחזירה ערך בוליאני של המאפיין הנתון. |
abstract
|
getBootHistory()
תכונת העזרה אוספת את המפה של היסטוריית האתחול עם זמן האתחול וסיבת האתחול. |
abstract
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
שיטת העזרה אוספת את מפת היסטוריית האתחול עם זמן האתחול וסיבת האתחול מאז הזמן הנתון מאז תחילת השימוש במכשיר ויחידת הזמן שצוינה. |
abstract
String
|
getBootloaderVersion()
שיטת נוחות לקבלת גרסת תוכנת האתחול של המכשיר הזה. |
abstract
String
|
getBuildAlias()
מאחזרים את הכינוי של ה-build שהמכשיר פועל כרגע. |
abstract
String
|
getBuildFlavor()
מאחזרים את גרסת ה-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 mode). |
abstract
String
|
getFastbootProductVariant()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode). |
abstract
String
|
getFastbootSerialNumber()
מחזירה את המספר הסידורי של מצב אתחול מהיר (fastboot). |
abstract
String
|
getFastbootVariable(String variableName)
מאחזרים את הערך הנתון של משתנה אתחול מהיר מהמכשיר. |
abstract
IFileEntry
|
getFileEntry(String path)
אחזור קובץ עזר לקובץ מרוחק במכשיר. |
abstract
IDevice
|
getIDevice()
הפונקציה מחזירה הפניה ל-ddmlib |
abstract
long
|
getIntProperty(String name, long defaultValue)
מחזירה ערך מספר שלם של המאפיין הנתון מהמכשיר. |
abstract
long
|
getLastExpectedRebootTimeMillis()
הפונקציה מחזירה את הפעם האחרונה שבה ממשקי API של Tradeified הפעילו הפעלה מחדש באלפיות השנייה, מאז 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/Loads במכשיר |
abstract
long
|
getPartitionFreeSpace(String partition)
שיטה שעוזרת לקבוע את נפח האחסון הפנוי במחיצה במכשיר. |
abstract
ProcessInfo
|
getProcessByName(String processName)
שיטת ה-Assistant מריצה את הפקודות 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 במקרה של שגיאה פנימית |
abstract
boolean
|
getUseFastbootErase()
בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר. |
abstract
boolean
|
isAdbRoot()
|
abstract
boolean
|
isAdbTcp()
|
abstract
boolean
|
isAppEnumerationSupported()
בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות |
abstract
boolean
|
isBypassLowTargetSdkBlockSupported()
בדיקה אם הפלטפורמה במכשיר תומכת בעקיפת חסימת SDK עם יעדים נמוכים בהתקנות של אפליקציות |
abstract
boolean
|
isDebugfsMounted()
בודקים אם רכיבי ניפוי הבאגים טענו. |
abstract
boolean
|
isDeviceEncrypted()
הפונקציה מחזירה אם המכשיר מוצפן. |
abstract
boolean
|
isDirectory(String deviceFilePath)
פונקציה זו מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה. אחרת, הערך false. |
abstract
boolean
|
isEncryptionSupported()
הפונקציה מחזירה אם המכשיר תומך בהצפנה. |
abstract
boolean
|
isExecutable(String fullPath)
הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ להפעלה. אחרת, False. |
abstract
boolean
|
isHeadless()
פונקציה זו מחזירה את הערך true אם המכשיר ללא GUI (ללא מסך). אחרת, הערך 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()
טעינת ניפוי באגים. |
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()
הפעלת המכשיר מחדש במצב adbrecovery. |
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,
מריץ בדיקות אינסטרומנטציה ומספק שחזור מכשיר. |
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
|
setUseFastbootErase(boolean useFastbootErase)
הגדרה אם להשתמש בפורמט מחיקה של אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי לאפס מחיצה במכשיר. |
abstract
void
|
startLogcat()
התחלת הצילום של פלט Logcat מהמכשיר ברקע. |
abstract
void
|
stopEmulatorOutput()
סוגרים את הפלט של האמולטור ומוחקים אותו. |
abstract
void
|
stopLogcat()
הפסקת התיעוד של פלט ה-Logcat מהמכשיר ומחיקת נתוני ה-Logcat שנשמרו. |
abstract
String
|
switchToAdbTcp()
העברת המכשיר למצב adb-over-tcp. |
abstract
boolean
|
switchToAdbUsb()
העברת המכשיר למצב adb על גבי USB. |
abstract
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
סנכרון מצטבר של התוכן של ספריית קבצים מקומית למכשיר. |
abstract
boolean
|
unlockDevice()
ביטול נעילת המכשיר אם המכשיר במצב מוצפן. |
abstract
void
|
unmountDebugfs()
ניתוק של ניפוי באגים. |
abstract
boolean
|
waitForBootComplete(long timeOut)
הפעולה תיחסם עד שתגדירו את התכונה הניסיונית להשלמת ההפעלה של המכשיר. |
abstract
boolean
|
waitForDeviceAvailable()
בהמתנה עד שהמכשיר יגיב וזמין לבדיקה. |
abstract
boolean
|
waitForDeviceAvailable(long waitTime)
בהמתנה עד שהמכשיר יגיב וזמין לבדיקה. |
abstract
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
בהמתנה עד שהמכשיר יגיב וזמין בלי להביא בחשבון את נתיב השחזור. |
abstract
void
|
waitForDeviceBootloader()
חסימה עד שניתן לראות את המכשיר באמצעות אתחול מהיר (fastboot). |
abstract
boolean
|
waitForDeviceInRecovery(long waitTime)
חסימת המכשיר למצב 'שחזור adb' (שים לב לכך שהוא שונה מ-
|
abstract
boolean
|
waitForDeviceInSideload(long waitTime)
חסימה כדי שהמכשיר יהיה במצב 'adb offload' |
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 (0xffff)
שיטות ציבוריות
checkApiLevelAgainstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
לבדוק אם תכונה מסוימת נתמכת כרגע בהינתן רמה מינימלית של תמיכה. השיטה הזו מביאה בחשבון תכונות שעדיין לא פורסמו, לפני ההעלאה של רמת ה-API.
פרמטרים | |
---|---|
strictMinLevel |
int : הרמה המינימלית המחמירה שתומכת בתכונה הזו. |
החזרות | |
---|---|
boolean |
הערך הוא True אם הרמה נתמכת. אחרת, שקרית. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
ניקוי הרישום ביומן
public abstract void clearLogcat ()
מחיקת כל נתוני ה-Logcat שהצטברו.
האפשרות הזו שימושית במקרים שבהם רוצים לוודא ש-ITestDevice#getLogcat()
יחזיר רק נתוני יומן שהופקו לאחר נקודה מסוימת (למשל, אחרי שדרוג של build חדש של מכשיר וכו').
DeleteFile
public abstract void deleteFile (String deviceFilePath)
שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
פרמטרים | |
---|---|
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
DeleteFile
public abstract void deleteFile (String deviceFilePath, int userId)
שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
פרמטרים | |
---|---|
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר. |
userId |
int : מזהה המשתמש שממנו רוצים למחוק |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
המכשיר הופעל מחדש
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.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
מכשירSoftאתחול מאז
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
שיטה של עוזרת לבדוק אם המכשיר הופעל מחדש מאז זמן UTC
מאז תחילת התקופה של ההגדרה,
מהמכשיר ומ-ERROR(/TimeUnit)
. הפעלה מחדש עם יכולת שחזור מתייחסת להפעלה מחדש של system_server מחוץ
להפעלה קשיחה של המכשיר (לדוגמה: נשלחה בקשה להפעלה מחדש). ניתן לקבל את ה-utcEpochTime של המכשיר הנוכחי
ב-Miliseccond בשיטה getDeviceDate()
.
פרמטרים | |
---|---|
utcEpochTime |
long : זמן המכשיר בשנייה מאז תחילת התקופה. |
timeUnit |
TimeUnit : יחידת הזמן TimeUnit של utcEpochTime הנתון. |
החזרות | |
---|---|
boolean |
true אם המכשיר הופעל מחדש |
קליעות | |
---|---|
RuntimeException |
אם יש במכשיר סיבה להפעלה חריגה |
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
השבתתAdbRoot
public abstract boolean disableAdbRoot ()
משבית את שורש adb.
השבתה של adb root עשויה לגרום לניתוק המכשיר מ-adb. השיטה הזו תיחסם עד שהמכשיר יהיה זמין.
החזרות | |
---|---|
boolean |
true אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
DoFileExist
public abstract boolean doesFileExist (String deviceFilePath)
שיטה עוזרת לקבוע אם קובץ קיים במכשיר.
פרמטרים | |
---|---|
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר לבדיקה |
החזרות | |
---|---|
boolean |
true אם הקובץ קיים, אחרת false . |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
הפעלתAdbRoot
public abstract boolean enableAdbRoot ()
הפעלת השורש של adb. אם ההגדרה Enable-root היא False, תופיע הודעה ביומן ותוחזר בלי להפעיל Root.
הפעלה של ברמה הבסיסית (root) עשויה לגרום לניתוק המכשיר מ-adb. השיטה הזו תיחסם עד שהמכשיר יהיה זמין.
החזרות | |
---|---|
boolean |
true אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
PerformanceAdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
ככל האפשר, מומלץ להשתמש ב-executeShellCommand(String)
במקום זאת, כי
השיטה הזו משפרת את זיהוי הכשלים והביצועים.
פרמטרים | |
---|---|
timeout |
long : הזמן באלפיות השנייה לפני שהמכשיר נחשב ללא תגובה, 0L ללא זמן קצוב לתפוגה |
commandArgs |
String : פקודת ה-adb והארגומנטים להרצה |
החזרות | |
---|---|
String |
את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
PerformanceAdbCommand
public abstract String executeAdbCommand (String... commandArgs)
שיטת עזרה שמבצעת פקודת adb כפקודת מערכת.
ככל האפשר, מומלץ להשתמש ב-executeShellCommand(String)
במקום זאת, כי
השיטה הזו משפרת את זיהוי הכשלים והביצועים.
פרמטרים | |
---|---|
commandArgs |
String : פקודת ה-adb והארגומנטים להרצה |
החזרות | |
---|---|
String |
את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
PerformanceAdbCommand
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
ככל האפשר, מומלץ להשתמש ב-executeShellCommand(String)
במקום זאת, כי
השיטה הזו משפרת את זיהוי הכשלים והביצועים.
פרמטרים | |
---|---|
timeout |
long : הזמן באלפיות השנייה לפני שהמכשיר נחשב ללא תגובה, 0L ללא זמן קצוב לתפוגה |
envMap |
: הסביבה להגדרה לפקודה |
commandArgs |
String : פקודת ה-adb והארגומנטים להרצה |
החזרות | |
---|---|
String |
את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
הפעלה מהירה אתחול פקודה
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת.
אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).
פרמטרים | |
---|---|
timeout |
long : הזמן באלפיות השנייה לפני שהתוקף של הפקודה פג |
commandArgs |
String : הפקודה 'אתחול מהיר' והארגומנטים להרצה |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
הפעלה מהירה אתחול פקודה
public abstract CommandResult executeFastbootCommand (String... commandArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת, עם זמן קצוב לתפוגה של 2 דקות כברירת מחדל.
אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).
פרמטרים | |
---|---|
commandArgs |
String : הפקודה 'אתחול מהיר' והארגומנטים להרצה |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
הפעלת לונגבאתחול מהיר
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) כפקודת מערכת.
זהה ל-executeFastbootCommand(String)
, אבל הזמן הקצוב לתפוגה יהיה ארוך יותר.
פרמטרים | |
---|---|
commandArgs |
String : הפקודה 'אתחול מהיר' והארגומנטים להרצה |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
הפעלת לונגבאתחול מהיר
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) בהרצה ארוכה כפקודת מערכת עם משתני סביבה של המערכת.
זהה ל-executeFastbootCommand(String)
, אבל הזמן הקצוב לתפוגה יהיה ארוך יותר.
פרמטרים | |
---|---|
envVarMap |
: משתני סביבת המערכת שבהם רצה פקודת האתחול המהיר |
commandArgs |
String : הפקודה 'אתחול מהיר' והארגומנטים להרצה |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
ביצועShellCommand
public abstract String executeShellCommand (String command)
שיטת עזרה שמפעילה פקודת מעטפת מסוג adb ומחזירה את הפלט בתור String
.
פרמטרים | |
---|---|
command |
String : פקודת המעטפת adb להרצה |
החזרות | |
---|---|
String |
הפלט של המעטפת |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
ביצועShellCommand
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 : מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת הפעלה של retryAttempts
ללא הצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
ביצועShellCommand
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 : מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת
retryAttempts ללא הצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
ביצועShellCommand
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 |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
offsetShellV2Command
public abstract CommandResult executeShellV2Command (String command)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult
, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
פרמטרים | |
---|---|
command |
String : הפקודה שצריך להריץ. |
החזרות | |
---|---|
CommandResult |
התוצאה בCommandResult . |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
offsetShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult
, מאוכלסות כראוי בפלט של סטטוס הפקודה ו-stderr. stdout מופנה אל הסטרימינג שצוין.
פרמטרים | |
---|---|
command |
String : הפקודה שצריך להריץ. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) כאשר פלט ה-std יופנה מחדש, או null. |
החזרות | |
---|---|
CommandResult |
התוצאה בCommandResult . |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
offsetShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult
, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
פרמטרים | |
---|---|
command |
String : הפקודה שצריך להריץ. |
pipeAsInput |
File : ERROR(/File) שיועבר כקלט לפקודה, או שהוא null. |
החזרות | |
---|---|
CommandResult |
התוצאה בCommandResult . |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
offsetShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
פרמטרים | |
---|---|
command |
String : פקודת המעטפת adb להרצה |
maxTimeoutForCommand |
long : הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה; היחידה כפי שצוין ב-timeUnit |
timeUnit |
TimeUnit : יחידה עבור maxTimeToOutputShellResponse |
retryAttempts |
int : מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת
retryAttempts ללא הצלחה. |
החזרות | |
---|---|
CommandResult |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
למידע נוסף:
offsetShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
פרמטרים | |
---|---|
command |
String : פקודת המעטפת adb להרצה |
maxTimeoutForCommand |
long : הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה; היחידה כפי שצוין ב-timeUnit |
timeUnit |
TimeUnit : יחידה עבור maxTimeToOutputShellResponse |
החזרות | |
---|---|
CommandResult |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
למידע נוסף:
offsetShellV2Command
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 : מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת
retryAttempts ללא הצלחה. |
החזרות | |
---|---|
CommandResult |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
למידע נוסף:
offsetShellV2Command
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) שאליו תתבצע הפניה אוטומטית של שגיאת ה-std, או הערך null. |
maxTimeoutForCommand |
long : הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה; היחידה כפי שצוין ב-timeUnit |
timeUnit |
TimeUnit : יחידה עבור maxTimeToOutputShellResponse |
retryAttempts |
int : מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב חריגה. המערכת תפסול את DeviceNotResponseError אם מתבצעת
retryAttempts ללא הצלחה. |
החזרות | |
---|---|
CommandResult |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
למידע נוסף:
מחיצה לאתחול מהיר (fastbootWipePartition)
public abstract CommandResult fastbootWipePartition (String partition)
שיטה לעזרה באיפוס המחיצה של המכשיר.
אם הערך של getUseFastbootErase()
הוא true
, תתבצע מחיקה של אתחול מהיר כדי לאפס את המחיצה. לאחר מכן, המכשיר צריך ליצור מערכת קבצים בפעם הבאה שהמכשיר יופעל.
אחרת, ייעשה שימוש בפורמט אתחול מהיר (fastboot) שיצור מערכת קבצים חדשה במכשיר.
אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).
פרמטרים | |
---|---|
partition |
String : המחיצה שרוצים לאפס |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
getApiLevel"
public abstract int getApiLevel ()
מאתרים את רמת ה-API של המכשיר. ברירת המחדל היא UNKNOWN_API_LEVEL
.
החזרות | |
---|---|
int |
מספר שלם שמציין את רמת ה-API של המכשיר |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
גרסת getBaseband
public abstract String getBasebandVersion ()
שיטת הנוחות לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה. כשמשיגים את גרסת הרדיו, היא ספציפית למכשיר, כך שיכול להיות שהיא לא תחזיר את המידע הנכון לכל המכשירים. השיטה הזו מסתמכת על הנכס gsm.version.baseband כדי להחזיר את פרטי הגרסה הנכונים.
המידע הזה לא מדויק במכשירי CDMA מסוימים, ויכול להיות שהגרסה שמוחזרת כאן לא תואמת
לגרסה שדווחה מהאתחול המהיר, ויכול להיות שלא תחזיר את הגרסה של רדיו CDMA.
אמ;לק: השיטה הזו מדווחת על גרסה מדויקת רק אם המאפיין gsm.version.baseband זהה לגרסה שהוחזרה על ידי fastboot getvar version-baseband
.
החזרות | |
---|---|
String |
גרסת פס הבסיס String או null אם לא ניתן לקבוע
(לא ניתן לקרוא במכשיר את מחרוזת הרדיו או את מחרוזת הגרסה) |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
הורדת הסוללה
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 |
getBootHistoryHistory
public abstractgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
שיטת העזרה אוספת את מפת היסטוריית האתחול עם זמן האתחול וסיבת האתחול מאז הזמן הנתון מאז תחילת השימוש במכשיר ויחידת הזמן שצוינה. ניתן להשיג את ה-utcEpochTime של המכשיר הנוכחי
באלפיות שנייה באמצעות השיטה getDeviceDate()
.
פרמטרים | |
---|---|
utcEpochTime |
long : הזמן שמוגדר במכשיר מאז Epoch. |
timeUnit |
TimeUnit : יחידת הזמן TimeUnit . |
החזרות | |
---|---|
|
מפה של זמן האתחול (זמן UTC בשנייה מאז נקודת ההתחלה) וסיבת האתחול |
קליעות | |
---|---|
DeviceNotAvailableException |
גרסה getBootloaderVersion
public abstract String getBootloaderVersion ()
שיטת נוחות לקבלת גרסת תוכנת האתחול של המכשיר הזה.
יתבצע ניסיון לאחזר את גרסת תוכנת האתחול מהמצב הנוכחי של המכשיר. (לדוגמה, אם המכשיר נמצא במצב אתחול מהיר (fastboot), יתבצע ניסיון לאחזר את הגרסה מאתחול מהיר)
החזרות | |
---|---|
String |
גרסת תוכנת האתחול String או null אם לא ניתן למצוא אותה |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
getBuildAlias
public abstract String getBuildAlias ()
מאחזרים את הכינוי של ה-build שהמכשיר פועל כרגע.
כינוי Build הוא בדרך כלל מחרוזת קריאה יותר מאשר מזהה ה-build (בדרך כלל מספר לגרסאות build של Nexus). לדוגמה, לגרסה הסופית של Android 4.2 יש את הכינוי JDQ39 ואת מזהה ה-build 573038
החזרות | |
---|---|
String |
כינוי ה-build או חזרה למזהה ה-build אם לא ניתן לאחזר אותו |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getBuildFlavor
public abstract String getBuildFlavor ()
מאחזרים את גרסת ה-build של המכשיר.
החזרות | |
---|---|
String |
טעם ה-build או אפס אם לא ניתן לאחזר אותו |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getBuildId
public abstract String getBuildId ()
מאחזרים את גרסת ה-build שהמכשיר פועל כרגע.
החזרות | |
---|---|
String |
מזהה ה-build או IBuildInfo#UNKNOWN_BUILD_ID אם לא ניתן לאחזר אותו |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getBuildSigningKeys
public abstract String getBuildSigningKeys ()
פונקציה זו מחזירה את סוג המפתח המשמש לחתימה על תמונת המכשיר
בדרך כלל, מכשירי Android חתומים על ידי מפתחות בדיקה (כמו ב-AOSP) או באמצעות מפתחות הפצה (שנשלטים על ידי יצרני מכשירים נפרדים)
החזרות | |
---|---|
String |
מפתח החתימה אם הוא נמצא. אחרת, הוא null. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
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.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getConnection
public abstract AbstractConnection getConnection ()
הפונקציה מחזירה את החיבור שמשויך למכשיר.
החזרות | |
---|---|
AbstractConnection |
getDeviceClass
public abstract String getDeviceClass ()
מקבלים את סיווג המכשיר.
החזרות | |
---|---|
String |
סיווג המכשיר String . |
getDeviceDate
public abstract long getDeviceDate ()
החזרת התאריך של המכשיר באלפיות השנייה מאז נקודת ההתחלה.
החזרות | |
---|---|
long |
את התאריך של המכשיר בפורמט תקופה של זמן מערכת. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor ()
צריך להחזיר DeviceDescriptor
מפרטי המכשיר כדי לקבל מידע עליו בלי
להעביר את האובייקט של המכשיר.
החזרות | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
צריך להחזיר DeviceDescriptor
מפרטי המכשיר כדי לקבל מידע עליו בלי
להעביר את האובייקט של המכשיר.
פרמטרים | |
---|---|
shortDescriptor |
boolean : האם להגביל את התיאור למידע מינימלי בלבד |
החזרות | |
---|---|
DeviceDescriptor |
getDeviceState
public abstract TestDeviceState getDeviceState ()
מאתרים את מצב המכשיר.
החזרות | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
עוזר לקבל את הפרש הזמנים בין המכשיר לבין ERROR(/Date)
נתון. שימוש ב-Epoch Time באופן פנימי.
פרמטרים | |
---|---|
date |
Date |
החזרות | |
---|---|
long |
ההבדל באלפיות השנייה |
קליעות | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public abstract InputStreamSource getEmulatorOutput ()
מקבלים את הסטרימינג של האמולטור stdout ו-stderr
החזרות | |
---|---|
InputStreamSource |
הפלט של האמולטור |
getExternalStoreFreeSpace
public abstract long getExternalStoreFreeSpace ()
שיטה שעוזרת לקבוע את נפח האחסון הפנוי באחסון החיצוני של המכשיר.
החזרות | |
---|---|
long |
כמות השטח הפנוי ב-KB |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
getFastbootProductType
public abstract String getFastbootProductType ()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
יש להשתמש בשיטה הזו רק אם המכשיר צריך להפעיל אתחול מהיר (fastboot). במקרה הזה, זו וריאציה קצת יותר בטוחה
מהשיטה הכללית getProductType()
, כי ITestDevice
ילמדו לשחזר את המכשיר במסגרת אתחול מהיר אם המכשיר במצב שגוי או
לא מגיב.
החזרות | |
---|---|
String |
השם של סוג המוצר String או null אם לא ניתן לקבוע |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
יש להשתמש בשיטה הזו רק אם המכשיר צריך להפעיל אתחול מהיר (fastboot). במקרה הזה, זו וריאציה קצת יותר בטוחה
מהשיטה הכללית getProductType()
, כי ITestDevice
ילמדו לשחזר את המכשיר במסגרת אתחול מהיר אם המכשיר במצב שגוי או
לא מגיב.
החזרות | |
---|---|
String |
השם של סוג המוצר String או null אם לא ניתן לקבוע |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
getFastbootSeriesNumber
public abstract String getFastbootSerialNumber ()
מחזירה את המספר הסידורי של מצב אתחול מהיר (fastboot).
החזרות | |
---|---|
String |
getFastbootVariable
public abstract String getFastbootVariable (String variableName)
מאחזרים את הערך הנתון של משתנה אתחול מהיר מהמכשיר.
פרמטרים | |
---|---|
variableName |
String : שם המשתנה |
החזרות | |
---|---|
String |
ערך הנכס או null אם הוא לא קיים |
קליעות | |
---|---|
|
supportedOperationError |
DeviceNotAvailableException |
getFileEntry
public abstract IFileEntry getFileEntry (String path)
אחזור קובץ עזר לקובץ מרוחק במכשיר.
פרמטרים | |
---|---|
path |
String : נתיב הקובץ לאחזור. יכול להיות נתיב או נתיב מוחלטים ביחס ל-'/'. (כלומר, יש תמיכה בתחביר '/system' או 'system'). |
החזרות | |
---|---|
IFileEntry |
IFileEntry או null אם הקובץ path לא נמצא |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getIDevice
public abstract IDevice getIDevice ()
הפונקציה מחזירה הפניה ל-ddmlib IDevice
המשויך.
יכול להיות ש-DDMS יקצה ערך IDevice
חדש בכל פעם שהמכשיר יתנתק
ויתחבר מחדש מ-adb. לכן, המתקשרים לא צריכים לשמור הפניה אל IDevice
,
כי ההפניה הזו עלולה להפוך למיושנת.
החזרות | |
---|---|
IDevice |
IDevice |
getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
מחזירה ערך מספר שלם של המאפיין הנתון מהמכשיר.
פרמטרים | |
---|---|
name |
String : שם הנכס |
defaultValue |
long : ערך ברירת המחדל שיוחזר אם הנכס ריק או לא קיים. |
החזרות | |
---|---|
long |
ערך המאפיין או defaultValue אם המאפיין ריק, לא קיים או שאין לו ערך מסוג מספר שלם. |
קליעות | |
---|---|
DeviceNotAvailableException |
getLastExpectedDefaultTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
הפונקציה מחזירה את הפעם האחרונה שבה ממשקי API של Tradeified הפעילו הפעלה מחדש באלפיות השנייה, מאז EPOCH
כפי שהוחזר על ידי System.currentTimeMillis()
.
החזרות | |
---|---|
long |
getLaunchApiLevel
public abstract int getLaunchApiLevel ()
מקבלים את רמת ה-API הראשונה שהושקה במכשיר. ברירת המחדל היא UNKNOWN_API_LEVEL
.
החזרות | |
---|---|
int |
מספר שלם שמציין את רמת ה-API הראשונה של המכשיר שהושקה |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getLogcat
public abstract InputStreamSource getLogcat ()
תופסת רצף snapshot של נתוני ה-Logcat.
פועל בשני מצבים:
TestDeviceOptions.getMaxLogcatDataSize()
בייטים מהתוכן הנוכחי של לכידת ה-Logcat ברקע
החזרות | |
---|---|
InputStreamSource |
getLogcat
public abstract InputStreamSource getLogcat (int maxBytes)
תופס זרם של תמונת מצב של maxBytes
נתוני ה-Logcat שתועדו.
כדאי להשתמש באפשרות הזו במקרים שבהם רוצים לצלם תמונות מצב בתדירות גבוהה של נתוני ה-Logcat שתועדו, בלי לגבור על ההשלכות הפוטנציאליות על נפח אחסון בכונן של קבלת קובץ ה-snapshot של getLogcat()
.
פרמטרים | |
---|---|
maxBytes |
int : כמות הנתונים המקסימלית שצריך להחזיר. הסכום צריך להיות מספיק מקום לזיכרון |
החזרות | |
---|---|
InputStreamSource |
getLogcatDump
public abstract InputStreamSource getLogcatDump ()
אחזור של קובץ ה-Dump של ה-Logcat הנוכחי במכשיר. בניגוד ל-getLogcat()
, השיטה הזו תמיד תחזיר תמונת מצב סטטית של ה-Logcat.
החיסרון הוא ששום דבר לא יוחזר אם אי אפשר להשיג את המכשיר.
החזרות | |
---|---|
InputStreamSource |
InputStreamSource של נתוני ה-Logcat. אם הנתונים של Logcat לא ייקלטו,
מוחזר זרם ריק. |
getLogcatAfter
public abstract InputStreamSource getLogcatSince (long date)
יוצר זרם snapshot של נתוני Logcat שתועדו החל מהתאריך שצוין. השעה במכשיר
צריכה להיות getDeviceDate()
.
פרמטרים | |
---|---|
date |
long : באלפיות השנייה מאז תחילת התקופה של זמן ההפעלה של קובץ ה-snapshot ועד היום.
(אפשר לקבל את הערך הזה באמצעות 'date +%s') |
החזרות | |
---|---|
InputStreamSource |
getMountPoint
public abstract String getMountPoint (String mountName)
מחזירה נקודת טעינה.
שליחת שאילתות ישירות למכשיר אם המידע שנשמר במטמון ב-IDevice
לא זמין.
TODO: העברת ההתנהגות הזו אל IDevice#getMountPoint(String)
פרמטרים | |
---|---|
mountName |
String : השם של נקודת הטעינה |
החזרות | |
---|---|
String |
נקודת הטעינה או null |
למידע נוסף:
getMountPointInfo
public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
הפונקציה מחזירה ערך MountPointInfo
שתואם לנתיב של נקודת הטעינה שצוין, או
null
אם לנתיב הזה לא נטען שום דבר או אם הוא לא מופיע
ב- /proc/Loads כנקודת טעינה.
פרמטרים | |
---|---|
mountpoint |
String |
החזרות | |
---|---|
ITestDevice.MountPointInfo |
ERROR(/List) מתוך MountPointInfo שמכילים את המידע ב-"/proc/המחירs" |
קליעות | |
---|---|
DeviceNotAvailableException |
למידע נוסף:
getMountPointInfo
public abstractgetMountPointInfo ()
החזרת גרסה מנותחת של המידע ב- /proc/Loads במכשיר
החזרות | |
---|---|
|
ERROR(/List) מתוך MountPointInfo שמכילים את המידע ב-"/proc/המחירs" |
קליעות | |
---|---|
DeviceNotAvailableException |
getPartitionFreeSpace
public abstract long getPartitionFreeSpace (String partition)
שיטה שעוזרת לקבוע את נפח האחסון הפנוי במחיצה במכשיר.
פרמטרים | |
---|---|
partition |
String |
החזרות | |
---|---|
long |
כמות השטח הפנוי ב-KB |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
getProcessByName
public abstract ProcessInfo getProcessByName (String processName)
שיטת ה-Assistant מריצה את הפקודות pidof ו-stat ומחזירה אובייקט ProcessInfo
עם PID ושעת ההתחלה של התהליך של התהליך הנתון.
פרמטרים | |
---|---|
processName |
String : מחרוזת שם התהליך. |
החזרות | |
---|---|
ProcessInfo |
ProcessInfo שלProcessName הנתון |
קליעות | |
---|---|
DeviceNotAvailableException |
getProcessPid
public abstract String getProcessPid (String process)
מחזירה את ה-pid של השירות או את הערך null אם משהו השתבש.
פרמטרים | |
---|---|
process |
String : מחרוזת שם הפרויקט (proces). |
החזרות | |
---|---|
String |
קליעות | |
---|---|
DeviceNotAvailableException |
getProductType
public abstract String getProductType ()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה.
השיטה הזו תפעל אם המכשיר נמצא במצב adb או אתחול מהיר (fastboot).
החזרות | |
---|---|
String |
השם של סוג המוצר String . לא יהיה null |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ולא ניתן לשחזר אותו, או אם לא ניתן לקבוע את סוג המוצר |
getProductVariant
public abstract String getProductVariant ()
שיטה נוחות לקבלת וריאציית המוצר של המכשיר הזה.
השיטה הזו תפעל אם המכשיר נמצא במצב adb או אתחול מהיר (fastboot).
החזרות | |
---|---|
String |
השם של וריאציית המוצר String או null אם לא ניתן
לקבוע |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
getProperty
public abstract String getProperty (String name)
מאחזרים את ערך המאפיין הנתון מהמכשיר.
פרמטרים | |
---|---|
name |
String : שם הנכס |
החזרות | |
---|---|
String |
ערך הנכס או null אם הוא לא קיים |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getrecoveryMode
public abstract ITestDevice.RecoveryMode getRecoveryMode ()
משתמשים במצב השחזור הנוכחי של המכשיר.
החזרות | |
---|---|
ITestDevice.RecoveryMode |
מצב השחזור הנוכחי שמשמש את המכשיר. |
getSeriesNumber
public abstract String getSerialNumber ()
שיטת נוחות לקבלת המספר הסידורי של המכשיר הזה.
החזרות | |
---|---|
String |
המספר הסידורי String |
getTombstones
public abstractgetTombstones ()
מאחזרים את רשימת המצבות ומחזירים אותה מהמכשירים. נדרש שורש.
היא הטובה ביותר. לכן, אם שליפה של מצבה אחת מסיבה כלשהי תיכשל,
היא תיעלם ברשימה. רק DeviceNotAvailableException
תסיים את השיטה
מוקדם יותר.
החזרות | |
---|---|
|
רשימה של קובצי מצבות, ריקים אם אין מצבה. |
קליעות | |
---|---|
DeviceNotAvailableException |
למידע נוסף:
getTotalMemory
public abstract long getTotalMemory ()
פונקציה זו מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים או -1 במקרה של שגיאה פנימית
החזרות | |
---|---|
long |
getUseFastbootdelete
public abstract boolean getUseFastbootErase ()
בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר.
החזרות | |
---|---|
boolean |
true אם תתבצע מחיקה של אתחול מהיר (fastboot), או false אם ייעשה שימוש בפורמט אתחול מהיר (fastboot). |
למידע נוסף:
isAdbRoot
public abstract boolean isAdbRoot ()
החזרות | |
---|---|
boolean |
true אם המכשיר נמצא כרגע ברמה הבסיסית (root) של adb, אחרת false . |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
isAdbTcp
public abstract boolean isAdbTcp ()
החזרות | |
---|---|
boolean |
true אם המכשיר מחובר ל-adb-over-tcp, אחרת false . |
isAppEnumeration נתמך
public abstract boolean isAppEnumerationSupported ()
בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
החזרות | |
---|---|
boolean |
True אם יש תמיכה בספירת אפליקציות, FALSE אם לא יש תמיכה בספירת אפליקציות |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public abstract boolean isBypassLowTargetSdkBlockSupported ()
בדיקה אם הפלטפורמה במכשיר תומכת בעקיפת חסימת SDK עם יעדים נמוכים בהתקנות של אפליקציות
החזרות | |
---|---|
boolean |
הערך הוא True אם יש תמיכה בעקיפה של חסימת SDK עם יעדים נמוכים, אחרת הערך False |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
isDebugfsMounted
public abstract boolean isDebugfsMounted ()
בודקים אם רכיבי ניפוי הבאגים טענו.
החזרות | |
---|---|
boolean |
true אם רכיבי ניפוי הבאגים נטענים |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
isDeviceEncrypt
public abstract boolean isDeviceEncrypted ()
הפונקציה מחזירה אם המכשיר מוצפן.
החזרות | |
---|---|
boolean |
true אם המכשיר מוצפן. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
הוא ספרייה
public abstract boolean isDirectory (String deviceFilePath)
פונקציה זו מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה. אחרת, הערך false.
פרמטרים | |
---|---|
deviceFilePath |
String |
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
isEncryptionsupported
public abstract boolean isEncryptionSupported ()
הפונקציה מחזירה אם המכשיר תומך בהצפנה.
החזרות | |
---|---|
boolean |
true אם המכשיר תומך בהצפנה. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
ניתן להפעלה
public abstract boolean isExecutable (String fullPath)
הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ להפעלה. אחרת, False.
פרמטרים | |
---|---|
fullPath |
String |
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
ללא GUI
public abstract boolean isHeadless ()
פונקציה זו מחזירה את הערך true אם המכשיר ללא GUI (ללא מסך). אחרת, הערך false.
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
נתמך
public abstract boolean isRuntimePermissionSupported ()
בדיקה אם הפלטפורמה במכשיר תומכת בהענקת הרשאות בתחילת ההפעלה
החזרות | |
---|---|
boolean |
הערך הוא True אם יש תמיכה בהרשאה בתחילת ההפעלה, או FALSE אם יש תמיכה בהרשאה. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
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(). |
טעינת ניפוי באגים
public abstract void mountDebugfs ()
טעינת ניפוי באגים.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
ללא חסימה מחדש
public abstract void nonBlockingReboot ()
יוצר פקודה להפעלה מחדש של המכשיר וחוזרת אחרי שהפקודה הושלמה וכשהמכשיר כבר לא גלוי ל-adb.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
הגדרת PostBoot
public abstract void postBootSetup ()
יש לפעול לפי ההוראות להגדרת המכשיר כדי לבדוק אותו לאחר כל הפעלה.
צריכה להתבצע קריאה אחרי שהמכשיר מופעל/זמין באופן מלא
בנסיבות רגילות אין צורך לקרוא לשיטה הזו באופן מפורש, כי הטמעות אמורות לבצע את השלבים האלה באופן אוטומטי כשמבצעים הפעלה מחדש.
המקרים שבהם צריך לקרוא לאפליקציה היא כשהמכשיר מופעל מחדש עקב אירועים אחרים (למשל, לאחר השלמת פקודת עדכון מהיר)
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
postInvocationTearDown
public void postInvocationTearDown ()
השיטה הזו הוצאה משימוש.
במקומו צריך להשתמש ב-postInvocationTearDown(Throwable)
.
שלבים נוספים לניקוי הנדרש הספציפי למכשיר, שיבוצעו לאחר ההפעלה.
postInvocationTearDown
public abstract void postInvocationTearDown (Throwable invocationException)
שלבים נוספים לניקוי הנדרש הספציפי למכשיר, שיבוצעו לאחר ההפעלה.
פרמטרים | |
---|---|
invocationException |
Throwable : אם יש כזה, החריג האחרון שגרם לכשל בהפעלה. |
הגדרת הפעלה מראש
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
שלבים נוספים להגדרה נדרשת ספציפית למכשיר שיבוצעו במכשיר לפני תהליך ההפעלה.
פרמטרים | |
---|---|
info |
IBuildInfo : ה-IBuildInfo של המכשיר. |
attributes |
MultiMap : המאפיינים שמאוחסנים בהקשר של ההפעלה |
קליעות | |
---|---|
|
com.android.tradefed.targetprep.TargetSetupError |
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
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 |
אם המכשיר לא זמין לאחר ההפעלה מחדש |
הפעלה מחדש של IntoBootloader
public abstract void rebootIntoBootloader ()
הפעלת המכשיר מחדש במצב תוכנת אתחול.
חסימה עד שהמכשיר יהיה במצב תוכנת אתחול.
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
הפעלה מחדש שלIntoFastbootd
public abstract void rebootIntoFastbootd ()
הפעלת המכשיר מחדש במצב אתחול מהיר (fastbootd).
חסימה עד שהמכשיר יופעל במצב אתחול מהיר (fastbootd).
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
הפעלה מחדש של התאוששות מאסון
public abstract void rebootIntoRecovery ()
הפעלת המכשיר מחדש במצב adbrecovery.
חסימה עד שהמכשיר יעבור לשחזור
קליעות | |
---|---|
DeviceNotAvailableException |
אם המכשיר לא זמין לאחר ההפעלה מחדש |
הפעלה מחדש של IntoSideload
public abstract void rebootIntoSideload (boolean autoReboot)
הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור)
הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע
פרמטרים | |
---|---|
autoReboot |
boolean : האם להפעיל מחדש את המכשיר באופן אוטומטי לאחר טעינה ממקור לא ידוע |
קליעות | |
---|---|
DeviceNotAvailableException |
אם המכשיר לא נמצא בהתקנה ממקור לא ידוע לאחר הפעלה מחדש |
הפעלה מחדש של IntoSideload
public abstract void rebootIntoSideload ()
הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור)
הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע
קליעות | |
---|---|
DeviceNotAvailableException |
אם המכשיר לא נמצא בהתקנה ממקור לא ידוע לאחר הפעלה מחדש |
הפעלה מחדש עדאונליין
public abstract void rebootUntilOnline ()
חלופה ל-reboot()
שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
קליעות | |
---|---|
DeviceNotAvailableException |
אם המכשיר לא זמין לאחר ההפעלה מחדש |
הפעלה מחדש עדאונליין
public abstract void rebootUntilOnline (String reason)
חלופה ל-reboot()
שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
פרמטרים | |
---|---|
reason |
String : הסיבה להפעלה מחדש, או null אם לא צוינה סיבה. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם המכשיר לא זמין לאחר ההפעלה מחדש |
למידע נוסף:
substituteUserspace
public abstract void rebootUserspace ()
מופעלת מחדש רק חלק של מרחב המשתמשים במכשיר.
החסימה תיחסם עד שהמכשיר יהיה זמין.
אזהרה. ההפעלה מחדש של מרחב המשתמשים נמצאת כרגע בפיתוח פעיל. השימוש בה הוא באחריותך בלבד.
קליעות | |
---|---|
DeviceNotAvailableException |
אם המכשיר לא זמין לאחר ההפעלה מחדש |
מחדשים UserspaceBeforeOnline
public abstract void rebootUserspaceUntilOnline ()
חלופה ל-rebootUserspace()
()} שחוסמת רק עד שהמכשיר מחובר לאינטרנט,
כלומר גלוי ל-adb.
קליעות | |
---|---|
DeviceNotAvailableException |
אם המכשיר לא זמין לאחר ההפעלה מחדש |
reloadSystemReadOnly
public abstract void remountSystemReadOnly ()
להגדיר את מחיצת המערכת במכשיר לקריאה בלבד. ייתכן שהמכשיר יופעל מחדש.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
ל-reloadSystemWritable
public abstract void remountSystemWritable ()
הגדרת מחיצת המערכת במכשיר לניתנת לכתיבה. ייתכן שהמכשיר יופעל מחדש.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
טעינה מחדש של ספק קריאה בלבד
public abstract void remountVendorReadOnly ()
מגדירים את מחיצת הספק במכשיר לקריאה בלבד. ייתכן שהמכשיר יופעל מחדש.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
ספק טעינה מחדש
public abstract void remountVendorWritable ()
מגדירים את מחיצת הספק במכשיר לניתנת לכתיבה. ייתכן שהמכשיר יופעל מחדש.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
בדיקות runInstrumentationTest
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
שיטת נוחות לביצוע ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
עם אוזן אחד או יותר שמועבר כפרמטרים.
פרמטרים | |
---|---|
runner |
IRemoteAndroidTestRunner : ה-IRemoteAndroidTestRunner שמריץ את הבדיקות |
listeners |
ITestLifeCycleReceiver : המאזינים לתוצאת הבדיקה |
החזרות | |
---|---|
boolean |
true אם פקודת הבדיקה הושלמה. false אם הסנכרון נכשל
אבל השחזור בוצע בהצלחה |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ולא ניתן לשחזר אותו. כלומר, פקודת הבדיקה נכשלה והשחזור נכשל. |
בדיקות runInstrumentationTest
public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
מריץ בדיקות אינסטרומנטציה ומספק שחזור מכשיר.
אם החיבור למכשיר יתנתק לפני שהרצת הבדיקה תסתיים והשחזור יצליח, כל המאזינים יקבלו הודעה על TestRunFailed והשגיאה "false" תוחזר. פקודת הבדיקה לא תרוץ מחדש. במקרה הצורך, המתקשרים יוכלו לנסות שוב.
אם החיבור למכשיר יאבד לפני שהרצת הבדיקה תסתיים והשחזור ייכשל, כל המאזינים יקבלו הודעה לגבי testRunנכשל ו-DeviceNotAvailableExt יסומן.
פרמטרים | |
---|---|
runner |
IRemoteAndroidTestRunner : ה-IRemoteAndroidTestRunner שמריץ את הבדיקות |
listeners |
: המאזינים לתוצאת הבדיקה |
החזרות | |
---|---|
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 : ציון תאריך מסוים. ייעשה שימוש בתאריך המארח אם null |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
setOptions
public abstract void setOptions (TestDeviceOptions options)
הגדרת TestDeviceOptions
של המכשיר
פרמטרים | |
---|---|
options |
TestDeviceOptions |
setProperty
public abstract boolean setProperty (String propKey, String propValue)
מגדיר את ערך המאפיין הנתון במכשיר. כדי להגדיר את הערך True, צריך להגדיר את השורש של adb.
פרמטרים | |
---|---|
propKey |
String : המפתח שרוצים להגדיר. |
propValue |
String : ערך המאפיין שרוצים להגדיר. |
החזרות | |
---|---|
boolean |
מחזירה True אם הפקודה setpro בוצעה בהצלחה, אחרת False. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
הגדרה לשחזור
public abstract void setRecovery (IDeviceRecovery recovery)
הגדרת IDeviceRecovery
לשימוש במכשיר הזה. צריך להגדיר אותן בזמן ההקצאה הראשונה של המכשיר.
פרמטרים | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
הגדרה לשחזור מצב
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
הגדרת מצב השחזור הנוכחי לשימוש במכשיר.
המדיניות הזו מאפשרת לקבוע באיזו שיטת שחזור להשתמש כשנתקלים בבעיית תקשורת במכשיר. מומלץ להשתמש בשיטה הזו באופן מוגבל רק במקרה הצורך (לדוגמה, כשה-framework מושבת וכו'),
פרמטרים | |
---|---|
mode |
ITestDevice.RecoveryMode : האם מצב 'שחזור עד למצב אונליין בלבד' צריך להיות מופעל או לא. |
setUseFastbootdelete
public abstract void setUseFastbootErase (boolean useFastbootErase)
הגדרה אם להשתמש בפורמט מחיקה של אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי לאפס מחיצה במכשיר.
פרמטרים | |
---|---|
useFastbootErase |
boolean : true אם צריך להשתמש במחיקה של אתחול מהיר (fastboot), או false אם
יש להשתמש בפורמט אתחול מהיר (fastboot). |
למידע נוסף:
startLogcat
public abstract void startLogcat ()
התחלת הצילום של פלט Logcat מהמכשיר ברקע.
לא תהיה לכך השפעה אם פלט ה-Logcat כבר תועד. אפשר לאחזר את הנתונים מאוחר יותר באמצעות getLogcat.
כשהמכשיר כבר לא בשימוש, צריך לבצע קריאה אל stopLogcat()
.
בדרך כלל אין צורך לקרוא ל-startLogcat()
ול-stopLogcat()
במסגרת הקשר הפעלה של TF, כי מסגרת TF תתחיל ותפסיק Logcat.
stopEmulatorOutput
public abstract void stopEmulatorOutput ()
סוגרים את הפלט של האמולטור ומוחקים אותו.
stopLogcat
public abstract void stopLogcat ()
הפסקת התיעוד של פלט ה-Logcat מהמכשיר ומחיקת נתוני ה-Logcat שנשמרו.
לא תהיה לכך השפעה אם לא יתועד פלט Logcat.
מעבר ל-AdbTcp
public abstract String switchToAdbTcp ()
העברת המכשיר למצב adb-over-tcp.
החזרות | |
---|---|
String |
את המספר הסידורי של ה-tcp או null אם לא ניתן להחליף את המכשיר |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
מעבר ל-AdbUsb
public abstract boolean switchToAdbUsb ()
העברת המכשיר למצב adb על גבי USB.
החזרות | |
---|---|
boolean |
true אם ההעברה בוצעה בהצלחה, false אחרת. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
SyncFiles
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
סנכרון מצטבר של התוכן של ספריית קבצים מקומית למכשיר.
כדי להחליט אילו קבצים לדחות, המערכת משווה בין חותמות זמן של קבצים מקומיים למשימות המקבילות מרחוק. רק קבצים 'חדשים' יותר או שלא קיימים' יועברו למכשיר. לכן, התקורה אמורה להיות קטנה יחסית אם הקובץ שהוגדר במכשיר כבר עדכני.
המערכת תתעלם מקבצים מוסתרים (עם שמות המתחילים ב-'.').
שימוש לדוגמה: SyncFiles("/tmp/files", "/sdcard") ייצור ספרייה מסוג /sdcard/files אם היא לא קיימת, וידחוף באופן רקורסיבי את התוכן /sdcard/files.
פרמטרים | |
---|---|
localFileDir |
File : ספריית הקבצים המקומית שמכילה את הקבצים שרוצים לדחוף באופן רקורסיבי. |
deviceFilePath |
String : הרמה הבסיסית (root) של נתיב הקובץ המוחלט של היעד המרוחק. כל הספריות בנתיב הקבצים
הזה חייבות להיות קריאה. למשל, דחיפה אל /data/local/tmp כאשר adb אינו ברמה הבסיסית (root)
תיכשל |
החזרות | |
---|---|
boolean |
true אם הקבצים סונכרנו בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
ביטול נעילת המכשיר
public abstract boolean unlockDevice ()
ביטול נעילת המכשיר אם המכשיר במצב מוצפן.
השיטה הזו עשויה להפעיל מחדש את ה-framework, אבל היא לא תפעילpostBootSetup()
. לכן, יכול להיות שהמכשיר לא מוכן במלואו לבדיקה כשהשיטה הזו תוחזר.
החזרות | |
---|---|
boolean |
true אם הפעולה בוצעה ללא שגיאות או אם המכשיר לא מוצפן. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
UnsupportedOperationException |
אם המכשיר לא תומך בהצפנה. |
ניתוק ניפוי באגים
public abstract void unmountDebugfs ()
ניתוק של ניפוי באגים.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
pendingForBootcomplete
public abstract boolean waitForBootComplete (long timeOut)
הפעולה תיחסם עד שתגדירו את התכונה הניסיונית להשלמת ההפעלה של המכשיר.
פרמטרים | |
---|---|
timeOut |
long : הזמן באלפיות השנייה עד להגדרת הדגל |
החזרות | |
---|---|
boolean |
true אם הדגל השלמת ההפעלה של המכשיר מוגדר במהלך הזמן הקצוב לתפוגה |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
pendingForDeviceAvailable
public abstract boolean waitForDeviceAvailable ()
בהמתנה עד שהמכשיר יגיב וזמין לבדיקה. הגדרת ברירת המחדל של הזמן הקצוב לתפוגה.
החזרות | |
---|---|
boolean |
True אם המכשיר זמין, False אם השחזור מושבת ולא זמין. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
pendingForDeviceAvailable
public abstract boolean waitForDeviceAvailable (long waitTime)
בהמתנה עד שהמכשיר יגיב וזמין לבדיקה.
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
True אם המכשיר זמין, False אם השחזור מושבת ולא זמין. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם המכשיר עדיין לא מגיב לאחר תום זמן ההמתנה. |
ListenForDeviceAvailableInRecoverPath
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
בהמתנה עד שהמכשיר יגיב וזמין בלי להביא בחשבון את נתיב השחזור.
פרמטרים | |
---|---|
waitTime |
long |
החזרות | |
---|---|
boolean |
הערך הוא True אם המכשיר זמין, או False אם לא זמין. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
startForDeviceBootloader
public abstract void waitForDeviceBootloader ()
חסימה עד שניתן לראות את המכשיר באמצעות אתחול מהיר (fastboot). שימוש בברירת המחדל של הזמן הקצוב לתפוגה.
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
WaitForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
חסימת המכשיר למצב 'שחזור adb' (שים לב לכך שהוא שונה מ-
IDeviceRecovery
).
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
true אם המכשיר נכנס למצב שחזור לפני שהתוקף שלו פג.
אחרת, false |
ListenForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
חסימה כדי שהמכשיר יהיה במצב 'adb offload'
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
true אם המכשיר נכנס למצב התקנה ממקור לא ידוע לפני שהתוקף שלו פג. אחרת, false
|
startForDeviceNotAvailable
public abstract boolean waitForDeviceNotAvailable (long waitTime)
חסימות כדי שהמכשיר לא יהיה זמין, כלומר חסר ב-adb
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
true אם המכשיר לא יהיה זמין לפני שהתוקף יפוג.
אחרת, false |
להמתיןForDeviceOnline
public abstract void waitForDeviceOnline ()
חסימה עד שהמכשיר גלוי דרך adb. הגדרת ברירת המחדל של הזמן הקצוב לתפוגה
הערה: לא בטוח שהמכשיר יגיב לפקודות בסיום. במקום זאת, אתם צריכים להשתמש ב-waitForDeviceAvailable()
.
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
להמתיןForDeviceOnline
public abstract void waitForDeviceOnline (long waitTime)
חסימה עד שהמכשיר גלוי דרך adb.
הערה: לא בטוח שהמכשיר יגיב לפקודות בסיום. במקום זאת, אתם צריכים להשתמש ב-waitForDeviceAvailable()
.
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
קליעות | |
---|---|
DeviceNotAvailableException |
אם החיבור למכשיר אבד ואי אפשר לשחזר אותו. |
startForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
בהמתנה עד שהמכשיר יגיב לפקודת מעטפת בסיסית של adb.
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
true אם המכשיר מגיב לפני הזמן שחלף waitTime. |