مانیتور وضعیت دستگاه

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor

امکاناتی را برای نظارت بر وضعیت یک IDevice فراهم می‌کند.

یک دستگاه در حال حاضر "موجود" در نظر گرفته می‌شود اگر و فقط اگر چهار رویداد درست باشند: ۱. دستگاه آنلاین باشد یا از طریق DDMS/adb قابل مشاهده باشد ( waitForDeviceOnline() ۲. دستگاه دارای پرچم dev.bootcomplete (@link #waitForBootComplete(long)} باشد ۳. مدیر بسته دستگاه پاسخگو باشد (ممکن است inop باشد) ۴. حافظه خارجی دستگاه نصب شده باشد ۳. و ۴. بخشی از waitForDeviceAvailable() باشد.

خلاصه

روش‌های عمومی

default void attachFinalState ( TestDeviceState finalState)

یک وضعیت نهایی ضمیمه کنید تا در صورت رسیدن به waitForDeviceState، اجرای آن متوقف شود.

default void clearTcpFastbootMonitor ()

هر وضعیتی را در مدیریت دستگاه پاک کنید.

abstract TestDeviceState getDeviceState ()

وضعیت دستگاه را دریافت می‌کند.

abstract String getFastbootSerialNumber ()

شماره سریال حالت فست‌بوت را دریافت می‌کند.

abstract String getMountPoint (String mountName)

یک نقطه اتصال (mount point) را برمی‌گرداند.

abstract String getSerialNumber ()

شماره سریال دستگاه را دریافت می‌کند.

abstract boolean isAdbTcp ()
abstract void setDefaultAvailableTimeout (long timeoutMs)

زمان انتظار برای در دسترس قرار گرفتن یک دستگاه را در تابع waitForDeviceAvailable() بر حسب میلی‌ثانیه تنظیم کنید.

abstract void setDefaultOnlineTimeout (long timeoutMs)

زمان انتظار برای آنلاین شدن یک دستگاه را در waitForDeviceOnline() بر حسب میلی‌ثانیه تنظیم می‌کند.

abstract void setFastbootSerialNumber (String serial)

شماره سریال حالت فست‌بوت را تنظیم می‌کند.

abstract void setIDevice ( IDevice device)

شناسه فعلی دستگاه را به‌روزرسانی می‌کند.

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 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 ()

هر وضعیتی را در مدیریت دستگاه پاک کنید.

دریافت وضعیت دستگاه 

public abstract TestDeviceState getDeviceState ()

وضعیت دستگاه را دریافت می‌کند.

بازگشت‌ها
TestDeviceState TestDeviceState دستگاه

دریافت شماره سریال Fastboot 

public abstract String getFastbootSerialNumber ()

شماره سریال حالت فست‌بوت را دریافت می‌کند.

بازگشت‌ها
String

دریافت نقطه اتصال 

public abstract String getMountPoint (String mountName)

یک نقطه اتصال (mount point) را برمی‌گرداند.

اگر اطلاعات ذخیره شده در IDevice در دسترس نباشد، مستقیماً از دستگاه پرس و جو می‌کند.

TODO: این رفتار را به IDevice.getMountPoint(String) منتقل کنید

پارامترها
mountName String : نام نقطه اتصال

بازگشت‌ها
String نقطه اتصال یا null

پرتاب‌ها
DeviceNotAvailableException

همچنین ببینید:

دریافت شماره سریال 

public abstract String getSerialNumber ()

شماره سریال دستگاه را دریافت می‌کند.

بازگشت‌ها
String

isAdbTcp 

public abstract boolean isAdbTcp ()

بازگشت‌ها
boolean اگر دستگاه از طریق tcp به adb متصل باشد، true

setDefaultAvailableTimeout 

public abstract void setDefaultAvailableTimeout (long timeoutMs)

زمان انتظار برای در دسترس قرار گرفتن یک دستگاه را در تابع waitForDeviceAvailable() بر حسب میلی‌ثانیه تنظیم کنید.

پارامترها
timeoutMs long

setDefaultOnlineTimeout 

public abstract void setDefaultOnlineTimeout (long timeoutMs)

زمان انتظار برای آنلاین شدن یک دستگاه را در waitForDeviceOnline() بر حسب میلی‌ثانیه تنظیم می‌کند.

پارامترها
timeoutMs long

تنظیم شماره سریال Fastboot 

public abstract void setFastbootSerialNumber (String serial)

شماره سریال حالت فست‌بوت را تنظیم می‌کند.

پارامترها
serial String

تنظیم IDevice 

public abstract void setIDevice (IDevice device)

شناسه فعلی دستگاه را به‌روزرسانی می‌کند.

همچنین ببینید:

تنظیم وضعیت 

public abstract void setState (TestDeviceState deviceState)

وضعیت فعلی دستگاه را تنظیم می‌کند.

صبر کن تا بوت کامل شود 

public abstract boolean waitForBootComplete (long waitTime)

تا زمانی که پرچم تکمیل بوت دستگاه تنظیم نشود، مسدود می‌شود

پارامترها
waitTime long : مقدار زمانی که باید منتظر بمانید (برحسب میلی‌ثانیه)

بازگشت‌ها
boolean

waitForDeviceموجود است 

public abstract IDevice waitForDeviceAvailable (long waitTime)

منتظر می‌ماند تا دستگاه پاسخگو باشد و برای آزمایش در دسترس باشد. در حال حاضر این بدان معناست که مدیر بسته و حافظه خارجی در دسترس هستند.

پارامترها
waitTime long : مدت زمان انتظار بر حسب میلی‌ثانیه

بازگشت‌ها
IDevice اگر دستگاه قبل از انقضای زمان آنلاین شود، IDevice برمی‌گرداند. در غیر این صورت null .

waitForDeviceموجود است 

public abstract IDevice waitForDeviceAvailable ()

منتظر می‌ماند تا دستگاه پاسخگو باشد و برای آزمایش در دسترس باشد.

معادل waitForDeviceAvailable(long) است، اما از زمان بوت پیش‌فرض دستگاه استفاده می‌کند.

بازگشت‌ها
IDevice اگر دستگاه قبل از انقضای زمان آنلاین شود، IDevice برمی‌گرداند. در غیر این صورت null .

waitForDeviceAvailableInRecoverPath 

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

نوع خاصی از waitForDeviceAvailable(long) که در طول مسیر بازیابی برای سفارشی‌سازی مدیریت فراخوانی می‌شود.

پارامترها
waitTime long

بازگشت‌ها
IDevice

پرتاب‌ها
DeviceNotAvailableException اگر دستگاه از دسترس خارج شود.

waitForDeviceبوت‌لودر 

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 : مسیر فایل باینری فست‌بوت مورد استفاده.

waitTime long : حداکثر زمان انتظار بر حسب میلی‌ثانیه

بازگشت‌ها
boolean اگر دستگاه قبل از انقضای زمان در حالت fastbootd باشد، true

waitForDeviceInRecovery 

public abstract IDevice waitForDeviceInRecovery ()

با استفاده از زمان‌بندی استاندارد بوت، منتظر می‌ماند تا دستگاه در حالت ریکاوری قرار گیرد.

بازگشت‌ها
IDevice اگر دستگاه قبل از انقضای زمان بازیابی شود، IDevice فعال می‌شود. در غیر این صورت null .

waitForDeviceInRecovery 

public abstract boolean waitForDeviceInRecovery (long waitTime)

منتظر می‌ماند تا دستگاه در حالت «بازیابی adb» قرار گیرد

پارامترها
waitTime long : حداکثر زمان انتظار بر حسب میلی‌ثانیه

بازگشت‌ها
boolean اگر دستگاه قبل از اتمام مهلت زمانی در حالت بازیابی باشد، مقدار True و در غیر این صورت مقدار False برمی‌گرداند.

waitForDeviceInSideload 

public abstract boolean waitForDeviceInSideload (long waitTime)

منتظر می‌ماند تا دستگاه در حالت «adb sideload» قرار گیرد.

پارامترها
waitTime long : حداکثر زمان انتظار بر حسب میلی‌ثانیه

بازگشت‌ها
boolean اگر دستگاه قبل از اتمام زمان در حالت بارگذاری جانبی باشد، مقدار True و در غیر این صورت مقدار False را برمی‌گرداند.

waitForDeviceNotAvailable 

public abstract boolean waitForDeviceNotAvailable (long waitTime)

منتظر می‌ماند تا دستگاه در دسترس نباشد

پارامترها
waitTime long : حداکثر زمان انتظار بر حسب میلی‌ثانیه

بازگشت‌ها
boolean اگر دستگاه از دسترس خارج شود، true

waitForDeviceآنلاین 

public abstract IDevice waitForDeviceOnline ()

با استفاده از زمان‌بندی استاندارد بوت، منتظر آنلاین شدن دستگاه می‌ماند.

توجه: این متد زمانی که دستگاه از طریق DDMS قابل مشاهده باشد، خروجی می‌دهد. این متد تضمین نمی‌کند که دستگاه واقعاً به دستورات adb پاسخگو باشد - به جای آن waitForDeviceAvailable() استفاده کنید.

بازگشت‌ها
IDevice اگر دستگاه قبل از انقضای زمان آنلاین شود، IDevice برمی‌گرداند. در غیر این صورت null .

waitForDeviceآنلاین 

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 اگر دستگاه قبل از گذشت waitTime پاسخگو شود، true .