آی‌دیوایس

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

شماره سریال شبیه‌ساز عبارت منظم (regexp.)

String UNKNOWN_PACKAGE

روش‌های عمومی

abstract boolean arePropertiesSet ()

اگر ویژگی‌ها کش شده باشند، true را برمی‌گرداند.

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

یک پورت فورواردینگ بین یک پورت TCP محلی و یک سوکت دامنه یونیکس از راه دور ایجاد می‌کند.

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

اطلاعات مربوط به AVD که شبیه‌ساز در حال اجرا است را برمی‌گرداند.

abstract String getAvdName ()

نام AVD که شبیه‌ساز در حال اجرا است را برمی‌گرداند.

abstract String getAvdPath ()

مسیر مطلق دستگاه مجازی را در سیستم فایل برمی‌گرداند.

abstract getBattery (long freshnessTime, TimeUnit timeUnit)

سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.

abstract getBattery ()

سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.

abstract Integer getBatteryLevel (long freshnessMs)

این متد منسوخ شده است. از getBattery(long, TimeUnit) استفاده کنید.

abstract Integer getBatteryLevel ()

این متد منسوخ شده است. getBattery() استفاده کنید.

abstract Client getClient (String applicationName)

یک Client با نام برنامه‌اش برمی‌گرداند.

abstract String getClientName (int pid)

نام کلاینت را با استفاده از 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)

یک نقطه اتصال (mount point) را برمی‌گرداند.

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 s است یا خیر.

abstract void installPackage (String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)

یک برنامه اندروید را روی دستگاه نصب می‌کند.

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

یک برنامه اندروید را روی دستگاه نصب می‌کند.

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

یک برنامه اندروید را روی دستگاه نصب می‌کند.

default void installPackages ( apks, boolean reinstall, installOptions)

یک برنامه اندروید ساخته شده از چندین فایل APK (یکی فایل اصلی و 0..n بسته تقسیم شده) را با زمان انقضای پیش‌فرض نصب می‌کند.

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

یک برنامه اندروید ساخته شده از چندین فایل 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)

یک برنامه اندروید متشکل از چندین فایل APK که به صورت محلی روی دستگاه قرار دارند را با زمان‌بندی پیش‌فرض نصب می‌کند.

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

یک برنامه اندروید ساخته شده از چندین فایل 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 بخواهید که در دستگاه به عنوان root عمل کند.

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)

یک بسته را از دستگاه حذف نصب می‌کند.

ثابت‌ها

اطلاعات ساخت تغییر

public static final int CHANGE_BUILD_INFO

تغییر دستگاه با ماسک بیت: تغییر اطلاعات ساخت.

مقدار ثابت: ۴ (۰x۰۰۰۰۰۰۴)

تغییر_لیست_مشتریان

public static final int CHANGE_CLIENT_LIST

ماسک بیت تغییر دستگاه: تغییر لیست Client .

مقدار ثابت: ۲ (۰x۰۰۰۰۰۰۲)

تغییر_پروفایل_لیست_مشتریان

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

ماسک بیت تغییر دستگاه: تغییر لیست ProfileableClient .

مقدار ثابت: ۸ (۰x۰۰۰۰۰۰۸)

تغییر_وضعیت

public static final int CHANGE_STATE

ماسک بیت تغییر دستگاه: تغییر DeviceState .

مقدار ثابت: ۱ (۰x۰۰۰۰۰۰۱)

شبیه‌ساز اول

public static final String FIRST_EMULATOR_SN

شماره سریال اولین شبیه‌ساز متصل شده.

مقدار ثابت: "emulator-5554"

داده های MNT

public static final String MNT_DATA

مقدار ثابت: "ANDROID_DATA"

حافظه خارجی MNT

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

مقدار ثابت: "ro.build.version.sdk"

ویژگی‌های ساخت و ساز PROP

public static final String PROP_BUILD_CHARACTERISTICS

مقدار ثابت: "ro.build.characterstic"

نام کد ساخت PROP

public static final String PROP_BUILD_CODENAME

مقدار ثابت: "ro.build.version.codename"

برچسب‌های PROP_BUILD

public static final String PROP_BUILD_TAGS

مقدار ثابت: "ro.build.tags"

نوع ساخت پیشنهادی

