مدیر دستگاه

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

رابطی برای مدیریت مجموعه‌ای از دستگاه‌های موجود برای آزمایش.

خلاصه

کلاس‌های تو در تو

interface IDeviceManager.IFastbootListener

یک شنونده برای تغییرات وضعیت فست‌بوت.

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

abstract void addDeviceMonitor ( IDeviceMonitor mon)

یک IDeviceMonitor اضافه می‌کند

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

به مدیر اطلاع می‌دهد که یک شنونده به تغییرات وضعیت fastboot علاقه‌مند است.

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

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

abstract ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

دستگاهی را برای آزمایش درخواست کنید که معیارهای خاصی را برآورده کند.

abstract ITestDevice allocateDevice ( IDeviceSelection options)

دستگاهی را برای آزمایش درخواست کنید که معیارهای خاصی را برآورده کند.

abstract ITestDevice allocateDevice ()

درخواست یک دستگاه فیزیکی برای آزمایش

abstract ITestDevice connectToTcpDevice (String ipAndPort)

اتصال به دستگاه با adb-over-tcp

این متد یک دستگاه جدید اختصاص می‌دهد که در نهایت باید از طریق disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) آزاد شود.

دستگاه ITestDevice برگردانده شده آنلاین خواهد بود، اما ممکن است پاسخگو نباشد.

abstract boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

از دستگاهی که به adb-over-tcp متصل است، جدا شوید.

abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)

یک توضیح کاربرپسند شامل لیستی از دستگاه‌های شناخته شده، وضعیت آنها و مقادیر گزینه‌های IDeviceSelection که معمولاً استفاده می‌شوند، ارائه دهید.

abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)

یک متد کمکی برای اجرای دستور shell روی دستگاه موجود.

abstract ITestDevice forceAllocateDevice (String serial)

حتی اگر در حال حاضر در دسترس نباشد، با بی‌رحمی یک دستگاه را به او اختصاص دهید.

abstract void freeDevice ( ITestDevice device, FreeDeviceState state)

دستگاه را به استخر برگردانید

تلاش برای بازگرداندن دستگاهی که قبلاً اختصاص داده نشده است، نادیده گرفته خواهد شد.

abstract String getAdbPath ()

مسیر فایل باینری adb مورد استفاده را برمی‌گرداند.

abstract String getAdbVersion ()

نسخه adb که در حال حاضر توسط مدیر دستگاه استفاده می‌شود را دریافت کنید.

abstract DeviceDescriptor getDeviceDescriptor (String serial)

DeviceDescriptor را به همراه سریال داده شده برمی‌گرداند.

abstract String getFastbootPath ()

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

abstract void init ( IDeviceSelection globalDeviceFilter, deviceMonitors)

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

abstract void init ()

مدیر دستگاه را مقداردهی اولیه کنید.

abstract boolean isEmulator (String serial)

تعیین اینکه آیا سریال داده شده نشان دهنده یک شبیه ساز است یا خیر

default boolean isFileSystemMountCheckEnabled ()

برمی‌گرداند که آیا باید در NativeDeviceStateMonitor بررسی کنیم که آیا سیستم فایل به درستی mount شده است یا خیر.

abstract boolean isNullDevice (String serial)

تعیین اینکه آیا سریال داده شده نشان دهنده یک دستگاه تهی است یا خیر

abstract void killEmulator ( ITestDevice device)

شبیه‌ساز داده شده را خاموش کنید.

abstract void launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

روش کمکی برای اجرای شبیه‌ساز.

abstract listAllDevices (boolean shortDescriptor)

لیستی از DeviceDescriptors را برای همه دستگاه‌های شناخته شده برمی‌گرداند.

abstract listAllDevices ()

لیستی از DeviceDescriptors را برای همه دستگاه‌های شناخته شده برمی‌گرداند.

abstract ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

یک متد کمکی که دستگاه usb داده شده را به حالت adb-over-tcp تغییر می‌دهد و سپس از طریق connectToTcpDevice(String) به آن متصل می‌شود.

abstract void removeDeviceMonitor ( IDeviceMonitor mon)

یک IDeviceMonitor که قبلاً اضافه شده بود را حذف می‌کند.

abstract void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

به مدیر اطلاع می‌دهد که شنونده دیگر علاقه‌ای به تغییرات وضعیت fastboot ندارد.

default void removeMonitoringTcpFastbootDevice (String serial)
abstract void restartAdbBridge ()

