IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor

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

מכשיר נחשב כרגע 'זמין' אם ארבעה אירועים מתקיימים: 1. המכשיר מחובר לאינטרנט, כלומר גלוי דרך DDMS/adb‏ (waitForDeviceOnline() 2. במכשיר מוגדר הדגל dev.bootcomplete‏ (@link #waitForBootComplete(long)} 3. מנהל החבילות של המכשיר מגיב (יכול להיות שהוא לא פעיל) 4. האחסון החיצוני של המכשיר מחובר 3. & 4. להיות חלק מ-waitForDeviceAvailable().

סיכום

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

default void attachFinalState(TestDeviceState finalState)

אם מגיעים לסטטוס הסופי, צריך לצרף אותו ל-waitForDeviceState כדי לבטל את הפעולה.

abstract TestDeviceState getDeviceState()

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

abstract String getFastbootSerialNumber()

הפונקציה מקבלת את המספר הסידורי של מצב Fastboot.

abstract String getMountPoint(String mountName)

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

abstract String getSerialNumber()

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

abstract boolean isAdbTcp()
abstract void setDefaultAvailableTimeout(long timeoutMs)

הגדרת הזמן (במילי-שניות) להמתנה עד שהמכשיר יהיה זמין ב-waitForDeviceAvailable().

abstract void setDefaultOnlineTimeout(long timeoutMs)

הגדרת הזמן (במילי-שניות) להמתנה עד שהמכשיר יהיה אונליין ב-waitForDeviceOnline().

abstract void setFastbootSerialNumber(String serial)

הגדרת המספר הסידורי של מצב Fastboot.

abstract void setIDevice(IDevice device)

עדכון מכשיר ה-IDevice הנוכחי.

abstract void setState(TestDeviceState deviceState)

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

abstract boolean waitForBootComplete(long waitTime)

נעילה עד להגדרת הדגל של השלמת האתחול במכשיר

abstract IDevice waitForDeviceAvailable(long waitTime)

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

abstract IDevice waitForDeviceAvailable()

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

default IDevice waitForDeviceAvailableInRecoverPath(long waitTime)

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

abstract boolean waitForDeviceBootloader(long waitTime)

המערכת ממתינה עד שהמכשיר יהיה ב-bootloader.

abstract void waitForDeviceBootloaderStateUpdate()

המערכת ממתינה לרענון מצב תוכנת האתחול של המכשיר

abstract boolean waitForDeviceFastbootd(String fastbootPath, long waitTime)

הפונקציה ממתינה עד שהמכשיר יהיה במצב fastbootd.

abstract IDevice waitForDeviceInRecovery()

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

abstract boolean waitForDeviceInRecovery(long waitTime)

ממתינים שהמכשיר יהיה במצב 'adb recovery'

abstract boolean waitForDeviceInSideload(long waitTime)

ממתינים עד שהמכשיר יהיה במצב 'adb sideload'

abstract boolean waitForDeviceNotAvailable(long waitTime)

ממתין עד שהמכשיר לא יהיה זמין

abstract IDevice waitForDeviceOnline()

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

abstract IDevice waitForDeviceOnline(long time)

המערכת ממתינה עד שהמכשיר יתחבר לאינטרנט.

abstract boolean waitForDeviceShell(long waitTime)

הפונקציה ממתינה עד שהמכשיר יגיב לפקודה בסיסית של מעטפת adb.

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

attachFinalState

public void attachFinalState (TestDeviceState finalState)

אם מגיעים לסטטוס הסופי, צריך לצרף אותו ל-waitForDeviceState כדי לבטל את הפעולה.

פרמטרים
finalState TestDeviceState

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

החזרות
TestDeviceState TestDeviceState של המכשיר

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

הפונקציה מקבלת את המספר הסידורי של מצב Fastboot.

החזרות
String

getMountPoint

public abstract String getMountPoint (String mountName)

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

שולחת שאילתה ישירות למכשיר אם המידע ששמור במטמון ב-IDevice לא זמין.

TODO: move this behavior to IDevice.getMountPoint(String)

פרמטרים
mountName String: שם נקודת הטעינה
החזרות
String נקודת הטעינה או null
זריקות
DeviceNotAvailableException

מידע נוסף:

getSerialNumber

public abstract String getSerialNumber ()

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

החזרות
String

isAdbTcp

public abstract boolean isAdbTcp ()

החזרות
boolean true אם המכשיר מחובר ל-adb דרך TCP

setDefaultAvailableTimeout

public abstract void setDefaultAvailableTimeout (long timeoutMs)

הגדרת הזמן (במילי-שניות) להמתנה עד שהמכשיר יהיה זמין ב-waitForDeviceAvailable().

פרמטרים
timeoutMs long

setDefaultOnlineTimeout

public abstract void setDefaultOnlineTimeout (long timeoutMs)

הגדרת הזמן (במילי-שניות) להמתנה עד שהמכשיר יהיה אונליין ב-waitForDeviceOnline().

פרמטרים
timeoutMs long

setFastbootSerialNumber

public abstract void setFastbootSerialNumber (String serial)

הגדרת המספר הסידורי של מצב Fastboot.

פרמטרים
serial String

setIDevice

public abstract void setIDevice (IDevice device)

עדכון מכשיר ה-IDevice הנוכחי.

setState

public abstract void setState (TestDeviceState deviceState)

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

waitForBootComplete

public abstract boolean waitForBootComplete (long waitTime)

נעילה עד להגדרת הדגל של השלמת האתחול במכשיר

פרמטרים
waitTime long: משך ההמתנה באלפיות שנייה
החזרות
boolean

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable (long waitTime)

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

פרמטרים
waitTime long: משך ההמתנה, באלפיות שנייה
החזרות
IDevice IDevice אם המכשיר יתחבר לאינטרנט לפני שפג התוקף. null אחרת.

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

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

זהו ערך מקביל לערך waitForDeviceAvailable(long), אבל הוא משתמש בזמן הקצוב לתפוגה כברירת מחדל להפעלת המכשיר.

החזרות
IDevice IDevice אם המכשיר יתחבר לאינטרנט לפני שפג התוקף. null אחרת.

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

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

פרמטרים
waitTime long

החזרות
IDevice

זריקות
DeviceNotAvailableException אם המכשיר לא זמין.

waitForDeviceBootloader

public abstract boolean waitForDeviceBootloader (long waitTime)

המערכת ממתינה עד שהמכשיר יהיה ב-bootloader.

פרמטרים
waitTime long: משך הזמן המקסימלי להמתנה, במילישניות
החזרות
boolean true אם המכשיר נמצא ב-bootloader לפני שתוקף הזמן יפוג

waitForDeviceBootloaderStateUpdate

public abstract void waitForDeviceBootloaderStateUpdate ()

המערכת ממתינה לרענון מצב תוכנת האתחול של המכשיר

waitForDeviceFastbootd

public abstract boolean waitForDeviceFastbootd (String fastbootPath, 
                long waitTime)

הפונקציה ממתינה עד שהמכשיר יהיה במצב fastbootd.

פרמטרים
fastbootPath String: הנתיב של קובץ ה-binary של fastboot שבו רוצים להשתמש.
waitTime long: משך הזמן המקסימלי להמתנה, במילישניות
החזרות
boolean true אם המכשיר נמצא ב-fastbootd לפני שתוקף הזמן יפוג

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

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

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

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

ממתינים שהמכשיר יהיה במצב 'adb recovery'

פרמטרים
waitTime long: משך הזמן המקסימלי להמתנה, במילישניות
החזרות
boolean הערך True אם המכשיר נמצא במצב שחזור לפני זמן הקצוב לתפוגה, אחרת הערך False.

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

ממתינים עד שהמכשיר יהיה במצב 'adb sideload'

פרמטרים
waitTime long: משך הזמן המקסימלי להמתנה, במילישניות
החזרות
boolean הערך True אם המכשיר נמצא בהעלאה צדדית לפני זמן הקצוב לתפוגה, ו-False אחרת.

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

ממתין עד שהמכשיר לא יהיה זמין

פרמטרים
waitTime long: משך הזמן המקסימלי להמתנה, במילישניות
החזרות
boolean true אם המכשיר לא זמין

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline ()

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

הערה: השיטה הזו תוחזר ברגע שהמכשיר יהיה גלוי דרך DDMS. הפקודה לא מבטיחה שהמכשיר אכן מגיב לפקודות adb – במקום זאת, צריך להשתמש בפקודה waitForDeviceAvailable().

החזרות
IDevice IDevice אם המכשיר יתחבר לאינטרנט לפני שפג התוקף. null אחרת.

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline (long time)

המערכת ממתינה עד שהמכשיר יתחבר לאינטרנט.

הערה: השיטה הזו תוחזר ברגע שהמכשיר יהיה גלוי דרך DDMS. הפקודה לא מבטיחה שהמכשיר אכן מגיב לפקודות adb – במקום זאת, צריך להשתמש בפקודה waitForDeviceAvailable().

פרמטרים
time long: משך הזמן המקסימלי להמתנה, במילישניות
החזרות
IDevice IDevice אם המכשיר יתחבר לאינטרנט לפני שפג התוקף. null אחרת.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

הפונקציה ממתינה עד שהמכשיר יגיב לפקודה בסיסית של מעטפת adb.

פרמטרים
waitTime long: משך ההמתנה, באלפיות שנייה
החזרות
boolean true אם המכשיר מגיב לפני שחולף הזמן waitTime.