public static final String PROP_BUILD_TYPE

مقدار ثابت: "ro.build.type"

نسخهٔ ساخت پیشنهادی

public static final String PROP_BUILD_VERSION

مقدار ثابت: "ro.build.version.release"

شماره نسخه_ساخت_PROP

public static final String PROP_BUILD_VERSION_NUMBER

این ثابت منسوخ شده است.
از PROP_BUILD_API_LEVEL استفاده کنید.

مقدار ثابت: "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

مقدار ثابت: "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

مقدار ثابت: "ro.product.cpu.abi2"

لیست دستگاه‌ها و پردازنده‌ها (PROP_DEVICE_CPU_ABI_LIST)

public static final String PROP_DEVICE_CPU_ABI_LIST

مقدار ثابت: "ro.product.cpu.abilist"

چگالی دستگاه PROP

public static final String PROP_DEVICE_DENSITY

مقدار ثابت: "ro.sf.lcd_density"

چگالی شبیه‌ساز دستگاه

public static final String PROP_DEVICE_EMULATOR_DENSITY

مقدار ثابت: "qemu.sf.lcd_density"

زبان دستگاه PROP

public static final String PROP_DEVICE_LANGUAGE

مقدار ثابت: "persist.sys.language"

تولیدکننده دستگاه PROP

public static final String PROP_DEVICE_MANUFACTURER

مقدار ثابت: "ro.product.manufacturer"

مدل دستگاه PROP

public static final String PROP_DEVICE_MODEL

مقدار ثابت: "ro.product.model"

منطقه‌ی دستگاه

public static final String PROP_DEVICE_REGION

مقدار ثابت: "persist.sys.country"

شبیه‌ساز تکرارشونده

public static final String RE_EMULATOR_SN

شماره سریال شبیه‌ساز عبارت منظم (regexp.)

مقدار ثابت: "شبیه‌ساز-(\d+)"

بسته_ناشناس

public static final String UNKNOWN_PACKAGE

مقدار ثابت: ""

روش‌های عمومی

arePropertiesSet

public abstract boolean arePropertiesSet ()

اگر ویژگی‌ها کش شده باشند، true را برمی‌گرداند.

بازگشت‌ها
boolean

ایجادبه‌جلو

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

یک پورت فورواردینگ بین یک پورت TCP محلی و یک سوکت دامنه یونیکس از راه دور ایجاد می‌کند.

پارامترها
localPort int : پورت محلی برای ارسال

remoteSocketName String : نام سوکت دامنه یونیکس ایجاد شده روی دستگاه

namespace IDevice.DeviceUnixSocketNamespace : فضای نامی که سوکت دامنه یونیکس در آن ایجاد شده است

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
در صورت بروز خطای ورودی/خروجی در اتصال.

ایجادبه‌جلو

public abstract void createForward (int localPort, 
                int remotePort)

یک پورت فورواردینگ بین یک پورت محلی و یک پورت راه دور ایجاد می‌کند.

پارامترها
localPort int : پورت محلی برای ارسال

remotePort int : پورت راه دور.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
در صورت بروز خطای ورودی/خروجی در اتصال.

ایجاد معکوس

public void createReverse (int remotePort, 
                int localPort)

یک پورت ایجاد می‌کند که بین یک پورت ریموت و یک پورت محلی، معکوس عمل می‌کند.

پارامترها
remotePort int : پورت راه دور برای معکوس کردن.

localPort int : پورت محلی

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
در صورت بروز خطای ورودی/خروجی در اتصال.

اجرای فرمان Binder

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 اگر adb دستور را رد کند
ShellCommandUnresponsiveException در صورتی که دستور binder برای مدت زمان معینی خروجی ارسال نکند.
در صورت بروز خطای ورودی/خروجی در اتصال.

همچنین ببینید:

اجرای فرمان Shell

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

اجرای فرمان Shell

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

یک دستور shell را روی دستگاه اجرا می‌کند و نتیجه را به receiver ارسال می‌کند.

این مشابه فراخوانی executeShellCommand(command, receiver, DdmPreferences.getTimeOut()) است.

پارامترها
command String : دستور shell برای اجرا

