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

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

NativeDeviceStateMonitor

public class NativeDeviceStateMonitor
extends Object implements IDeviceStateMonitor

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

الفئات الفرعية المباشرة المعروفة

DeviceStateMonitor

DeviceStateMonitor فئة مساعدة لمراقبة حالة IDevice

الفئات الفرعية غير المباشرة المعروفة

NestedDeviceStateMonitor

NestedDeviceStateMonitor أداة مراقبة حالة الجهاز التي تُجري عمليات تحقّق إضافية على الجهاز المُدمَج لاستيعاب تفاصيل البيئة الافتراضية

فئة مساعدة لرصد حالة IDevice بدون إطار عمل

ملخّص

الثابتات
`long`	`MAX_CHECK_POLL_TIME`
`int`	`MAX_OP_TIME` الحد الأقصى لوقت العملية بالملي ثانية لطلب "الاستعلام عن الاستجابة"

الحقول
`protected static final String`	`PERM_DENIED_ERROR_PATTERN`

وظائف الإنشاء العامة
`NativeDeviceStateMonitor(IDeviceManager mgr, IDevice device, boolean fastbootEnabled)`

الطرق العامة
`void`	`attachFinalState(TestDeviceState finalState)` يجب إرفاق حالة نهائية لإيقاف waitForDeviceState في حال الوصول إليها.
`TestDeviceState`	`getDeviceState()` الحصول على حالة الجهاز
`String`	`getFastbootSerialNumber()` الحصول على الرقم التسلسلي لوضع Fastboot
`String`	`getMountPoint(String mountName)` لعرض نقطة تثبيت.
`String`	`getSerialNumber()` الحصول على الرقم التسلسلي للجهاز
`boolean`	`isAdbTcp()`
`void`	`setDefaultAvailableTimeout(long timeoutMs)` اضبط الوقت بالملي ثانية للانتظار إلى أن يصبح الجهاز متاحًا في `waitForDeviceAvailable()`.
`void`	`setDefaultOnlineTimeout(long timeoutMs)` اضبط الوقت بالملي ثانية للانتظار إلى أن يصبح الجهاز متصلاً بالإنترنت في `waitForDeviceOnline()`.
`void`	`setFastbootSerialNumber(String serial)` اضبط الرقم التسلسلي لوضع Fastboot.
`void`	`setIDevice(IDevice newDevice)` تعديل جهاز IDevice الحالي
`void`	`setState(TestDeviceState deviceState)` تُستخدَم لضبط الحالة الحالية للجهاز.
`boolean`	`waitForBootComplete(long waitTime)` يتم حظر الإجراء إلى أن يتم ضبط علامة اكتمال عملية تشغيل الجهاز.
`IDevice`	`waitForDeviceAvailable(long waitTime)` ينتظر الجهاز حتى يصبح متجاوبًا ومتاحًا للاختبار.
`IDevice`	`waitForDeviceAvailable()` ينتظر الجهاز حتى يصبح متجاوبًا ومتاحًا للاختبار.
`IDevice`	`waitForDeviceAvailableInRecoverPath(long waitTime)` نسخة خاصة من `waitForDeviceAvailable(long)` يتمّ استدعاؤها أثناء مسار الاسترداد لتحديد كيفية التعامل مع الطلب.
`boolean`	`waitForDeviceBootloader(long time)` ينتظر حتى يصبح الجهاز في برنامج الإقلاع.
`void`	`waitForDeviceBootloaderStateUpdate()` الانتظار إلى أن يتم تعديل حالة برنامج الإقلاع في الجهاز
`boolean`	`waitForDeviceFastbootd(String fastbootPath, long time)` ينتظر حتى يصبح الجهاز في وضع fastbootd.
`IDevice`	`waitForDeviceInRecovery()` ينتظر حتى يصبح الجهاز في "وضع الاسترداد" باستخدام مهلة التشغيل العادية.
`boolean`	`waitForDeviceInRecovery(long waitTime)` الانتظار إلى أن يصبح الجهاز في حالة "استرداد adb"
`boolean`	`waitForDeviceInSideload(long waitTime)` الانتظار إلى أن يصبح الجهاز في حالة "تحميل جانبي باستخدام adb"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` الانتظار إلى أن يصبح الجهاز غير متاح
`IDevice`	`waitForDeviceOnline()` ينتظر الجهاز حتى يصبح متصلاً بالإنترنت باستخدام مهلة التشغيل العادية.
`IDevice`	`waitForDeviceOnline(long waitTime)` ينتظر الجهاز حتى يصبح متصلاً بالإنترنت.
`boolean`	`waitForDeviceShell(long waitTime)` ينتظر حتى يستجيب الجهاز لأمر أساسي في واجهة برمجة التطبيقات adb shell.

الطرق المحمية
`CollectingOutputReceiver`	`createOutputReceiver()` متاح للاختبار
`long`	`getCheckPollTime()` متاح للاختبار
`long`	`getCurrentTime()` متاح للاختبار
`IDevice`	`getIDevice()`
`boolean`	`postOnlineCheck(long waitTime)` عمليات التحقّق الإضافية التي يجب إجراؤها على جهاز متصل بالإنترنت
`boolean`	`waitForStoreMount(long waitTime)` ينتظر حتى يتم تركيب وحدة التخزين الخارجية للجهاز.

الثابتات

MAX_CHECK_POLL_TIME

protected static final long MAX_CHECK_POLL_TIME

القيمة الثابتة: 3000 (0x0000000000000bb8)

MAX_OP_TIME

protected static final int MAX_OP_TIME

الحد الأقصى لوقت العملية بالملي ثانية لطلب "الاستعلام عن الاستجابة"

القيمة الثابتة: 10000 (0x00002710)

الحقول

PERM_DENIED_ERROR_PATTERN

protected static final String PERM_DENIED_ERROR_PATTERN

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

NativeDeviceStateMonitor

public NativeDeviceStateMonitor (IDeviceManager mgr, 
                IDevice device, 
                boolean fastbootEnabled)

المعلمات
`mgr`	`IDeviceManager`
`device`	`IDevice`
`fastbootEnabled`	`boolean`

الطرق العامة

attachFinalState

public void attachFinalState (TestDeviceState finalState)

يجب إرفاق حالة نهائية لإيقاف waitForDeviceState في حال الوصول إليها.

المعلمات
`finalState`	`TestDeviceState`

getDeviceState

public TestDeviceState getDeviceState ()

الحصول على حالة الجهاز

المرتجعات
`TestDeviceState`	`TestDeviceState` الجهاز

getFastbootSerialNumber

public String getFastbootSerialNumber ()

الحصول على الرقم التسلسلي لوضع Fastboot

المرتجعات
`String`

getMountPoint

public String getMountPoint (String mountName)

لعرض نقطة تثبيت.

يبحث في الجهاز مباشرةً إذا لم تكن المعلومات المخزّنة مؤقتًا في IDevice متاحة.

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

المعلمات
`mountName`	`String`: اسم نقطة التثبيت

المرتجعات
`String`	نقطة التثبيت أو `null`

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

getSerialNumber

public String getSerialNumber ()

الحصول على الرقم التسلسلي للجهاز

المرتجعات
`String`

isAdbTcp

public boolean isAdbTcp ()

المرتجعات
`boolean`

setDefaultAvailableTimeout

public void setDefaultAvailableTimeout (long timeoutMs)

اضبط الوقت بالملي ثانية للانتظار إلى أن يصبح الجهاز متاحًا في waitForDeviceAvailable().

المعلمات
`timeoutMs`	`long`

setDefaultOnlineTimeout

public void setDefaultOnlineTimeout (long timeoutMs)

اضبط الوقت بالملي ثانية للانتظار إلى أن يصبح الجهاز متصلاً بالإنترنت في waitForDeviceOnline().

المعلمات
`timeoutMs`	`long`

setFastbootSerialNumber

public void setFastbootSerialNumber (String serial)

اضبط الرقم التسلسلي لوضع Fastboot.

المعلمات
`serial`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

تعديل جهاز IDevice الحالي

setState

public void setState (TestDeviceState deviceState)

تُستخدَم لضبط الحالة الحالية للجهاز.

waitForBootComplete

public boolean waitForBootComplete (long waitTime)

يتم حظر الإجراء إلى أن يتم ضبط علامة اكتمال عملية تشغيل الجهاز.

المعلمات
`waitTime`	‫`long`: المدة بالملي ثانية للانتظار

المرتجعات
`boolean`

waitForDeviceAvailable

public IDevice waitForDeviceAvailable (long waitTime)

ينتظر الجهاز حتى يصبح متجاوبًا ومتاحًا للاختبار. ويعني ذلك حاليًا أنّه يتوفّر مدير الحِزم ومساحة التخزين الخارجية.

المعلمات
`waitTime`	‫`long`: الوقت بالملي ثانية للانتظار

المرتجعات
`IDevice`	`IDevice` إذا أصبح الجهاز متصلاً بالإنترنت قبل انتهاء الوقت `null` في الحالات الأخرى

waitForDeviceAvailable

public IDevice waitForDeviceAvailable ()

ينتظر الجهاز حتى يصبح متجاوبًا ومتاحًا للاختبار.

يعادل waitForDeviceAvailable(long)، ولكنّه يستخدم مهلة التمهيد الافتراضية للجهاز.

المرتجعات
`IDevice`	`IDevice` إذا أصبح الجهاز متصلاً بالإنترنت قبل انتهاء الوقت `null` في الحالات الأخرى

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

نسخة خاصة من waitForDeviceAvailable(long) يتمّ استدعاؤها أثناء مسار الاسترداد لتحديد كيفية التعامل مع الطلب.

المعلمات
`waitTime`	`long`

المرتجعات
`IDevice`

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

waitForDeviceBootloader

public boolean waitForDeviceBootloader (long time)

ينتظر حتى يصبح الجهاز في برنامج الإقلاع.

المعلمات
`time`	‫`long`: الحد الأقصى للوقت بالملي ثانية للانتظار

المرتجعات
`boolean`	`true` إذا كان الجهاز في برنامج الإقلاع قبل انتهاء الوقت

waitForDeviceBootloaderStateUpdate

public void waitForDeviceBootloaderStateUpdate ()

الانتظار إلى أن يتم تعديل حالة برنامج الإقلاع في الجهاز

waitForDeviceFastbootd

public boolean waitForDeviceFastbootd (String fastbootPath, 
                long time)

ينتظر حتى يصبح الجهاز في وضع fastbootd.

المعلمات
`fastbootPath`	‫`String`: مسار ملف fastboot الثنائي المطلوب استخدامه
`time`	‫`long`: الحد الأقصى للوقت بالملي ثانية للانتظار

المرتجعات
`boolean`	`true` إذا كان الجهاز في fastbootd قبل انتهاء الوقت

waitForDeviceInRecovery

public IDevice waitForDeviceInRecovery ()

ينتظر حتى يصبح الجهاز في "وضع الاسترداد" باستخدام مهلة التشغيل العادية.

المرتجعات
`IDevice`	`IDevice` إذا أصبح الجهاز في وضع الاسترداد قبل انتهاء الوقت `null` بخلاف ذلك.

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

الانتظار إلى أن يصبح الجهاز في حالة "استرداد adb"

المعلمات
`waitTime`	‫`long`: الحد الأقصى للوقت بالملي ثانية للانتظار

المرتجعات
`boolean`	صحيح إذا كان الجهاز في وضع الاسترداد قبل انتهاء مهلة الانتظار، خطأ بخلاف ذلك

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

الانتظار إلى أن يصبح الجهاز في حالة "تحميل جانبي باستخدام adb"

المعلمات
`waitTime`	‫`long`: الحد الأقصى للوقت بالملي ثانية للانتظار

المرتجعات
`boolean`	صحيح إذا كان الجهاز في وضع التحميل الجانبي قبل انتهاء مهلة الانتظار، خطأ في الحالات الأخرى

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

الانتظار إلى أن يصبح الجهاز غير متاح

المعلمات
`waitTime`	‫`long`: الحد الأقصى للوقت بالملي ثانية للانتظار

المرتجعات
`boolean`	`true` في حال عدم توفّر الجهاز

waitForDeviceOnline

public IDevice waitForDeviceOnline ()

ينتظر الجهاز حتى يصبح متصلاً بالإنترنت باستخدام مهلة التشغيل العادية.

ملاحظة: ستظهر هذه الطريقة بعد أن يصبح الجهاز مرئيًا من خلال DDMS. ولا يضمن ذلك أنّه سيستجيب الجهاز فعليًا لأوامر adb، لذا استخدِم waitForDeviceAvailable() بدلاً من ذلك.

المرتجعات
`IDevice`	`IDevice` إذا أصبح الجهاز متصلاً بالإنترنت قبل انتهاء الوقت `null` في الحالات الأخرى

waitForDeviceOnline

public IDevice waitForDeviceOnline (long waitTime)

ينتظر الجهاز حتى يصبح متصلاً بالإنترنت.

المعلمات
`waitTime`	‫`long`: الحد الأقصى للوقت بالملي ثانية للانتظار

المرتجعات
`IDevice`	`IDevice` إذا أصبح الجهاز متصلاً بالإنترنت قبل انتهاء الوقت `null` في الحالات الأخرى

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

ينتظر حتى يستجيب الجهاز لأمر أساسي في واجهة برمجة التطبيقات adb shell.

المعلمات
`waitTime`	‫`long`: الوقت بالملي ثانية للانتظار

المرتجعات
`boolean`	`true` إذا أصبح الجهاز متجاوبًا قبل انقضاء `waitTime`

الطرق المحمية

createOutputReceiver

protected CollectingOutputReceiver createOutputReceiver ()

متاح للاختبار

المرتجعات
`CollectingOutputReceiver`	`CollectingOutputReceiver`

getCheckPollTime

protected long getCheckPollTime ()

متاح للاختبار

المرتجعات
`long`

getCurrentTime

protected long getCurrentTime ()

متاح للاختبار

المرتجعات
`long`

getIDevice

protected IDevice getIDevice ()

المرتجعات
`IDevice`	`IDevice` ربط بمراقب الحالة

postOnlineCheck

protected boolean postOnlineCheck (long waitTime)

عمليات التحقّق الإضافية التي يجب إجراؤها على جهاز متصل بالإنترنت

المعلمات
`waitTime`	‫`long`: الوقت بالملي ثانية للانتظار قبل الاستسلام

المرتجعات
`boolean`	`true` إذا كانت عمليات التحقّق ناجحة قبل انتهاء مهلة الانتظار `false` بخلاف ذلك

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

waitForStoreMount

protected boolean waitForStoreMount (long waitTime)

ينتظر حتى يتم تركيب وحدة التخزين الخارجية للجهاز.

المعلمات
`waitTime`	‫`long`: الوقت بالملي ثانية للانتظار قبل الاستسلام

المرتجعات
`boolean`	`true` إذا تم تثبيت المتجر الخارجي قبل انتهاء صلاحية مهلة الانتظار `false` بخلاف ذلك

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