IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor

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

מכשיר נחשב כ'זמין' כרגע אך ורק אם 4 אירועים מתקיימים: 1. המכשיר במצב אונליין שניתן לראות אותו גם דרך DDMS/adb (waitForDeviceOnline()) 2. Device has dev.bootcomplete דגל set (@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)

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

abstract void waitForDeviceBootloaderStateUpdate()

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

abstract boolean waitForDeviceFastbootd(String fastbootPath, long waitTime)

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

abstract IDevice waitForDeviceInRecovery()

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

abstract boolean waitForDeviceInRecovery(long waitTime)

ממתין שהמכשיר יהיה ב'שחזור adb' הסמוי הסופי

abstract boolean waitForDeviceInSideload(long waitTime)

ממתין שהמכשיר יופיע ב-'adb offload' הסמוי הסופי

abstract boolean waitForDeviceNotAvailable(long waitTime)

בהמתנה שהמכשיר לא יהיה זמין

abstract IDevice waitForDeviceOnline()

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

abstract IDevice waitForDeviceOnline(long time)

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

abstract boolean waitForDeviceShell(long waitTime)

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

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

addFinalState

public void attachFinalState (TestDeviceState finalState)

יש לצרף מצב סופי כדי לבטל את ההגדרה WaitForDeviceState אם היא זמינה.

פרמטרים
finalState TestDeviceState

getDeviceState

public abstract TestDeviceState getDeviceState ()

מקבל את מצב המכשיר.

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

getFastbootSeriesNumber

public abstract String getFastbootSerialNumber ()

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

החזרות
String

getMountPoint

public abstract String getMountPoint (String mountName)

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

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

TODO: העברת ההתנהגות הזו אל IDevice#getMountPoint(String)

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

למידע נוסף:

getSeriesNumber 

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

setFastbootSeriesNumber

public abstract void setFastbootSerialNumber (String serial)

הגדרת המספר הסידורי של מצב אתחול מהיר (fastboot).

פרמטרים
serial String

setIDevice

public abstract void setIDevice (IDevice device)

מעדכן את ה-IDevice הנוכחי.

setState (הגדרת מצב)

public abstract void setState (TestDeviceState deviceState)

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

pendingForBootcomplete

public abstract boolean waitForBootComplete (long waitTime)

הפעולה תיחסם עד להגדרת הסימון להשלמת ההפעלה של המכשיר

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

pendingForDeviceAvailable

public abstract IDevice waitForDeviceAvailable (long waitTime)

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

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

pendingForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

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

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

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

ListenForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

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

פרמטרים
waitTime long

החזרות
IDevice

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

startForDeviceBootloader

public abstract boolean waitForDeviceBootloader (long waitTime)

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

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

ListenForDeviceBootloaderStateUpdate

public abstract void waitForDeviceBootloaderStateUpdate ()

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

לחכותForDeviceFastbootd

public abstract boolean waitForDeviceFastbootd (String fastbootPath, 
                long waitTime)

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

פרמטרים
fastbootPath String: הנתיב של הקובץ הבינארי של אתחול מהיר שבו יש להשתמש.
waitTime long: משך הזמן המקסימלי באלפיות השנייה
החזרות
boolean true אם במכשיר הופעל אתחול מהיר (fastbootd) לפני שהזמן יפוג

WaitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

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

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

WaitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

ממתין שהמכשיר יהיה ב'שחזור adb' הסמוי הסופי

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

startForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

ממתין שהמכשיר יופיע ב-'adb offload' הסמוי הסופי

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

startForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

בהמתנה שהמכשיר לא יהיה זמין

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

להמתיןForDeviceOnline

public abstract IDevice waitForDeviceOnline ()

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

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

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

להמתיןForDeviceOnline

public abstract IDevice waitForDeviceOnline (long time)

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

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

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

startForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

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