پل adb و سرویس‌هایی که به اتصالات adb وابسته هستند را مجدداً راه‌اندازی کنید (اگر stopAdbBridge() فراخوانی شده باشد).

abstract void stopAdbBridge ()

پل adb و سرویس‌هایی که به اتصالات adb وابسته هستند را متوقف کنید.

abstract void terminate ()

سرویس‌های نظارت بر دستگاه را متوقف می‌کند و کتابخانه ddm را خاتمه می‌دهد.

abstract void terminateDeviceMonitor ()

مانیتورهای دستگاه را متوقف کنید.

abstract void terminateDeviceRecovery ()

تاپیک بازیابی دستگاه را متوقف می‌کند.

default void terminateHard (String reason)

مانند terminateHard() .

abstract void terminateHard ()

مانند terminate() ، اما تلاش می‌کند adb را نیز به زور خاموش کند.

abstract boolean waitForFirstDeviceAdded (long timeout)

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

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

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

public abstract void addDeviceMonitor (IDeviceMonitor mon)

یک IDeviceMonitor اضافه می‌کند

پارامترها
mon IDeviceMonitor

اضافه کردنFastbootListener 

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

به مدیر اطلاع می‌دهد که یک شنونده به تغییرات وضعیت fastboot علاقه‌مند است.

در حال حاضر، IDeviceManager فقط در صورتی دستگاه‌هایی را در حالت فست‌بوت رصد می‌کند که یک یا چند شنونده فعال داشته باشند.

TODO: این کمی ترفند است - یک راه حل بهتر پیدا کنید

addMonitoringTcpFastbootDevice 

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

یک دستگاه را به مانیتور فست‌بوت اضافه کنید. مانیتور فست‌بوت از 'fastboot_serial' برای ارتباط با دستگاه استفاده می‌کند.

پارامترها
serial String : شماره سریال دستگاه.

fastboot_serial String : شماره سریال حالت فست‌بوت دستگاه.

تخصیص دستگاه 

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

دستگاهی را برای آزمایش درخواست کنید که معیارهای خاصی را برآورده کند.

پارامترها
options IDeviceSelection : IDeviceSelection که دستگاه باید داشته باشد.

isTemporary boolean : آیا باید یک NullDevice موقت ایجاد شود یا خیر.

بازگشت‌ها
ITestDevice یک ITestDevice برای آزمایش، یا اگر در دسترس نباشد null

تخصیص دستگاه 

public abstract ITestDevice allocateDevice (IDeviceSelection options)

دستگاهی را برای آزمایش درخواست کنید که معیارهای خاصی را برآورده کند.

پارامترها
options IDeviceSelection : IDeviceSelection که دستگاه باید داشته باشد.

بازگشت‌ها
ITestDevice یک ITestDevice برای آزمایش، یا اگر در دسترس نباشد null

تخصیص دستگاه 

public abstract ITestDevice allocateDevice ()

درخواست یک دستگاه فیزیکی برای آزمایش

بازگشت‌ها
ITestDevice یک ITestDevice برای آزمایش، یا اگر در دسترس نباشد null

connectToTcpDevice 

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

اتصال به دستگاه با adb-over-tcp

این متد یک دستگاه جدید اختصاص می‌دهد که در نهایت باید از طریق disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) آزاد شود.

دستگاه ITestDevice برگردانده شده آنلاین خواهد بود، اما ممکن است پاسخگو نباشد.

توجه داشته باشید که انجام عملیاتی مانند راه‌اندازی مجدد روی دستگاه متصل به TCP، اتصال TCP به دستگاه را قطع می‌کند و منجر به خطای DeviceNotAvailableException می‌شود.

پارامترها
ipAndPort String : آدرس IP و پورت اصلی دستگاهی که قرار است به آن متصل شوید

بازگشت‌ها
ITestDevice اگر اتصال TCP برقرار نشد، ITestDevice یا null برمی‌گرداند.

قطع ارتباط از TcpDevice 

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

از دستگاهی که به adb-over-tcp متصل است، جدا شوید.

دستگاه را به حالت USB برمی‌گرداند و آن را آزاد می‌کند.

پارامترها
tcpDevice ITestDevice : دستگاهی که در حال حاضر در حالت tcp است و قبلاً از طریق connectToTcpDevice(String) اختصاص داده شده است.

بازگشت‌ها
boolean اگر تغییر به حالت USB موفقیت‌آمیز بود، true

اطلاعات دستگاه‌ها 

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

