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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.server.DeviceImpl

جهاز يمكن أن يكون جهازًا فعليًا أو محاكيًا.

ملخّص

طُرق وضع التصميم العامة
`DeviceImpl(String serialNumber, IDevice.DeviceState deviceState)`

الإجراءات العامة
`boolean`	`arePropertiesSet()` تعرِض `true` إذا تم تخزين المواقع مؤقتًا
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` تنشئ هذه السمة إعادة توجيه المنفذ بين منفذ TCP محلي ومقبس نطاق Unix بعيد.
`void`	`createForward(int localPort, int remotePort)` تنشئ هذه السمة عملية إعادة توجيه المنفذ بين منفذ محلي وآخر بعيد.
`void`	`createReverse(int remotePort, int localPort)` تُنشئ هذه السمة عملية عكس للمنفذ بين منفذ بعيد ومنفذ محلي.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى `receiver` وهذا مشابه لاستدعاء `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)`
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` إصدار من الأمر executeShell يمكنه تلقّي بث إدخال لإرساله من خلال stdin.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى `receiver`.
`void`	`forceStop(String applicationName)` فرض إيقاف تطبيق حسب اسم التطبيق
`List<String>`	`getAbis()` تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المتوافقة مع هذا الجهاز.
`ListenableFuture<AvdData>`	`getAvdData()` تعرض هذه السمة معلومات عن الجهاز الافتراضي الذي يتم تشغيل المحاكي عليه.
`String`	`getAvdName()` تعرِض هذه السمة اسم جهاز AVD الذي يتم تشغيل المحاكي عليه.
`String`	`getAvdPath()` تعرض هذه السمة المسار المطلق للجهاز الافتراضي في نظام الملفات.
`Future<Integer>`	`getBattery(long freshnessTime, TimeUnit timeUnit)` لعرض مستوى بطارية الجهاز، من 0 إلى 100 بالمائة
`Future<Integer>`	`getBattery()` تعرض هذه السمة مستوى البطارية في الجهاز، من 0 إلى 100 بالمائة.
`Integer`	`getBatteryLevel(long freshnessMs)` تعرض هذه السمة مستوى البطارية في الجهاز، من 0 إلى 100 بالمائة.
`Integer`	`getBatteryLevel()` لعرض مستوى بطارية الجهاز، من 0 إلى 100 بالمائة
`int`	`getDensity()` تعرض هذه السمة فئة الكثافة لشاشة الجهاز من خلال قراءة قيمة السمة `PROP_DEVICE_DENSITY` في النظام.
`FileListingService`	`getFileListingService()` تعرض هذه السمة `FileListingService` لهذا الجهاز.
`String`	`getLanguage()` تعرض هذه السمة لغة المستخدم.
`InstallMetrics`	`getLastInstallMetrics()` تعرض هذه السمة معلومات عن عملية التثبيت الأخيرة على هذا الجهاز.
`String`	`getMountPoint(String name)` تعرِض هذه السمة نقطة تثبيت.
`String`	`getName()` تعرِض هذه السمة اسمًا (مفهومًا) لهذا الجهاز.
`Map<String, String>`	`getProperties()` تعرِض هذه السمة خصائص الجهاز المخزَّنة مؤقتًا.
`String`	`getProperty(String name)` طريقة ملائمة تحاول استرداد سمة من خلال `getSystemProperty(String)` مع وقت انتظار قصير جدًا، وتتجاهل الاستثناءات.
`String`	`getPropertyCacheOrSync(String name)` مزيج من `getProperty(String)` و`getPropertySync(String)` سيحاول استرداد السمة من ذاكرة التخزين المؤقت.
`int`	`getPropertyCount()` تعرض هذه السمة عدد الوحدات السكنية المتاحة للاستئجار في هذا الجهاز.
`String`	`getPropertySync(String name)` متغير من `getProperty(String)` سيحاول استرداد السمة المحدّدة من الجهاز مباشرةً، بدون استخدام ذاكرة التخزين المؤقت.
`String`	`getRegion()` تعرض هذه السمة منطقة المستخدم.
`static String`	`getScreenRecorderCommand(String remoteFilePath, ScreenRecorderOptions options)`
`RawImage`	`getScreenshot()` يلتقط لقطة شاشة للجهاز ويعرضها كـ `RawImage`.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` تعرض هذه السمة الرقم التسلسلي للجهاز.
`IDevice.DeviceState`	`getState()` تعرِض هذه الإشارة حالة الجهاز.
`SyncService`	`getSyncService()` تعرض هذه السمة عنصر `SyncService` لإرسال الملفات إلى الجهاز واستلامها منه.
`ListenableFuture<String>`	`getSystemProperty(String name)` تنفيذ طلب بحث غير متزامن محتمل عن سمة نظام
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` تثبِّت هذه السياسة تطبيق Android على الجهاز.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` تثبِّت هذه السياسة تطبيق Android على الجهاز.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` تثبِّت هذه السياسة تطبيق Android على الجهاز.
`void`	`installPackages(List<File> apks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)` تثبيت تطبيق Android يتألف من عدة ملفات APK (حزمة رئيسية واحدة و0..n حزمة مقسّمة)
`void`	`installPackages(List<File> apks, boolean reinstall, List<String> installOptions)` تثبيت تطبيق Android يتألف من عدة ملفات APK (ملف رئيسي واحد و0..n حِزم مقسّمة) مع مهلة تلقائية
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` تثبِّت هذه الطريقة حزمة التطبيق التي تم إرسالها إلى موقع جغرافي مؤقت على الجهاز.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` تثبِّت هذه الطريقة حزمة التطبيق التي تم إرسالها إلى موقع جغرافي مؤقت على الجهاز.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` تثبِّت هذه الطريقة حزمة التطبيق التي تم إرسالها إلى موقع جغرافي مؤقت على الجهاز.
`void`	`installRemotePackages(List<String> remoteApks, boolean reinstall, List<String> installOptions, long timeout, TimeUnit timeoutUnit)` تثبيت تطبيق Android يتألف من عدة ملفات APK مخزّنة على الجهاز
`void`	`installRemotePackages(List<String> remoteApks, boolean reinstall, List<String> installOptions)` تثبيت تطبيق Android يتألف من عدة ملفات APK مخزّنة محليًا على الجهاز مع مهلة تلقائية
`boolean`	`isBootLoader()` تعرِض هذه الإشارة ما إذا كان الجهاز في وضع برنامج الإقلاع.
`boolean`	`isEmulator()` تعرِض هذه السمة القيمة `true` إذا كان الجهاز محاكيًا.
`boolean`	`isOffline()` تعرِض هذه الإشارة ما إذا كان الجهاز غير متصل بالإنترنت.
`boolean`	`isOnline()` تعرِض هذه السمة ما إذا كان الجهاز جاهزًا.
`boolean`	`isRoot()` يطلب هذا الإجراء حالة الوصول إلى الجذر الحالية للجهاز.
`void`	`kill(String applicationName)` يوقف تطبيقًا حسب اسم التطبيق.
`void`	`pullFile(String remote, String local)` يجلب ملفًا واحدًا.
`void`	`push(String[] local, String remote)` يدفع عدة ملفات أو أدلة.
`void`	`pushFile(String local, String remote)` يدفع ملفًا واحدًا.
`SocketChannel`	`rawBinder(String service, String[] parameters)` استدعاء خدمة Android Binder Bridge على جهاز بعيد
`SocketChannel`	`rawExec(String executable, String[] parameters)` استدعاء خدمة host:exec على جهاز بعيد
`void`	`reboot(String into)` أعد تشغيل الجهاز.
`void`	`removeForward(int localPort)` يزيل عملية إعادة توجيه المنفذ بين منفذ محلي ومنفذ بعيد.
`void`	`removeRemotePackage(String remoteFilePath)` يزيل ملفًا من الجهاز.
`void`	`removeReverse(int remotePort)` يزيل هذا الإجراء عكس المنفذ بين منفذ بعيد ومنفذ محلي.
`boolean`	`root()` اطلب من برنامج adb الخفي أن يصبح الجذر على الجهاز.
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` يبدأ تسجيل الشاشة على الجهاز إذا كان الجهاز يتيح استخدام `Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature feature)` تعرِض هذه الطريقة ما إذا كان هذا الجهاز يتيح استخدام ميزة الجهاز المحدّدة.
`boolean`	`supportsFeature(IDevice.Feature feature)` تعرِض هذه السمة ما إذا كان هذا الجهاز يتيح استخدام ميزة البرنامج المحدّدة.
`String`	`syncPackageToDevice(String localFilePath)` إرسال ملف إلى الجهاز
`String`	`toString()`
`String`	`uninstallApp(String applicationID, String... extraArgs)` لإلغاء تثبيت تطبيق من الجهاز
`String`	`uninstallPackage(String packageName)` تؤدي إلى إلغاء تثبيت حزمة من الجهاز.

