DeviceManager

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
   ↳ 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)

أضِف جهازًا إلى أداة مراقبة 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)

تعرض هذه الطريقة قائمة بـ 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()

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

void stopAdbBridge()

أوقِف جسر تصحيح أخطاء Android (adb) والخدمات التي تعتمد على اتصالات 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

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

Constant Value: "unknown"

الحقول

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

الإنشاءات العامة

DeviceManager

public DeviceManager ()

يجب استرداد DeviceManager من GlobalConfiguration

الطُرق العامة

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

المعلمات
stubDevice IDevice

addAvailableNativeDevice

public void addAvailableNativeDevice (IDevice stubDevice)

المعلمات
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

يضيف IDeviceMonitor

المعلمات
mon IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

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

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

TODO: هذا حلّ مؤقت، يجب إيجاد حلّ أفضل

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastbootSerial)

أضِف جهازًا إلى أداة مراقبة Fastboot. سيستخدم برنامج مراقبة fastboot السلسلة "fastboot_serial" للتواصل مع الجهاز.

المعلمات
serial String: الرقم التسلسلي للجهاز
fastbootSerial ‫String: الرقم التسلسلي لوضع Fastboot في الجهاز

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

طلب جهاز للاختبار يستوفي معايير معيّنة

المعلمات
options IDeviceSelection: IDeviceSelection التي يجب أن يستوفيها الجهاز
isTemporary ‫boolean: لتحديد ما إذا كان يجب إنشاء NullDevice مؤقت أم لا.
المرتجعات
ITestDevice ITestDevice للاختبار، أو null في حال عدم توفّرها

allocateDevice

public ITestDevice allocateDevice (IDeviceSelection options)

طلب جهاز للاختبار يستوفي معايير معيّنة

المعلمات
options IDeviceSelection: IDeviceSelection التي يجب أن يستوفيها الجهاز
المرتجعات
ITestDevice ITestDevice للاختبار، أو null في حال عدم توفّرها

allocateDevice

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

disconnectFromTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

افصل الجهاز المرتبط عبر adb-over-tcp.

تعود هذه الطريقة بالجهاز إلى وضع USB وتتيح استخدامه.

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

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

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

executeCmdOnAvailableDevice

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

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

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

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

تنفيذ أمر adb غير مستهدف لجهاز معيّن، مثل adb connect

المرتجعات
String الناتج القياسي إذا نجح الأمر، أو قيمة فارغة في حال عدم نجاحه

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

تخصيص جهاز بشكل غير لائق، حتى إذا لم يكن متاحًا حاليًا

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

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

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

إرجاع جهاز إلى المجموعة

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

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

getAdbPath

public String getAdbPath ()

تعرض هذه السمة مسار ملف adb الثنائي المطلوب استخدامه.

المرتجعات
String

getAdbVersion

public String getAdbVersion ()

احصل على إصدار adb المستخدَم حاليًا من قِبل "مدير الأجهزة".

المرتجعات
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

تعرض هذه الطريقة DeviceDescriptor مع الرقم التسلسلي المحدّد.

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

getFastbootPath

public String getFastbootPath ()

تعرض هذه السمة مسار ملف fastboot الثنائي المطلوب استخدامه.

المرتجعات
String

init

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

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

المعلمات
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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

المعلمات
globalDeviceFilter ‫IDeviceSelection: فلتر الجهاز
globalDeviceMonitors

init

public void init ()

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

isEmulator

public boolean isEmulator (String serial)

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

المعلمات
serial String

المرتجعات
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

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

listAllDevices

public  listAllDevices (boolean shortDescriptor)

تعرض هذه الطريقة قائمة بـ DeviceDescriptors لجميع الأجهزة المعروفة

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

listAllDevices

public  listAllDevices ()

تعرض هذه الطريقة قائمة بـ DeviceDescriptors لجميع الأجهزة المعروفة

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

reconnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

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

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

removeDeviceMonitor

public void removeDeviceMonitor (IDeviceMonitor mon)

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

المعلمات
mon IDeviceMonitor

removeFastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

يُعلم هذا الإجراء المدير بأنّ المستمع لم يعُد مهتمًا بالتغييرات في حالة fastboot.

removeMonitoringTcpFastbootDevice

public void removeMonitoringTcpFastbootDevice (String serial)

المعلمات
serial String

restartAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

أوقِف جسر تصحيح أخطاء Android (adb) والخدمات التي تعتمد على اتصالات adb.

إنهاء

public void terminate ()

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

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

terminateDeviceMonitor

public void terminateDeviceMonitor ()

أوقِف "مراقبة الأجهزة".

terminateDeviceRecovery

public void terminateDeviceRecovery ()

توقف سلسلة استرداد الجهاز.

terminateHard

public void terminateHard (String reason)

أغانٍ مشابهة لأغاني terminateHard()

المعلمات
reason ‫String: سبب اختياري لإنهاء الاشتراك

terminateHard

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

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

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