receiver IShellOutputReceiver : IShellOutputReceiver که خروجی دستور shell را دریافت می‌کند.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
ShellCommandUnresponsiveException در صورتی که دستور shell برای مدت زمان معینی خروجی ارسال نکند.
در صورت بروز خطای ورودی/خروجی در اتصال.

اجرای فرمان Shell

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

توقف اجباری

public void forceStop (String applicationName)

توقف اجباری یک برنامه با استفاده از نام برنامه. این کار تمام هشدارهای در حال انتظار و محاسبات در صف را حذف می‌کند.

پارامترها
applicationName String : نام برنامه

دریافت ابیس

public abstract  getAbis ()

ABI های پشتیبانی شده توسط این دستگاه را برمی‌گرداند. ABI ها به ترتیب ترجیحی مرتب شده‌اند و اولین ABI ترجیحی‌ترین است.

بازگشت‌ها
فهرست ABI ها.

دریافت داده

public ListenableFuture<AvdData> getAvdData ()

اطلاعات مربوط به AVD که شبیه‌ساز در حال اجرا است را برمی‌گرداند.

AvdData.getName نام AVD است و در صورت عدم وجود، null .

AvdData.getPath مسیر AVD است یا اگر این یک دستگاه فیزیکی باشد، دستور فرعی کنسول شبیه‌ساز ناموفق باشد، یا نسخه شبیه‌ساز قدیمی‌تر از 30.0.18 باشد، null است.

بازگشت‌ها
ListenableFuture< AvdData > AvdData برای دستگاه.

دریافت نام کاربری

public abstract String getAvdName ()

نام AVD که شبیه‌ساز در حال اجرا است را برمی‌گرداند.

این فقط در صورتی معتبر است که isEmulator() مقدار true را برگرداند.

اگر شبیه‌ساز هیچ AVD را اجرا نمی‌کند (برای مثال از یک ساختار درختی منبع اندروید در حال اجرا است)، این متد مقدار " <build> " را برمی‌گرداند.

نکته: اگر می‌خواهید روی مدت زمان وقفه کنترل داشته باشید، ترجیحاً از getAvdData() استفاده کنید.

بازگشت‌ها
String نام AVD یا در صورت عدم وجود null .

دریافتAvdPath

public abstract String getAvdPath ()

مسیر مطلق به دستگاه مجازی در سیستم فایل را برمی‌گرداند. این مسیر وابسته به سیستم عامل است؛ در لینوکس با / و در ویندوز با \ جداکننده نام خواهد بود.

نکته: اگر می‌خواهید روی مدت زمان وقفه کنترل داشته باشید، ترجیحاً از getAvdData() استفاده کنید.

بازگشت‌ها
String مسیر AVD یا اگر این یک دستگاه فیزیکی است، دستور فرعی کنسول شبیه‌ساز ناموفق بود، یا نسخه شبیه‌ساز قدیمی‌تر از 30.0.18 است، null است.

باتری را دریافت کنید

public abstract  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.

ممکن است سطح باتری در حافظه پنهان (cache) ذخیره شده باشد. فقط در صورتی که freshnessTime از آخرین درخواست موفقیت‌آمیز منقضی شده باشد، سطح باتری دستگاه را درخواست می‌کند.

پارامترها
freshnessTime long : میزان باتری مورد نظر برای مدت زمان اخیر

timeUnit TimeUnit : ERROR(/TimeUnit) مربوط به freshnessTime

بازگشت‌ها
یک ERROR(/Future) که می‌تواند برای پرس‌وجوی سطح باتری استفاده شود. اگر سطح باتری قابل بازیابی نباشد، Future یک ERROR(/ExecutionException) برمی‌گرداند.

باتری را دریافت کنید

public abstract  getBattery ()

سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.

ممکن است میزان باتری در حافظه پنهان (cache) ذخیره شده باشد. فقط در صورتی که ۵ دقیقه از آخرین درخواست موفقیت‌آمیز گذشته باشد، از دستگاه میزان باتری آن را درخواست می‌کند.

بازگشت‌ها
یک ERROR(/Future) که می‌تواند برای پرس‌وجوی سطح باتری استفاده شود. اگر سطح باتری قابل بازیابی نباشد، Future یک ERROR(/ExecutionException) برمی‌گرداند.

دریافت سطح باتری

