NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

JavaScript.lang.Object
com.android.tradefed.device.NativeDevice


הטמעת ברירת מחדל של מכשירי Android בסטאק ITestDevice שלא במצב מלא.

סיכום

מחלקות מקוננות

class NativeDevice.AdbAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) להרצת מערכת ההפעלה adb .... הפקודה. 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) להפעלה מחדש של המכשיר. 

קבועים

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)

ייווצר TestDevice.

שיטות ציבוריות

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( wifiSsidToPsk, boolean scanSsid)

מתחבר לרשת Wi-Fi.

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

מתחבר לרשת Wi-Fi.

boolean connectToWifiNetwork( wifiSsidToPsk)

התחברות לרשת Wi-Fi.

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)

מתחבר לרשת Wi-Fi.

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)

וריאנט של connectToWifiNetwork(String, String) שמתחבר רק באמצעות המכשיר אין כרגע קישוריות רשת.

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

וריאנט של connectToWifiNetwork(String, String) שמתחבר רק באמצעות המכשיר אין כרגע קישוריות רשת.

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)

הסרה של IDeviceActionReceiver הרשום.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

שיטה מסייעת לבדוק אם המכשיר הופעל מחדש ברכה על ידי השוואה בין השרת system_server הנוכחי השרת הקודם של system_server ProcessInfo.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

שיטה שעוזרת לבדוק אם המכשיר הופעל מחדש החל משעה UTC מאז תחילת התקופה של זמן מערכת במכשיר ERROR(/TimeUnit) שלו.

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, envMap, String... cmdArgs)

שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.

String executeAdbCommand(String... cmdArgs)

שיטת עזרה שמבצעת פקודת adb כפקודת מערכת.

CommandResult executeFastbootCommand(String... cmdArgs)

שיטת עזרה שמפעילה פקודת אתחול מהיר כפקודת מערכת, עם זמן קצוב לתפוגה שמוגדר כברירת מחדל 2 דקות.

CommandResult executeFastbootCommand(long timeout, String... cmdArgs)

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

CommandResult executeLongFastbootCommand(String... cmdArgs)

שיטת עזרה שמבצעת פקודת אתחול מהיר (fastboot) כפקודת מערכת.

CommandResult executeLongFastbootCommand( envVarMap, String... cmdArgs)

שיטת עזרה המבצעת פקודת אתחול מהיר (Fastboot) שרצה במשך זמן רב כפקודת מערכת עם מערכת במשתני סביבה.

String executeShellCommand(String command)

שיטת עזרה שמפעילה פקודת מעטפת מסוג adb ומחזירה את הפלט בתור String.

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, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult, שמאוכלס כראוי בפלט סטטוס הפקודה וב-stderr.

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

שיטת עזרה שמפעילה פקודת מעטפת adb ומחזירה את התוצאות בתור CommandResult, שמאוכלס כראוי בפלט סטטוס הפקודה, ב-stdout וב-stderr.

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

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

הפונקציה מחזירה ערך DeviceDescriptor שנשמר במטמון אם המכשיר מוקצה, אחרת מחזירה את הערך DeviceDescriptor הנוכחי.

String[] getChildren(String path)

לחלופין, אפשר להשתמש ב-IFileEntry שלא עובד לפעמים בגלל הרשאות.

AbstractConnection getConnection()

החיבור הנוכחי שמשויך למכשיר.

ContentProviderHandler getContentProvider(int userId)

הפונקציה מחזירה את הערך ContentProviderHandler או את הערך null אם לא זמין.

DeviceFoldableState getCurrentFoldableState()

מחזירה את מצב המכשיר המתקפל הנוכחי של המכשיר או ערך null אם התרחשו בעיות מסוימות.

int getCurrentUser()

החזרת המזהה של המשתמש הפעיל הנוכחי.

String getDeviceClass()

מקבלים את סיווג המכשיר.

long getDeviceDate()

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

DeviceDescriptor getDeviceDescriptor()

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

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

TestDeviceState getDeviceState()

מאתרים את מצב המכשיר.

long getDeviceTimeOffset(Date date)

עוזר לקבל את הפרש הזמנים בין המכשיר לבין ERROR(/Date) נתון.

InputStreamSource getEmulatorOutput()

מקבלים את הסטרימינג של האמולטור stdout ו-stderr

Process getEmulatorProcess()

מחזירים את הערך Process שתואם לאמולטור הזה.

final File getExecuteShellCommandLog()

