مدير الجهاز

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

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

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

حدود
shortDescriptor	boolean : ما إذا كان سيتم قصر الواصفات على الحد الأدنى من المعلومات

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

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