مدیر دستگاه

public class DeviceManager
extends Object implements IDeviceManager

شیء جاوا
↳ com.android.tradefed.device.DeviceManager

خلاصه

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

class DeviceManager.FastbootDevice

نمایش یک دستگاه در حالت Fastboot.

ثابت‌ها

String UNKNOWN_DISPLAY_STRING

نمایش رشته برای ویژگی‌های ناشناخته

فیلدها

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

سازندگان عمومی

DeviceManager ()

DeviceManager باید از GlobalConfiguration بازیابی شود.

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

void addAvailableDevice ( IDevice stubDevice)
void addAvailableNativeDevice ( IDevice stubDevice)
void addDeviceMonitor ( IDeviceMonitor mon)

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

void addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice)
void addFastbootListener ( IDeviceManager.IFastbootListener listener)

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

void addMonitoringTcpFastbootDevice (String serial, String fastbootSerial)

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

ITestDevice allocateDevice ( IDeviceSelection options, boolean isTemporary)

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

ITestDevice allocateDevice ( IDeviceSelection options)

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

ITestDevice allocateDevice ()

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

ITestDevice connectToTcpDevice (String ipAndPort)

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

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

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

boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

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

void displayDevicesInfo (PrintWriter stream, boolean includeStub)

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

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

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

String executeGlobalAdbCommand (String... cmdArgs)

اجرای یک دستور adb که مختص یک دستگاه خاص نیست، مثلاً

ITestDevice forceAllocateDevice (String serial)

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

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

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

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

String getAdbPath ()

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

String getAdbVersion ()

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

DeviceDescriptor getDeviceDescriptor (String serial)

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

String getFastbootPath ()

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

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

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

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

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

void init ()

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

boolean isEmulator (String serial)

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

boolean isFileSystemMountCheckEnabled ()

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

boolean isNullDevice (String serial)

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

void killEmulator ( ITestDevice device)

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

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

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

listAllDevices (boolean shortDescriptor)

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

listAllDevices ()

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

ITestDevice reconnectDeviceToTcp ( ITestDevice usbDevice)

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

void removeDeviceMonitor ( IDeviceMonitor mon)

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

void removeFastbootListener ( IDeviceManager.IFastbootListener listener)

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

void removeMonitoringTcpFastbootDevice (String serial)

void restartAdbBridge ()

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

void stopAdbBridge ()

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

void terminate ()

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

void terminateDeviceMonitor ()

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

void terminateDeviceRecovery ()

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

void terminateHard (String reason)

مانند terminateHard() .

void terminateHard ()

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

boolean waitForFirstDeviceAdded (long timeout)

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

ثابت‌ها

رشته_نمایش_ناشناس 

public static final String UNKNOWN_DISPLAY_STRING

نمایش رشته برای ویژگی‌های ناشناخته

مقدار ثابت: "نامشخص"

فیلدها

mDvcMon 

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled 

protected boolean mFastbootEnabled

سازندگان عمومی

مدیر دستگاه 

public DeviceManager ()

DeviceManager باید از GlobalConfiguration بازیابی شود.

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

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

public void addAvailableDevice (IDevice stubDevice)

پارامترها
stubDevice IDevice

addAvailableNativeDevice 

public void addAvailableNativeDevice (IDevice stubDevice)

پارامترها
stubDevice IDevice

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

public void addDeviceMonitor (IDeviceMonitor mon)

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

پارامترها
mon IDeviceMonitor

اضافه کردن دستگاه Fastboot 

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

پارامترها
fastbootDevice DeviceManager.FastbootDevice

اضافه کردنFastbootListener 

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

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

addMonitoringTcpFastbootDevice 

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

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

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

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

تخصیص دستگاه 

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

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

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

تخصیص دستگاه 

public ITestDevice allocateDevice (IDeviceSelection options)

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

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

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

تخصیص دستگاه 

public ITestDevice allocateDevice ()

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

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

connectToTcpDevice 

public 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 boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

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

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

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

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

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

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

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

اجرایCmdOnAvailableDevice 

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

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

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

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

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

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

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

اجرای دستور GlobalAdb 

public String executeGlobalAdbCommand (String... cmdArgs)

اجرای یک دستور adb که مختص یک دستگاه خاص نیست، مثلاً 'adb connect'

بازگشت‌ها
String اگر دستور successm باشد، خروجی std خواهد بود، در غیر این صورت null.

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

public ITestDevice forceAllocateDevice (String serial)

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

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

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

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

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

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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

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

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

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

مسیر دریافتAdb 

public String getAdbPath ()

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

بازگشت‌ها
String

دریافت نسخه Adb 

public String getAdbVersion ()

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

بازگشت‌ها
String

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

public DeviceDescriptor getDeviceDescriptor (String serial)

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

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

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

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

public String getFastbootPath ()

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

بازگشت‌ها
String

اولیه 

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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

پارامترها
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

اولیه 

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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

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

globalDeviceMonitors

اولیه 

public void init ()

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

شبیه‌ساز is 

public boolean isEmulator (String serial)

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

پارامترها
serial String

بازگشت‌ها
boolean

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

public boolean isFileSystemMountCheckEnabled ()

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

بازگشت‌ها
boolean

isNullDevice 

public boolean isNullDevice (String serial)

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

پارامترها
serial String

بازگشت‌ها
boolean

killEmulator 

public void killEmulator (ITestDevice device)

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

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

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

پرتاب‌ها
DeviceNotAvailableException

شبیه‌ساز launchEmulator 

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

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

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

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

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

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

پرتاب‌ها
DeviceNotAvailableException

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

public  listAllDevices (boolean shortDescriptor)

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

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

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

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

public  listAllDevices ()

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

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

اتصال مجدد DeviceToTcp 

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

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

پرتاب‌ها
DeviceNotAvailableException

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

public void removeDeviceMonitor (IDeviceMonitor mon)

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

پارامترها
mon IDeviceMonitor

حذف FastbootListener 

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

removeMonitoringTcpFastbootDevice 

public void removeMonitoringTcpFastbootDevice (String serial)

پارامترها
serial String

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

public void restartAdbBridge ()

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

stopAdbBridge 

public void stopAdbBridge ()

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

خاتمه دادن 

public void terminate ()

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

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

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

public void terminateDeviceMonitor ()

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

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

public void terminateDeviceRecovery ()

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

خاتمه سخت 

public void terminateHard (String reason)

مانند terminateHard() .

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

خاتمه سخت 

public void terminateHard ()

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

waitForFirstDeviceAdded 

public boolean waitForFirstDeviceAdded (long timeout)

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

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

بازگشت‌ها
boolean