تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مدير الجهاز

public class DeviceManager
extends Object implements IDeviceManager

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


ملخص

فئات متداخلة

class DeviceManager.FastbootDevice

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

مجالات

public static final String UNKNOWN_DISPLAY_STRING

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

protected DeviceMonitorMultiplexer mDvcMon

protected boolean mFastbootEnabled

المنشئون العامة

DeviceManager ()

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

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

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

يضيف IDeviceMonitor

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) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

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

void init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) 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) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

طريقة المساعد لإطلاق المحاكي.

listAllDevices ()

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

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

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

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

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

المعلمات
stubDevice IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

يضيف IDeviceMonitor

المعلمات
mon IDeviceMonitor

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

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

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

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

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

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

المعلمات
serial String : الرقم التسلسلي للجهاز.

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

تخصيص الجهاز

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

جهاز connectToTcp

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

getAdbPath

public String getAdbPath ()

إرجاع المسار إلى ملف adb الثنائي المطلوب استخدامه.

عائدات
String

getAdbVersion

public String getAdbVersion ()

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

عائدات
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

ترجع DeviceDescriptor بالتسلسل المحدد.

المعلمات
serial String : الرقم التسلسلي للجهاز الذي سيحصل عليه

عائدات
DeviceDescriptor DeviceDescriptor للجهاز المحدد ، أو null إذا كان المسلسل لا يتطابق مع جهاز معروف.

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

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

محاكي

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

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

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

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

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

إزالة FastbootListener

public void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

إعادة تشغيل

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

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

إنهاء

public void terminate ()

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

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

إنهاء جهاز مراقبة

public void terminateDeviceMonitor ()

قم بإيقاف أجهزة مراقبة الجهاز.

إنهاء جهاز الاسترداد

public void terminateDeviceRecovery ()

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

إنهاء صعب

public void terminateHard (String reason)

مثل terminateHard() .

المعلمات
reason String : سبب اختياري معطى للإنهاء.

إنهاء صعب

public void terminateHard ()

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

waitForFirstDevice added

public boolean waitForFirstDeviceAdded (long timeout)

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

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

عائدات
boolean