היומן שמכיל את כל היומנים של executeShellCommand(String).

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)

עוזר לא רשמי לקבל FileEntry מנתיב שאינו שורש.

getFoldableStates()

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

IDevice getIDevice()

הפונקציה מחזירה הפניה ל-ddmlib IDevice המשויך.

getInstalledPackageNames()

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

long getIntProperty(String name, long defaultValue)

מחזירה ערך מספר שלם של המאפיין הנתון מהמכשיר.

String getIpAddress()

מקבלת את כתובת ה-IP של המכשיר.

KeyguardControllerState getKeyguardState()

החזרת אובייקט כדי לקבל את המצב הנוכחי של KeyGuard או כ-null אם אין תמיכה בו.

long getLastExpectedRebootTimeMillis()

פונקציה זו מחזירה את הפעם האחרונה שבה ממשקי API של Tradeified הפעילו הפעלה מחדש באלפיות השנייה מאז EPOCH בתור הוחזרו על ידי System.currentTimeMillis().

int getLaunchApiLevel()

מקבלים את רמת ה-API הראשונה שהושקה במכשיר.

InputStreamSource getLogcat()

תופסת רצף snapshot של נתוני ה-Logcat.

InputStreamSource getLogcat(int maxBytes)

תופס זרם של תמונת מצב של maxBytes נתוני ה-Logcat שתועדו.

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

החזרת IDeviceStateMonitor המשויך למכשיר.

String getMountPoint(String mountName)

מחזירה נקודת טעינה.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

הפונקציה מחזירה MountPointInfo שתואם לנתיב נקודת הטעינה שצוין, או null אם לא נטען דבר בנתיב הזה או שהוא לא מופיע /proc/Loads כנקודת טעינה.

getMountPointInfo()

החזרת גרסה מנותחת של המידע ב- /proc/Loads במכשיר

TestDeviceOptions getOptions()

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

long getPartitionFreeSpace(String partition)

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

Integer getPrimaryUserId()

מחזירה את מזהה המשתמש הראשי.

ProcessInfo getProcessByName(String processName)

שיטת העזרה מפעילה את ה-"pidof" ו-stat הפקודה ומחזירה את האובייקט ProcessInfo עם PID ושעת ההתחלה של התהליך של התהליך הנתון.

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)

הצגת getSetting(int, String, String) ובוצעה במשתמש מערכת.

String getSimOperator()

יש להחזיר את המפעיל של כרטיס ה-SIM או אם הוא לא זמין או אם המכשיר לא זמין.

String getSimState()

החזרת מצב כרטיס ה-SIM או אפס אם לא זמין או שהמכשיר לא זמין.

getTombstones()

מאחזרים את רשימת המצבות ומחזירים אותה מהמכשירים.

long getTotalMemory()

פונקציה זו מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים או -1 במקרה של שגיאה פנימית

String getTrackingSerial()

למטרות ניהול מכשירים, מקבלים את המספר הסידורי שמשמש למעקב אחרי המכשיר.

getUninstallablePackageNames()

מאחזרים את שמות החבילות של האפליקציות שאפשר להסיר.

boolean getUseFastbootErase()

בחירה אם להשתמש בפורמט מחיקת אתחול מהיר (fastboot) או בפורמט אתחול מהיר (fastboot) כדי למחוק מחיצה במכשיר.

int getUserFlags(int userId)

למצוא ולהחזיר את הדגלים של משתמש נתון.

getUserInfos()

הפונקציה מקבלת את מפת useId אל UserInfo במכשיר.

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 אם המכשיר נמצא ב-TestDeviceState#FASTBOOT או ב-TestDeviceState.FASTBOOTD.

boolean isUserRunning(int userId)

בודקים אם משתמש מסוים פועל.

boolean isUserSecondary(int userId)

מחזירה אם המשתמש שצוין הוא משתמש משני לפי הדגלים שלו.

boolean isUserVisible(int userId)

הפונקציה בודקת אם המשתמש הנתון גלוי.

boolean isUserVisibleOnDisplay(int userId, int displayId)

הפונקציה בודקת אם המשתמש הנתון גלוי במסך הנתון.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

הפונקציה מחזירה אם המכשיר מאפשר למשתמשים להתחיל להיות גלויים ברקע ב-ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

boolean isVisibleBackgroundUsersSupported()

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

boolean isWifiEnabled()

יש לבדוק אם ה-Wi-Fi מופעל.

listDisplayIds()

