החל משנת 2026, כדי להתאים את התהליך למודל הפיתוח היציב שלנו ולשמור על יציבות הפלטפורמה בסביבה העסקית, נפרסם קוד מקור ב-AOSP ברבעון השני וברבעון הרביעי. כדי ליצור תוספים ל-AOSP ולתרום לו, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main. ענף המניפסט android-latest-release תמיד יפנה לגרסה העדכנית ביותר שנדחפה ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.

WaitDeviceRecovery

public class WaitDeviceRecovery
extends Object implements IDeviceRecovery

java.lang.Object
↳	com.android.tradefed.device.WaitDeviceRecovery

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

סיכום

ערכים קבועים
`int`	`BOOTLOADER_POLL_ATTEMPTS` מספר הניסיונות לבדוק אם המכשיר נמצא בתוכנת האתחול.
`long`	`INITIAL_PAUSE_TIME` הזמן במילישניות להמתנה לפני תחילת ניסיונות השחזור

שדות
`protected long`	`mBootloaderWaitTime`
`protected boolean`	`mDisableUnresponsiveReboot`
`protected boolean`	`mDisableUsbReset`
`protected long`	`mFastbootWaitTime`
`protected long`	`mOnlineWaitTime`
`protected int`	`mRequiredMinBattery`
`protected long`	`mShellWaitTime`
`protected long`	`mWaitTime`

Constructors ציבוריים
`WaitDeviceRecovery()`

‫methods ציבוריים
`void`	`recoverDevice(IDeviceStateMonitor monitor, boolean recoverUntilOnline)` ניסיון לשחזר את המכשיר הנתון, שלא ניתן יותר לתקשר איתו.
`void`	`recoverDeviceBootloader(IDeviceStateMonitor monitor)` מנסים לשחזר את המכשיר הנתון שלא מגיב במצב Bootloader.
`void`	`recoverDeviceFastbootd(IDeviceStateMonitor monitor)` מנסים לשחזר את המכשיר הנתון שלא מגיב במצב fastbootd.
`void`	`recoverDeviceRecovery(IDeviceStateMonitor monitor)` מנסים לשחזר את המכשיר הנתון שלא מגיב במצב שחזור.
`void`	`setFastbootPath(String fastbootPath)` מגדיר את הנתיב לקובץ הבינארי של fastboot שבו יש להשתמש.

שיטות מוגנות
`void`	`checkMinBatteryLevel(IDevice device)` בודק אם רמת הטעינה של הסוללה במכשיר עומדת בדרישת המינימום
`IRunUtil`	`getRunUtil()` משיגים את מופע `RunUtil` שרוצים להשתמש בו.
`void`	`handleDeviceNotAvailable(IDeviceStateMonitor monitor, boolean recoverTillOnline)` טיפול במצב שבו המכשיר לא זמין.
`void`	`handleDeviceUnresponsive(IDevice device, IDeviceStateMonitor monitor)` טיפול במצב שבו המכשיר מחובר לאינטרנט אבל לא מגיב.

ערכים קבועים

BOOTLOADER_POLL_ATTEMPTS

public static final int BOOTLOADER_POLL_ATTEMPTS

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

נחשף לבדיקות יחידה

ערך קבוע: 3 (0x00000003)

INITIAL_PAUSE_TIME

protected static final long INITIAL_PAUSE_TIME

הזמן במילישניות להמתנה לפני תחילת ניסיונות השחזור

ערך קבוע: 5000 (0x0000000000001388)

שדות

mBootloaderWaitTime

protected long mBootloaderWaitTime

mDisableUnresponsiveReboot

protected boolean mDisableUnresponsiveReboot

mDisableUsbReset

protected boolean mDisableUsbReset

mFastbootWaitTime

protected long mFastbootWaitTime

mOnlineWaitTime

protected long mOnlineWaitTime

mRequiredMinBattery

protected int mRequiredMinBattery

mShellWaitTime

protected long mShellWaitTime

mWaitTime

protected long mWaitTime

Constructors ציבוריים

WaitDeviceRecovery

public WaitDeviceRecovery ()

‫methods ציבוריים

recoverDevice

public void recoverDevice (IDeviceStateMonitor monitor, 
                boolean recoverUntilOnline)

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

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

פרמטרים
`monitor`	‫`IDeviceStateMonitor`: `IDeviceStateMonitor` שבו רוצים להשתמש.
`recoverUntilOnline`	‫`boolean`: אם הערך הוא true, ה-method צריך להחזיר ערך ברגע שהמכשיר מחובר אונליין ב-adb. אם הערך הוא False, השיטה צריכה לחסום עד שהמכשיר יהיה זמין באופן מלא לבדיקה (כלומר, `IDeviceStateMonitor.waitForDeviceAvailable()` מצליח).

זריקות
`DeviceNotAvailableException`

recoverDeviceBootloader

public void recoverDeviceBootloader (IDeviceStateMonitor monitor)

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

פרמטרים
`monitor`	‫`IDeviceStateMonitor`: `IDeviceStateMonitor` שבו רוצים להשתמש.

זריקות
`DeviceNotAvailableException`

recoverDeviceFastbootd

public void recoverDeviceFastbootd (IDeviceStateMonitor monitor)

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

פרמטרים
`monitor`	‫`IDeviceStateMonitor`: `IDeviceStateMonitor` שבו רוצים להשתמש.

זריקות
`DeviceNotAvailableException`

recoverDeviceRecovery

public void recoverDeviceRecovery (IDeviceStateMonitor monitor)

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

פרמטרים
`monitor`	‫`IDeviceStateMonitor`: `IDeviceStateMonitor` שבו רוצים להשתמש.

זריקות
`DeviceNotAvailableException`

setFastbootPath

public void setFastbootPath (String fastbootPath)

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

פרמטרים
`fastbootPath`	‫`String`: `String` שמגדיר את הנתיב לקובץ הבינארי של fastboot.

שיטות מוגנות

checkMinBatteryLevel

protected void checkMinBatteryLevel (IDevice device)

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

זריקות
`DeviceNotAvailableException`	אם אי אפשר לקרוא את רמת הטעינה של הסוללה או שהיא נמוכה מהרמה המינימלית

getRunUtil

protected IRunUtil getRunUtil ()

משיגים את מופע RunUtil שרוצים להשתמש בו.

החשיפה היא לצורך בדיקות יחידה.

החזרות
`IRunUtil`

handleDeviceNotAvailable

protected void handleDeviceNotAvailable (IDeviceStateMonitor monitor, 
                boolean recoverTillOnline)

טיפול במצב שבו המכשיר לא זמין.

פרמטרים
`monitor`	‫`IDeviceStateMonitor`: `IDeviceStateMonitor`
`recoverTillOnline`	‫`boolean`: אם הערך הוא true, השיטה הזו אמורה להחזיר את הערך אם המכשיר מחובר לאינטרנט, ולא לבדוק את זמן התגובה

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

handleDeviceUnresponsive

protected void handleDeviceUnresponsive (IDevice device, 
                IDeviceStateMonitor monitor)

טיפול במצב שבו המכשיר מחובר לאינטרנט אבל לא מגיב.

פרמטרים
`device`	`IDevice`

זריקות
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`