IDeviceManager
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
واجهة لإدارة مجموعة الأجهزة المتاحة للاختبار.
ملخص
فئات متداخلة | |
---|---|
interface | IDeviceManager.IFastbootListener مستمع لتغييرات حالة Fastboot. |
الأساليب العامة | |
---|---|
abstract void | addDeviceMonitor ( IDeviceMonitor mon) يضيف |
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 تخصص هذه الطريقة جهازًا جديدًا ، والذي يجب تحريره في النهاية عبر سيكون |
abstract boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) افصل جهاز adb-over-tcp المتصل. |
abstract void | displayDevicesInfo (PrintWriter printWriter, boolean includeStub) قم بإخراج وصف سهل الاستخدام يحتوي على قائمة بالأجهزة المعروفة وحالتها وقيم خيارات |
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 () يُرجع ما إذا كان يجب علينا التحقق في |
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 ، ثم الاتصال به عبر |
abstract void | removeDeviceMonitor ( IDeviceMonitor mon) يزيل |
abstract void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) يخبر المدير أن المستمع لم يعد مهتمًا بتغييرات حالة Fastboot. |
abstract void | restartAdbBridge () إعادة التشغيل (إذا تم استدعاء |
abstract void | stopAdbBridge () توقف جسر adb والخدمات التي تعتمد على اتصالات adb. |
abstract void | terminate () يوقف خدمات مراقبة الجهاز ، وينهي مكتبة ddm. |
abstract void | terminateDeviceMonitor () قم بإيقاف أجهزة مراقبة الجهاز. |
abstract void | terminateDeviceRecovery () يوقف مؤشر ترابط استعادة الجهاز. |
default void | terminateHard (String reason) مثل |
abstract void | terminateHard () مثل |
abstract boolean | waitForFirstDeviceAdded (long timeout) انتظر حتى يتم توصيل أول جهاز مادي. |
الأساليب العامة
addDeviceMonitor
public abstract void addDeviceMonitor (IDeviceMonitor mon)
يضيف IDeviceMonitor
حدود | |
---|---|
mon | IDeviceMonitor |
addFastbootListener
public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)
يخبر المدير أن المستمع مهتم بتغييرات حالة Fastboot.
في الوقت الحالي ، لن يقوم IDeviceManager
بمراقبة الأجهزة في fastboot إلا إذا كان هناك مستمع نشط واحد أو أكثر.
TODO: هذا نوع من الاختراق - اعثر على حل أفضل
addMonitoringTcpFastbootDevice
public abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
أضف جهازًا إلى شاشة Fastboot. ستستخدم شاشة Fastboot "fastboot_serial" للتواصل مع الجهاز.
حدود | |
---|---|
serial | String : الرقم التسلسلي للجهاز. |
fastboot_serial | String : الرقم التسلسلي لوضع Fastboot للجهاز. |
تخصيص الجهاز
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 إذا لم يتوفر واحد |
جهاز connectToTcp
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 |
disconnectFromTcpDevice
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 : أمر 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 . يُستخدم للتحكم في إعادة الجهاز إلى تجمع الأجهزة المتاح. |
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 للجهاز المحدد ، أو null إذا كان المسلسل لا يتطابق مع جهاز معروف. |
getFastbootPath
public abstract String getFastbootPath ()
إرجاع المسار إلى ملف fastboot الثنائي المراد استخدامه.
عائدات | |
---|---|
String |
فيه
public abstract void init (IDeviceSelection globalDeviceFilter,deviceMonitors)
قم بتهيئة مدير الجهاز باستخدام مرشح الجهاز. يمكن استخدام هذا المرشح لتوجيه DeviceManager لتجاهل بعض الأجهزة المتصلة.
حدود | |
---|---|
globalDeviceFilter | IDeviceSelection : مرشح الجهاز |
deviceMonitors |
فيه
public abstract void init ()
قم بتهيئة مدير الجهاز. يجب استدعاء هذا مرة واحدة ومرة واحدة فقط قبل استدعاء أي طرق أخرى.
محاكي
public abstract boolean isEmulator (String serial)
حدد ما إذا كان المسلسل المعطى يمثل محاكيًا
حدود | |
---|---|
serial | String |
عائدات | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
يُرجع ما إذا كان يجب علينا التحقق في NativeDeviceStateMonitor
أم لا ، من تثبيت نظام الملفات بشكل صحيح.
عائدات | |
---|---|
boolean |
isNullDevice
public abstract boolean isNullDevice (String serial)
تحديد ما إذا كان المسلسل المعطى يمثل جهازًا فارغًا
حدود | |
---|---|
serial | String |
عائدات | |
---|---|
boolean |
killEmulator
public abstract void killEmulator (ITestDevice device)
قم بإيقاف تشغيل المحاكي المحدد.
كتل حتى يختفي المحاكي من ADB. لن يكون لها أي تأثير إذا لم يكن المحاكي متاحًا بالفعل.
حدود | |
---|---|
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 abstractlistAllDevices (boolean shortDescriptor)
تُرجع قائمة DeviceDescriptors لجميع الأجهزة المعروفة
حدود | |
---|---|
shortDescriptor | boolean : ما إذا كان سيتم قصر الواصفات على الحد الأدنى من المعلومات |
عائدات | |
---|---|
قائمة DeviceDescriptor لجميع الأجهزة المعروفة |
listAllDevices
public abstractlistAllDevices ()
تُرجع قائمة DeviceDescriptors لجميع الأجهزة المعروفة
عائدات | |
---|---|
قائمة DeviceDescriptor لجميع الأجهزة المعروفة |
أعد توصيل الجهاز إلى Tcp
public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
طريقة مساعدة تقوم بتحويل جهاز USB المحدد إلى وضع adb-over-tcp ، ثم الاتصال به عبر connectToTcpDevice(String)
.
حدود | |
---|---|
usbDevice | ITestDevice : الجهاز حاليا في وضع USB |
عائدات | |
---|---|
ITestDevice | ITestDevice المخصص حديثًا في وضع tcp أو null إذا تعذر تكوين اتصال tcp |
رميات | |
---|---|
DeviceNotAvailableException | إذا فُقد الاتصال بجهاز usbDevice ولا يمكن استعادته |
removeDeviceMonitor
public abstract void removeDeviceMonitor (IDeviceMonitor mon)
يزيل IDeviceMonitor
الذي تمت إضافته مسبقًا. ليس له تأثير إذا لم تتم إضافة mon.
حدود | |
---|---|
mon | IDeviceMonitor |
إزالة FastbootListener
public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)
يخبر المدير أن المستمع لم يعد مهتمًا بتغييرات حالة Fastboot.
إعادة تشغيل
public abstract void restartAdbBridge ()
إعادة التشغيل (إذا تم استدعاء stopAdbBridge()
) تعتمد جسر adb والخدمات على اتصالات adb.
stopAdbBridge
public abstract void stopAdbBridge ()
توقف جسر adb والخدمات التي تعتمد على اتصالات adb.
إنهاء
public abstract void terminate ()
يوقف خدمات مراقبة الجهاز ، وينهي مكتبة ddm.
يجب استدعاء هذا عند إنهاء التطبيق.
أنظر أيضا:
إنهاء جهاز مراقبة
public abstract void terminateDeviceMonitor ()
قم بإيقاف أجهزة مراقبة الجهاز.
إنهاء جهاز الاسترداد
public abstract void terminateDeviceRecovery ()
يوقف مؤشر ترابط استعادة الجهاز.
إنهاء صعب
public void terminateHard (String reason)
مثل terminateHard()
.
حدود | |
---|---|
reason | String : سبب اختياري معطى للإنهاء. |
إنهاء صعب
public abstract void terminateHard ()
مثل terminate()
، ولكن محاولات لإغلاق adb بقوة أيضًا.
waitForFirstDevice added
public abstract boolean waitForFirstDeviceAdded (long timeout)
انتظر حتى يتم توصيل أول جهاز مادي. إذا تم توصيل الجهاز من قبل ، فإنه يعود مباشرة إلى True. إذا لم تتم إضافة أي جهاز ، فسيتم إرجاعه خطأ بعد انتهاء المهلة.
حدود | |
---|---|
timeout | long : حان وقت الانتظار بالملي ثانية قبل إرجاع القيمة false. |
عائدات | |
---|---|
boolean |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-03-30 (حسب التوقيت العالمي المتفَّق عليه)