مدير الجهاز

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
↳ com.android.tradefed.device.DeviceManager

ملخّص

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

class DeviceManager.FastbootDevice

تمثيل جهاز في وضع Fastboot (Fastboot mode). 

الحقول

public static final String UNKNOWN_DISPLAY_STRING

عرض سلسلة للخصائص غير المعروفة

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

شركة إنشاءات عامة

DeviceManager()

يجب استرداد "مدير الجهاز" من GlobalConfiguration.

الطرق العامة

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

يضيف IDeviceMonitor

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

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

void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

إضافة جهاز إلى شاشة Fastboot مراقبة

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

لعرض المسار إلى البرنامج الثنائي لـ Fastboot لاستخدامه.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

تهيئة مدير الجهاز.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

تهيئة مدير الجهاز.

void init()

تهيئة مدير الجهاز.

boolean isEmulator(String serial)

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

boolean isFileSystemMountCheckEnabled()

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

boolean isNullDevice(String serial)

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

void killEmulator(ITestDevice device)

أوقِف تشغيل المحاكي المحدد.

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

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

listAllDevices(boolean shortDescriptor)

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

listAllDevices()

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

ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

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

void removeDeviceMonitor(IDeviceMonitor mon)

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

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

void restartAdbBridge()

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

void stopAdbBridge()

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

void terminate()

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

void terminateDeviceMonitor()

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

void terminateDeviceRecovery()

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

void terminateHard(String reason)

مثل "terminateHard()".

void terminateHard()

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

boolean waitForFirstDeviceAdded(long timeout)

انتظِر إلى أن يتم توصيل أول جهاز فعلي.

الحقول

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

عرض سلسلة للخصائص غير المعروفة

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

شركة إنشاءات عامة

مدير الجهاز

public DeviceManager ()

يجب استرداد "مدير الجهاز" من GlobalConfiguration.

الطرق العامة

إضافة جهاز متاح

public void addAvailableDevice (IDevice stubDevice)

المعلمات
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

يضيف IDeviceMonitor

المعلمات
mon IDeviceMonitor

جهاز addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

المعلمات
fastbootDevice DeviceManager.FastbootDevice

إضافة FastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

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

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

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

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

تخصيص جهاز

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

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

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

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

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

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

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

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

تنفيذCmdOnavailableDevice

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

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

المعلمات
serial String: الرقم التسلسلي للجهاز
command String: أمر Shell.
timeout long: مدة اكتمال الأمر
timeUnit TimeUnit: وحدة المهلة
المرتجعات
CommandResult CommandResult

تنفيذ GlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

نفِّذ أمر adb لا يستهدف جهازًا معيّنًا، مثل "adb Connect"

المرتجعات
String إخراج std إذا كان الأمر خالٍ من الأخطاء في الحالات الأخرى.

جهاز forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

تخصيص جهاز فظ، حتى إذا لم يكن متاحًا في الوقت الحالي

لن يكون لذلك أي تأثير إذا سبق تخصيص الجهاز.

المعلمات
serial String: الرقم التسلسلي للجهاز المراد تخصيصه
المرتجعات
ITestDevice ITestDevice، أو null إذا تعذّر تخصيصهما

جهاز مجاني

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

إرجاع جهاز إلى حوض السباحة

وسيتم تجاهل محاولات إرجاع جهاز لم يتم تخصيصه سابقًا.

المعلمات
device ITestDevice: المساحة المتوفّرة لـ ITestDevice
deviceState FreeDeviceState: FreeDeviceState يُستخدم للتحكّم في ما إذا إعادة الجهاز إلى مجموعة الأجهزة المتاحة.

الحصول على AdbPath

public String getAdbPath ()

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

المرتجعات
String

getAdbVersion

public String getAdbVersion ()

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

المرتجعات
String

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

public DeviceDescriptor getDeviceDescriptor (String serial)

لعرض DeviceDescriptor مع الرقم التسلسلي المحدد.

المعلمات
serial String: الرقم التسلسلي للجهاز الذي سيتم الحصول عليه
المرتجعات
DeviceDescriptor تكون قيمة DeviceDescriptor للجهاز المحدّد أو صفرًا إذا لم يكن الرقم التسلسلي لا يتضمن يتطابق مع جهاز معروف.

الطريقة getFastbootPath

public String getFastbootPath ()

لعرض المسار إلى البرنامج الثنائي لـ Fastboot لاستخدامه.

المرتجعات
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 ()

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

isEmulator

public boolean isEmulator (String serial)

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

المعلمات
serial String

المرتجعات
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

المرتجعات
boolean

جهاز isNull

public boolean isNullDevice (String serial)

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

المعلمات
serial String

المرتجعات
boolean

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

public void killEmulator (ITestDevice device)

أوقِف تشغيل المحاكي المحدد.

يتم حظر المستخدم إلى أن يختفي المحاكي من adb. لن يكون للمحاكي أي تأثير إذا لم يكن المحاكي مفعلاً حاليًا. المتوفرة.

المعلمات
device ITestDevice: ITestDevice الذي يمثل المحاكي المطلوب إيقاف تشغيله
الرميات
DeviceNotAvailableException

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

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

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

سيتم تشغيل المحاكي كما حدده المتصل

المعلمات
device ITestDevice: العنصر النائب ITestDevice الذي يمثّل جهاز المحاكي المخصّص
bootTimeout long: الوقت اللازم لتشغيل المحاكي بالمللي ثانية
emulatorArgs : وسيطات سطر الأوامر لتشغيل المحاكي
الرميات
DeviceNotAvailableException

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

public  listAllDevices (boolean shortDescriptor)

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

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

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

public  listAllDevices ()

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

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

إعادة ربطDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

إزالة-مراقبة الجهاز

public void removeDeviceMonitor (IDeviceMonitor mon)

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

المعلمات
mon IDeviceMonitor

إزالة FastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

إعادة تشغيلAdbridge

public void restartAdbBridge ()

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

cannot translate

public void stopAdbBridge ()

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

إنهاء

public void terminate ()

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

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

EndDeviceMonitor

public void terminateDeviceMonitor ()

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

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

public void terminateDeviceRecovery ()

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

إنهاء صعب

public void terminateHard (String reason)

مثل "terminateHard()".

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

إنهاء صعب

public void terminateHard ()

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

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

public boolean waitForFirstDeviceAdded (long timeout)

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

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