طُرق وضع التصميم العامة

DeviceImpl

public DeviceImpl (String serialNumber, 
                IDevice.DeviceState deviceState)

المعلَمات
`serialNumber`	`String`
`deviceState`	`IDevice.DeviceState`

الإجراءات العامة

arePropertiesSet

public boolean arePropertiesSet ()

تعرِض true إذا تم تخزين المواقع مؤقتًا

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

createForward

public void createForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

تنشئ هذه السمة إعادة توجيه المنفذ بين منفذ TCP محلي ومقبس نطاق Unix بعيد.

المعلَمات
`localPort`	‫`int`: المنفذ المحلي الذي سيتم إعادة توجيهه
`remoteSocketName`	‫`String`: اسم مقبس نطاق Unix الذي تم إنشاؤه على الجهاز
`namespace`	‫`IDevice.DeviceUnixSocketNamespace`: مساحة الاسم التي تم فيها إنشاء مقبس نطاق Unix

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

تنشئ هذه السمة عملية إعادة توجيه المنفذ بين منفذ محلي وآخر بعيد.

المعلَمات
`localPort`	‫`int`: المنفذ المحلي الذي سيتم إعادة توجيهه
`remotePort`	‫`int`: المنفذ البعيد

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

تُنشئ هذه السمة عملية عكس للمنفذ بين منفذ بعيد ومنفذ محلي.

