اعتبارًا من عام 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.

IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

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

‫AdbShimDevice وDeviceImpl وDeviceManager.FastbootDevice وNullDevice وRemoteAvdIDevice وStubDevice وStubLocalAndroidVirtualDevice وVmRemoteDevice

AdbShimDevice	تنفيذ العنصر النائب AdbShimDevice لـ `IDevice`
DeviceImpl	جهاز
DeviceManager.FastbootDevice	تمثيل لجهاز في وضع Fastboot
NullDevice	عنصر نائب `IDevice` تستخدمه `DeviceManager` لتحديد وقت `true` `IDeviceSelection.nullDeviceRequested()`
RemoteAvdIDevice	عنصر نائب `IDevice` تستخدمه `DeviceManager` لتحديد وقت `true` `DeviceSelectionOptions.gceDeviceRequested()`
StubDevice	تنفيذ عنصر نائب لـ `IDevice`
StubLocalAndroidVirtualDevice	عنصر نائب `IDevice` تستخدمه `DeviceManager` لتحديد وقت `true` `DeviceSelectionOptions.localVirtualDeviceRequested()`
VmRemoteDevice	جهاز افتراضي بعيد ستتم إدارته من داخل الجهاز الافتراضي

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

ملخّص

الثوابت
`int`	`CHANGE_BUILD_INFO` قناع بت لتغيير الجهاز: تغيير معلومات الإصدار
`int`	`CHANGE_STATE` قناع بت تغيير الجهاز: تغيير `DeviceState`
`String`	`FIRST_EMULATOR_SN` الرقم التسلسلي لأول محاكي متصل
`String`	`MNT_DATA`
`String`	`MNT_EXTERNAL_STORAGE`
`String`	`MNT_ROOT`
`String`	`PROP_BUILD_API_LEVEL`
`String`	`PROP_BUILD_CHARACTERISTICS`
`String`	`PROP_BUILD_CODENAME`
`String`	`PROP_BUILD_TAGS`
`String`	`PROP_BUILD_TYPE`
`String`	`PROP_BUILD_VERSION`
`String`	`PROP_BUILD_VERSION_NUMBER` تم إيقاف هذا الثابت نهائيًا. استخدِم `PROP_BUILD_API_LEVEL`.
`String`	`PROP_DEBUGGABLE`
`String`	`PROP_DEVICE_CPU_ABI`
`String`	`PROP_DEVICE_CPU_ABI2`
`String`	`PROP_DEVICE_CPU_ABI_LIST`
`String`	`PROP_DEVICE_DENSITY`
`String`	`PROP_DEVICE_EMULATOR_DENSITY`
`String`	`PROP_DEVICE_LANGUAGE`
`String`	`PROP_DEVICE_MANUFACTURER`
`String`	`PROP_DEVICE_MODEL`
`String`	`PROP_DEVICE_REGION`
`String`	`RE_EMULATOR_SN` التعبير العادي للرقم التسلسلي للمحاكي
`String`	`UNKNOWN_PACKAGE`

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

الثوابت

CHANGE_BUILD_INFO

public static final int CHANGE_BUILD_INFO

قناع بت لتغيير الجهاز: تغيير معلومات الإصدار

القيمة الثابتة: 4 (0x00000004)

CHANGE_STATE

public static final int CHANGE_STATE

قناع بت تغيير الجهاز: تغيير DeviceState

القيمة الثابتة: 1 (0x00000001)

FIRST_EMULATOR_SN

public static final String FIRST_EMULATOR_SN

الرقم التسلسلي لأول محاكي متصل

القيمة الثابتة: "emulator-5554"

MNT_DATA

public static final String MNT_DATA

القيمة الثابتة: "ANDROID_DATA"

MNT_EXTERNAL_STORAGE

public static final String MNT_EXTERNAL_STORAGE

القيمة الثابتة: "EXTERNAL_STORAGE"

MNT_ROOT

public static final String MNT_ROOT

القيمة الثابتة: "ANDROID_ROOT"

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

Constant Value: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

Constant Value: "ro.build.characteristics"

PROP_BUILD_CODENAME

public static final String PROP_BUILD_CODENAME

القيمة الثابتة: "ro.build.version.codename"

PROP_BUILD_TAGS

public static final String PROP_BUILD_TAGS

