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)

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

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)

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

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)

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

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

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

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

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

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

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

alocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

اطلب جهازًا للاختبار يلبي معايير معينة.

حدود
options IDeviceSelection : IDeviceSelection الذي يجب أن يلبيه الجهاز.

isTemporary boolean : ما إذا كان يجب إنشاء NullDevice مؤقتًا أم لا.

عائدات
ITestDevice ITestDevice للاختبار، أو null إذا لم يكن متاحًا

alocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

اطلب جهازًا للاختبار يلبي معايير معينة.

حدود
options IDeviceSelection : IDeviceSelection الذي يجب أن يلبيه الجهاز.

عائدات
ITestDevice ITestDevice للاختبار، أو null إذا لم يكن متاحًا

alocateDevice

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 ITestDevice أو null إذا تعذر إنشاء اتصال TCP

dcconnectFromTcpDevice

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 : أمر الصدفة.

timeout long : مقدار الوقت الذي يستغرقه الأمر لإكماله.

timeUnit TimeUnit : وحدة المهلة.

عائدات
CommandResult CommandResult .

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

تخصيص جهاز بشكل فظ، حتى لو لم يكن متوفرًا حاليًا.

لن يكون له أي تأثير إذا تم تخصيص الجهاز بالفعل.

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

عائدات
ITestDevice ITestDevice ، أو null إذا تعذر تخصيصه

freeDevice

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

فيه

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

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

deviceMonitors

فيه

public abstract void init ()

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

com.isEmulator

public abstract boolean isEmulator (String serial)

تحديد ما إذا كان التسلسل المحدد يمثل محاكيًا

حدود
serial String

عائدات
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

عائدات
boolean

com.isNullDevice

public abstract boolean isNullDevice (String serial)

تحديد ما إذا كان المسلسل المحدد يمثل جهازًا فارغًا

حدود
serial String

عائدات
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

قم بإيقاف تشغيل المحاكي المحدد.

كتل حتى يختفي المحاكي من بنك التنمية الآسيوي. لن يكون له أي تأثير إذا كان المحاكي غير متوفر بالفعل.

حدود
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 لجميع الأجهزة المعروفة

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

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

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

com.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 والخدمات على اتصالات adb.

stopAdbBridge

public abstract void stopAdbBridge ()

إيقاف جسر adb والخدمات تعتمد على اتصالات adb.

إنهاء

public abstract void terminate ()

يوقف خدمات مراقبة الجهاز، وينهي مكتبة ddm.

يجب أن يتم استدعاء هذا عند إنهاء التطبيق.

أنظر أيضا:

terminerDeviceMonitor

public abstract void terminateDeviceMonitor ()

إيقاف شاشات الجهاز.

terminerDeviceRecovery

public abstract void terminateDeviceRecovery ()

يوقف مؤشر ترابط استرداد الجهاز.

terminerHard

public void terminateHard (String reason)

مثل terminateHard() .

حدود
reason String : سبب اختياري محدد للإنهاء.

terminerHard

public abstract void terminateHard ()

مثل terminate() ، ولكنه يحاول إغلاق adb بالقوة أيضًا.

تمت إضافة waitForFirstDevice

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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

عائدات
boolean