איסוף רשימת מזהי המסכים הזמינים במכשיר, כפי שדווח על ידי dumpsys SurfaceFlinger".

listDisplayIdsForStartingVisibleBackgroundUsers()

קבלת רשימת המסכים שבהם אפשר להשתמש כדי start a user visible in the background.

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)

אחזור קובץ מהמכשיר, מאחסן אותו בקובץ ERROR(/File) מקומי זמני ומחזיר אותו File.

File pullFile(String remoteFilePath)

אחזור קובץ מהמכשיר, מאחסן אותו בקובץ ERROR(/File) מקומי זמני ומחזיר אותו File.

boolean pullFile(String remoteFilePath, File localFile, int userId)

אחזור קובץ מהמכשיר.

String pullFileContents(String remoteFilePath)

אחזור קובץ מהמכשיר והחזרת התוכן שלו.

File pullFileFromExternal(String remoteFilePath)

שיטת נוחות לאחזור קובץ מהאחסון החיצוני של המכשיר, ומאחסנת אותו ERROR(/File) מקומי זמני, ולהחזיר הפניה לאותו File.

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

דחיפת תוכן של ספריות באופן רקורסיבי למכשיר, ולא כולל ספריות מסוימות לאחר סינון.

boolean pushDir(File localFileDir, String deviceFilePath)

דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.

boolean pushDir(File localFileDir, String deviceFilePath, int userId)

דחיפת תוכן ספרייה למכשיר באופן רקורסיבי.

boolean pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)

וריאנט של pushFile(File, String) שיכול גם להעריך את הצורך עבור ספק התוכן.

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 עם reason שניתן כדי באופן רציף במהלך ההפעלה מחדש.

void reboot()

הפעלת המכשיר מחדש במצב adb.

void rebootIntoBootloader()

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

void rebootIntoFastbootd()

הפעלת המכשיר מחדש במצב אתחול מהיר (fastbootd).

void rebootIntoRecovery()

הפעלת המכשיר מחדש במצב adbrecovery.

void rebootIntoSideload()

הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור)

הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע

void rebootIntoSideload(boolean autoReboot)

הפעלה מחדש של המכשיר במצב adb התקנה ממקור לא ידוע (לתשומת ליבך, זהו מצב מיוחד בתהליך שחזור)

הפעולה תיחסם עד שהמכשיר יעבור למצב התקנה ממקור לא ידוע

void rebootUntilOnline()

חלופה ל-reboot() שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.

void rebootUntilOnline(String reason)

חלופה ל-reboot() שחוסמת רק עד שהמכשיר מחובר לאינטרנט, כלומר גלוי ל-adb.

void rebootUserspace()

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

void rebootUserspaceUntilOnline()

חלופה ל-rebootUserspace() ()} שחוסמת רק עד שהמכשיר יהיה אונליין, גלויים ל-adb.

boolean recoverDevice()

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

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

רישום IDeviceActionReceiver למכשיר הזה.

void remountSystemReadOnly()

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

void remountSystemWritable()

הגדרת מחיצת המערכת במכשיר לניתנת לכתיבה.

void remountVendorReadOnly()

מגדירים את מחיצת הספק במכשיר לקריאה בלבד.

void remountVendorWritable()

מגדירים את מחיצת הספק במכשיר לניתנת לכתיבה.

boolean removeAdmin(String componentName, int userId)

הסרת מנהל המכשיר הנתון למשתמש הנתון והחזרה של true אם הפעולה בוצעה בהצלחה, אחרת false.

void removeOwners()

אתם יכולים להסיר את כל בעלי הפרופילים הקיימים של המכשיר, תוך כדי מאמץ.

boolean removeUser(int userId)

להסיר משתמש נתון מהמכשיר.

void resetContentProviderSetup()

יש לאפס את הסימון להגדרת ספק תוכן כדי להפעיל אותו שוב.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)

שיטת נוחות לביצוע ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) עם אוזן אחד או יותר שמועבר כפרמטרים.

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

מריץ בדיקות אינסטרומנטציה ומספק שחזור מכשיר.

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)), אבל מפעיל את הבדיקה עבור המשתמש הנתון.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

דומה ל-ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), אבל מריץ את הבדיקה עבור משתמש נתון.

void setConfiguration(IConfiguration configuration)

החדרת IConfiguration בשימוש.

final void setConnectionAvdInfo(GceAvdInfo avdInfo)
void setDate(Date date)

