اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

AdbTcpConnection

public class AdbTcpConnection
extends DefaultConnection

java.lang.Object
↳	com.android.tradefed.device.connection.AbstractConnection
	↳	com.android.tradefed.device.connection.DefaultConnection
		↳	com.android.tradefed.device.connection.AdbTcpConnection

الفئات الفرعية المباشرة المعروفة

AdbSshConnection

AdbSshConnection اتصال Adb عبر جسر ssh

تمثيل الاتصال التلقائي لجهاز، يُفترض أنّه اتصال adb عادي بالجهاز

ملخّص

الثوابت
`long`	`DEFAULT_SHORT_CMD_TIMEOUT`
`int`	`MAX_RETRIES`
`long`	`RETRY_INTERVAL_MS`

وظائف الإنشاء العامة
`AdbTcpConnection(DefaultConnection.ConnectionBuilder builder)`

الطرق العامة
`boolean`	`adbTcpConnect(String host, String port)` طريقة مساعدة لربط adb بجهاز Android معيّن يعمل ببروتوكول tcp ip
`boolean`	`adbTcpDisconnect(String host, String port)` طريقة مساعدة لقطع اتصال adb بجهاز Android معيّن يستخدم بروتوكول tcp ip
`String`	`getHostName(String serial)` عرض اسم المضيف المرتبط بالجهاز
`String`	`getPortNum(String serial)` عرض رقم المنفذ المرتبط بالجهاز
	`getSuiteSnapshots()` عرض خريطة اللقطات
`void`	`initializeConnection()` ابدأ عملية ربط الجهاز.
`void`	`reconnect(String serial)` أعِد الاتصال بالجهاز.
`void`	`recoverVirtualDevice(ITestDevice device, String snapshotId, DeviceNotAvailableException dnae)` استرداد الجهاز المحدَّد من خلال إعادة ضبطه
`void`	`setAdbLogFile(File adbLogFile)` قدِّم ملف مستلِم يمكننا من خلاله تخزين جميع سجلات اتصال adb لأغراض تصحيح الأخطاء.
`void`	`snapshotDevice(ITestDevice device, String snapshotId)` التقاط لقطة شاشة للجهاز المحدَّد
`void`	`tearDownConnection()` تنظيف عملية الربط

الطرق المحمية
`void`	`waitForAdbConnect(String serial, long waitTime)` تأكَّد من تفعيل اتصال adb.

الثوابت

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)

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

AdbTcpConnection

public AdbTcpConnection (DefaultConnection.ConnectionBuilder builder)

المعلمات
`builder`	`DefaultConnection.ConnectionBuilder`

الطرق العامة

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`	صحيح إذا تم قطع الاتصال بالجهاز بنجاح، وخطأ في الحالات الأخرى.

getHostName

public String getHostName (String serial)

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

المعلمات
`serial`	`String`

المرتجعات
`String`

getPortNum

public String getPortNum (String serial)

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

المعلمات
`serial`	`String`

المرتجعات
`String`

getSuiteSnapshots

public  getSuiteSnapshots ()

عرض خريطة اللقطات

المرتجعات

initializeConnection

public void initializeConnection ()

ابدأ عملية ربط الجهاز.

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

إعادة الاتصال

public void reconnect (String serial)

أعِد الاتصال بالجهاز.

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

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

recoverVirtualDevice

public void recoverVirtualDevice (ITestDevice device, 
                String snapshotId, 
                DeviceNotAvailableException dnae)

استرداد الجهاز المحدَّد من خلال إعادة ضبطه

المعلمات
`device`	`ITestDevice`: يتم استخدام `ITestDevice` لمعالج إعادة ضبط الجهاز.
`snapshotId`	`String`: يُستخدَم معرّف اللقطة لتحميل اللقطة الصحيحة لاستعادتها.
`dnae`	`DeviceNotAvailableException`: `DeviceNotAvailableException` هو استثناء الجهاز الحالي غير متوفّر

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

setAdbLogFile

public void setAdbLogFile (File adbLogFile)

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

المعلمات
`adbLogFile`	`File`

snapshotDevice

public void snapshotDevice (ITestDevice device, 
                String snapshotId)

التقاط لقطة شاشة للجهاز المحدَّد

المعلمات
`device`	`ITestDevice`: يتم استخدام `ITestDevice` لمعالج لقطات الجهاز.
`snapshotId`	`String`: snapshotId هو اسم اللقطة التي سيتم حفظها.

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

tearDownConnection

public void tearDownConnection ()

تنظيف عملية الربط

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

waitForAdbConnect

protected void waitForAdbConnect (String serial, 
                long waitTime)

تحقَّق مما إذا كان اتصال adb مفعَّلاً.

المعلمات
`serial`	`String`
`waitTime`	`long`

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