public abstract Integer getBatteryLevel (long freshnessMs)

این روش منسوخ شده است.
استفاده از getBattery(long, TimeUnit)

سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.

ممکن است سطح باتری در حافظه پنهان (cache) ذخیره شده باشد. فقط در صورتی که freshnessMs از آخرین درخواست موفق منقضی شده باشد، سطح باتری دستگاه را درخواست می‌کند.

بازگشت‌ها
Integer سطح باتری یا در صورت عدم امکان بازیابی، null

پرتاب‌ها
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

دریافت سطح باتری

public abstract Integer getBatteryLevel ()

این روش منسوخ شده است.
استفاده از getBattery()

سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.

ممکن است میزان باتری در حافظه پنهان (cache) ذخیره شده باشد. فقط در صورتی که ۵ دقیقه از آخرین درخواست موفقیت‌آمیز گذشته باشد، از دستگاه میزان باتری آن را درخواست می‌کند.

بازگشت‌ها
Integer سطح باتری یا در صورت عدم امکان بازیابی، null

پرتاب‌ها
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

دریافت کلاینت

public abstract Client getClient (String applicationName)

یک Client با نام برنامه‌اش برمی‌گرداند.

پارامترها
applicationName String : نام برنامه

بازگشت‌ها
Client شیء Client یا در صورت عدم تطابق null .

دریافت نام کلاینت

public abstract String getClientName (int pid)

نام کلاینت را با استفاده از pid برمی‌گرداند یا در صورت ناشناخته بودن pid، null برمی‌گرداند.

پارامترها
pid int : شناسه (pid) کلاینت.

بازگشت‌ها
String

دریافت مشتریان

public abstract Client[] getClients ()

آرایه‌ای از کلاینت‌ها را برمی‌گرداند.

بازگشت‌ها
Client[]

چگالی را دریافت کنید

public abstract int getDensity ()

با خواندن مقدار ویژگی سیستمی PROP_DEVICE_DENSITY ، میزان چگالی صفحه نمایش دستگاه را برمی‌گرداند.

بازگشت‌ها
int چگالی، یا -۱ اگر قابل تعیین نباشد.

سرویس فهرست فایل‌ها (getFileListingService)

public abstract FileListingService getFileListingService ()

یک FileListingService برای این دستگاه برمی‌گرداند.

بازگشت‌ها
FileListingService

ویژگی‌های سخت‌افزاری را دریافت کنید

public  getHardwareCharacteristics ()

ویژگی‌های به‌دست‌آمده با خواندن ویژگی ویژگی‌های ساخت را برمی‌گرداند.

بازگشت‌ها

زبان را دریافت کنید

public abstract String getLanguage ()

زبان کاربر را برمی‌گرداند.

بازگشت‌ها
String زبان کاربر، یا اگر ناشناخته است، null

معیارهای آخرین نصب

public InstallMetrics getLastInstallMetrics ()

اطلاعات مربوط به جدیدترین نصب روی این دستگاه را دریافت می‌کند.

بازگشت‌ها
InstallMetrics معیارهای InstallMetrics که نصب را توصیف می‌کنند.

دریافت نقطه اتصال

public abstract String getMountPoint (String name)

یک نقطه اتصال (mount point) را برمی‌گرداند.

پارامترها
name String : نام نقطه اتصالی که قرار است برگردانده شود

بازگشت‌ها
String

همچنین ببینید:

مشتریان قابل نمایه‌سازی

public ProfileableClient[] getProfileableClients ()

آرایه‌ای از کلاینت‌های قابل پروفایل را برمی‌گرداند.

بازگشت‌ها
ProfileableClient[]

دریافت ویژگی‌ها

public abstract  getProperties ()

این روش منسوخ شده است.
به جای آن از IShellEnabledDevice.getSystemProperty(String) استفاده کنید

ویژگی‌های دستگاه ذخیره شده را برمی‌گرداند. این شامل کل خروجی 'getprop' است.

بازگشت‌ها

دریافت ویژگی

public abstract String getProperty (String name)

روشی آسان که تلاش می‌کند یک ویژگی را از طریق IShellEnabledDevice.getSystemProperty(String) با زمان انتظار بسیار کوتاهی بازیابی کند و استثنائات را بپذیرد.

