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

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

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver , IManagedTestDevice , ITestLoggerReceiver

java.lang.object
↳	com.android.tradefed.device.NativeDevice

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

TestDevice

TestDevice پیاده سازی ITestDevice برای یک دستگاه اندرویدی تمام پشته

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

LocalAndroidVirtualDevice ، ManagedRemoteDevice ، NestedRemoteDevice ، RemoteAndroidDevice ، RemoteAndroidVirtualDevice

LocalAndroid Virtual Device	کلاس برای دستگاه های مجازی محلی که روی هاست TradeFed اجرا می شوند.
ManagedRemoteDevice	دستگاهی که در داخل یک ماشین مجازی اجرا می شود که ما از راه دور از طریق یک نمونه Tradefed در داخل VM آن را مدیریت می کنیم.
NestedRemoteDevice	نمایش دستگاه در حال اجرا در داخل یک ماشین مجازی Cuttlefish از راه دور.
RemoteAndroidDevice	پیاده سازی `ITestDevice` برای یک دستگاه اندرویدی تمام پشته متصل از طریق adb connect.
RemoteAndroid Virtual Device	رفتار `RemoteAndroidDevice` برای یک دستگاه Android با پشته کامل که در موتور محاسباتی Google (Gce) اجرا می شود، گسترش می دهد.

اجرای پیش‌فرض دستگاه‌های اندرویدی ITestDevice بدون پشته.

خلاصه

کلاس های تو در تو
`class`	`NativeDevice.AdbAction` یک `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` برای اجرای دستور «adb ....» سیستم عامل.
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` برای راه اندازی مجدد دستگاه.

ثابت ها
`int`	`INVALID_USER_ID` مقدار بازگشتی برای هر شناسه کاربری نامعتبر/یافتنی: UserHandle مقدار -10000 را تعریف کرد
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` تعداد پیش فرض دستور سعی مجدد برای انجام

فیلدها
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

سازندگان عمومی
`NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` یک `TestDevice` ایجاد می کند.

روش های عمومی
`void`	`batchPrefetchStartupBuildProps ()` بهینه‌سازی میکرو (حدود 400 میلی‌لیتر) با واکشی از قبل همه لوازم مورد نیاز ما به جای فراخوانی «adb getprop» برای هر یک.
`boolean`	`canSwitchToHeadlessSystemUser ()` برمی‌گرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر.
`boolean`	`checkApiLevelAgainstNextRelease (int strictMinLevel)` بررسی کنید که آیا یک ویژگی در حال حاضر با حداقل پشتیبانی پشتیبانی می شود یا خیر.
`boolean`	`checkConnectivity ()` بررسی کنید که دستگاه اتصال شبکه دارد.
`boolean`	`clearErrorDialogs ()` سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید.
`void`	`clearLastConnectedWifiNetwork ()` آخرین شبکه وای فای متصل را پاک می کند.
`void`	`clearLogcat ()` تمام داده های logcat انباشته شده را حذف می کند.
`boolean`	`connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)` به شبکه وای فای متصل می شود.
`boolean`	`connectToWifiNetwork (String wifiSsid, String wifiPsk)` به شبکه وای فای متصل می شود.
`boolean`	`connectToWifiNetwork ( wifiSsidToPsk)` به شبکه وای فای متصل می شود.f
`boolean`	`connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)` به شبکه وای فای متصل می شود.
`boolean`	`connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)` گونه ای از `connectToWifiNetwork(String, String)` که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
`boolean`	`connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)` گونه ای از `connectToWifiNetwork(String, String)` که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
`int`	`createUser (String name, boolean guest, boolean ephemeral)` یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
`int`	`createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)` یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
`int`	`createUser (String name)` یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
`int`	`createUserNoThrow (String name)` یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
`DeviceInspectionResult`	`debugDeviceNotAvailable ()` یک دستگاه را بازرسی کنید و وقتی دستگاهی در دسترس نیست، اطلاعات دقیق را برگردانید.
`void`	`deleteFile (String deviceFilePath, int userId)` روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه.
`void`	`deleteFile (String deviceFilePath)` روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه.
`void`	`deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)` `IDeviceActionReceiver` ثبت شده را حذف می کند.
`boolean`	`deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)` روش کمکی برای بررسی اینکه آیا دستگاه با مقایسه system_server فعلی با system_server `ProcessInfo` قبلی، نرم‌افزار راه‌اندازی شده است یا خیر.
`boolean`	`deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)` روش کمکی برای بررسی اینکه آیا دستگاه از زمان UTC از دوره زمانی از دستگاه و `ERROR(/TimeUnit)` نرم‌افزار راه‌اندازی شده است یا خیر.
`boolean`	`disableAdbRoot ()` ریشه adb را خاموش می کند.
`void`	`disableKeyguard ()` تلاش برای غیرفعال کردن محافظ صفحه کلید.
`boolean`	`disableNetworkMonitor ()` مانیتورینگ شبکه را در دستگاه غیرفعال می کند.
`boolean`	`disconnectFromWifi ()` از شبکه وای فای قطع می شود.
`boolean`	`doesFileExist (String deviceFilePath, int userId)` روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر.
`boolean`	`doesFileExist (String deviceFilePath)` روش کمکی برای تعیین وجود فایل روی دستگاه.
`File`	`dumpHeap (String process, String devicePath)` سعی کنید پشته را از system_server تخلیه کنید.
`boolean`	`enableAdbRoot ()` ریشه adb را روشن می کند.
`boolean`	`enableNetworkMonitor ()` نظارت بر شبکه را بر روی دستگاه فعال می کند.
`String`	`executeAdbCommand (long timeout, String... cmdArgs)` متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند.
`String`	`executeAdbCommand (long timeout, envMap, String... cmdArgs)` متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند.
`String`	`executeAdbCommand (String... cmdArgs)` متد Helper که دستور adb را به عنوان دستور سیستم اجرا می کند.
`CommandResult`	`executeFastbootCommand (String... cmdArgs)` روش Helper که یک فرمان fastboot را به عنوان یک فرمان سیستم با زمان پیش فرض 2 دقیقه اجرا می کند.
`CommandResult`	`executeFastbootCommand (long timeout, String... cmdArgs)` متد Helper که دستور fastboot را به عنوان دستور سیستم اجرا می کند.
`CommandResult`	`executeLongFastbootCommand (String... cmdArgs)` متد Helper که یک فرمان طولانی در حال اجرا fastboot را به عنوان فرمان سیستم اجرا می کند.
`CommandResult`	`executeLongFastbootCommand ( envVarMap, String... cmdArgs)` روش کمکی که یک فرمان طولانی در حال اجرا سریع بوت را به عنوان فرمان سیستم با متغیرهای محیط سیستم اجرا می کند.
`String`	`executeShellCommand (String command)` متد Helper که یک دستور adb shell را اجرا می کند و خروجی را به صورت `String` برمی گرداند.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver)` دستور adb shell داده شده را اجرا می کند و در صورت شکست دستور چندین بار دوباره امتحان می کند.
`CommandResult`	`executeShellV2Command (String cmd)` متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت `CommandResult` با خروجی وضعیت فرمان، stdout و stderr به درستی پر می کند.
`CommandResult`	`executeShellV2Command (String cmd, OutputStream pipeToOutput)` متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت `CommandResult` که به درستی با خروجی وضعیت فرمان و stderr پر شده است برمی گرداند.
`CommandResult`	`executeShellV2Command (String cmd, File pipeAsInput)` متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت `CommandResult` با خروجی وضعیت فرمان، stdout و stderr به درستی پر می کند.
`CommandResult`	`executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
`CommandResult`	`executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
`CommandResult`	`executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
`CommandResult`	`executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
`CommandResult`	`fastbootWipePartition (String partition)` روش کمکی که یک پارتیشن را برای دستگاه پاک می کند.
	`getActiveApexes ()` اطلاعات مربوط به APEX های فعال شده در دستگاه را واکشی کنید.
	`getAllSettings (String namespace)` جفت مقدار کلید فضای نام درخواستی را برگردانید.
`DeviceAllocationState`	`getAllocationState ()` وضعیت تخصیص فعلی دستگاه را برگردانید
`String`	`getAndroidId (int userId)` شناسه android مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null.
	`getAndroidIds ()` یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید.
`int`	`getApiLevel ()` سطح API دستگاه را دریافت کنید.
`PackageInfo`	`getAppPackageInfo (String packageName)` اطلاعات مربوط به بسته نصب شده روی دستگاه را واکشی کنید.
	`getAppPackageInfos ()` اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید.
`String`	`getBasebandVersion ()` روش آسان برای دریافت نسخه بیس باند (رادیویی) این دستگاه.
`Integer`	`getBattery ()` سطح فعلی باتری یک دستگاه را برمی‌گرداند یا اگر سطح باتری در دسترس نباشد، Null را برمی‌گرداند.
`boolean`	`getBooleanProperty (String name, boolean defaultValue)` مقدار بولی ویژگی داده شده را برمی گرداند.
	`getBootHistory ()` روش Helper نقشه تاریخچه بوت را با زمان بوت و دلیل بوت جمع آوری می کند.
	`getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)` روش Helper نقشه تاریخچه راه‌اندازی را با زمان بوت و دلیل راه‌اندازی از زمان معین از دوره زمانی از دستگاه و واحد زمانی مشخص شده جمع‌آوری می‌کند.
`String`	`getBootloaderVersion ()` روش راحت برای دریافت نسخه بوت لودر این دستگاه.
`InputStreamSource`	`getBugreport ()` گزارش اشکال را از دستگاه بازیابی می کند.
`InputStreamSource`	`getBugreportz ()` یک bugreportz را از دستگاه بازیابی می کند.
`String`	`getBuildAlias ()` نام مستعار بیلدی که دستگاه در حال حاضر در حال اجرا است را بازیابی کنید.
`String`	`getBuildFlavor ()` طعم ساخت دستگاه را بازیابی کنید.
`String`	`getBuildId ()` بیلدی که دستگاه در حال اجرا است را بازیابی کنید.
`String`	`getBuildSigningKeys ()` نوع کلید مورد استفاده برای امضای تصویر دستگاه را برمی‌گرداند معمولاً دستگاه‌های Android ممکن است با کلیدهای آزمایشی (مانند AOSP) یا کلیدهای انتشار (که توسط سازنده‌های دستگاه کنترل می‌شوند) امضا شوند.
`DeviceDescriptor`	`getCachedDeviceDescriptor ()` اگر دستگاه اختصاص داده شده باشد، `DeviceDescriptor` ذخیره شده را برمی‌گرداند، در غیر این صورت `DeviceDescriptor` فعلی را برمی‌گرداند.
`DeviceDescriptor`	`getCachedDeviceDescriptor (boolean shortDescriptor)` اگر دستگاه اختصاص داده شده باشد، `DeviceDescriptor` ذخیره شده را برمی‌گرداند، در غیر این صورت `DeviceDescriptor` فعلی را برمی‌گرداند.
`String[]`	`getChildren (String path)` جایگزینی برای استفاده از `IFileEntry` که گاهی اوقات به دلیل مجوزها کار نمی کند.
`AbstractConnection`	`getConnection ()` اتصال فعلی مرتبط با دستگاه.
`ContentProviderHandler`	`getContentProvider (int userId)` `ContentProviderHandler` را برمی گرداند یا اگر در دسترس نباشد، آن را خالی می کند.
`DeviceFoldableState`	`getCurrentFoldableState ()` وضعیت تاشو فعلی دستگاه را برمی‌گرداند یا در صورت بروز برخی مشکلات، آن را خالی می‌کند.
`int`	`getCurrentUser ()` شناسه کاربر فعلی را برگردانید.
`String`	`getDeviceClass ()` کلاس دستگاه را دریافت کنید.
`long`	`getDeviceDate ()` تاریخ دستگاه را بر حسب میلی‌ثانیه از آن دوره برگردانید.
`DeviceDescriptor`	`getDeviceDescriptor ()` یک `DeviceDescriptor` از اطلاعات دستگاه برگردانید تا اطلاعات مربوط به آن را بدون عبور از شی دستگاه واقعی دریافت کنید.
`DeviceDescriptor`	`getDeviceDescriptor (boolean shortDescriptor)` یک `DeviceDescriptor` از اطلاعات دستگاه برگردانید تا اطلاعات مربوط به آن را بدون عبور از شی دستگاه واقعی دریافت کنید.
`TestDeviceState`	`getDeviceState ()` وضعیت دستگاه را دریافت کنید.
`long`	`getDeviceTimeOffset (Date date)` کمک کننده برای دریافت تفاوت زمانی بین دستگاه و یک `ERROR(/Date)` داده شده.
`InputStreamSource`	`getEmulatorOutput ()` جریان شبیه ساز stdout و stderr را دریافت کنید
`Process`	`getEmulatorProcess ()` `Process` مربوط به این شبیه ساز را برگردانید.
`final File`	`getExecuteShellCommandLog ()` گزارشی که شامل تمام گزارش‌های `executeShellCommand(String)` است.
`long`	`getExternalStoreFreeSpace ()` روش کمکی برای تعیین میزان فضای خالی در حافظه خارجی دستگاه.
`String`	`getFastbootPath ()` مسیر باینری fastboot مورد استفاده را برمی گرداند.
`String`	`getFastbootProductType ()` روشی راحت برای دریافت نوع محصول این دستگاه در حالت فست بوت.
`String`	`getFastbootProductVariant ()` روشی راحت برای دریافت نوع محصول این دستگاه در حالت فست بوت.
`String`	`getFastbootSerialNumber ()` شماره سریال حالت fastboot را برمی گرداند.
`String`	`getFastbootVariable (String variableName)` مقدار متغیر fastboot داده شده را از دستگاه بازیابی کنید.
`String`	`getFastbootVersion ()` رشته نسخه باینری fastboot مورد استفاده را برمی گرداند.
`IFileEntry`	`getFileEntry (String path)` یک مرجع به یک فایل راه دور در دستگاه را بازیابی کنید.
`IFileEntry`	`getFileEntry (FileListingService.FileEntry entry)` کمک کننده غیر رسمی برای دریافت `FileEntry` از مسیر غیر ریشه.
	`getFoldableStates ()` لیست حالت های تاشو را در دستگاه برمی گرداند.
`IDevice`	`getIDevice ()` یک ارجاع به `IDevice` ddmlib مرتبط را برمی‌گرداند.
	`getInstalledPackageNames ()` نام بسته های برنامه موجود در دستگاه را واکشی کنید.
`long`	`getIntProperty (String name, long defaultValue)` مقدار صحیح ویژگی داده شده را از دستگاه برمی‌گرداند.
`String`	`getIpAddress ()` آدرس IP دستگاه را دریافت می کند.
`KeyguardControllerState`	`getKeyguardState ()` یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید.
`long`	`getLastExpectedRebootTimeMillis ()` آخرین باری را که APIهای Tradefed راه‌اندازی مجدد را در میلی‌ثانیه از زمان EPOCH راه‌اندازی کردند، برمی‌گرداند که توسط `System.currentTimeMillis()` بازگردانده شده است.
`int`	`getLaunchApiLevel ()` اولین سطح API راه اندازی شده دستگاه را دریافت کنید.
`InputStreamSource`	`getLogcat ()` یک جریان عکس فوری از داده های logcat را می گیرد.
`InputStreamSource`	`getLogcat (int maxBytes)` یک جریان عکس فوری از آخرین `maxBytes` داده logcat گرفته شده را می گیرد.
`InputStreamSource`	`getLogcatDump ()` یک روگرفت از logcat فعلی برای دستگاه دریافت کنید.
`InputStreamSource`	`getLogcatSince (long date)` یک جریان عکس فوری از داده‌های logcat گرفته شده را با شروع تاریخ ارائه شده می‌گیرد.
`String`	`getMacAddress ()` آدرس MAC دستگاه را برمی‌گرداند، در صورت عدم درخواست از دستگاه، باطل می‌شود.
`Integer`	`getMainUserId ()` شناسه اصلی کاربر را برمی گرداند.
	`getMainlineModuleInfo ()` اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید.
`int`	`getMaxNumberOfRunningUsersSupported ()` حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید.
`int`	`getMaxNumberOfUsersSupported ()` حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید.
`Process`	`getMicrodroidProcess ()`
`IDeviceStateMonitor`	`getMonitor ()` `IDeviceStateMonitor` مرتبط با دستگاه را برگردانید.
`String`	`getMountPoint (String mountName)` نقطه اتصال را برمی‌گرداند.
`ITestDevice.MountPointInfo`	`getMountPointInfo (String mountpoint)` `MountPointInfo` مربوط به مسیر mountpoint مشخص شده را برمی‌گرداند، یا اگر آن مسیر چیزی نصب نشده باشد یا به‌طور دیگری در /proc/mounts به‌عنوان یک نقطه mount ظاهر نشود، `null` را برمی‌گرداند.
	`getMountPointInfo ()` یک نسخه تجزیه شده از اطلاعات موجود در /proc/mounts در دستگاه را برمی گرداند
`TestDeviceOptions`	`getOptions ()` گزینه های تست دستگاه را واکشی کنید.
`long`	`getPartitionFreeSpace (String partition)` روش کمکی برای تعیین مقدار فضای خالی در پارتیشن دستگاه.
`Integer`	`getPrimaryUserId ()` شناسه کاربر اصلی را برمی گرداند.
`ProcessInfo`	`getProcessByName (String processName)` متد Helper دستور "pidof" و "stat" را اجرا می کند و شی `ProcessInfo` با PID و زمان شروع فرآیند پردازش داده شده برمی گرداند.
`String`	`getProcessPid (String process)` اگر مشکلی پیش آمده باشد، پید سرویس را برمی‌گرداند یا نول می‌کند.
`String`	`getProductType ()` روش راحت برای دریافت نوع محصول این دستگاه.
`String`	`getProductVariant ()` روش راحت برای دریافت نوع محصول این دستگاه.
`String`	`getProperty (String name)` مقدار مشخصه داده شده را از دستگاه بازیابی کنید.
`ITestDevice.RecoveryMode`	`getRecoveryMode ()` حالت بازیابی فعلی مورد استفاده برای دستگاه را دریافت کنید.
`InputStreamSource`	`getScreenshot (long displayId)` یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد.
`InputStreamSource`	`getScreenshot (String format)` یک اسکرین شات از دستگاه می گیرد.
`InputStreamSource`	`getScreenshot (String format, boolean rescale)` یک اسکرین شات از دستگاه می گیرد.
`InputStreamSource`	`getScreenshot ()` یک اسکرین شات از دستگاه می گیرد.
`String`	`getSerialNumber ()` روش آسان برای دریافت شماره سریال این دستگاه.
`String`	`getSetting (int userId, String namespace, String key)` مقدار تنظیمات درخواستی را برگردانید.
`String`	`getSetting (String namespace, String key)` `getSetting(int, String, String)` ببینید و روی کاربر سیستم انجام شود.
`String`	`getSimOperator ()` اپراتور سیم کارت را برگردانید یا اگر در دسترس نیست یا دستگاه در دسترس نیست، آن را خالی کنید.
`String`	`getSimState ()` وضعیت سیم کارت را برگردانید یا اگر در دسترس نیست یا دستگاه در دسترس نیست، آن را خالی کنید.
	`getTombstones ()` لیست سنگ قبرها را از دستگاه ها واکشی و برگردانید.
`long`	`getTotalMemory ()` حجم کل حافظه فیزیکی را بر حسب بایت یا -1 را در صورت خطای داخلی برمی گرداند
`String`	`getTrackingSerial ()` برای مدیریت دستگاه، سریال را برای ردیابی دستگاه استفاده کنید.
	`getUninstallablePackageNames ()` نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید.
`boolean`	`getUseFastbootErase ()` برای پاک کردن پارتیشن روی دستگاه از فرمت fastboot erase یا fastboot استفاده کنید.
`int`	`getUserFlags (int userId)` پرچم های یک کاربر معین را پیدا کرده و برگردانید.
	`getUserInfos ()` نقشه useId به `UserInfo` را در دستگاه دریافت می کند.
`int`	`getUserSerialNumber (int userId)` در صورت یافتن شماره سریال مرتبط به userId، در هر مورد دیگر -10000 را برگردانید.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent (DeviceEvent event)` DeviceEvent داده شده را پردازش کنید. DeviceEvent را پردازش کنید، که ممکن است این دستگاه را به وضعیت تخصیص جدید منتقل کند یا نکند.
`boolean`	`hasFeature (String feature)` بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر.
`String`	`installPackage (File packageFile, boolean reinstall, String... extraArgs)` بسته اندروید را روی دستگاه نصب کنید.
`String`	`installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` بسته اندروید را روی دستگاه نصب کنید.
`String`	`installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)` یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.
`String`	`installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.
`void`	`invalidatePropertyCache ()`
`boolean`	`isAdbRoot ()`
`boolean`	`isAdbTcp ()`
`boolean`	`isAppEnumerationSupported ()` بررسی کنید که آیا پلتفرم روی دستگاه از شمارش برنامه پشتیبانی می‌کند یا خیر
`boolean`	`isBypassLowTargetSdkBlockSupported ()` بررسی کنید که آیا پلتفرم روی دستگاه از دور زدن بلوک sdk هدف پایین در نصب برنامه پشتیبانی می‌کند یا خیر
`boolean`	`isDebugfsMounted ()` بررسی کنید که آیا debugfs نصب شده است یا خیر.
`boolean`	`isDeviceEncrypted ()` اگر دستگاه رمزگذاری شده باشد برمی گردد.
`boolean`	`isDirectory (String path)` اگر مسیر روی دستگاه یک دایرکتوری است، True را برگردانید، در غیر این صورت false.
`boolean`	`isEnableAdbRoot ()`
`boolean`	`isEncryptionSupported ()` اگر رمزگذاری در دستگاه پشتیبانی شود، برمی‌گردد.
`boolean`	`isExecutable (String fullPath)` اگر مسیر فایل روی دستگاه یک فایل اجرایی باشد، True را برمی‌گرداند، در غیر این صورت false است.
`boolean`	`isFastbootEnabled ()` اگر فست بوت برای دستگاه موجود است، برگردید.
`boolean`	`isHeadless ()` اگر دستگاه بدون هد است (بدون صفحه) true را برگردانید، در غیر این صورت false.
`boolean`	`isHeadlessSystemUserMode ()` نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر.
`boolean`	`isMainUserPermanentAdmin ()` نشان می دهد که آیا کاربر اصلی یک سرپرست دائمی است و نمی توان آن را حذف کرد یا به وضعیت غیر سرپرست تنزل داد.
`boolean`	`isMultiUserSupported ()` تعیین می کند که آیا چند کاربر پشتیبانی می شود یا خیر.
`boolean`	`isPackageInstalled (String packageName, String userId)` دستگاه را برای نام بسته معین و شناسه کاربری داده شده جستجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر.
`boolean`	`isPackageInstalled (String packageName)` دستگاه را برای یک نام بسته جستجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.
`boolean`	`isRuntimePermissionSupported ()` بررسی کنید که آیا پلتفرم روی دستگاه از اعطای مجوز زمان اجرا پشتیبانی می کند یا خیر
`boolean`	`isStateBootloaderOrFastbootd ()` اگر دستگاه در `TestDeviceState.FASTBOOT` یا `TestDeviceState.FASTBOOTD` باشد، درست برمی گردد.
`boolean`	`isUserRunning (int userId)` بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر.
`boolean`	`isUserSecondary (int userId)` آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر.
`boolean`	`isUserVisible (int userId)` بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر.
`boolean`	`isUserVisibleOnDisplay (int userId, int displayId)` بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported ()` نشان می‌دهد که آیا دستگاه به کاربران اجازه می‌دهد در پس‌زمینه در `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` قابل مشاهده باشند یا خیر.
`boolean`	`isVisibleBackgroundUsersSupported ()` نشان می دهد که آیا دستگاه به کاربران اجازه می دهد در پس زمینه قابل مشاهده باشند یا خیر.
`boolean`	`isWifiEnabled ()` تست کنید آیا وای فای فعال است یا خیر.
	`listDisplayIds ()` لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید.
	`listDisplayIdsForStartingVisibleBackgroundUsers ()` لیستی از نمایشگرهایی را دریافت می کند که می توانند برای `start a user visible in the background` استفاده شوند.
	`listUsers ()` لیست کاربران دستگاه را دریافت می کند.