یک توضیح کاربرپسند شامل لیستی از دستگاه‌های شناخته شده، وضعیت آنها و مقادیر گزینه‌های IDeviceSelection که معمولاً استفاده می‌شوند، ارائه دهید.

پارامترها
printWriter PrintWriter : ERROR(/PrintWriter) برای نمایش توضیحات

includeStub boolean : آیا دستگاه‌های خرد (stub devices) را نیز نمایش دهد یا خیر.

اجرایCmdOnAvailableDevice 

public abstract CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

یک متد کمکی برای اجرای دستور shell روی دستگاه موجود.

پارامترها
serial String : سریال دستگاه.

command String : دستور پوسته.

timeout long : مدت زمانی که طول می‌کشد تا دستور تکمیل شود.

timeUnit TimeUnit : واحد مربوط به زمان انقضا.

بازگشت‌ها
CommandResult یک CommandResult .

دستگاه را مجبور به تخصیص کنید 

public abstract ITestDevice forceAllocateDevice (String serial)

حتی اگر در حال حاضر در دسترس نباشد، با بی‌رحمی یک دستگاه را به او اختصاص دهید.

اگر دستگاه از قبل اختصاص داده شده باشد، هیچ تاثیری نخواهد داشت.

پارامترها
serial String : سریال دستگاه برای تخصیص

بازگشت‌ها
ITestDevice ITestDevice یا اگر تخصیص داده نشد، null

دستگاه رایگان 

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

دستگاه را به استخر برگردانید

تلاش برای بازگرداندن دستگاهی که قبلاً اختصاص داده نشده است، نادیده گرفته خواهد شد.

پارامترها
device ITestDevice : ITestDevice برای آزاد کردن

state FreeDeviceState : FreeDeviceState . برای کنترل اینکه آیا دستگاه به مجموعه دستگاه‌های موجود بازگردانده می‌شود یا خیر، استفاده می‌شود.

مسیر دریافتAdb 

public abstract String getAdbPath ()

مسیر فایل باینری adb مورد استفاده را برمی‌گرداند.

بازگشت‌ها
String

دریافت نسخه Adb 

public abstract String getAdbVersion ()

نسخه adb که در حال حاضر توسط مدیر دستگاه استفاده می‌شود را دریافت کنید.

بازگشت‌ها
String

دریافت توصیفگر دستگاه 

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

DeviceDescriptor را به همراه سریال داده شده برمی‌گرداند.

پارامترها
serial String : شماره سریالی که باید دستگاه دریافت کند

بازگشت‌ها
DeviceDescriptor DeviceDescriptor برای دستگاه انتخاب شده، یا اگر سریال با دستگاه شناخته شده‌ای مطابقت ندارد، null.

مسیر Fastboot را دریافت کنید 

public abstract String getFastbootPath ()

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

بازگشت‌ها
String

اولیه 

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

پارامترها
globalDeviceFilter IDeviceSelection : فیلتر دستگاه

deviceMonitors

اولیه 

public abstract void init ()

مقداردهی اولیه مدیر دستگاه. این متد باید یک بار و فقط یک بار قبل از فراخوانی هر متد دیگری فراخوانی شود.

شبیه‌ساز is 

public abstract boolean isEmulator (String serial)

تعیین اینکه آیا سریال داده شده نشان دهنده یک شبیه ساز است یا خیر

پارامترها
serial String

بازگشت‌ها
boolean

بررسی نصب سیستم فایل فعال شد 

public boolean isFileSystemMountCheckEnabled ()

برمی‌گرداند که آیا باید در NativeDeviceStateMonitor بررسی کنیم که آیا سیستم فایل به درستی mount شده است یا خیر.

بازگشت‌ها
boolean

isNullDevice 

public abstract boolean isNullDevice (String serial)

تعیین اینکه آیا سریال داده شده نشان دهنده یک دستگاه تهی است یا خیر

پارامترها
serial String

بازگشت‌ها
boolean

killEmulator 

public abstract void killEmulator (ITestDevice device)

شبیه‌ساز داده شده را خاموش کنید.

تا زمانی که شبیه‌ساز از adb ناپدید شود، مسدود می‌شود. اگر شبیه‌ساز از قبل در دسترس نباشد، هیچ تاثیری نخواهد داشت.

پارامترها
device ITestDevice : ITestDevice که شبیه‌ساز را برای خاموش کردن نشان می‌دهد

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

شبیه‌ساز launchEmulator 

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

روش کمکی برای اجرای شبیه‌ساز.