מגדיר את התאריך במכשיר

הערה: הגדרת תאריך במכשיר מחייבת הרמה הבסיסית (root)

boolean setDeviceOwner(String componentName, int userId)

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

void setDeviceState(TestDeviceState deviceState)

מעדכנים את מצב המכשיר.

void setEmulatorOutputStream(SizeLimitedOutputStream output)

כדי שהאמולטור SizeLimitedOutputStream ירשום את הפלט ביומן

void setEmulatorProcess(Process p)

המדיניות הזו מגדירה את Process, כשהמכשיר הזה הוא אמולטור.

void setFastbootEnabled(boolean fastbootEnabled)

מגדירים את האפשרות לאתחול מהיר (Fastboot) במכשיר.

void setFastbootPath(String fastbootPath)

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

void setIDevice(IDevice newDevice)

עדכון ה-IDevice המשויך ל-ITestDevice הזה.

void setLogStartDelay(int delay)

הגדרת משך הזמן באלפיות השנייה לפני התחלת צילום Logcat במכשיר אונליין.

void setOptions(TestDeviceOptions options)

הגדרת TestDeviceOptions של המכשיר

boolean setProperty(String propKey, String propValue)

מגדיר את ערך המאפיין הנתון במכשיר.

void setRecovery(IDeviceRecovery recovery)

הגדרת IDeviceRecovery לשימוש במכשיר הזה.

void setRecoveryMode(ITestDevice.RecoveryMode mode)

הגדרת מצב השחזור הנוכחי לשימוש במכשיר.

void setSetting(String namespace, String key, String value)

הצגת setSetting(int, String, String, String) ובוצעה במשתמש מערכת.

void setSetting(int userId, String namespace, String key, String value)

אתם יכולים להוסיף ערך הגדרה למרחב השמות של משתמש נתון.

void setTestLogger(ITestLogger testLogger)

החדרה של המכונה ITestLogger

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)

צריך לעבור ל-User-ID אחר עם זמן קצוב לתפוגה שמוגדר כברירת מחדל.

boolean switchUser(int userId, long timeout)

עוברים ל-User-ID אחר עם הזמן הקצוב לתפוגה שצוין כתאריך היעד.

boolean syncFiles(File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport()

יוצרים דוח על באג ומחזירים אותו בתוך אובייקט Bugreport כדי לטפל בו.

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' (שימו לב ששונה מ- IDeviceRecovery).

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)

צריך ליצור RebootDeviceAction שישמש לביצוע פעולת הפעלה מחדש.

IRunUtil createRunUtil()
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

צריך לבצע הפעלה מחדש של adb.

void ensureRuntimePermissionSupported()

שיטת עזרה אחרת כדי לגרום לחריגה אם אין תמיכה בהרשאה בתחילת ההפעלה

int getApiLevelSafe()
ITestLogger getLogger()
IRunUtil getRunUtil()

מקבלים את המכונה RunUtil כדי להשתמש בה.

void initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
String internalGetProperty(String propName, String fastbootVar, String description)

אחזור מאפיין מכשיר, מהמטמון של ddmlib כברירת מחדל, ולחזור אל 'adb' "shell getpro" או "fastboot getvar", בהתאם לסטטוס ההפעלה של המכשיר הוא Fastboot (אתחול מהיר או לא).

boolean isInRebootCallback()

הפונקציה מחזירה אם מתבצע כרגע קריאה חוזרת (callback) להפעלה מחדש או לא.

boolean isNewer(File localFile, IFileEntry entry)

אם הקובץ המקומי חדש יותר מהקובץ המרוחק, מוחזר הערך true.

void notifyRebootEnded()

שליחת התראה לכל IDeviceActionReceiver על אירוע סיום ההפעלה מחדש.

void notifyRebootStarted()

שליחת התראה לכל הIDeviceActionReceiver על אירוע התחלת הפעלה מחדש.

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( deviceOptions)
CommandResult simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)

מריצים פקודת אתחול מהירה פשוטה עם משתני סביבה ומדווחים על הסטטוס של הפקודה.

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

אפשרויות MOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

בנאים ציבוריים

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

החזרות
boolean true אם הפעולה בוצעה בהצלחה.

קליעות
DeviceNotAvailableException

הפעלת NetworkMonitor

public boolean enableNetworkMonitor ()

הפעלת ניטור רשת במכשיר.

החזרות
boolean true אם המעקב הופעל בהצלחה. false אם הפעולה נכשלה.

