IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

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

ملخّص

الثوابت

int CHANGE_BUILD_INFO

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

int CHANGE_CLIENT_LIST

قناع بت تغيير الجهاز: تغيير قائمة Client.

int CHANGE_PROFILEABLE_CLIENT_LIST

قناع بت تغيير الجهاز: تغيير قائمة ProfileableClient

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.

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

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

abstract void executeShellCommand(String command, IShellOutputReceiver receiver)

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

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

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

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

default void forceStop(String applicationName)

فرض إيقاف تطبيق حسب اسم التطبيق

abstract getAbis()

تعرض هذه السمة واجهات التطبيق الثنائية (ABI) المتوافقة مع هذا الجهاز.

default ListenableFuture<AvdData> getAvdData()

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

abstract String getAvdName()

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

abstract String getAvdPath()

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

abstract getBattery(long freshnessTime, TimeUnit timeUnit)

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

abstract getBattery()

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

abstract Integer getBatteryLevel(long freshnessMs)

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

abstract Integer getBatteryLevel()

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

abstract Client getClient(String applicationName)

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

abstract String getClientName(int pid)

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

abstract Client[] getClients()

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

abstract int getDensity()

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

abstract FileListingService getFileListingService()

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

default getHardwareCharacteristics()

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

abstract String getLanguage()

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

default InstallMetrics getLastInstallMetrics()

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

abstract String getMountPoint(String name)

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

default ProfileableClient[] getProfileableClients()

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

abstract getProperties()

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

abstract String getProperty(String name)

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

abstract String getPropertyCacheOrSync(String name)

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

abstract int getPropertyCount()

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

abstract String getPropertySync(String name)

تم إيقاف هذه الطريقة نهائيًا. استخدام IShellEnabledDevice.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 boolean hasClients()

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

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

تثبِّت هذه السياسة تطبيق Android على الجهاز.

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

تثبِّت هذه السياسة تطبيق Android على الجهاز.

default void installPackages( apks, boolean reinstall, installOptions)

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

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

تثبيت تطبيق 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( remoteApks, boolean reinstall, installOptions)

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

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

تثبيت تطبيق 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)

تبدأ هذه الطريقة تسجيل الشاشة على الجهاز إذا كان الجهاز يتيح استخدام IDevice.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

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

Constant Value: 4 (0x00000004)

CHANGE_CLIENT_LIST

public static final int CHANGE_CLIENT_LIST

قناع بت تغيير الجهاز: تغيير قائمة Client

Constant Value: 2 (0x00000002)

CHANGE_PROFILEABLE_CLIENT_LIST

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

قناع بت تغيير الجهاز: تغيير قائمة ProfileableClient

Constant Value: 8 (0x00000008)

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

القيمة الثابتة: "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
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

createForward

public abstract void createForward (int localPort, 
                int remotePort)

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

المعلمات
localPort int: المنفذ المحلي الذي سيتم إعادة توجيهه
remotePort ‫int: المنفذ البعيد
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

createReverse

public void createReverse (int remotePort, 
                int localPort)

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

المعلمات
remotePort ‫int: المنفذ البعيد الذي سيتم عكسه.
localPort ‫int: المنفذ المحلي
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

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

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

executeShellCommand

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

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

المعلمات
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream

الرميات
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

المعلمات
command ‫String: أمر shell المطلوب تنفيذه
receiver IShellOutputReceiver: IShellOutputReceiver الذي سيتلقّى نتيجة أمر shell
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException في حال عدم إرسال أمر shell أي مخرجات خلال فترة زمنية محددة.
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

executeShellCommand

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

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

المعلمات
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

الرميات
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

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

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

getAbis

public abstract  getAbis ()

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

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

getAvdData

public ListenableFuture<AvdData> getAvdData ()

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

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

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

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

getAvdName

public abstract String getAvdName ()

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

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

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

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

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

getAvdPath

public abstract String getAvdPath ()

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

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

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

getBattery

public abstract  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

المعلمات
freshnessTime ‫long: مدى الحداثة المطلوب لمستوى البطارية
timeUnit TimeUnit: ERROR(/TimeUnit) من freshnessTime
المرتجعات
ERROR(/Future) يمكن استخدامه للاستعلام عن مستوى البطارية. ستعرض الدالة Future القيمة ERROR(/ExecutionException) إذا تعذّر استرداد مستوى البطارية.

getBattery

public abstract  getBattery ()

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

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

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

getBatteryLevel

public abstract Integer getBatteryLevel (long freshnessMs)

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

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

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

المرتجعات
Integer مستوى البطارية أو null إذا تعذّر استرداده
الرميات
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

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

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

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

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

getClient

public abstract Client getClient (String applicationName)

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

المعلمات
applicationName ‫String: اسم التطبيق
المرتجعات
Client الكائن Client أو null إذا لم يتم العثور على أي تطابق

getClientName

public abstract String getClientName (int pid)

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

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

getClient

public abstract Client[] getClients ()

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

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

getDensity