`boolean`	`logAnrs ( ITestLogger logger)` ANR ها را از دستگاه جمع آوری و ثبت می کند.
`boolean`	`logBugreport (String dataName, ITestLogger listener)` روش کمکی برای گرفتن گزارش اشکال و ورود آن به خبرنگاران.
`void`	`logOnDevice (String tag, Log.LogLevel level, String format, Object... args)` یک پیام را در logcat دستگاه ثبت کنید.
`void`	`mountDebugfs ()` اشکال زدایی را سوار کنید.
`void`	`nonBlockingReboot ()` دستوری را برای راه اندازی مجدد دستگاه صادر می کند و با فرمان کامل و زمانی که دستگاه دیگر برای adb قابل مشاهده نیست، برمی گردد.
`void`	`postAdbRootAction ()` اگر دستگاه نیاز به انجام برخی اقدامات خاص بعد از ریشه adb و قبل از اینکه دستگاه دوباره آنلاین شود، لغو شود.
`void`	`postAdbUnrootAction ()` اگر دستگاه نیاز به انجام برخی اقدامات خاص پس از unroot adb و قبل از اینکه دستگاه دوباره آنلاین شود، لغو شود.
`void`	`postBootSetup ()` دستورالعمل‌هایی را برای پیکربندی دستگاه برای آزمایش آن پس از هر بار بوت انجام دهید.
`void`	`postInvocationTearDown (Throwable exception)` مراحل اضافی برای پاکسازی مورد نیاز خاص دستگاه که پس از انجام فراخوانی اجرا می شود.
`void`	`preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes)` مراحل اضافی برای تنظیم مورد نیاز خاص دستگاه که قبل از جریان فراخوانی روی دستگاه اجرا می شود.
`boolean`	`pullDir (String deviceFilePath, File localDir, int userId)` به صورت بازگشتی محتویات دایرکتوری را از دستگاه بکشید.
`boolean`	`pullDir (String deviceFilePath, File localDir)` به صورت بازگشتی محتویات دایرکتوری را از دستگاه بکشید.
`boolean`	`pullFile (String remoteFilePath, File localFile)` یک فایل را از دستگاه بازیابی می کند.
`File`	`pullFile (String remoteFilePath, int userId)` یک فایل را از دستگاه بازیابی می کند، آن را در یک `ERROR(/File)` موقت محلی ذخیره می کند و آن `File` برمی گرداند.
`File`	`pullFile (String remoteFilePath)` یک فایل را از دستگاه بازیابی می کند، آن را در یک `ERROR(/File)` موقت محلی ذخیره می کند و آن `File` برمی گرداند.
`boolean`	`pullFile (String remoteFilePath, File localFile, int userId)` یک فایل را از دستگاه بازیابی می کند.
`String`	`pullFileContents (String remoteFilePath)` یک فایل را از دستگاه بازیابی می کند و محتویات را برمی گرداند.
`File`	`pullFileFromExternal (String remoteFilePath)` یک روش راحت برای بازیابی یک فایل از حافظه خارجی دستگاه، ذخیره آن در یک `ERROR(/File)` موقت محلی و بازگشت یک مرجع به آن `File` .
`boolean`	`pushDir (File localFileDir, String deviceFilePath, excludedDirectories)` به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید در حالی که برخی دایرکتوری ها را که فیلتر شده اند حذف کنید.
`boolean`	`pushDir (File localFileDir, String deviceFilePath)` به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید.
`boolean`	`pushDir (File localFileDir, String deviceFilePath, int userId)` به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید.
`boolean`	`pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` گونه ای از `pushFile(File, String)` که می تواند به صورت اختیاری ارزیابی نیاز به ارائه دهنده محتوا را در نظر بگیرد.
`boolean`	`pushFile (File localFile, String remoteFilePath)` یک فایل را به دستگاه فشار دهید.
`boolean`	`pushFile (File localFile, String remoteFilePath, int userId)` یک فایل را به دستگاه فشار دهید.
`boolean`	`pushString (String contents, String remoteFilePath)` فایل فشار ایجاد شده از رشته ای به دستگاه
`void`	`reboot (String reason)` دستگاه را به حالت adb راه‌اندازی مجدد می‌کند و `reason` مشخصی برای ادامه راه‌اندازی مجدد دارد.
`void`	`reboot ()` دستگاه را به حالت adb راه اندازی مجدد می کند.
`void`	`rebootIntoBootloader ()` دستگاه را به حالت بوت لودر راه اندازی مجدد می کند.
`void`	`rebootIntoFastbootd ()` دستگاه را در حالت فست بوت مجدد راه اندازی می کند.
`void`	`rebootIntoRecovery ()` دستگاه را به حالت بازیابی adb راه اندازی مجدد می کند.
`void`	`rebootIntoSideload ()` دستگاه را به حالت adb sideload مجدد راه اندازی می کند (توجه داشته باشید که این یک حالت ویژه در حال بازیابی است) مسدود می شود تا زمانی که دستگاه وارد حالت بار جانبی شود
`void`	`rebootIntoSideload (boolean autoReboot)` دستگاه را به حالت adb sideload مجدد راه اندازی می کند (توجه داشته باشید که این یک حالت ویژه در حال بازیابی است) مسدود می شود تا زمانی که دستگاه وارد حالت بار جانبی شود
`void`	`rebootUntilOnline ()` جایگزینی برای `reboot()` که فقط تا زمانی که دستگاه آنلاین شود مسدود می شود، یعنی برای adb قابل مشاهده است.
`void`	`rebootUntilOnline (String reason)` جایگزینی برای `reboot()` که فقط تا زمانی که دستگاه آنلاین شود مسدود می شود، یعنی برای adb قابل مشاهده است.
`void`	`rebootUserspace ()` فقط قسمتی از دستگاه را در فضای کاربر راه اندازی مجدد می کند.
`void`	`rebootUserspaceUntilOnline ()` جایگزینی برای `rebootUserspace()` ()} که فقط تا زمانی که دستگاه آنلاین شود مسدود می شود، یعنی برای adb قابل مشاهده است.
`boolean`	`recoverDevice ()` تلاش برای بازیابی ارتباطات دستگاه
`void`	`registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)` `IDeviceActionReceiver` را برای این دستگاه ثبت می کند.
`void`	`remountSystemReadOnly ()` پارتیشن سیستم را روی دستگاه فقط خواندنی کنید.
`void`	`remountSystemWritable ()` پارتیشن سیستم روی دستگاه را قابل نوشتن کنید.
`void`	`remountVendorReadOnly ()` پارتیشن فروشنده روی دستگاه را فقط خواندنی کنید.
`void`	`remountVendorWritable ()` پارتیشن فروشنده روی دستگاه را قابل نوشتن کنید.
`boolean`	`removeAdmin (String componentName, int userId)` ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود `true` برگردانید، در غیر این صورت `false` .
`void`	`removeOwners ()` همه دارندگان نمایه دستگاه موجود را با بهترین تلاش حذف کنید.
`boolean`	`removeUser (int userId)` یک کاربر معین را از دستگاه حذف کنید.
`void`	`resetContentProviderSetup ()` پرچم را برای راه اندازی ارائه دهنده محتوا بازنشانی کنید تا دوباره فعال شود.
`boolean`	`runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` روش آسان برای انجام `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` با یک یا چند شنونده به عنوان پارامتر ارسال شده است.
`boolean`	`runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)` تست های ابزار دقیق را اجرا می کند و بازیابی دستگاه را فراهم می کند.
`boolean`	`runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)` مانند `ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))` اما تست را برای کاربر مورد نظر اجرا می کند.
`boolean`	`runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` مانند `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)` اما آزمایش را برای یک کاربر مشخص اجرا می کند.
`void`	`setConfiguration ( IConfiguration configuration)` `IConfiguration` در حال استفاده را تزریق می کند.
`final void`	`setConnectionAvdInfo ( GceAvdInfo avdInfo)`
`void`	`setDate (Date date)` تاریخ را روی دستگاه تنظیم می کند توجه: تنظیم تاریخ در دستگاه نیاز به روت دارد
`boolean`	`setDeviceOwner (String componentName, int userId)` یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید.
`void`	`setDeviceState ( TestDeviceState deviceState)` وضعیت دستگاه را به روز کنید.
`void`	`setEmulatorOutputStream ( SizeLimitedOutputStream output)` برای شبیه ساز `SizeLimitedOutputStream` برای ورود به خروجی تنظیم کنید
`void`	`setEmulatorProcess (Process p)` هنگامی که این دستگاه شبیه ساز است، `Process` را تنظیم می کند.
`void`	`setFastbootEnabled (boolean fastbootEnabled)` گزینه fastboot را برای دستگاه تنظیم کنید.
`void`	`setFastbootPath (String fastbootPath)` مسیر باینری fastboot را که باید استفاده شود را تعیین می کند.
`void`	`setIDevice (IDevice newDevice)` IDevice مرتبط با این ITestDevice را به روز کنید.
`void`	`setLogStartDelay (int delay)` زمان انتظار را قبل از شروع ضبط logcat برای یک دستگاه آنلاین بر حسب میلی ثانیه تنظیم می کند.
`void`	`setOptions ( TestDeviceOptions options)` `TestDeviceOptions` را برای دستگاه تنظیم کنید
`boolean`	`setProperty (String propKey, String propValue)` مقدار ویژگی داده شده را روی دستگاه تنظیم می کند.
`void`	`setRecovery ( IDeviceRecovery recovery)` `IDeviceRecovery` را برای استفاده برای این دستگاه تنظیم کنید.
`void`	`setRecoveryMode ( ITestDevice.RecoveryMode mode)` حالت بازیابی فعلی را برای استفاده برای دستگاه تنظیم کنید.
`void`	`setSetting (String namespace, String key, String value)` به `setSetting(int, String, String, String)` مراجعه کنید و در کاربر سیستم انجام شد.
`void`	`setSetting (int userId, String namespace, String key, String value)` یک مقدار تنظیم به فضای نام یک کاربر معین اضافه کنید.
`void`	`setTestLogger ( ITestLogger testLogger)` نمونه `ITestLogger` را تزریق می کند
`void`	`setTrackingSerial (String trackingSerial)` برای مدیریت دستگاه، سریالی را که برای ارجاع دستگاه استفاده می کنیم، ردیابی کنید.
`void`	`setUseFastbootErase (boolean useFastbootErase)` تنظیم کنید که برای پاک کردن یک پارتیشن روی دستگاه از فرمت fastboot erase یا fastboot استفاده شود.
`void`	`startLogcat ()` شروع به گرفتن خروجی logcat از دستگاه در پس زمینه کنید.
`boolean`	`startTradeInModeTesting (int timeoutMs)` حالت معاملاتی آزمایشی را فعال کنید.
`boolean`	`startUser (int userId)` اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پس‌زمینه راه‌اندازی می‌کند.
`boolean`	`startUser (int userId, boolean waitFlag)` اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پس‌زمینه راه‌اندازی می‌کند.
`boolean`	`startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)` کاربر مشخصی را در پس‌زمینه شروع می‌کند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه می‌دهد فعالیت‌ها را در آن نمایشگر راه‌اندازی کند).
`void`	`stopEmulatorOutput ()` خروجی شبیه ساز را ببندید و حذف کنید.
`void`	`stopLogcat ()` گرفتن خروجی logcat از دستگاه را متوقف کنید و داده های ذخیره شده logcat را دور بریزید.
`void`	`stopTradeInModeTesting ()` آزمایش حالت تجارت در را متوقف کنید.
`boolean`	`stopUser (int userId)` یک کاربر معین را متوقف می کند.
`boolean`	`stopUser (int userId, boolean waitFlag, boolean forceFlag)` یک کاربر معین را متوقف کنید.
`String`	`switchToAdbTcp ()` دستگاه را به حالت adb-over-tcp تغییر دهید.
`boolean`	`switchToAdbUsb ()` دستگاه را به حالت adb از طریق usb تغییر دهید.
`boolean`	`switchUser (int userId)` به userId دیگری با مهلت زمانی پیش‌فرض تغییر وضعیت دهید.
`boolean`	`switchUser (int userId, long timeout)` به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید.
`boolean`	`syncFiles (File localFileDir, String deviceFilePath)` به صورت تدریجی محتویات یک فهرست فایل محلی را با دستگاه همگام می کند.
`Bugreport`	`takeBugreport ()` یک Bugreport بگیرید و آن را در یک شی `Bugreport` برمی گرداند تا آن را مدیریت کند.
`String`	`uninstallPackage (String packageName)` یک بسته Android را از دستگاه حذف نصب کنید.
`String`	`uninstallPackageForUser (String packageName, int userId)` یک بسته Android را برای یک کاربر خاص از دستگاه حذف نصب کنید.
`boolean`	`unlockDevice ()` اگر دستگاه در حالت رمزگذاری شده باشد، قفل دستگاه را باز می کند.
`void`	`unmountDebugfs ()` حذف اشکال زدایی
`boolean`	`waitForBootComplete (long timeOut)` مسدود می شود تا زمانی که پرچم کامل بوت دستگاه تنظیم شود.
`boolean`	`waitForDeviceAvailable ()` منتظر می ماند تا دستگاه پاسخگو و برای آزمایش در دسترس باشد.
`boolean`	`waitForDeviceAvailable (long waitTime)` منتظر می ماند تا دستگاه پاسخگو و برای آزمایش در دسترس باشد.
`boolean`	`waitForDeviceAvailableInRecoverPath (long waitTime)` منتظر می ماند تا دستگاه بدون در نظر گرفتن مسیر بازیابی پاسخگو و در دسترس باشد.
`void`	`waitForDeviceBootloader ()` مسدود می شود تا زمانی که دستگاه از طریق فست بوت قابل مشاهده باشد.
`boolean`	`waitForDeviceInRecovery (long waitTime)` مسدود کردن دستگاه در حالت «بازیابی adb» (توجه داشته باشید که این با `IDeviceRecovery` متفاوت است).
`boolean`	`waitForDeviceInSideload (long waitTime)` مسدود کردن دستگاه در حالت "adb sideload".
`boolean`	`waitForDeviceNotAvailable (long waitTime)` بلوک‌هایی که دستگاه در دسترس نیست، یعنی از adb موجود نیست
`void`	`waitForDeviceOnline ()` مسدود می شود تا زمانی که دستگاه از طریق adb قابل مشاهده باشد.
`void`	`waitForDeviceOnline (long waitTime)` مسدود می شود تا زمانی که دستگاه از طریق adb قابل مشاهده باشد.
`boolean`	`waitForDeviceShell (long waitTime)` منتظر می ماند تا دستگاه به یک دستور اولیه پوسته adb پاسخ دهد.

