NativeDevice
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
JavaScript.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
הטמעת ברירת מחדל של מכשירי Android בסטאק ITestDevice
שלא במצב מלא.
סיכום
מחלקות מקוננות | |
---|---|
class |
NativeDevice.AdbAction
|
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
קבועים | |
---|---|
int |
INVALID_USER_ID
ערך שהוחזר לכל מזהה משתמש לא חוקי/לא נמצא: UserHandle הגדיר את הערך -10000 |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
מספר ברירת המחדל של ניסיונות חוזרים של פקודה לבצע |
שדות | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
בנאים ציבוריים | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
ייווצר |
שיטות ציבוריות | |
---|---|
void
|
batchPrefetchStartupBuildProps()
אופטימיזציית מיקרו (בערך 400 אלפיות שנייה) על ידי שליפה מראש של כל הרכיבים הדרושים לנו במקום לקרוא ל-'adb' getpro' לכל אחד מהם. |
boolean
|
canSwitchToHeadlessSystemUser()
הפונקציה מחזירה אם מותר לעבור למשתמש SYSTEM ללא GUI. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
לבדוק אם תכונה מסוימת נתמכת כרגע בהינתן רמה מינימלית של תמיכה. |
boolean
|
checkConnectivity()
חשוב לבדוק שלמכשיר יש קישוריות לרשת. |
boolean
|
clearErrorDialogs()
אפשר לנסות לסגור את כל תיבות הדו-שיח של השגיאה שמוצגות כרגע בממשק המשתמש של המכשיר. |
void
|
clearLastConnectedWifiNetwork()
ניקוי רשת ה-Wi-Fi האחרונה שחוברה. |
void
|
clearLogcat()
מחיקת כל נתוני ה-Logcat שהצטברו. |
boolean
|
connectToWifiNetwork(
מתחבר לרשת Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
מתחבר לרשת Wi-Fi. |
boolean
|
connectToWifiNetwork(
התחברות לרשת Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
מתחבר לרשת Wi-Fi. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
וריאנט של |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
וריאנט של |
int
|
createUser(String name, boolean guest, boolean ephemeral)
יצירת משתמש עם שם נתון והדגלים שסופקו |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
יצירת משתמש עם שם נתון והדגלים שסופקו |
int
|
createUser(String name)
יצירת משתמש עם שם נתון ודגלי ברירת המחדל 0. |
int
|
createUserNoThrow(String name)
יצירת משתמש עם שם נתון ודגלי ברירת המחדל 0. |
void
|
deleteFile(String deviceFilePath, int userId)
שיטה לעזרה במחיקת קובץ או ספרייה במכשיר. |
void
|
deleteFile(String deviceFilePath)
שיטה לעזרה במחיקת קובץ או ספרייה במכשיר. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
הסרה של |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
שיטה מסייעת לבדוק אם המכשיר הופעל מחדש ברכה על ידי השוואה בין השרת system_server הנוכחי
השרת הקודם של system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
שיטה שעוזרת לבדוק אם המכשיר הופעל מחדש החל משעה UTC מאז תחילת התקופה של זמן מערכת
במכשיר |
boolean
|
disableAdbRoot()
משבית את שורש adb. |
void
|
disableKeyguard()
מנסה להשבית את מגן המקשים. |
boolean
|
disableNetworkMonitor()
ההגדרה משביתה ניטור רשת במכשיר. |
boolean
|
disconnectFromWifi()
המכשיר מתנתק מרשת Wi-Fi. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
שיטה עוזרת לקבוע אם קובץ במכשיר קיים למשתמש מסוים. |
boolean
|
doesFileExist(String deviceFilePath)
שיטה עוזרת לקבוע אם קובץ קיים במכשיר. |
File
|
dumpHeap(String process, String devicePath)
נסה למחוק את הערימה מה-system_server. |
boolean
|
enableAdbRoot()
הפעלת השורש של adb. |
boolean
|
enableNetworkMonitor()
הפעלת ניטור רשת במכשיר. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה. |
String
|
executeAdbCommand(long timeout,
שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה. |
String
|
executeAdbCommand(String... cmdArgs)
שיטת עזרה שמבצעת פקודת adb כפקודת מערכת. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
שיטת עזרה שמפעילה פקודת אתחול מהיר כפקודת מערכת, עם זמן קצוב לתפוגה שמוגדר כברירת מחדל 2 דקות. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) כפקודת מערכת. |
CommandResult
|
executeLongFastbootCommand(
שיטת עזרה המבצעת פקודת אתחול מהיר (Fastboot) שרצה במשך זמן רב כפקודת מערכת עם מערכת במשתני סביבה. |
String
|
executeShellCommand(String command)
שיטת עזרה שמפעילה פקודת מעטפת מסוג adb ומחזירה את הפלט בתור |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
מפעיל את פקודת המעטפת הנתונה של adb, ומנסה שוב מספר פעמים אם הפקודה נכשלת. |
CommandResult
|
executeShellV2Command(String cmd)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות. |
CommandResult
|
fastbootWipePartition(String partition)
שיטה לעזרה באיפוס המחיצה של המכשיר. |
|
getActiveApexes()
אחזור המידע על הפעלה של APEX במכשיר. |
|
getAllSettings(String namespace)
החזרת זוגות של ערכי מפתח ממרחב השמות המבוקש. |
DeviceAllocationState
|
getAllocationState()
החזרת מצב ההקצאה הנוכחי של המכשיר |
String
|
getAndroidId(int userId)
חיפוש והחזרת android-id המשויך ל-userId, null אם לא נמצא. |
|
getAndroidIds()
יצירת מפה של מזהי Android שנמצאו במזהי משתמשים תואמים. |
int
|
getApiLevel()
מאתרים את רמת ה-API של המכשיר. |
PackageInfo
|
getAppPackageInfo(String packageName)
אחזור מידע על חבילה שמותקנת במכשיר. |
|
getAppPackageInfos()
אחזור מידע על החבילות שמותקנות במכשיר. |
String
|
getBasebandVersion()
שיטת הנוחות לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה. |
Integer
|
getBattery()
מחזירה את רמת הטעינה הנוכחית של הסוללה של מכשיר או את הערך Null אם רמת הסוללה לא זמינה. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
מחזירה ערך בוליאני של המאפיין הנתון. |
|
getBootHistory()
תכונת העזרה אוספת את המפה של היסטוריית האתחול עם זמן האתחול וסיבת האתחול. |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
שיטת העזרה אוספת את מפת היסטוריית האתחול עם זמן האתחול וסיבת האתחול, כי הזמן שעבר מאז epoch מהמכשיר ומיחידת הזמן שצוינה. |
String
|
getBootloaderVersion()
שיטת נוחות לקבלת גרסת תוכנת האתחול של המכשיר הזה. |
InputStreamSource
|
getBugreport()
אחזור דוח על באג מהמכשיר. |
InputStreamSource
|
getBugreportz()
אחזור דוח על באג מהמכשיר. |
String
|
getBuildAlias()
מאחזרים את הכינוי של ה-build שהמכשיר פועל כרגע. |
String
|
getBuildFlavor()
מאחזרים את גרסת ה-build של המכשיר. |
String
|
getBuildId()
מאחזרים את גרסת ה-build שהמכשיר פועל כרגע. |
String
|
getBuildSigningKeys()
פונקציה זו מחזירה את סוג המפתח המשמש לחתימה על תמונת המכשיר בדרך כלל מכשירי Android נחתמים באמצעות מפתחות בדיקה (כמו ב-AOSP) או באמצעות מפתחות הפצה (נשלטת על ידי יצרני מכשירים נפרדים) |
DeviceDescriptor
|
getCachedDeviceDescriptor()
הפונקציה מחזירה ערך |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
הפונקציה מחזירה ערך |
String[]
|
getChildren(String path)
לחלופין, אפשר להשתמש ב- |
AbstractConnection
|
getConnection()
החיבור הנוכחי שמשויך למכשיר. |
ContentProviderHandler
|
getContentProvider(int userId)
הפונקציה מחזירה את הערך |
DeviceFoldableState
|
getCurrentFoldableState()
מחזירה את מצב המכשיר המתקפל הנוכחי של המכשיר או ערך null אם התרחשו בעיות מסוימות. |
int
|
getCurrentUser()
החזרת המזהה של המשתמש הפעיל הנוכחי. |
String
|
getDeviceClass()
מקבלים את סיווג המכשיר. |
long
|
getDeviceDate()
החזרת התאריך של המכשיר באלפיות השנייה מאז נקודת ההתחלה. |
DeviceDescriptor
|
getDeviceDescriptor()
החזרת |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
החזרת |
TestDeviceState
|
getDeviceState()
מאתרים את מצב המכשיר. |
long
|
getDeviceTimeOffset(Date date)
עוזר לקבל את הפרש הזמנים בין המכשיר לבין |
InputStreamSource
|
getEmulatorOutput()
מקבלים את הסטרימינג של האמולטור stdout ו-stderr |
Process
|
getEmulatorProcess()
מחזירים את הערך |
final
File
|
getExecuteShellCommandLog()
היומן שמכיל את כל היומנים של |
long
|
getExternalStoreFreeSpace()
שיטה שעוזרת לקבוע את נפח האחסון הפנוי באחסון החיצוני של המכשיר. |
String
|
getFastbootPath()
מחזירה את הנתיב של הקובץ הבינארי של אתחול מהיר (fastboot) שבו משתמשים. |
String
|
getFastbootProductType()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode). |
String
|
getFastbootProductVariant()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode). |
String
|
getFastbootSerialNumber()
מחזירה את המספר הסידורי של מצב אתחול מהיר (fastboot). |
String
|
getFastbootVariable(String variableName)
מאחזרים את הערך הנתון של משתנה אתחול מהיר מהמכשיר. |
String
|
getFastbootVersion()
מחזירה את מחרוזת הגרסה של הקובץ הבינארי של אתחול מהיר שבו נעשה שימוש. |
IFileEntry
|
getFileEntry(String path)
אחזור קובץ עזר לקובץ מרוחק במכשיר. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
עוזר לא רשמי לקבל |
|
getFoldableStates()
הפונקציה מחזירה את רשימת המצבים המתקפלים במכשיר. |
IDevice
|
getIDevice()
הפונקציה מחזירה הפניה ל-ddmlib |
|
getInstalledPackageNames()
אחזר את שמות החבילות של האפליקציות שקיימים במכשיר. |
long
|
getIntProperty(String name, long defaultValue)
מחזירה ערך מספר שלם של המאפיין הנתון מהמכשיר. |
String
|
getIpAddress()
מקבלת את כתובת ה-IP של המכשיר. |
KeyguardControllerState
|
getKeyguardState()
החזרת אובייקט כדי לקבל את המצב הנוכחי של KeyGuard או כ-null אם אין תמיכה בו. |
long
|
getLastExpectedRebootTimeMillis()
פונקציה זו מחזירה את הפעם האחרונה שבה ממשקי API של TradeFederal הפעילו הפעלה מחדש באלפיות השנייה מאז EPOCH כ-
הוחזרו על ידי |
int
|
getLaunchApiLevel()
מקבלים את רמת ה-API הראשונה שהושקה במכשיר. |
InputStreamSource
|
getLogcat()
תופסת רצף snapshot של נתוני ה-Logcat. |
InputStreamSource
|
getLogcat(int maxBytes)
תופס זרם של תמונת מצב של |
InputStreamSource
|
getLogcatDump()
אחזור של קובץ ה-Dump של ה-Logcat הנוכחי במכשיר. |
InputStreamSource
|
getLogcatSince(long date)
יוצר זרם snapshot של נתוני Logcat שתועדו החל מהתאריך שצוין. |
String
|
getMacAddress()
מחזירה את כתובת ה-MAC של המכשיר, null אם לא ניתן לשלוח שאילתה מהמכשיר. |
Integer
|
getMainUserId()
הפונקציה מחזירה את מזהה המשתמש הראשי. |
|
getMainlineModuleInfo()
קבלת המידע על המודולים של השורה הראשית שמותקנים במכשיר. |
int
|
getMaxNumberOfRunningUsersSupported()
קבלת המספר המקסימלי של משתמשים פעילים נתמכים בו-זמנית. |
int
|
getMaxNumberOfUsersSupported()
קבלת המספר המקסימלי של משתמשים נתמכים. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
החזרת |
String
|
getMountPoint(String mountName)
מחזירה נקודת טעינה. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
הפונקציה מחזירה |
|
getMountPointInfo()
החזרת גרסה מנותחת של המידע ב- /proc/Loads במכשיר |
TestDeviceOptions
|
getOptions()
מאחזרים את אפשרויות הבדיקה של המכשיר. |
long
|
getPartitionFreeSpace(String partition)
שיטה שעוזרת לקבוע את נפח האחסון הפנוי במחיצה במכשיר. |
Integer
|
getPrimaryUserId()
מחזירה את מזהה המשתמש הראשי. |
ProcessInfo
|
getProcessByName(String processName)
שיטת העזרה מפעילה את ה-"pidof" ו-stat הפקודה ומחזירה את האובייקט |
String
|
getProcessPid(String process)
מחזירה את ה-pid של השירות או את הערך null אם משהו השתבש. |
String
|
getProductType()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה. |
String
|
getProductVariant()
שיטת נוחות לקבלת וריאציית המוצר של המכשיר הזה. |
String
|
getProperty(String name)
מאחזרים את ערך המאפיין הנתון מהמכשיר. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
משתמשים במצב השחזור הנוכחי של המכשיר. |
InputStreamSource
|
getScreenshot(String format)
מצלם צילום מסך מהמכשיר. |
InputStreamSource
|
getScreenshot(long displayId)
מצלם צילום מסך מהמכשיר שצוין למזהה התצוגה. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
מצלם צילום מסך מהמכשיר. |
InputStreamSource
|
getScreenshot()
מצלם צילום מסך מהמכשיר. |
String
|
getSerialNumber()
שיטת נוחות לקבלת המספר הסידורי של המכשיר הזה. |
String
|
getSetting(int userId, String namespace, String key)
מחזירה את הערך של ההגדרה המבוקשת. |
String
|
getSetting(String namespace, String key)
הצגת |
String
|
getSimOperator()
יש להחזיר את המפעיל של כרטיס ה-SIM או אם הוא לא זמין או אם המכשיר לא זמין. |
String
|
getSimState()
החזרת מצב כרטיס ה-SIM או אפס אם לא זמין או שהמכשיר לא זמין. |
|
getTombstones()
מאחזרים את רשימת המצבות ומחזירים אותה מהמכשירים. |
long
|
getTotalMemory()
פונקציה זו מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים או -1 במקרה של שגיאה פנימית |
String
|
getTrackingSerial()
למטרות ניהול מכשירים, מקבלים את המספר הסידורי שמשמש למעקב אחרי המכשיר. |
|
getUninstallablePackageNames()
מאחזרים את שמות החבילות של האפליקציות שאפשר להסיר. |
boolean
|
getUseFastbootErase()
בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר. |
int
|
getUserFlags(int userId)
למצוא ולהחזיר את הדגלים של משתמש נתון. |
|
getUserInfos()
הפונקציה מקבלת את מפת useId אל |
int
|
getUserSerialNumber(int userId)
אם נמצא, יש להחזיר את המספר הסידורי שמשויך למזהה המשתמש, -10000 במקרים אחרים. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
מעבדים את ה-DeviceEvent הנתון. לעבד את DeviceEvent, שעשוי להעביר את המכשיר הזה להקצאה חדשה או לא להעביר אותו . |
boolean
|
hasFeature(String feature)
בודקים אם התכונה זמינה במכשיר. |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
מתקינים חבילת Android במכשיר. |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
מתקינים חבילת Android במכשיר. |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
התקנת חבילת Android במכשיר של משתמש מסוים. |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
התקנת חבילת Android במכשיר של משתמש מסוים. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות |
boolean
|
isBypassLowTargetSdkBlockSupported()
בדיקה אם הפלטפורמה במכשיר תומכת בעקיפה של חסימת SDK עם יעדים נמוכים בהתקנות של אפליקציות |
boolean
|
isDebugfsMounted()
בודקים אם רכיבי ניפוי הבאגים טענו. |
boolean
|
isDeviceEncrypted()
הפונקציה מחזירה אם המכשיר מוצפן. |
boolean
|
isDirectory(String path)
פונקציה זו מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה. אחרת, הערך false. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
הפונקציה מחזירה אם המכשיר תומך בהצפנה. |
boolean
|
isExecutable(String fullPath)
הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ להפעלה. אחרת, False. |
boolean
|
isFastbootEnabled()
צריך לחזור אם התכונה 'אתחול מהיר' זמינה במכשיר. |
boolean
|
isHeadless()
פונקציה זו מחזירה את הערך true אם המכשיר ללא GUI (ללא מסך). אחרת, הערך false. |
boolean
|
isHeadlessSystemUserMode()
מחזירה אם המכשיר משתמש במצב משתמש במערכת ללא GUI. |
boolean
|
isMainUserPermanentAdmin()
הפונקציה מחזירה אם המשתמש הראשי הוא אדמין קבוע ולא ניתן למחוק או לשדרג אותו לאחור ל- ללא הרשאת אדמין. |
boolean
|
isMultiUserSupported()
המדיניות קובעת אם יש תמיכה בריבוי משתמשים. |
boolean
|
isPackageInstalled(String packageName, String userId)
שולחים למכשיר שאילתות לגבי שם חבילה נתון ומזהה משתמש כדי לבדוק אם החבילה הנוכחית מותקנת או לא עבור המשתמש הזה. |
boolean
|
isPackageInstalled(String packageName)
שולחים למכשיר שאילתה על שם חבילה מסוים כדי לבדוק אם הוא מותקן כרגע או לא. |
boolean
|
isRuntimePermissionSupported()
בדיקה אם הפלטפורמה במכשיר תומכת בהענקת הרשאות בתחילת ההפעלה |
boolean
|
isStateBootloaderOrFastbootd()
הפונקציה מחזירה את הערך True אם המכשיר נמצא ב- |
boolean
|
isUserRunning(int userId)
בודקים אם משתמש מסוים פועל. |
boolean
|
isUserSecondary(int userId)
מחזירה אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו. |
boolean
|
isUserVisible(int userId)
הפונקציה בודקת אם המשתמש הנתון גלוי. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
הפונקציה בודקת אם המשתמש הנתון גלוי במסך הנתון. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
הפונקציה מחזירה אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע ב- |
boolean
|
isVisibleBackgroundUsersSupported()
הפונקציה מחזירה אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע. |
boolean
|
isWifiEnabled()
יש לבדוק אם ה-Wi-Fi מופעל. |
|
listDisplayIds()
איסוף רשימת מזהי המסכים הזמינים במכשיר, כפי שדווח על ידי dumpsys SurfaceFlinger". |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
קבלת רשימת המסכים שבהם אפשר להשתמש כדי |
|
listUsers()
קבלת רשימת המשתמשים במכשיר. |
boolean
|
logAnrs(ITestLogger logger)
איסוף ורישום של מקרי ANR מהמכשיר. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
שיטה עוזרת לתעד דוח על באג ולרשום אותו למדווחים. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
רישום הודעה ב-Logcat של המכשיר. |
void
|
mountDebugfs()
טעינת ניפוי באגים. |
void
|
nonBlockingReboot()
יוצר פקודה להפעלה מחדש של המכשיר וחוזרת אחרי שהפקודה הושלמה כשהמכשיר לא מחובר גלוי יותר ל-adb. |
void
|
postAdbRootAction()
שינוי אם צריך לבצע פעולות ספציפיות במכשיר אחרי השורש של adb ולפני שהמכשיר חזר לאינטרנט. |
void
|
postAdbUnrootAction()
שינוי אם צריך לבצע פעולות ספציפיות במכשיר אחרי שחרור הפרמטר adb ולפני כן שהמכשיר יתחבר שוב לאינטרנט. |
void
|
postBootSetup()
יש לפעול לפי ההוראות להגדרת המכשיר כדי לבדוק אותו לאחר כל הפעלה. |
void
|
postInvocationTearDown(Throwable exception)
שלבים נוספים לניקוי הנדרש הספציפי למכשיר, שיבוצעו לאחר ההפעלה הושלמה. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
שלבים נוספים להגדרה הנדרשת ספציפית למכשיר שיבוצעו במכשיר לפני את זרימת ההפעלה. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי. |
boolean
|
pullDir(String deviceFilePath, File localDir)
שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי. |
boolean
|
pullFile(String remoteFilePath, File localFile)
אחזור קובץ מהמכשיר. |
File
|
pullFile(String remoteFilePath, int userId)
אחזור קובץ מהמכשיר, מאחסן אותו בקובץ |
File
|
pullFile(String remoteFilePath)
אחזור קובץ מהמכשיר, מאחסן אותו בקובץ |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
אחזור קובץ מהמכשיר. |
String
|
pullFileContents(String remoteFilePath)
אחזור קובץ מהמכשיר והחזרת התוכן שלו. |
File
|
pullFileFromExternal(String remoteFilePath)
שיטת נוחות לאחזור קובץ מהאחסון החיצוני של המכשיר, ומאחסנת אותו
|
boolean
|
pushDir(File localFileDir, String deviceFilePath,
דחיפת תוכן של ספריות באופן רקורסיבי למכשיר, ולא כולל ספריות מסוימות לאחר סינון. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
דחיפת תוכן ספרייה למכשיר באופן רקורסיבי. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
דחיפת תוכן ספרייה למכשיר באופן רקורסיבי. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
וריאנט של |
boolean
|
pushFile(File localFile, String remoteFilePath)
דחיפת קובץ למכשיר. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
דחיפת קובץ למכשיר. |
boolean
|
pushString(String contents, String remoteFilePath)
דחיפת קובץ שנוצר ממחרוזת למכשיר |
void
|
reboot(String reason)
הפעלת המכשיר מחדש למצב adb עם |
void
|
reboot()
הפעלת המכשיר מחדש במצב adb. |
void
|
rebootIntoBootloader()
הפעלת המכשיר מחדש במצב תוכנת אתחול. |
void
|
rebootIntoFastbootd()
הפעלת המכשיר מחדש במצב אתחול מהיר (fastbootd). |
void
|
rebootIntoRecovery()
הפעלת המכשיר מחדש במצב adbrecovery. |
void
|
rebootIntoSideload()
הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור) הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע |
void
|
rebootIntoSideload(boolean autoReboot)
הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור) הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע |
void
|
rebootUntilOnline()
חלופה ל- |
void
|
rebootUntilOnline(String reason)
חלופה ל- |
void
|
rebootUserspace()
מופעלת מחדש רק חלק של מרחב המשתמשים במכשיר. |
void
|
rebootUserspaceUntilOnline()
חלופה ל- |
boolean
|
recoverDevice()
ניסיונות לשחזר את התקשורת במכשיר. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
רישום |
void
|
remountSystemReadOnly()
להגדיר את מחיצת המערכת במכשיר לקריאה בלבד. |
void
|
remountSystemWritable()
הגדרת מחיצת המערכת במכשיר לניתנת לכתיבה. |
void
|
remountVendorReadOnly()
מגדירים את מחיצת הספק במכשיר לקריאה בלבד. |
void
|
remountVendorWritable()
מגדירים את מחיצת הספק במכשיר לניתנת לכתיבה. |
boolean
|
removeAdmin(String componentName, int userId)
הסרת מנהל המכשיר הנתון למשתמש הנתון והחזרה של |
void
|
removeOwners()
אתם יכולים להסיר את כל בעלי הפרופילים הקיימים של המכשיר בלי להתאמץ. |
boolean
|
removeUser(int userId)
להסיר משתמש נתון מהמכשיר. |
void
|
resetContentProviderSetup()
יש לאפס את הסימון להגדרת ספק תוכן כדי להפעיל אותו שוב. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
שיטת נוחות לביצוע |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
מריץ בדיקות אינסטרומנטציה ומספק שחזור מכשיר. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
בדיוק כמו במלון |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
דומה ל- |
void
|
setConfiguration(IConfiguration configuration)
החדרת |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
מגדיר את התאריך במכשיר הערה: הגדרת תאריך במכשיר מחייבת הרמה הבסיסית (root) |
boolean
|
setDeviceOwner(String componentName, int userId)
הגדרת רכיב של מנהל מכשיר כבעלים של המכשיר במשתמש הנתון. |
void
|
setDeviceState(TestDeviceState deviceState)
מעדכנים את מצב המכשיר. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
כדי שהאמולטור |
void
|
setEmulatorProcess(Process p)
המדיניות הזו מגדירה את |
void
|
setFastbootEnabled(boolean fastbootEnabled)
מגדירים את האפשרות לאתחול מהיר (Fastboot) במכשיר. |
void
|
setFastbootPath(String fastbootPath)
מגדיר את הנתיב לקובץ הבינארי של אתחול מהיר שבו יש להשתמש. |
void
|
setIDevice(IDevice newDevice)
עדכון ה-IDevice המשויך ל-ITestDevice הזה. |
void
|
setLogStartDelay(int delay)
הגדרת משך הזמן באלפיות השנייה לפני התחלת צילום Logcat במכשיר אונליין. |
void
|
setOptions(TestDeviceOptions options)
הגדרת |
boolean
|
setProperty(String propKey, String propValue)
מגדיר את ערך המאפיין הנתון במכשיר. |
void
|
setRecovery(IDeviceRecovery recovery)
הגדרת |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
הגדרת מצב השחזור הנוכחי לשימוש במכשיר. |
void
|
setSetting(String namespace, String key, String value)
הצגת |
void
|
setSetting(int userId, String namespace, String key, String value)
אתם יכולים להוסיף ערך הגדרה למרחב השמות של משתמש נתון. |
void
|
setTestLogger(ITestLogger testLogger)
החדרה של המכונה |
void
|
setTrackingSerial(String trackingSerial)
למטרות ניהול מכשירים, עוקבים אחרי המספר הסידורי שבו אנחנו משתמשים כדי להתייחס למכשיר. |
void
|
setUseFastbootErase(boolean useFastbootErase)
הגדרה אם להשתמש בפורמט מחיקה של אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי לאפס מחיצה במכשיר. |
void
|
startLogcat()
התחלת הצילום של פלט Logcat מהמכשיר ברקע. |
boolean
|
startUser(int userId)
מפעיל משתמש מסוים ברקע אם הוא מופסק כרגע. |
boolean
|
startUser(int userId, boolean waitFlag)
מפעיל משתמש מסוים ברקע אם הוא מופסק כרגע. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
מפעיל משתמש מסוים ברקע, גלוי במסך הנתון (כלומר, מאפשר למשתמש) כדי להפעיל פעילויות בתצוגה הזו). |
void
|
stopEmulatorOutput()
סוגרים את הפלט של האמולטור ומוחקים אותו. |
void
|
stopLogcat()
הפסקת התיעוד של פלט ה-Logcat מהמכשיר ומחיקת נתוני ה-Logcat שנשמרו. |
boolean
|
stopUser(int userId)
עוצר משתמש נתון. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
עצירה של משתמש נתון. |
String
|
switchToAdbTcp()
העברת המכשיר למצב adb-over-tcp. |
boolean
|
switchToAdbUsb()
העברת המכשיר למצב adb על גבי USB. |
boolean
|
switchUser(int userId)
מעבר למזהה משתמש אחר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל. |
boolean
|
switchUser(int userId, long timeout)
עוברים ל-User-ID אחר עם הזמן הקצוב לתפוגה שצוין כתאריך היעד. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
סנכרון מצטבר של התוכן של ספריית קבצים מקומית למכשיר. |
Bugreport
|
takeBugreport()
יוצרים דוח על באג ומחזירים אותו בתוך אובייקט |
String
|
uninstallPackage(String packageName)
מסירים חבילת Android מהמכשיר. |
String
|
uninstallPackageForUser(String packageName, int userId)
הסרה של חבילת Android מהמכשיר של משתמש מסוים. |
boolean
|
unlockDevice()
ביטול נעילת המכשיר אם המכשיר במצב מוצפן. |
void
|
unmountDebugfs()
ניתוק של ניפוי באגים. |
boolean
|
waitForBootComplete(long timeOut)
הפעולה תיחסם עד שתגדירו את התכונה הניסיונית להשלמת ההפעלה של המכשיר. |
boolean
|
waitForDeviceAvailable()
בהמתנה עד שהמכשיר יגיב וזמין לבדיקה. |
boolean
|
waitForDeviceAvailable(long waitTime)
בהמתנה עד שהמכשיר יגיב וזמין לבדיקה. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
בהמתנה עד שהמכשיר יגיב וזמין בלי להביא בחשבון את נתיב השחזור. |
void
|
waitForDeviceBootloader()
חסימה עד שניתן לראות את המכשיר באמצעות אתחול מהיר (fastboot). |
boolean
|
waitForDeviceInRecovery(long waitTime)
חסימה של גישת המכשיר ל'שחזור adb' (שימו לב ששונה מ-
|
boolean
|
waitForDeviceInSideload(long waitTime)
חסימה של שילוב המכשיר ב-'adb offload' הסמוי הסופי |
boolean
|
waitForDeviceNotAvailable(long waitTime)
חסימות כדי שהמכשיר לא יהיה זמין, כלומר חסר ב-adb |
void
|
waitForDeviceOnline()
חסימה עד שהמכשיר גלוי דרך adb. |
void
|
waitForDeviceOnline(long waitTime)
חסימה עד שהמכשיר גלוי דרך adb. |
boolean
|
waitForDeviceShell(long waitTime)
בהמתנה עד שהמכשיר יגיב לפקודת מעטפת בסיסית של adb. |
שיטות מוגנות | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
יוצר את פקודת ה-OS עבור הסשן והארגומנטים הנתונים של adb במעטפת |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
צריך ליצור |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
צריך לבצע הפעלה מחדש של adb. |
void
|
ensureRuntimePermissionSupported()
שיטת עזרה אחרת כדי לגרום לחריגה אם אין תמיכה בהרשאה בתחילת ההפעלה |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
מקבלים את המכונה |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
אחזור מאפיין מכשיר, מהמטמון של ddmlib כברירת מחדל, ולחזור אל 'adb' "shell getpro" או 'fastboot getvar', בהתאם לסטטוס ההפעלה של המכשיר – אתחול מהיר או לא. |
boolean
|
isInRebootCallback()
הפונקציה מחזירה אם מתבצע כרגע קריאות חוזרות (callback) להפעלה מחדש או לא. |
boolean
|
isNewer(File localFile, IFileEntry entry)
אם הקובץ המקומי חדש יותר מהקובץ המרוחק, מוחזר הערך |
void
|
notifyRebootEnded()
שליחת התראה לכל |
void
|
notifyRebootStarted()
שליחת התראה לכל ה |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
מבצע פעולה במכשיר הזה. |
void
|
postAdbReboot()
פעולות נוספות שאפשר לבצע אחרי הפעלה מחדש. |
void
|
prePostBootSetup()
המדיניות מאפשרת לכל סוג מכשיר (AndroidNativeDevice, TestDevice) לשנות את השיטה הזו בשביל לאחר הפעלה ספציפית. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
מגדירים את המופע של השעון לשימוש. |
void
|
setMicrodroidProcess(Process process)
סימון ה-TestDevice כ-microdroid ומגדיר את ה-CID שלו. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
מריצים פקודת אתחול מהירה פשוטה עם משתני סביבה ומדווחים על הסטטוס של הפקודה. |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
מפעיל פקודת אתחול מהירה ומדווחים על הסטטוס של הפקודה. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
צריך להמתין כדי לראות שהמכשיר לא זמין (הפסקת הדיווח ל-adb). |
קבועים
INVALID_USER_ID
public static final int INVALID_USER_ID
ערך שהוחזר לכל מזהה משתמש לא חוקי/לא נמצא: UserHandle הגדיר את הערך -10000
ערך קבוע: -10,000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
ערך קבוע: 5,000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
מספר ברירת המחדל של ניסיונות חוזרים של פקודה לבצע
ערך קבוע: 2 (0x00000002)
שדות
DEBUGFS_PATH
public static final String DEBUGFS_PATH
SD_CARD
protected static final String SD_CARD
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
בנאים ציבוריים
NativeDevice
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
ייווצר TestDevice
.
פרמטרים | |
---|---|
device |
IDevice : IDevice המשויך |
stateMonitor |
IDeviceStateMonitor : המנגנון של IDeviceStateMonitor שבו יש להשתמש |
allocationMonitor |
IDeviceMonitor : IDeviceMonitor להודיע על שינויים במצב ההקצאה.
יכול להיות null |
שיטות ציבוריות
אצווהPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
אופטימיזציית מיקרו (בערך 400 אלפיות שנייה) על ידי שליפה מראש של כל הרכיבים הדרושים לנו במקום לקרוא ל-'adb' getpro' לכל אחד מהם. כלומר, אחזור כל המאפיינים הוא מהיר באותה מידה כמו אחזור של נכס. פעולות כמו device.getApiLevel(), checkApiLevelAgainstNextRelease ו-getBuildAlias 'adb getפרו'. אנחנו מאחזרים אותם בשיחה אחת וקוראים ל-NativeDevice.setProperty. גם אם לא נעשה זאת, NativeDevice תקרא ל-setProperty ותשמור את התוצאה במטמון שיחות עתידיות. אנחנו עושים את זה קצת קודם. אם המכשיר נמצא בתהליך שחזור או שהוא נמצא שם הן שגיאות אחרות באחזור הרכיבים, ואנחנו פשוט מתעלמים מהן.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
הפונקציה מחזירה אם מותר לעבור למשתמש SYSTEM ללא GUI.
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
CheckApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
לבדוק אם תכונה מסוימת נתמכת כרגע בהינתן רמה מינימלית של תמיכה. הזה שמביאה בחשבון תכונות שעדיין לא פורסמו, לפני ההעלאה של רמת ה-API.
פרמטרים | |
---|---|
strictMinLevel |
int : הרמה המינימלית המחמירה שתומכת בתכונה הזו. |
החזרות | |
---|---|
boolean |
הערך הוא True אם הרמה נתמכת. אחרת, שקרית. |
קליעות | |
---|---|
DeviceNotAvailableException |
בדיקת קישוריות
public boolean checkConnectivity ()
חשוב לבדוק שלמכשיר יש קישוריות לרשת.
החזרות | |
---|---|
boolean |
true אם למכשיר יש חיבור פעיל לרשת,
false למעלה. |
קליעות | |
---|---|
DeviceNotAvailableException |
cleanErrorDialogs
public boolean clearErrorDialogs ()
אפשר לנסות לסגור את כל תיבות הדו-שיח של השגיאה שמוצגות כרגע בממשק המשתמש של המכשיר.
החזרות | |
---|---|
boolean |
true אם לא קיימות תיבות דו-שיח, או אם תיבות הדו-שיח נוקו.
אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
cleanLastConnectedWi-FiNetwork
public void clearLastConnectedWifiNetwork ()
ניקוי רשת ה-Wi-Fi האחרונה שחוברה. צריך לקרוא לכך כשמתחילים הפעלה חדשה כדי להימנע מהתחברות לרשת ה-Wi-Fi שהייתה בשימוש בבדיקה הקודמת לאחר הפעלת המכשיר מחדש.
ניקוי הרישום ביומן
public void clearLogcat ()
מחיקת כל נתוני ה-Logcat שהצטברו.
האפשרות הזו שימושית במקרים שבהם רוצים להבטיח שההחזרות של ITestDevice#getLogcat()
יחזרו רק
נתוני יומן שמופקים אחרי נקודה מסוימת (למשל, אחרי שדרוג של גרסת build חדשה של מכשיר וכו').
ConnectToWi-FiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
מתחבר לרשת Wi-Fi.
מפעיל Wi-Fi וחוסם עד שמתבצע חיבור מוצלח באמצעות אחת מנקודות ה-Wi-Fi
הרשתות שמצוינות במפה wifiSsidToPsk. אחרי שייווצר חיבור, המכונה תנסה
לשחזר את החיבור אחרי כל הפעלה מחדש עד ITestDevice#disconnectFromWifi()
או
קוראים לפונקציה ITestDevice#clearLastConnectedWifiNetwork()
.
פרמטרים | |
---|---|
wifiSsidToPsk |
: מפה של נקודות SSID של Wi-Fi לסיסמאות. |
scanSsid |
boolean : האם לסרוק אחר SSID מוסתר לרשת הזו. |
החזרות | |
---|---|
boolean |
true אם הוא מחובר לרשת Wi-Fi בהצלחה. false
אחרת |
קליעות | |
---|---|
DeviceNotAvailableException |
ConnectToWi-FiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
מתחבר לרשת Wi-Fi.
הפעלת ה-Wi-Fi וחסימה של עד שיתבצע חיבור מוצלח לרשת ה-Wi-Fi שצוינה.
אחרי שיתבצע חיבור, המכונה תנסה לשחזר את החיבור אחרי כל הפעלה מחדש
עד ITestDevice#disconnectFromWifi()
או
קוראים לפונקציה ITestDevice#clearLastConnectedWifiNetwork()
.
פרמטרים | |
---|---|
wifiSsid |
String : מזהה ה-Wi-Fi שאליו צריך להתחבר |
wifiPsk |
String : ביטוי סיסמה של PSK או ערך null אם לא מוצפן |
החזרות | |
---|---|
boolean |
true אם הוא מחובר לרשת Wi-Fi בהצלחה. false
אחרת |
קליעות | |
---|---|
DeviceNotAvailableException |
ConnectToWi-FiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk)
מתחבר לרשת Wi-Fi.
מפעיל Wi-Fi וחוסם עד שמתבצע חיבור מוצלח באמצעות אחת מנקודות ה-Wi-Fi
הרשתות שמצוינות במפה wifiSsidToPsk. אחרי שייווצר חיבור, המכונה תנסה
לשחזר את החיבור אחרי כל הפעלה מחדש עד ITestDevice#disconnectFromWifi()
או
השם ITestDevice#clearLastConnectedWifiNetwork()
נקרא.f
פרמטרים | |
---|---|
wifiSsidToPsk |
: מפה של נקודות SSID של Wi-Fi לסיסמאות. |
החזרות | |
---|---|
boolean |
true אם הוא מחובר לרשת Wi-Fi בהצלחה. false
אחרת |
קליעות | |
---|---|
DeviceNotAvailableException |
ConnectToWi-FiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
מתחבר לרשת Wi-Fi.
הפעלת ה-Wi-Fi וחסימה של עד שיתבצע חיבור מוצלח לרשת ה-Wi-Fi שצוינה.
אחרי שיתבצע חיבור, המכונה תנסה לשחזר את החיבור אחרי כל הפעלה מחדש
עד ITestDevice#disconnectFromWifi()
או
קוראים לפונקציה ITestDevice#clearLastConnectedWifiNetwork()
.
פרמטרים | |
---|---|
wifiSsid |
String : מזהה ה-Wi-Fi שאליו צריך להתחבר |
wifiPsk |
String : ביטוי סיסמה של PSK או ערך null אם לא מוצפן |
scanSsid |
boolean : האם לסרוק כדי לאתר SSID מוסתר לרשת הזו. |
החזרות | |
---|---|
boolean |
true אם הוא מחובר לרשת Wi-Fi בהצלחה. false
אחרת |
קליעות | |
---|---|
DeviceNotAvailableException |
ConnectToWi-FiNetworkIf Needed
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
וריאנט של connectToWifiNetwork(String, String)
שמתחבר רק באמצעות המכשיר
אין כרגע קישוריות רשת.
פרמטרים | |
---|---|
scanSsid |
boolean : האם לסרוק כדי לאתר SSID מוסתר לרשת הזו |
החזרות | |
---|---|
boolean |
true אם הוא מחובר לרשת Wi-Fi בהצלחה. false
אחרת |
קליעות | |
---|---|
DeviceNotAvailableException |
ConnectToWi-FiNetworkIf Needed
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
וריאנט של connectToWifiNetwork(String, String)
שמתחבר רק באמצעות המכשיר
אין כרגע קישוריות רשת.
החזרות | |
---|---|
boolean |
true אם הוא מחובר לרשת Wi-Fi בהצלחה. false
אחרת |
קליעות | |
---|---|
DeviceNotAvailableException |
CreateUser
public int createUser (String name, boolean guest, boolean ephemeral)
יצירת משתמש עם שם נתון והדגלים שסופקו
פרמטרים | |
---|---|
name |
String : של המשתמש שצריך ליצור במכשיר |
guest |
boolean : הפעלת סימון המשתמש – אורח במהלך היצירה |
ephemeral |
boolean : הפעלת סימון המשתמש באופן זמני במהלך היצירה |
החזרות | |
---|---|
int |
המזהה של המשתמש שנוצר |
קליעות | |
---|---|
DeviceNotAvailableException |
CreateUser
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
יצירת משתמש עם שם נתון והדגלים שסופקו
פרמטרים | |
---|---|
name |
String : של המשתמש שצריך ליצור במכשיר |
guest |
boolean : הפעלת סימון המשתמש – אורח במהלך היצירה |
ephemeral |
boolean : הפעלת סימון המשתמש באופן זמני במהלך היצירה |
forTesting |
boolean : הפעלת סימון הבדיקה –לבדיקה במהלך היצירה |
החזרות | |
---|---|
int |
המזהה של המשתמש שנוצר |
קליעות | |
---|---|
DeviceNotAvailableException |
CreateUser
public int createUser (String name)
יצירת משתמש עם שם נתון ודגלי ברירת המחדל 0.
פרמטרים | |
---|---|
name |
String : של המשתמש שצריך ליצור במכשיר |
החזרות | |
---|---|
int |
המספר השלם של מזהה המשתמש שנוצר |
קליעות | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
יצירת משתמש עם שם נתון ודגלי ברירת המחדל 0.
פרמטרים | |
---|---|
name |
String : של המשתמש שצריך ליצור במכשיר |
החזרות | |
---|---|
int |
המספר השלם של מזהה המשתמש שנוצר, או 1- לשגיאה. |
קליעות | |
---|---|
DeviceNotAvailableException |
DeleteFile
public void deleteFile (String deviceFilePath, int userId)
שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
פרמטרים | |
---|---|
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר. |
userId |
int : מזהה המשתמש שממנו רוצים למחוק |
קליעות | |
---|---|
DeviceNotAvailableException |
DeleteFile
public void deleteFile (String deviceFilePath)
שיטה לעזרה במחיקת קובץ או ספרייה במכשיר.
פרמטרים | |
---|---|
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר. |
קליעות | |
---|---|
DeviceNotAvailableException |
ביטול הרישוםDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
הסרה של IDeviceActionReceiver
הרשום.
פרמטרים | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : IDeviceActionReceiver שיוסר. |
המכשיר הופעל מחדש
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
שיטה מסייעת לבדוק אם המכשיר הופעל מחדש ברכה על ידי השוואה בין השרת system_server הנוכחי
השרת הקודם של system_server ProcessInfo
. משתמשים ב-getProcessByName(String)
ומקבלים ProcessInfo
.
פרמטרים | |
---|---|
prevSystemServerProcess |
ProcessInfo : תהליך system_server הקודם ProcessInfo . |
החזרות | |
---|---|
boolean |
true אם המכשיר הופעל מחדש |
קליעות | |
---|---|
DeviceNotAvailableException |
המכשירSoftאתחול מאז
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
שיטה שעוזרת לבדוק אם המכשיר הופעל מחדש החל משעה UTC מאז תחילת התקופה של זמן מערכת
במכשיר ERROR(/TimeUnit)
שלו. הפעלה מחדש רכה מתייחסת ל-system_server שהופעל מחדש מחוץ
הפעלה קשיחה מחדש של המכשיר (לדוגמה: נשלחה בקשה להפעלה מחדש). המכשיר הנוכחי utcEpochTime ב-
אפשר לקבל Milliseccond בשיטה getDeviceDate()
.
פרמטרים | |
---|---|
utcEpochTime |
long : זמן המכשיר בשנייה מאז תחילת התקופה. |
timeUnit |
TimeUnit : יחידת הזמן TimeUnit של utcEpochTime הנתון. |
החזרות | |
---|---|
boolean |
true אם המכשיר הופעל מחדש |
קליעות | |
---|---|
DeviceNotAvailableException |
השבתת AdbRoot
public boolean disableAdbRoot ()
משבית את שורש adb.
השבתה של adb root עשויה לגרום לניתוק המכשיר מ-adb. השיטה הזו תיחסם עד שהמכשיר זמין.
החזרות | |
---|---|
boolean |
true אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
השבתה של KeyGuard
public void disableKeyguard ()
מנסה להשבית את מגן המקשים.
קודם כל צריך להמתין עד ששליחה הקלט תהיה מוכנה, זה מתרחש בערך באותו זמן כאשר המכשיר מדווח על BOOT_COMPLETE, באופן אסינכרוני, כי המסגרת הנוכחית יש מרוץ תהליכים מדי פעם. לאחר מכן נשלחת פקודה לסגירת מקש KeyGuard (פועל בתנועה לא מאובטחת בלבד)
קליעות | |
---|---|
DeviceNotAvailableException |
השבתת NetworkMonitor
public boolean disableNetworkMonitor ()
ההגדרה משביתה ניטור רשת במכשיר.
החזרות | |
---|---|
boolean |
true אם המעקב הושבת בהצלחה. false
אם הפעולה נכשלה. |
קליעות | |
---|---|
DeviceNotAvailableException |
התנתקות מ-Wi-Fi
public boolean disconnectFromWifi ()
המכשיר מתנתק מרשת Wi-Fi.
הפעולה הזו מסירה את כל הרשתות מרשימת הרשתות המוכרות ומשביתה את ה-Wi-Fi.
החזרות | |
---|---|
boolean |
true אם הוא מנותק מרשת ה-Wi-Fi. false
אם הניתוק נכשל. |
קליעות | |
---|---|
DeviceNotAvailableException |
DoFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
שיטה עוזרת לקבוע אם קובץ במכשיר קיים למשתמש מסוים.
פרמטרים | |
---|---|
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר לבדיקה |
userId |
int : מזהה המשתמש שבאמצעותו צריך לבדוק את קיומו של הקובץ |
החזרות | |
---|---|
boolean |
true אם הקובץ קיים, אחרת false . |
קליעות | |
---|---|
DeviceNotAvailableException |
DoFileExist
public boolean doesFileExist (String deviceFilePath)
שיטה עוזרת לקבוע אם קובץ קיים במכשיר.
פרמטרים | |
---|---|
deviceFilePath |
String : הנתיב המוחלט של הקובץ במכשיר לבדיקה |
החזרות | |
---|---|
boolean |
true אם הקובץ קיים, אחרת false . |
קליעות | |
---|---|
DeviceNotAvailableException |
עריסות
public File dumpHeap (String process, String devicePath)
נסה למחוק את הערימה מה-system_server. באחריות המתקשר/ת לבצע ניקיון את הקובץ שהורד.
פרמטרים | |
---|---|
process |
String : שם התהליך במכשיר שאליו רוצים לבצע את ה-Dumpheap. |
devicePath |
String : הנתיב במכשיר שבו צריך למקם את קובץ ה-Dump. המיקום הזה חייב להיות מיקום שבו
ההרשאות מאפשרות זאת. |
החזרות | |
---|---|
File |
ERROR(/File) שמכיל את הדוח. המערכת תציג ערך של null אם משהו נכשל. |
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלה של AdbRoot
public boolean enableAdbRoot ()
הפעלת השורש של adb. אם האפשרות Enable-root (הפעלה) היא 'false', תתועד הודעה החזרה בלי להפעיל את הרמה הבסיסית (root).
הפעלה של ברמה הבסיסית (root) עשויה לגרום לניתוק המכשיר מ-adb. השיטה הזו תיחסם עד שהמכשיר זמין.
החזרות | |
---|---|
boolean |
true אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלת NetworkMonitor
public boolean enableNetworkMonitor ()
הפעלת ניטור רשת במכשיר.
החזרות | |
---|---|
boolean |
true אם המעקב הופעל בהצלחה. false
אם הפעולה נכשלה. |
קליעות | |
---|---|
DeviceNotAvailableException |
PerformanceAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
מומלץ להשתמש במקום זאת ב-executeShellCommand(String)
ככל האפשר,
מספקת שיטה טובה יותר לזיהוי כשלים ולביצועים טובים יותר.
פרמטרים | |
---|---|
timeout |
long : הזמן באלפיות השנייה לפני שהמכשיר נחשב ללא תגובה, 0L
ללא זמן קצוב לתפוגה |
cmdArgs |
String : פקודת ה-adb והארגומנטים להרצה |
החזרות | |
---|---|
String |
את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה. |
קליעות | |
---|---|
DeviceNotAvailableException |
PerformanceAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.
מומלץ להשתמש במקום זאת ב-executeShellCommand(String)
ככל האפשר,
מספקת שיטה טובה יותר לזיהוי כשלים ולביצועים טובים יותר.
פרמטרים | |
---|---|
timeout |
long : הזמן באלפיות השנייה לפני שהמכשיר נחשב ללא תגובה, 0L
ללא זמן קצוב לתפוגה |
envMap |
: הסביבה להגדרה לפקודה |
cmdArgs |
String : פקודת ה-adb והארגומנטים להרצה |
החזרות | |
---|---|
String |
את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה. |
קליעות | |
---|---|
DeviceNotAvailableException |
PerformanceAdbCommand
public String executeAdbCommand (String... cmdArgs)
שיטת עזרה שמבצעת פקודת adb כפקודת מערכת.
מומלץ להשתמש במקום זאת ב-executeShellCommand(String)
ככל האפשר,
מספקת שיטה טובה יותר לזיהוי כשלים ולביצועים טובים יותר.
פרמטרים | |
---|---|
cmdArgs |
String : פקודת ה-adb והארגומנטים להרצה |
החזרות | |
---|---|
String |
את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה. |
קליעות | |
---|---|
DeviceNotAvailableException |
startFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
שיטת עזרה שמפעילה פקודת אתחול מהיר כפקודת מערכת, עם זמן קצוב לתפוגה שמוגדר כברירת מחדל 2 דקות.
אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).
פרמטרים | |
---|---|
cmdArgs |
String : הפקודה 'אתחול מהיר' והארגומנטים להרצה |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
startFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר כפקודת מערכת.
אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).
פרמטרים | |
---|---|
timeout |
long : הזמן באלפיות השנייה לפני שהתוקף של הפקודה פג |
cmdArgs |
String : הפקודה 'אתחול מהיר' והארגומנטים להרצה |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלת לונגבאתחול מהיר
public CommandResult executeLongFastbootCommand (String... cmdArgs)
שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) כפקודת מערכת.
זהה ל-executeFastbootCommand(String)
, אבל הזמן הקצוב לתפוגה יהיה ארוך יותר.
פרמטרים | |
---|---|
cmdArgs |
String : הפקודה 'אתחול מהיר' והארגומנטים להרצה |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלת לונגבאתחול מהיר
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
שיטת עזרה המבצעת פקודת אתחול מהיר (Fastboot) שרצה במשך זמן רב כפקודת מערכת עם מערכת במשתני סביבה.
זהה ל-executeFastbootCommand(String)
, אבל הזמן הקצוב לתפוגה יהיה ארוך יותר.
פרמטרים | |
---|---|
envVarMap |
: משתני סביבת המערכת שבהם רצה פקודת האתחול המהיר |
cmdArgs |
String : הפקודה 'אתחול מהיר' והארגומנטים להרצה |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
ביצועShellCommand
public String executeShellCommand (String command)
שיטת עזרה שמפעילה פקודת מעטפת מסוג adb ומחזירה את הפלט בתור String
.
פרמטרים | |
---|---|
command |
String : פקודת המעטפת adb להרצה |
החזרות | |
---|---|
String |
הפלט של המעטפת |
קליעות | |
---|---|
DeviceNotAvailableException |
ביצועShellCommand
public 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 : מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב
חריג. המערכת תפסול את DeviceNotRError אם היא retryAttempts
מתבצעות ללא הצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
ביצועShellCommand
public 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 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 CommandResult executeShellV2Command (String cmd)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult
, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
פרמטרים | |
---|---|
cmd |
String : הפקודה שצריך להריץ. |
החזרות | |
---|---|
CommandResult |
התוצאה בCommandResult . |
קליעות | |
---|---|
DeviceNotAvailableException |
offsetShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult
, שמאוכלס כראוי בפלט סטטוס הפקודה וב-stderr. stdout הוא
לשידור שצוין.
פרמטרים | |
---|---|
cmd |
String : הפקודה שצריך להריץ. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) כאשר פלט ה-std יופנה מחדש, או null. |
החזרות | |
---|---|
CommandResult |
התוצאה בCommandResult . |
קליעות | |
---|---|
DeviceNotAvailableException |
offsetShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult
, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.
פרמטרים | |
---|---|
cmd |
String : הפקודה שצריך להריץ. |
pipeAsInput |
File : ERROR(/File) שיועבר כקלט לפקודה, או שהוא null. |
החזרות | |
---|---|
CommandResult |
התוצאה בCommandResult . |
קליעות | |
---|---|
DeviceNotAvailableException |
offsetShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
פרמטרים | |
---|---|
cmd |
String : פקודת המעטפת adb להרצה |
maxTimeoutForCommand |
long : הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה. יחידה בתור
צוין ב-timeUnit |
timeUnit |
TimeUnit : יחידה עבור maxTimeToOutputShellResponse |
retryAttempts |
int : מספר הפעמים המקסימלי לביצוע ניסיון חוזר של הפקודה אם היא נכשלת עקב
חריג. מילת המפתח DeviceNotResponseError תבוטל אם retryAttempts
שבוצעו ללא הצלחה. |
החזרות | |
---|---|
CommandResult |
קליעות | |
---|---|
DeviceNotAvailableException |
offsetShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
פרמטרים | |
---|---|
cmd |
String : פקודת המעטפת adb להרצה |
maxTimeoutForCommand |
long : הזמן הקצוב לתפוגה שמוגדר להשלמת הפקודה. יחידה בתור
צוין ב-timeUnit |
timeUnit |
TimeUnit : יחידה עבור maxTimeToOutputShellResponse |
החזרות | |
---|---|
CommandResult |
קליעות | |
---|---|
DeviceNotAvailableException |
offsetShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
פרמטרים | |
---|---|
cmd |
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 CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
מפעילה פקודת מעטפת adb, עם פרמטרים נוספים לשליטה בהתנהגות הפקודות.
פרמטרים | |
---|---|
cmd |
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 CommandResult fastbootWipePartition (String partition)
שיטה לעזרה באיפוס המחיצה של המכשיר.
אם הערך של getUseFastbootErase()
הוא true
, המחיקה תתבצע באמצעות אתחול מהיר
את המחיצה. לאחר מכן, המכשיר צריך ליצור מערכת קבצים בפעם הבאה שהמכשיר יופעל.
אם לא, ייעשה שימוש בפורמט אתחול מהיר (fastboot) שיצור מערכת קבצים חדשה במכשיר.
אמור להיות בשימוש כשהמכשיר כבר נמצא במצב אתחול מהיר (fastboot).
פרמטרים | |
---|---|
partition |
String : המחיצה שרוצים לאפס |
החזרות | |
---|---|
CommandResult |
התוצאה של הפקודה שמכילה את הפלט של הפקודה |
קליעות | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
אחזור המידע על הפעלה של APEX במכשיר.
החזרות | |
---|---|
|
ERROR(/Set) מתוך ApexInfo מופעלים כרגע במכשיר |
קליעות | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
החזרת זוגות של ערכי מפתח ממרחב השמות המבוקש.
פרמטרים | |
---|---|
namespace |
String : חייב להיות אחד מהערכים {"system", "secure", "global"} |
החזרות | |
---|---|
|
המפה של צמדי המפתח. המערכת תציג ערך של null אם אין תמיכה במרחב השמות. |
קליעות | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
החזרת מצב ההקצאה הנוכחי של המכשיר
החזרות | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
חיפוש והחזרת android-id המשויך ל-userId, null אם לא נמצא.
פרמטרים | |
---|---|
userId |
int |
החזרות | |
---|---|
String |
קליעות | |
---|---|
DeviceNotAvailableException |
מזהי getAndroidId
publicgetAndroidIds ()
יצירת מפה של מזהי Android שנמצאו במזהי משתמשים תואמים. אין ביטוח שכל משתמש הפרמטר id ימצא מזהה android המשויך לפונקציה הזו, כך שחלק ממזהי המשתמש עשויים להתאים ל-null.
החזרות | |
---|---|
|
מפה של מזהי Android שנמצאו במזהי משתמשים תואמים. |
קליעות | |
---|---|
DeviceNotAvailableException |
getApiLevel"
public int getApiLevel ()
מאתרים את רמת ה-API של המכשיר. ברירת המחדל היא UNKNOWN_API_LEVEL
.
החזרות | |
---|---|
int |
מספר שלם שמציין את רמת ה-API של המכשיר |
קליעות | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
אחזור מידע על חבילה שמותקנת במכשיר.
פרמטרים | |
---|---|
packageName |
String |
החזרות | |
---|---|
PackageInfo |
PackageInfo או null אם לא ניתן לאחזר את המידע |
קליעות | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
אחזור מידע על החבילות שמותקנות במכשיר.
החזרות | |
---|---|
|
הותקנו ERROR(/List) מתוך PackageInfo במכשיר. |
קליעות | |
---|---|
DeviceNotAvailableException |
גרסת getBaseband
public String getBasebandVersion ()
שיטת הנוחות לקבלת גרסת פס בסיס (רדיו) של המכשיר הזה. בתהליך קבלה של גרסת הרדיו
ספציפי למכשיר, לכן ייתכן שהוא לא יחזיר את המידע הנכון לכל המכשירים. הזה
מסתמכת על השימוש ב-gsm.version.baseband למכירהy כדי להחזיר את פרטי הגרסה הנכונים.
המידע הזה לא מדויק במכשירי CDMA מסוימים, ויכול להיות שהגרסה שמוחזרת כאן לא תהיה תואמת
הגרסה שדווחה באמצעות אתחול מהיר עשויה שלא להחזיר את הגרסה עבור רדיו CDMA.
אמ;לק: השיטה הזו מדווחת על גרסה מדויקת רק אם המאפיין gsm.version.baseband הוא
זהה לגרסה שהוחזרה על ידי fastboot getvar version-baseband
.
החזרות | |
---|---|
String |
גרסת פס הבסיס String או null אם לא ניתן לקבוע
(במכשיר אין נתוני רדיו או גרסה שלא ניתן לקרוא אותה) |
קליעות | |
---|---|
DeviceNotAvailableException |
הורדת הסוללה
public Integer getBattery ()
מחזירה את רמת הטעינה הנוכחית של הסוללה של מכשיר או את הערך Null אם רמת הסוללה לא זמינה.
החזרות | |
---|---|
Integer |
getBooleanProperty
public 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
publicgetBootHistory ()
תכונת העזרה אוספת את המפה של היסטוריית האתחול עם זמן האתחול וסיבת האתחול.
החזרות | |
---|---|
|
מפה של זמן האתחול (זמן UTC בשנייה מאז נקודת ההתחלה) וסיבת האתחול |
קליעות | |
---|---|
DeviceNotAvailableException |
getBootHistoryHistory
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
שיטת העזרה אוספת את מפת היסטוריית האתחול עם זמן האתחול וסיבת האתחול, כי
הזמן שעבר מאז epoch מהמכשיר ומיחידת הזמן שצוינה. המכשיר הנוכחי utcEpochTime ב-
ניתן להשיג אלפית שנייה באמצעות השיטה getDeviceDate()
.
פרמטרים | |
---|---|
utcEpochTime |
long : זמן המכשיר מאז תחילת התקופה. |
timeUnit |
TimeUnit : יחידת הזמן TimeUnit . |
החזרות | |
---|---|
|
מפה של זמן האתחול (זמן UTC בשנייה מאז נקודת ההתחלה) וסיבת האתחול |
קליעות | |
---|---|
DeviceNotAvailableException |
גרסה getBootloaderVersion
public String getBootloaderVersion ()
שיטת נוחות לקבלת גרסת תוכנת האתחול של המכשיר הזה.
יתבצע ניסיון לאחזר את גרסת תוכנת האתחול מהמצב הנוכחי של המכשיר. (לדוגמה, אם מכשיר נמצא במצב אתחול מהיר, הוא ינסה לאחזר גרסה מאתחול מהיר)
החזרות | |
---|---|
String |
גרסת תוכנת האתחול String או null אם לא ניתן למצוא אותה |
קליעות | |
---|---|
DeviceNotAvailableException |
דוח getBugreport
public InputStreamSource getBugreport ()
אחזור דוח על באג מהמכשיר.
מובטח שההטמעה תמשיך לפעול במכשיר ללא כרטיס sdcard (או כשכרטיס ה-sdcard עדיין לא נטען).
החזרות | |
---|---|
InputStreamSource |
InputStreamSource שיפיק את התוכן של דוח איתור הבאגים על פי דרישה. לחשבון
במקרה של כשל, הפונקציה InputStreamSource תפיק ERROR(/InputStream) ריק. |
getBugreportz
public InputStreamSource getBugreportz ()
אחזור דוח על באג מהמכשיר. דוח הבאג בפורמט ZIP מכיל את דוח הבאג הראשי וגם קובצי יומן אחרים שימושיים לניפוי באגים.
נתמך רק עבור 'גרסת adb' > 1.0.36
החזרות | |
---|---|
InputStreamSource |
InputStreamSource של קובץ ה-ZIP שמכיל את דוח הבאג, החזרת הערך null ב-
במקרה של כשל. |
getBuildAlias
public String getBuildAlias ()
מאחזרים את הכינוי של ה-build שהמכשיר פועל כרגע.
כינוי Build הוא בדרך כלל מחרוזת קריאה יותר ממזהה ה-build (בדרך כלל מספר עבור גרסאות build של Nexus). לדוגמה, לגרסה הסופית של Android 4.2 יש כינוי JDQ39 ומזהה build 573038
החזרות | |
---|---|
String |
כינוי ה-build או חזרה למזהה ה-build אם לא ניתן לאחזר אותו |
קליעות | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public String getBuildFlavor ()
מאחזרים את גרסת ה-build של המכשיר.
החזרות | |
---|---|
String |
טעם ה-build או אפס אם לא ניתן לאחזר אותו |
קליעות | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
מאחזרים את גרסת ה-build שהמכשיר פועל כרגע.
החזרות | |
---|---|
String |
מזהה ה-build או IBuildInfo#UNKNOWN_BUILD_ID אם לא ניתן לאחזר אותו |
קליעות | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public String getBuildSigningKeys ()
פונקציה זו מחזירה את סוג המפתח המשמש לחתימה על תמונת המכשיר
בדרך כלל מכשירי Android נחתמים באמצעות מפתחות בדיקה (כמו ב-AOSP) או באמצעות מפתחות הפצה (נשלטת על ידי יצרני מכשירים נפרדים)
החזרות | |
---|---|
String |
מפתח החתימה אם הוא נמצא. אחרת, הוא null. |
קליעות | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
הפונקציה מחזירה ערך DeviceDescriptor
שנשמר במטמון אם המכשיר מוקצה, אחרת מחזירה את הערך
DeviceDescriptor
הנוכחי.
החזרות | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
הפונקציה מחזירה ערך DeviceDescriptor
שנשמר במטמון אם המכשיר מוקצה, אחרת מחזירה את הערך
DeviceDescriptor
הנוכחי.
פרמטרים | |
---|---|
shortDescriptor |
boolean : האם להגביל את התיאור למידע מינימלי בלבד |
החזרות | |
---|---|
DeviceDescriptor |
getChildren
public String[] getChildren (String path)
לחלופין, אפשר להשתמש ב-IFileEntry
שלא עובד לפעמים בגלל הרשאות.
פרמטרים | |
---|---|
path |
String : הוא הנתיב במכשיר שבו מבצעים את החיפוש |
החזרות | |
---|---|
String[] |
מערך של מחרוזת שמכילה את כל הקובץ בנתיב במכשיר. |
קליעות | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
החיבור הנוכחי שמשויך למכשיר.
החזרות | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
הפונקציה מחזירה את הערך ContentProviderHandler
או את הערך null אם לא זמין.
אפשר להשתמש שוב בספק התוכן אם הוא נבנה בעבר עם אותה userId
.
פרמטרים | |
---|---|
userId |
int : מזהה המשתמש שבאמצעותו רוצים לאתחל את ספק התוכן. |
החזרות | |
---|---|
ContentProviderHandler |
קליעות | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
מחזירה את מצב המכשיר המתקפל הנוכחי של המכשיר או ערך null אם התרחשו בעיות מסוימות.
החזרות | |
---|---|
DeviceFoldableState |
קליעות | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
החזרת המזהה של המשתמש הפעיל הנוכחי. במקרה של שגיאה, מחזירים את הערך -10000.
החזרות | |
---|---|
int |
קליעות | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
מקבלים את סיווג המכשיר.
החזרות | |
---|---|
String |
סיווג המכשיר String . |
getDeviceDate
public long getDeviceDate ()
החזרת התאריך של המכשיר באלפיות השנייה מאז נקודת ההתחלה.
החזרות | |
---|---|
long |
את התאריך של המכשיר בפורמט תקופה של זמן מערכת. |
קליעות | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
החזרת DeviceDescriptor
מהמידע במכשיר כדי לקבל מידע עליו בלי
שמעבירים את האובייקט של המכשיר בפועל.
החזרות | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
החזרת DeviceDescriptor
מהמידע במכשיר כדי לקבל מידע עליו בלי
שמעבירים את האובייקט של המכשיר בפועל.
פרמטרים | |
---|---|
shortDescriptor |
boolean : האם להגביל את התיאור למידע מינימלי בלבד |
החזרות | |
---|---|
DeviceDescriptor |
getDeviceState
public TestDeviceState getDeviceState ()
מאתרים את מצב המכשיר.
החזרות | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
עוזר לקבל את הפרש הזמנים בין המכשיר לבין ERROR(/Date)
נתון. שימוש בתקופה המקבילה
באופן פנימי.
פרמטרים | |
---|---|
date |
Date |
החזרות | |
---|---|
long |
ההבדל באלפיות השנייה |
קליעות | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
מקבלים את הסטרימינג של האמולטור stdout ו-stderr
החזרות | |
---|---|
InputStreamSource |
הפלט של האמולטור |
getEmulatorProcess
public Process getEmulatorProcess ()
מחזירים את הערך Process
שתואם לאמולטור הזה.
החזרות | |
---|---|
Process |
Process או null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
היומן שמכיל את כל היומנים של executeShellCommand(String)
.
החזרות | |
---|---|
File |
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
שיטה שעוזרת לקבוע את נפח האחסון הפנוי באחסון החיצוני של המכשיר.
החזרות | |
---|---|
long |
כמות השטח הפנוי ב-KB |
קליעות | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
מחזירה את הנתיב של הקובץ הבינארי של אתחול מהיר (fastboot) שבו משתמשים.
כדי להפעיל פונקציות של אתחול מהיר (fastboot), עדיין צריך להגדיר את isFastbootEnabled()
כ-True.
החזרות | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
יש להשתמש בשיטה הזו רק אם המכשיר צריך להפעיל אתחול מהיר (fastboot). זו וריאציה קצת יותר בטוחה
מאשר בשיטה הגנרית getProductType()
במקרה הזה, כי ITestDevice
יידע לשחזר את המכשיר לאתחול מהיר אם המכשיר נמצא במצב שגוי או
לא מגיב.
החזרות | |
---|---|
String |
השם של סוג המוצר String או null אם לא ניתן לקבוע |
קליעות | |
---|---|
DeviceNotAvailableException |
getFastbootProductVariant
public String getFastbootProductVariant ()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה במצב אתחול מהיר (Fastboot mode).
יש להשתמש בשיטה הזו רק אם המכשיר צריך להפעיל אתחול מהיר (fastboot). זו וריאציה קצת יותר בטוחה
מאשר בשיטה הגנרית getProductType()
במקרה הזה, כי ITestDevice
יידע לשחזר את המכשיר לאתחול מהיר אם המכשיר נמצא במצב שגוי או
לא מגיב.
החזרות | |
---|---|
String |
השם של סוג המוצר String או null אם לא ניתן לקבוע |
קליעות | |
---|---|
DeviceNotAvailableException |
getFastbootSeriesNumber
public String getFastbootSerialNumber ()
מחזירה את המספר הסידורי של מצב אתחול מהיר (fastboot).
החזרות | |
---|---|
String |
getFastbootVariable
public String getFastbootVariable (String variableName)
מאחזרים את הערך הנתון של משתנה אתחול מהיר מהמכשיר.
פרמטרים | |
---|---|
variableName |
String : שם המשתנה |
החזרות | |
---|---|
String |
ערך הנכס או null אם הוא לא קיים |
קליעות | |
---|---|
DeviceNotAvailableException |
גרסת getFastbootVersion
public String getFastbootVersion ()
מחזירה את מחרוזת הגרסה של הקובץ הבינארי של אתחול מהיר שבו נעשה שימוש. או שהוא null אם משהו קורה שגוי.
החזרות | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
אחזור קובץ עזר לקובץ מרוחק במכשיר.
פרמטרים | |
---|---|
path |
String : נתיב הקובץ לאחזור. יכול להיות נתיב או נתיב מוחלטים ביחס ל-'/'. (כלומר
גם "/system" ו'מערכת' תחביר נתמך) |
החזרות | |
---|---|
IFileEntry |
IFileEntry או null אם קובץ ב-path לא יכול
למצוא |
קליעות | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
עוזר לא רשמי לקבל FileEntry
מנתיב שאינו שורש. FIXME: ארגון מחדש של הקוד
מערכת FileEntry כדי שתהיה זמינה מכל נתיב. (גם לא ברמה הבסיסית)
פרמטרים | |
---|---|
entry |
FileListingService.FileEntry : FileEntry לא בהכרח שורש כפי שנדרש ב-Ddmlib. |
החזרות | |
---|---|
IFileEntry |
FileEntryWrapper שמייצג את FileEntry. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
הפונקציה מחזירה את רשימת המצבים המתקפלים במכשיר. אפשר לקבל באמצעות הערך 'cmd device_state' מצבי הדפסה".
החזרות | |
---|---|
|
קליעות | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
הפונקציה מחזירה הפניה ל-ddmlib IDevice
המשויך.
ייתכן שיקצה IDevice
חדש על ידי DDMS בכל פעם שהמכשיר יתנתק
מתחבר מחדש מ-adb. לכן המתקשרים לא צריכים לשמור הפניה אל IDevice
,
כי ההפניה הזו עלולה להפוך למיושנת.
החזרות | |
---|---|
IDevice |
IDevice |
getInstalledPackageNames
publicgetInstalledPackageNames ()
אחזר את שמות החבילות של האפליקציות שקיימים במכשיר.
החזרות | |
---|---|
|
ERROR(/Set) מתוך String שמות של חבילות המותקנים כרגע במכשיר. |
קליעות | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
מחזירה ערך מספר שלם של המאפיין הנתון מהמכשיר.
פרמטרים | |
---|---|
name |
String : שם הנכס |
defaultValue |
long : ערך ברירת המחדל שיוחזר אם הנכס ריק או לא קיים. |
החזרות | |
---|---|
long |
ערך המאפיין או defaultValue אם הנכס ריק, לא קיים,
או שאין לו ערך מסוג מספר שלם. |
קליעות | |
---|---|
DeviceNotAvailableException |
getIpAddress
public String getIpAddress ()
מקבלת את כתובת ה-IP של המכשיר.
החזרות | |
---|---|
String |
כתובת ה-IP של המכשיר, או null אם למכשיר אין כתובת IP |
קליעות | |
---|---|
DeviceNotAvailableException |
getKeyGuardState
public KeyguardControllerState getKeyguardState ()
החזרת אובייקט כדי לקבל את המצב הנוכחי של KeyGuard או כ-null אם אין תמיכה בו.
החזרות | |
---|---|
KeyguardControllerState |
KeyguardControllerState שמכיל תמונת מצב של מצב מגן המפתח
ומחזירה את הערך Null אם שאילתת KeyGuard לא נתמכת. |
קליעות | |
---|---|
DeviceNotAvailableException |
getLastExpectedDefaultTimeMillis
public long getLastExpectedRebootTimeMillis ()
פונקציה זו מחזירה את הפעם האחרונה שבה ממשקי API של TradeFederal הפעילו הפעלה מחדש באלפיות השנייה מאז EPOCH כ-
הוחזרו על ידי System.currentTimeMillis()
.
החזרות | |
---|---|
long |
getLaunchApiLevel
public int getLaunchApiLevel ()
מקבלים את רמת ה-API הראשונה שהושקה במכשיר. ברירת המחדל היא UNKNOWN_API_LEVEL
.
החזרות | |
---|---|
int |
מספר שלם שמציין את רמת ה-API הראשונה של המכשיר שהושקה |
קליעות | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
תופסת רצף snapshot של נתוני ה-Logcat.
פועל בשני מצבים:
TestDeviceOptions.getMaxLogcatDataSize()
בייטים מהתוכן הנוכחי של הרקע
לכידת Logcat
החזרות | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
תופס זרם של תמונת מצב של maxBytes
נתוני ה-Logcat שתועדו.
כדאי להשתמש באפשרות הזו במקרים שבהם רוצים לתעד תמונות מצב בתדירות גבוהה של נתוני ה-Logcat שתועדו.
מבלי לגזול עונש גדול שעלול להיות גדול במקום האחסון בכונן של השגת קובץ ה-snapshot של getLogcat()
.
פרמטרים | |
---|---|
maxBytes |
int : כמות הנתונים המקסימלית שצריך להחזיר. צריך להיות סכום שיכול להיות
מתאימות בצורה נוחה לזיכרון |
החזרות | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
אחזור של קובץ ה-Dump של ה-Logcat הנוכחי במכשיר. בניגוד ל-getLogcat()
, השיטה הזו
מחזיר תמיד קובץ dump סטטי של ה-Logcat.
החיסרון הוא ששום דבר לא יוחזר אם אי אפשר להשיג את המכשיר.
החזרות | |
---|---|
InputStreamSource |
InputStreamSource של נתוני ה-Logcat. אם תיכשל, מוחזר זרם ריק
כדי לתעד נתוני Logcat. |
getLogcatAfter
public InputStreamSource getLogcatSince (long date)
יוצר זרם snapshot של נתוני Logcat שתועדו החל מהתאריך שצוין. השעה ב-
יש להשתמש במכשיר getDeviceDate()
.
פרמטרים | |
---|---|
date |
long : באלפיות השנייה מאז תחילת התקופה של זמן ההפעלה של קובץ ה-snapshot ועד היום.
(אפשר לקבל את הערך הזה באמצעות 'date +%s') |
החזרות | |
---|---|
InputStreamSource |
getMacAddress
public String getMacAddress ()
מחזירה את כתובת ה-MAC של המכשיר, null אם לא ניתן לשלוח שאילתה מהמכשיר.
החזרות | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
הפונקציה מחזירה את מזהה המשתמש הראשי.
החזרות | |
---|---|
Integer |
מזהה המשתמש של המשתמש הראשי אם קיים, ו-null אם אין משתמש ראשי. |
קליעות | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
קבלת המידע על המודולים של השורה הראשית שמותקנים במכשיר.
החזרות | |
---|---|
|
ERROR(/Set) מתוך String מודולים של השורה הראשית שמותקנים כרגע במכשיר. |
קליעות | |
---|---|
DeviceNotAvailableException |
getMaxNumberOf runningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
קבלת המספר המקסימלי של משתמשים פעילים נתמכים בו-זמנית. ברירת המחדל היא 0.
החזרות | |
---|---|
int |
מספר שלם שמציין את מספר המשתמשים הפעילים בו-זמנית |
קליעות | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
קבלת המספר המקסימלי של משתמשים נתמכים. ברירת המחדל היא 0.
החזרות | |
---|---|
int |
מספר שלם שמציין את מספר המשתמשים הנתמכים |
קליעות | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
החזרות | |
---|---|
Process |
מחזירה את התהליך של ה-VM של Microdroid. אם TestDevice הוא לא Microdroid null. |
getMonitor
public IDeviceStateMonitor getMonitor ()
החזרת IDeviceStateMonitor
המשויך למכשיר.
החזרות | |
---|---|
IDeviceStateMonitor |
getMountPoint
public String getMountPoint (String mountName)
מחזירה נקודת טעינה.
שליחת שאילתות ישירות למכשיר אם המידע שנשמר במטמון ב-IDevice
לא זמין.
TODO: העברת ההתנהגות הזו אל IDevice#getMountPoint(String)
פרמטרים | |
---|---|
mountName |
String : השם של נקודת הטעינה |
החזרות | |
---|---|
String |
נקודת הטעינה או null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
הפונקציה מחזירה MountPointInfo
שתואם לנתיב נקודת הטעינה שצוין, או
null
אם לא נטען דבר בנתיב הזה או שהוא לא מופיע
/proc/Loads כנקודת טעינה.
פרמטרים | |
---|---|
mountpoint |
String |
החזרות | |
---|---|
ITestDevice.MountPointInfo |
ERROR(/List) מתוך MountPointInfo שמכילים את המידע ב-"/proc/Loads" |
קליעות | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
החזרת גרסה מנותחת של המידע ב- /proc/Loads במכשיר
החזרות | |
---|---|
|
ERROR(/List) מתוך MountPointInfo שמכילים את המידע ב-"/proc/Loads" |
קליעות | |
---|---|
DeviceNotAvailableException |
getOptions
public TestDeviceOptions getOptions ()
מאחזרים את אפשרויות הבדיקה של המכשיר.
החזרות | |
---|---|
TestDeviceOptions |
TestDeviceOptions קשור למכשיר בבדיקה. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
שיטה שעוזרת לקבוע את נפח האחסון הפנוי במחיצה במכשיר.
פרמטרים | |
---|---|
partition |
String |
החזרות | |
---|---|
long |
כמות השטח הפנוי ב-KB |
קליעות | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId
public Integer getPrimaryUserId ()
מחזירה את מזהה המשתמש הראשי.
החזרות | |
---|---|
Integer |
מזהה המשתמש של המשתמש הראשי אם קיים, ו-null אם אין משתמש ראשי. |
קליעות | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
שיטת העזרה מפעילה את ה-"pidof" ו-stat הפקודה ומחזירה את האובייקט ProcessInfo
עם
PID ושעת ההתחלה של התהליך של התהליך הנתון.
פרמטרים | |
---|---|
processName |
String : מחרוזת שם התהליך. |
החזרות | |
---|---|
ProcessInfo |
ProcessInfo שלProcessName הנתון |
קליעות | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
מחזירה את ה-pid של השירות או את הערך null אם משהו השתבש.
פרמטרים | |
---|---|
process |
String : מחרוזת שם הפרויקט (proces). |
החזרות | |
---|---|
String |
קליעות | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
שיטת נוחות לקבלת סוג המוצר של המכשיר הזה.
השיטה הזו תפעל אם המכשיר נמצא במצב adb או אתחול מהיר (fastboot).
החזרות | |
---|---|
String |
השם של סוג המוצר String . לא יהיה null |
קליעות | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
שיטת נוחות לקבלת וריאציית המוצר של המכשיר הזה.
השיטה הזו תפעל אם המכשיר נמצא במצב adb או אתחול מהיר (fastboot).
החזרות | |
---|---|
String |
השם של וריאציית המוצר String או null אם הוא לא יכול
נקבע |
קליעות | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
מאחזרים את ערך המאפיין הנתון מהמכשיר.
פרמטרים | |
---|---|
name |
String : שם הנכס |
החזרות | |
---|---|
String |
ערך הנכס או null אם הוא לא קיים |
קליעות | |
---|---|
DeviceNotAvailableException |
getrecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
משתמשים במצב השחזור הנוכחי של המכשיר.
החזרות | |
---|---|
ITestDevice.RecoveryMode |
מצב השחזור הנוכחי שמשמש את המכשיר. |
getצילום מסך
public InputStreamSource getScreenshot (String format)
מצלם צילום מסך מהמכשיר. כדי להקטין את הגודל, מומלץ להשתמש במקום זאת בקידוד JPEG(פורמט getצילום מסך) עם קידוד JPEG
פרמטרים | |
---|---|
format |
String : קובץ PNG נתמך, JPEG |
החזרות | |
---|---|
InputStreamSource |
InputStreamSource של צילום המסך בפורמט, או null אם
צילום המסך נכשל. |
קליעות | |
---|---|
DeviceNotAvailableException |
getצילום מסך
public InputStreamSource getScreenshot (long displayId)
מצלם צילום מסך מהמכשיר שצוין למזהה התצוגה. הפורמט הוא PNG.
TODO: הרחבת ההטמעות שלמעלה כדי לתמוך ב-'format' ו'קנה מידה'
פרמטרים | |
---|---|
displayId |
long : מזהה התצוגה של המסך שממנו רוצים לצלם את המסך. |
החזרות | |
---|---|
InputStreamSource |
InputStreamSource של צילום המסך בפורמט, או null אם
צילום המסך נכשל. |
קליעות | |
---|---|
DeviceNotAvailableException |
getצילום מסך
public InputStreamSource getScreenshot (String format, boolean rescale)
מצלם צילום מסך מהמכשיר. מומלץ להשתמש במקום זאת ב-getScreenshot(String)
עם קידוד JPEG לגודל קטן יותר.
פרמטרים | |
---|---|
format |
String : קובץ PNG נתמך, JPEG |
rescale |
boolean : אם צריך לשנות את גודל המסך כדי להקטין את גודל התמונה שמתקבלת |
החזרות | |
---|---|
InputStreamSource |
InputStreamSource של צילום המסך בפורמט, או null אם
צילום המסך נכשל. |
קליעות | |
---|---|
DeviceNotAvailableException |
getצילום מסך
public InputStreamSource getScreenshot ()
מצלם צילום מסך מהמכשיר.
החזרות | |
---|---|
InputStreamSource |
InputStreamSource של צילום המסך בפורמט png, או null אם
צילום המסך נכשל. |
קליעות | |
---|---|
DeviceNotAvailableException |
getSeriesNumber
public String getSerialNumber ()
שיטת נוחות לקבלת המספר הסידורי של המכשיר הזה.
החזרות | |
---|---|
String |
המספר הסידורי String |
הגדרה
public String getSetting (int userId, String namespace, String key)
מחזירה את הערך של ההגדרה המבוקשת. מרחב השמות חייב להיות אחד מהערכים הבאים: {"system", "secure", "global"}
פרמטרים | |
---|---|
userId |
int |
namespace |
String |
key |
String |
החזרות | |
---|---|
String |
הערך שמשויך למפתח namespace:של משתמש. המערכת תציג ערך של null אם לא ניתן למצוא אותו. |
קליעות | |
---|---|
DeviceNotAvailableException |
הגדרה
public String getSetting (String namespace, String key)
הצגת getSetting(int, String, String)
ובוצעה במשתמש מערכת.
פרמטרים | |
---|---|
namespace |
String |
key |
String |
החזרות | |
---|---|
String |
קליעות | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
יש להחזיר את המפעיל של כרטיס ה-SIM או אם הוא לא זמין או אם המכשיר לא זמין.
החזרות | |
---|---|
String |
getSimState
public String getSimState ()
החזרת מצב כרטיס ה-SIM או אפס אם לא זמין או שהמכשיר לא זמין.
החזרות | |
---|---|
String |
getTombstones
publicgetTombstones ()
מאחזרים את רשימת המצבות ומחזירים אותה מהמכשירים. נדרש שורש.
היא הטובה ביותר. לכן אם לא ניתן לשלוף מצבה אחת מסיבה כלשהי, היא תיכשל
חסרים ברשימה. רק DeviceNotAvailableException
יגרום לסיום של השיטה.
מוקדם.
החזרות | |
---|---|
|
רשימה של קובצי מצבות, ריקים אם אין מצבה. |
קליעות | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
פונקציה זו מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים או -1 במקרה של שגיאה פנימית
החזרות | |
---|---|
long |
getTrackingENTER
public String getTrackingSerial ()
למטרות ניהול מכשירים, מקבלים את המספר הסידורי שמשמש למעקב אחרי המכשיר.
החזרות | |
---|---|
String |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
מאחזרים את שמות החבילות של האפליקציות שאפשר להסיר. כרגע הוא מוגדר כך חבילות שאינן של מערכת וחבילות מערכת מעודכנות.
החזרות | |
---|---|
|
ERROR(/Set) משמות החבילות של String שניתן להסיר, המותקנים כרגע
במכשיר. |
קליעות | |
---|---|
DeviceNotAvailableException |
getUseFastbootdelete
public boolean getUseFastbootErase ()
בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר.
החזרות | |
---|---|
boolean |
true אם ייעשה שימוש במחיקה של אתחול מהיר, או false אם ייעשה שימוש בפורמט של אתחול מהיר
. |
getUserflags
public int getUserFlags (int userId)
למצוא ולהחזיר את הדגלים של משתמש נתון. הסימונים מוגדרים ב-"android.content.pm.UserInfo" בכיתה בפרויקט קוד פתוח של Android.
פרמטרים | |
---|---|
userId |
int |
החזרות | |
---|---|
int |
הדגלים המשויכים למזהה המשתמש שצוין, אם נמצא, -10000 במקרים אחרים. |
קליעות | |
---|---|
DeviceNotAvailableException |
getUserInfos
publicgetUserInfos ()
הפונקציה מקבלת את מפת useId אל UserInfo
במכשיר. הפעולה תקפיץ DeviceRuntimeException
אם הפלט מהמכשיר לא תקין.
החזרות | |
---|---|
|
את הרשימה של UserInfo. |
קליעות | |
---|---|
DeviceNotAvailableException |
getUserSeriesNumber
public int getUserSerialNumber (int userId)
אם נמצא, יש להחזיר את המספר הסידורי שמשויך למזהה המשתמש, -10000 במקרים אחרים.
פרמטרים | |
---|---|
userId |
int |
החזרות | |
---|---|
int |
קליעות | |
---|---|
DeviceNotAvailableException |
headAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
מעבדים את ה-DeviceEvent הנתון. עשוי להעביר את המכשיר
למצב החדש. יודיע לIDeviceMonitor
על מעברים בין מדינות.
לעבד את DeviceEvent, שעשוי להעביר את המכשיר הזה להקצאה חדשה או לא להעביר אותו .
פרמטרים | |
---|---|
event |
DeviceEvent |
החזרות | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
בודקים אם התכונה זמינה במכשיר.
פרמטרים | |
---|---|
feature |
String : איזה פורמט צריך להיות "feature: |
החזרות | |
---|---|
boolean |
True אם התכונה נמצאת, אחרת False. |
קליעות | |
---|---|
DeviceNotAvailableException |
חבילת התקנה
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
מתקינים חבילת Android במכשיר.
פרמטרים | |
---|---|
packageFile |
File : קובץ ה-APK להתקנה |
reinstall |
boolean : true אם יש לבצע התקנה מחדש |
extraArgs |
String : ארגומנטים נוספים שרוצים להעביר. למידע נוסף: 'adb Shell pm -h' עבור זמינים
אפשרויות. |
החזרות | |
---|---|
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
חבילת התקנה
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
מתקינים חבילת Android במכשיר.
הערה: רק תרחישים לדוגמה שדורשים שליטה מפורשת בהענקת הרשאה בתחילת ההפעלה ב צריך להפעיל את הפונקציה הזו בזמן ההתקנה.
פרמטרים | |
---|---|
packageFile |
File : קובץ ה-APK להתקנה |
reinstall |
boolean : true אם יש לבצע התקנה מחדש |
grantPermissions |
boolean : אם צריך להעניק את כל ההרשאות בזמן הריצה בזמן ההתקנה |
extraArgs |
String : ארגומנטים נוספים שרוצים להעביר. למידע נוסף: 'adb Shell pm -h' עבור זמינים
אפשרויות. |
החזרות | |
---|---|
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
התקנהPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
התקנת חבילת Android במכשיר של משתמש מסוים.
פרמטרים | |
---|---|
packageFile |
File : קובץ ה-APK להתקנה |
reinstall |
boolean : true אם יש לבצע התקנה מחדש |
userId |
int : מספר המשתמש השלם שרוצים להתקין. |
extraArgs |
String : ארגומנטים נוספים שרוצים להעביר. למידע נוסף: 'adb Shell pm -h' עבור זמינים
אפשרויות. |
החזרות | |
---|---|
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
התקנהPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
התקנת חבילת Android במכשיר של משתמש מסוים.
הערה: רק תרחישים לדוגמה שדורשים שליטה מפורשת בהענקת הרשאה בתחילת ההפעלה ב צריך להפעיל את הפונקציה הזו בזמן ההתקנה.
פרמטרים | |
---|---|
packageFile |
File : קובץ ה-APK להתקנה |
reinstall |
boolean : true אם יש לבצע התקנה מחדש |
grantPermissions |
boolean : אם צריך להעניק את כל ההרשאות בזמן הריצה בזמן ההתקנה |
userId |
int : מספר המשתמש השלם שרוצים להתקין. |
extraArgs |
String : ארגומנטים נוספים שרוצים להעביר. למידע נוסף: 'adb Shell pm -h' עבור זמינים
אפשרויות. |
החזרות | |
---|---|
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
inVerifyPropertycache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
החזרות | |
---|---|
boolean |
isAppEnumeration נתמך
public boolean isAppEnumerationSupported ()
בדיקה אם הפלטפורמה במכשיר תומכת בספירת אפליקציות
החזרות | |
---|---|
boolean |
True אם יש תמיכה בספירת אפליקציות, FALSE אם לא יש תמיכה בספירת אפליקציות |
קליעות | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
בדיקה אם הפלטפורמה במכשיר תומכת בעקיפה של חסימת SDK עם יעדים נמוכים בהתקנות של אפליקציות
החזרות | |
---|---|
boolean |
הערך הוא True אם יש תמיכה בעקיפה של בלוק SDK עם יעד נמוך, False אם לא |
קליעות | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
בודקים אם רכיבי ניפוי הבאגים טענו.
החזרות | |
---|---|
boolean |
true אם רכיבי ניפוי הבאגים נטענים |
קליעות | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypt
public boolean isDeviceEncrypted ()
הפונקציה מחזירה אם המכשיר מוצפן.
החזרות | |
---|---|
boolean |
true אם המכשיר מוצפן. |
קליעות | |
---|---|
DeviceNotAvailableException |
הוא ספרייה
public boolean isDirectory (String path)
פונקציה זו מחזירה את הערך True אם הנתיב במכשיר הוא ספרייה. אחרת, הערך false.
פרמטרים | |
---|---|
path |
String |
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot
public boolean isEnableAdbRoot ()
החזרות | |
---|---|
boolean |
true אם צריך להפעיל את הרמה הבסיסית (root) במכשיר |
isEncryptionsupported
public boolean isEncryptionSupported ()
הפונקציה מחזירה אם המכשיר תומך בהצפנה.
החזרות | |
---|---|
boolean |
true אם המכשיר תומך בהצפנה. |
קליעות | |
---|---|
DeviceNotAvailableException |
ניתן להפעלה
public boolean isExecutable (String fullPath)
הפונקציה מחזירה את הערך True אם נתיב הקובץ במכשיר הוא קובץ להפעלה. אחרת, False.
פרמטרים | |
---|---|
fullPath |
String |
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
הפרמטר isFastbootEnabled
public boolean isFastbootEnabled ()
צריך לחזור אם התכונה 'אתחול מהיר' זמינה במכשיר.
החזרות | |
---|---|
boolean |
ללא GUI
public boolean isHeadless ()
פונקציה זו מחזירה את הערך true אם המכשיר ללא GUI (ללא מסך). אחרת, הערך false.
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
מחזירה אם המכשיר משתמש במצב משתמש במערכת ללא GUI.
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
הפונקציה מחזירה אם המשתמש הראשי הוא אדמין קבוע ולא ניתן למחוק או לשדרג אותו לאחור ל- ללא הרשאת אדמין.
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
isMultiUserSupported
public boolean isMultiUserSupported ()
המדיניות קובעת אם יש תמיכה בריבוי משתמשים.
החזרות | |
---|---|
boolean |
true אם יש תמיכה בריבוי משתמשים, FALSE אם יש תמיכה בריבוי משתמשים, אחרת |
קליעות | |
---|---|
DeviceNotAvailableException |
isPackageInstalled (בהתקנה)
public boolean isPackageInstalled (String packageName, String userId)
שולחים למכשיר שאילתות לגבי שם חבילה נתון ומזהה משתמש כדי לבדוק אם החבילה הנוכחית מותקנת או לא עבור המשתמש הזה.
פרמטרים | |
---|---|
packageName |
String : החבילה שאנחנו בודקים אם היא מותקנת. |
userId |
String : מזהה המשתמש שאנחנו בודקים שהחבילה מותקנת עבורו. אם הערך הוא null, המשתמש הראשי
המערכת תשתמש באפס. |
החזרות | |
---|---|
boolean |
הערך יהיה True אם החבילה מדווחת כאפליקציה שהותקנה. אחרת, שקרית. |
קליעות | |
---|---|
DeviceNotAvailableException |
isPackageInstalled (בהתקנה)
public boolean isPackageInstalled (String packageName)
שולחים למכשיר שאילתה על שם חבילה מסוים כדי לבדוק אם הוא מותקן כרגע או לא.
פרמטרים | |
---|---|
packageName |
String |
החזרות | |
---|---|
boolean |
הערך יהיה True אם החבילה מדווחת כאפליקציה שהותקנה. אחרת, שקרית. |
קליעות | |
---|---|
DeviceNotAvailableException |
נתמך
public boolean isRuntimePermissionSupported ()
בדיקה אם הפלטפורמה במכשיר תומכת בהענקת הרשאות בתחילת ההפעלה
החזרות | |
---|---|
boolean |
הערך הוא True אם יש תמיכה בהרשאה בתחילת ההפעלה, או FALSE אם יש תמיכה בהרשאה. |
קליעות | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
הפונקציה מחזירה את הערך True אם המכשיר נמצא ב-TestDeviceState#FASTBOOT
או ב-TestDeviceState.FASTBOOTD
.
החזרות | |
---|---|
boolean |
isUser running
public boolean isUserRunning (int userId)
בודקים אם משתמש מסוים פועל.
פרמטרים | |
---|---|
userId |
int |
החזרות | |
---|---|
boolean |
הערך הוא True אם המשתמש פועל, בכל מקרה אחר הערך False. |
קליעות | |
---|---|
DeviceNotAvailableException |
isUsersecondary
public boolean isUserSecondary (int userId)
מחזירה אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.
פרמטרים | |
---|---|
userId |
int |
החזרות | |
---|---|
boolean |
true אם המשתמש הוא משני, אחרת false. |
קליעות | |
---|---|
DeviceNotAvailableException |
isUserצג
public boolean isUserVisible (int userId)
הפונקציה בודקת אם המשתמש הנתון גלוי.
A "גלוי" הוא משתמש שמקיים אינטראקציה עם ולכן הוא יכול להפעיל פעילויות הפעלה (בדרך כלל בתצוגת ברירת המחדל).
פרמטרים | |
---|---|
userId |
int |
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
isUserVisibilityOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
הפונקציה בודקת אם המשתמש הנתון גלוי במסך הנתון.
A "גלוי" הוא משתמש שמקיים אינטראקציה עם ולכן הוא יכול להשיק פעילויות בתצוגה הזאת.
פרמטרים | |
---|---|
userId |
int |
displayId |
int |
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
isdisplayBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
הפונקציה מחזירה אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע ב-ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
אם כן, אפשר להתקשר אל startVisibleBackgroundUser(int, int, boolean)
, להעביר
תצוגה שהוחזרה על ידי listDisplayIdsForStartingVisibleBackgroundUsers()
(ש
צריך לכלול את ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
isViewBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
הפונקציה מחזירה אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע.
אם כן, אפשר להתקשר אל startVisibleBackgroundUser(int, int, boolean)
, להעביר
תצוגה שהוחזרה על ידי listDisplayIdsForStartingVisibleBackgroundUsers()
.
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
תואם ל-Wi-Fi
public boolean isWifiEnabled ()
יש לבדוק אם ה-Wi-Fi מופעל.
הפונקציה בודקת אם אפשרות ה-Wi-Fi מופעלת במכשיר. שימושי לקביעת סטטוס Wi-Fi לפני בדיקה לא צריך לפעול עם Wi-Fi, למשל בדיקות נתונים סלולריים.
החזרות | |
---|---|
boolean |
true אם ה-Wi-Fi מופעל. false אם האפשרות מושבתת |
קליעות | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
איסוף רשימת מזהי המסכים הזמינים במכשיר, כפי שדווח על ידי dumpsys SurfaceFlinger".
החזרות | |
---|---|
|
רשימת המסכים. ברירת המחדל תמיד מחזירה את הערך 0 שמוגדר כברירת המחדל. |
קליעות | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForSTART visibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
קבלת רשימת המסכים שבהם אפשר להשתמש כדי start a user visible in the background
.
החזרות | |
---|---|
|
קליעות | |
---|---|
DeviceNotAvailableException |
listUsers
publiclistUsers ()
קבלת רשימת המשתמשים במכשיר. המערכת תיקח DeviceRuntimeException
אם הפלט
מהמכשיר, זה לא כצפוי.
החזרות | |
---|---|
|
הרשימה של מזהי המשתמשים. |
קליעות | |
---|---|
DeviceNotAvailableException |
LogAnrs
public boolean logAnrs (ITestLogger logger)
איסוף ורישום של מקרי ANR מהמכשיר.
פרמטרים | |
---|---|
logger |
ITestLogger : ITestLogger לרישום מקרי ה-ANR. |
החזרות | |
---|---|
boolean |
הערך הוא True אם הרישום ביומן בוצע בהצלחה, אחרת False. |
קליעות | |
---|---|
DeviceNotAvailableException |
דוח LogBugreport
public boolean logBugreport (String dataName, ITestLogger listener)
שיטה עוזרת לתעד דוח על באג ולרשום אותו למדווחים.
פרמטרים | |
---|---|
dataName |
String : השם שתחתיו ידווח הדוח על הבאג. |
listener |
ITestLogger : ITestLogger לרישום הדוח על הבאג. |
החזרות | |
---|---|
boolean |
הערך הוא True אם הרישום ביומן בוצע בהצלחה, אחרת False. |
LogOnDevice
public 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 void nonBlockingReboot ()
יוצר פקודה להפעלה מחדש של המכשיר וחוזרת אחרי שהפקודה הושלמה כשהמכשיר לא מחובר גלוי יותר ל-adb.
קליעות | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
שינוי אם צריך לבצע פעולות ספציפיות במכשיר אחרי השורש של adb ולפני שהמכשיר חזר לאינטרנט. הטמעת ברירת המחדל לא כוללת פעולות הוספה. לא מובטח שיופעל adb בשלב הזה.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
שינוי אם צריך לבצע פעולות ספציפיות במכשיר אחרי שחרור הפרמטר adb ולפני כן שהמכשיר יתחבר שוב לאינטרנט. הטמעת ברירת המחדל לא כוללת פעולות נוספות. לא מובטח שהשורש adb יושבת בשלב הזה.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
הגדרת PostBoot
public void postBootSetup ()
יש לפעול לפי ההוראות להגדרת המכשיר כדי לבדוק אותו לאחר כל הפעלה.
צריכה להתבצע קריאה אחרי שהמכשיר מופעל/זמין באופן מלא
בנסיבות רגילות אין צורך לקרוא לשיטה הזו באופן מפורש, צריכים לבצע את השלבים האלה באופן אוטומטי כשמבצעים הפעלה מחדש.
המקום שבו ייתכן שצריך לקרוא לו הוא כאשר המכשיר מופעל מחדש עקב אירועים אחרים (למשל, הפקודה לעדכון אתחול מהיר הושלמה)
קליעות | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
שלבים נוספים לניקוי הנדרש הספציפי למכשיר, שיבוצעו לאחר ההפעלה הושלמה.
פרמטרים | |
---|---|
exception |
Throwable : אם יש כזה, החריג האחרון שגרם לכשל בהפעלה. |
הגדרת הפעלה מראש
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
שלבים נוספים להגדרה הנדרשת ספציפית למכשיר שיבוצעו במכשיר לפני את זרימת ההפעלה.
פרמטרים | |
---|---|
info |
IBuildInfo : ה-IBuildInfo של המכשיר. |
attributes |
MultiMap : המאפיינים שמאוחסנים בהקשר של ההפעלה |
קליעות | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
pullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי.
פרמטרים | |
---|---|
deviceFilePath |
String : הנתיב המוחלט של הקובץ של המקור המרוחק |
localDir |
File : הספרייה המקומית שאליה מייצאים את הקבצים |
userId |
int : מזהה המשתמש שממנו יש לשלוף |
החזרות | |
---|---|
boolean |
true אם הקובץ יישלף. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
pullDir
public boolean pullDir (String deviceFilePath, File localDir)
שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי.
פרמטרים | |
---|---|
deviceFilePath |
String : הנתיב המוחלט של הקובץ של המקור המרוחק |
localDir |
File : הספרייה המקומית שאליה מייצאים את הקבצים |
החזרות | |
---|---|
boolean |
true אם הקובץ יישלף. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile)
אחזור קובץ מהמכשיר.
פרמטרים | |
---|---|
remoteFilePath |
String : הנתיב המוחלט לקובץ במכשיר. |
localFile |
File : הקובץ המקומי שבו שומרים את התוכן. אם השדה לא ריק, התוכן
הוחלף. |
החזרות | |
---|---|
boolean |
true אם הקובץ אוחזר בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath, int userId)
אחזור קובץ מהמכשיר, מאחסן אותו בקובץ ERROR(/File)
מקומי זמני ומחזיר אותו
File
.
פרמטרים | |
---|---|
remoteFilePath |
String : הנתיב המוחלט לקובץ במכשיר. |
userId |
int : מזהה המשתמש שממנו יש לשלוף |
החזרות | |
---|---|
File |
ERROR(/File) שמכיל את התוכן של קובץ המכשיר, או null אם
ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח) |
קליעות | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
אחזור קובץ מהמכשיר, מאחסן אותו בקובץ ERROR(/File)
מקומי זמני ומחזיר אותו
File
.
פרמטרים | |
---|---|
remoteFilePath |
String : הנתיב המוחלט לקובץ במכשיר. |
החזרות | |
---|---|
File |
ERROR(/File) שמכיל את התוכן של קובץ המכשיר, או null אם
ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח) |
קליעות | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
אחזור קובץ מהמכשיר.
פרמטרים | |
---|---|
remoteFilePath |
String : הנתיב המוחלט לקובץ במכשיר. |
localFile |
File : הקובץ המקומי שבו שומרים את התוכן. אם השדה לא ריק, התוכן
הוחלף. |
userId |
int : מזהה המשתמש שממנו יש לשלוף |
החזרות | |
---|---|
boolean |
true אם הקובץ אוחזר בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
אחזור קובץ מהמכשיר והחזרת התוכן שלו.
פרמטרים | |
---|---|
remoteFilePath |
String : הנתיב המוחלט לקובץ במכשיר. |
החזרות | |
---|---|
String |
String שמכיל את התוכן של קובץ המכשיר, או null אם
ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח) |
קליעות | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
שיטת נוחות לאחזור קובץ מהאחסון החיצוני של המכשיר, ומאחסנת אותו
ERROR(/File)
מקומי זמני, ולהחזיר הפניה לאותו File
.
פרמטרים | |
---|---|
remoteFilePath |
String : הנתיב לקובץ במכשיר, ביחס לאחסון החיצוני של המכשיר
נקודת טעינה |
החזרות | |
---|---|
File |
ERROR(/File) שמכיל את התוכן של קובץ המכשיר, או null אם
ההעתקה נכשלה מסיבה כלשהי (כולל בעיות במערכת הקבצים של המארח) |
קליעות | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
דחיפת תוכן של ספריות באופן רקורסיבי למכשיר, ולא כולל ספריות מסוימות לאחר סינון.
פרמטרים | |
---|---|
localFileDir |
File : הספרייה המקומית שרוצים לדחוף |
deviceFilePath |
String : נתיב הקובץ המוחלט של היעד המרוחק |
excludedDirectories |
: קבוצת שמות של ספריות מוחרגות שלא צריך לדחוף. |
החזרות | |
---|---|
boolean |
true אם הקובץ נדחף בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.
פרמטרים | |
---|---|
localFileDir |
File : הספרייה המקומית שרוצים לדחוף |
deviceFilePath |
String : נתיב הקובץ המוחלט של היעד המרוחק |
החזרות | |
---|---|
boolean |
true אם הקובץ נדחף בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.
פרמטרים | |
---|---|
localFileDir |
File : הספרייה המקומית שרוצים לדחוף |
deviceFilePath |
String : נתיב הקובץ המוחלט של היעד המרוחק |
userId |
int : מזהה המשתמש שאליו רוצים להעביר בדחיפה |
החזרות | |
---|---|
boolean |
true אם הקובץ נדחף בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
קובץ PushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
וריאנט של pushFile(File, String)
שיכול גם להעריך את הצורך
עבור ספק התוכן.
פרמטרים | |
---|---|
localFile |
File : הקובץ המקומי לדחיפה |
remoteFilePath |
String : הנתיב המוחלט לקובץ היעד המרוחק |
evaluateContentProviderNeeded |
boolean : האם לבדוק אם אנחנו צריכים את ספק התוכן |
החזרות | |
---|---|
boolean |
true אם הקובץ נדחף בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
קובץ PushFile
public boolean pushFile (File localFile, String remoteFilePath)
דחיפת קובץ למכשיר. שימוש בספק תוכן כברירת מחדל.
פרמטרים | |
---|---|
localFile |
File : הקובץ המקומי לדחיפה |
remoteFilePath |
String : הנתיב המוחלט לקובץ היעד המרוחק |
החזרות | |
---|---|
boolean |
true אם הקובץ נדחף בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
קובץ PushFile
public boolean pushFile (File localFile, String remoteFilePath, int userId)
דחיפת קובץ למכשיר. שימוש בספק תוכן כברירת מחדל.
פרמטרים | |
---|---|
localFile |
File : הקובץ המקומי לדחיפה |
remoteFilePath |
String : הנתיב המוחלט לקובץ היעד המרוחק |
userId |
int : מזהה המשתמש שאליו רוצים לדחוף |
החזרות | |
---|---|
boolean |
true אם הקובץ נדחף בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
PushString
public boolean pushString (String contents, String remoteFilePath)
דחיפת קובץ שנוצר ממחרוזת למכשיר
פרמטרים | |
---|---|
contents |
String : תוכן הקובץ לדחיפה |
remoteFilePath |
String : הנתיב המוחלט לקובץ היעד המרוחק |
החזרות | |
---|---|
boolean |
true אם המחרוזת נדחפה בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
להפעיל מחדש
public void reboot (String reason)
הפעלת המכשיר מחדש למצב adb עם reason
שניתן כדי באופן רציף במהלך ההפעלה מחדש.
החסימה תיחסם עד שהמכשיר יהיה זמין.
אפשר לקבל את הסיבה להפעלה מחדש האחרונה על ידי שליחת שאילתה ברמת המערכת של sys.boot.reason
.
פרמטרים | |
---|---|
reason |
String : הסיבה להפעלה מחדש, או null אם לא צוינה סיבה. |
קליעות | |
---|---|
DeviceNotAvailableException |
להפעיל מחדש
public void reboot ()
הפעלת המכשיר מחדש במצב adb.
החסימה תיחסם עד שהמכשיר יהיה זמין.
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלה מחדש של IntoBootloader
public void rebootIntoBootloader ()
הפעלת המכשיר מחדש במצב תוכנת אתחול.
חסימה עד שהמכשיר יהיה במצב תוכנת אתחול.
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלה מחדש שלIntoFastbootd
public void rebootIntoFastbootd ()
הפעלת המכשיר מחדש במצב אתחול מהיר (fastbootd).
חסימה עד שהמכשיר יופעל במצב אתחול מהיר (fastbootd).
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלה מחדש של התאוששות מאסון
public void rebootIntoRecovery ()
הפעלת המכשיר מחדש במצב adbrecovery.
חסימה עד שהמכשיר יעבור לשחזור
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלה מחדש של IntoSideload
public void rebootIntoSideload ()
הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור)
הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלה מחדש של IntoSideload
public void rebootIntoSideload (boolean autoReboot)
הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור)
הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע
פרמטרים | |
---|---|
autoReboot |
boolean : האם להפעיל מחדש את המכשיר באופן אוטומטי לאחר טעינה ממקור לא ידוע |
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלה מחדש עדאונליין
public void rebootUntilOnline ()
חלופה ל-reboot()
שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלה מחדש עדאונליין
public void rebootUntilOnline (String reason)
חלופה ל-reboot()
שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.
פרמטרים | |
---|---|
reason |
String : הסיבה להפעלה מחדש, או null אם לא צוינה סיבה. |
קליעות | |
---|---|
DeviceNotAvailableException |
substituteUserspace
public void rebootUserspace ()
מופעלת מחדש רק חלק של מרחב המשתמשים במכשיר.
החסימה תיחסם עד שהמכשיר יהיה זמין.
אזהרה. ההפעלה מחדש של מרחב המשתמש נמצאת כרגע בפיתוח פעיל. השימוש בה הוא באחריותך.
קליעות | |
---|---|
DeviceNotAvailableException |
substituteUserspaceBeforeOnline
public void rebootUserspaceUntilOnline ()
חלופה ל-rebootUserspace()
()} שחוסמת רק עד שהמכשיר יהיה אונליין,
גלויים ל-adb.
קליעות | |
---|---|
DeviceNotAvailableException |
מכשיר שחזור
public boolean recoverDevice ()
ניסיונות לשחזר את התקשורת במכשיר.
החזרות | |
---|---|
boolean |
True אם בוצע ניסיון שחזור והצלחתי, הפונקציה מחזירה את הערך False אם המערכת דילגה על השחזור. |
קליעות | |
---|---|
DeviceNotAvailableException |
אם המכשיר לא זמין יותר |
רישוםDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
רישום IDeviceActionReceiver
למכשיר הזה.
כל המכשירים מסוג 'IDeviceActionReceiver
' הרשומים יקבלו הודעה לפני פעולה במכשיר
מתחילה ואחרי שהפעולה במכשיר מסתיימת.
פרמטרים | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : IDeviceActionReceiver שיירשם. |
reloadSystemReadOnly
public void remountSystemReadOnly ()
להגדיר את מחיצת המערכת במכשיר לקריאה בלבד. ייתכן שהמכשיר יופעל מחדש.
קליעות | |
---|---|
DeviceNotAvailableException |
ל-reloadSystemWritable
public void remountSystemWritable ()
הגדרת מחיצת המערכת במכשיר לניתנת לכתיבה. ייתכן שהמכשיר יופעל מחדש.
קליעות | |
---|---|
DeviceNotAvailableException |
טעינה מחדש של ספק קריאה בלבד
public void remountVendorReadOnly ()
מגדירים את מחיצת הספק במכשיר לקריאה בלבד. ייתכן שהמכשיר יופעל מחדש.
קליעות | |
---|---|
DeviceNotAvailableException |
ספק טעינה מחדש
public void remountVendorWritable ()
מגדירים את מחיצת הספק במכשיר לניתנת לכתיבה. ייתכן שהמכשיר יופעל מחדש.
קליעות | |
---|---|
DeviceNotAvailableException |
הסרת אדמין
public boolean removeAdmin (String componentName, int userId)
הסרת מנהל המכשיר הנתון למשתמש הנתון והחזרה של true
אם הפעולה בוצעה בהצלחה, אחרת false
.
פרמטרים | |
---|---|
componentName |
String : מתוך מנהל המכשיר להסרה. |
userId |
int : מהמשתמשים שהאדמין של המכשיר גר בו. |
החזרות | |
---|---|
boolean |
True אם היא מצליחה, אחרת False. |
קליעות | |
---|---|
DeviceNotAvailableException |
הסרת בעלים
public void removeOwners ()
אתם יכולים להסיר את כל בעלי הפרופילים הקיימים של המכשיר בלי להתאמץ.
קליעות | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
להסיר משתמש נתון מהמכשיר.
פרמטרים | |
---|---|
userId |
int : מהמשתמש שרוצים להסיר |
החזרות | |
---|---|
boolean |
true אם נצליח להסיר את המשתמש, false אם לא נצליח להסיר את המשתמש. |
קליעות | |
---|---|
DeviceNotAvailableException |
איפוסContentProviderSetup
public void resetContentProviderSetup ()
יש לאפס את הסימון להגדרת ספק תוכן כדי להפעיל אותו שוב.
בדיקות runInstrumentationTest
public 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 boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
מריץ בדיקות אינסטרומנטציה ומספק שחזור מכשיר.
אם החיבור למכשיר יתנתק לפני סיום הפעלת הבדיקה והשחזור יצליח, המאזינים יקבלו הודעות לגבי testRunFailed ו-"false" יוחזר. פקודת הבדיקה לא יופעלו מחדש. במקרה הצורך, המתקשרים יוכלו לנסות שוב.
אם החיבור למכשיר מתנתק לפני שהרצת הבדיקה הסתיימה והשחזור נכשל, כל המאזינים יקבלו הודעה לגבי testRunFailed ו-DeviceNotAvailableExt יסומן.
פרמטרים | |
---|---|
runner |
IRemoteAndroidTestRunner : ה-IRemoteAndroidTestRunner שמריץ את הבדיקות |
listeners |
: המאזינים לתוצאת הבדיקה |
החזרות | |
---|---|
boolean |
true אם פקודת הבדיקה הושלמה. false אם הפעולה נכשלה
הפעולה הושלמה עקב חריגת תקשורת במכשיר, אבל השחזור הסתיים בהצלחה |
קליעות | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public 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 boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
דומה ל-ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
, אבל מריץ את הבדיקה עבור משתמש נתון.
פרמטרים | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
הגדרה
public void setConfiguration (IConfiguration configuration)
החדרת IConfiguration
בשימוש.
פרמטרים | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
פרמטרים | |
---|---|
avdInfo |
GceAvdInfo |
setDate (תאריך הגדרה)
public void setDate (Date date)
מגדיר את התאריך במכשיר
הערה: הגדרת תאריך במכשיר מחייבת הרמה הבסיסית (root)
פרמטרים | |
---|---|
date |
Date : לציין תאריך מסוים; ישתמש בתאריך המארח אם null |
קליעות | |
---|---|
DeviceNotAvailableException |
setDeviceOwner (הבעלים של המכשיר)
public boolean setDeviceOwner (String componentName, int userId)
הגדרת רכיב של מנהל מכשיר כבעלים של המכשיר במשתמש הנתון.
פרמטרים | |
---|---|
componentName |
String : של אדמין המכשיר להיות הבעלים של המכשיר. |
userId |
int : של המשתמש שבו גר בעל המכשיר. |
החזרות | |
---|---|
boolean |
True אם היא מצליחה, אחרת False. |
קליעות | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
מעדכנים את מצב המכשיר.
פרמטרים | |
---|---|
deviceState |
TestDeviceState : TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
כדי שהאמולטור SizeLimitedOutputStream
ירשום את הפלט ביומן
פרמטרים | |
---|---|
output |
SizeLimitedOutputStream : לרישום הפלט ביומן |
setEmulatorProcess
public void setEmulatorProcess (Process p)
המדיניות הזו מגדירה את Process
, כשהמכשיר הזה הוא אמולטור.
פרמטרים | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
מגדירים את האפשרות לאתחול מהיר (Fastboot) במכשיר. יש להגדיר כשהמכשיר הראשון שהוקצו.
פרמטרים | |
---|---|
fastbootEnabled |
boolean : אם התכונה 'אתחול מהיר' זמינה למכשיר או לא |
setFastbootPath
public void setFastbootPath (String fastbootPath)
מגדיר את הנתיב לקובץ הבינארי של אתחול מהיר שבו יש להשתמש.
כדי להפעיל פונקציות של אתחול מהיר (fastboot), עדיין צריך להגדיר את isFastbootEnabled()
כ-True.
פרמטרים | |
---|---|
fastbootPath |
String |
setIDevice
public void setIDevice (IDevice newDevice)
עדכון ה-IDevice המשויך ל-ITestDevice הזה.
ה-IDevice החדש חייב להפנות את אותו מכשיר פיזי שאליו מפנה ההפניה הנוכחית. השיטה הזו תתבצע שיחה אם DDMS הקצה IDevice חדש
פרמטרים | |
---|---|
newDevice |
IDevice : IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
הגדרת משך הזמן באלפיות השנייה לפני התחלת צילום Logcat במכשיר אונליין.
פרמטרים | |
---|---|
delay |
int : ההשהיה באלפיות השנייה |
setOptions
public void setOptions (TestDeviceOptions options)
הגדרת TestDeviceOptions
של המכשיר
פרמטרים | |
---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
מגדיר את ערך המאפיין הנתון במכשיר. כדי להגדיר את הערך True, צריך להגדיר את השורש של adb.
פרמטרים | |
---|---|
propKey |
String : המפתח שרוצים להגדיר. |
propValue |
String : ערך המאפיין שרוצים להגדיר. |
החזרות | |
---|---|
boolean |
מחזירה True אם הפקודה setpro בוצעה בהצלחה, אחרת False. |
קליעות | |
---|---|
DeviceNotAvailableException |
הגדרה לשחזור
public void setRecovery (IDeviceRecovery recovery)
הגדרת IDeviceRecovery
לשימוש במכשיר הזה. יש להגדיר כשהמכשיר הראשון
שהוקצו.
פרמטרים | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
הגדרה לשחזור מצב
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
הגדרת מצב השחזור הנוכחי לשימוש במכשיר.
משמש לקביעת שיטת השחזור שבה ייעשה שימוש כאשר קיימת בעיית תקשורת במכשיר המערכת נתקלה בבעיה. מומלץ להשתמש בשיטה הזו רק כשצריך (לדוגמה, כשהמסגרת מושבתת, וכו'
פרמטרים | |
---|---|
mode |
ITestDevice.RecoveryMode : האם יש לבצע שחזור עד למצב אונליין בלבד במצב מופעל או לא. |
הגדרה
public void setSetting (String namespace, String key, String value)
הצגת setSetting(int, String, String, String)
ובוצעה במשתמש מערכת.
פרמטרים | |
---|---|
namespace |
String |
key |
String |
value |
String |
קליעות | |
---|---|
DeviceNotAvailableException |
הגדרה
public void setSetting (int userId, String namespace, String key, String value)
אתם יכולים להוסיף ערך הגדרה למרחב השמות של משתמש נתון. רק חלק מההגדרות יהיו זמינות לאחר הפעלה מחדש. מרחב השמות חייב להיות אחד מהערכים הבאים: {"system", "secure", "global"}
פרמטרים | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
קליעות | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
החדרה של המכונה ITestLogger
פרמטרים | |
---|---|
testLogger |
ITestLogger |
setTrackingENTER
public void setTrackingSerial (String trackingSerial)
למטרות ניהול מכשירים, עוקבים אחרי המספר הסידורי שבו אנחנו משתמשים כדי להתייחס למכשיר.
פרמטרים | |
---|---|
trackingSerial |
String |
setUseFastbootdelete
public void setUseFastbootErase (boolean useFastbootErase)
הגדרה אם להשתמש בפורמט מחיקה של אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי לאפס מחיצה במכשיר.
פרמטרים | |
---|---|
useFastbootErase |
boolean : true אם צריך להשתמש במחיקה של אתחול מהיר (fastboot), או false אם
צריך להשתמש בפורמט אתחול מהיר (fastboot). |
startLogcat
public void startLogcat ()
התחלת הצילום של פלט Logcat מהמכשיר ברקע.
לא תהיה לכך השפעה אם פלט ה-Logcat כבר תועד. אפשר לאחזר את הנתונים מאוחר יותר באמצעות getLogcat.
כשהמכשיר כבר לא בשימוש, צריך לבצע קריאה אל stopLogcat()
.
בדרך כלל לא צריך להתקשר אל startLogcat()
ואל stopLogcat()
כאשר
בהקשר של הפעלה של TF, כי מסגרת TF תתחיל ותפסיק Logcat.
startUser
public boolean startUser (int userId)
מפעיל משתמש מסוים ברקע אם הוא מופסק כרגע. אם המשתמש כבר פועלת ברקע, השיטה הזו היא NOOP.
פרמטרים | |
---|---|
userId |
int : מהמשתמש להתחיל ברקע |
החזרות | |
---|---|
boolean |
true אם המשתמש הופעל בהצלחה ברקע. |
קליעות | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
מפעיל משתמש מסוים ברקע אם הוא מופסק כרגע. אם המשתמש כבר פועלת ברקע, השיטה הזו היא NOOP. ניתן לספק סימון נוסף שצריך להמתין לפעולה שמשפיעה.
פרמטרים | |
---|---|
userId |
int : מהמשתמש להתחיל ברקע |
waitFlag |
boolean : יגרום לפקודה להמתין עד שהמשתמש יתחיל לפעול ויבטל את הנעילה שלו. |
החזרות | |
---|---|
boolean |
true אם המשתמש הופעל בהצלחה ברקע. |
קליעות | |
---|---|
DeviceNotAvailableException |
start visibilityBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
מפעיל משתמש מסוים ברקע, גלוי במסך הנתון (כלומר, מאפשר למשתמש) כדי להפעיל פעילויות בתצוגה הזו).
הערה: הפקודה הזו לא בודקת אם המשתמש קיים, שהתצוגה זמינה, device supports such feature
וכו'.
פרמטרים | |
---|---|
userId |
int : מהמשתמש להתחיל ברקע |
displayId |
int : מסך שבו המשתמש יכול להתחיל לראות אותו |
waitFlag |
boolean : יגרום לפקודה להמתין עד שהמשתמש יתחיל לפעול ויבטל את הנעילה שלו. |
החזרות | |
---|---|
boolean |
true אם המשתמש הופעל ברקע. |
קליעות | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
סוגרים את הפלט של האמולטור ומוחקים אותו.
stopLogcat
public void stopLogcat ()
הפסקת התיעוד של פלט ה-Logcat מהמכשיר ומחיקת נתוני ה-Logcat שנשמרו.
לא תהיה לכך השפעה אם לא יתועד פלט Logcat.
stopUser
public boolean stopUser (int userId)
עוצר משתמש נתון. אם המשתמש כבר עצר, השיטה הזו היא NOOP. לא ניתן להפסיק את המשתמש הנוכחי ואת המשתמש של המערכת.
פרמטרים | |
---|---|
userId |
int : של המשתמש כדי להפסיק. |
החזרות | |
---|---|
boolean |
true אם המשתמש הופסק בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
עצירה של משתמש נתון. אפשר לספק דגלים נוספים כדי להמתין עד שהפעולה תיכנס לתוקף, ולסגור את המשתמש. לא ניתן להפסיק את המשתמש הנוכחי ואת המשתמש של המערכת.
פרמטרים | |
---|---|
userId |
int : של המשתמש כדי להפסיק. |
waitFlag |
boolean : יגרום לפקודה להמתין עד שהמשתמש יופסק. |
forceFlag |
boolean : סגירה ידנית של פעולת המשתמש. |
החזרות | |
---|---|
boolean |
true אם המשתמש הופסק בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
מעבר ל-AdbTcp
public String switchToAdbTcp ()
העברת המכשיר למצב adb-over-tcp.
החזרות | |
---|---|
String |
את המספר הסידורי של ה-tcp או null אם לא ניתן להחליף את המכשיר |
קליעות | |
---|---|
DeviceNotAvailableException |
מעבר ל-AdbUsb
public boolean switchToAdbUsb ()
העברת המכשיר למצב adb על גבי USB.
החזרות | |
---|---|
boolean |
true אם ההעברה בוצעה בהצלחה, false אחרת. |
קליעות | |
---|---|
DeviceNotAvailableException |
מתג משתמש
public boolean switchUser (int userId)
מעבר למזהה משתמש אחר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל. switchUser(int, long)
.
פרמטרים | |
---|---|
userId |
int |
החזרות | |
---|---|
boolean |
הערך הוא True אם ה-User-ID החדש תואם לספק ה-User-ID. אחרת, שקרית. |
קליעות | |
---|---|
DeviceNotAvailableException |
מתג משתמש
public boolean switchUser (int userId, long timeout)
עוברים ל-User-ID אחר עם הזמן הקצוב לתפוגה שצוין כתאריך היעד. ניסיון להשבית את נעילת המקשים לאחר שינוי המשתמש בהצלחה.
פרמטרים | |
---|---|
userId |
int |
timeout |
long : להמתין לפני החזרת FALSE למשתמש-החלפה נכשלה. |
החזרות | |
---|---|
boolean |
הערך הוא True אם ה-User-ID החדש תואם לספק ה-User-ID. אחרת, שקרית. |
קליעות | |
---|---|
DeviceNotAvailableException |
SyncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
סנכרון מצטבר של התוכן של ספריית קבצים מקומית למכשיר.
כדי להחליט אילו קבצים לדחות, המערכת משווה בין חותמות הזמן של קבצים מקומיים לבין השלט הרחוק שלהם שווי ערך. רק 'חדש יותר' או קבצים שלא קיימים, יועברו למכשיר. כלומר, היא צריכה להיות קטנה יחסית אם הקובץ שהוגדר במכשיר כבר עדכני.
המערכת תתעלם מקבצים מוסתרים (עם שמות המתחילים ב-'.').
שימוש לדוגמה: SyncFiles("/tmp/files", "/sdcard") ייצור ספריית sdcard/files אם הוא אינו קיים כבר, וכל התוכן של קובץ /tmp/files דחוף באופן רקורסיבי ל- /sdcard/files.
פרמטרים | |
---|---|
localFileDir |
File : ספריית הקבצים המקומית שמכילה את הקבצים שרוצים לדחוף באופן רקורסיבי. |
deviceFilePath |
String : הרמה הבסיסית (root) של נתיב הקובץ המוחלט של היעד המרוחק. כל הספריות
נתיב הקובץ חייב להיות קריא. כלומר, העברה אל /data/local/tmp כאשר adb אינו Root
ייכשל |
החזרות | |
---|---|
boolean |
true אם הקבצים סונכרנו בהצלחה. אחרת, false . |
קליעות | |
---|---|
DeviceNotAvailableException |
takeBugreport
public Bugreport takeBugreport ()
יוצרים דוח על באג ומחזירים אותו בתוך אובייקט Bugreport
כדי לטפל בו. החזרה ריקה
במקרה של בעיה. צריך לנקות את הקובץ שמצוין באובייקט הדוח על הבאג דרך Bugreport.close()
.
החזרות | |
---|---|
Bugreport |
הסרת החבילה
public String uninstallPackage (String packageName)
מסירים חבילת Android מהמכשיר.
פרמטרים | |
---|---|
packageName |
String : חבילת Android שיש להסיר |
החזרות | |
---|---|
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
removePackageForUser
public String uninstallPackageForUser (String packageName, int userId)
הסרה של חבילת Android מהמכשיר של משתמש מסוים.
פרמטרים | |
---|---|
packageName |
String : חבילת Android שיש להסיר |
userId |
int : מספר המשתמש השלם שרוצים להסיר. |
החזרות | |
---|---|
String |
String עם קוד שגיאה, או null אם הפעולה בוצעה בהצלחה. |
קליעות | |
---|---|
DeviceNotAvailableException |
ביטול נעילת המכשיר
public boolean unlockDevice ()
ביטול נעילת המכשיר אם המכשיר במצב מוצפן.
השיטה הזו עשויה להפעיל מחדש את ה-framework, אבל היא לא תפעילpostBootSetup()
. לכן,
ייתכן שהמכשיר לא יהיה מוכן לגמרי לבדיקה כשהשיטה הזו תחזור.
החזרות | |
---|---|
boolean |
true אם הפעולה בוצעה בהצלחה או אם המכשיר לא מוצפן. |
קליעות | |
---|---|
DeviceNotAvailableException |
ניתוק ניפוי באגים
public void unmountDebugfs ()
ניתוק של ניפוי באגים.
קליעות | |
---|---|
DeviceNotAvailableException |
pendingForBootcomplete
public boolean waitForBootComplete (long timeOut)
הפעולה תיחסם עד שתגדירו את התכונה הניסיונית להשלמת ההפעלה של המכשיר.
פרמטרים | |
---|---|
timeOut |
long : הזמן באלפיות השנייה עד להגדרת הדגל |
החזרות | |
---|---|
boolean |
true אם הדגל השלמת ההפעלה של המכשיר מוגדר במהלך הזמן הקצוב לתפוגה |
קליעות | |
---|---|
DeviceNotAvailableException |
pendingForDeviceAvailable
public boolean waitForDeviceAvailable ()
בהמתנה עד שהמכשיר יגיב וזמין לבדיקה. הגדרת ברירת המחדל של הזמן הקצוב לתפוגה.
החזרות | |
---|---|
boolean |
True אם המכשיר זמין, False אם השחזור מושבת ולא זמין. |
קליעות | |
---|---|
DeviceNotAvailableException |
pendingForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
בהמתנה עד שהמכשיר יגיב וזמין לבדיקה.
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
True אם המכשיר זמין, False אם השחזור מושבת ולא זמין. |
קליעות | |
---|---|
DeviceNotAvailableException |
ListenForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
בהמתנה עד שהמכשיר יגיב וזמין בלי להביא בחשבון את נתיב השחזור.
פרמטרים | |
---|---|
waitTime |
long |
החזרות | |
---|---|
boolean |
הערך הוא True אם המכשיר זמין, או False אם לא זמין. |
קליעות | |
---|---|
DeviceNotAvailableException |
startForDeviceBootloader
public void waitForDeviceBootloader ()
חסימה עד שניתן לראות את המכשיר באמצעות אתחול מהיר (fastboot). שימוש בברירת המחדל של הזמן הקצוב לתפוגה.
קליעות | |
---|---|
DeviceNotAvailableException |
WaitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
חסימה של גישת המכשיר ל'שחזור adb' (שימו לב ששונה מ-
IDeviceRecovery
).
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
true אם המכשיר נכנס למצב שחזור לפני שהתוקף שלו פג.
false אחרת |
ListenForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
חסימה של שילוב המכשיר ב-'adb offload' הסמוי הסופי
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
true אם המכשיר נכנס למצב התקנה ממקור לא ידוע לפני שהתוקף שלו פג. false
אחרת |
startForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
חסימות כדי שהמכשיר לא יהיה זמין, כלומר חסר ב-adb
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
true אם המכשיר לא יהיה זמין לפני שהתוקף יפוג.
false אחרת |
להמתיןForDeviceOnline
public void waitForDeviceOnline ()
חסימה עד שהמכשיר גלוי דרך adb. הגדרת ברירת המחדל של הזמן הקצוב לתפוגה
הערה: לא בטוח שהמכשיר יגיב לפקודות בסיום. כדאי להשתמש
יש גם אפשרות waitForDeviceAvailable()
.
קליעות | |
---|---|
DeviceNotAvailableException |
להמתיןForDeviceOnline
public void waitForDeviceOnline (long waitTime)
חסימה עד שהמכשיר גלוי דרך adb.
הערה: לא בטוח שהמכשיר יגיב לפקודות בסיום. כדאי להשתמש
יש גם אפשרות waitForDeviceAvailable()
.
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
קליעות | |
---|---|
DeviceNotAvailableException |
startForDeviceShell
public boolean waitForDeviceShell (long waitTime)
בהמתנה עד שהמכשיר יגיב לפקודת מעטפת בסיסית של adb.
פרמטרים | |
---|---|
waitTime |
long : משך הזמן באלפיות השנייה |
החזרות | |
---|---|
boolean |
true אם המכשיר מגיב לפני הזמן שחלף waitTime. |
שיטות מוגנות
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
פרמטרים | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
יוצר את פקודת ה-OS עבור הסשן והארגומנטים הנתונים של adb במעטפת
פרמטרים | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
החזרות | |
---|---|
String[] |
CheckApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
פרמטרים | |
---|---|
feature |
String |
strictMinLevel |
int |
createInitialDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
צריך ליצור RebootDeviceAction
שישמש לביצוע פעולת הפעלה מחדש.
פרמטרים | |
---|---|
rebootMode |
NativeDevice.RebootMode : מצב של ההפעלה מחדש. |
reason |
String : להפעלה מחדש. |
החזרות | |
---|---|
NativeDevice.RebootDeviceAction |
RebootDeviceAction שנוצר. |
doAdbRe
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
צריך לבצע הפעלה מחדש של adb.
פרמטרים | |
---|---|
rebootMode |
NativeDevice.RebootMode : מצב של ההפעלה מחדש. |
reason |
String : להפעלה מחדש. |
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
להבטיח RuntimePermissionssupported
protected void ensureRuntimePermissionSupported ()
שיטת עזרה אחרת כדי לגרום לחריגה אם אין תמיכה בהרשאה בתחילת ההפעלה
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
החזרות | |
---|---|
int |
אתחול חיבור
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
פרמטרים | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
קליעות | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
InternalGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
אחזור מאפיין מכשיר, מהמטמון של ddmlib כברירת מחדל, ולחזור אל 'adb' "shell getpro" או 'fastboot getvar', בהתאם לסטטוס ההפעלה של המכשיר – אתחול מהיר או לא.
פרמטרים | |
---|---|
propName |
String : השם של מאפיין המכשיר כפי שהוחזר על ידי 'adb Shell getפרו' |
fastbootVar |
String : השם של המשתנה המקביל מסוג אתחול מהיר לשאילתה. אם null ,
לא יתבצע ניסיון לשאילתת אתחול מהיר (fastboot) |
description |
String : תיאור פשוט של המשתנה. האות הראשונה צריכה להיות אותיות רישיות. |
החזרות | |
---|---|
String |
מחרוזת, אולי null או ריקה, המכילה את הערך של המאפיין הנתון |
קליעות | |
---|---|
DeviceNotAvailableException |
הפעלה מחדש של קריאה חוזרת
protected boolean isInRebootCallback ()
הפונקציה מחזירה אם מתבצע כרגע קריאה חוזרת (callback) להפעלה מחדש או לא. כל ממשקי ה-API הציבוריים עבור אם הערך הוא True, יש להשבית את ההפעלה מחדש.
החזרות | |
---|---|
boolean |
חדש יותר
protected boolean isNewer (File localFile, IFileEntry entry)
אם הקובץ המקומי חדש יותר מהקובץ המרוחק, מוחזר הערך true
. IFileEntry
הוא הערך
מדויק לדקה, במקרה של שווים לזמנים, הקובץ ייחשב חדש יותר.
פרמטרים | |
---|---|
localFile |
File |
entry |
IFileEntry |
החזרות | |
---|---|
boolean |
ההודעה הופעלה מחדש הסתיימה
protected void notifyRebootEnded ()
שליחת התראה לכל IDeviceActionReceiver
על אירוע סיום ההפעלה מחדש.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
ההודעה הופעלה מחדש
protected void notifyRebootStarted ()
שליחת התראה לכל הIDeviceActionReceiver
על אירוע התחלת הפעלה מחדש.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
ביצועפעולה
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
מבצע פעולה במכשיר הזה. יתבצע ניסיון לשחזר את המכשיר, ואם רוצים, יתבצע ניסיון חוזר של הפקודה אם הפעולה נכשלה.
פרמטרים | |
---|---|
actionDescription |
String : תיאור קצר של הפעולה שצריך לבצע. משמש לרישום ביומן
למטרות בלבד. |
action |
NativeDevice.DeviceAction : הפעולה שצריך לבצע |
retryAttempts |
int : הניסיון החוזר מנסה לבצע פעולה אם הוא נכשל אך השחזור מצליח |
החזרות | |
---|---|
boolean |
true אם הפעולה בוצעה בהצלחה |
קליעות | |
---|---|
DeviceNotAvailableException |
אם ניסיון השחזור נכשל או מספר הניסיונות המקסימלי שבוצעו הפעולה בוצעה בהצלחה |
לאחר ההפעלה מחדש
protected void postAdbReboot ()
פעולות נוספות שאפשר לבצע אחרי הפעלה מחדש.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
הגדרת טרום-PostBoot
protected void prePostBootSetup ()
המדיניות מאפשרת לכל סוג מכשיר (AndroidNativeDevice, TestDevice) לשנות את השיטה הזו בשביל לאחר הפעלה ספציפית.
קליעות | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין] |
DeviceNotAvailableException |
pullFile פנימי
protected boolean pullFileInternal (String remoteFilePath, File localFile)
פרמטרים | |
---|---|
remoteFilePath |
String |
localFile |
File |
החזרות | |
---|---|
boolean |
קליעות | |
---|---|
DeviceNotAvailableException |
הגדרת השעון
protected void setClock (Clock clock)
מגדירים את המופע של השעון לשימוש.
פרמטרים | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
סימון ה-TestDevice כ-microdroid ומגדיר את ה-CID שלו.
פרמטרים | |
---|---|
process |
Process : תהליך ה-VM של ה-Microdroid. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
פרמטרים | |
---|---|
deviceOptions |
|
אתחול מהיר פשוט
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
מריצים פקודת אתחול מהירה פשוטה עם משתני סביבה ומדווחים על הסטטוס של הפקודה.
פרמטרים | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
החזרות | |
---|---|
CommandResult |
אתחול מהיר פשוט
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
מפעיל פקודת אתחול מהירה ומדווחים על הסטטוס של הפקודה.
פרמטרים | |
---|---|
timeout |
long |
fullCmd |
String |
החזרות | |
---|---|
CommandResult |
startForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
צריך להמתין כדי לראות שהמכשיר לא זמין (הפסקת הדיווח ל-adb).
פרמטרים | |
---|---|
operationDesc |
String : שם הפעולה שבהמתנה. |
time |
long : זמן ההמתנה עד שהשירות לא זמין. |
החזרות | |
---|---|
boolean |
הערך הוא True אם המכשיר הפך ללא זמין. |