از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

استاب دیوایس

public class StubDevice
extends Object implements IDevice

شیء جاوا
↳	com.android.tradefed.device.StubDevice

زیرکلاس‌های مستقیم شناخته‌شده

DeviceManager.FastbootDevice ، NullDevice ، RemoteAvdIDevice ، StubLocalAndroidVirtualDevice ، VmRemoteDevice

مدیر دستگاه. دستگاه فست‌بوت	نمایش یک دستگاه در حالت Fastboot.
دستگاه تهی	یک شناسه‌ی `IDevice` که توسط `DeviceManager` برای تخصیص زمانی که `IDeviceSelection.nullDeviceRequested()` مقدار `true` دارد، استفاده می‌شود.
دستگاه از راه دورAvdIDevice	یک `IDevice` که توسط `DeviceManager` برای تخصیص زمانی که `DeviceSelectionOptions.gceDeviceRequested()` `true` دارد، استفاده می‌شود.
دستگاه مجازی اندروید StubLocal	یک `IDevice` که توسط `DeviceManager` برای تخصیص زمانی که `DeviceSelectionOptions.localVirtualDeviceRequested()` `true` دارد، استفاده می‌شود.
VmRemoteDevice	یک دستگاه مجازی از راه دور که ما از داخل ماشین مجازی آن را مدیریت خواهیم کرد.

پیاده‌سازی جای‌نگهدار Stub از یک IDevice .

خلاصه

سازندگان عمومی
`StubDevice (String serial)`
`StubDevice (String serial, boolean isEmulator)`

روش‌های عمومی
`boolean`	`arePropertiesSet ()` اگر ویژگی‌ها کش شده باشند، `true` را برمی‌گرداند.
`void`	`createForward (int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` یک پورت فورواردینگ بین یک پورت TCP محلی و یک سوکت دامنه یونیکس از راه دور ایجاد می‌کند.
`void`	`createForward (int localPort, int remotePort)` یک پورت فورواردینگ بین یک پورت محلی و یک پورت راه دور ایجاد می‌کند.
`void`	`createReverse (int remotePort, int localPort)` یک پورت ایجاد می‌کند که بین یک پورت ریموت و یک پورت محلی، معکوس عمل می‌کند.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` یک دستور shell را روی دستگاه اجرا می‌کند و نتیجه را به یک `receiver` ارسال می‌کند.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver)` یک دستور shell را روی دستگاه اجرا می‌کند و نتیجه را به `receiver` ارسال می‌کند. این مشابه فراخوانی `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())` است.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)` این روش منسوخ شده است. از `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)` استفاده کنید.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` یک دستور shell را روی دستگاه اجرا می‌کند و نتیجه را به یک `receiver` ارسال می‌کند.
	`getAbis ()` ABI های پشتیبانی شده توسط این دستگاه را برمی‌گرداند.
`String`	`getAvdName ()` نام AVD که شبیه‌ساز در حال اجرا است را برمی‌گرداند.
`String`	`getAvdPath ()` مسیر مطلق دستگاه مجازی را در سیستم فایل برمی‌گرداند.
	`getBattery (long freshnessTime, TimeUnit timeUnit)` سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.
	`getBattery ()` سطح باتری دستگاه را از ۰ تا ۱۰۰ درصد برگردانید.
`Integer`	`getBatteryLevel (long freshnessMs)` این متد منسوخ شده است. به جای آن `getBattery(long, TimeUnit)` استفاده کنید.
`Integer`	`getBatteryLevel ()` این متد منسوخ شده است. به جای آن `getBattery()` استفاده کنید.
`Client`	`getClient (String applicationName)` یک `Client` با نام برنامه‌اش برمی‌گرداند.
`String`	`getClientName (int pid)` نام کلاینت را با استفاده از pid برمی‌گرداند یا در صورت ناشناخته بودن pid، `null` برمی‌گرداند.
`Client[]`	`getClients ()` آرایه‌ای از کلاینت‌ها را برمی‌گرداند.
`int`	`getDensity ()` با خواندن مقدار ویژگی سیستمی `PROP_DEVICE_DENSITY` ، میزان چگالی صفحه نمایش دستگاه را برمی‌گرداند.
`FileListingService`	`getFileListingService ()` یک `FileListingService` برای این دستگاه برمی‌گرداند.
`String`	`getLanguage ()` زبان کاربر را برمی‌گرداند.
`String`	`getMountPoint (String name)` یک نقطه اتصال (mount point) را برمی‌گرداند.
`String`	`getName ()` یک نام (انسانی) برای این دستگاه برمی‌گرداند.
	`getProperties ()` این روش منسوخ شده است. به جای آن `getSystemProperty(String)` استفاده کنید.
