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

StubDevice

public class StubDevice
extends Object implements IDevice, Serializable

java.lang.Object
↳	com.android.tradefed.device.StubDevice

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

‫DeviceManager.FastbootDevice وNullDevice وRemoteAvdIDevice وStubLocalAndroidVirtualDevice وVmRemoteDevice

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

تنفيذ عنصر نائب لـ IDevice

ملخّص

طُرق وضع التصميم العامة
`StubDevice(String serial)`
`StubDevice(String serial, boolean isEmulator)`

الإجراءات العامة
`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)` تم إيقاف هذه الطريقة نهائيًا. استخدِم `executeShellCommand(String,IShellOutputReceiver,long,TimeUnit)`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى `receiver`.
`List<String>`	`getAbis()` تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المتوافقة مع هذا الجهاز.
`String`	`getAvdName()` تعرِض هذه السمة اسم جهاز AVD الذي يتم تشغيل المحاكي عليه.
`String`	`getAvdPath()` تعرض هذه السمة المسار المطلق للجهاز الافتراضي في نظام الملفات.
`Future<Integer>`	`getBattery(long freshnessTime, TimeUnit timeUnit)` لعرض مستوى بطارية الجهاز، من 0 إلى 100 بالمائة
`Future<Integer>`	`getBattery()` لعرض مستوى بطارية الجهاز، من 0 إلى 100 بالمائة
`Integer`	`getBatteryLevel(long freshnessMs)` تم إيقاف هذه الطريقة نهائيًا. استخدِم `getBattery(long,TimeUnit)` بدلاً من ذلك.
`Integer`	`getBatteryLevel()` تم إيقاف هذه الطريقة نهائيًا. استخدِم `getBattery()` بدلاً من ذلك.
`int`	`getDensity()` تعرض هذه السمة فئة الكثافة لشاشة الجهاز من خلال قراءة قيمة السمة `PROP_DEVICE_DENSITY` في النظام.
`FileListingService`	`getFileListingService()` تعرض هذه السمة `FileListingService` لهذا الجهاز.
`String`	`getLanguage()` تعرض هذه السمة لغة المستخدم.
`String`	`getMountPoint(String name)` تعرِض هذه السمة نقطة تثبيت.
`String`	`getName()` تعرِض هذه السمة اسمًا (مفهومًا) لهذا الجهاز.
`Map<String, String>`	`getProperties()` تم إيقاف هذه الطريقة نهائيًا. استخدِم `getSystemProperty(String)` بدلاً من ذلك.
`String`	`getProperty(String name)` طريقة ملائمة تحاول استرداد سمة من خلال `getSystemProperty(String)` مع وقت انتظار قصير جدًا، وتتجاهل الاستثناءات.
`String`	`getPropertyCacheOrSync(String name)` تم إيقاف هذه الطريقة نهائيًا. استخدِم `getProperty(String)` بدلاً من ذلك.
`int`	`getPropertyCount()` تم إيقاف هذه الطريقة نهائيًا. تم إيقافها نهائيًا في ddmlib مع ذكر "تفاصيل التنفيذ" كسبب.
`String`	`getPropertySync(String name)` تم إيقاف هذه الطريقة نهائيًا. استخدِم `getProperty(String)` بدلاً من ذلك.
`String`	`getRegion()` تعرض هذه السمة منطقة المستخدم.
`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> apkFilePaths, boolean reinstall, List<String> extraArgs, long timeOutInMs, TimeUnit timeunit)` تثبيت تطبيق 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)` تثبِّت هذه الطريقة حزمة التطبيق التي تم إرسالها إلى موقع جغرافي مؤقت على الجهاز.
`boolean`	`isBootLoader()` تعرِض هذه الإشارة ما إذا كان الجهاز في وضع برنامج الإقلاع.
`boolean`	`isEmulator()` تعرِض هذه السمة القيمة `true` إذا كان الجهاز محاكيًا.
`boolean`	`isOffline()` تعرِض هذه الإشارة ما إذا كان الجهاز غير متصل بالإنترنت.
`boolean`	`isOnline()` تعرِض هذه السمة ما إذا كان الجهاز جاهزًا.
`boolean`	`isRoot()` يطلب هذا الإجراء حالة الوصول إلى الجذر الحالية للجهاز.
`void`	`pullFile(String remote, String local)` يجلب ملفًا واحدًا.
`void`	`pushFile(String local, String remote)` يدفع ملفًا واحدًا.
`void`	`reboot(String into)` أعد تشغيل الجهاز.
`void`	`removeForward(int localPort)` يزيل عملية إعادة توجيه المنفذ بين منفذ محلي ومنفذ بعيد.
`void`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`void`	`removeRemotePackage(String remoteFilePath)` يزيل ملفًا من الجهاز.
`void`	`removeReverse(int remotePort)` يزيل هذا الإجراء عكس المنفذ بين منفذ بعيد ومنفذ محلي.
`boolean`	`root()` اطلب من برنامج adb الخفي أن يصبح الجذر على الجهاز.
`void`	`setSerial(String serial)`
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` يبدأ تسجيل الشاشة على الجهاز إذا كان الجهاز يتيح استخدام `Feature.SCREEN_RECORD`.
`boolean`	`supportsFeature(IDevice.HardwareFeature arg0)` تعرِض هذه الطريقة ما إذا كان هذا الجهاز يتيح استخدام ميزة الجهاز المحدّدة.
`boolean`	`supportsFeature(IDevice.Feature feature)` تعرِض هذه السمة ما إذا كان هذا الجهاز يتيح استخدام ميزة البرنامج المحدّدة.
`String`	`syncPackageToDevice(String localFilePath)` إرسال ملف إلى الجهاز
`String`	`uninstallApp(String applicationID, String... extraArgs)` لإلغاء تثبيت تطبيق من الجهاز
`String`	`uninstallPackage(String packageName)` تؤدي إلى إلغاء تثبيت حزمة من الجهاز.

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