public abstract int getDensity ()

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

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

getFileListingService

public abstract FileListingService getFileListingService ()

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

المرتجعات
FileListingService

getHardwareCharacteristics

public  getHardwareCharacteristics ()

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

المرتجعات

getLanguage

public abstract String getLanguage ()

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

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

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

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

getMountPoint

public abstract String getMountPoint (String name)

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

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

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

getProfileableClients

public ProfileableClient[] getProfileableClients ()

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

المرتجعات
ProfileableClient[]

getProperties

public abstract  getProperties ()

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

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

المرتجعات

getProperty

public abstract String getProperty (String name)

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

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

المعلمات
name ‫String: اسم القيمة المطلوب عرضها
المرتجعات
String القيمة أو null إذا لم تكن قيمة السمة متاحة على الفور

getPropertyCacheOrSync

public abstract String getPropertyCacheOrSync (String name)

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

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

المعلمات
name ‫String: اسم القيمة المطلوب عرضها
المرتجعات
String القيمة أو null إذا لم تكن السمة متوفّرة
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException في حال عدم إرسال أمر shell أي مخرجات خلال فترة زمنية محددة.
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

getPropertyCount

public abstract int getPropertyCount ()

تم إيقاف استخدام هذه الطريقة نهائيًا.
تفاصيل التنفيذ

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

المرتجعات
int

getPropertySync

public abstract String getPropertySync (String name)

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

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

المعلمات
name ‫String: اسم القيمة المطلوب عرضها
المرتجعات
String القيمة أو null إذا لم تكن السمة متوفّرة
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException في حال عدم إرسال أمر shell أي مخرجات خلال فترة زمنية محددة.
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

getRegion

public abstract String getRegion ()

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

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

getScreenshot

public abstract RawImage getScreenshot ()

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

المرتجعات
RawImage لقطة الشاشة كـ RawImage أو null إذا حدث خطأ.
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

المعلمات
timeout long

unit TimeUnit

المرتجعات
RawImage

الرميات
AdbCommandRejectedException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

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

المرتجعات
String

getState

public abstract IDevice.DeviceState getState ()

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

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

getSyncService

public abstract SyncService getSyncService ()

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

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

hasClients

public abstract boolean hasClients ()

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

المرتجعات
boolean

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

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

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

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

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

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

installPackages

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

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

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

installRemotePackage

public 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

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

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

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

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 ( remoteApks, 
                boolean reinstall, 
                 installOptions)

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

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

installRemotePackages

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

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

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

isBootLoader

public 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 الخفي يعمل كجذر، وخطأ في الحالات الأخرى.
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException

قتل

public void kill (String applicationName)

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

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

pullFile

public abstract void pullFile (String remote, 
                String local)

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

المعلمات
remote ‫String: المسار الكامل إلى الملف البعيد
local ‫String: تمثّل هذه السمة الوجهة المحلية.
الرميات
في حال حدوث خطأ في الإدخال/الإخراج.
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
TimeoutException في حال انتهاء المهلة المحدّدة لقراءة الردود من الجهاز
SyncException في حال حدوث خطأ في المزامنة

إرسال

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

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

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

pushFile

public abstract void pushFile (String local, 
                String remote)

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

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

rawBinder

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

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

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

المعلمات
service ‫String: اسم خدمة Android التي سيتم الاتصال بها
parameters ‫String: مَعلمات أمر الرابط
المرتجعات
SocketChannel تم ربط SocketChannel بعملية التنفيذ على الجهاز. بعد الاستخدام.
الرميات
AdbCommandRejectedException
TimeoutException

rawExec

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

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

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

المعلمات
executable String

parameters String

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

إعادة تشغيل

public abstract void reboot (String into)

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

المعلمات
into ‫String: اسم برنامج الإقلاع الذي ستتم إعادة التشغيل إليه، أو قيمة فارغة لإعادة تشغيل الجهاز فقط
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
IOException

removeForward

public void removeForward (int localPort)

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

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

removeForward

public void removeForward (int localPort, 
                int remotePort)

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

المعلمات
localPort int

remotePort int

الرميات
AdbCommandRejectedException
TimeoutException

removeForward

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

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

المعلمات
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

الرميات
AdbCommandRejectedException
TimeoutException

removeRemotePackage

public abstract void removeRemotePackage (String remoteFilePath)

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

المعلمات
remoteFilePath ‫String: مسار الملف المطلوب إزالته على الجهاز
الرميات
InstallException في حال تعذّر التثبيت

removeReverse

public void removeReverse (int remotePort)

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

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

الجذر

public abstract boolean root ()

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

المرتجعات
boolean صحيح إذا كان برنامج adb الخفي يعمل كجذر، وخطأ في الحالات الأخرى.
الرميات
TimeoutException في حال انتهاء مهلة الاتصال
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException إذا تعذّر طلب حالة الجذر
IOException

startScreenRecorder

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

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

المعلمات
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

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

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 في حال تعذُّر إلغاء التثبيت