`String`	`getProperty (String name)` روشی آسان که تلاش می‌کند یک ویژگی را از طریق `IShellEnabledDevice.getSystemProperty(String)` با زمان انتظار بسیار کوتاهی بازیابی کند و استثنائات را بپذیرد.
`String`	`getPropertyCacheOrSync (String name)` این متد منسوخ شده است. به جای آن `getProperty(String)` استفاده کنید.
`int`	`getPropertyCount ()` این متد منسوخ شده است. در ddmlib با دلیل «جزئیات پیاده‌سازی» منسوخ شده است.
`String`	`getPropertySync (String name)` این متد منسوخ شده است. به جای آن `getProperty(String)` استفاده کنید.
`String`	`getRegion ()` منطقه کاربر را برمی‌گرداند.
`RawImage`	`getScreenshot ()` از دستگاه عکس می‌گیرد و آن را به عنوان یک `RawImage` برمی‌گرداند.
`RawImage`	`getScreenshot (long timeout, TimeUnit unit)`
`String`	`getSerialNumber ()` شماره سریال دستگاه را برمی‌گرداند.
`IDevice.DeviceState`	`getState ()` وضعیت دستگاه را برمی‌گرداند.
`SyncService`	`getSyncService ()` یک شیء `SyncService` را برمی‌گرداند تا فایل‌ها را به دستگاه ارسال/دریافت کند.
`ListenableFuture<String>`	`getSystemProperty (String name)` یک پرس‌وجوی ناهمزمان بالقوه برای یک ویژگی سیستم انجام دهید.
`boolean`	`hasClients ()` برمی‌گرداند که آیا `IDevice` دارای `Client` s است یا خیر.
`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 ( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)` یک برنامه اندروید ساخته شده از چندین فایل APK (یکی فایل اصلی و 0..n بسته تقسیم شده) را نصب می‌کند.
`void`	`installRemotePackage (String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` بسته برنامه‌ای را که به یک مکان موقت در دستگاه منتقل شده بود، نصب می‌کند.
`void`	`installRemotePackage (String remoteFilePath, boolean reinstall, String... extraArgs)` بسته برنامه‌ای را که به یک مکان موقت در دستگاه منتقل شده بود، نصب می‌کند.
`void`	`installRemotePackage (String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` بسته برنامه‌ای را که به یک مکان موقت در دستگاه منتقل شده بود، نصب می‌کند.
`boolean`	`isBootLoader ()` اگر دستگاه در حالت بوت لودر باشد، مقدار را برمی‌گرداند.
`boolean`	`isEmulator ()` اگر دستگاه یک شبیه‌ساز باشد، `true` را برمی‌گرداند.
`boolean`	`isOffline ()` اگر دستگاه آفلاین باشد، برمی‌گردد.
`boolean`	`isOnline ()` در صورت آماده بودن دستگاه، مرجوع می‌شود.
`boolean`	`isRoot ()` وضعیت ریشه فعلی دستگاه را پرس و جو می‌کند.
`void`	`pullFile (String remote, String local)` یک فایل واحد را دریافت می‌کند.
`void`	`pushFile (String local, String remote)` یک فایل واحد را ارسال می‌کند.
`void`	`reboot (String into)` دستگاه را دوباره راه اندازی کنید.
`void`	`removeForward (int localPort)` انتقال پورت بین یک پورت محلی و یک پورت راه دور را حذف می‌کند.
`void`	`removeForward (int localPort, int remotePort)`
`void`	`removeForward (int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`void`	`removeRemotePackage (String remoteFilePath)` یک فایل را از دستگاه حذف می‌کند.
`void`	`removeReverse (int remotePort)` پورتی را که بین یک پورت ریموت و یک پورت محلی جابجا می‌شود، حذف می‌کند.
`boolean`	`root ()` از سرویس adb بخواهید که در دستگاه به عنوان root عمل کند.
`void`	`setSerial (String serial)`
`void`	`startScreenRecorder (String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` اگر دستگاه از `IDevice.Feature.SCREEN_RECORD` پشتیبانی کند، ضبط صفحه نمایش را در دستگاه آغاز می‌کند.
`boolean`	`supportsFeature ( IDevice.HardwareFeature arg0)` برمی‌گرداند که آیا این دستگاه از ویژگی سخت‌افزاری داده شده پشتیبانی می‌کند یا خیر.
`boolean`	`supportsFeature ( IDevice.Feature feature)` برمی‌گرداند که آیا این دستگاه از ویژگی نرم‌افزاری داده شده پشتیبانی می‌کند یا خیر.
`String`	`syncPackageToDevice (String localFilePath)` یک فایل را به دستگاه ارسال می‌کند
`String`	`uninstallApp (String applicationID, String... extraArgs)` یک برنامه را از دستگاه حذف نصب می‌کند.
`String`	`uninstallPackage (String packageName)` یک بسته را از دستگاه حذف نصب می‌کند.

سازندگان عمومی

استاب دیوایس

public StubDevice (String serial)

پارامترها
`serial`	`String`

استاب دیوایس

public StubDevice (String serial, 
                boolean isEmulator)

پارامترها
`serial`	`String`
`isEmulator`	`boolean`

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

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`

اجرای فرمان 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)

یک دستور 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)

این روش منسوخ شده است.
از executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit) استفاده کنید.