روش های محافظت شده
`void`	`addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand (String command, boolean forceExitStatusDetection)` دستور OS را برای جلسه دستور adb shell داده شده می سازد و args می کند
`void`	`checkApiLevelAgainst (String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction ( NativeDevice.RebootMode rebootMode, String reason)` یک `RebootDeviceAction` ایجاد کنید تا در هنگام انجام یک عمل راه اندازی مجدد استفاده شود.
`IRunUtil`	`createRunUtil ()`
`void`	`doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)` یک راه اندازی مجدد adb انجام دهید.
`void`	`ensureRuntimePermissionSupported ()` روش کمکی برای پرتاب استثنا در صورت عدم پشتیبانی از مجوز زمان اجرا
`int`	`getApiLevelSafe ()`
`ITestLogger`	`getLogger ()`
`IRunUtil`	`getRunUtil ()` نمونه `RunUtil` را برای استفاده دریافت کنید.
`void`	`initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes)`
`String`	`internalGetProperty (String propName, String fastbootVar, String description)` یک ویژگی دستگاه را از کش ddmlib به طور پیش‌فرض واکشی کنید و بسته به اینکه دستگاه در Fastboot باشد یا خیر، به «adb shell getprop» یا «fastboot getvar» برگردید.
`boolean`	`isInRebootCallback ()` برمی‌گرداند که آیا فراخوان‌های راه‌اندازی مجدد در حال حاضر اجرا می‌شوند یا خیر.
`boolean`	`isNewer (File localFile, IFileEntry entry)` اگر فایل محلی جدیدتر از فایل راه دور باشد، `true` برگردانید.
`void`	`notifyRebootEnded ()` به همه `IDeviceActionReceiver` درباره رویداد پایان راه‌اندازی مجدد اطلاع می‌دهد.
`void`	`notifyRebootStarted ()` همه `IDeviceActionReceiver` در مورد رویداد شروع راه اندازی مجدد مطلع می کند.
`boolean`	`performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` عملی را در این دستگاه انجام می دهد.
`void`	`postAdbReboot ()` اقدامات اضافی احتمالی که می توان پس از راه اندازی مجدد انجام داد.
`void`	`prePostBootSetup ()` به هر نوع دستگاه (AndroidNativeDevice، TestDevice) اجازه می‌دهد این روش را برای راه‌اندازی خاص پس از بوت لغو کند.
`boolean`	`pullFileInternal (String remoteFilePath, File localFile)`
`void`	`setClock (Clock clock)` نمونه ساعت را برای استفاده تنظیم کنید.
`void`	`setMicrodroidProcess (Process process)` TestDevice را به عنوان microdroid علامت گذاری کرده و CID آن را تنظیم می کند.
`void`	`setTestDeviceOptions ( deviceOptions)`
`CommandResult`	`simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd)` یک فرمان ساده fastboot را با متغیرهای محیطی اجرا می کند و وضعیت دستور را گزارش می دهد.
`CommandResult`	`simpleFastbootCommand (long timeout, String[] fullCmd)` یک فرمان ساده fastboot را اجرا می کند و وضعیت فرمان را گزارش می کند.
`boolean`	`waitForDeviceNotAvailable (String operationDesc, long time)` منتظر بمانید تا دستگاه در دسترس نباشد (گزارش به adb را متوقف کنید).

ثابت ها

INVALID_USER_ID

public static final int INVALID_USER_ID

مقدار بازگشتی برای هر شناسه کاربری نامعتبر/یافتنی: UserHandle مقدار -10000 را تعریف کرد

مقدار ثابت: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

مقدار ثابت: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

تعداد پیش فرض دستور سعی مجدد برای انجام

مقدار ثابت: 2 (0x00000002)

فیلدها

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

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

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

یک TestDevice ایجاد می کند.

پارامترها
`device`	`IDevice` : `IDevice` مرتبط
`stateMonitor`	`IDeviceStateMonitor` : مکانیسم `IDeviceStateMonitor` برای استفاده
`allocationMonitor`	`IDeviceMonitor` : `IDeviceMonitor` برای اطلاع از تغییرات وضعیت تخصیص. می تواند پوچ باشد

روش های عمومی

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

بهینه‌سازی میکرو (حدود 400 میلی‌لیتر) با واکشی از قبل همه لوازم مورد نیاز ما به جای فراخوانی «adb getprop» برای هر یک. یعنی واکشی همه ویژگی ها به همان سرعتی است که واکشی یکی است. مواردی مانند device.getApiLevel()، checkApiLevelAgainstNextRelease و getBuildAlias همگی «adb getprop» را در زیر هود صدا می کنند. ما آنها را در یک تماس واکشی می کنیم و NativeDevice.setProperty را فرا می خوانیم. حتی اگر این کار را انجام ندهیم، NativeDevice خودش setProperty را فراخوانی می کند و نتیجه را برای تماس های بعدی کش می کند. ما فقط کمی زودتر این کار را انجام می دهیم. اگر دستگاه در حال بازیابی است یا خطاهای دیگری در واکشی لوازم وجود دارد، ما فقط آنها را نادیده می گیریم.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

برمی‌گرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر.

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

بررسی کنید که آیا یک ویژگی در حال حاضر با حداقل پشتیبانی پشتیبانی می شود یا خیر. این روش قبل از اینکه سطح API افزایش یابد، ویژگی‌های منتشر نشده را در نظر می‌گیرد.

پارامترها
`strictMinLevel`	`int` : حداقل حداقل سطح ممکن که از این ویژگی پشتیبانی می کند.

برمی گرداند
`boolean`	اگر سطح پشتیبانی شود درست است. در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

بررسی اتصال

public boolean checkConnectivity ()

بررسی کنید که دستگاه اتصال شبکه دارد.

برمی گرداند
`boolean`	`true` اگر دستگاه اتصال شبکه کار می کند، `false` .

پرتاب می کند
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید.

برمی گرداند
`boolean`	`true` اگر هیچ گفتگویی وجود نداشته باشد یا گفتگوها با موفقیت پاک شوند. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

آخرین شبکه وای فای متصل را پاک می کند. این باید هنگام شروع فراخوانی جدید برای جلوگیری از اتصال به شبکه وای فای مورد استفاده در آزمایش قبلی پس از راه‌اندازی مجدد دستگاه خوانده شود.

clearLogcat

public void clearLogcat ()

تمام داده های logcat انباشته شده را حذف می کند.

این برای مواردی مفید است که می‌خواهید مطمئن شوید ITestDevice.getLogcat() فقط داده‌های گزارش تولید شده پس از یک نقطه خاص (مانند فلش کردن یک دستگاه جدید و غیره) را برمی‌گرداند.

اتصال به شبکه Wifi

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

به شبکه وای فای متصل می شود.

وای فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز با یکی از شبکه های وای فای ارائه شده در نقشه wifiSsidToPsk برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice.disconnectFromWifi() یا ITestDevice.clearLastConnectedWifiNetwork() فراخوانی شود.

پارامترها
`wifiSsidToPsk`	: نقشه ای از SSID وای فای به گذرواژه ها.
`scanSsid`	`boolean` : آیا باید SSIDهای مخفی این شبکه را اسکن کرد یا خیر.

برمی گرداند
`boolean`	`true` اگر با موفقیت به شبکه وای فای متصل شوید. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

اتصال به شبکه Wifi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

به شبکه وای فای متصل می شود.

فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز به شبکه وای فای مشخص شده برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice.disconnectFromWifi() یا ITestDevice.clearLastConnectedWifiNetwork() فراخوانی شود.

پارامترها
`wifiSsid`	`String` : وای فای ssid برای اتصال
`wifiPsk`	`String` : عبارت عبور PSK یا اگر رمزگذاری نشده باشد، null است

برمی گرداند
`boolean`	`true` اگر با موفقیت به شبکه وای فای متصل شوید. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

اتصال به شبکه Wifi

public boolean connectToWifiNetwork ( wifiSsidToPsk)

به شبکه وای فای متصل می شود.

پارامترها
`wifiSsidToPsk`	: نقشه ای از SSID وای فای به گذرواژه ها.

برمی گرداند
`boolean`	`true` اگر با موفقیت به شبکه وای فای متصل شوید. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

اتصال به شبکه Wifi

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

به شبکه وای فای متصل می شود.

پارامترها
`wifiSsid`	`String` : وای فای ssid برای اتصال
`wifiPsk`	`String` : عبارت عبور PSK یا اگر رمزگذاری نشده باشد، null است
`scanSsid`	`boolean` : آیا باید SSID مخفی این شبکه را اسکن کرد.

برمی گرداند
`boolean`	`true` اگر با موفقیت به شبکه وای فای متصل شوید. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

گونه ای از connectToWifiNetwork(String, String) که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.

پارامترها
`scanSsid`	`boolean` : آیا باید SSID مخفی این شبکه را اسکن کرد

برمی گرداند
`boolean`	`true` اگر با موفقیت به شبکه وای فای متصل شوید. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

گونه ای از connectToWifiNetwork(String, String) که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.

برمی گرداند
`boolean`	`true` اگر با موفقیت به شبکه وای فای متصل شوید. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید

پارامترها
`name`	`String` : کاربر برای ایجاد در دستگاه
`guest`	`boolean` : فعال کردن پرچم کاربر --guest در حین ایجاد
`ephemeral`	`boolean` : در حین ایجاد، پرچم کاربر را فعال کنید

برمی گرداند
`int`	شناسه کاربر ایجاد شده

پرتاب می کند
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید

پارامترها
`name`	`String` : کاربر برای ایجاد در دستگاه
`guest`	`boolean` : فعال کردن پرچم کاربر --guest در حین ایجاد
`ephemeral`	`boolean` : در حین ایجاد، پرچم کاربر را فعال کنید
`forTesting`	`boolean` : پرچم تست --برای آزمایش در حین ایجاد را فعال کنید

برمی گرداند
`int`	شناسه کاربر ایجاد شده

پرتاب می کند
`DeviceNotAvailableException`

createUser

public int createUser (String name)

یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.

پارامترها
`name`	`String` : کاربر برای ایجاد در دستگاه

برمی گرداند
`int`	عدد صحیح برای شناسه کاربری ایجاد شده

پرتاب می کند
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.

پارامترها
`name`	`String` : کاربر برای ایجاد در دستگاه

برمی گرداند
`int`	عدد صحیح برای شناسه کاربر ایجاد شده یا -1 برای خطا.

پرتاب می کند
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

یک دستگاه را بازرسی کنید و وقتی دستگاهی در دسترس نیست، اطلاعات دقیق را برگردانید.

برمی گرداند
`DeviceInspectionResult`

حذف فایل

public void deleteFile (String deviceFilePath, 
                int userId)

روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه.

پارامترها
`deviceFilePath`	`String` : مسیر مطلق فایل روی دستگاه.
`userId`	`int` : شناسه کاربری که باید از آن حذف شود

پرتاب می کند
`DeviceNotAvailableException`

حذف فایل

public void deleteFile (String deviceFilePath)

روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه.

پارامترها
`deviceFilePath`	`String` : مسیر مطلق فایل روی دستگاه.

پرتاب می کند
`DeviceNotAvailableException`

لغو ثبت DeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

IDeviceActionReceiver ثبت شده را حذف می کند.

پارامترها
`deviceActionReceiver`	`IDeviceActionReceiver` : یک `IDeviceActionReceiver` که حذف خواهد شد.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

روش کمکی برای بررسی اینکه آیا دستگاه با مقایسه system_server فعلی با system_server ProcessInfo قبلی، نرم‌افزار راه‌اندازی شده است یا خیر. برای دریافت ProcessInfo getProcessByName(String) استفاده کنید.

پارامترها
`prevSystemServerProcess`	`ProcessInfo` : فرآیند system_server قبلی `ProcessInfo` .

برمی گرداند
`boolean`	`true` اگر دستگاه به صورت نرم راه اندازی شود

پرتاب می کند
`DeviceNotAvailableException`

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

روش کمکی برای بررسی اینکه آیا دستگاه از زمان UTC از دوره زمانی از دستگاه و ERROR(/TimeUnit) نرم‌افزار راه‌اندازی شده است یا خیر. Soft-Restart به system_server اشاره دارد که خارج از راه‌اندازی مجدد سخت دستگاه (برای مثال: راه‌اندازی مجدد درخواستی) مجدداً راه‌اندازی شده است. دستگاه فعلی utcEpochTime در میلی ثانیه را می توان با روش getDeviceDate() بدست آورد.

پارامترها
`utcEpochTime`	`long` : زمان دستگاه در ثانیه از زمان.
`timeUnit`	`TimeUnit` : واحد زمان `TimeUnit` برای utcEpochTime داده شده.

برمی گرداند
`boolean`	`true` اگر دستگاه به صورت نرم راه اندازی شود

پرتاب می کند
`DeviceNotAvailableException`