קליעות
DeviceNotAvailableException

startAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.

מומלץ להשתמש במקום זאת ב-executeShellCommand(String) ככל האפשר, מספקת שיטה טובה יותר לזיהוי כשלים ולביצועים טובים יותר.

פרמטרים
timeout long: הזמן באלפיות השנייה לפני שהמכשיר נחשב ללא תגובה, 0L ללא זמן קצוב לתפוגה

cmdArgs String: פקודת ה-adb והארגומנטים להרצה

החזרות
String את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה.

קליעות
DeviceNotAvailableException

startAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

שיטה לעזרה שמריצה פקודת adb כפקודת מערכת עם זמן קצוב לתפוגה.

מומלץ להשתמש ב-executeShellCommand(String) במקום זאת ככל האפשר, מספקת שיטה טובה יותר לזיהוי כשלים ולביצועים טובים יותר.

פרמטרים
timeout long: הזמן באלפיות השנייה לפני שהמכשיר נחשב ללא תגובה, 0L ללא זמן קצוב לתפוגה

envMap : הסביבה להגדרה לפקודה

cmdArgs String: פקודת ה-adb והארגומנטים להרצה

החזרות
String את ה-stdout מהפקודה. null אם הפעלת הפקודה נכשלה.

קליעות
DeviceNotAvailableException

startAdbCommand

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

ActivateShellV2Command

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

public  getActiveApexes ()

אחזור המידע על הפעלה של APEX במכשיר.

החזרות
ERROR(/Set) מתוך ApexInfo מופעלים כרגע במכשיר

קליעות
DeviceNotAvailableException

getAllSettings