القيمة الثابتة: "ro.build.tags"

PROP_BUILD_TYPE

public static final String PROP_BUILD_TYPE

Constant Value: "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

Constant Value: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

تم إيقاف هذا الثابت نهائيًا.
استخدِم PROP_BUILD_API_LEVEL.

Constant Value: "ro.build.version.sdk"

PROP_DEBUGGABLE

public static final String PROP_DEBUGGABLE

القيمة الثابتة: "ro.debuggable"

PROP_DEVICE_CPU_ABI

public static final String PROP_DEVICE_CPU_ABI

Constant Value: "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

Constant Value: "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

القيمة الثابتة: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

Constant Value: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

Constant Value: "qemu.sf.lcd_density"

PROP_DEVICE_LANGUAGE

public static final String PROP_DEVICE_LANGUAGE

Constant Value: "persist.sys.language"

PROP_DEVICE_MANUFACTURER

public static final String PROP_DEVICE_MANUFACTURER

Constant Value: "ro.product.manufacturer"

PROP_DEVICE_MODEL

public static final String PROP_DEVICE_MODEL

Constant Value: "ro.product.model"

PROP_DEVICE_REGION

public static final String PROP_DEVICE_REGION

Constant Value: "persist.sys.country"

RE_EMULATOR_SN

public static final String RE_EMULATOR_SN

تعبير عادي للرقم التسلسلي للمحاكي

القيمة الثابتة: "emulator-(\d+)"

UNKNOWN_PACKAGE

public static final String UNKNOWN_PACKAGE

Constant Value: ""

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

arePropertiesSet

public abstract boolean arePropertiesSet ()

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

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

createForward

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

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

createForward

public abstract void createForward (int localPort, 
                int remotePort)

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

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`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`ShellCommandUnresponsiveException`	في حال لم يرسل أمر المجلّد أي ناتج خلال فترة زمنية معيّنة.
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

يُرجى الاطّلاع أيضًا على:

DdmPreferences.getTimeOut()

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`ShellCommandUnresponsiveException`	في حال عدم إرسال أمر shell أي مخرجات خلال فترة زمنية محددة.
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

يُرجى الاطّلاع أيضًا على:

executeShellCommand

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

تم إيقاف هذا الإجراء نهائيًا.
استخدِم executeShellCommand(String,IShellOutputReceiver,long,TimeUnit).

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

عمليات الطرح
`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`

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public abstract 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 abstract String getAvdName ()

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

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

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

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

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

getAvdPath

public abstract String getAvdPath ()

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

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

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

getBattery

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

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

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

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

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

getBattery

public abstract Future<Integer> getBattery ()

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

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

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

getBatteryLevel

public abstract Integer getBatteryLevel (long freshnessMs)

تم إيقاف هذا الإجراء نهائيًا.
استخدام getBattery(long,TimeUnit)

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

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

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

عمليات الطرح
	com.android.ddmlib.ShellCommandUnresponsiveException
`AdbCommandRejectedException`
`IOException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getBatteryLevel

public abstract Integer getBatteryLevel ()

تم إيقاف هذا الإجراء نهائيًا.
استخدام getBattery()

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

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

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

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

getDensity

public abstract int getDensity ()

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

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

getFileListingService

public abstract FileListingService getFileListingService ()

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

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

getHardwareCharacteristics

public Set<String> getHardwareCharacteristics ()

تعرض هذه السمة الميزات التي تم الحصول عليها من خلال قراءة سمة خصائص الإصدار.

المرتجعات
`Set<String>`

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

getLanguage

public abstract String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint

public abstract String getMountPoint (String name)

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

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

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

يُرجى الاطّلاع أيضًا على:

getProperties

public abstract Map<String, String> getProperties ()

تم إيقاف هذا الإجراء نهائيًا.
استخدِم getSystemProperty(String) بدلاً من ذلك

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

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

getProperty

public abstract String getProperty (String name)

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

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

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

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

getPropertyCacheOrSync

public abstract String getPropertyCacheOrSync (String name)

تم إيقاف هذا الإجراء نهائيًا.
استخدِم getSystemProperty(String) بدلاً من ذلك

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

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`ShellCommandUnresponsiveException`	في حال عدم إرسال أمر shell أي مخرجات خلال فترة زمنية محددة.
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