غیرفعال کردن AdbRoot

public boolean disableAdbRoot ()

ریشه adb را خاموش می کند.

غیرفعال کردن ریشه adb ممکن است باعث قطع ارتباط دستگاه با adb شود. این روش تا زمانی که دستگاه در دسترس نباشد مسدود خواهد شد.

برمی گرداند
`boolean`	در صورت موفقیت `true`

پرتاب می کند
`DeviceNotAvailableException`

غیرفعال کردن کیگارد

public void disableKeyguard ()

تلاش برای غیرفعال کردن محافظ صفحه کلید.

ابتدا منتظر بمانید تا ارسال ورودی آماده شود، این تقریباً همزمان با گزارش دستگاه BOOT_COMPLETE، ظاهراً ناهمزمان، اتفاق می‌افتد، زیرا پیاده‌سازی چارچوب فعلی دارای شرایط مسابقه گاه به گاه است. سپس دستور رد کردن صفحه کلید ارسال می شود (فقط روی موارد غیر ایمن کار می کند)

پرتاب می کند
`DeviceNotAvailableException`

شبکه مانیتور را غیرفعال کنید

public boolean disableNetworkMonitor ()

مانیتورینگ شبکه را در دستگاه غیرفعال می کند.

برمی گرداند
`boolean`	`true` اگر نظارت با موفقیت غیرفعال شود. `false` اگر شکست خورد

پرتاب می کند
`DeviceNotAvailableException`

قطع اتصال از وای فای

public boolean disconnectFromWifi ()

از شبکه وای فای قطع می شود.

تمام شبکه ها را از لیست شبکه های شناخته شده حذف می کند و وای فای را غیرفعال می کند.

برمی گرداند
`boolean`	`true` اگر با موفقیت از شبکه وای فای قطع شود. `false` اگر قطع اتصال انجام نشد.

پرتاب می کند
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر.

پارامترها
`deviceFilePath`	`String` : مسیر مطلق فایل روی دستگاه برای بررسی
`userId`	`int` : شناسه کاربری که وجود فایل را با آن بررسی کنید

برمی گرداند
`boolean`	`true` در صورت وجود فایل، `false` در غیر این صورت.

پرتاب می کند
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

برمی گرداند
`boolean`	`true` در صورت وجود فایل، `false` در غیر این صورت.

پرتاب می کند
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

سعی کنید پشته را از system_server تخلیه کنید. این وظیفه تماس گیرنده است که فایل تخلیه شده را پاک کند.

پارامترها
`process`	`String` : نام فرآیند دستگاهی که باید روی آن تخلیه شود.
`devicePath`	`String` : مسیر روی دستگاه که در آن روگرفت را قرار دهید. این باید مکانی باشد که مجوزها اجازه آن را می دهند.

برمی گرداند
`File`	`ERROR(/File)` حاوی گزارش. اگر چیزی شکست خورده است.

پرتاب می کند
`DeviceNotAvailableException`

فعال کردن AdbRoot

public boolean enableAdbRoot ()

ریشه adb را روشن می کند. اگر تنظیم "enable-root" "false" باشد، پیامی را ثبت می کند و بدون فعال کردن root باز می گردد.

فعال کردن ریشه adb ممکن است باعث قطع ارتباط دستگاه با adb شود. این روش تا زمانی که دستگاه در دسترس نباشد مسدود خواهد شد.

برمی گرداند
`boolean`	در صورت موفقیت `true`

پرتاب می کند
`DeviceNotAvailableException`

مانیتور شبکه را فعال کنید

public boolean enableNetworkMonitor ()

نظارت بر شبکه را بر روی دستگاه فعال می کند.

برمی گرداند
`boolean`	`true` اگر نظارت با موفقیت فعال شود. `false` اگر شکست خورد

پرتاب می کند
`DeviceNotAvailableException`

دستور Adb را اجرا کنید

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند.

executeShellCommand(String) باید هر جا که امکان دارد استفاده شود، زیرا آن روش تشخیص خرابی و عملکرد بهتری را ارائه می دهد.

پارامترها
`timeout`	`long` : زمان بر حسب میلی ثانیه قبل از اینکه دستگاه پاسخگو نباشد، 0 لیتر بدون وقفه
`cmdArgs`	`String` : دستور adb و آرگومان هایی که باید اجرا شوند

برمی گرداند
`String`	stdout از دستور. اگر دستور اجرا نشد `null` .

پرتاب می کند
`DeviceNotAvailableException`

دستور Adb را اجرا کنید

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند.

executeShellCommand(String) باید هر جا که امکان دارد استفاده شود، زیرا آن روش تشخیص خرابی و عملکرد بهتری را ارائه می دهد.

پارامترها
`timeout`	`long` : زمان بر حسب میلی ثانیه قبل از اینکه دستگاه پاسخگو نباشد، 0 لیتر بدون وقفه
`envMap`	: محیطی برای تنظیم دستور
`cmdArgs`	`String` : دستور adb و آرگومان هایی که باید اجرا شوند

برمی گرداند
`String`	stdout از دستور. اگر دستور اجرا نشد `null` .

پرتاب می کند
`DeviceNotAvailableException`

دستور Adb را اجرا کنید

public String executeAdbCommand (String... cmdArgs)

متد Helper که دستور adb را به عنوان دستور سیستم اجرا می کند.

executeShellCommand(String) باید هر جا که امکان دارد استفاده شود، زیرا آن روش تشخیص خرابی و عملکرد بهتری را ارائه می دهد.

پارامترها
`cmdArgs`	`String` : دستور adb و آرگومان هایی که باید اجرا شوند

برمی گرداند
`String`	stdout از دستور. اگر دستور اجرا نشد `null` .

پرتاب می کند
`DeviceNotAvailableException`

دستور Fastboot Command را اجرا کنید

public CommandResult executeFastbootCommand (String... cmdArgs)

روش Helper که یک فرمان fastboot را به عنوان یک فرمان سیستم با زمان پیش فرض 2 دقیقه اجرا می کند.

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

پارامترها
`cmdArgs`	`String` : دستور fastboot و آرگومان هایی که باید اجرا شوند

برمی گرداند
`CommandResult`	CommandResult حاوی خروجی فرمان است

پرتاب می کند
`DeviceNotAvailableException`

دستور Fastboot Command را اجرا کنید

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

متد Helper که دستور fastboot را به عنوان دستور سیستم اجرا می کند.

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

پارامترها
`timeout`	`long` : زمان بر حسب میلی ثانیه قبل از انقضای فرمان
`cmdArgs`	`String` : دستور fastboot و آرگومان هایی که باید اجرا شوند

برمی گرداند
`CommandResult`	CommandResult حاوی خروجی فرمان است

پرتاب می کند
`DeviceNotAvailableException`

اجرایLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

متد Helper که یک فرمان طولانی در حال اجرا fastboot را به عنوان فرمان سیستم اجرا می کند.

با executeFastbootCommand(String) یکسان است، به جز اینکه از زمان طولانی تری استفاده می کند.

پارامترها
`cmdArgs`	`String` : دستور fastboot و آرگومان هایی که باید اجرا شوند

برمی گرداند
`CommandResult`	CommandResult حاوی خروجی فرمان است

پرتاب می کند
`DeviceNotAvailableException`

اجرایLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

روش کمکی که یک فرمان طولانی در حال اجرا سریع بوت را به عنوان فرمان سیستم با متغیرهای محیط سیستم اجرا می کند.

با executeFastbootCommand(String) یکسان است، به جز اینکه از زمان طولانی تری استفاده می کند.

پارامترها
`envVarMap`	: متغیرهای محیطی سیستم که دستور fastboot با آنها اجرا می شود
`cmdArgs`	`String` : دستور fastboot و آرگومان هایی که باید اجرا شوند

برمی گرداند
`CommandResult`	CommandResult حاوی خروجی فرمان است

پرتاب می کند
`DeviceNotAvailableException`

ShellCommand را اجرا کنید

public String executeShellCommand (String command)

متد Helper که یک دستور adb shell را اجرا می کند و خروجی را به صورت String برمی گرداند.

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

برمی گرداند
`String`	خروجی پوسته

پرتاب می کند
`DeviceNotAvailableException`

ShellCommand را اجرا کنید

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.

پارامترها
`command`	`String` : دستور adb shell برای اجرا
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` برای هدایت خروجی پوسته به آن.
`maxTimeToOutputShellResponse`	`long` : حداکثر مدت زمانی که فرمان مجاز است هیچ پاسخی صادر نکند. واحد همانطور که در `timeUnit` مشخص شده است
`timeUnit`	`TimeUnit` : واحد برای `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر `retryAttempts` بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

پرتاب می کند
`DeviceNotAvailableException`

ShellCommand را اجرا کنید

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.

پارامترها
`command`	`String` : دستور adb shell برای اجرا
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` برای هدایت خروجی پوسته به آن.
`maxTimeoutForCommand`	`long` : حداکثر زمان برای تکمیل دستور. واحد همانطور که در `timeUnit` مشخص شده است
`maxTimeToOutputShellResponse`	`long` : حداکثر مدت زمانی که فرمان مجاز است هیچ پاسخی صادر نکند. واحد همانطور که در `timeUnit` مشخص شده است
`timeUnit`	`TimeUnit` : واحد برای `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر `retryAttempts` بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

پرتاب می کند
`DeviceNotAvailableException`

ShellCommand را اجرا کنید

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

دستور adb shell داده شده را اجرا می کند و در صورت شکست دستور چندین بار دوباره امتحان می کند.

شکل ساده‌تری از executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) با مقادیر پیش‌فرض.

پارامترها
`command`	`String` : دستور adb shell برای اجرا
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` برای هدایت خروجی پوسته به آن.

پرتاب می کند
`DeviceNotAvailableException`

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd)

متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت CommandResult با خروجی وضعیت فرمان، stdout و stderr به درستی پر می کند.

پارامترها
`cmd`	`String` : دستوری که باید اجرا شود.

برمی گرداند
`CommandResult`	نتیجه در `CommandResult` .

پرتاب می کند
`DeviceNotAvailableException`

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت CommandResult که به درستی با خروجی وضعیت فرمان و stderr پر شده است برمی گرداند. stdout به جریان مشخص شده هدایت می شود.

پارامترها
`cmd`	`String` : دستوری که باید اجرا شود.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` که در آن خروجی std تغییر مسیر داده می‌شود یا تهی می‌شود.

برمی گرداند
`CommandResult`	نتیجه در `CommandResult` .

پرتاب می کند
`DeviceNotAvailableException`

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

پارامترها
`cmd`	`String` : دستوری که باید اجرا شود.
`pipeAsInput`	`File` : یک `ERROR(/File)` که به عنوان ورودی دستور یا null ارسال می شود.

برمی گرداند
`CommandResult`	نتیجه در `CommandResult` .

پرتاب می کند
`DeviceNotAvailableException`

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.

پارامترها
`cmd`	`String` : دستور adb shell برای اجرا
`maxTimeoutForCommand`	`long` : حداکثر زمان برای تکمیل دستور. واحد همانطور که در `timeUnit` مشخص شده است
`timeUnit`	`TimeUnit` : واحد برای `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر `retryAttempts` بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

برمی گرداند
`CommandResult`

پرتاب می کند
`DeviceNotAvailableException`

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.

پارامترها
`cmd`	`String` : دستور adb shell برای اجرا
`maxTimeoutForCommand`	`long` : حداکثر زمان برای تکمیل دستور. واحد همانطور که در `timeUnit` مشخص شده است
`timeUnit`	`TimeUnit` : واحد برای `maxTimeToOutputShellResponse`

برمی گرداند
`CommandResult`

پرتاب می کند
`DeviceNotAvailableException`

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.

پارامترها
`cmd`	`String` : دستور adb shell برای اجرا
`pipeAsInput`	`File` : یک `ERROR(/File)` که به عنوان ورودی دستور یا null ارسال می شود.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` که در آن خروجی std تغییر مسیر داده می‌شود یا تهی می‌شود.
`maxTimeoutForCommand`	`long` : حداکثر زمان برای تکمیل دستور. واحد همانطور که در `timeUnit` مشخص شده است
`timeUnit`	`TimeUnit` : واحد برای `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر `retryAttempts` بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

برمی گرداند
`CommandResult`

پرتاب می کند
`DeviceNotAvailableException`

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.

پارامترها
`cmd`	`String` : دستور adb shell برای اجرا
`pipeAsInput`	`File` : یک `ERROR(/File)` که به عنوان ورودی دستور یا null ارسال می شود.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` که در آن خروجی std تغییر مسیر داده می‌شود یا تهی می‌شود.
`pipeToError`	`OutputStream` : `ERROR(/OutputStream)` که در آن خطای std تغییر مسیر داده می شود، یا null می شود.
`maxTimeoutForCommand`	`long` : حداکثر زمان برای تکمیل دستور. واحد همانطور که در `timeUnit` مشخص شده است
`timeUnit`	`TimeUnit` : واحد برای `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر `retryAttempts` بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

برمی گرداند
`CommandResult`

پرتاب می کند
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

اگر getUseFastbootErase() true باشد، از fastboot erase برای پاک کردن پارتیشن استفاده خواهد شد. سپس دستگاه باید در دفعه بعد که دستگاه بوت می شود یک سیستم فایل ایجاد کند. در غیر این صورت از فرمت fastboot استفاده می شود که یک فایل سیستم جدید در دستگاه ایجاد می کند.

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

پارامترها
`partition`	`String` : پارتیشنی که باید پاک شود

برمی گرداند
`CommandResult`	CommandResult حاوی خروجی فرمان است

پرتاب می کند
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

اطلاعات مربوط به APEX های فعال شده در دستگاه را واکشی کنید.

برمی گرداند
	`ERROR(/Set)` `ApexInfo` در حال حاضر در دستگاه فعال شده است

پرتاب می کند
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

جفت مقدار کلید فضای نام درخواستی را برگردانید.

پارامترها
`namespace`	`String` : باید یکی از {"system"، "secure"، "global"} باشد.

برمی گرداند
	نقشه جفت ارزش کلیدی اگر فضای نام پشتیبانی نشود، تهی است.

پرتاب می کند
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

وضعیت تخصیص فعلی دستگاه را برگردانید

برمی گرداند
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

شناسه android مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null.

پارامترها
`userId`	`int`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید. هیچ بیمه ای وجود ندارد که هر شناسه کاربری یک شناسه اندروید مرتبط با این تابع را پیدا کند، بنابراین برخی از شناسه های کاربر ممکن است با null مطابقت داشته باشند.

برمی گرداند
	نقشه شناسه های اندروید، شناسه های کاربر منطبق را پیدا کرد.

پرتاب می کند
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

سطح API دستگاه را دریافت کنید. پیش‌فرض UNKNOWN_API_LEVEL است.

برمی گرداند
`int`	یک عدد صحیح که سطح API دستگاه را نشان می دهد

پرتاب می کند
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

برمی گرداند
`PackageInfo`	`PackageInfo` یا در صورتی که اطلاعات قابل بازیابی نباشد، `null`

پرتاب می کند
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید.

برمی گرداند
	`ERROR(/List)` `PackageInfo` های نصب شده روی دستگاه.

پرتاب می کند
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

روش آسان برای دریافت نسخه بیس باند (رادیویی) این دستگاه. دریافت نسخه رادیویی مخصوص دستگاه است، بنابراین ممکن است اطلاعات صحیح را برای همه دستگاه‌ها برنگرداند. این روش برای بازگرداندن اطلاعات نسخه صحیح به ویژگی gsm.version.baseband متکی است. این برای برخی از دستگاه‌های CDMA دقیق نیست و نسخه بازگشتی در اینجا ممکن است با نسخه گزارش‌شده از fastboot مطابقت نداشته باشد و ممکن است نسخه را برای رادیو CDMA برگرداند. TL;DR این روش تنها در صورتی نسخه دقیق را گزارش می‌کند که ویژگی gsm.version.baseband با نسخه بازگردانده شده توسط fastboot getvar version-baseband یکسان باشد.

برمی گرداند
`String`	اگر نمی توان آن را تعیین کرد، نسخه باند پایه `String` یا `null` (دستگاه رادیو ندارد یا رشته نسخه قابل خواندن نیست)

پرتاب می کند
`DeviceNotAvailableException`

دریافت باتری

public Integer getBattery ()

سطح فعلی باتری یک دستگاه را برمی‌گرداند یا اگر سطح باتری در دسترس نباشد، Null را برمی‌گرداند.

برمی گرداند
`Integer`

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

مقدار بولی ویژگی داده شده را برمی گرداند.

پارامترها
`name`	`String` : نام ملک
`defaultValue`	`boolean` : مقدار پیش‌فرض برای بازگشت در صورت خالی بودن یا نبودن ویژگی.

برمی گرداند
`boolean`	اگر ویژگی دارای مقدار `"1"` ، `"y"` ، `"yes"` ، `"on"` یا `"true"` `true` ، اگر ویژگی دارای مقدار `"0"` ، `"n"` ، `"no"` ، `"off"` ، `"false"` یا `defaultValue` باشد، `false` .

پرتاب می کند
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

روش Helper نقشه تاریخچه بوت را با زمان بوت و دلیل بوت جمع آوری می کند.

برمی گرداند
	نقشه زمان راه‌اندازی (زمان UTC در ثانیه از زمان Epoch) و دلیل راه‌اندازی

پرتاب می کند
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

روش Helper نقشه تاریخچه راه‌اندازی را با زمان بوت و دلیل راه‌اندازی از زمان معین از دوره زمانی از دستگاه و واحد زمانی مشخص شده جمع‌آوری می‌کند. دستگاه فعلی utcEpochTime در میلی ثانیه را می توان با روش getDeviceDate() بدست آورد.

پارامترها
`utcEpochTime`	`long` : زمان دستگاه از زمان.
`timeUnit`	`TimeUnit` : واحد زمان `TimeUnit` .

برمی گرداند
	نقشه زمان راه‌اندازی (زمان UTC در ثانیه از زمان Epoch) و دلیل راه‌اندازی

پرتاب می کند
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

روش راحت برای دریافت نسخه بوت لودر این دستگاه.

سعی خواهد کرد نسخه بوت لودر را از وضعیت فعلی دستگاه بازیابی کند. (یعنی اگر دستگاه در حالت فست بوت باشد، سعی می کند نسخه را از فست بوت بازیابی کند)

برمی گرداند
`String`	نسخه بوت لودر `String` یا در صورتی که پیدا نشد `null`

پرتاب می کند
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

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

اجرای این برای ادامه کار بر روی دستگاهی بدون sdcard (یا جایی که sdcard هنوز نصب نشده است) تضمین شده است.

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` که محتویات گزارش اشکال را در صورت تقاضا تولید می کند. در صورت خرابی، `InputStreamSource` یک `ERROR(/InputStream)` خالی تولید می کند.