StubDevice

public StubDevice (String serial)

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

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

المعلَمات
`serial`	`String`
`isEmulator`	`boolean`

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

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)

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

المعلَمات
`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)

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

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

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

getAbis

public List<String> getAbis ()

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

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

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)

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

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

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

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

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

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

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

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

getDensity

public int getDensity ()

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

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

getFileListingService

public FileListingService getFileListingService ()

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

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

getLanguage

public String getLanguage ()

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

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

getMountPoint

public String getMountPoint (String name)

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

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

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

getName

public String getName ()

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

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

getProperties

public Map<String, String> getProperties ()

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

تعرِض هذه السمة خصائص الجهاز المخزَّنة مؤقتًا. يحتوي على الناتج الكامل للأمر 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) بدلاً من ذلك.

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

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

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

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

getPropertyCount

public int getPropertyCount ()

تم إيقاف هذا الإجراء نهائيًا.تم إيقاف
نهائيًا في ddmlib مع ذكر "تفاصيل التنفيذ" كسبب.

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

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

getPropertySync

public String getPropertySync (String name)

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

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

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

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

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

getRegion

public String getRegion ()

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

المرتجعات
`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> apkFilePaths, 
                boolean reinstall, 
                List<String> extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

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

المعلَمات
`apkFilePaths`	‫`List`: قائمة بحِزم APK المطلوب تثبيتها (حِزمة APK رئيسية واحدة + من 0 إلى n من حِزم APK المجزّأة)
`reinstall`	`boolean`: اضبطها على `true` إذا كان يجب إعادة تثبيت التطبيق
`extraArgs`	`List`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm install --help" للاطّلاع على الخيارات المتاحة.
`timeOutInMs`	`long`: انتهاء مهلة التثبيت
`timeunit`	`TimeUnit`: `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`

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`

pullFile

public void pullFile (String remote, 
                String local)

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

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

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

pushFile

public void pushFile (String local, 
                String remote)

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

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

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

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

public void reboot (String into)

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

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

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

removeForward

public void removeForward (int localPort)

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

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

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

removeForward

public void removeForward (int localPort, 
                int remotePort)

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

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

removeForward

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

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

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

setSerial

public void setSerial (String serial)

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

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 arg0)

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

المعلَمات
`arg0`	`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`

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`