نکته: اگر می‌خواهید روی مدت زمان وقفه کنترل داشته باشید، ترجیحاً از IShellEnabledDevice.getSystemProperty(String) استفاده کنید.

پارامترها
name String : نام مقداری که قرار است برگردانده شود.

بازگشت‌ها
String مقدار یا اگر مقدار ویژگی بلافاصله در دسترس نبود، null

دریافت ویژگی CacheOrSync

public abstract String getPropertyCacheOrSync (String name)

این روش منسوخ شده است.
به جای آن از IShellEnabledDevice.getSystemProperty(String) استفاده کنید

ترکیبی از getProperty(String) و getPropertySync(String) که سعی در بازیابی ویژگی از حافظه پنهان (cache) دارد. در صورت عدم یافتن، به صورت همزمان سعی می‌کند مستقیماً از دستگاه پرس‌وجو کند و در صورت موفقیت، حافظه پنهان را مجدداً پر کند.

پارامترها
name String : نام مقداری که قرار است برگردانده شود.

بازگشت‌ها
String مقدار یا در صورت عدم وجود ویژگی، null

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
ShellCommandUnresponsiveException در صورتی که دستور shell برای مدت زمان معینی خروجی ارسال نکند.
در صورت بروز خطای ورودی/خروجی در اتصال.

getPropertyCount

public abstract int getPropertyCount ()

این روش منسوخ شده است.
جزئیات پیاده‌سازی

تعداد ویژگی (property) این دستگاه را برمی‌گرداند.

بازگشت‌ها
int

همگام‌سازی ویژگی‌ها

public abstract String getPropertySync (String name)

این روش منسوخ شده است.
استفاده از IShellEnabledDevice.getSystemProperty(String)

نوعی از getProperty(String) که سعی می‌کند ویژگی داده شده را مستقیماً از دستگاه و بدون استفاده از حافظه پنهان بازیابی کند. این متد (فقط) باید برای هرگونه ویژگی فرار استفاده شود.

پارامترها
name String : نام مقداری که قرار است برگردانده شود.

بازگشت‌ها
String مقدار یا در صورت عدم وجود ویژگی، null

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
ShellCommandUnresponsiveException در صورتی که دستور shell برای مدت زمان معینی خروجی ارسال نکند.
در صورت بروز خطای ورودی/خروجی در اتصال.

منطقه را دریافت کنید

public abstract String getRegion ()

منطقه کاربر را برمی‌گرداند.

بازگشت‌ها
String منطقه کاربر، یا اگر ناشناخته است، null

دریافت اسکرین شات

public abstract RawImage getScreenshot ()

از دستگاه عکس می‌گیرد و آن را به عنوان یک RawImage برمی‌گرداند.

بازگشت‌ها
RawImage اگر مشکلی پیش آمد، تصویر صفحه به صورت RawImage یا null نمایش داده می‌شود.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
در صورت بروز خطای ورودی/خروجی در اتصال.

دریافت اسکرین شات

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

پارامترها
timeout long

unit TimeUnit

بازگشت‌ها
RawImage

پرتاب‌ها
AdbCommandRejectedException
TimeoutException

دریافت شماره سریال

public abstract String getSerialNumber ()

شماره سریال دستگاه را برمی‌گرداند.

بازگشت‌ها
String

دریافت وضعیت

public abstract IDevice.DeviceState getState ()

وضعیت دستگاه را برمی‌گرداند.

بازگشت‌ها
IDevice.DeviceState

دریافت همگام‌سازی سرویس

public abstract SyncService getSyncService ()

یک شیء SyncService را برمی‌گرداند تا فایل‌ها را به دستگاه ارسال/دریافت کند.

بازگشت‌ها
SyncService اگر SyncService ایجاد نشود، null خواهد بود. این اتفاق زمانی می‌افتد که adb به دلیل نامعتبر بودن IDevice (یا قطع شدن اتصال) از برقراری اتصال خودداری کند.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
اگر اتصال با adb ناموفق بود.

مشتریان دارد

public abstract boolean hasClients ()

برمی‌گرداند که آیا IDevice دارای Client s است یا خیر.

بازگشت‌ها
boolean

نصب بسته

public abstract void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