getPropertyCount

public abstract int getPropertyCount ()

تم إيقاف هذا الإجراء نهائيًا.
تفاصيل التنفيذ

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

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

getPropertySync

public abstract String getPropertySync (String name)

تم إيقاف هذا الإجراء نهائيًا.
استخدام getSystemProperty(String)

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

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`ShellCommandUnresponsiveException`	في حال عدم إرسال أمر shell أي مخرجات خلال فترة زمنية محددة.
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

getRegion

public abstract String getRegion ()

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

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

getScreenshot

public abstract RawImage getScreenshot ()

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

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

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

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

getSerialNumber

public abstract String getSerialNumber ()

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

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

getState

public abstract IDevice.DeviceState getState ()

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

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

getSyncService

public abstract SyncService getSyncService ()

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال تعذّر الاتصال بـ adb

installPackage

public abstract 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 abstract 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 abstract 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 abstract 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 abstract 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(String,boolean,InstallReceiver,long,long,TimeUnit,String...)

installRemotePackage

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

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

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

عمليات الطرح
`InstallException`	في حال تعذّر التثبيت

يُرجى الاطّلاع أيضًا على:

installRemotePackage(String,boolean,InstallReceiver,long,long,TimeUnit,String...)

installRemotePackage

public abstract 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 abstract boolean isBootLoader ()

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

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

isEmulator

public abstract boolean isEmulator ()

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

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

isOffline

public abstract boolean isOffline ()

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

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

isOnline

public abstract boolean isOnline ()

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

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

isRoot

public abstract boolean isRoot ()

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`
`ShellCommandUnresponsiveException`

قتل

public void kill (String applicationName)

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

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

pullFile

public abstract void pullFile (String remote, 
                String local)

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`SyncException`	في حال حدوث خطأ في المزامنة
`TimeoutException`	في حال انتهاء المهلة المحدّدة لقراءة الردود من الجهاز
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج

إرسال

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

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`SyncException`	إذا تعذّر إرسال بعض الملفات
`TimeoutException`	في حال انتهاء المهلة المحدّدة لقراءة الردود من الجهاز
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج أثناء الاتصال

pushFile

public abstract void pushFile (String local, 
                String remote)

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`SyncException`	إذا تعذّر إرسال الملف
`TimeoutException`	في حال انتهاء المهلة المحدّدة لقراءة الردود من الجهاز
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج أثناء الاتصال

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 abstract void reboot (String into)

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`TimeoutException`	في حال انتهاء مهلة الاتصال
	java.io.IOException
`IOException`

removeForward

public void removeForward (int localPort)

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

removeForward

public void removeForward (int localPort, 
                int remotePort)

تم إيقاف هذا الإجراء نهائيًا.
استخدام removeForward(int)

المعلَمات
`localPort`	`int`
`remotePort`	`int`

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

removeForward

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

تم إيقاف هذا الإجراء نهائيًا.
استخدام removeForward(int)

المعلَمات
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

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

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

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

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

عمليات الطرح
`InstallException`	في حال تعذّر التثبيت

removeReverse

public void removeReverse (int remotePort)

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

جذر

public abstract boolean root ()

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`ShellCommandUnresponsiveException`	إذا تعذّر طلب حالة الجذر
`TimeoutException`	في حال انتهاء مهلة الاتصال
	java.io.IOException
`IOException`

startScreenRecorder

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

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

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

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

supportsFeature

public abstract boolean supportsFeature (IDevice.HardwareFeature feature)

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

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

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

supportsFeature

public abstract boolean supportsFeature (IDevice.Feature feature)

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

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

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

syncPackageToDevice

public abstract String syncPackageToDevice (String localFilePath)

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

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

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

عمليات الطرح
`AdbCommandRejectedException`	إذا رفضت أداة تصحيح أخطاء Android الأمر
`SyncException`	إذا حدث خطأ أثناء إرسال الحزمة إلى الجهاز
`TimeoutException`	في حال انتهاء مهلة الاتصال
`IOException`	في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

uninstallApp

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

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

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

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

عمليات الطرح
`InstallException`	في حال تعذُّر إلغاء التثبيت

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

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

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

عمليات الطرح
`InstallException`	في حال تعذُّر إلغاء التثبيت