getBugreportz

public InputStreamSource getBugreportz ()

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

فقط برای «نسخه adb» > 1.0.36 پشتیبانی می شود

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از فایل فشرده حاوی bugreportz، در صورت خرابی، null را برگردانید.

getBuildAlias

public String getBuildAlias ()

نام مستعار بیلدی که دستگاه در حال حاضر در حال اجرا است را بازیابی کنید.

نام مستعار Build معمولاً یک رشته خواناتر از build id است (معمولاً یک عدد برای ساخت‌های Nexus). به عنوان مثال، نسخه نهایی اندروید 4.2 دارای بیلد نام مستعار JDQ39 و شناسه ساخت 573038 است.

برمی گرداند
`String`	نام مستعار ساخت یا بازگشت به شناسه ساخت در صورتی که بازیابی نشد

پرتاب می کند
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

طعم ساخت دستگاه را بازیابی کنید.

برمی گرداند
`String`	طعم ساخت یا در صورتی که قابل بازیابی نباشد پوچ است

پرتاب می کند
`DeviceNotAvailableException`

getBuildId

public String getBuildId ()

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

برمی گرداند
`String`	شناسه ساخت یا `IBuildInfo.UNKNOWN_BUILD_ID` اگر بازیابی نشد

پرتاب می کند
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

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

معمولاً دستگاه‌های Android ممکن است با کلیدهای آزمایشی (مانند AOSP) یا کلیدهای انتشار (که توسط سازنده‌های دستگاه کنترل می‌شوند) امضا شوند.

برمی گرداند
`String`	اگر کلید امضا پیدا شد، در غیر این صورت باطل می شود.

پرتاب می کند
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

اگر دستگاه اختصاص داده شده باشد، DeviceDescriptor ذخیره شده را برمی‌گرداند، در غیر این صورت DeviceDescriptor فعلی را برمی‌گرداند.

برمی گرداند
`DeviceDescriptor`

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

پارامترها
`shortDescriptor`	`boolean` : اینکه آیا توصیفگر را به حداقل اطلاعات محدود کند یا نه

برمی گرداند
`DeviceDescriptor`

بچه ها بگیر

public String[] getChildren (String path)

جایگزینی برای استفاده از IFileEntry که گاهی اوقات به دلیل مجوزها کار نمی کند.

پارامترها
`path`	`String` : مسیری است که در دستگاه باید جستجو را انجام داد

برمی گرداند
`String[]`	آرایه ای از رشته حاوی تمام فایل در یک مسیر در دستگاه.

پرتاب می کند
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

اتصال فعلی مرتبط با دستگاه.

برمی گرداند
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

ContentProviderHandler را برمی گرداند یا اگر در دسترس نباشد، آن را خالی می کند.

اگر ارائه‌دهنده محتوا قبلاً با همان userId ساخته شده باشد، می‌توان دوباره از آن استفاده کرد.

پارامترها
`userId`	`int` : شناسه کاربری برای مقداردهی اولیه ارائه دهنده محتوا.

برمی گرداند
`ContentProviderHandler`

پرتاب می کند
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

برمی گرداند
`DeviceFoldableState`

پرتاب می کند
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

شناسه کاربر فعلی را برگردانید. در صورت بروز خطا 10000- را برگردانید.

برمی گرداند
`int`

پرتاب می کند
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

کلاس دستگاه را دریافت کنید.

برمی گرداند
`String`	کلاس دستگاه `String`

getDeviceDate

public long getDeviceDate ()

تاریخ دستگاه را بر حسب میلی‌ثانیه از آن دوره برگردانید.

برمی گرداند
`long`	تاریخ دستگاه در قالب دوره ای.

پرتاب می کند
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

یک DeviceDescriptor از اطلاعات دستگاه برگردانید تا اطلاعات مربوط به آن را بدون عبور از شی دستگاه واقعی دریافت کنید.

برمی گرداند
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

یک DeviceDescriptor از اطلاعات دستگاه برگردانید تا اطلاعات مربوط به آن را بدون عبور از شی دستگاه واقعی دریافت کنید.

پارامترها
`shortDescriptor`	`boolean` : اینکه آیا توصیفگر را به حداقل اطلاعات محدود کند یا نه

برمی گرداند
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

وضعیت دستگاه را دریافت کنید.

برمی گرداند
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

کمک کننده برای دریافت تفاوت زمانی بین دستگاه و یک ERROR(/Date) داده شده. از زمان Epoch به صورت داخلی استفاده کنید.

پارامترها
`date`	`Date`

برمی گرداند
`long`	تفاوت در میلی ثانیه

پرتاب می کند
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

جریان شبیه ساز stdout و stderr را دریافت کنید

برمی گرداند
`InputStreamSource`	خروجی شبیه ساز

getEmulatorProcess

public Process getEmulatorProcess ()

Process مربوط به این شبیه ساز را برگردانید.

برمی گرداند
`Process`	`Process` یا `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

گزارشی که شامل تمام گزارش‌های executeShellCommand(String) است.

برمی گرداند
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

روش کمکی برای تعیین میزان فضای خالی در حافظه خارجی دستگاه.

برمی گرداند
`long`	مقدار فضای خالی در کیلوبایت

پرتاب می کند
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

مسیر باینری fastboot مورد استفاده را برمی گرداند. هنوز هم نیاز دارد که isFastbootEnabled() درست باشد، تا توابع fastboot فعال باشند.

برمی گرداند
`String`

getFastbootProductType

public String getFastbootProductType ()

روشی راحت برای دریافت نوع محصول این دستگاه در حالت فست بوت.

این روش فقط در صورتی باید استفاده شود که دستگاه باید در فست بوت باشد. در این مورد، نوع آن کمی ایمن‌تر از متد getProductType() عمومی است، زیرا ITestDevice می‌داند که اگر دستگاه در وضعیت نادرست باشد یا پاسخگو نباشد، دستگاه را در فست‌بوت بازیابی کند.

برمی گرداند
`String`	نام نوع محصول `String` یا اگر قابل تعیین نباشد، `null`

پرتاب می کند
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

روشی راحت برای دریافت نوع محصول این دستگاه در حالت فست بوت.

برمی گرداند
`String`	نام نوع محصول `String` یا اگر قابل تعیین نباشد، `null`

پرتاب می کند
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

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

برمی گرداند
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

مقدار متغیر fastboot داده شده را از دستگاه بازیابی کنید.

پارامترها
`variableName`	`String` : نام متغیر

برمی گرداند
`String`	مقدار خاصیت یا در صورت عدم وجود آن `null`

پرتاب می کند
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

رشته نسخه باینری fastboot مورد استفاده را برمی گرداند. یا اگر مشکلی پیش بیاید باطل می شود.

برمی گرداند
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

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

پارامترها
`path`	`String` : مسیر فایل برای بازیابی. می تواند یک مسیر یا مسیر مطلق نسبت به '/' باشد. (یعنی هر دو دستور "/system" و "system" پشتیبانی می شوند)

برمی گرداند
`IFileEntry`	`IFileEntry` یا `null` اگر فایل در `path` داده شده یافت نشد

پرتاب می کند
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

کمک کننده غیر رسمی برای دریافت FileEntry از مسیر غیر ریشه. FIXME: سیستم FileEntry را مجدداً فاکتور کنید تا از هر مسیری در دسترس باشد. (حتی غیر ریشه).

پارامترها
`entry`	`FileListingService.FileEntry` : یک `FileEntry` لزوماً آنطور که Ddmlib نیاز دارد روت نمی کند.

برمی گرداند
`IFileEntry`	یک FileEntryWrapper که نمایانگر FileEntry است.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getFoldableStates

public  getFoldableStates ()

لیست حالت های تاشو را در دستگاه برمی گرداند. می توان با "cmd device_state print-states" به دست آورد.

برمی گرداند

پرتاب می کند
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

یک ارجاع به IDevice ddmlib مرتبط را برمی‌گرداند.

هر بار که دستگاه از adb جدا می شود و مجدداً وصل می شود، ممکن است یک IDevice جدید توسط DDMS اختصاص داده شود. بنابراین تماس گیرندگان نباید یک مرجع به IDevice نگه دارند، زیرا ممکن است آن مرجع قدیمی شود.

برمی گرداند
`IDevice`	`IDevice`

getInstalledPackageNames

public  getInstalledPackageNames ()

نام بسته های برنامه موجود در دستگاه را واکشی کنید.

برمی گرداند
	`ERROR(/Set)` نام‌های بسته `String` که در حال حاضر روی دستگاه نصب شده‌اند.

پرتاب می کند
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

مقدار صحیح ویژگی داده شده را از دستگاه برمی‌گرداند.

پارامترها
`name`	`String` : نام ملک
`defaultValue`	`long` : مقدار پیش فرض برای بازگشت در صورت خالی بودن یا نبودن ویژگی.

برمی گرداند
`long`	اگر ویژگی خالی باشد، وجود نداشته باشد یا مقدار صحیح نداشته باشد، مقدار ویژگی یا `defaultValue` .

پرتاب می کند
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

آدرس IP دستگاه را دریافت می کند.

برمی گرداند
`String`	آدرس IP دستگاه، یا اگر دستگاه آدرس IP نداشته باشد، `null`

پرتاب می کند
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید.

برمی گرداند
`KeyguardControllerState`	یک `KeyguardControllerState` که حاوی یک عکس فوری از وضعیت نگهدارنده کلید است و در صورت عدم پشتیبانی از پرس و جوی Keyguard، Null را برمی گرداند.

پرتاب می کند
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

آخرین باری را که APIهای Tradefed راه‌اندازی مجدد را در میلی‌ثانیه از زمان EPOCH راه‌اندازی کردند، برمی‌گرداند که توسط System.currentTimeMillis() بازگردانده شده است.

برمی گرداند
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

اولین سطح API راه اندازی شده دستگاه را دریافت کنید. پیش‌فرض UNKNOWN_API_LEVEL است.

برمی گرداند
`int`	یک عدد صحیح که نشان دهنده اولین سطح API راه اندازی شده دستگاه است

پرتاب می کند
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

یک جریان عکس فوری از داده های logcat را می گیرد.

در دو حالت کار می کند:

اگر logcat در حال حاضر در پس‌زمینه ضبط می‌شود، تا بایت‌های TestDeviceOptions.getMaxLogcatDataSize() از محتویات فعلی ضبط logcat پس‌زمینه برمی‌گردد.

در غیر این صورت، اگر دستگاه در حال حاضر پاسخ می‌دهد، داده‌های logcat را بازگرداند

برمی گرداند
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

یک جریان عکس فوری از آخرین maxBytes داده logcat گرفته شده را می گیرد.

برای مواردی مفید است که می‌خواهید عکس‌های فوری مکرری از داده‌های logcat گرفته‌شده بگیرید، بدون اینکه جریمه فضای دیسک بالقوه بزرگی برای گرفتن کل عکس فوری getLogcat() متحمل شوید.

پارامترها
`maxBytes`	`int` : حداکثر مقدار داده برای بازگشت. باید مقداری باشد که به راحتی در حافظه جا شود

برمی گرداند
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

یک روگرفت از logcat فعلی برای دستگاه دریافت کنید. برخلاف getLogcat() ، این متد همیشه یک dump ایستا از logcat را برمی گرداند.

این عیب را دارد که اگر دستگاه در دسترس نباشد، هیچ چیز برگردانده نخواهد شد.

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از داده های logcat. اگر نتواند داده های logcat را بگیرد، یک جریان خالی برگردانده می شود.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

یک جریان عکس فوری از داده‌های logcat گرفته شده را با شروع تاریخ ارائه شده می‌گیرد. زمان روی دستگاه باید از getDeviceDate() استفاده شود.

پارامترها
`date`	`long` : در قالب میلی ثانیه از زمان شروع عکس فوری تا زمان حال. (با استفاده از "تاریخ +%s" قابل دریافت است)

برمی گرداند
`InputStreamSource`

دریافت مک آدرس

public String getMacAddress ()

آدرس MAC دستگاه را برمی‌گرداند، در صورت عدم درخواست از دستگاه، باطل می‌شود.

برمی گرداند
`String`

getMainUserId

public Integer getMainUserId ()

شناسه اصلی کاربر را برمی گرداند.

برمی گرداند
`Integer`	شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد null.

پرتاب می کند
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید.

برمی گرداند
	`ERROR(/Set)` ماژول های خط اصلی `String` که در حال حاضر روی دستگاه نصب شده اند.

پرتاب می کند
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید. پیش فرض 0 است.

برمی گرداند
`int`	یک عدد صحیح که تعداد کاربرانی که به طور همزمان در حال اجرا هستند را نشان می دهد

پرتاب می کند
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. پیش فرض 0 است.

برمی گرداند
`int`	یک عدد صحیح که تعداد کاربران پشتیبانی شده را نشان می دهد

پرتاب می کند
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

برمی گرداند
`Process`	فرآیند Microdroid VM را برمی‌گرداند. اگر TestDevice یک Microdroid نباشد، null را برمی‌گرداند.

getMonitor

public IDeviceStateMonitor getMonitor ()

IDeviceStateMonitor مرتبط با دستگاه را برگردانید.

برمی گرداند
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

نقطه اتصال را برمی‌گرداند.

اگر اطلاعات ذخیره‌شده در IDevice در دسترس نباشد، مستقیماً از دستگاه سؤال می‌کند.

TODO: این رفتار را به IDevice.getMountPoint(String) منتقل کنید

پارامترها
`mountName`	`String` : نام نقطه نصب

برمی گرداند
`String`	نقطه نصب یا `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

MountPointInfo مربوط به مسیر mountpoint مشخص شده را برمی‌گرداند، یا اگر آن مسیر چیزی نصب نشده باشد یا به‌طور دیگری در /proc/mounts به‌عنوان یک نقطه mount ظاهر نشود، null را برمی‌گرداند.

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

برمی گرداند
`ITestDevice.MountPointInfo`	`ERROR(/List)` `MountPointInfo` حاوی اطلاعات در "/proc/mounts"

پرتاب می کند
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

یک نسخه تجزیه شده از اطلاعات موجود در /proc/mounts در دستگاه را برمی گرداند

برمی گرداند
	`ERROR(/List)` `MountPointInfo` حاوی اطلاعات در "/proc/mounts"

پرتاب می کند
`DeviceNotAvailableException`

getOptions

public TestDeviceOptions getOptions ()

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

برمی گرداند
`TestDeviceOptions`	`TestDeviceOptions` مربوط به دستگاه تحت آزمایش.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

روش کمکی برای تعیین مقدار فضای خالی در پارتیشن دستگاه.

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

برمی گرداند
`long`	مقدار فضای خالی در کیلوبایت

پرتاب می کند
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

شناسه کاربر اصلی را برمی گرداند.

برمی گرداند
`Integer`	شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد، null.

پرتاب می کند
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

متد Helper دستور "pidof" و "stat" را اجرا می کند و شی ProcessInfo با PID و زمان شروع فرآیند پردازش داده شده برمی گرداند.

پارامترها
`processName`	`String` : نام فرآیند String.

برمی گرداند
`ProcessInfo`	ProcessInfo مربوط به processName داده شده

پرتاب می کند
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

اگر مشکلی پیش آمده باشد، پید سرویس را برمی‌گرداند یا نول می‌کند.

پارامترها
`process`	`String` : نام فرآیند String.

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

getProductType

public String getProductType ()

روش راحت برای دریافت نوع محصول این دستگاه.

اگر دستگاه در حالت adb یا fastboot باشد، این روش کار خواهد کرد.

برمی گرداند
`String`	نام نوع محصول `String` پوچ نخواهد بود

پرتاب می کند
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

روش راحت برای دریافت نوع محصول این دستگاه.

اگر دستگاه در حالت adb یا fastboot باشد، این روش کار خواهد کرد.