یک برنامه اندروید را روی دستگاه نصب می‌کند. این یک متد کمکی است که مراحل 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 اگر نصب با شکست مواجه شود.

نصب بسته

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

یک برنامه اندروید را روی دستگاه نصب می‌کند. این یک متد کمکی است که مراحل syncPackageToDevice، installRemotePackage و removePackage را با هم ترکیب می‌کند.

پارامترها
packageFilePath String : مسیر مطلق فایل سیستم برای نصب فایل روی میزبان محلی

reinstall boolean : اگر نصب مجدد برنامه لازم باشد، روی true تنظیم می‌شود.

receiver InstallReceiver : از InstallReceiver برای نظارت بر نصب و دریافت وضعیت نهایی استفاده می‌شود.

extraArgs String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.

پرتاب‌ها
InstallException اگر نصب با شکست مواجه شود.

نصب بسته

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

یک برنامه اندروید را روی دستگاه نصب می‌کند. این یک متد کمکی است که مراحل syncPackageToDevice، installRemotePackage و removePackage را با هم ترکیب می‌کند.

پارامترها
packageFilePath String : مسیر مطلق فایل سیستم برای نصب فایل روی میزبان محلی

reinstall boolean : اگر نصب مجدد برنامه لازم باشد، روی true تنظیم می‌شود.

extraArgs String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.

پرتاب‌ها
InstallException اگر نصب با شکست مواجه شود.

نصب بسته‌ها

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

یک برنامه اندروید ساخته شده از چندین فایل APK (یکی فایل اصلی و 0..n بسته تقسیم شده) را با زمان انقضای پیش‌فرض نصب می‌کند.

پارامترها
apks : لیست apk ها برای نصب (۱ apk اصلی + ۰..n apk های تقسیم شده)

reinstall boolean : اگر نصب مجدد برنامه لازم باشد، روی true تنظیم می‌شود.

installOptions : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.

پرتاب‌ها
InstallException اگر نصب با شکست مواجه شود.

نصب بسته‌ها

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

یک برنامه اندروید ساخته شده از چندین فایل APK (یکی فایل اصلی و 0..n بسته تقسیم شده) را نصب می‌کند.

پارامترها
apks : لیست apk ها برای نصب (۱ apk اصلی + ۰..n apk های تقسیم شده)

reinstall boolean : اگر نصب مجدد برنامه لازم باشد، روی true تنظیم می‌شود.

installOptions : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.

timeout long : زمان نصب به پایان رسیده است

timeoutUnit TimeUnit : ERROR(/TimeUnit) مربوط به پارامتر timeout

پرتاب‌ها
InstallException اگر نصب با شکست مواجه شود.

نصب بسته از راه دور

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 اگر نصب با شکست مواجه شود.

نصب بسته از راه دور

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

بسته برنامه‌ای را که به یک مکان موقت در دستگاه منتقل شده بود، نصب می‌کند.

پارامترها
remoteFilePath String : مسیر مطلق فایل به فایل بسته روی دستگاه

reinstall boolean : اگر نصب مجدد برنامه لازم باشد، روی true تنظیم می‌شود.

extraArgs String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.

پرتاب‌ها
InstallException اگر نصب با شکست مواجه شود.

نصب بسته از راه دور

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 اگر نصب با شکست مواجه شود.

نصب بسته‌های از راه دور

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

یک برنامه اندروید متشکل از چندین فایل APK که به صورت محلی روی دستگاه قرار دارند را با زمان‌بندی پیش‌فرض نصب می‌کند.

پارامترها
remoteApks : فهرست مسیرهای فایل apk روی دستگاه برای نصب

reinstall boolean : اگر نصب مجدد برنامه لازم باشد، روی true تنظیم می‌شود.

installOptions : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.

پرتاب‌ها
InstallException اگر نصب با شکست مواجه شود.

نصب بسته‌های از راه دور

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

یک برنامه اندروید ساخته شده از چندین فایل APK که به صورت محلی روی دستگاه قرار دارند را نصب می‌کند.

پارامترها
remoteApks : فهرست مسیرهای فایل apk که روی دستگاه برای نصب قرار دارند

reinstall boolean : اگر نصب مجدد برنامه لازم باشد، روی true تنظیم می‌شود.

installOptions : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.

timeout long : زمان نصب به پایان رسیده است

