IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


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

خلاصه

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

interface IDeviceManager.IFastbootListener

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

روش های عمومی

abstract void addDeviceMonitor ( IDeviceMonitor mon)

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

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

به مدیر اطلاع می دهد که شنونده به تغییرات حالت فست بوت علاقه مند است.

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)

یک روش کمکی برای اجرای فرمان پوسته در دستگاه موجود.

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

مسیر باینری fastboot را برای استفاده برمی گرداند.

abstract void init ( IDeviceSelection globalDeviceFilter, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors)

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

abstract void init ()

مدیر دستگاه را راه اندازی کنید.

abstract boolean isEmulator (String serial)

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

default boolean isFileSystemMountCheckEnabled ()

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

abstract boolean isNullDevice (String serial)

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

abstract void killEmulator ( ITestDevice device)

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

abstract void launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) 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)

به مدیر اطلاع می دهد که شنونده دیگر علاقه ای به تغییرات حالت فست بوت ندارد.

abstract void restartAdbBridge ()

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

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)

به مدیر اطلاع می دهد که شنونده به تغییرات حالت فست بوت علاقه مند است.

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

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

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

یک دستگاه را به مانیتور فست بوت اضافه کنید. مانیتور fastboot از '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

اتصال بهTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

به دستگاهی با adb-over-tcp متصل شوید

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

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

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

مولفه های
ipAndPort String : آدرس IP اصلی و پورت دستگاه برای اتصال

برمی گرداند
ITestDevice ITestDevice یا null در صورتی که اتصال tcp ایجاد نشد

قطع اتصال از TcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

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

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

برمی گرداند
boolean اگر تغییر به حالت usb موفقیت آمیز بود true

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

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

مولفه های
printWriter PrintWriter : ERROR(/PrintWriter) برای خروجی توضیحات

includeStub boolean : اینکه آیا دستگاه های خرد نیز نمایش داده شود یا خیر.

executeCmdOnAvailableDevice

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

یک روش کمکی برای اجرای فرمان پوسته در دستگاه موجود.

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

command String : فرمان پوسته.

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

timeUnit TimeUnit : واحدی برای وقفه.

برمی گرداند
CommandResult یک CommandResult

forceAllocateDevice

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 . برای کنترل بازگرداندن دستگاه به مخزن دستگاه موجود استفاده می شود.

getAdbPath

public abstract String getAdbPath ()

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

برمی گرداند
String

getAdbVersion

public abstract String getAdbVersion ()

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

برمی گرداند
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

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

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

برمی گرداند
DeviceDescriptor DeviceDescriptor برای دستگاه انتخاب شده، یا اگر سریال با دستگاه شناخته شده مطابقت نداشته باشد، پوچ شود.

getFastbootPath

public abstract String getFastbootPath ()

مسیر باینری fastboot را برای استفاده برمی گرداند.

برمی گرداند
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

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

deviceMonitors

init

public abstract void init ()

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

isEmulator

public abstract boolean isEmulator (String serial)

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

مولفه های
serial String

برمی گرداند
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

برمی گرداند
boolean

NullDevice است

public abstract boolean isNullDevice (String serial)

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

مولفه های
serial String

برمی گرداند
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

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

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

مولفه های
device ITestDevice : ITestDevice نشان دهنده شبیه ساز برای خاموش شدن

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

شبیه ساز راه اندازی

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

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

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

مولفه های
device ITestDevice : مکان نگهدار ITestDevice که دستگاه شبیه ساز اختصاص داده شده را نشان می دهد

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

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

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

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

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

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

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

listAllDevices

public abstract  listAllDevices ()

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

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

ReconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

مولفه های
usbDevice ITestDevice : دستگاهی که در حال حاضر در حالت usb است

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

پرتاب می کند
DeviceNotAvailableException اگر اتصال با usbDevice از بین رفته باشد و قابل بازیابی نباشد

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

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

مولفه های
mon IDeviceMonitor

حذفFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

به مدیر اطلاع می دهد که شنونده دیگر علاقه ای به تغییرات حالت فست بوت ندارد.

ریستارت AdbBridge

public abstract void restartAdbBridge ()

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

stopAdbBridge

public abstract void stopAdbBridge ()

توقف پل adb و خدمات به اتصالات adb بستگی دارد.

خاتمه دادن

public abstract void terminate ()

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

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

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

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

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

terminateDeviceRecovery

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 را برمی‌گرداند. اگر دستگاهی اضافه نشده باشد، پس از اتمام زمان، false را برمی‌گرداند.

مولفه های
timeout long : زمان انتظار در میلی ثانیه قبل از بازگشت false.

برمی گرداند
boolean