آیدیوایس
public interface IDevice
implements IShellEnabledDevice
| com.android.ddmlib.IDevice |
یک دستگاه. میتواند یک دستگاه فیزیکی یا یک شبیهساز باشد.
خلاصه
روشهای عمومی | |
|---|---|
abstract boolean | arePropertiesSet () اگر ویژگیها کش شده باشند، |
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 استفاده میکند |
default void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)نسخهای از دستور executeShell که میتواند یک جریان ورودی را برای ارسال از طریق stdin دریافت کند. |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver)یک دستور shell را روی دستگاه اجرا میکند و نتیجه را به receiver ارسال میکند. این مشابه فراخوانی |
abstract void | executeShellCommand (String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse) این روش منسوخ شده است. از |
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) این متد منسوخ شده است. از |
abstract Integer | getBatteryLevel () این متد منسوخ شده است. |
abstract Client | getClient (String applicationName) یک |
abstract String | getClientName (int pid) نام کلاینت را با استفاده از pid برمیگرداند یا در صورت ناشناخته بودن pid، |
abstract Client[] | getClients ()آرایهای از کلاینتها را برمیگرداند. |
abstract int | getDensity () با خواندن مقدار ویژگی سیستمی |
abstract FileListingService | getFileListingService () یک |
default | getHardwareCharacteristics ()ویژگیهای بهدستآمده با خواندن ویژگی ویژگیهای ساخت را برمیگرداند. |
abstract String | getLanguage ()زبان کاربر را برمیگرداند. |
default InstallMetrics | getLastInstallMetrics ()اطلاعات مربوط به جدیدترین نصب روی این دستگاه را دریافت میکند. |
abstract String | getMountPoint (String name)یک نقطه اتصال (mount point) را برمیگرداند. |
default ProfileableClient[] | getProfileableClients ()آرایهای از کلاینتهای قابل پروفایل را برمیگرداند. |
abstract | getProperties () این روش منسوخ شده است. به جای آن |
abstract String | getProperty (String name) روشی آسان که تلاش میکند یک ویژگی را از طریق |
abstract String | getPropertyCacheOrSync (String name) این روش منسوخ شده است. به جای آن |
abstract int | getPropertyCount ()این روش منسوخ شده است. جزئیات پیادهسازی |
abstract String | getPropertySync (String name) این روش منسوخ شده است. |
abstract String | getRegion ()منطقه کاربر را برمیگرداند. |
abstract RawImage | getScreenshot () از دستگاه عکس میگیرد و آن را به عنوان یک |
abstract RawImage | getScreenshot (long timeout, TimeUnit unit) |
abstract String | getSerialNumber ()شماره سریال دستگاه را برمیگرداند. |
abstract IDevice.DeviceState | getState ()وضعیت دستگاه را برمیگرداند. |
abstract SyncService | getSyncService () یک شیء |
abstract boolean | hasClients () |
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 (یک برنامه اندروید ساخته شده از چندین فایل APK (یکی فایل اصلی و 0..n بسته تقسیم شده) را با زمان انقضای پیشفرض نصب میکند. |
abstract void | installPackages (یک برنامه اندروید ساخته شده از چندین فایل 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 (یک برنامه اندروید متشکل از چندین فایل APK که به صورت محلی روی دستگاه قرار دارند را با زمانبندی پیشفرض نصب میکند. |
default void | installRemotePackages (یک برنامه اندروید ساخته شده از چندین فایل APK که به صورت محلی روی دستگاه قرار دارند را نصب میکند. |
abstract boolean | isBootLoader ()اگر دستگاه در حالت بوت لودر باشد، مقدار را برمیگرداند. |
abstract boolean | isEmulator () اگر دستگاه یک شبیهساز باشد، |
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) این روش منسوخ شده است. |
default void | removeForward (int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace) این روش منسوخ شده است. |
abstract void | removeRemotePackage (String remoteFilePath)یک فایل را از دستگاه حذف میکند. |
default void | removeReverse (int remotePort)پورتی را که بین یک پورت ریموت و یک پورت محلی جابجا میشود، حذف میکند. |
abstract boolean | root ()از سرویس adb بخواهید که در دستگاه به عنوان root عمل کند. |
abstract void | startScreenRecorder (String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver) اگر دستگاه از |
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 استفاده میکند
| پارامترها | |
|---|---|
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 abstractgetAbis ()
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 abstractgetBattery (long freshnessTime, TimeUnit timeUnit)
سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.
ممکن است سطح باتری در حافظه پنهان (cache) ذخیره شده باشد. فقط در صورتی که freshnessTime از آخرین درخواست موفقیتآمیز منقضی شده باشد، سطح باتری دستگاه را درخواست میکند.
| پارامترها | |
|---|---|
freshnessTime | long : میزان باتری مورد نظر برای مدت زمان اخیر |
timeUnit | TimeUnit : ERROR(/TimeUnit) مربوط به freshnessTime |
| بازگشتها | |
|---|---|
| یک ERROR(/Future) که میتواند برای پرسوجوی سطح باتری استفاده شود. اگر سطح باتری قابل بازیابی نباشد، Future یک ERROR(/ExecutionException) برمیگرداند. |
باتری را دریافت کنید
public abstractgetBattery ()
سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.
ممکن است میزان باتری در حافظه پنهان (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 | |
ویژگیهای سختافزاری را دریافت کنید
publicgetHardwareCharacteristics ()
ویژگیهای بهدستآمده با خواندن ویژگی ویژگیهای ساخت را برمیگرداند.
| بازگشتها | |
|---|---|
| |
زبان را دریافت کنید
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 abstractgetProperties ()
این روش منسوخ شده است.
به جای آن از 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 | اگر حذف نصب ناموفق بود. |