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)

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

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"

abstract boolean waitForDeviceNotAvailable(long waitTime)

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

abstract IDevice waitForDeviceOnline()

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

abstract IDevice waitForDeviceOnline(long time)

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

abstract boolean waitForDeviceShell(long waitTime)

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

الطرق العامة

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)

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

المعلمات
waitTime ‫long: الحد الأقصى للوقت بالملي ثانية للانتظار
المرتجعات
boolean true إذا كان الجهاز في برنامج الإقلاع قبل انتهاء الوقت

waitForDeviceBootloaderStateUpdate

public abstract void waitForDeviceBootloaderStateUpdate ()

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

waitForDeviceFastbootd

public abstract boolean waitForDeviceFastbootd (String fastbootPath, 
                long waitTime)

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

المعلمات
fastbootPath String: مسار ملف fastboot الثنائي المطلوب استخدامه
waitTime ‫long: الحد الأقصى للوقت بالملي ثانية للانتظار
المرتجعات
boolean true إذا كان الجهاز في fastbootd قبل انتهاء الوقت

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

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

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

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

المعلمات
waitTime ‫long: الحد الأقصى للوقت بالملي ثانية للانتظار
المرتجعات
boolean صحيح إذا كان الجهاز في وضع الاسترداد قبل انتهاء مهلة الانتظار، وخطأ في الحالات الأخرى.

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

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

المعلمات
waitTime ‫long: الحد الأقصى للوقت بالملي ثانية للانتظار
المرتجعات
boolean صحيح إذا كان الجهاز في وضع التثبيت من مصدر غير معروف قبل انتهاء مهلة الانتظار، خطأ بخلاف ذلك.

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 shell.

المعلمات
waitTime ‫long: المدة بالملي ثانية للانتظار
المرتجعات
boolean true إذا أصبح الجهاز متجاوبًا قبل انقضاء waitTime