المعلَمات
`remotePort`	‫`int`: المنفذ البعيد الذي سيتم عكسه.
`localPort`	‫`int`: المنفذ المحلي

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى receiver

وهذا مشابه لاستدعاء executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

المعلَمات
`command`	‫`String`: أمر shell المطلوب تنفيذه
`receiver`	‫`IShellOutputReceiver`: `IShellOutputReceiver` الذي سيتلقّى نتيجة أمر shell

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                int maxTimeToOutputResponse)

المعلَمات
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى receiver.

يُستخدَم maxTimeToOutputResponse كحد أقصى لوقت الانتظار عند توقُّع تلقّي ناتج الأمر من الجهاز.
في أي وقت، إذا لم يعرض أمر shell أي نتائج لمدة تزيد عن maxTimeToOutputResponse، سيؤدي ذلك إلى طرح ShellCommandUnresponsiveException.

بالنسبة إلى أوامر مثل إخراج السجلّ، يجب استخدام القيمة maxTimeToOutputResponse التي تساوي 0، ما يعني أنّ الطريقة لن تعرض أي خطأ وسيتم حظرها إلى أن تعرض IShellOutputReceiver.isCancelled() الخاصة بالمستلِم القيمة true.

المعلَمات
`command`	‫`String`: أمر shell المطلوب تنفيذه
`receiver`	‫`IShellOutputReceiver`: `IShellOutputReceiver` الذي سيتلقّى نتيجة أمر shell
`maxTimeout`	‫`long`: الحد الأقصى لمهلة انتهاء صلاحية الأمر. تعني القيمة 0 أنّه لن يتم تطبيق أي حد أقصى للمهلة.
`maxTimeToOutputResponse`	‫`long`: الحد الأقصى للمدة الزمنية التي يُسمح خلالها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي `receiver` التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ.
`maxTimeUnits`	‫`TimeUnit`: وحدات القيم غير الصفرية `maxTimeout` و`maxTimeToOutputResponse`

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

إصدار من الأمر executeShell يمكنه تلقّي بث إدخال لإرساله من خلال stdin.

المعلَمات
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	`InputStream`

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى receiver.

المعلَمات
`command`	‫`String`: أمر shell المطلوب تنفيذه
`receiver`	‫`IShellOutputReceiver`: `IShellOutputReceiver` الذي سيتلقّى نتيجة أمر shell
`maxTimeToOutputResponse`	‫`long`: الحد الأقصى للمدة الزمنية التي يُسمح خلالها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي `receiver` التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ.
`maxTimeUnits`	`TimeUnit`: وحدات قيم `maxTimeToOutputResponse` غير الصفرية.

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

forceStop

public void forceStop (String applicationName)

فرض إيقاف تطبيق حسب اسم التطبيق يؤدي هذا الإجراء إلى إزالة جميع المنبّهات المعلقة وعمليات الحساب التي تم وضعها في قائمة الانتظار.

المعلَمات
`applicationName`	‫`String`: اسم التطبيق

getAbis

public List<String> getAbis ()

تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المتوافقة مع هذا الجهاز. يتم ترتيب واجهات ABI حسب الترتيب المفضّل، وتكون واجهة ABI الأولى هي الأكثر تفضيلاً.