برمی گرداند
`String`	نام نوع محصول `String` یا اگر قابل تعیین نباشد، `null`

پرتاب می کند
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

مقدار مشخصه داده شده را از دستگاه بازیابی کنید.

پارامترها
`name`	`String` : نام ملک

برمی گرداند
`String`	مقدار خاصیت یا در صورت عدم وجود آن `null`

پرتاب می کند
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

حالت بازیابی فعلی مورد استفاده برای دستگاه را دریافت کنید.

برمی گرداند
`ITestDevice.RecoveryMode`	حالت بازیابی فعلی مورد استفاده برای دستگاه.

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

public InputStreamSource getScreenshot (long displayId)

یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد. فرمت PNG است.

TODO: پیاده سازی های بالا را برای پشتیبانی از "قالب" و "مقیاس مجدد" گسترش دهید

پارامترها
`displayId`	`long` : شناسه نمایش صفحه برای گرفتن اسکرین شات از آن.

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات `null` .

پرتاب می کند
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot (String format)

یک اسکرین شات از دستگاه می گیرد. توصیه می شود برای اندازه کوچکتر از getScreenshot (فرمت) به جای کدگذاری JPEG استفاده کنید

پارامترها
`format`	`String` : پشتیبانی از PNG، JPEG

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات `null` .

پرتاب می کند
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

یک اسکرین شات از دستگاه می گیرد. توصیه می شود به جای آن از getScreenshot(String) با رمزگذاری JPEG برای اندازه کوچکتر استفاده کنید.

پارامترها
`format`	`String` : پشتیبانی از PNG، JPEG
`rescale`	`boolean` : اگر اسکرین شات باید تغییر مقیاس داده شود تا اندازه تصویر حاصل کاهش یابد

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات `null` .

پرتاب می کند
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot ()

یک اسکرین شات از دستگاه می گیرد.

برمی گرداند
`InputStreamSource`	یک `InputStreamSource` از اسکرین شات با فرمت png یا در صورت عدم موفقیت اسکرین شات `null` .

پرتاب می کند
`DeviceNotAvailableException`

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

public String getSerialNumber ()

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

برمی گرداند
`String`	شماره سریال `String`

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

مقدار تنظیمات درخواستی را برگردانید. فضای نام باید یکی از موارد زیر باشد: {"system", "secure", "global"}

پارامترها
`userId`	`int`
`namespace`	`String`
`key`	`String`

برمی گرداند
`String`	مقدار مربوط به فضای نام: کلید یک کاربر. اگر پیدا نشد، پوچ است.

پرتاب می کند
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

getSetting(int, String, String) ببینید و روی کاربر سیستم انجام شود.

پارامترها
`namespace`	`String`
`key`	`String`

برمی گرداند
`String`

پرتاب می کند
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

اپراتور سیم کارت را برگردانید یا اگر در دسترس نیست یا دستگاه در دسترس نیست، آن را خالی کنید.

برمی گرداند
`String`

getSimState

public String getSimState ()

وضعیت سیم کارت را برگردانید یا اگر در دسترس نیست یا دستگاه در دسترس نیست، آن را خالی کنید.

برمی گرداند
`String`

گرفتن سنگ قبر

public  getTombstones ()

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

روش بهترین تلاش است، بنابراین اگر یک سنگ قبر به هر دلیلی کشیده نشود، در لیست گم می شود. فقط یک DeviceNotAvailableException این روش را زودتر خاتمه می دهد.

برمی گرداند
	لیستی از فایل های سنگ قبر، در صورت عدم وجود سنگ قبر خالی.

پرتاب می کند
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

حجم کل حافظه فیزیکی را بر حسب بایت یا -1 را در صورت خطای داخلی برمی گرداند

برمی گرداند
`long`

getTrackingSerial

public String getTrackingSerial ()

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

برمی گرداند
`String`

getUninstalablePackageNames

public  getUninstallablePackageNames ()

نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید. این در حال حاضر به عنوان بسته های غیر سیستمی و بسته های سیستمی به روز شده تعریف می شود.

برمی گرداند
	`ERROR(/Set)` نام‌های بسته `String` غیرقابل نصب که در حال حاضر روی دستگاه نصب شده‌اند.

پرتاب می کند
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

برای پاک کردن پارتیشن روی دستگاه از فرمت fastboot erase یا fastboot استفاده کنید.

برمی گرداند
`boolean`	`true` اگر از fastboot erase استفاده شود یا `false` اگر از فرمت fastboot استفاده شود.

getUserFlags

public int getUserFlags (int userId)

پرچم های یک کاربر معین را پیدا کرده و برگردانید. پرچم‌ها در کلاس «android.content.pm.UserInfo» در پروژه منبع باز Android تعریف شده‌اند.

پارامترها
`userId`	`int`

برمی گرداند
`int`	پرچم های مرتبط با userId ارائه شده در صورت یافتن، -10000 در هر مورد دیگر.

پرتاب می کند
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

نقشه useId به UserInfo را در دستگاه دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException پرتاب می کند.

برمی گرداند
	لیست اشیاء UserInfo

پرتاب می کند
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

در صورت یافتن شماره سریال مرتبط به userId، در هر مورد دیگر -10000 را برگردانید.

پارامترها
`userId`	`int`

برمی گرداند
`int`

پرتاب می کند
`DeviceNotAvailableException`

handleAlocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

DeviceEvent داده شده را پردازش کنید. ممکن است دستگاه به حالت جدید انتقال یابد. IDeviceMonitor از هرگونه انتقال وضعیت مطلع می کند.

DeviceEvent را پردازش کنید، که ممکن است این دستگاه را به وضعیت تخصیص جدید منتقل کند یا نکند.

پارامترها
`event`	`DeviceEvent`

برمی گرداند
`IManagedTestDevice.DeviceEventResponse`

دارای ویژگی

public boolean hasFeature (String feature)

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

پارامترها
`feature`	`String` : کدام فرمت باید «feature: "یا" "مستقیم

برمی گرداند
`boolean`	اگر ویژگی پیدا شود درست است، در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

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

پارامترها
`packageFile`	`File` : فایل apk برای نصب
`reinstall`	`boolean` : `true` اگر نصب مجدد انجام شود
`extraArgs`	`String` : آرگومان های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به «adb shell pm -h» مراجعه کنید.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.

پارامترها
`packageFile`	`File` : فایل apk برای نصب
`reinstall`	`boolean` : `true` اگر نصب مجدد انجام شود
`grantPermissions`	`boolean` : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند
`extraArgs`	`String` : آرگومان های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به «adb shell pm -h» مراجعه کنید.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

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

پارامترها
`packageFile`	`File` : فایل apk برای نصب
`reinstall`	`boolean` : `true` اگر نصب مجدد انجام شود
`userId`	`int` : شناسه کاربری عدد صحیح برای نصب.
`extraArgs`	`String` : آرگومان های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به «adb shell pm -h» مراجعه کنید.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.

پارامترها
`packageFile`	`File` : فایل apk برای نصب
`reinstall`	`boolean` : `true` اگر نصب مجدد انجام شود
`grantPermissions`	`boolean` : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند
`userId`	`int` : شناسه کاربری عدد صحیح برای نصب.
`extraArgs`	`String` : آرگومان های اضافی اختیاری برای ارسال. برای گزینه‌های موجود به «adb shell pm -h» مراجعه کنید.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot است

public boolean isAdbRoot ()

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

برمی گرداند
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

برمی گرداند
`boolean`	اگر شمارش برنامه پشتیبانی شود درست است، در غیر این صورت نادرست است

پرتاب می کند
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

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

برمی گرداند
`boolean`	درست است اگر بلوک sdk با هدف پایین دور زدن پشتیبانی شود، در غیر این صورت نادرست است

پرتاب می کند
`DeviceNotAvailableException`

isDebugfsMounted است

public boolean isDebugfsMounted ()

بررسی کنید که آیا debugfs نصب شده است یا خیر.

برمی گرداند
`boolean`	`true` اگر اشکال زدایی نصب شده باشد

پرتاب می کند
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

اگر دستگاه رمزگذاری شده باشد برمی گردد.

برمی گرداند
`boolean`	اگر دستگاه رمزگذاری شده باشد `true` .

پرتاب می کند
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

اگر مسیر روی دستگاه یک دایرکتوری است، True را برگردانید، در غیر این صورت false.

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

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isEnableAdbRoot است

public boolean isEnableAdbRoot ()

برمی گرداند
`boolean`	`true` اگر ریشه adb باید در دستگاه فعال باشد

isEncryptionSupported

public boolean isEncryptionSupported ()

اگر رمزگذاری در دستگاه پشتیبانی شود، برمی‌گردد.

برمی گرداند
`boolean`	`true` اگر دستگاه از رمزگذاری پشتیبانی کند.

پرتاب می کند
`DeviceNotAvailableException`

قابل اجرا است

public boolean isExecutable (String fullPath)

اگر مسیر فایل روی دستگاه یک فایل اجرایی باشد، True را برمی‌گرداند، در غیر این صورت false است.

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

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isFastbootEnabled است

public boolean isFastbootEnabled ()

اگر فست بوت برای دستگاه موجود است، برگردید.

برمی گرداند
`boolean`

بی سر است

public boolean isHeadless ()

اگر دستگاه بدون هد است (بدون صفحه) true را برگردانید، در غیر این صورت false.

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر.

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

نشان می دهد که آیا کاربر اصلی یک سرپرست دائمی است و نمی توان آن را حذف کرد یا به وضعیت غیر سرپرست تنزل داد.

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

تعیین می کند که آیا چند کاربر پشتیبانی می شود یا خیر.

برمی گرداند
`boolean`	درست است اگر چند کاربر پشتیبانی می شود، نادرست در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

isPackageInstalled است

public boolean isPackageInstalled (String packageName, 
                String userId)

دستگاه را برای نام بسته معین و شناسه کاربری داده شده جستجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر.

پارامترها
`packageName`	`String` : بسته ای که ما در حال بررسی آن هستیم که آیا نصب شده است.
`userId`	`String` : شناسه کاربری که بسته را بررسی می کنیم برای آن نصب شده است. اگر null باشد، از کاربر اصلی صفر استفاده می شود.

برمی گرداند
`boolean`	درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

isPackageInstalled است

public boolean isPackageInstalled (String packageName)

دستگاه را برای یک نام بسته جستجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.

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

برمی گرداند
`boolean`	درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

isRuntimePermissionSupported است

public boolean isRuntimePermissionSupported ()

بررسی کنید که آیا پلتفرم روی دستگاه از اعطای مجوز زمان اجرا پشتیبانی می کند یا خیر

برمی گرداند
`boolean`	اگر مجوز زمان اجرا پشتیبانی شود درست است، در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

اگر دستگاه در TestDeviceState.FASTBOOT یا TestDeviceState.FASTBOOTD باشد، درست برمی گردد.

برمی گرداند
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر.

پارامترها
`userId`	`int`

برمی گرداند
`boolean`	اگر کاربر در حال اجرا باشد درست است، در سایر موارد نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر.

پارامترها
`userId`	`int`

برمی گرداند
`boolean`	درست است اگر کاربر ثانویه باشد، در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر.

کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت ها را راه اندازی کند (معمولاً در صفحه نمایش پیش فرض).

پارامترها
`userId`	`int`

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر.

کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت های خود را در آن نمایشگر راه اندازی کند.

پارامترها
`userId`	`int`
`displayId`	`int`

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

