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

DeviceImpl

public final class DeviceImpl
extends Object implements IDevice

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

جهاز يمكن أن يكون جهازًا ماديًا أو محاكيًا.

ملخّص

الإنشاءات العامة
`DeviceImpl(ClientTracker clientTracer, 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`	`executeBinderCommand(String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)` ينفّذ أمر Binder على الجهاز، ويرسل النتيجة إلى `receiver` يستخدم هذا الأمر استدعاء exec:cmd أو abb_exec: الأسرع إذا كان كل من نظام تشغيل الجهاز وخادم ADB المضيف متوافقَين مع ميزة تنفيذ Android Binder Bridge.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, 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)` ينفّذ أمر 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`	`forceStop(String applicationName)` فرض إيقاف تطبيق حسب اسم التطبيق
	`getAbis()` تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المتوافقة مع هذا الجهاز.
`ListenableFuture<AvdData>`	`getAvdData()` تعرض هذه السمة معلومات عن الجهاز الافتراضي الذي يتم تشغيل المحاكي عليه.
`String`	`getAvdName()` تعرِض هذه السمة اسم الجهاز الافتراضي الذي يتم تشغيل المحاكي عليه.
`String`	`getAvdPath()` تعرض هذه السمة المسار المطلق للجهاز الافتراضي في نظام الملفات.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` إرجاع مستوى شحن بطارية الجهاز، من 0 إلى 100 بالمائة
	`getBattery()` إرجاع مستوى شحن بطارية الجهاز، من 0 إلى 100 بالمائة
`Integer`	`getBatteryLevel(long freshnessMs)` إرجاع مستوى شحن بطارية الجهاز، من 0 إلى 100 بالمائة
`Integer`	`getBatteryLevel()` إرجاع مستوى شحن بطارية الجهاز، من 0 إلى 100 بالمائة
`ClientImpl`	`getClient(String applicationName)` تعرض هذه الدالة `Client` حسب اسم التطبيق.
`String`	`getClientName(int pid)` تعرِض هذه السمة اسم العميل حسب رقم التعريف الشخصي (pid) أو `null` إذا كان رقم التعريف الشخصي غير معروف.
`ClientTracker`	`getClientTracker()`
`ClientImpl[]`	`getClients()` تعرض هذه السمة مصفوفة العملاء.
`int`	`getDensity()` تعرض هذه السمة فئة الكثافة لشاشة الجهاز من خلال قراءة قيمة السمة `PROP_DEVICE_DENSITY` في النظام.
`FileListingService`	`getFileListingService()` تعرض هذه السمة `FileListingService` لهذا الجهاز.
`String`	`getLanguage()` تعرض هذه السمة لغة المستخدم.
`InstallMetrics`	`getLastInstallMetrics()` تعرض هذه السمة معلومات عن عملية التثبيت الأخيرة على هذا الجهاز.
`String`	`getMountPoint(String name)` تعرِض هذه السمة نقطة تثبيت.
`String`	`getName()` تعرض هذه السمة اسمًا (مفهومًا) لهذا الجهاز.
`ClientImpl[]`	`getNativeClients()`
`ClientImpl`	`getNativeClients(String applicationName)`
`ProfileableClientImpl[]`	`getProfileableClients()` تعرض هذه الطريقة مصفوفة العملاء الذين يمكن إنشاء ملفات شخصية لهم.
	`getProperties()` تعرِض هذه السمة خصائص الجهاز المخزَّنة مؤقتًا.
`String`	`getProperty(String name)` طريقة ملائمة تحاول استرداد سمة من خلال `IShellEnabledDevice.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)` تنفيذ طلب بحث غير متزامن محتمل عن سمة نظام
`boolean`	`hasClients()` تعرض ما إذا كان `IDevice` يتضمّن `Client`.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` تثبِّت هذه السياسة تطبيق Android على الجهاز.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` تثبِّت هذه السياسة تطبيق Android على الجهاز.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` تثبِّت هذه السياسة تطبيق Android على الجهاز.
`void`	`installPackages( apks, boolean reinstall, installOptions)` تثبيت تطبيق Android يتألف من عدة ملفات APK (حزمة رئيسية واحدة و0..n حِزم مقسّمة) مع مهلة تلقائية
`void`	`installPackages( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` تثبيت تطبيق 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( remoteApks, boolean reinstall, installOptions)` تثبيت تطبيق Android يتألف من عدة ملفات APK مخزّنة محليًا على الجهاز مع مهلة تلقائية
`void`	`installRemotePackages( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)` تثبيت تطبيق 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)` تبدأ هذه الطريقة تسجيل الشاشة على الجهاز إذا كان الجهاز يتيح استخدام `IDevice.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 (ClientTracker clientTracer, 
                String serialNumber, 
                IDevice.DeviceState deviceState)

المعلمات
`clientTracer`	`ClientTracker`
`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`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

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

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

الرميات
`AdbCommandRejectedException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

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