شبیه‌ساز را طبق آنچه توسط فراخوانی‌کننده مشخص شده است، اجرا می‌کند.

پارامترها
device ITestDevice : متغیر ITestDevice که نشان‌دهنده دستگاه شبیه‌ساز اختصاص داده شده است.

bootTimeout long : مدت زمان انتظار برای بوت شدن شبیه‌ساز بر حسب میلی‌ثانیه

emulatorArgs آرگومان‌های خط فرمان برای اجرای شبیه‌ساز

پرتاب‌ها
DeviceNotAvailableException اگر شبیه‌ساز بوت نشود یا آنلاین نشود

لیست همه دستگاه‌ها 

public abstract  listAllDevices (boolean shortDescriptor)

لیستی از DeviceDescriptors را برای همه دستگاه‌های شناخته شده برمی‌گرداند.

پارامترها
shortDescriptor boolean : آیا توصیفگرها را به حداقل اطلاعات محدود کنیم یا خیر

بازگشت‌ها
فهرستی از DeviceDescriptor برای همه دستگاه‌های شناخته شده

لیست همه دستگاه‌ها 

public abstract  listAllDevices ()

لیستی از DeviceDescriptors را برای همه دستگاه‌های شناخته شده برمی‌گرداند.

بازگشت‌ها
فهرستی از DeviceDescriptor برای همه دستگاه‌های شناخته شده

اتصال مجدد DeviceToTcp 

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

یک متد کمکی که دستگاه usb داده شده را به حالت adb-over-tcp تغییر می‌دهد و سپس از طریق connectToTcpDevice(String) به آن متصل می‌شود.

پارامترها
usbDevice ITestDevice : دستگاهی که در حال حاضر در حالت USB است

بازگشت‌ها
ITestDevice ITestDevice تازه تخصیص داده شده در حالت tcp یا در صورت عدم امکان ایجاد اتصال tcp، null

پرتاب‌ها
DeviceNotAvailableException اگر اتصال با usbDevice قطع شده و قابل بازیابی نیست

حذف مانیتور دستگاه 

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

IDeviceMonitor اضافه شده قبلی را حذف می‌کند. اگر mon اضافه نشده باشد، هیچ تاثیری ندارد.

پارامترها
mon IDeviceMonitor

حذف FastbootListener 

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

به مدیر اطلاع می‌دهد که شنونده دیگر علاقه‌ای به تغییرات وضعیت fastboot ندارد.

removeMonitoringTcpFastbootDevice 

public void removeMonitoringTcpFastbootDevice (String serial)

پارامترها
serial String

راه اندازی مجددAdbBridge 

public abstract void restartAdbBridge ()

پل adb و سرویس‌هایی که به اتصالات adb وابسته هستند را مجدداً راه‌اندازی کنید (اگر stopAdbBridge() فراخوانی شده باشد).

stopAdbBridge 

public abstract void stopAdbBridge ()

پل adb و سرویس‌هایی که به اتصالات adb وابسته هستند را متوقف کنید.

خاتمه دادن 

public abstract void terminate ()

سرویس‌های نظارت بر دستگاه را متوقف می‌کند و کتابخانه ddm را خاتمه می‌دهد.

این باید پس از خاتمه درخواست فراخوانی شود.

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

خاتمه دادن به مانیتور دستگاه 

public abstract void terminateDeviceMonitor ()

مانیتورهای دستگاه را متوقف کنید.

خاتمه بازیابی دستگاه 

public abstract void terminateDeviceRecovery ()

تاپیک بازیابی دستگاه را متوقف می‌کند.

خاتمه سخت 

public void terminateHard (String reason)

مانند terminateHard() .

پارامترها
reason String : دلیل اختیاری ارائه شده برای خاتمه.

خاتمه سخت 

public abstract void terminateHard ()

مانند terminate() ، اما تلاش می‌کند adb را نیز به زور خاموش کند.

waitForFirstDeviceAdded 

public abstract boolean waitForFirstDeviceAdded (long timeout)

صبر کنید تا اولین دستگاه فیزیکی متصل شود. اگر دستگاهی قبلاً متصل شده باشد، مستقیماً مقدار True را برمی‌گرداند. اگر هیچ دستگاهی اضافه نشده باشد، پس از timeout مقدار false را برمی‌گرداند.

پارامترها
timeout long : مدت زمان انتظار بر حسب میلی‌ثانیه قبل از برگرداندن مقدار false.

بازگشت‌ها
boolean