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)

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

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

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