مدير جهاز IDevice

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

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

ملخّص

الصفوف المتداخلة

interface IDeviceManager.IFastbootListener

أداة معالجة لتغيّرات حالة Fastboot (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)

يمكنك إعداد مدير الجهاز باستخدام فلتر للجهاز.

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)

طريقة مساعدة لتشغيل المحاكي

abstract listAllDevices(boolean shortDescriptor)

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

abstract listAllDevices()

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

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

إضافة FastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

مهمة: هذه محاولة بسيطة - ابحث عن حل أفضل

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

إضافة جهاز إلى شاشة Fastboot مراقبة ستستخدم أداة Fastboot المراقبة "Fastboot_serial" إلى الاتصال بالجهاز.

المعلمات
serial String: الرقم التسلسلي للجهاز
fastboot_serial String: الرقم التسلسلي لوضع Fastboot (Fastboot mode) على الجهاز

تخصيص جهاز

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

قطع الاتصال من TcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

إلغاء الربط بجهاز مرتبط بأداة adb-over-tcp.

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

المعلمات
tcpDevice ITestDevice: الجهاز في وضع tcp حاليًا، تم تخصيصه سابقًا عبر connectToTcpDevice(String)
المرتجعات
boolean true إذا تم التبديل إلى وضع USB بنجاح.

معلومات حول العرض

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

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

المعلمات
printWriter PrintWriter: السمة ERROR(/PrintWriter) التي سيتم إخراج الوصف منها
includeStub boolean: تحديد ما إذا كان سيتم عرض أجهزة التنويهات الموجزة أيضًا أم لا

تنفيذCmdOnavailableDevice

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 يُستخدم للتحكّم في ما إذا إعادة الجهاز إلى مجموعة الأجهزة المتاحة.

الحصول على AdbPath

public abstract String getAdbPath ()

عرض المسار إلى ثنائي Adb لاستخدامه.

المرتجعات
String

getAdbVersion

public abstract String getAdbVersion ()

احصل على إصدار adb الذي يستخدمه مدير الأجهزة حاليًا.

المرتجعات
String

الحصول على أداة وصف الجهاز

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

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

isEmulator

public abstract boolean isEmulator (String serial)

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

المعلمات
serial String

المرتجعات
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

المرتجعات
boolean

جهاز isNull

public abstract boolean isNullDevice (String serial)

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

المعلمات
serial String

المرتجعات
boolean

إغلاق المحاكي

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: الوقت اللازم لتشغيل المحاكي بالمللي ثانية
emulatorArgs : وسيطات سطر الأوامر لتشغيل المحاكي
الرميات
DeviceNotAvailableException في حال تعذُّر تشغيل المحاكي أو الاتصال بالإنترنت

قائمة جميع الأجهزة

public abstract  listAllDevices (boolean shortDescriptor)

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

المعلمات
shortDescriptor boolean: ما إذا كان سيتم حصر الوصف بالحد الأدنى من المعلومات أم لا
المرتجعات
قائمة بقيمة DeviceDescriptor لجميع الأجهزة المعروفة

قائمة جميع الأجهزة

public abstract  listAllDevices ()

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

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

إعادة ربطDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

المعلمات
usbDevice ITestDevice: الجهاز في وضع USB حاليًا
المرتجعات
ITestDevice ITestDevice المخصّصة حديثًا في وضع tcp أو null إذا كانت tcp تعذَّر إنشاء اتصال
الرميات
DeviceNotAvailableException إذا انقطع الاتصال بـ usbDevice تعذر استردادها

إزالة DeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

يؤدي هذا الإجراء إلى إزالة IDeviceMonitor تمت إضافته سابقًا. لن يكون له أي تأثير إذا لم تتم إضافة الاثنين.

المعلمات
mon IDeviceMonitor

إزالة FastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

إعادة تشغيلAdbridge

public abstract void restartAdbBridge ()

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

cannot translate

public abstract void stopAdbBridge ()

يعتمد إيقاف مجموعة إعدادات Adb Bridge والخدمات على اتصالات adb.

إنهاء

public abstract void terminate ()

إيقاف خدمات مراقبة الأجهزة وإنهاء مكتبة DDm

يجب طلب ذلك عند إنهاء الطلب.

يُرجى الاطّلاع أيضًا على:

EndDeviceMonitor

public abstract void terminateDeviceMonitor ()

أوقِف شاشات الأجهزة.

إنهاء عملية استرداد الجهاز

public abstract void terminateDeviceRecovery ()

تؤدي هذه السياسة إلى إيقاف سلسلة محادثات استرداد الجهاز.

إنهاء صعب

public void terminateHard (String reason)

مثل "terminateHard()".

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

إنهاء صعب

public abstract void terminateHard ()

مثل terminate()، ولكنّه يحاول إيقاف Adb أيضًا بشكل كامل.

انتظار الجهاز الأول مُضاف

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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