المرتجعات
`List<String>`	قائمة قيم ABI

getAvdData

public ListenableFuture<AvdData> getAvdData ()

تعرض هذه السمة معلومات عن الجهاز الافتراضي الذي يتم تشغيل المحاكي عليه.

‫AvdData.getName هو اسم المحاكي أو null إذا لم يكن هناك أي محاكي.

‫AvdData.getPath هو مسار المحاكي الافتراضي لنظام Android أو قيمة فارغة إذا كان هذا جهازًا فعليًا، أو إذا تعذّر تنفيذ الأمر الفرعي لوحدة تحكّم المحاكي، أو إذا كان إصدار المحاكي أقدم من 30.0.18

المرتجعات
`ListenableFuture<AvdData>`	`AvdData` للجهاز

getAvdName

public String getAvdName ()

تعرِض هذه السمة اسم جهاز AVD الذي يتم تشغيل المحاكي عليه.

لا يكون هذا الإجراء صالحًا إلا إذا كانت الدالة isEmulator() تعرض القيمة "صحيح".

إذا كان المحاكي لا يشغّل أي جهاز افتراضي Android (على سبيل المثال، إذا كان يتم تشغيله من إصدار شجرة مصدر Android)، سيعرض هذا الأسلوب "<build>".

ملاحظة: يُفضّل استخدام getAvdData() إذا أردت التحكّم في المهلة.

المرتجعات
`String`	اسم المحاكي أو `null` إذا لم يكن هناك أي محاكي

getAvdPath

public String getAvdPath ()

تعرض هذه السمة المسار المطلق للجهاز الافتراضي في نظام الملفات. يعتمد المسار على نظام التشغيل، وسيتضمّن فواصل / بين الأسماء على Linux وفواصل \ على Windows.

ملاحظة: يُفضّل استخدام getAvdData() إذا أردت التحكّم في المهلة.

المرتجعات
`String`	مسار AVD أو قيمة فارغة إذا كان هذا جهازًا فعليًا، أو تعذّر تنفيذ الأمر الفرعي لوحدة تحكّم المحاكي، أو كان إصدار المحاكي أقدم من 30.0.18

getBattery

public Future<Integer> getBattery (long freshnessTime, 
                TimeUnit timeUnit)

لعرض مستوى بطارية الجهاز، من 0 إلى 100 بالمائة

قد يتم تخزين مستوى البطارية مؤقتًا. لا يتم طلب مستوى البطارية من الجهاز إلا إذا انتهت صلاحية freshnessTime منذ آخر طلب ناجح.

المعلَمات
`freshnessTime`	‫`long`: مدى الحداثة المطلوب لمستوى البطارية
`timeUnit`	`TimeUnit`: `TimeUnit` الخاص بـ freshnessTime

المرتجعات
`Future<Integer>`	`Future` يمكن استخدامه للاستعلام عن مستوى البطارية. ستعرض الدالة Future القيمة `ExecutionException` إذا تعذّر استرداد مستوى البطارية.

getBattery

public Future<Integer> getBattery ()

لعرض مستوى بطارية الجهاز، من 0 إلى 100 بالمائة

قد يتم تخزين مستوى البطارية مؤقتًا. لا يتم طلب مستوى البطارية من الجهاز إلا بعد مرور 5 دقائق على آخر طلب ناجح.

المرتجعات
`Future<Integer>`	`Future` يمكن استخدامه للاستعلام عن مستوى البطارية. ستعرض الدالة Future القيمة `ExecutionException` إذا تعذّر استرداد مستوى البطارية.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

تعرض هذه السمة مستوى البطارية في الجهاز، من 0 إلى 100 بالمائة.

قد يتم تخزين مستوى البطارية مؤقتًا. لا يتم طلب مستوى البطارية من الجهاز إلا بعد مرور freshnessMs ملي ثانية على آخر طلب ناجح.

المرتجعات
`Integer`	مستوى البطارية أو `null` إذا تعذّر استرداده

getBatteryLevel

public Integer getBatteryLevel ()

تعرض هذه السمة مستوى البطارية في الجهاز، من 0 إلى 100 بالمائة.

قد يتم تخزين مستوى البطارية مؤقتًا. لا يتم طلب مستوى البطارية من الجهاز إلا بعد مرور 5 دقائق على آخر طلب ناجح.

المرتجعات
`Integer`	مستوى البطارية أو `null` إذا تعذّر استرداده

getDensity

public int getDensity ()