نشان می‌دهد که آیا دستگاه به کاربران اجازه می‌دهد در پس‌زمینه در ERROR(/java.android.view.Display#DEFAULT_DISPLAY) قابل مشاهده باشند یا خیر.

اگر اینطور است، می‌توانید startVisibleBackgroundUser(int, int, boolean) فراخوانی کنید و نمایشگری را ارسال کنید که توسط listDisplayIdsForStartingVisibleBackgroundUsers() (که باید شامل ERROR(/java.android.view.Display#DEFAULT_DISPLAY) باشد).

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

نشان می دهد که آیا دستگاه به کاربران اجازه می دهد در پس زمینه قابل مشاهده باشند یا خیر.

اگر اینطور است، می توانید startVisibleBackgroundUser(int, int, boolean) فراخوانی کنید و نمایشگری را که توسط listDisplayIdsForStartingVisibleBackgroundUsers() برگردانده شده است، ارسال کنید.

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

isWifiEnabled است

public boolean isWifiEnabled ()

تست کنید آیا وای فای فعال است یا خیر.

بررسی می کند که آیا وای فای در دستگاه فعال است یا خیر. برای اثبات وضعیت وای فای قبل از آزمایش هایی که نباید با وای فای اجرا شوند مفید است، به عنوان مثال آزمایش های داده تلفن همراه.

برمی گرداند
`boolean`	`true` اگر وای فای فعال باشد. `false` در صورت غیرفعال بودن

پرتاب می کند
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید.

برمی گرداند
	لیست نمایشگرها پیش فرض همیشه نمایشگر پیش فرض 0 را برمی گرداند.

پرتاب می کند
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

لیستی از نمایشگرهایی را دریافت می کند که می توانند برای start a user visible in the background استفاده شوند.

برمی گرداند

پرتاب می کند
`DeviceNotAvailableException`

لیست کاربران

public  listUsers ()

لیست کاربران دستگاه را دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException پرتاب می کند.

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

پرتاب می کند
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

ANR ها را از دستگاه جمع آوری و ثبت می کند.

پارامترها
`logger`	`ITestLogger` : یک `ITestLogger` برای ثبت ANR ها.

برمی گرداند
`boolean`	اگر ثبت با موفقیت انجام شد درست است، در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

گزارش logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

روش کمکی برای گرفتن گزارش اشکال و ورود آن به خبرنگاران.

پارامترها
`dataName`	`String` : نامی که گزارش اشکال تحت آن گزارش می شود.
`listener`	`ITestLogger` : یک `ITestLogger` برای ثبت گزارش اشکال.

برمی گرداند
`boolean`	اگر ثبت با موفقیت انجام شد درست است، در غیر این صورت نادرست است.

logOnDevice

public void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

یک پیام را در logcat دستگاه ثبت کنید. این یک تماس ایمن است که حتی اگر ورود به سیستم با شکست مواجه شود، پرتاب نمی شود.

پارامترها
`tag`	`String` : برچسبی که تحت آن پیام خود را در logcat ثبت می کنیم.
`level`	`Log.LogLevel` : سطح اشکال زدایی پیام در logcat.
`format`	`String` : قالب پیام.
`args`	`Object` : آرگ هایی که باید از طریق String.format() جایگزین شوند.

mountDebugfs

public void mountDebugfs ()

اشکال زدایی را سوار کنید.

پرتاب می کند
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

دستوری را برای راه اندازی مجدد دستگاه صادر می کند و با فرمان کامل و زمانی که دستگاه دیگر برای adb قابل مشاهده نیست، برمی گردد.

پرتاب می کند
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

اگر دستگاه نیاز به انجام برخی اقدامات خاص بعد از ریشه adb و قبل از اینکه دستگاه دوباره آنلاین شود، لغو شود. اجرای پیش‌فرض شامل هیچ اقدام اضافی نمی‌شود. ریشه adb در این مرحله تضمین نمی شود که فعال شود.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postAdbUnrootAction

public void postAdbUnrootAction ()

اگر دستگاه نیاز به انجام برخی اقدامات خاص پس از unroot adb و قبل از اینکه دستگاه دوباره آنلاین شود، لغو شود. اجرای پیش‌فرض شامل هیچ اقدام اضافی نمی‌شود. غیرفعال شدن ریشه adb در این مرحله تضمینی نیست.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public void postBootSetup ()

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

باید پس از راه‌اندازی کامل/در دسترس بودن دستگاه فراخوانی شود

در شرایط عادی این روش نیازی به فراخوانی صریح ندارد، زیرا پیاده‌سازی‌ها باید این مراحل را به‌طور خودکار هنگام اجرای راه‌اندازی مجدد انجام دهند.

جایی که ممکن است نیاز به فراخوانی داشته باشد، زمانی است که دستگاه به دلیل رویدادهای دیگر راه اندازی مجدد می شود (مثلاً زمانی که فرمان به روز رسانی فست بوت کامل شده است)

پرتاب می کند
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

مراحل اضافی برای پاکسازی مورد نیاز خاص دستگاه که پس از انجام فراخوانی اجرا می شود.

پارامترها
`exception`	`Throwable` : در صورت وجود، آخرین استثنا ناشی از شکست فراخوانی.

preInvocationSetup

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

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

پارامترها
`info`	`IBuildInfo` : `IBuildInfo` دستگاه.
`attributes`	`MultiMap` : ویژگی هایی که در زمینه فراخوانی ذخیره می شوند

پرتاب می کند
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

به صورت بازگشتی محتویات دایرکتوری را از دستگاه بکشید.

پارامترها
`deviceFilePath`	`String` : مسیر فایل مطلق منبع راه دور
`localDir`	`File` : فهرست محلی برای کشیدن فایل‌ها در آن
`userId`	`int` : شناسه کاربری که باید از آن خارج شود

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت کشیده شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

به صورت بازگشتی محتویات دایرکتوری را از دستگاه بکشید.

پارامترها
`deviceFilePath`	`String` : مسیر فایل مطلق منبع راه دور
`localDir`	`File` : فهرست محلی برای کشیدن فایل‌ها در آن

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت کشیده شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

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

پارامترها
`remoteFilePath`	`String` : مسیر مطلق فایل در دستگاه.
`localFile`	`File` : فایل محلی برای ذخیره محتویات. اگر خالی نباشد، محتویات جایگزین خواهند شد.

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت بازیابی شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

یک فایل را از دستگاه بازیابی می کند، آن را در یک ERROR(/File) موقت محلی ذخیره می کند و آن File برمی گرداند.

پارامترها
`remoteFilePath`	`String` : مسیر مطلق فایل در دستگاه.
`userId`	`int` : شناسه کاربری که باید از آن خارج شود

برمی گرداند
`File`	یک `ERROR(/File)` حاوی محتویات فایل دستگاه، یا در صورت عدم موفقیت کپی به هر دلیلی (از جمله مشکلات سیستم فایل میزبان) `null` .

پرتاب می کند
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

یک فایل را از دستگاه بازیابی می کند، آن را در یک ERROR(/File) موقت محلی ذخیره می کند و آن File برمی گرداند.

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

برمی گرداند
`File`	یک `ERROR(/File)` حاوی محتویات فایل دستگاه، یا در صورت عدم موفقیت کپی به هر دلیلی (از جمله مشکلات سیستم فایل میزبان) `null` .

پرتاب می کند
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

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

پارامترها
`remoteFilePath`	`String` : مسیر مطلق فایل در دستگاه.
`localFile`	`File` : فایل محلی برای ذخیره محتویات. اگر خالی نباشد، محتویات جایگزین خواهند شد.
`userId`	`int` : شناسه کاربری که باید از آن خارج شود

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت بازیابی شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

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

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

برمی گرداند
`String`	`String` ای که حاوی محتویات فایل دستگاه است، یا اگر به هر دلیلی کپی نشد (از جمله مشکلات سیستم فایل میزبان) `null` .

پرتاب می کند
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

یک روش راحت برای بازیابی یک فایل از حافظه خارجی دستگاه، ذخیره آن در یک ERROR(/File) موقت محلی و بازگشت یک مرجع به آن File .

پارامترها
`remoteFilePath`	`String` : مسیر فایل روی دستگاه، نسبت به نقطه نصب حافظه خارجی دستگاه

برمی گرداند
`File`	یک `ERROR(/File)` حاوی محتویات فایل دستگاه، یا در صورت عدم موفقیت کپی به هر دلیلی (از جمله مشکلات سیستم فایل میزبان) `null` .

پرتاب می کند
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

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

پارامترها
`localFileDir`	`File` : دایرکتوری محلی برای فشار دادن
`deviceFilePath`	`String` : مسیر فایل مطلق مقصد راه دور
`excludedDirectories`	: مجموعه ای از نام دایرکتوری های حذف شده که نباید فشار داده شوند.

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت فشار داده شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید.

پارامترها
`localFileDir`	`File` : دایرکتوری محلی برای فشار دادن
`deviceFilePath`	`String` : مسیر فایل مطلق مقصد راه دور

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت فشار داده شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید.

پارامترها
`localFileDir`	`File` : دایرکتوری محلی برای فشار دادن
`deviceFilePath`	`String` : مسیر فایل مطلق مقصد راه دور
`userId`	`int` : شناسه کاربری که باید به آن فشار دهید

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت فشار داده شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

گونه ای از pushFile(File, String) که می تواند به صورت اختیاری ارزیابی نیاز به ارائه دهنده محتوا را در نظر بگیرد.

پارامترها
`localFile`	`File` : فایل محلی برای فشار دادن
`remoteFilePath`	`String` : مسیر فایل مطلق مقصد از راه دور
`evaluateContentProviderNeeded`	`boolean` : بررسی کنیم که آیا به ارائه دهنده محتوا نیاز داریم یا خیر

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت فشار داده شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

یک فایل را به دستگاه فشار دهید. به طور پیش فرض با استفاده از یک ارائه دهنده محتوا.

پارامترها
`localFile`	`File` : فایل محلی برای فشار دادن
`remoteFilePath`	`String` : مسیر فایل مطلق مقصد از راه دور

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت فشار داده شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                int userId)

یک فایل را به دستگاه فشار دهید. به طور پیش فرض با استفاده از یک ارائه دهنده محتوا.

پارامترها
`localFile`	`File` : فایل محلی برای فشار دادن
`remoteFilePath`	`String` : مسیر فایل مطلق مقصد از راه دور
`userId`	`int` : شناسه کاربری که باید به آن فشار دهید

برمی گرداند
`boolean`	`true` اگر فایل با موفقیت فشار داده شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

فایل فشار ایجاد شده از رشته ای به دستگاه

پارامترها
`contents`	`String` : محتویات فایل برای فشار دادن
`remoteFilePath`	`String` : مسیر فایل مطلق مقصد از راه دور

برمی گرداند
`boolean`	`true` اگر رشته با موفقیت فشار داده شود. `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

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

public void reboot (String reason)

دستگاه را به حالت adb راه‌اندازی مجدد می‌کند و reason مشخصی برای ادامه راه‌اندازی مجدد دارد.

مسدود می شود تا زمانی که دستگاه در دسترس قرار گیرد.

آخرین دلیل راه اندازی مجدد را می توان با پرس و جوی sys.boot.reason propety بدست آورد.

پارامترها
`reason`	`String` : دلیلی برای این راه‌اندازی مجدد، یا اگر دلیلی مشخص نشده باشد، `null` .

پرتاب می کند
`DeviceNotAvailableException`

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

public void reboot ()

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

مسدود می شود تا زمانی که دستگاه در دسترس قرار گیرد.

پرتاب می کند
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

پرتاب می کند
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

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

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

پرتاب می کند
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

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

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

پرتاب می کند
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

دستگاه را به حالت adb sideload مجدد راه اندازی می کند (توجه داشته باشید که این یک حالت ویژه در حال بازیابی است)

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

پرتاب می کند
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

دستگاه را به حالت adb sideload مجدد راه اندازی می کند (توجه داشته باشید که این یک حالت ویژه در حال بازیابی است)

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

پارامترها
`autoReboot`	`boolean` : آیا دستگاه پس از بارگذاری جانبی به طور خودکار راه اندازی مجدد شود

پرتاب می کند
`DeviceNotAvailableException`

راه اندازی مجدد تا آنلاین

public void rebootUntilOnline ()

جایگزینی برای reboot() که فقط تا زمانی که دستگاه آنلاین شود مسدود می شود، یعنی برای adb قابل مشاهده است.

پرتاب می کند
`DeviceNotAvailableException`

راه اندازی مجدد تا آنلاین

public void rebootUntilOnline (String reason)

جایگزینی برای reboot() که فقط تا زمانی که دستگاه آنلاین شود مسدود می شود، یعنی برای adb قابل مشاهده است.

پارامترها
`reason`	`String` : دلیلی برای این راه‌اندازی مجدد، یا اگر دلیلی مشخص نشده باشد، `null` .

پرتاب می کند
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

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

مسدود می شود تا زمانی که دستگاه در دسترس قرار گیرد.

هشدار. راه اندازی مجدد فضای کاربری در حال حاضر در حال توسعه فعال است، از آن با مسئولیت خود استفاده کنید.

پرتاب می کند
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

جایگزینی برای rebootUserspace() ()} که فقط تا زمانی که دستگاه آنلاین شود مسدود می شود، یعنی برای adb قابل مشاهده است.

پرتاب می کند
`DeviceNotAvailableException`

بازیابی دستگاه

public boolean recoverDevice ()

تلاش برای بازیابی ارتباطات دستگاه

برمی گرداند
`boolean`	اگر بازیابی انجام شود و موفقیت آمیز باشد درست است، اگر بازیابی نادیده گرفته شود، False را برمی‌گرداند

پرتاب می کند
`DeviceNotAvailableException`	اگر دستگاه دیگر در دسترس نباشد

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

IDeviceActionReceiver را برای این دستگاه ثبت می کند.

همه IDeviceActionReceiver های ثبت شده قبل از شروع یک اقدام دستگاه و پس از پایان عملکرد دستگاه مطلع خواهند شد.

پارامترها
`deviceActionReceiver`	`IDeviceActionReceiver` : یک `IDeviceActionReceiver` که ثبت خواهد شد.

remountSystemReadOnly

public void remountSystemReadOnly ()

پارتیشن سیستم را روی دستگاه فقط خواندنی کنید. ممکن است دستگاه را راه اندازی مجدد کند.

پرتاب می کند
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

پارتیشن سیستم روی دستگاه را قابل نوشتن کنید. ممکن است دستگاه را راه اندازی مجدد کند.

پرتاب می کند
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

پارتیشن فروشنده روی دستگاه را فقط خواندنی کنید. ممکن است دستگاه را راه اندازی مجدد کند.

پرتاب می کند
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

پارتیشن فروشنده روی دستگاه را قابل نوشتن کنید. ممکن است دستگاه را راه اندازی مجدد کند.

پرتاب می کند
`DeviceNotAvailableException`

حذف ادمین

public boolean removeAdmin (String componentName, 
                int userId)

ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود true برگردانید، در غیر این صورت false .

پارامترها
`componentName`	`String` : مدیر دستگاه که باید حذف شود.
`userId`	`int` : کاربری که سرپرست دستگاه در آن زندگی می کند.

برمی گرداند
`boolean`	اگر موفقیت آمیز باشد درست است، در غیر این صورت نادرست.

پرتاب می کند
`DeviceNotAvailableException`

حذف مالکان

public void removeOwners ()

همه دارندگان نمایه دستگاه موجود را با بهترین تلاش حذف کنید.

پرتاب می کند
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

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

پارامترها
`userId`	`int` : کاربر برای حذف

برمی گرداند
`boolean`	درست است اگر در حذف کاربر موفق بودیم، در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

پرچم را برای راه اندازی ارائه دهنده محتوا بازنشانی کنید تا دوباره فعال شود.

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                ITestLifeCycleReceiver... listeners)

روش آسان برای انجام ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) با یک یا چند شنونده به عنوان پارامتر ارسال شده است.

پارامترها
`runner`	`IRemoteAndroidTestRunner` : `IRemoteAndroidTestRunner` که تست ها را اجرا می کند
`listeners`	`ITestLifeCycleReceiver` : شنونده(های) نتیجه آزمایش

برمی گرداند
`boolean`	`true` اگر دستور تست تکمیل شود. اگر تکمیل نشد، `false` ، اما بازیابی با موفقیت انجام شد

پرتاب می کند
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

تست های ابزار دقیق را اجرا می کند و بازیابی دستگاه را فراهم می کند.

اگر قبل از اجرای آزمایشی اتصال با دستگاه قطع شود و بازیابی موفقیت آمیز باشد، همه شنوندگان از testRunFailed مطلع می شوند و "false" برگردانده می شود. دستور تست مجددا اجرا نمی شود. این به تماس گیرندگان واگذار می شود که در صورت لزوم دوباره تلاش کنند.

اگر قبل از اجرای آزمایشی اتصال با دستگاه قطع شود، و بازیابی ناموفق باشد، همه شنوندگان از testRunFailed مطلع می شوند و DeviceNotAvailableException پرتاب می شود.

پارامترها
`runner`	`IRemoteAndroidTestRunner` : `IRemoteAndroidTestRunner` که تست ها را اجرا می کند
`listeners`	: شنوندگان نتیجه آزمون

برمی گرداند
`boolean`	`true` اگر دستور تست تکمیل شود. اگر به دلیل استثنای ارتباط دستگاه تکمیل نشد `false` ، اما بازیابی با موفقیت انجام شد

پرتاب می کند
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                 listeners)

مانند ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) اما تست را برای کاربر مورد نظر اجرا می کند.

پارامترها
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

مانند ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) اما آزمایش را برای یک کاربر مشخص اجرا می کند.

پارامترها
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

پیکربندی set

public void setConfiguration (IConfiguration configuration)

IConfiguration در حال استفاده را تزریق می کند.

پارامترها
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

پارامترها
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

تاریخ را روی دستگاه تنظیم می کند

توجه: تنظیم تاریخ در دستگاه نیاز به روت دارد

پارامترها
`date`	`Date` : تاریخ خاصی را مشخص کنید. در صورت `null` از تاریخ میزبان استفاده خواهد کرد

پرتاب می کند
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید.

پارامترها
`componentName`	`String` : مدیر دستگاه که مالک دستگاه باشد.
`userId`	`int` : کاربری که صاحب دستگاه در آن زندگی می کند.

برمی گرداند
`boolean`	اگر موفقیت آمیز باشد درست است، در غیر این صورت نادرست.

پرتاب می کند
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

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

پارامترها
`deviceState`	`TestDeviceState` : `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

برای شبیه ساز SizeLimitedOutputStream برای ورود به خروجی تنظیم کنید

پارامترها
`output`	`SizeLimitedOutputStream` : برای ثبت خروجی

setEmulatorProcess

public void setEmulatorProcess (Process p)

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

پارامترها
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

گزینه fastboot را برای دستگاه تنظیم کنید. زمانی که دستگاه برای اولین بار تخصیص داده می شود باید تنظیم شود.

پارامترها
`fastbootEnabled`	`boolean` : آیا فست بوت برای دستگاه موجود است یا خیر

setFastbootPath

public void setFastbootPath (String fastbootPath)

مسیر باینری fastboot را که باید استفاده شود را تعیین می کند. هنوز هم نیاز دارد که isFastbootEnabled() درست باشد، تا توابع fastboot فعال باشند.

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

setIDevice

public void setIDevice (IDevice newDevice)

IDevice مرتبط با این ITestDevice را به روز کنید.

IDevice جدید باید همان دستگاه فیزیکی مرجع فعلی را ارجاع دهد. این متد در صورتی فراخوانی می شود که DDMS یک دستگاه ID جدید اختصاص داده باشد

پارامترها
`newDevice`	`IDevice` : `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

زمان انتظار را قبل از شروع ضبط logcat برای یک دستگاه آنلاین بر حسب میلی ثانیه تنظیم می کند.

پارامترها
`delay`	`int` : تاخیر در ms

setOptions

public void setOptions (TestDeviceOptions options)

TestDeviceOptions را برای دستگاه تنظیم کنید

پارامترها
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

مقدار ویژگی داده شده را روی دستگاه تنظیم می کند. نیاز به ریشه adb درست است.

پارامترها
`propKey`	`String` : کلیدی که باید تنظیم شود.
`propValue`	`String` : مقدار خاصیت که باید تنظیم شود.

برمی گرداند
`boolean`	اگر دستور setprop موفقیت آمیز بود، `True` برمی‌گرداند، در غیر این صورت، False را برمی‌گرداند.

پرتاب می کند
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

IDeviceRecovery را برای استفاده برای این دستگاه تنظیم کنید. زمانی که دستگاه برای اولین بار تخصیص داده می شود باید تنظیم شود.

پارامترها
`recovery`	`IDeviceRecovery` : `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

حالت بازیابی فعلی را برای استفاده برای دستگاه تنظیم کنید.

برای کنترل روش بازیابی در هنگام مواجه شدن با مشکل ارتباط دستگاه استفاده می شود. توصیه می شود فقط در مواقع لزوم از این روش استفاده کنید (مثلاً وقتی فریمورک خراب است و غیره).

پارامترها
`mode`	`ITestDevice.RecoveryMode` : حالت «بازیابی فقط تا آنلاین» باید روشن باشد یا خیر.

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

به setSetting(int, String, String, String) مراجعه کنید و در کاربر سیستم انجام شد.

پارامترها
`namespace`	`String`
`key`	`String`
`value`	`String`

پرتاب می کند
`DeviceNotAvailableException`

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

یک مقدار تنظیم به فضای نام یک کاربر معین اضافه کنید. برخی از تنظیمات فقط پس از راه اندازی مجدد در دسترس خواهند بود. فضای نام باید یکی از موارد زیر باشد: {"system", "secure", "global"}

پارامترها
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

پرتاب می کند
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

نمونه ITestLogger را تزریق می کند

پارامترها
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

برای مدیریت دستگاه، سریالی را که برای ارجاع دستگاه استفاده می کنیم، ردیابی کنید.

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

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

تنظیم کنید که برای پاک کردن یک پارتیشن روی دستگاه از فرمت fastboot erase یا fastboot استفاده شود.

پارامترها
`useFastbootErase`	`boolean` : اگر از فرمت فست بوت استفاده شود `true` یا اگر از فرمت فست بوت استفاده شود `false` .

startLogcat

public void startLogcat ()

شروع به گرفتن خروجی logcat از دستگاه در پس زمینه کنید.

اگر خروجی logcat از قبل گرفته شده باشد، تاثیری نخواهد داشت. داده ها را می توان بعداً از طریق getLogcat بازیابی کرد.

هنگامی که دستگاه دیگر در حال استفاده نیست، stopLogcat() باید فراخوانی شود.

startLogcat() و stopLogcat() معمولاً نیازی به فراخوانی در یک زمینه فراخوانی TF ندارند، زیرا چارچوب TF logcat را شروع و متوقف می کند.

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

حالت معاملاتی آزمایشی را فعال کنید. دستگاه پاک می شود و راه اندازی مجدد می شود.

پارامترها
`timeoutMs`	`int`

برمی گرداند
`boolean`	اگر موفق بودیم درست، در غیر این صورت نادرست

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId)

اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پس‌زمینه راه‌اندازی می‌کند. اگر کاربر قبلاً در پس‌زمینه اجرا می‌شود، این روش یک NOOP است.

پارامترها
`userId`	`int` : کاربر برای شروع در پس زمینه

برمی گرداند
`boolean`	درست است اگر کاربر با موفقیت در پس‌زمینه راه‌اندازی شده باشد.

پرتاب می کند
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پس‌زمینه راه‌اندازی می‌کند. اگر کاربر قبلاً در پس‌زمینه اجرا می‌شود، این روش یک NOOP است. امکان ارائه پرچم اضافی برای منتظر ماندن برای تأثیرگذاری عملیات.

پارامترها
`userId`	`int` : کاربر برای شروع در پس زمینه
`waitFlag`	`boolean` : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند.

برمی گرداند
`boolean`	درست است اگر کاربر با موفقیت در پس‌زمینه راه‌اندازی شده باشد.

پرتاب می کند
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

کاربر مشخصی را در پس‌زمینه شروع می‌کند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه می‌دهد فعالیت‌ها را در آن نمایشگر راه‌اندازی کند).