timeoutUnit TimeUnit : ERROR(/TimeUnit) مربوط به پارامتر timeout

پرتاب‌ها
InstallException اگر نصب با شکست مواجه شود.

ایس‌بوت‌لودر

public abstract boolean isBootLoader ()

اگر دستگاه در حالت بوت لودر باشد، مقدار را برمی‌گرداند.

بازگشت‌ها
boolean اگر getState() DeviceState.BOOTLOADER را برگرداند، true .

شبیه‌ساز is

public abstract boolean isEmulator ()

اگر دستگاه یک شبیه‌ساز باشد، true را برمی‌گرداند.

بازگشت‌ها
boolean

isآفلاین

public abstract boolean isOffline ()

اگر دستگاه آفلاین باشد، برمی‌گردد.

بازگشت‌ها
boolean اگر getState() DeviceState.OFFLINE را برگرداند، true .

آنلاین است

public abstract boolean isOnline ()

در صورت آماده بودن دستگاه، مرجوع می‌شود.

بازگشت‌ها
boolean اگر getState() DeviceState.ONLINE را برگرداند، true .

ای‌اس‌روت

public abstract boolean isRoot ()

وضعیت روت فعلی دستگاه را بررسی می‌کند. برای اطلاعات بیشتر به «adb root» مراجعه کنید.

بازگشت‌ها
boolean اگر سرویس adb به عنوان root در حال اجرا باشد، مقدار true و در غیر این صورت مقدار false را برمی‌گرداند.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند.
ShellCommandUnresponsiveException

کشتن

public void kill (String applicationName)

یک برنامه را با نام برنامه از بین می‌برد. این فقط فعالیت‌ها را از بین می‌برد و وضعیت آن را در سیستم اندروید به حال خود رها می‌کند.

پارامترها
applicationName String : نام برنامه

فایل pull

public abstract void pullFile (String remote, 
                String local)

یک فایل واحد را دریافت می‌کند.

پارامترها
remote String : مسیر کامل فایل راه دور

local String : مقصد محلی.

پرتاب‌ها
در صورت وجود استثنای IO.
AdbCommandRejectedException اگر adb دستور را رد کند
TimeoutException در صورت اتمام زمان خواندن پاسخ‌ها از دستگاه.
SyncException در صورت بروز استثنا در همگام‌سازی.

فشار دادن

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

چندین فایل یا دایرکتوری را ارسال می‌کند.

پارامترها
local String : فایل‌های محلی برای ارسال

remote String : مسیر راه دور که نشان‌دهنده‌ی یک دایرکتوری است

پرتاب‌ها
در صورت بروز خطای ورودی/خروجی در اتصال
AdbCommandRejectedException اگر adb دستور را رد کند
TimeoutException در صورت اتمام زمان خواندن پاسخ‌ها از دستگاه
SyncException اگر برخی از فایل‌ها قابل ارسال نبودند

pushFile

public abstract void pushFile (String local, 
                String remote)

یک فایل واحد را ارسال می‌کند.

پارامترها
local String : مسیر فایل محلی.

remote String : مسیر فایل راه دور

پرتاب‌ها
در صورت بروز خطای ورودی/خروجی در اتصال
AdbCommandRejectedException اگر adb دستور را رد کند
TimeoutException در صورت اتمام زمان خواندن پاسخ‌ها از دستگاه
SyncException اگر فایل قابل ارسال نبود

خام‌بایندر

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

سرویس Android Binder Bridge را روی یک دستگاه راه دور فراخوانی کنید. یک کانال سوکت که به دستور device binder متصل است را برگردانید.

مالکیت SocketChannel به تماس‌گیرنده واگذار می‌شود، و پس از استفاده باید صریحاً بسته شود.

پارامترها
service String : نام سرویس اندروید که قرار است به آن متصل شوید

parameters String : پارامترهای دستور binder

بازگشت‌ها
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 : نام بوت‌لودر برای راه‌اندازی مجدد، یا null برای راه‌اندازی مجدد دستگاه.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
استثنای IO

حذف به جلو

public void removeForward (int localPort)

انتقال پورت بین یک پورت محلی و یک پورت راه دور را حذف می‌کند.