تعرض هذه السمة فئة الكثافة لشاشة الجهاز من خلال قراءة قيمة السمة PROP_DEVICE_DENSITY في النظام.

المرتجعات
`int`	الكثافة، أو -1 إذا تعذّر تحديدها

getFileListingService

public FileListingService getFileListingService ()

تعرض هذه السمة FileListingService لهذا الجهاز.

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

getLanguage

public String getLanguage ()

تعرض هذه السمة لغة المستخدم.

المرتجعات
`String`	لغة المستخدم، أو قيمة فارغة إذا كانت غير معروفة

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

تعرض هذه السمة معلومات عن عملية التثبيت الأخيرة على هذا الجهاز.

المرتجعات
`InstallMetrics`	مقاييس `InstallMetrics` تصف عملية التثبيت

getMountPoint

public String getMountPoint (String name)

تعرِض هذه السمة نقطة تثبيت.

المعلَمات
`name`	`String`: اسم نقطة التثبيت المطلوب إرجاعها

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

getName

public String getName ()

تعرِض هذه السمة اسمًا (مفهومًا) لهذا الجهاز. عادةً ما يكون هذا هو اسم المحاكي الافتراضي لنظام Android (AVD) بالنسبة إلى المحاكيات الافتراضية، ومزيجًا من اسم الشركة المصنّعة واسم الطراز والرقم التسلسلي بالنسبة إلى الأجهزة.

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

getProperties

public Map<String, String> getProperties ()

تعرِض هذه السمة خصائص الجهاز المخزَّنة مؤقتًا. يحتوي على الناتج الكامل للأمر getprop

المرتجعات
`Map<String, String>`

getProperty

public String getProperty (String name)

طريقة ملائمة تحاول استرداد سمة من خلال getSystemProperty(String) مع وقت انتظار قصير جدًا، وتتجاهل الاستثناءات.

ملاحظة: يُفضّل استخدام getSystemProperty(String) إذا أردت التحكّم في المهلة.

المعلَمات
`name`	‫`String`: اسم القيمة المطلوب عرضها

المرتجعات
`String`	القيمة أو `null` إذا لم تكن قيمة السمة متاحة على الفور

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

مزيج من getProperty(String) وgetPropertySync(String) سيحاول استرداد السمة من ذاكرة التخزين المؤقت. إذا لم يتم العثور على الجهاز، سيحاول بشكل متزامن الاستعلام عن الجهاز مباشرةً وإعادة ملء ذاكرة التخزين المؤقت في حال نجاح ذلك.

المعلَمات
`name`	‫`String`: اسم القيمة المطلوب عرضها

المرتجعات
`String`	القيمة أو `null` إذا لم تكن السمة متوفرة

getPropertyCount

public int getPropertyCount ()

تعرض هذه السمة عدد العقارات لهذا الجهاز.

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

getPropertySync

public String getPropertySync (String name)

متغير من getProperty(String) سيحاول استرداد السمة المحدّدة من الجهاز مباشرةً، بدون استخدام ذاكرة التخزين المؤقت. يجب استخدام هذه الطريقة (فقط) مع أي سمات متغيرة.

المعلَمات
`name`	‫`String`: اسم القيمة المطلوب عرضها

المرتجعات
`String`	القيمة أو `null` إذا لم تكن السمة متوفرة

getRegion

public String getRegion ()

تعرض هذه السمة منطقة المستخدم.

المرتجعات
`String`	منطقة المستخدم، أو قيمة فارغة إذا كانت غير معروفة

getScreenRecorderCommand

public static String getScreenRecorderCommand (String remoteFilePath, 
                ScreenRecorderOptions options)

