IDeviceManager
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
واجهة لإدارة مجموعة الأجهزة المتاحة للاختبار.
ملخص
فصول متداخلة | |
---|---|
interface | IDeviceManager.IFastbootListener مستمع لتغييرات حالة fastboot. |
الأساليب العامة | |
---|---|
abstract void | addDeviceMonitor ( IDeviceMonitor mon) يضيف |
abstract void | addFastbootListener ( IDeviceManager.IFastbootListener listener) إبلاغ المدير بأن المستمع مهتم بتغييرات حالة التشغيل السريع. |
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) إبلاغ المدير بأن المستمع لم يعد مهتمًا بتغييرات حالة التشغيل السريع. |
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)
إبلاغ المدير بأن المستمع مهتم بتغييرات حالة التشغيل السريع.
حاليًا، سيقوم IDeviceManager
بمراقبة الأجهزة في fastboot فقط إذا كان هناك واحد أو أكثر من المستمعين النشطين.
المهام: هذا نوع من الاختراق - ابحث عن حل أفضل
addMonitoringTcpFastbootDevice
public abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
أضف جهازًا إلى شاشة fastboot. ستستخدم شاشة fastboot "fastboot_serial" للتواصل مع الجهاز.
حدود | |
---|---|
serial | String : الرقم التسلسلي للجهاز. |
fastboot_serial | String : الرقم التسلسلي لوضع التشغيل السريع للجهاز. |
alocateDevice
public abstract ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
اطلب جهازًا للاختبار يلبي معايير معينة.
حدود | |
---|---|
options | IDeviceSelection : IDeviceSelection الذي يجب أن يلبيه الجهاز. |
isTemporary | boolean : ما إذا كان يجب إنشاء NullDevice مؤقتًا أم لا. |
عائدات | |
---|---|
ITestDevice | ITestDevice للاختبار، أو null إذا لم يكن متاحًا |
alocateDevice
public abstract ITestDevice allocateDevice (IDeviceSelection options)
اطلب جهازًا للاختبار يلبي معايير معينة.
حدود | |
---|---|
options | IDeviceSelection : IDeviceSelection الذي يجب أن يلبيه الجهاز. |
عائدات | |
---|---|
ITestDevice | ITestDevice للاختبار، أو null إذا لم يكن متاحًا |
alocateDevice
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 |
dcconnectFromTcpDevice
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 : أمر الصدفة. |
timeout | long : مقدار الوقت الذي يستغرقه الأمر لإكماله. |
timeUnit | TimeUnit : وحدة المهلة. |
عائدات | |
---|---|
CommandResult | CommandResult . |
forceAllocateDevice
public abstract ITestDevice forceAllocateDevice (String serial)
تخصيص جهاز بشكل فظ، حتى لو لم يكن متوفرًا حاليًا.
لن يكون له أي تأثير إذا تم تخصيص الجهاز بالفعل.
حدود | |
---|---|
serial | String : الجهاز التسلسلي المراد تخصيصه |
عائدات | |
---|---|
ITestDevice | ITestDevice ، أو null إذا تعذر تخصيصه |
freeDevice
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 للجهاز المحدد، أو يكون فارغًا إذا كان التسلسل لا يتطابق مع جهاز معروف. |
getFastbootPath
public abstract String getFastbootPath ()
إرجاع المسار إلى ثنائي fastboot المراد استخدامه.
عائدات | |
---|---|
String |
فيه
public abstract void init (IDeviceSelection globalDeviceFilter,deviceMonitors)
قم بتهيئة مدير الجهاز باستخدام عامل تصفية الجهاز. يمكن استخدام هذا المرشح لتوجيه DeviceManager لتجاهل بعض الأجهزة المتصلة.
حدود | |
---|---|
globalDeviceFilter | IDeviceSelection : مرشح الجهاز |
deviceMonitors |
فيه
public abstract void init ()
تهيئة مدير الجهاز. يجب أن يتم استدعاء هذا مرة واحدة فقط قبل استدعاء أية طرق أخرى.
com.isEmulator
public abstract boolean isEmulator (String serial)
تحديد ما إذا كان التسلسل المحدد يمثل محاكيًا
حدود | |
---|---|
serial | String |
عائدات | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
إرجاع ما إذا كان ينبغي لنا التحقق في NativeDeviceStateMonitor
من تثبيت نظام الملفات بشكل صحيح أم لا.
عائدات | |
---|---|
boolean |
com.isNullDevice
public abstract boolean isNullDevice (String serial)
تحديد ما إذا كان المسلسل المحدد يمثل جهازًا فارغًا
حدود | |
---|---|
serial | String |
عائدات | |
---|---|
boolean |
killEmulator
public abstract void killEmulator (ITestDevice device)
قم بإيقاف تشغيل المحاكي المحدد.
كتل حتى يختفي المحاكي من بنك التنمية الآسيوي. لن يكون له أي تأثير إذا كان المحاكي غير متوفر بالفعل.
حدود | |
---|---|
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 لجميع الأجهزة المعروفة |
reconnectDeviceToTcp
public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
طريقة مساعدة تقوم بتحويل جهاز USB المحدد إلى وضع adb-over-tcp، ثم الاتصال به عبر connectToTcpDevice(String)
.
حدود | |
---|---|
usbDevice | ITestDevice : الجهاز الموجود حاليًا في وضع USB |
عائدات | |
---|---|
ITestDevice | ITestDevice المخصص حديثًا في وضع tcp أو null إذا تعذر تكوين اتصال tcp |
رميات | |
---|---|
DeviceNotAvailableException | إذا فُقد الاتصال بجهاز usbDevice ولا يمكن استعادته |
com.removeDeviceMonitor
public abstract void removeDeviceMonitor (IDeviceMonitor mon)
يزيل IDeviceMonitor
الذي تمت إضافته مسبقًا. ليس له أي تأثير إذا لم تتم إضافة mon.
حدود | |
---|---|
mon | IDeviceMonitor |
إزالة FastbootListener
public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)
إبلاغ المدير بأن المستمع لم يعد مهتمًا بتغييرات حالة التشغيل السريع.
إعادة تشغيلAdbBridge
public abstract void restartAdbBridge ()
أعد تشغيل (إذا تم استدعاء stopAdbBridge()
) يعتمد جسر adb والخدمات على اتصالات adb.
stopAdbBridge
public abstract void stopAdbBridge ()
إيقاف جسر adb والخدمات تعتمد على اتصالات adb.
إنهاء
public abstract void terminate ()
يوقف خدمات مراقبة الجهاز، وينهي مكتبة ddm.
يجب أن يتم استدعاء هذا عند إنهاء التطبيق.
أنظر أيضا:
terminerDeviceMonitor
public abstract void terminateDeviceMonitor ()
إيقاف شاشات الجهاز.
terminerDeviceRecovery
public abstract void terminateDeviceRecovery ()
يوقف مؤشر ترابط استرداد الجهاز.
terminerHard
public void terminateHard (String reason)
مثل terminateHard()
.
حدود | |
---|---|
reason | String : سبب اختياري محدد للإنهاء. |
terminerHard
public abstract void terminateHard ()
مثل terminate()
، ولكنه يحاول إغلاق adb بالقوة أيضًا.
تمت إضافة waitForFirstDevice
public abstract boolean waitForFirstDeviceAdded (long timeout)
انتظر حتى يتم توصيل أول جهاز فعلي. إذا تم توصيل جهاز من قبل، فإنه يعود مباشرة صحيح. إذا لم تتم إضافة أي جهاز، فسيتم إرجاع خطأ بعد انتهاء المهلة.
حدود | |
---|---|
timeout | long : وقت الانتظار بالمللي ثانية قبل إرجاع خطأ. |
عائدات | |
---|---|
boolean |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-12-01 (حسب التوقيت العالمي المتفَّق عليه)