RemoteAndroidDevice

public class RemoteAndroidDevice
extends TestDevice

java.lang.Object
   ↳ com.android.tradefed.device.NativeDevice
     ↳ com.android.tradefed.device.TestDevice
       ↳ com.android.tradefed.device.RemoteAndroidDevice

تنفيذ ITestDevice لجهاز Android مزوّد بمجموعة كاملة من الأدوات ومتصل عبر adb connect لنفترض أنّ الرقم التسلسلي للجهاز سيكون بالتنسيق : في adb.

ملخّص

الثابتات

long DEFAULT_SHORT_CMD_TIMEOUT

int MAX_RETRIES

long RETRY_INTERVAL_MS

long WAIT_FOR_ADB_CONNECT

وظائف الإنشاء العامة

RemoteAndroidDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

لإنشاء RemoteAndroidDevice.

الطرق العامة

boolean adbTcpConnect(String host, String port)

طريقة مساعدة لربط adb بجهاز Android معيّن يعمل ببروتوكول tcp ip

boolean adbTcpDisconnect(String host, String port)

طريقة مساعدة لقطع اتصال adb بجهاز Android معيّن يستخدم بروتوكول النقل المتعدّد للملفات (TCP) وبروتوكول الإنترنت (IP)

static boolean checkSerialFormatValid(String serialString)

تحقَّق مما إذا كان تنسيق السلسلة كما هو متوقّع :port

DeviceDescriptor getDeviceDescriptor()

String getHostName()

عرض اسم المضيف المرتبط بالجهاز

String getMacAddress()

String getPortNum()

عرض رقم المنفذ المرتبط بالجهاز

boolean isEncryptionSupported()

void postAdbRootAction()

يمكنك إلغاء هذا الخيار إذا كان الجهاز بحاجة إلى اتّخاذ بعض الإجراءات المحدّدة بعد الحصول على إذن الوصول إلى الجذر من خلال adb وقبل إعادة ربط الجهاز بالإنترنت.

void postAdbUnrootAction()

يمكنك إلغاء هذا الخيار إذا كان الجهاز بحاجة إلى اتّخاذ بعض الإجراءات المحدّدة بعد إلغاء الجذر باستخدام adb وقبل إعادة الجهاز إلى الاتصال بالإنترنت.

void postInvocationTearDown(Throwable exception)

void recoverDevice()

يحاول الجهاز استعادة الاتصال.

void setAdbLogFile(File adbLogFile)

قدِّم ملف مستلِم يمكننا فيه تخزين جميع سجلات اتصال adb لأغراض تصحيح الأخطاء.

void waitForAdbConnect(long waitTime)

تحقَّق من تفعيل اتصال adb.

الطرق المحمية

String getInitialIp()

عرض عنوان IP الأولي المرتبط بالجهاز، إن توفّر

String getInitialSerial()

عرض الاسم التسلسلي الأولي للجهاز

void postAdbReboot()

الإجراءات الإضافية المحتمَلة التي يمكن اتخاذها بعد إعادة التشغيل

الثابتات

DEFAULT_SHORT_CMD_TIMEOUT

protected static final long DEFAULT_SHORT_CMD_TIMEOUT

القيمة الثابتة: 20000 (0x0000000000004e20)

MAX_RETRIES

protected static final int MAX_RETRIES

القيمة الثابتة: 5 (0x00000005)

RETRY_INTERVAL_MS

protected static final long RETRY_INTERVAL_MS

القيمة الثابتة: 5000 (0x0000000000001388)

WAIT_FOR_ADB_CONNECT

public static final long WAIT_FOR_ADB_CONNECT

القيمة الثابتة: 120000 (0x000000000001d4c0)

وظائف الإنشاء العامة

RemoteAndroidDevice

public RemoteAndroidDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

لإنشاء RemoteAndroidDevice.

المعلمات
device IDevice: IDevice المرتبط
stateMonitor IDeviceStateMonitor: آلية IDeviceStateMonitor المُستخدَمة
allocationMonitor IDeviceMonitor: IDeviceMonitor لإعلامك بتغييرات حالة التخصيص

الطرق العامة

adbTcpConnect

public boolean adbTcpConnect (String host, 
                String port)