پارامترها
`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 ارسال می‌کند.

پارامترها
`command`	`String` : دستور shell برای اجرا
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` که خروجی دستور shell را دریافت می‌کند.
`maxTimeout`	`long` : حداکثر زمان انتظار برای اجرای دستور. مقدار 0 به این معنی است که هیچ حداکثر زمان انتظاری اعمال نخواهد شد.
`maxTimeToOutputResponse`	`long` : حداکثر زمانی که دستور مجاز است هیچ پاسخی ارائه ندهد. مقدار 0 به این معنی است که متد برای همیشه (تا زمانی که `receiver` اجرا را لغو کند) منتظر خروجی دستور می‌ماند و هرگز ارسال نمی‌شود.
`maxTimeUnits`	`TimeUnit` : واحد برای مقادیر غیر صفر `maxTimeout` و `maxTimeToOutputResponse` .

پرتاب‌ها
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

دریافت ابیس

public  getAbis ()

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

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

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

public String getAvdName ()

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

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

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

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

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

دریافتAvdPath

public String getAvdPath ()

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

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

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

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

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

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

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

پارامترها
`freshnessTime`	`long` : میزان باتری مورد نظر برای مدت زمان اخیر
`timeUnit`	`TimeUnit` : `ERROR(/TimeUnit)` مربوط به freshnessTime

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

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

public  getBattery ()

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

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

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

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

public Integer getBatteryLevel (long freshnessMs)

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

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

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

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

پرتاب‌ها
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

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

public Integer getBatteryLevel ()

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

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

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

پرتاب‌ها
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

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

public Client getClient (String applicationName)

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

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

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

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

public String getClientName (int pid)

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

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

بازگشت‌ها
`String`

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

public Client[] getClients ()

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

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

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

public int getDensity ()

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

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

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

public FileListingService getFileListingService ()

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

بازگشت‌ها
`FileListingService`

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

public String getLanguage ()

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

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

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

public String getMountPoint (String name)

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

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

بازگشت‌ها
`String`

دریافت نام

public String getName ()

یک نام (انسانی) برای این دستگاه برمی‌گرداند. معمولاً این نام برای AVDها و ترکیبی از نام سازنده، نام مدل و شماره سریال برای دستگاه‌ها است.

بازگشت‌ها
`String`

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

public  getProperties ()

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

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

بازگشت‌ها

دریافت ویژگی

public String getProperty (String name)

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

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

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

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

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

public String getPropertyCacheOrSync (String name)

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

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

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

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

پرتاب‌ها
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getPropertyCount

public int getPropertyCount ()

این روش منسوخ شده است.
در ddmlib با دلیل «جزئیات پیاده‌سازی» منسوخ شده است.

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

بازگشت‌ها
`int`

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

public String getPropertySync (String name)

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

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

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

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

پرتاب‌ها
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

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

public String getRegion ()

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

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

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

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)

پارامترها
`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)

پارامترها
`packageFilePath`	`String` : مسیر مطلق فایل سیستم برای نصب فایل روی میزبان محلی
`reinstall`	`boolean` : اگر نصب مجدد برنامه لازم باشد، روی `true` تنظیم می‌شود.
`extraArgs`	`String` : آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.

پرتاب‌ها
`InstallException`

نصب بسته‌ها

public void installPackages ( apkFilePaths, 
                boolean reinstall, 
                 extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

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

پارامترها
`apkFilePaths`	: لیست apk ها برای نصب (۱ apk اصلی + ۰..n apk های تقسیم شده)
`reinstall`	`boolean` : اگر نصب مجدد برنامه لازم باشد، روی `true` تنظیم می‌شود.
`extraArgs`	: آرگومان‌های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به 'adb shell pm install --help' مراجعه کنید.
`timeOutInMs`	`long` : زمان نصب به پایان رسیده است
`timeunit`	`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 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`

فایل pull

public void pullFile (String remote, 
                String local)

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

پارامترها
`remote`	`String` : مسیر کامل فایل راه دور
`local`	`String` : مقصد محلی.

پرتاب‌ها
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

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

پارامترها
`local`	`String` : مسیر فایل محلی.
`remote`	`String` : مسیر فایل راه دور

پرتاب‌ها
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

راه اندازی مجدد

public void reboot (String into)

دستگاه را دوباره راه اندازی کنید.

پارامترها
`into`	`String` : نام بوت‌لودر برای راه‌اندازی مجدد، یا null برای راه‌اندازی مجدد دستگاه.

پرتاب‌ها
`AdbCommandRejectedException`
`TimeoutException`

حذف به جلو

public void removeForward (int localPort)

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

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

پرتاب‌ها
`AdbCommandRejectedException`
`TimeoutException`

حذف به جلو

public void removeForward (int localPort, 
                int remotePort)

پارامترها
`localPort`	`int`
`remotePort`	`int`

پرتاب‌ها
`AdbCommandRejectedException`
`TimeoutException`

حذف به جلو

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

پارامترها
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

پرتاب‌ها
`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 setSerial (String serial)

پارامترها
`serial`	`String`

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

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

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

پارامترها
`arg0`	`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 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`