المعلَمات
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`

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

getScreenshot

public RawImage getScreenshot ()

يلتقط لقطة شاشة للجهاز ويعرضها كـ RawImage.

المرتجعات
`RawImage`	لقطة الشاشة كـ `RawImage` أو `null` إذا حدث خطأ.

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

المعلَمات
`timeout`	`long`
`unit`	`TimeUnit`

القيم المُعادة
`RawImage`

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

تعرض هذه السمة الرقم التسلسلي للجهاز.

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

getState

public IDevice.DeviceState getState ()

تعرِض هذه الإشارة حالة الجهاز.

المرتجعات
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

تعرض هذه السمة عنصر SyncService لإرسال الملفات إلى الجهاز واستلامها منه.

المرتجعات
`SyncService`	‫`null` إذا تعذّر إنشاء SyncService يمكن أن يحدث ذلك إذا رفضت أداة adb فتح الاتصال لأنّ `IDevice` غير صالح (أو تم قطع الاتصال).

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

تنفيذ طلب بحث غير متزامن محتمل عن سمة نظام

المعلَمات
`name`	‫`String`: اسم القيمة المطلوب عرضها

المرتجعات
`ListenableFuture<String>`	قد تعرض السمة `ListenableFuture.` `get` القيمة null.

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

تثبِّت هذه السياسة تطبيق Android على الجهاز. هذه طريقة مساعدة تجمع بين خطوات syncPackageToDevice وinstallRemotePackage وremovePackage.

المعلَمات
`packageFilePath`	‫`String`: المسار المطلق لنظام الملفات إلى الملف على المضيف المحلي المراد تثبيته
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`receiver`	‫`InstallReceiver`: `InstallReceiver` الذي سيتم استخدامه لتتبُّع عملية التثبيت والحصول على الحالة النهائية.
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.

عمليات الطرح
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

تثبِّت هذه السياسة تطبيق Android على الجهاز. هذه طريقة مساعدة تجمع بين خطوات syncPackageToDevice وinstallRemotePackage وremovePackage.

المعلَمات
`packageFilePath`	‫`String`: المسار المطلق لنظام الملفات إلى الملف على المضيف المحلي المراد تثبيته
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`receiver`	‫`InstallReceiver`: `InstallReceiver` الذي سيتم استخدامه لتتبُّع عملية التثبيت والحصول على الحالة النهائية.
`maxTimeout`	‫`long`: الحد الأقصى لمهلة انتهاء صلاحية الأمر. تعني القيمة 0 أنّه لن يتم تطبيق أي حد أقصى للمهلة.
`maxTimeToOutputResponse`	‫`long`: الحد الأقصى للمدة الزمنية التي يُسمح خلالها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي `receiver` التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ.
`maxTimeUnits`	‫`TimeUnit`: وحدات القيم غير الصفرية `maxTimeout` و`maxTimeToOutputResponse`
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.

عمليات الطرح
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                String... extraArgs)

تثبِّت هذه السياسة تطبيق Android على الجهاز. هذه طريقة مساعدة تجمع بين خطوات syncPackageToDevice وinstallRemotePackage وremovePackage.

المعلَمات
`packageFilePath`	‫`String`: المسار المطلق لنظام الملفات إلى الملف على المضيف المحلي المراد تثبيته
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.

عمليات الطرح
`InstallException`

installPackages

public void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

تثبيت تطبيق Android يتألف من عدة ملفات APK (حزمة رئيسية واحدة و0..n حزمة مقسّمة)

المعلَمات
`apks`	‫`List`: قائمة بحِزم APK المطلوب تثبيتها (حِزمة APK رئيسية واحدة + من 0 إلى n من حِزم APK المجزّأة)
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`installOptions`	`List`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.
`timeout`	`long`: انتهاء مهلة التثبيت
`timeoutUnit`	`TimeUnit`: `TimeUnit` المقابل لمَعلمة المهلة

عمليات الطرح
`InstallException`

installPackages

public void installPackages (List<File> apks, 
                boolean reinstall, 
                List<String> installOptions)

تثبيت تطبيق Android يتألف من عدة ملفات APK (ملف رئيسي واحد و0..n حِزم مقسّمة) مع مهلة تلقائية

المعلَمات
`apks`	‫`List`: قائمة بحِزم APK المطلوب تثبيتها (حِزمة APK رئيسية واحدة + من 0 إلى n من حِزم APK المجزّأة)
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`installOptions`	`List`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.

عمليات الطرح
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

تثبِّت هذه الطريقة حزمة التطبيق التي تم إرسالها إلى موقع جغرافي مؤقت على الجهاز.

المعلَمات
`remoteFilePath`	‫`String`: المسار المطلق للملف على الجهاز
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`receiver`	‫`InstallReceiver`: `InstallReceiver` الذي سيتم استخدامه لتتبُّع عملية التثبيت والحصول على الحالة النهائية.
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.

عمليات الطرح
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

تثبِّت هذه الطريقة حزمة التطبيق التي تم إرسالها إلى موقع جغرافي مؤقت على الجهاز.

المعلَمات
`remoteFilePath`	‫`String`: المسار المطلق للملف على الجهاز
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.

عمليات الطرح
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

تثبِّت هذه الطريقة حزمة التطبيق التي تم إرسالها إلى موقع جغرافي مؤقت على الجهاز.

المعلَمات
`remoteFilePath`	‫`String`: المسار المطلق للملف على الجهاز
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`receiver`	‫`InstallReceiver`: `InstallReceiver` الذي سيتم استخدامه لتتبُّع عملية التثبيت والحصول على الحالة النهائية.
`maxTimeout`	‫`long`: الحد الأقصى لمهلة انتهاء صلاحية الأمر. تعني القيمة 0 أنّه لن يتم تطبيق أي حد أقصى للمهلة.
`maxTimeToOutputResponse`	‫`long`: الحد الأقصى للمدة الزمنية التي يُسمح خلالها للأمر بعدم عرض أي استجابة. تعني القيمة 0 أنّ الطريقة ستنتظر إلى الأبد (إلى أن يلغي `receiver` التنفيذ) للحصول على ناتج الأمر ولن تعرض أي خطأ.
`maxTimeUnits`	‫`TimeUnit`: وحدات القيم غير الصفرية `maxTimeout` و`maxTimeToOutputResponse`
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.

عمليات الطرح
`InstallException`

installRemotePackages

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

تثبيت تطبيق Android يتألف من عدة ملفات APK مخزّنة على الجهاز

المعلَمات
`remoteApks`	‫`List`: قائمة بمسارات ملفات APK المخزّنة على الجهاز لتثبيتها
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`installOptions`	`List`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.
`timeout`	`long`: انتهاء مهلة التثبيت
`timeoutUnit`	`TimeUnit`: `TimeUnit` المقابل لمَعلمة المهلة

عمليات الطرح
`InstallException`

installRemotePackages

public void installRemotePackages (List<String> remoteApks, 
                boolean reinstall, 
                List<String> installOptions)

تثبيت تطبيق Android يتألف من عدة ملفات APK مخزّنة محليًا على الجهاز مع مهلة تلقائية

المعلَمات
`remoteApks`	‫`List`: قائمة بمسارات ملفات APK على الجهاز لتثبيتها
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`installOptions`	`List`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.

عمليات الطرح
`InstallException`

isBootLoader

public boolean isBootLoader ()

تعرِض هذه الإشارة ما إذا كان الجهاز في وضع برنامج الإقلاع.

المرتجعات
`boolean`	تعرض الدالة `true` إذا `getState()` القيمة `DeviceState.BOOTLOADER`.

isEmulator

public boolean isEmulator ()

تعرِض هذه السمة القيمة true إذا كان الجهاز محاكيًا.

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

isOffline

public boolean isOffline ()

تعرِض هذه الإشارة ما إذا كان الجهاز غير متصل بالإنترنت.

المرتجعات
`boolean`	تعرض الدالة `true` إذا `getState()` القيمة `DeviceState.OFFLINE`.

isOnline

public boolean isOnline ()

تعرِض هذه السمة ما إذا كان الجهاز جاهزًا.

المرتجعات
`boolean`	تعرض الدالة `true` إذا `getState()` القيمة `DeviceState.ONLINE`.

isRoot

public boolean isRoot ()

يطلب هذا الإجراء حالة الوصول إلى الجذر الحالية للجهاز. اطّلِع على "adb root" لمزيد من المعلومات.

المرتجعات
`boolean`	صحيح إذا كان برنامج adb الخفي يعمل كجذر، وخطأ في الحالات الأخرى.

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

قتل

public void kill (String applicationName)

يوقف تطبيقًا حسب اسم التطبيق. سيؤدي ذلك إلى إيقاف الأنشطة فقط، مع ترك حالتها في نظام Android وحده.

المعلَمات
`applicationName`	‫`String`: اسم التطبيق

pullFile

public void pullFile (String remote, 
                String local)

يجلب ملفًا واحدًا.

المعلَمات
`remote`	`String`: المسار الكامل إلى الملف البعيد
`local`	‫`String`: الوجهة المحلية

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`SyncException`
`TimeoutException`

إرسال

public void push (String[] local, 
                String remote)

يدفع عدة ملفات أو أدلة.

المعلَمات
`local`	`String`: الملفات المحلية التي سيتم إرسالها
`remote`	‫`String`: المسار البعيد الذي يمثّل دليلاً

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

يدفع ملفًا واحدًا.

المعلَمات
`local`	`String`: مسار الملف المحلي
`remote`	`String`: مسار الملف البعيد

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`SyncException`
`TimeoutException`

rawBinder

public SocketChannel rawBinder (String service, 
                String[] parameters)

استدعاء خدمة Android Binder Bridge على جهاز بعيد تعرض هذه الطريقة قناة socket متصلة بأمر binder الخاص بالجهاز.

يتم التنازل عن ملكية SocketChannel إلى المتصل، ويجب إغلاقها بشكل صريح بعد الاستخدام.

المعلَمات
`service`	‫`String`: اسم خدمة Android التي سيتم الاتصال بها
`parameters`	`String`: مَعلمات أمر Binder

المرتجعات
`SocketChannel`	تم ربط SocketChannel بعملية التنفيذ على الجهاز. بعد الاستخدام.

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

rawExec

public SocketChannel rawExec (String executable, 
                String[] parameters)

استدعاء خدمة host:exec على جهاز بعيد تعرض هذه السمة قناة مقبس مرتبطة بالعملية الجاري تنفيذها. يُرجى العِلم أنّ خدمة exec لا تفرّق بين stdout وstderr، لذا يمكن أن تأتي أي بيانات تتم قراءتها من المقبس من أي من المخرجات ويتم دمجها.

يتم التنازل عن ملكية SocketChannel إلى المتصل، ويجب إغلاقها بشكل صريح بعد الاستخدام.

المعلَمات
`executable`	`String`
`parameters`	`String`

المرتجعات
`SocketChannel`	تم ربط SocketChannel بعملية التنفيذ على الجهاز. بعد الاستخدام.

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

إعادة التشغيل

public void reboot (String into)

أعد تشغيل الجهاز.

المعلَمات
`into`	‫`String`: اسم برنامج الإقلاع الذي ستتم إعادة التشغيل إليه، أو قيمة فارغة لإعادة تشغيل الجهاز فقط.

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

يزيل عملية إعادة توجيه المنفذ بين منفذ محلي ومنفذ بعيد.

المعلَمات
`localPort`	‫`int`: المنفذ المحلي الذي سيتم إعادة توجيهه

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

يزيل ملفًا من الجهاز.

المعلَمات
`remoteFilePath`	`String`: مسار الملف المراد إزالته على الجهاز

عمليات الطرح
`InstallException`

removeReverse

public void removeReverse (int remotePort)

يزيل هذا الإجراء عكس المنفذ بين منفذ بعيد ومنفذ محلي.

المعلَمات
`remotePort`	‫`int`: المنفذ البعيد

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`TimeoutException`

جذر

public boolean root ()

اطلب من برنامج adb الخفي أن يصبح الجذر على الجهاز. قد يتعذّر تنفيذ هذا الإجراء بدون إشعار، ولا يمكن تنفيذه بنجاح إلا في إصدارات المطوّرين. اطّلِع على "adb root" لمزيد من المعلومات.

المرتجعات
`boolean`	صحيح إذا كان برنامج adb الخفي يعمل كجذر، وخطأ في الحالات الأخرى.

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

startScreenRecorder

public void startScreenRecorder (String remoteFilePath, 
                ScreenRecorderOptions options, 
                IShellOutputReceiver receiver)

يبدأ تسجيل الشاشة على الجهاز إذا كان الجهاز يتيح استخدام Feature.SCREEN_RECORD.

المعلَمات
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature feature)

تعرِض هذه الطريقة ما إذا كان هذا الجهاز يتيح استخدام ميزة الجهاز المحدّدة.

المعلَمات
`feature`	`IDevice.HardwareFeature`

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

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

تعرِض هذه السمة ما إذا كان هذا الجهاز يتيح استخدام ميزة البرنامج المحدّدة.

المعلَمات
`feature`	`IDevice.Feature`

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

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

إرسال ملف إلى الجهاز

المعلَمات
`localFilePath`	‫`String`: المسار المطلق للملف على المضيف المحلي

المرتجعات
`String`	مسار الوجهة `String` على الجهاز للملف

عمليات الطرح
`AdbCommandRejectedException`
`IOException`
`SyncException`
`TimeoutException`

toString

public String toString ()

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

uninstallApp

public String uninstallApp (String applicationID, 
                String... extraArgs)

لإلغاء تثبيت تطبيق من الجهاز

المعلَمات
`applicationID`	‫`String`: معرّف تطبيق Android المطلوب إلغاء تثبيته
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.

المرتجعات
`String`	‫`String` مع رمز خطأ، أو `null` في حال النجاح

عمليات الطرح
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

تؤدي إلى إلغاء تثبيت حزمة من الجهاز.

المعلَمات
`packageName`	‫`String`: معرّف تطبيق Android المطلوب إلغاء تثبيته

المرتجعات
`String`	‫`String` مع رمز خطأ، أو `null` في حال النجاح

عمليات الطرح
`InstallException`