توجه: این دستور بررسی نمی کند که آیا کاربر وجود دارد، نمایشگر موجود است، device supports such feature و غیره.

پارامترها
`userId`	`int` : کاربر برای شروع در پس زمینه
`displayId`	`int` : نمایش برای شروع قابل مشاهده کاربر
`waitFlag`	`boolean` : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند.

برمی گرداند
`boolean`	`true` اگر کاربر با موفقیت شروع به کار کرده باشد در پس زمینه قابل مشاهده است.

پرتاب می کند
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

خروجی شبیه ساز را ببندید و حذف کنید.

stopLogcat

public void stopLogcat ()

گرفتن خروجی logcat از دستگاه را متوقف کنید و داده های ذخیره شده logcat را دور بریزید.

اگر خروجی logcat گرفته نشود تاثیری نخواهد داشت.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

آزمایش حالت تجارت در را متوقف کنید.

پرتاب می کند
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

یک کاربر معین را متوقف می کند. اگر کاربر قبلا متوقف شده باشد، این روش یک NOOP است. کاربر فعلی و سیستم را نمی توان متوقف کرد.

پارامترها
`userId`	`int` : کاربر برای توقف.

برمی گرداند
`boolean`	درست است اگر کاربر با موفقیت متوقف شود.

پرتاب می کند
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

یک کاربر معین را متوقف کنید. امکان ارائه پرچم‌های اضافی برای منتظر ماندن برای تأثیرگذاری عملیات و خاتمه اجباری کاربر. کاربر فعلی و سیستم را نمی توان متوقف کرد.

پارامترها
`userId`	`int` : کاربر برای توقف.
`waitFlag`	`boolean` : فرمان را منتظر می ماند تا کاربر متوقف شود.
`forceFlag`	`boolean` : کاربر را مجبور به توقف می کند.

برمی گرداند
`boolean`	درست است اگر کاربر با موفقیت متوقف شود.

پرتاب می کند
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

دستگاه را به حالت adb-over-tcp تغییر دهید.

برمی گرداند
`String`	شماره سریال tcp یا در صورت عدم تغییر دستگاه، `null`

پرتاب می کند
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

دستگاه را به حالت adb از طریق usb تغییر دهید.

برمی گرداند
`boolean`	`true` اگر سوئیچ موفقیت آمیز بود، در غیر این صورت `false` .

پرتاب می کند
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

به userId دیگری با مهلت زمانی پیش‌فرض تغییر وضعیت دهید. switchUser(int, long) .

پارامترها
`userId`	`int`

برمی گرداند
`boolean`	اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید. پس از موفقیت آمیز بودن تغییر کاربر، محافظ صفحه کلید را غیرفعال کنید.

پارامترها
`userId`	`int`
`timeout`	`long` : منتظر ماندن قبل از بازگشت false برای سوئیچ کاربر ناموفق بود.

برمی گرداند
`boolean`	اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

با مقایسه مُهرهای زمانی فایل‌های محلی با معادل‌های راه دور، تصمیم می‌گیرد کدام فایل‌ها را فشار دهد. فقط فایل‌های «جدیدتر» یا ناموجود به دستگاه منتقل می‌شوند. بنابراین اگر فایل تنظیم شده روی دستگاه از قبل به روز باشد، سربار باید نسبتاً کوچک باشد.

فایل های مخفی (با نام هایی که با "." شروع می شوند) نادیده گرفته می شوند.

مثال استفاده: syncFiles("/tmp/files"، "/sdcard") یک دایرکتوری /sdcard/files را در صورتی که از قبل وجود نداشته باشد ایجاد می کند و به صورت بازگشتی محتویات /tmp/files را به /sdcard/files فشار می دهد.

پارامترها
`localFileDir`	`File` : فهرست فایل محلی حاوی فایل هایی برای فشار دادن بازگشتی.
`deviceFilePath`	`String` : ریشه مسیر فایل مطلق مقصد راه دور. همه دایرکتوری ها در مسیر فایل باید قابل خواندن باشند. یعنی فشار دادن به /data/local/tmp زمانی که adb روت نیست با شکست مواجه خواهد شد

برمی گرداند
`boolean`	اگر فایل ها با موفقیت همگام سازی شوند `true` . `false` در غیر این صورت

پرتاب می کند
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

یک Bugreport بگیرید و آن را در یک شی Bugreport برمی گرداند تا آن را مدیریت کند. در صورت مشکل، باطل برگردانید. فایل ارجاع شده در شی Bugreport باید از طریق Bugreport.close() پاک شود.

برمی گرداند
`Bugreport`

UninstallPackage

public String uninstallPackage (String packageName)

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

پارامترها
`packageName`	`String` : بسته Android برای حذف نصب

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

پارامترها
`packageName`	`String` : بسته Android برای حذف نصب
`userId`	`int` : شناسه کاربری عدد صحیح برای حذف نصب.

برمی گرداند
`String`	یک `String` با کد خطا، یا در صورت موفقیت `null` .

پرتاب می کند
`DeviceNotAvailableException`

باز کردن قفل دستگاه

public boolean unlockDevice ()

اگر دستگاه در حالت رمزگذاری شده باشد، قفل دستگاه را باز می کند.

این متد ممکن است چارچوب را مجددا راه اندازی کند اما postBootSetup() را فراخوانی نخواهد کرد. بنابراین، ممکن است هنگام بازگشت این روش، دستگاه به طور کامل برای آزمایش آماده نباشد.

برمی گرداند
`boolean`	در صورت موفقیت یا عدم رمزگذاری دستگاه `true` .

پرتاب می کند
`DeviceNotAvailableException`

UnmountDebugfs

public void unmountDebugfs ()

حذف اشکال زدایی

پرتاب می کند
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

مسدود می شود تا زمانی که پرچم کامل بوت دستگاه تنظیم شود.

پارامترها
`timeOut`	`long` : زمان انتظار برای تنظیم پرچم بر حسب میلی ثانیه

برمی گرداند
`boolean`	درست است اگر پرچم کامل بوت دستگاه در مدت زمان تعیین شده تنظیم شود

پرتاب می کند
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

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

برمی گرداند
`boolean`	اگر دستگاه در دسترس باشد درست است، اگر بازیابی غیرفعال و در دسترس نباشد نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

منتظر می ماند تا دستگاه پاسخگو و برای آزمایش در دسترس باشد.

پارامترها
`waitTime`	`long` : زمان انتظار بر حسب ms

برمی گرداند
`boolean`	اگر دستگاه در دسترس باشد درست است، اگر بازیابی غیرفعال و در دسترس نباشد نادرست است.

پرتاب می کند
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

منتظر می ماند تا دستگاه بدون در نظر گرفتن مسیر بازیابی پاسخگو و در دسترس باشد.

پارامترها
`waitTime`	`long`

برمی گرداند
`boolean`	درست اگر دستگاه در دسترس باشد، نادرست اگر در دسترس نباشد.

پرتاب می کند
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

مسدود می شود تا زمانی که دستگاه از طریق فست بوت قابل مشاهده باشد. از مهلت زمانی پیش فرض استفاده کنید.

پرتاب می کند
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

مسدود کردن دستگاه در حالت «بازیابی adb» (توجه داشته باشید که این با IDeviceRecovery متفاوت است).

پارامترها
`waitTime`	`long` : زمان انتظار بر حسب ms

برمی گرداند
`boolean`	`true` اگر دستگاه قبل از انقضای زمان به بازیابی راه اندازی شود. `false` در غیر این صورت

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

مسدود کردن دستگاه در حالت "adb sideload".

پارامترها
`waitTime`	`long` : زمان انتظار بر حسب ms

برمی گرداند
`boolean`	`true` اگر دستگاه قبل از انقضای زمان در بار جانبی بوت شود. `false` در غیر این صورت

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

بلوک‌هایی که دستگاه در دسترس نیست، یعنی از adb موجود نیست

پارامترها
`waitTime`	`long` : زمان انتظار بر حسب ms

برمی گرداند
`boolean`	`true` اگر دستگاه قبل از انقضای زمان در دسترس نباشد. `false` در غیر این صورت

waitForDeviceOnline

public void waitForDeviceOnline ()

مسدود می شود تا زمانی که دستگاه از طریق adb قابل مشاهده باشد. از مهلت زمانی پیش‌فرض استفاده می‌کند

توجه داشته باشید که دستگاه ممکن است لزوماً به دستورات پس از تکمیل پاسخگو نباشد. به جای آن از waitForDeviceAvailable() استفاده کنید.

پرتاب می کند
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

مسدود می شود تا زمانی که دستگاه از طریق adb قابل مشاهده باشد.

پارامترها
`waitTime`	`long` : زمان انتظار بر حسب ms

پرتاب می کند
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

منتظر می ماند تا دستگاه به یک دستور اولیه پوسته adb پاسخ دهد.

پارامترها
`waitTime`	`long` : زمان انتظار بر حسب ms

برمی گرداند
`boolean`	`true` اگر دستگاه قبل از سپری شدن `waitTime` پاسخگو شود.

روش های محافظت شده

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

پارامترها
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

دستور OS را برای جلسه دستور adb shell داده شده می سازد و args می کند

پارامترها
`command`	`String`
`forceExitStatusDetection`	`boolean`

برمی گرداند
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

پارامترها
`feature`	`String`
`strictMinLevel`	`int`

createRebootDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

یک RebootDeviceAction ایجاد کنید تا در هنگام انجام یک عمل راه اندازی مجدد استفاده شود.

پارامترها
`rebootMode`	`NativeDevice.RebootMode` : حالتی از این راه‌اندازی مجدد.
`reason`	`String` : برای این راه اندازی مجدد.

برمی گرداند
`NativeDevice.RebootDeviceAction`	`RebootDeviceAction` ایجاد شده

createRunUtil

protected IRunUtil createRunUtil ()

برمی گرداند
`IRunUtil`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

یک راه اندازی مجدد adb انجام دهید.

پارامترها
`rebootMode`	`NativeDevice.RebootMode` : حالتی از این راه‌اندازی مجدد.
`reason`	`String` : برای این راه اندازی مجدد.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

sureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

روش کمکی برای پرتاب استثنا در صورت عدم پشتیبانی از مجوز زمان اجرا

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getApiLevelSafe

protected int getApiLevelSafe ()

برمی گرداند
`int`

getLogger

protected ITestLogger getLogger ()

برمی گرداند
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

نمونه RunUtil را برای استفاده دریافت کنید.

برمی گرداند
`IRunUtil`

InitializeConnection

protected void initializeConnection (IBuildInfo info, 
                MultiMap<String, String> attributes)

پارامترها
`info`	`IBuildInfo`
`attributes`	`MultiMap`

پرتاب می کند
`DeviceNotAvailableException`
`TargetSetupError`

insideGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

یک ویژگی دستگاه را از کش ddmlib به طور پیش‌فرض واکشی کنید و بسته به اینکه دستگاه در Fastboot باشد یا خیر، به «adb shell getprop» یا «fastboot getvar» برگردید.

پارامترها
`propName`	`String` : نام ویژگی دستگاه که توسط «adb shell getprop» برگردانده شده است
`fastbootVar`	`String` : نام متغیر fastboot معادل query. اگر `null` ، کوئری فست بوت انجام نخواهد شد
`description`	`String` : یک توضیح ساده از متغیر. حرف اول باید بزرگ باشد.

برمی گرداند
`String`	یک رشته، احتمالا `null` یا خالی، حاوی مقدار خاصیت داده شده

پرتاب می کند
`DeviceNotAvailableException`

isInRebootCallback است

protected boolean isInRebootCallback ()

برمی‌گرداند که آیا فراخوان‌های راه‌اندازی مجدد در حال حاضر اجرا می‌شوند یا خیر. اگر درست باشد، تمام api های عمومی برای راه اندازی مجدد باید غیرفعال شوند.

برمی گرداند
`boolean`

جدیدتر است

protected boolean isNewer (File localFile, 
                IFileEntry entry)

اگر فایل محلی جدیدتر از فایل راه دور باشد، true برگردانید. IFileEntry با دقت به دقیقه، در صورت مساوی بودن، فایل جدیدتر در نظر گرفته می شود.

پارامترها
`localFile`	`File`
`entry`	`IFileEntry`

برمی گرداند
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

به همه IDeviceActionReceiver درباره رویداد پایان راه‌اندازی مجدد اطلاع می‌دهد.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

notifyRebootStarted

protected void notifyRebootStarted ()

همه IDeviceActionReceiver در مورد رویداد شروع راه اندازی مجدد مطلع می کند.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

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

پارامترها
`actionDescription`	`String` : شرح کوتاهی از اقدامی که باید انجام شود. فقط برای اهداف ورود به سیستم استفاده می شود.
`action`	`NativeDevice.DeviceAction` : اقدامی که باید انجام شود
`retryAttempts`	`int` : تلاش مجدد برای انجام عمل در صورت شکست اما بازیابی موفق است

برمی گرداند
`boolean`	`true` اگر اقدام با موفقیت انجام شود

پرتاب می کند
`DeviceNotAvailableException`	اگر تلاش برای بازیابی با شکست مواجه شد یا حداکثر تلاش بدون موفقیت انجام شد

postAdbReboot

protected void postAdbReboot ()

اقدامات اضافی احتمالی که می توان پس از راه اندازی مجدد انجام داد.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

prePostBootSetup

protected void prePostBootSetup ()

به هر نوع دستگاه (AndroidNativeDevice، TestDevice) اجازه می‌دهد این روش را برای راه‌اندازی خاص پس از بوت لغو کند.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

پارامترها
`remoteFilePath`	`String`
`localFile`	`File`

برمی گرداند
`boolean`

پرتاب می کند
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

نمونه ساعت را برای استفاده تنظیم کنید.

پارامترها
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

TestDevice را به عنوان microdroid علامت گذاری کرده و CID آن را تنظیم می کند.

پارامترها
`process`	`Process` : فرآیند Microdroid VM.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

پارامترها
`deviceOptions`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

یک فرمان ساده fastboot را با متغیرهای محیطی اجرا می کند و وضعیت دستور را گزارش می دهد.

پارامترها
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

برمی گرداند
`CommandResult`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

یک فرمان ساده fastboot را اجرا می کند و وضعیت فرمان را گزارش می کند.

پارامترها
`timeout`	`long`
`fullCmd`	`String`

برمی گرداند
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

منتظر بمانید تا دستگاه در دسترس نباشد (گزارش به adb را متوقف کنید).

پارامترها
`operationDesc`	`String` : نام عملیاتی که در انتظار آن در دسترس نیست.
`time`	`long` : زمان انتظار برای رخ دادن غیرقابل دسترس بودن.

برمی گرداند
`boolean`	اگر دستگاه در دسترس نباشد درست است.

NativeDevice

خلاصه

کلاس های تو در تو

ثابت ها

فیلدها

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

روش های عمومی

روش های محافظت شده

ثابت ها

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

فیلدها

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

mOptions

mStateMonitor

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

NativeDevice

روش های عمومی

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

بررسی اتصال

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

اتصال به شبکه Wifi

اتصال به شبکه Wifi

اتصال به شبکه Wifi

اتصال به شبکه Wifi

ConnectToWifiNetworkIfNeeded

ConnectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

حذف فایل

حذف فایل

لغو ثبت DeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

غیرفعال کردن AdbRoot

غیرفعال کردن کیگارد

شبکه مانیتور را غیرفعال کنید

قطع اتصال از وای فای

doesFileExist

doesFileExist

dumpHeap

فعال کردن AdbRoot

مانیتور شبکه را فعال کنید

دستور Adb را اجرا کنید

دستور Adb را اجرا کنید

دستور Adb را اجرا کنید

دستور Fastboot Command را اجرا کنید

دستور Fastboot Command را اجرا کنید

اجرایLongFastbootCommand

اجرایLongFastbootCommand

ShellCommand را اجرا کنید

ShellCommand را اجرا کنید

ShellCommand را اجرا کنید

ShellCommand را اجرا کنید

ShellV2Command را اجرا کنید

ShellV2Command را اجرا کنید

ShellV2Command را اجرا کنید

ShellV2Command را اجرا کنید

ShellV2Command را اجرا کنید

ShellV2Command را اجرا کنید

ShellV2Command را اجرا کنید

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos