دستگاه ایمپل
public final class DeviceImpl
extends Object implements IDevice
| شیء جاوا | |
| ↳ | com.android.tradefed.device.server.DeviceImpl |
یک دستگاه. میتواند یک دستگاه فیزیکی یا یک شبیهساز باشد.
خلاصه
سازندگان عمومی | |
|---|---|
DeviceImpl ( ClientTracker clientTracer, String serialNumber, IDevice.DeviceState deviceState) | |
روشهای عمومی | |
|---|---|
boolean | arePropertiesSet () اگر ویژگیها کش شده باشند، |
void | createForward (int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)یک پورت فورواردینگ بین یک پورت TCP محلی و یک سوکت دامنه یونیکس از راه دور ایجاد میکند. |
void | createForward (int localPort, int remotePort)یک پورت فورواردینگ بین یک پورت محلی و یک پورت راه دور ایجاد میکند. |
void | createReverse (int remotePort, int localPort)یک پورت ایجاد میکند که بین یک پورت ریموت و یک پورت محلی، معکوس عمل میکند. |
void | executeBinderCommand (String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)یک دستور Binder را روی دستگاه اجرا میکند و نتیجه را به receiver ارسال میکند. این از exec:cmd استفاده میکند |
void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)یک دستور shell را روی دستگاه اجرا میکند و نتیجه را به یک receiver ارسال میکند. |
void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)نسخهای از دستور executeShell که میتواند یک جریان ورودی را برای ارسال از طریق stdin دریافت کند. |
void | executeShellCommand (String command, IShellOutputReceiver receiver)یک دستور shell را روی دستگاه اجرا میکند و نتیجه را به receiver ارسال میکند. این مشابه فراخوانی |
void | executeShellCommand (String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse) |
void | executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)یک دستور shell را روی دستگاه اجرا میکند و نتیجه را به یک receiver ارسال میکند. |
void | forceStop (String applicationName)توقف اجباری یک برنامه با استفاده از نام برنامه. |
| getAbis ()ABI های پشتیبانی شده توسط این دستگاه را برمیگرداند. |
ListenableFuture< AvdData > | getAvdData ()اطلاعات مربوط به AVD که شبیهساز در حال اجرا است را برمیگرداند. |
String | getAvdName ()نام AVD که شبیهساز در حال اجرا است را برمیگرداند. |
String | getAvdPath ()مسیر مطلق دستگاه مجازی را در سیستم فایل برمیگرداند. |
| getBattery (long freshnessTime, TimeUnit timeUnit)سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید. |
| getBattery ()سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید. |
Integer | getBatteryLevel (long freshnessMs)سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید. |
Integer | getBatteryLevel ()سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید. |
ClientImpl | getClient (String applicationName) یک |
String | getClientName (int pid) نام کلاینت را با استفاده از pid برمیگرداند یا در صورت ناشناخته بودن pid، |
ClientTracker | getClientTracker () |
ClientImpl[] | getClients ()آرایهای از کلاینتها را برمیگرداند. |
int | getDensity () با خواندن مقدار ویژگی سیستمی |
FileListingService | getFileListingService () یک |
String | getLanguage ()زبان کاربر را برمیگرداند. |
InstallMetrics | getLastInstallMetrics ()اطلاعات مربوط به جدیدترین نصب روی این دستگاه را دریافت میکند. |
String | getMountPoint (String name)یک نقطه اتصال (mount point) را برمیگرداند. |
String | getName ()یک نام (انسانی) برای این دستگاه برمیگرداند. |
ClientImpl[] | getNativeClients () |
ClientImpl | getNativeClients (String applicationName) |
ProfileableClientImpl[] | getProfileableClients ()آرایهای از کلاینتهای قابل پروفایل را برمیگرداند. |
| getProperties ()ویژگیهای دستگاه ذخیرهشده در حافظه پنهان (cache) را برمیگرداند. |
String | getProperty (String name) روشی آسان که تلاش میکند یک ویژگی را از طریق |
String | getPropertyCacheOrSync (String name) ترکیبی از |
int | getPropertyCount ()تعداد ویژگی (property) این دستگاه را برمیگرداند. |
String | getPropertySync (String name) نوعی از |
String | getRegion ()منطقه کاربر را برمیگرداند. |
static String | getScreenRecorderCommand (String remoteFilePath, ScreenRecorderOptions options) |
RawImage | getScreenshot () از دستگاه عکس میگیرد و آن را به عنوان یک |
RawImage | getScreenshot (long timeout, TimeUnit unit) |
String | getSerialNumber ()شماره سریال دستگاه را برمیگرداند. |
IDevice.DeviceState | getState ()وضعیت دستگاه را برمیگرداند. |
SyncService | getSyncService () یک شیء |
ListenableFuture<String> | getSystemProperty (String name)یک پرسوجوی ناهمزمان بالقوه برای یک ویژگی سیستم انجام دهید. |
boolean | hasClients () |
void | installPackage (String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)یک برنامه اندروید را روی دستگاه نصب میکند. |
void | installPackage (String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)یک برنامه اندروید را روی دستگاه نصب میکند. |
void | installPackage (String packageFilePath, boolean reinstall, String... extraArgs)یک برنامه اندروید را روی دستگاه نصب میکند. |
void | installPackages (یک برنامه اندروید ساخته شده از چندین فایل APK (یکی فایل اصلی و 0..n بسته تقسیم شده) را با زمان انقضای پیشفرض نصب میکند. |
void | installPackages (یک برنامه اندروید ساخته شده از چندین فایل APK (یکی فایل اصلی و 0..n بسته تقسیم شده) را نصب میکند. |
void | installRemotePackage (String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)بسته برنامهای را که به یک مکان موقت در دستگاه منتقل شده بود، نصب میکند. |
void | installRemotePackage (String remoteFilePath, boolean reinstall, String... extraArgs)بسته برنامهای را که به یک مکان موقت در دستگاه منتقل شده بود، نصب میکند. |
void | installRemotePackage (String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)بسته برنامهای را که به یک مکان موقت در دستگاه منتقل شده بود، نصب میکند. |
void | installRemotePackages (یک برنامه اندروید متشکل از چندین فایل APK که به صورت محلی روی دستگاه قرار دارند را با زمانبندی پیشفرض نصب میکند. |
void | installRemotePackages (یک برنامه اندروید ساخته شده از چندین فایل APK که به صورت محلی روی دستگاه قرار دارند را نصب میکند. |
boolean | isBootLoader ()اگر دستگاه در حالت بوت لودر باشد، مقدار را برمیگرداند. |
boolean | isEmulator () اگر دستگاه یک شبیهساز باشد، |
boolean | isOffline ()اگر دستگاه آفلاین باشد، برمیگردد. |
boolean | isOnline ()در صورت آماده بودن دستگاه، مرجوع میشود. |
boolean | isRoot ()وضعیت ریشه فعلی دستگاه را پرس و جو میکند. |
void | kill (String applicationName)یک برنامه را با استفاده از نام برنامه از بین میبرد. |
void | pullFile (String remote, String local)یک فایل واحد را دریافت میکند. |
void | push (String[] local, String remote)چندین فایل یا دایرکتوری را ارسال میکند. |
void | pushFile (String local, String remote)یک فایل واحد را ارسال میکند. |
SocketChannel | rawBinder (String service, String[] parameters)سرویس Android Binder Bridge را روی یک دستگاه از راه دور فراخوانی کنید. |
SocketChannel | rawExec (String executable, String[] parameters)سرویس host:exec را روی یک دستگاه راه دور فراخوانی کنید. |
void | reboot (String into)دستگاه را دوباره راه اندازی کنید. |
void | removeForward (int localPort)انتقال پورت بین یک پورت محلی و یک پورت راه دور را حذف میکند. |
void | removeRemotePackage (String remoteFilePath)یک فایل را از دستگاه حذف میکند. |
void | removeReverse (int remotePort)پورتی را که بین یک پورت ریموت و یک پورت محلی جابجا میشود، حذف میکند. |
boolean | root ()از سرویس adb بخواهید که در دستگاه به عنوان root عمل کند. |
void | startScreenRecorder (String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver) اگر دستگاه از |
boolean | supportsFeature ( IDevice.HardwareFeature feature)برمیگرداند که آیا این دستگاه از ویژگی سختافزاری داده شده پشتیبانی میکند یا خیر. |
boolean | supportsFeature ( IDevice.Feature feature)برمیگرداند که آیا این دستگاه از ویژگی نرمافزاری داده شده پشتیبانی میکند یا خیر. |
String | syncPackageToDevice (String localFilePath)یک فایل را به دستگاه ارسال میکند |
String | toString () |
String | uninstallApp (String applicationID, String... extraArgs)یک برنامه را از دستگاه حذف نصب میکند. |
String | uninstallPackage (String packageName)یک بسته را از دستگاه حذف نصب میکند. |
سازندگان عمومی
دستگاه ایمپل
public DeviceImpl (ClientTracker clientTracer, String serialNumber, IDevice.DeviceState deviceState)
| پارامترها | |
|---|---|
clientTracer | ClientTracker |
serialNumber | String |
deviceState | IDevice.DeviceState |
روشهای عمومی
arePropertiesSet
public boolean arePropertiesSet ()
اگر ویژگیها کش شده باشند، true را برمیگرداند.
| بازگشتها | |
|---|---|
boolean | |
ایجادبهجلو
public void createForward (int localPort,
String remoteSocketName,
IDevice.DeviceUnixSocketNamespace namespace)یک پورت فورواردینگ بین یک پورت TCP محلی و یک سوکت دامنه یونیکس از راه دور ایجاد میکند.
| پارامترها | |
|---|---|
localPort | int : پورت محلی برای ارسال |
remoteSocketName | String : نام سوکت دامنه یونیکس ایجاد شده روی دستگاه |
namespace | IDevice.DeviceUnixSocketNamespace : فضای نامی که سوکت دامنه یونیکس در آن ایجاد شده است |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
TimeoutException | |
ایجادبهجلو
public void createForward (int localPort,
int remotePort)یک پورت فورواردینگ بین یک پورت محلی و یک پورت راه دور ایجاد میکند.
| پارامترها | |
|---|---|
localPort | int : پورت محلی برای ارسال |
remotePort | int : پورت راه دور. |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
TimeoutException | |
ایجاد معکوس
public void createReverse (int remotePort,
int localPort)یک پورت ایجاد میکند که بین یک پورت ریموت و یک پورت محلی، معکوس عمل میکند.
| پارامترها | |
|---|---|
remotePort | int : پورت راه دور برای معکوس کردن. |
localPort | int : پورت محلی |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
TimeoutException | |
اجرای فرمان 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 |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
ShellCommandUnresponsiveException | |
TimeoutException | |
اجرای فرمان Shell
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeToOutputResponse,
TimeUnit maxTimeUnits)یک دستور shell را روی دستگاه اجرا میکند و نتیجه را به یک receiver ارسال میکند.
maxTimeToOutputResponse به عنوان حداکثر زمان انتظار هنگام انتظار برای خروجی دستور از دستگاه استفاده میشود.
در هر زمانی، اگر دستور shell برای مدت زمانی طولانیتر از maxTimeToOutputResponse چیزی خروجی ندهد، آنگاه متد ShellCommandUnresponsiveException صادر خواهد کرد.
برای دستوراتی مانند خروجی log، باید از مقدار maxTimeToOutputResponse برابر با ۰ استفاده شود، به این معنی که متد هرگز اجرا نمیشود و تا زمانی که IShellOutputReceiver.isCancelled() گیرنده true را برنگرداند، مسدود خواهد شد.
| پارامترها | |
|---|---|
command | String : دستور shell برای اجرا |
receiver | IShellOutputReceiver : IShellOutputReceiver که خروجی دستور shell را دریافت میکند. |
maxTimeToOutputResponse | long : حداکثر زمانی که دستور مجاز است هیچ پاسخی ارائه ندهد. مقدار 0 به این معنی است که متد برای همیشه (تا زمانی که receiver اجرا را لغو کند) منتظر خروجی دستور میماند و هرگز ارسال نمیشود. |
maxTimeUnits | TimeUnit : واحد برای مقادیر غیر صفر maxTimeToOutputResponse . |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
ShellCommandUnresponsiveException | |
TimeoutException | |
اجرای فرمان 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 void executeShellCommand (String command,
IShellOutputReceiver receiver)یک دستور shell را روی دستگاه اجرا میکند و نتیجه را به receiver ارسال میکند.
این مشابه فراخوانی executeShellCommand(command, receiver, DdmPreferences.getTimeOut()) است.
| پارامترها | |
|---|---|
command | String : دستور shell برای اجرا |
receiver | IShellOutputReceiver : IShellOutputReceiver که خروجی دستور shell را دریافت میکند. |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
ShellCommandUnresponsiveException | |
TimeoutException | |
اجرای فرمان Shell
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
int maxTimeToOutputResponse)| پارامترها | |
|---|---|
command | String |
receiver | IShellOutputReceiver |
maxTimeToOutputResponse | int |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
ShellCommandUnresponsiveException | |
TimeoutException | |
اجرای فرمان Shell
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeout,
long maxTimeToOutputResponse,
TimeUnit maxTimeUnits)یک دستور shell را روی دستگاه اجرا میکند و نتیجه را به یک receiver ارسال میکند.
maxTimeToOutputResponse به عنوان حداکثر زمان انتظار هنگام انتظار برای خروجی دستور از دستگاه استفاده میشود.
در هر زمانی، اگر دستور shell برای مدت زمانی طولانیتر از maxTimeToOutputResponse چیزی خروجی ندهد، آنگاه متد ShellCommandUnresponsiveException صادر خواهد کرد.
برای دستوراتی مانند خروجی log، باید از مقدار maxTimeToOutputResponse برابر با ۰ استفاده شود، به این معنی که متد هرگز اجرا نمیشود و تا زمانی که IShellOutputReceiver.isCancelled() گیرنده true را برنگرداند، مسدود خواهد شد.
| پارامترها | |
|---|---|
command | String : دستور shell برای اجرا |
receiver | IShellOutputReceiver : IShellOutputReceiver که خروجی دستور shell را دریافت میکند. |
maxTimeout | long : حداکثر زمان انتظار برای اجرای دستور. مقدار 0 به این معنی است که هیچ حداکثر زمان انتظاری اعمال نخواهد شد. |
maxTimeToOutputResponse | long : حداکثر زمانی که دستور مجاز است هیچ پاسخی ارائه ندهد. مقدار 0 به این معنی است که متد برای همیشه (تا زمانی که receiver اجرا را لغو کند) منتظر خروجی دستور میماند و هرگز ارسال نمیشود. |
maxTimeUnits | TimeUnit : واحد برای مقادیر غیر صفر maxTimeout و maxTimeToOutputResponse . |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
ShellCommandUnresponsiveException | |
TimeoutException | |
توقف اجباری
public void forceStop (String applicationName)
توقف اجباری یک برنامه با استفاده از نام برنامه. این کار تمام هشدارهای در حال انتظار و محاسبات در صف را حذف میکند.
| پارامترها | |
|---|---|
applicationName | String : نام برنامه |
دریافت ابیس
publicgetAbis ()
ABI های پشتیبانی شده توسط این دستگاه را برمیگرداند. ABI ها به ترتیب ترجیحی مرتب شدهاند و اولین ABI ترجیحیترین است.
| بازگشتها | |
|---|---|
| فهرست ABI ها. |
دریافت داده
public ListenableFuture<AvdData> getAvdData ()
اطلاعات مربوط به AVD که شبیهساز در حال اجرا است را برمیگرداند.
AvdData.getName نام AVD است و در صورت عدم وجود، null .
AvdData.getPath مسیر AVD است یا اگر این یک دستگاه فیزیکی باشد، دستور فرعی کنسول شبیهساز ناموفق باشد، یا نسخه شبیهساز قدیمیتر از 30.0.18 باشد، null است.
| بازگشتها | |
|---|---|
ListenableFuture< AvdData > | AvdData برای دستگاه. |
دریافت نام کاربری
public String getAvdName ()
نام AVD که شبیهساز در حال اجرا است را برمیگرداند.
این فقط در صورتی معتبر است که isEmulator() مقدار true را برگرداند.
اگر شبیهساز هیچ AVD را اجرا نمیکند (برای مثال از یک ساختار درختی منبع اندروید در حال اجرا است)، این متد مقدار " <build> " را برمیگرداند.
نکته: اگر میخواهید روی مدت زمان وقفه کنترل داشته باشید، ترجیحاً از getAvdData() استفاده کنید.
| بازگشتها | |
|---|---|
String | نام AVD یا در صورت عدم وجود null . |
دریافتAvdPath
public String getAvdPath ()
مسیر مطلق به دستگاه مجازی در سیستم فایل را برمیگرداند. این مسیر وابسته به سیستم عامل است؛ در لینوکس با / و در ویندوز با \ جداکننده نام خواهد بود.
نکته: اگر میخواهید روی مدت زمان وقفه کنترل داشته باشید، ترجیحاً از getAvdData() استفاده کنید.
| بازگشتها | |
|---|---|
String | مسیر AVD یا اگر این یک دستگاه فیزیکی است، دستور فرعی کنسول شبیهساز ناموفق بود، یا نسخه شبیهساز قدیمیتر از 30.0.18 است، null است. |
باتری را دریافت کنید
publicgetBattery (long freshnessTime, TimeUnit timeUnit)
سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.
ممکن است سطح باتری در حافظه پنهان (cache) ذخیره شده باشد. فقط در صورتی که freshnessTime از آخرین درخواست موفقیتآمیز منقضی شده باشد، سطح باتری دستگاه را درخواست میکند.
| پارامترها | |
|---|---|
freshnessTime | long : میزان باتری مورد نظر برای مدت زمان اخیر |
timeUnit | TimeUnit : ERROR(/TimeUnit) مربوط به freshnessTime |
| بازگشتها | |
|---|---|
| یک ERROR(/Future) که میتواند برای پرسوجوی سطح باتری استفاده شود. اگر سطح باتری قابل بازیابی نباشد، Future یک ERROR(/ExecutionException) برمیگرداند. |
باتری را دریافت کنید
publicgetBattery ()
سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.
ممکن است میزان باتری در حافظه پنهان (cache) ذخیره شده باشد. فقط در صورتی که ۵ دقیقه از آخرین درخواست موفقیتآمیز گذشته باشد، از دستگاه میزان باتری آن را درخواست میکند.
| بازگشتها | |
|---|---|
| یک ERROR(/Future) که میتواند برای پرسوجوی سطح باتری استفاده شود. اگر سطح باتری قابل بازیابی نباشد، Future یک ERROR(/ExecutionException) برمیگرداند. |
دریافت سطح باتری
public Integer getBatteryLevel (long freshnessMs)
سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.
ممکن است سطح باتری در حافظه پنهان (cache) ذخیره شده باشد. فقط در صورتی که freshnessMs از آخرین درخواست موفق منقضی شده باشد، سطح باتری دستگاه را درخواست میکند.
| بازگشتها | |
|---|---|
Integer | سطح باتری یا در صورت عدم امکان بازیابی، null |
دریافت سطح باتری
public Integer getBatteryLevel ()
سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.
ممکن است میزان باتری در حافظه پنهان (cache) ذخیره شده باشد. فقط در صورتی که ۵ دقیقه از آخرین درخواست موفقیتآمیز گذشته باشد، از دستگاه میزان باتری آن را درخواست میکند.
| بازگشتها | |
|---|---|
Integer | سطح باتری یا در صورت عدم امکان بازیابی، null |
دریافت کلاینت
public ClientImpl getClient (String applicationName)
یک Client با نام برنامهاش برمیگرداند.
| پارامترها | |
|---|---|
applicationName | String : نام برنامه |
| بازگشتها | |
|---|---|
ClientImpl | شیء Client یا در صورت عدم تطابق null . |
دریافت نام کلاینت
public String getClientName (int pid)
نام کلاینت را با استفاده از pid برمیگرداند یا در صورت ناشناخته بودن pid، null برمیگرداند.
| پارامترها | |
|---|---|
pid | int : شناسه (pid) کلاینت. |
| بازگشتها | |
|---|---|
String | |
دریافت مشتریان
public ClientImpl[] getClients ()
آرایهای از کلاینتها را برمیگرداند.
| بازگشتها | |
|---|---|
ClientImpl[] | |
چگالی را دریافت کنید
public int getDensity ()
با خواندن مقدار ویژگی سیستمی PROP_DEVICE_DENSITY ، میزان چگالی صفحه نمایش دستگاه را برمیگرداند.
| بازگشتها | |
|---|---|
int | چگالی، یا -۱ اگر قابل تعیین نباشد. |
سرویس فهرست فایلها (getFileListingService)
public FileListingService getFileListingService ()
یک FileListingService برای این دستگاه برمیگرداند.
| بازگشتها | |
|---|---|
FileListingService | |
زبان را دریافت کنید
public String getLanguage ()
زبان کاربر را برمیگرداند.
| بازگشتها | |
|---|---|
String | زبان کاربر، یا اگر ناشناخته است، null |
معیارهای آخرین نصب
public InstallMetrics getLastInstallMetrics ()
اطلاعات مربوط به جدیدترین نصب روی این دستگاه را دریافت میکند.
| بازگشتها | |
|---|---|
InstallMetrics | معیارهای InstallMetrics که نصب را توصیف میکنند. |
دریافت نقطه اتصال
public String getMountPoint (String name)
یک نقطه اتصال (mount point) را برمیگرداند.
| پارامترها | |
|---|---|
name | String : نام نقطه اتصالی که قرار است برگردانده شود |
| بازگشتها | |
|---|---|
String | |
دریافت نام
public String getName ()
یک نام (انسانی) برای این دستگاه برمیگرداند. معمولاً این نام برای AVDها و ترکیبی از نام سازنده، نام مدل و شماره سریال برای دستگاهها است.
| بازگشتها | |
|---|---|
String | |
دریافت کلاینتهای بومی
public ClientImpl getNativeClients (String applicationName)
| پارامترها | |
|---|---|
applicationName | String |
| بازگشتها | |
|---|---|
ClientImpl | |
مشتریان قابل نمایهسازی
public ProfileableClientImpl[] getProfileableClients ()
آرایهای از کلاینتهای قابل پروفایل را برمیگرداند.
| بازگشتها | |
|---|---|
ProfileableClientImpl[] | |
دریافت ویژگیها
publicgetProperties ()
ویژگیهای دستگاه ذخیره شده را برمیگرداند. این شامل کل خروجی 'getprop' است.
| بازگشتها | |
|---|---|
| |
دریافت ویژگی
public String getProperty (String name)
روشی آسان که تلاش میکند یک ویژگی را از طریق IShellEnabledDevice.getSystemProperty(String) با زمان انتظار بسیار کوتاهی بازیابی کند و استثنائات را بپذیرد.
نکته: اگر میخواهید روی مدت زمان وقفه کنترل داشته باشید، ترجیحاً از IShellEnabledDevice.getSystemProperty(String) استفاده کنید.
| پارامترها | |
|---|---|
name | String : نام مقداری که قرار است برگردانده شود. |
| بازگشتها | |
|---|---|
String | مقدار یا اگر مقدار ویژگی بلافاصله در دسترس نبود، null |
دریافت ویژگی CacheOrSync
public String getPropertyCacheOrSync (String name)
ترکیبی از getProperty(String) و getPropertySync(String) که سعی در بازیابی ویژگی از حافظه پنهان (cache) دارد. در صورت عدم یافتن، به صورت همزمان سعی میکند مستقیماً از دستگاه پرسوجو کند و در صورت موفقیت، حافظه پنهان را مجدداً پر کند.
| پارامترها | |
|---|---|
name | String : نام مقداری که قرار است برگردانده شود. |
| بازگشتها | |
|---|---|
String | مقدار یا در صورت عدم وجود ویژگی، null |
getPropertyCount
public int getPropertyCount ()
تعداد ویژگی (property) این دستگاه را برمیگرداند.
| بازگشتها | |
|---|---|
int | |
همگامسازی ویژگیها
public String getPropertySync (String name)
نوعی از getProperty(String) که سعی میکند ویژگی داده شده را مستقیماً از دستگاه و بدون استفاده از حافظه پنهان بازیابی کند. این متد (فقط) باید برای هرگونه ویژگی فرار استفاده شود.
| پارامترها | |
|---|---|
name | String : نام مقداری که قرار است برگردانده شود. |
| بازگشتها | |
|---|---|
String | مقدار یا در صورت عدم وجود ویژگی، null |
منطقه را دریافت کنید
public String getRegion ()
منطقه کاربر را برمیگرداند.
| بازگشتها | |
|---|---|
String | منطقه کاربر، یا اگر ناشناخته است، null |
دستور getScreenRecorder
public static String getScreenRecorderCommand (String remoteFilePath,
ScreenRecorderOptions options)| پارامترها | |
|---|---|
remoteFilePath | String |
options | ScreenRecorderOptions |
| بازگشتها | |
|---|---|
String | |
دریافت اسکرین شات
public RawImage getScreenshot ()
از دستگاه عکس میگیرد و آن را به عنوان یک RawImage برمیگرداند.
| بازگشتها | |
|---|---|
RawImage | اگر مشکلی پیش آمد، تصویر صفحه به صورت RawImage یا null نمایش داده میشود. |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
TimeoutException | |
دریافت اسکرین شات
public RawImage getScreenshot (long timeout, TimeUnit unit)
| پارامترها | |
|---|---|
timeout | long |
unit | TimeUnit |
| بازگشتها | |
|---|---|
RawImage | |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
TimeoutException | |
دریافت شماره سریال
public String getSerialNumber ()
شماره سریال دستگاه را برمیگرداند.
| بازگشتها | |
|---|---|
String | |
دریافت وضعیت
public IDevice.DeviceState getState ()
وضعیت دستگاه را برمیگرداند.
| بازگشتها | |
|---|---|
IDevice.DeviceState | |
دریافت همگامسازی سرویس
public SyncService getSyncService ()
یک شیء SyncService را برمیگرداند تا فایلها را به دستگاه ارسال/دریافت کند.
| بازگشتها | |
|---|---|
SyncService | اگر SyncService ایجاد نشود، null خواهد بود. این اتفاق زمانی میافتد که adb به دلیل نامعتبر بودن IDevice (یا قطع شدن اتصال) از برقراری اتصال خودداری کند. |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
TimeoutException | |
ویژگی سیستم را دریافت کنید
public ListenableFuture<String> getSystemProperty (String name)
یک پرسوجوی ناهمزمان بالقوه برای یک ویژگی سیستم انجام دهید.
| پارامترها | |
|---|---|
name | String : نام مقداری که قرار است برگردانده شود. |
| بازگشتها | |
|---|---|
ListenableFuture<String> | یک ListenableFuture. ERROR(get/Future#get() get) ممکن است مقدار null را برگرداند. |
مشتریان دارد
public boolean hasClients ()
برمیگرداند که آیا IDevice دارای Client s است یا خیر.
| بازگشتها | |
|---|---|
boolean | |
نصب بسته
public 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 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 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 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 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 void installRemotePackage (String remoteFilePath,
boolean reinstall,
String... extraArgs)بسته برنامهای را که به یک مکان موقت در دستگاه منتقل شده بود، نصب میکند.
| پارامترها | |
|---|---|
remoteFilePath | String : مسیر مطلق فایل به فایل بسته روی دستگاه |
reinstall | boolean : اگر نصب مجدد برنامه لازم باشد، روی true تنظیم میشود. |
extraArgs | String : آرگومانهای اضافی اختیاری برای ارسال. برای گزینههای موجود به 'adb shell pm install --help' مراجعه کنید. |
| پرتابها | |
|---|---|
InstallException | |
نصب بسته از راه دور
public void installRemotePackage (String remoteFilePath,
boolean reinstall,
InstallReceiver receiver,
long maxTimeout,
long maxTimeToOutputResponse,
TimeUnit maxTimeUnits,
String... extraArgs)بسته برنامهای را که به یک مکان موقت در دستگاه منتقل شده بود، نصب میکند.
| پارامترها | |
|---|---|
remoteFilePath | String : مسیر مطلق فایل به فایل بسته روی دستگاه |
reinstall | boolean : اگر نصب مجدد برنامه لازم باشد، روی true تنظیم میشود. |
receiver | InstallReceiver : از InstallReceiver برای نظارت بر نصب و دریافت وضعیت نهایی استفاده میشود. |
maxTimeout | long : حداکثر زمان انتظار برای اجرای دستور. مقدار 0 به این معنی است که هیچ حداکثر زمان انتظاری اعمال نخواهد شد. |
maxTimeToOutputResponse | long : حداکثر زمانی که دستور مجاز است هیچ پاسخی ارائه ندهد. مقدار 0 به این معنی است که متد برای همیشه (تا زمانی که receiver اجرا را لغو کند) منتظر خروجی دستور میماند و هرگز ارسال نمیشود. |
maxTimeUnits | TimeUnit : واحد برای مقادیر غیر صفر maxTimeout و maxTimeToOutputResponse . |
extraArgs | String : آرگومانهای اضافی اختیاری برای ارسال. برای گزینههای موجود به 'adb shell pm install --help' مراجعه کنید. |
| پرتابها | |
|---|---|
InstallException | |
نصب بستههای از راه دور
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 boolean isBootLoader ()
اگر دستگاه در حالت بوت لودر باشد، مقدار را برمیگرداند.
| بازگشتها | |
|---|---|
boolean | اگر getState() DeviceState.BOOTLOADER را برگرداند، true . |
شبیهساز is
public boolean isEmulator ()
اگر دستگاه یک شبیهساز باشد، true را برمیگرداند.
| بازگشتها | |
|---|---|
boolean | |
isآفلاین
public boolean isOffline ()
اگر دستگاه آفلاین باشد، برمیگردد.
| بازگشتها | |
|---|---|
boolean | اگر getState() DeviceState.OFFLINE را برگرداند، true . |
آنلاین است
public boolean isOnline ()
در صورت آماده بودن دستگاه، مرجوع میشود.
| بازگشتها | |
|---|---|
boolean | اگر getState() DeviceState.ONLINE را برگرداند، true . |
ایاسروت
public boolean isRoot ()
وضعیت روت فعلی دستگاه را بررسی میکند. برای اطلاعات بیشتر به «adb root» مراجعه کنید.
| بازگشتها | |
|---|---|
boolean | اگر سرویس adb به عنوان root در حال اجرا باشد، مقدار true و در غیر این صورت مقدار false را برمیگرداند. |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
ShellCommandUnresponsiveException | |
TimeoutException | |
کشتن
public void kill (String applicationName)
یک برنامه را با نام برنامه از بین میبرد. این فقط فعالیتها را از بین میبرد و وضعیت آن را در سیستم اندروید به حال خود رها میکند.
| پارامترها | |
|---|---|
applicationName | String : نام برنامه |
فایل pull
public void pullFile (String remote,
String local)یک فایل واحد را دریافت میکند.
| پارامترها | |
|---|---|
remote | String : مسیر کامل فایل راه دور |
local | String : مقصد محلی. |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
SyncException | |
TimeoutException | |
فشار دادن
public void push (String[] local,
String remote)چندین فایل یا دایرکتوری را ارسال میکند.
| پارامترها | |
|---|---|
local | String : فایلهای محلی برای ارسال |
remote | String : مسیر راه دور که نشاندهندهی یک دایرکتوری است |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
SyncException | |
TimeoutException | |
pushFile
public void pushFile (String local,
String remote)یک فایل واحد را ارسال میکند.
| پارامترها | |
|---|---|
local | String : مسیر فایل محلی. |
remote | String : مسیر فایل راه دور |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
SyncException | |
TimeoutException | |
خامبایندر
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 void reboot (String into)
دستگاه را دوباره راه اندازی کنید.
| پارامترها | |
|---|---|
into | String : نام بوتلودر برای راهاندازی مجدد، یا null برای راهاندازی مجدد دستگاه. |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
TimeoutException | |
حذف به جلو
public void removeForward (int localPort)
انتقال پورت بین یک پورت محلی و یک پورت راه دور را حذف میکند.
| پارامترها | |
|---|---|
localPort | int : پورت محلی برای ارسال |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
TimeoutException | |
حذف بستهی از راه دور
public void removeRemotePackage (String remoteFilePath)
یک فایل را از دستگاه حذف میکند.
| پارامترها | |
|---|---|
remoteFilePath | String : مسیر فایلی که قرار است حذف شود در دستگاه |
| پرتابها | |
|---|---|
InstallException | |
حذف معکوس
public void removeReverse (int remotePort)
پورتی را که بین یک پورت ریموت و یک پورت محلی جابجا میشود، حذف میکند.
| پارامترها | |
|---|---|
remotePort | int : پورت راه دور. |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
TimeoutException | |
ریشه
public boolean root ()
از سرویس adb بخواهید که در دستگاه به عنوان root عمل کند. این کار ممکن است بیسروصدا انجام شود و فقط در نسخههای توسعهدهندگان میتواند موفق باشد. برای اطلاعات بیشتر به «adb root» مراجعه کنید.
| بازگشتها | |
|---|---|
boolean | اگر سرویس adb به عنوان root در حال اجرا باشد، مقدار true و در غیر این صورت مقدار false را برمیگرداند. |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
ShellCommandUnresponsiveException | |
TimeoutException | |
ضبط کننده صفحه نمایش را شروع کنید
public void startScreenRecorder (String remoteFilePath,
ScreenRecorderOptions options,
IShellOutputReceiver receiver)اگر دستگاه از IDevice.Feature.SCREEN_RECORD پشتیبانی کند، ضبط صفحه نمایش را در دستگاه آغاز میکند.
| پارامترها | |
|---|---|
remoteFilePath | String |
options | ScreenRecorderOptions |
receiver | IShellOutputReceiver |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
ShellCommandUnresponsiveException | |
TimeoutException | |
پشتیبانی ازویژگی
public boolean supportsFeature (IDevice.HardwareFeature feature)
برمیگرداند که آیا این دستگاه از ویژگی سختافزاری داده شده پشتیبانی میکند یا خیر.
| پارامترها | |
|---|---|
feature | IDevice.HardwareFeature |
| بازگشتها | |
|---|---|
boolean | |
پشتیبانی ازویژگی
public boolean supportsFeature (IDevice.Feature feature)
برمیگرداند که آیا این دستگاه از ویژگی نرمافزاری داده شده پشتیبانی میکند یا خیر.
| پارامترها | |
|---|---|
feature | IDevice.Feature |
| بازگشتها | |
|---|---|
boolean | |
همگامسازی بستهها برای دستگاه
public String syncPackageToDevice (String localFilePath)
یک فایل را به دستگاه ارسال میکند
| پارامترها | |
|---|---|
localFilePath | String : مسیر مطلق فایل روی میزبان محلی |
| بازگشتها | |
|---|---|
String | مسیر مقصد String روی دستگاه برای فایل |
| پرتابها | |
|---|---|
AdbCommandRejectedException | |
SyncException | |
TimeoutException | |
رشتهی دوتایی
public String toString ()
| بازگشتها | |
|---|---|
String | |
حذف نصب برنامه
public String uninstallApp (String applicationID,
String... extraArgs)یک برنامه را از دستگاه حذف نصب میکند.
| پارامترها | |
|---|---|
applicationID | String : شناسه برنامه اندروید برای حذف نصب |
extraArgs | String : آرگومانهای اضافی اختیاری برای ارسال. برای گزینههای موجود به 'adb shell pm install --help' مراجعه کنید. |
| بازگشتها | |
|---|---|
String | یک String با کد خطا، یا در صورت موفقیت، null . |
| پرتابها | |
|---|---|
InstallException | |
حذف نصب بسته
public String uninstallPackage (String packageName)
یک بسته را از دستگاه حذف نصب میکند.
| پارامترها | |
|---|---|
packageName | String : شناسه برنامه اندروید برای حذف نصب |
| بازگشتها | |
|---|---|
String | یک String با کد خطا، یا در صورت موفقیت، null . |
| پرتابها | |
|---|---|
InstallException | |