الرميات
`AdbCommandRejectedException`
`TimeoutException`

executeBinderCommand

public void executeBinderCommand (String[] parameters, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

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

يستخدم هذا الأمر استدعاء exec:cmd أو abb_exec: الأسرع إذا كان كل من نظام تشغيل الجهاز وخادم ADB المضيف متوافقَين مع ميزة تنفيذ Android Binder Bridge.

المعلمات
`parameters`	‫`String`: أمر binder المطلوب تنفيذه
`receiver`	‫`IShellOutputReceiver`: `IShellOutputReceiver` الذي سيتلقّى نتيجة أمر Binder
`maxTimeToOutputResponse`	`long`
`maxTimeUnits`	`TimeUnit`
`is`	‫`InputStream`: دفق إدخال اختياري لإرساله من خلال stdin

الرميات
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

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

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

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

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

الرميات
`AdbCommandRejectedException`
`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`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

الرميات
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

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

الرميات
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

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

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

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

الرميات
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public  getAbis ()

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

المرتجعات
	قائمة قيم ABI

getAvdData

public ListenableFuture<AvdData> getAvdData ()

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

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

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

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

getAvdName

public String getAvdName ()

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

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

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

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

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

getAvdPath

public String getAvdPath ()

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

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

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

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

المعلمات
`freshnessTime`	‫`long`: مدى الحداثة المطلوب لمستوى البطارية
`timeUnit`	`TimeUnit`: `ERROR(/TimeUnit)` من freshnessTime

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

getBattery

public  getBattery ()

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

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

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

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

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

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

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

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

getClient

public ClientImpl getClient (String applicationName)

تعرض هذه الدالة Client حسب اسم التطبيق.

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

المرتجعات
`ClientImpl`	الكائن `Client` أو `null` إذا لم يتم العثور على أي تطابق

getClientName

public String getClientName (int pid)

تعرِض هذه السمة اسم العميل حسب رقم التعريف أو null إذا كان رقم التعريف غير معروف.

المعلمات
`pid`	‫`int`: تمثّل هذه السمة رقم تعريف العملية (PID) للعميل.

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

getClientTracker

public ClientTracker getClientTracker ()

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

getClient

public ClientImpl[] getClients ()

تعرض هذه السمة مصفوفة العملاء.

المرتجعات
`ClientImpl[]`

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`

getNativeClients

public ClientImpl[] getNativeClients ()

المرتجعات
`ClientImpl[]`

getNativeClients

public ClientImpl getNativeClients (String applicationName)

المعلمات
`applicationName`	`String`

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

getProfileableClients

public ProfileableClientImpl[] getProfileableClients ()

تعرض هذه الطريقة مصفوفة العملاء الذين يمكن إنشاء ملفات شخصية لهم.

المرتجعات
`ProfileableClientImpl[]`

getProperties

public  getProperties ()

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

المرتجعات

getProperty

public String getProperty (String name)

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

ملاحظة: يُفضّل استخدام IShellEnabledDevice.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`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

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

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

الرميات
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

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

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

getState

public IDevice.DeviceState getState ()

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

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

getSyncService

public SyncService getSyncService ()

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

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

الرميات
`AdbCommandRejectedException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

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

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

المرتجعات
`ListenableFuture<String>`	قد تعرض السمة `ListenableFuture.` `ERROR(get/Future#get() get)` القيمة null.

hasClients

public boolean hasClients ()

تعرض ما إذا كان IDevice يتضمّن Client.

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

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, 
                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, 
                String... extraArgs)

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

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

الرميات
`InstallException`

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

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

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

الرميات
`InstallException`

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

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

الرميات
`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 ( remoteApks, 
                boolean reinstall, 
                 installOptions)

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

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

الرميات
`InstallException`

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

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

الرميات
`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`
`ShellCommandUnresponsiveException`
`TimeoutException`

قتل

public void kill (String applicationName)

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

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

pullFile

public void pullFile (String remote, 
                String local)

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

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

الرميات
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

إرسال

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

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

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

الرميات
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

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

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

الرميات
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

rawBinder

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

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

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

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

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

الرميات
`AdbCommandRejectedException`
`TimeoutException`

rawExec

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

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

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

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

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

الرميات
`AdbCommandRejectedException`
`TimeoutException`

إعادة تشغيل

public void reboot (String into)

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

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

الرميات
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

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

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

الرميات
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

يزيل هذا الإجراء ملفًا من الجهاز.

المعلمات
`remoteFilePath`	‫`String`: مسار الملف المطلوب إزالته على الجهاز

الرميات
`InstallException`

removeReverse

public void removeReverse (int remotePort)

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

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

الرميات
`AdbCommandRejectedException`
`TimeoutException`

الجذر

public boolean root ()

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

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

الرميات
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

startScreenRecorder

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

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

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

الرميات
`AdbCommandRejectedException`
`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`
`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`