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 إذا تم الوصول إليها.

default void clearTcpFastbootMonitor()

محو أي حالة في "إدارة الأجهزة"

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 recovery"

abstract boolean waitForDeviceInSideload(long waitTime)

ينتظر أن يصبح الجهاز في حالة "adb sideload"

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

clearTcpFastbootMonitor

public void clearTcpFastbootMonitor ()

محو أي حالة في "إدارة الأجهزة"

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 recovery"

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

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

ينتظر أن يصبح الجهاز في حالة "adb sideload"

المعلمات
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