طريقة مساعدة لربط adb بجهاز Android معيّن يعمل ببروتوكول tcp ip

المعلمات
host String: اسم المضيف/عنوان IP لجهاز Android يستخدم بروتوكول tcp/ip
port ‫String: رقم منفذ جهاز tcp/ip
المرتجعات
boolean صحيح إذا تم الاتصال بالجهاز بنجاح، خطأ في الحالات الأخرى

adbTcpDisconnect

public boolean adbTcpDisconnect (String host, 
                String port)

طريقة مساعدة لقطع اتصال adb بجهاز Android معيّن يستخدم بروتوكول النقل المتعدّد للملفات (TCP) وبروتوكول الإنترنت (IP)

المعلمات
host String: اسم المضيف/عنوان IP لجهاز Android يستخدم بروتوكول tcp/ip
port ‫String: رقم منفذ جهاز tcp/ip
المرتجعات
boolean صحيح إذا تم قطع الاتصال بالجهاز بنجاح، خطأ في الحالات الأخرى

checkSerialFormatValid

public static boolean checkSerialFormatValid (String serialString)

تحقَّق مما إذا كان تنسيق السلسلة كما هو متوقّع :port.

المعلمات
serialString String

المرتجعات
boolean صحيح إذا كان التنسيق صالحًا، وخطأ في الحالات الأخرى

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

المرتجعات
DeviceDescriptor

getHostName

public String getHostName ()

عرض اسم المضيف المرتبط بالجهاز تم استخراجها من المسلسل.

المرتجعات
String

getMacAddress

public String getMacAddress ()

المرتجعات
String

getPortNum

public String getPortNum ()

عرض رقم المنفذ المرتبط بالجهاز تم استخراجها من المسلسل.

المرتجعات
String

isEncryptionSupported

public boolean isEncryptionSupported ()

المرتجعات
boolean

postAdbRootAction

public void postAdbRootAction ()

يمكنك إلغاء هذا الخيار إذا كان الجهاز بحاجة إلى اتّخاذ بعض الإجراءات المحدّدة بعد الحصول على إذن الوصول إلى الجذر من خلال adb وقبل إعادة ربط الجهاز بالإنترنت. لا يتضمّن التنفيذ التلقائي أي إجراءات إضافية. لا يمكن ضمان تفعيل adb root في هذه المرحلة.

عمليات الرمي
DeviceNotAvailableException

postAdbUnrootAction

public void postAdbUnrootAction ()

يمكنك إلغاء هذا الخيار إذا كان الجهاز بحاجة إلى اتّخاذ بعض الإجراءات المحدّدة بعد إلغاء الجذر باستخدام adb وقبل إعادة الجهاز إلى الاتصال بالإنترنت. لا يتضمّن التنفيذ التلقائي أي إجراءات إضافية. لا يمكننا ضمان إيقاف إذن الوصول إلى الجذر في adb في هذه المرحلة.

عمليات الرمي
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

المعلمات
exception Throwable

recoverDevice

public void recoverDevice ()

يحاول الجهاز استعادة الاتصال.

عمليات الرمي
DeviceNotAvailableException

setAdbLogFile

public void setAdbLogFile (File adbLogFile)

قدِّم ملف مستلِم يمكننا فيه تخزين جميع سجلات اتصال adb لأغراض تصحيح الأخطاء.

المعلمات
adbLogFile File

waitForAdbConnect

public void waitForAdbConnect (long waitTime)

تحقَّق من تفعيل اتصال adb.

المعلمات
waitTime long

عمليات الرمي
DeviceNotAvailableException

الطرق المحمية

getInitialIp

protected String getInitialIp ()

عرض عنوان IP المرتبط بالجهاز في البداية، إن توفّر تعرِض قيمة فارغة إذا لم يكن هناك عنوان ip أولي معروف.

المرتجعات
String

getInitialSerial

protected String getInitialSerial ()

عرض الاسم التسلسلي الأولي للجهاز

المرتجعات
String

postAdbReboot

protected void postAdbReboot ()

الإجراءات الإضافية المحتمَلة التي يمكن اتخاذها بعد إعادة التشغيل

عمليات الرمي
DeviceNotAvailableException