public  getAllSettings (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

public  getAndroidIds ()

יצירת מפה של מזהי 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

public  getAppPackageInfos ()

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

החזרות
הותקנו 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

public  getBootHistory ()

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

החזרות
מפה של זמן האתחול (זמן UTC בשנייה מאז נקודת ההתחלה) וסיבת האתחול

קליעות
DeviceNotAvailableException

getBootHistoryHistory

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

שיטת העזרה אוספת את המפה של היסטוריית האתחול עם זמן האתחול וסיבת האתחול, כי הזמן שעבר מאז epoch מהמכשיר ומיחידת הזמן שצוינה. המכשיר הנוכחי utcEpochTime ב- ניתן להשיג אלפית שנייה באמצעות השיטה getDeviceDate().

פרמטרים
utcEpochTime long: הזמן שמוגדר במכשיר מאז Epoch.

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' &gt; 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 לא בהכרח Root כפי שנדרש ב-Ddmlib.

החזרות
IFileEntry FileEntryWrapper שמייצג את FileEntry.

קליעות
com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

הפונקציה מחזירה את רשימת המצבים המתקפלים במכשיר. אפשר לקבל באמצעות הערך 'cmd device_state' מצבי הדפסה".

החזרות

קליעות
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

הפונקציה מחזירה הפניה ל-ddmlib IDevice המשויך.

ייתכן שיקצה IDevice חדש על ידי DDMS בכל פעם שהמכשיר יתנתק מתחבר מחדש מ-adb. לכן המתקשרים לא צריכים לשמור הפניה אל IDevice, כי ההפניה הזו עלולה להפוך למיושנת.

החזרות
IDevice IDevice

getInstalledPackageNames

public  getInstalledPackageNames ()

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

החזרות
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.

פועל בשני מצבים:

  • אם ה-Logcat מצולם כרגע ברקע, יחזיר עד TestDeviceOptions.getMaxLogcatDataSize() בייטים מהתוכן הנוכחי של הרקע לכידת Logcat
  • אחרת, יחזיר תמונת מצב סטטית של נתוני ה-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

    public  getMainlineModuleInfo ()

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

    החזרות
    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

    public  getMountPointInfo ()

    החזרת גרסה מנותחת של המידע ב- /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: מחרוזת שם האובייקט.

    החזרות
    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 מצב השחזור הנוכחי שמשמש את המכשיר.

    קבלת צילום מסך

    public InputStreamSource getScreenshot (String format)

    מצלם צילום מסך מהמכשיר. כדי להקטין את הגודל, מומלץ להשתמש במקום זאת בקידוד JPEG(פורמט getצילום מסך) עם קידוד JPEG

    פרמטרים
    format String: קובץ PNG נתמך, JPEG

    החזרות
    InputStreamSource InputStreamSource של צילום המסך בפורמט, או null אם צילום המסך נכשל.

    קליעות
    DeviceNotAvailableException

    קבלת צילום מסך

    public InputStreamSource getScreenshot (long displayId)

    מצלם צילום מסך מהמכשיר שצוין למזהה התצוגה. הפורמט הוא PNG.

    TODO: הרחבת ההטמעות שלמעלה כדי לתמוך ב-'format' ו'קנה מידה'

    פרמטרים
    displayId long: מזהה התצוגה של המסך שממנו רוצים לצלם את המסך.

    החזרות
    InputStreamSource InputStreamSource של צילום המסך בפורמט, או null אם צילום המסך נכשל.

    קליעות
    DeviceNotAvailableException

    קבלת צילום מסך

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    מצלם צילום מסך מהמכשיר. מומלץ להשתמש במקום זאת ב-getScreenshot(String) עם קידוד JPEG לגודל קטן יותר.

    פרמטרים
    format String: קובץ PNG נתמך, JPEG

    rescale boolean: אם צריך לשנות את גודל המסך כדי להקטין את גודל התמונה שמתקבלת

    החזרות
    InputStreamSource InputStreamSource של צילום המסך בפורמט, או null אם צילום המסך נכשל.

    קליעות
    DeviceNotAvailableException

    קבלת צילום מסך

    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

    public  getTombstones ()

    מאחזרים את רשימת המצבות ומחזירים אותה מהמכשירים. נדרש שורש.

    היא הטובה ביותר. לכן אם לא ניתן לשלוף מצבה אחת מסיבה כלשהי, היא תיכשל חסרים ברשימה. רק DeviceNotAvailableException יגרום לסיום של השיטה. מוקדם.

    החזרות
    רשימה של קובצי מצבות, ריקים אם אין מצבה.

    קליעות
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

    פונקציה זו מחזירה את הגודל הכולל של הזיכרון הפיזי בבייטים או -1 במקרה של שגיאה פנימית

    החזרות
    long

    getTrackingENTER

    public String getTrackingSerial ()

    למטרות ניהול מכשירים, מקבלים את המספר הסידורי שמשמש למעקב אחרי המכשיר.

    החזרות
    String

    getUninstallablePackageNames

    public  getUninstallablePackageNames ()

    מאחזרים את שמות החבילות של האפליקציות שאפשר להסיר. כרגע הוא מוגדר כך חבילות שאינן של מערכת וחבילות מערכת מעודכנות.

    החזרות
    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

    public  getUserInfos ()

    הפונקציה מקבלת את מפת 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

    inOAuthPropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    החזרות
    boolean

    קליעות
    DeviceNotAvailableException

    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

    public  listDisplayIds ()

    איסוף רשימת מזהי המסכים הזמינים במכשיר, כפי שדווח על ידי dumpsys SurfaceFlinger".

    החזרות
    רשימת המסכים. ברירת המחדל תמיד מחזירה את הערך 0 שמוגדר כברירת המחדל.

    קליעות
    DeviceNotAvailableException

    listDisplayIdsForOutboundצגBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

    קבלת רשימת המסכים שבהם אפשר להשתמש כדי start a user visible in the background.

    החזרות

    קליעות
    DeviceNotAvailableException

    listUsers

    public  listUsers ()

    קבלת רשימת המשתמשים במכשיר. המערכת תיקח 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 mountDebugfs ()

    טעינה של ניפוי באגים.

    קליעות
    DeviceNotAvailableException

    ללא חסימה מחדש

    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)

    מריץ בדיקות אינסטרומנטציה ומספק שחזור מכשיר.

    אם החיבור למכשיר יתנתק לפני סיום הפעלת הבדיקה והשחזור יצליח, המאזינים יקבלו הודעות לגבי testRunנכשל ו-"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)

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

    startForDeviceInSideload

    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 שנוצר.

    createRunUtil

    protected IRunUtil createRunUtil ()

    החזרות
    IRunUtil

    doAdbאתחול

    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

    getLogger

    protected ITestLogger getLogger ()

    החזרות
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    מקבלים את המכונה RunUtil כדי להשתמש בה.

    החזרות
    IRunUtil

    אתחול חיבור

    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", בהתאם לסטטוס ההפעלה של המכשיר הוא Fastboot (אתחול מהיר או לא).

    פרמטרים
    propName String: השם של מאפיין המכשיר כפי שהוחזר על ידי 'adb Shell getpro'

    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 אם המכשיר הפך ללא זמין.