اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

StubDevice

public class StubDevice
extends Object implements IDevice

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

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

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

DeviceManager.FastbootDevice	تمثيل لجهاز في وضع Fastboot
NullDevice	عنصر نائب `IDevice` تستخدمه `DeviceManager` لتحديد وقت `IDeviceSelection.nullDeviceRequested()` عندما تكون الحالة `true`
RemoteAvdIDevice	عنصر نائب `IDevice` تستخدمه `DeviceManager` لتحديد وقت `DeviceSelectionOptions.gceDeviceRequested()` عندما تكون الحالة `true`
StubLocalAndroidVirtualDevice	عنصر نائب `IDevice` تستخدمه `DeviceManager` لتحديد وقت `DeviceSelectionOptions.localVirtualDeviceRequested()` عندما تكون الحالة `true`
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, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى `receiver` وهذا مشابه لاستدعاء `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)` تم إيقاف هذه الطريقة نهائيًا. استخدِم `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` ينفّذ أمر shell على الجهاز، ويرسل النتيجة إلى `receiver`.
	`getAbis()` تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المتوافقة مع هذا الجهاز.
`String`	`getAvdName()` تعرِض هذه السمة اسم المحاكي الذي يتم تشغيل الجهاز الافتراضي عليه.
`String`	`getAvdPath()` تعرض هذه السمة المسار المطلق للجهاز الافتراضي في نظام الملفات.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` إرجاع مستوى شحن بطارية الجهاز، من 0 إلى 100 بالمائة
	`getBattery()` إرجاع مستوى شحن بطارية الجهاز، من 0 إلى 100 بالمائة
`Integer`	`getBatteryLevel(long freshnessMs)` تم إيقاف هذه الطريقة نهائيًا. يُرجى استخدام `getBattery(long, TimeUnit)` بدلاً من ذلك.
`Integer`	`getBatteryLevel()` تم إيقاف هذه الطريقة نهائيًا. يُرجى استخدام `getBattery()` بدلاً من ذلك.
`Client`	`getClient(String applicationName)` تعرض هذه الدالة `Client` حسب اسم التطبيق.
`String`	`getClientName(int pid)` تعرِض هذه السمة اسم العميل حسب رقم التعريف الشخصي (pid) أو `null` إذا كان رقم التعريف الشخصي غير معروف.
`Client[]`	`getClients()` تعرض هذه السمة مصفوفة العملاء.
`int`	`getDensity()` تعرض هذه السمة فئة الكثافة لشاشة الجهاز من خلال قراءة قيمة السمة `PROP_DEVICE_DENSITY` في النظام.
`FileListingService`	`getFileListingService()` تعرض هذه السمة `FileListingService` لهذا الجهاز.
`String`	`getLanguage()` تعرض هذه السمة لغة المستخدم.
`String`	`getMountPoint(String name)` تعرِض هذه السمة نقطة تثبيت.
`String`	`getName()` تعرض هذه السمة اسمًا (مفهومًا) لهذا الجهاز.
	`getProperties()` تم إيقاف هذه الطريقة نهائيًا. يُرجى استخدام `getSystemProperty(String)` بدلاً من ذلك.
`String`	`getProperty(String name)` طريقة ملائمة تحاول استرداد سمة من خلال `IShellEnabledDevice.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)` تنفيذ طلب بحث غير متزامن محتمل عن سمة نظام
`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( apkFilePaths, boolean reinstall, 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)` تبدأ هذه الطريقة تسجيل الشاشة على الجهاز إذا كان الجهاز يتيح استخدام `IDevice.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`
`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`

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)

ينفّذ أمر 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)

تم إيقاف استخدام هذه الطريقة نهائيًا.
استخدِم executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

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

getAbis

public  getAbis ()

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

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

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)

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

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

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

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

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

getBatteryLevel

public Integer getBatteryLevel ()

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

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

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

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

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

getClient

public Client getClient (String applicationName)

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

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

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

getClientName

public String getClientName (int pid)

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

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

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

getClient

public Client[] getClients ()

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

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

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  getProperties ()

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

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

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

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

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

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

getPropertyCount

public int getPropertyCount ()

تم إيقاف استخدام هذه الطريقة نهائيًا.تم إيقاف
نهائيًا في ddmlib مع تحديد "تفاصيل التنفيذ" كسبب.

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

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

getPropertySync

public String getPropertySync (String name)

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

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

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

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

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

getRegion

public String getRegion ()

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

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

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

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

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`

pullFile

public void pullFile (String remote, 
                String local)

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

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

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

pushFile

public void pushFile (String local, 
                String remote)

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

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

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

إعادة تشغيل

public void reboot (String into)

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

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

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

removeForward

public void removeForward (int localPort)

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

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

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

removeForward

public void removeForward (int localPort, 
                int remotePort)

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

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

removeForward

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

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

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

setSerial

public void setSerial (String serial)

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

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 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`
`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`