پارامترها
localPort int : پورت محلی برای ارسال

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
در صورت بروز خطای ورودی/خروجی در اتصال.

حذف به جلو

public void removeForward (int localPort, 
                int remotePort)

این روش منسوخ شده است.
استفاده از removeForward(int)

پارامترها
localPort int

remotePort int

پرتاب‌ها
AdbCommandRejectedException
TimeoutException

حذف به جلو

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

این روش منسوخ شده است.
استفاده از removeForward(int)

پارامترها
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

پرتاب‌ها
AdbCommandRejectedException
TimeoutException

حذف بسته‌ی از راه دور

public abstract void removeRemotePackage (String remoteFilePath)

یک فایل را از دستگاه حذف می‌کند.

پارامترها
remoteFilePath String : مسیر فایلی که قرار است حذف شود در دستگاه

پرتاب‌ها
InstallException اگر نصب با شکست مواجه شود.

حذف معکوس

public void removeReverse (int remotePort)

پورتی را که بین یک پورت ریموت و یک پورت محلی جابجا می‌شود، حذف می‌کند.

پارامترها
remotePort int : پورت راه دور.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
در صورت بروز خطای ورودی/خروجی در اتصال.

ریشه

public abstract boolean root ()

از سرویس adb بخواهید که در دستگاه به عنوان root عمل کند. این کار ممکن است بی‌سروصدا انجام شود و فقط در نسخه‌های توسعه‌دهندگان می‌تواند موفق باشد. برای اطلاعات بیشتر به «adb root» مراجعه کنید.

بازگشت‌ها
boolean اگر سرویس adb به عنوان root در حال اجرا باشد، مقدار true و در غیر این صورت مقدار false را برمی‌گرداند.

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند.
ShellCommandUnresponsiveException اگر وضعیت ریشه قابل استعلام نباشد.
استثنای IO

ضبط کننده صفحه نمایش را شروع کنید

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

اگر دستگاه از IDevice.Feature.SCREEN_RECORD پشتیبانی کند، ضبط صفحه نمایش را در دستگاه آغاز می‌کند.

پارامترها
remoteFilePath String

options ScreenRecorderOptions

receiver IShellOutputReceiver

پرتاب‌ها
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

پشتیبانی ازویژگی

public abstract boolean supportsFeature (IDevice.HardwareFeature feature)

برمی‌گرداند که آیا این دستگاه از ویژگی سخت‌افزاری داده شده پشتیبانی می‌کند یا خیر.

پارامترها
feature IDevice.HardwareFeature

بازگشت‌ها
boolean

پشتیبانی ازویژگی

public abstract boolean supportsFeature (IDevice.Feature feature)

برمی‌گرداند که آیا این دستگاه از ویژگی نرم‌افزاری داده شده پشتیبانی می‌کند یا خیر.

پارامترها
feature IDevice.Feature

بازگشت‌ها
boolean

همگام‌سازی بسته‌ها برای دستگاه

public abstract String syncPackageToDevice (String localFilePath)

یک فایل را به دستگاه ارسال می‌کند

پارامترها
localFilePath String : مسیر مطلق فایل روی میزبان محلی

بازگشت‌ها
String مسیر مقصد String روی دستگاه برای فایل

پرتاب‌ها
TimeoutException در صورت اتمام زمان اتصال.
AdbCommandRejectedException اگر adb دستور را رد کند
در صورت بروز خطای ورودی/خروجی در اتصال.
SyncException اگر هنگام فشار دادن بسته روی دستگاه خطایی رخ دهد.

حذف نصب برنامه

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

یک برنامه را از دستگاه حذف نصب می‌کند.

پارامترها
applicationID String : شناسه برنامه اندروید برای حذف نصب

extraArgs String : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.

بازگشت‌ها
String یک String با کد خطا، یا در صورت موفقیت، null .

پرتاب‌ها
InstallException اگر حذف نصب ناموفق بود.

حذف نصب بسته

public abstract String uninstallPackage (String packageName)

یک بسته را از دستگاه حذف نصب می‌کند.

پارامترها
packageName String : شناسه برنامه اندروید برای حذف نصب

بازگشت‌ها
String یک String با کد خطا، یا در صورت موفقیت، null .

پرتاب‌ها
InstallException اگر حذف نصب ناموفق بود.