IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


واجهة لإدارة مجموعة الأجهزة المتاحة للاختبار.

ملخص

فئات متداخلة

interface IDeviceManager.IFastbootListener

مستمع لتغييرات حالة Fastboot.

الأساليب العامة

abstract void addDeviceMonitor ( IDeviceMonitor mon)

يضيف IDeviceMonitor

abstract void addFastbootListener ( IDeviceManager.IFastbootListener listener)

يخبر المدير أن المستمع مهتم بتغييرات حالة Fastboot.

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

أضف جهازًا إلى شاشة Fastboot.

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

إرجاع المسار إلى ملف 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)

يخبر المدير أن المستمع لم يعد مهتمًا بتغييرات حالة Fastboot.

abstract void restartAdbBridge ()

إعادة التشغيل (إذا تم استدعاء stopAdbBridge() ) تعتمد جسر adb والخدمات على اتصالات 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)

انتظر حتى يتم توصيل أول جهاز مادي.

الأساليب العامة

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

يضيف IDeviceMonitor

حدود
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

يخبر المدير أن المستمع مهتم بتغييرات حالة Fastboot.

في الوقت الحالي ، لن يقوم IDeviceManager بمراقبة الأجهزة في fastboot إلا إذا كان هناك مستمع نشط واحد أو أكثر.

TODO: هذا نوع من الاختراق - اعثر على حل أفضل

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

أضف جهازًا إلى شاشة Fastboot. ستستخدم شاشة Fastboot "fastboot_serial" للتواصل مع الجهاز.

حدود
serial String : الرقم التسلسلي للجهاز.

fastboot_serial String : الرقم التسلسلي لوضع Fastboot للجهاز.

تخصيص الجهاز

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 إذا لم يتوفر واحد

جهاز connectToTcp

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

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

افصل جهاز adb-over-tcp المتصل.

يعيد الجهاز إلى وضع USB ويحرره.

حدود
tcpDevice ITestDevice : الجهاز حاليًا في وضع tcp ، تم تخصيصه مسبقًا عبر connectToTcpDevice(String)

عائدات
boolean true إذا كان التبديل إلى وضع USB ناجحًا

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)

طريقة مساعدة لتنفيذ أمر shell على الجهاز المتاح.

حدود
serial String : الرقم التسلسلي للجهاز.

command String : أمر shell.

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 للجهاز المحدد ، أو null إذا كان المسلسل لا يتطابق مع جهاز معروف.

getFastbootPath

public abstract String getFastbootPath ()

إرجاع المسار إلى ملف fastboot الثنائي المراد استخدامه.

عائدات
String

فيه

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

قم بتهيئة مدير الجهاز باستخدام مرشح الجهاز. يمكن استخدام هذا المرشح لتوجيه DeviceManager لتجاهل بعض الأجهزة المتصلة.

حدود
globalDeviceFilter IDeviceSelection : مرشح الجهاز

deviceMonitors

فيه

public abstract void init ()

قم بتهيئة مدير الجهاز. يجب استدعاء هذا مرة واحدة ومرة ​​واحدة فقط قبل استدعاء أي طرق أخرى.

محاكي

public abstract boolean isEmulator (String serial)

حدد ما إذا كان المسلسل المعطى يمثل محاكيًا

حدود
serial String

عائدات
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

يُرجع ما إذا كان يجب علينا التحقق في NativeDeviceStateMonitor أم لا ، من تثبيت نظام الملفات بشكل صحيح.

عائدات
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 إذا فشل المحاكي في التمهيد أو الاتصال بالإنترنت

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

تُرجع قائمة DeviceDescriptors لجميع الأجهزة المعروفة

حدود
shortDescriptor boolean : ما إذا كان سيتم قصر الواصفات على الحد الأدنى من المعلومات

عائدات
قائمة DeviceDescriptor لجميع الأجهزة المعروفة

listAllDevices

public abstract  listAllDevices ()

تُرجع قائمة DeviceDescriptors لجميع الأجهزة المعروفة

عائدات
قائمة DeviceDescriptor لجميع الأجهزة المعروفة

أعد توصيل الجهاز إلى Tcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

طريقة مساعدة تقوم بتحويل جهاز USB المحدد إلى وضع adb-over-tcp ، ثم الاتصال به عبر connectToTcpDevice(String) .

حدود
usbDevice ITestDevice : الجهاز حاليا في وضع USB

عائدات
ITestDevice ITestDevice المخصص حديثًا في وضع tcp أو null إذا تعذر تكوين اتصال tcp

رميات
DeviceNotAvailableException إذا فُقد الاتصال بجهاز usbDevice ولا يمكن استعادته

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

يزيل IDeviceMonitor الذي تمت إضافته مسبقًا. ليس له تأثير إذا لم تتم إضافة mon.

حدود
mon IDeviceMonitor

إزالة FastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

يخبر المدير أن المستمع لم يعد مهتمًا بتغييرات حالة Fastboot.

إعادة تشغيل

public abstract void restartAdbBridge ()

إعادة التشغيل (إذا تم استدعاء stopAdbBridge() ) تعتمد جسر adb والخدمات على اتصالات adb.

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 بقوة أيضًا.

waitForFirstDevice added

public abstract boolean waitForFirstDeviceAdded (long timeout)

انتظر حتى يتم توصيل أول جهاز مادي. إذا تم توصيل الجهاز من قبل ، فإنه يعود مباشرة إلى True. إذا لم تتم إضافة أي جهاز ، فسيتم إرجاعه خطأ بعد انتهاء المهلة.

حدود
timeout long : حان وقت الانتظار بالملي ثانية قبل إرجاع القيمة false.

عائدات
boolean