اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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`

وظائف الإنشاء العامة
`WaitDeviceRecovery()`

الطرق العامة
`void`	`recoverDevice(IDeviceStateMonitor monitor, boolean recoverUntilOnline)` محاولة استرداد الجهاز المحدَّد الذي لم يعُد بالإمكان التواصل معه
`void`	`recoverDeviceBootloader(IDeviceStateMonitor monitor)` يُرجى محاولة استرداد الجهاز الذي لا يستجيب في وضع أداة تحميل البرامج الثابتة.
`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

وظائف الإنشاء العامة

WaitDeviceRecovery

public WaitDeviceRecovery ()

الطرق العامة

recoverDevice

public void recoverDevice (IDeviceStateMonitor monitor, 
                boolean recoverUntilOnline)

محاولة استرداد الجهاز المحدَّد الذي لم يعُد بالإمكان التواصل معه

يجب أن تحظر الطريقة الإذن ولا تُرجعه إلا عندما يكون الجهاز في الحالة المطلوبة.

المعلمات
`monitor`	`IDeviceStateMonitor`: `IDeviceStateMonitor` المطلوب استخدامه
`recoverUntilOnline`	‫`boolean`: إذا كان صحيحًا، من المفترض أن تُرجع الطريقة القيمة فور اتصال الجهاز بالإنترنت على adb. إذا كان القيمة خطأ، يجب أن تحظر الطريقة الجهاز إلى أن يصبح متاحًا بالكامل للاختبار (أي `IDeviceStateMonitor.waitForDeviceAvailable()` تنجح.

عمليات الرمي
`DeviceNotAvailableException`

recoverDeviceBootloader

public void recoverDeviceBootloader (IDeviceStateMonitor monitor)

يُرجى محاولة استرداد الجهاز الذي لا يستجيب في وضع أداة تحميل البرامج الثابتة.

المعلمات
`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`: إذا كانت القيمة صحيحة، من المفترض أن تُرجع هذه الطريقة ما إذا كان الجهاز متصلاً بالإنترنت، وليس التحقّق من الاستجابة

عمليات الرمي
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

handleDeviceUnresponsive

protected void handleDeviceUnresponsive (IDevice device, 
                IDeviceStateMonitor monitor)

التعامل مع الحالات التي يكون فيها الجهاز متصلاً بالإنترنت ولكنّه لا يستجيب

المعلمات
`device`	`IDevice`

عمليات الرمي
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`