NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver , IManagedTestDevice , ITestLoggerReceiver

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


اجرای پیش‌فرض دستگاه‌های اندرویدی 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) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

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

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

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

boolean connectToWifiNetwork ( wifiSsidToPsk) 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 ایجاد کنید.

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

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

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

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

InputStreamSource getScreenshot (long displayId)

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

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) 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) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

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

boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) 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 startUser (int userId)

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

boolean startUser (int userId, boolean waitFlag)

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

boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)

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

void stopEmulatorOutput ()

خروجی شبیه ساز را ببندید و حذف کنید.

void stopLogcat ()

گرفتن خروجی logcat از دستگاه را متوقف کنید و داده های ذخیره شده logcat را دور بریزید.

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) setTestDeviceOptions ( deviceOptions)
CommandResult simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) 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 برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice#disconnectFromWifi() یا ITestDevice#clearLastConnectedWifiNetwork() فراخوانی شود.f

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

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

پرتاب می کند
DeviceNotAvailableException
اتصال به شبکه Wifi
public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

پارامترها
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
حذف فایل
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 که حذف خواهد شد.

دستگاه نرم افزار راه اندازی مجدد شد
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
اجرای AdbCommand
public String executeAdbCommand (String... cmdArgs)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException
دستور Fastboot Command را اجرا کنید
public CommandResult executeFastbootCommand (String... cmdArgs)

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

انتظار می رود وقتی دستگاه در حال حاضر در حالت Fastboot قرار دارد ، استفاده شود.

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

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

پرتاب می کند
DeviceNotAvailableException
ExecuteFastBootCommand
public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

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

انتظار می رود وقتی دستگاه در حال حاضر در حالت Fastboot قرار دارد ، استفاده شود.

پارامترها
timeout long : زمان در میلی ثانیه قبل از پایان فرمان

cmdArgs String : دستور fastboot و آرگومان های اجرا

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

پرتاب می کند
DeviceNotAvailableException
ExecuteLongfastBootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException
ExecuteLongfastBootCommand
public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

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

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

پارامترها
envVarMap : متغیرهای سیستم سیستم که دستور fastboot با آن اجرا می شود

cmdArgs String : دستور fastboot و آرگومان های اجرا

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

پرتاب می کند
DeviceNotAvailableException
مجری
public String executeShellCommand (String command)

روش یاور که یک دستور پوسته ADB را اجرا می کند و خروجی را به عنوان یک String باز می گرداند.

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

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

پرتاب می کند
DeviceNotAvailableException
مجری
public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

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

receiver IShellOutputReceiver : IShellOutputReceiver برای هدایت خروجی پوسته به.

maxTimeToOutputShellResponse long : حداکثر زمانی که در طی آن دستور مجاز به خروج هیچ پاسخی نیست. واحد همانطور که در timeUnit مشخص شده است

timeUnit TimeUnit : واحد برای maxTimeToOutputShellResponse

retryAttempts int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود.

پرتاب می کند
DeviceNotAvailableException
مجری
public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

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

receiver IShellOutputReceiver : IShellOutputReceiver برای هدایت خروجی پوسته به.

maxTimeoutForCommand long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است

maxTimeToOutputShellResponse long : حداکثر زمانی که در طی آن دستور مجاز به خروج هیچ پاسخی نیست. واحد همانطور که در timeUnit مشخص شده است

timeUnit TimeUnit : واحد برای maxTimeToOutputShellResponse

retryAttempts int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود.

پرتاب می کند
DeviceNotAvailableException
مجری
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
ExecuteLellv2Command
public CommandResult executeShellV2Command (String cmd)

روش یاور که یک دستور پوسته ADB را اجرا می کند و نتایج را به عنوان یک CommandResult به درستی با خروجی وضعیت فرمان ، STDOUT و STDERR باز می گرداند.

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

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

پرتاب می کند
DeviceNotAvailableException
ExecuteLellv2Command
public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

روش یاور که یک دستور پوسته ADB را اجرا می کند و نتایج را به عنوان یک CommandResult به درستی با خروجی وضعیت فرمان و STDERR باز می گرداند. STDOUT به جریان مشخص شده هدایت می شود.

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

pipeToOutput OutputStream : ERROR(/OutputStream) که در آن خروجی STD هدایت می شود یا تهی می شود.

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

پرتاب می کند
DeviceNotAvailableException
ExecuteLellv2Command
public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

روش یاور که یک دستور پوسته ADB را اجرا می کند و نتایج را به عنوان یک CommandResult به درستی با خروجی وضعیت فرمان ، STDOUT و STDERR باز می گرداند.

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

pipeAsInput File : ERROR(/File) که به عنوان ورودی به دستور یا NULL لوله کشی می شود.

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

پرتاب می کند
DeviceNotAvailableException
ExecuteLellv2Command
public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

پارامترها
cmd String : دستور ADB Shell برای اجرا

maxTimeoutForCommand long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است

timeUnit TimeUnit : واحد برای maxTimeToOutputShellResponse

retryAttempts int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود.

برمی گرداند
CommandResult

پرتاب می کند
DeviceNotAvailableException
ExecuteLellv2Command
public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

پارامترها
cmd String : دستور ADB Shell برای اجرا

maxTimeoutForCommand long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است

timeUnit TimeUnit : واحد برای maxTimeToOutputShellResponse

برمی گرداند
CommandResult

پرتاب می کند
DeviceNotAvailableException
ExecuteLellv2Command
public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

پارامترها
cmd String : دستور ADB Shell برای اجرا

pipeAsInput File : ERROR(/File) که به عنوان ورودی به دستور یا NULL لوله کشی می شود.

pipeToOutput OutputStream : ERROR(/OutputStream) که در آن خروجی STD هدایت می شود یا تهی می شود.

maxTimeoutForCommand long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است

timeUnit TimeUnit : واحد برای maxTimeToOutputShellResponse

retryAttempts int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود.

برمی گرداند
CommandResult

پرتاب می کند
DeviceNotAvailableException
ExecuteLellv2Command
public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

پارامترها
cmd String : دستور ADB Shell برای اجرا

pipeAsInput File : ERROR(/File) که به عنوان ورودی به دستور یا NULL لوله کشی می شود.

pipeToOutput OutputStream : ERROR(/OutputStream) که در آن خروجی STD هدایت می شود یا تهی می شود.

pipeToError OutputStream : ERROR(/OutputStream) که در آن خطای STD هدایت می شود یا تهی می شود.

maxTimeoutForCommand long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است

timeUnit TimeUnit : واحد برای maxTimeToOutputShellResponse

retryAttempts int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود.

برمی گرداند
CommandResult

پرتاب می کند
DeviceNotAvailableException
شستشو
public CommandResult fastbootWipePartition (String partition)

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

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

انتظار می رود وقتی دستگاه در حال حاضر در حالت Fastboot قرار دارد ، استفاده شود.

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

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

پرتاب می کند
DeviceNotAvailableException
getActiveApexes
public  getActiveApexes ()

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

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

پرتاب می کند
DeviceNotAvailableException
getAllSettings
public  getAllSettings (String namespace)

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

پارامترها
namespace String : باید یکی از {"سیستم" ، "ایمن" ، "جهانی" باشد

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

پرتاب می کند
DeviceNotAvailableException
GetAllocationState
public DeviceAllocationState getAllocationState ()

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

برمی گرداند
DeviceAllocationState

GetAndroidid
public String getAndroidId (int userId)

Android-ID مرتبط با یک کاربر ، NULL را در صورت یافتن پیدا کنید و برگردانید.

پارامترها
userId int

برمی گرداند
String

پرتاب می کند
DeviceNotAvailableException
getAndroidids
public  getAndroidIds ()

یک نقشه از شناسه های اندرویدی پیدا کنید که شناسه های کاربری مطابق با آن باشد. هیچ بیمه ای وجود ندارد که هر شناسه کاربر شناسه Android را در این عملکرد پیدا کند تا برخی از شناسه های کاربر ممکن است با NULL مطابقت داشته باشند.

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

پرتاب می کند
DeviceNotAvailableException
گله
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 ()

روش راحتی برای دریافت نسخه BaseBand (رادیو) این دستگاه. دریافت نسخه رادیویی خاص دستگاه است ، بنابراین ممکن است اطلاعات صحیح را برای همه دستگاه ها برنگردد. این روش برای بازگشت اطلاعات نسخه صحیح به GSM.Version.BaseBand Propery متکی است. این برای برخی از دستگاه های CDMA دقیق نیست و نسخه برگشتی در اینجا ممکن است با نسخه گزارش شده از Fastboot مطابقت نداشته باشد و ممکن است نسخه را برای رادیو CDMA بازگرداند. TL ؛ DR این روش فقط نسخه دقیق را گزارش می کند اگر ویژگی GSM.Version.BaseBand همان نسخه برگشتی توسط fastboot getvar version-baseband باشد.

برمی گرداند
String اگر نمی توان آن را تعیین کرد ، نسخه BaseBand String یا null (دستگاه هیچ رادیو یا نسخه نسخه ای ندارد)

پرتاب می کند
DeviceNotAvailableException
گیتری
public Integer getBattery ()

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

برمی گرداند
Integer

getBooleanProperty
public boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

defaultValue boolean : مقدار پیش فرض برای بازگشت در صورت خالی بودن خاصیت یا وجود وجود ندارد.

برمی گرداند
boolean true اگر این ملک دارای ارزش "1" ، "y" ، "yes" ، "on" یا "true" false اگر این ملک دارای ارزش "0" ، "n" ، "no" ، "off" ، "false" ، یا defaultValue در غیر این صورت.

پرتاب می کند
DeviceNotAvailableException
جبهه
public  getBootHistory ()

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

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

پرتاب می کند
DeviceNotAvailableException
جبهه
public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

پارامترها
utcEpochTime long : زمان دستگاه از زمان.

timeUnit TimeUnit : Time Unit TimeUnit .

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

پرتاب می کند
DeviceNotAvailableException
GetBootLoaderVersion
public String getBootloaderVersion ()

روش راحتی برای به دست آوردن نسخه bootloader این دستگاه.

سعی در بازیابی نسخه bootloader از حالت فعلی دستگاه خواهد داشت. (یعنی اگر دستگاه در حالت FastBoot باشد ، سعی در بازیابی نسخه از Fastboot خواهد داشت)

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

پرتاب می کند
DeviceNotAvailableException
GetBugReport
public InputStreamSource getBugreport ()

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

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

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

getBugreportz
public InputStreamSource getBugreportz ()

یک Bugreportz را از دستگاه بازیابی می کند. Format BugReport شامل اصلی BugReport و سایر پرونده های ورود به سیستم است که برای اشکال زدایی مفید هستند.

فقط برای "نسخه ADB"> 1.0.36 پشتیبانی می شود

برمی گرداند
InputStreamSource InputStreamSource از پرونده ZIP حاوی Bugreportz ، در صورت عدم موفقیت ، تهی را برمی گرداند.

GetBuildalias
public String getBuildAlias ()

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

ساخت نام مستعار معمولاً یک رشته خواندنی تر از ساخت شناسه است (به طور معمول یک عدد برای ساختهای Nexus). به عنوان مثال ، نسخه نهایی Android 4.2 دارای Alias ​​JDQ39 است ، و ساخت شناسه 573038

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

پرتاب می کند
DeviceNotAvailableException
GetBuildFlavor
public String getBuildFlavor ()

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

برمی گرداند
String در صورت عدم بازیابی ، طعم ساخت یا تهی

پرتاب می کند
DeviceNotAvailableException
باکتری
public String getBuildId ()

بازیابی ساخت دستگاه در حال حاضر در حال اجرا است.

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

پرتاب می کند
DeviceNotAvailableException
GetBuildSigningKeys
public String getBuildSigningKeys ()

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

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

برمی گرداند
String کلید امضای در صورت یافتن ، در غیر این صورت تهی است.

پرتاب می کند
DeviceNotAvailableException
getCachedDevicedEscriptor
public DeviceDescriptor getCachedDeviceDescriptor ()

در صورت اختصاص دستگاه ، یک DeviceDescriptor CachedEscriptor را باز می گرداند ، در غیر این صورت DeviceDescriptor فعلی را برمی گرداند.

برمی گرداند
DeviceDescriptor

getCachedDevicedEscriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

در صورت اختصاص دستگاه ، یک DeviceDescriptor CachedEscriptor را باز می گرداند ، در غیر این صورت DeviceDescriptor فعلی را برمی گرداند.

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

برمی گرداند
DeviceDescriptor

بچه گله
public String[] getChildren (String path)

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

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

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

پرتاب می کند
DeviceNotAvailableException
اتصال
public AbstractConnection getConnection ()

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

برمی گرداند
AbstractConnection

GetContentProvider
public ContentProviderHandler getContentProvider (int userId)

اگر در دسترس نباشد ، ContentProviderHandler یا NULL را برمی گرداند.

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

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

برمی گرداند
ContentProviderHandler

پرتاب می کند
DeviceNotAvailableException
getCurrentFoldAbstate
public DeviceFoldableState getCurrentFoldableState ()

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

برمی گرداند
DeviceFoldableState

پرتاب می کند
DeviceNotAvailableException
جبهه
public int getCurrentUser ()

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

برمی گرداند
int

پرتاب می کند
DeviceNotAvailableException
گلی
public String getDeviceClass ()

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

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

گودال
public long getDeviceDate ()

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

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

پرتاب می کند
DeviceNotAvailableException
دستبند
public DeviceDescriptor getDeviceDescriptor ()

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

برمی گرداند
DeviceDescriptor

دستبند
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

برمی گرداند
DeviceDescriptor

گیره
public TestDeviceState getDeviceState ()

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

برمی گرداند
TestDeviceState

GetDevicetimeOffset
public long getDeviceTimeOffset (Date date)

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

پارامترها
date Date

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

پرتاب می کند
DeviceNotAvailableException
GetEmulatorOutput
public InputStreamSource getEmulatorOutput ()

جریان Emulator stdout و Stderr را دریافت کنید

برمی گرداند
InputStreamSource بازده شبیه ساز

پیش ساز
public Process getEmulatorProcess ()

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

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

getExecteShellCommandlog
public final File getExecuteShellCommandLog ()

ورود به سیستم که شامل تمام سیاهههای مربوط executeShellCommand(String) است.

برمی گرداند
File

فضای getExternalStorefreeSpe
public long getExternalStoreFreeSpace ()

روش یاور برای تعیین میزان فضای آزاد در ذخیره خارجی دستگاه.

برمی گرداند
long مقدار فضای آزاد در KB

پرتاب می کند
DeviceNotAvailableException
پاتری
public String getFastbootPath ()

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

برمی گرداند
String

GetFastBootProductType
public String getFastbootProductType ()

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

این روش فقط باید در صورت استفاده از دستگاه در Fastboot استفاده شود. این نوع کمی ایمن تر از روش عمومی getProductType() در این حالت است ، زیرا Itestdevice می داند اگر دستگاه در حالت نادرست باشد یا پاسخگو نیست ، دستگاه را در Fastboot بازیابی می کند.

برمی گرداند
String نام نوع محصول String یا null در صورت عدم تعیین آن

پرتاب می کند
DeviceNotAvailableException
GetFastBootProductVariant
public String getFastbootProductVariant ()

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

این روش فقط باید در صورت استفاده از دستگاه در Fastboot استفاده شود. این نوع کمی ایمن تر از روش عمومی getProductType() در این حالت است ، زیرا Itestdevice می داند اگر دستگاه در حالت نادرست باشد یا پاسخگو نیست ، دستگاه را در Fastboot بازیابی می کند.

برمی گرداند
String نام نوع محصول String یا null در صورت عدم تعیین آن

پرتاب می کند
DeviceNotAvailableException
GetFastBootSerialNumber
public String getFastbootSerialNumber ()

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

برمی گرداند
String

getFastBootVarable
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 : مسیر پرونده برای بازیابی. می تواند یک مسیر یا مسیر مطلق نسبت به '/' باشد. (IE هر دو "/سیستم" و "سیستم" نحو پشتیبانی می شود)

برمی گرداند
IFileEntry اگر IFileEntry در path داده شده پیدا null

پرتاب می کند
DeviceNotAvailableException
GetFileentry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)

یاور غیررسمی برای دریافت یک FileEntry از یک مسیر غیر ریشه. FIXME: سیستم عامل FileTry را از هر مسیر در دسترس قرار دهید. (حتی غیر ریشه ای).

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

برمی گرداند
IFileEntry یک FileTrywrapper نماینده Fileentry.

پرتاب می کند
com.android.tradefed.device.devicenotavailableablexception
DeviceNotAvailableException
getPoldAbleStates
public  getFoldableStates ()

لیست حالتهای تاشو را در دستگاه برمی گرداند. با "CMD FEECTION_STATE PRINT-STATES" می توان به دست آورد.

برمی گرداند

پرتاب می کند
DeviceNotAvailableException
جبهه
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 دستگاه یا null اگر دستگاه آدرس IP ندارد

پرتاب می کند
DeviceNotAvailableException
GetKeyGuardState
public KeyguardControllerState getKeyguardState ()

در صورت عدم پشتیبانی ، یک شیء را برگردانید تا وضعیت فعلی Keyguard یا NULL را بدست آورید.

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

پرتاب می کند
DeviceNotAvailableException
getlastexpectedrebootimemillis
public long getLastExpectedRebootTimeMillis ()

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

برمی گرداند
long

getlaunchapilevel
public int getLaunchApiLevel ()

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

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

پرتاب می کند
DeviceNotAvailableException
گله
public InputStreamSource getLogcat ()

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

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

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

    برمی گرداند
    InputStreamSource

  • گله
    public InputStreamSource getLogcat (int maxBytes)

    یک جریان عکس از آخرین maxBytes از داده های LogCat ضبط شده را به دست می آورد.

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

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

    برمی گرداند
    InputStreamSource

    گله
    public InputStreamSource getLogcatDump ()

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

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

    برمی گرداند
    InputStreamSource InputStreamSource از داده های logcat. در صورت عدم موفقیت در گرفتن داده های LogCat ، یک جریان خالی بازگردانده می شود.

    GetLogcatsince
    public InputStreamSource getLogcatSince (long date)

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

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

    برمی گرداند
    InputStreamSource

    getMacaddress
    public String getMacAddress ()

    آدرس MAC دستگاه را برمی گرداند ، اگر نتواند از دستگاه پرس و جو کند.

    برمی گرداند
    String

    جبهه
    public Integer getMainUserId ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    getMainlinemoduleInfo
    public  getMainlineModuleInfo ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    getMaxNumberOfRunningusSported
    public int getMaxNumberOfRunningUsersSupported ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    getMaxNumberOfUserssported
    public int getMaxNumberOfUsersSupported ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    گیتمودروید پردازش
    public Process getMicrodroidProcess ()

    برمی گرداند
    Process روند MicroDroid VM را برمی گرداند. اگر TestDevice میکرودروئید نیست ، تهی می کند.

    گیره
    public IDeviceStateMonitor getMonitor ()

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

    برمی گرداند
    IDeviceStateMonitor

    نقطه
    public String getMountPoint (String mountName)

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

    اگر اطلاعات ذخیره شده در IDevice در دسترس نباشد ، دستگاه را مستقیماً پرس و جو کنید.

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

    پارامترها
    mountName String : نام Mount Point

    برمی گرداند
    String نقطه کوه یا null

    getMountInfo
    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    پارامترها
    mountpoint String

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

    پرتاب می کند
    DeviceNotAvailableException
    getMountInfo
    public  getMountPointInfo ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    گله
    public TestDeviceOptions getOptions ()

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

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

    فضای GetPartitionFreespeSte
    public long getPartitionFreeSpace (String partition)

    روش یاور برای تعیین میزان فضای آزاد در پارتیشن دستگاه.

    پارامترها
    partition String

    برمی گرداند
    long مقدار فضای آزاد در KB

    پرتاب می کند
    DeviceNotAvailableException
    GetPrimaryUserid
    public Integer getPrimaryUserId ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    نام خانوادگی
    public ProcessInfo getProcessByName (String processName)

    روش یاور دستور "Pidof" و "Stat" را اجرا می کند و شیء ProcessInfo با PID و زمان شروع فرآیند فرآیند داده شده باز می گرداند.

    پارامترها
    processName String : رشته نام Proces.

    برمی گرداند
    ProcessInfo فرآیند نام پردازنده داده شده

    پرتاب می کند
    DeviceNotAvailableException
    پردازش کننده
    public String getProcessPid (String process)

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

    پارامترها
    process String : رشته نام Proces.

    برمی گرداند
    String

    پرتاب می کند
    DeviceNotAvailableException
    محصول GetProductType
    public String getProductType ()

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

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

    برمی گرداند
    String نام نوع محصول String . تهی نخواهد بود

    پرتاب می کند
    DeviceNotAvailableException
    محصول
    public String getProductVariant ()

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

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

    برمی گرداند
    String اگر نمی توان تعیین کرد نام نوع محصول String یا null

    پرتاب می کند
    DeviceNotAvailableException
    GetProperty
    public String getProperty (String name)

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

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

    برمی گرداند
    String اگر وجود نداشته باشد مقدار خاصیت یا null

    پرتاب می کند
    DeviceNotAvailableException
    رفیق
    public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getscreenshot
    public InputStreamSource getScreenshot (String format)

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

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

    برمی گرداند
    InputStreamSource اگر تصویر موفقیت آمیز نبود ، یک InputStreamSource از تصویر در قالب یا null وجود دارد.

    پرتاب می کند
    DeviceNotAvailableException
    getscreenshot
    public InputStreamSource getScreenshot (long displayId)

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

    TODO: برای پشتیبانی از "قالب" و "Rescale" ، پیاده سازی های فوق را گسترش دهید

    پارامترها
    displayId long : شناسه صفحه نمایش برای دریافت تصویر از صفحه نمایش.

    برمی گرداند
    InputStreamSource اگر تصویر موفقیت آمیز نبود ، یک InputStreamSource از تصویر در قالب یا null وجود دارد.

    پرتاب می کند
    DeviceNotAvailableException
    getscreenshot
    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

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

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

    rescale boolean : در صورت کاهش تصویر برای کاهش اندازه تصویر حاصل باید نجات یابد

    برمی گرداند
    InputStreamSource اگر تصویر موفقیت آمیز نبود ، یک InputStreamSource از تصویر در قالب یا null وجود دارد.

    پرتاب می کند
    DeviceNotAvailableException
    getscreenshot
    public InputStreamSource getScreenshot ()

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

    برمی گرداند
    InputStreamSource اگر تصویر موفقیت آمیز نبود ، یک InputStreamSource از تصویر از تصویر با فرمت PNG یا null .

    پرتاب می کند
    DeviceNotAvailableException
    geterialNumber
    public String getSerialNumber ()

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

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

    در دست گرفتن
    public String getSetting (int userId, 
                    String namespace, 
                    String key)

    مقدار تنظیم درخواست شده را برگردانید. فضای نام باید یکی از: {"سیستم" ، "ایمن" ، "جهانی" باشد

    پارامترها
    userId int

    namespace String

    key String

    برمی گرداند
    String مقدار مرتبط با فضای نام: کلید یک کاربر. اگر یافت نشد NULL.

    پرتاب می کند
    DeviceNotAvailableException
    در دست گرفتن
    public String getSetting (String namespace, 
                    String key)

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

    پارامترها
    namespace String

    key String

    برمی گرداند
    String

    پرتاب می کند
    DeviceNotAvailableException
    GetImoperator
    public String getSimOperator ()

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

    برمی گرداند
    String

    GetAmstate
    public String getSimState ()

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

    برمی گرداند
    String

    سنگهای قیمتی
    public  getTombstones ()

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

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

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

    پرتاب می کند
    DeviceNotAvailableException
    GetTotalmemory
    public long getTotalMemory ()

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

    برمی گرداند
    long

    GetTrackingserial
    public String getTrackingSerial ()

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

    برمی گرداند
    String

    نام های getUninstallablePackagenames
    public  getUninstallablePackageNames ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    GetUsefastBooterase
    public boolean getUseFastbootErase ()

    برای پاک کردن یک پارتیشن روی دستگاه ، از استفاده از Fastboot Erase یا FastBoot استفاده کنید.

    برمی گرداند
    boolean در صورت استفاده از فرمت Fastboot true در صورت استفاده از Fastboot از فرمت استفاده false شود.

    GetUserflags
    public int getUserFlags (int userId)

    پرچم های یک کاربر خاص را پیدا و برگردانید. پرچم ها در کلاس "android.content.pm.userinfo" در پروژه منبع باز اندروید تعریف شده اند.

    پارامترها
    userId int

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

    پرتاب می کند
    DeviceNotAvailableException
    GetUserinfos
    public  getUserInfos ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    GetUserserialNumber
    public int getUserSerialNumber (int userId)

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

    پارامترها
    userId int

    برمی گرداند
    int

    پرتاب می کند
    DeviceNotAvailableException
    دستگیرنده
    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

    پارامترها
    event DeviceEvent

    بازگرداندن
    IManagedTestDevice.DeviceEventResponse

    asfeature
    public boolean hasFeature (String feature)

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

    پارامترها
    feature String : کدام قالب باید باشد "ویژگی: "یا" "مستقیم.

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

    پرتاب می کند
    DeviceNotAvailableException
    بسته بندی
    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
    بسته بندی
    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 ()

    ایزادبروت
    public boolean isAdbRoot ()

    بازگرداندن
    boolean

    پرتاب می کند
    DeviceNotAvailableException
    isadbtcp
    public boolean isAdbTcp ()

    بازگرداندن
    boolean

    isappenumerationsupported
    public boolean isAppEnumerationSupported ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    isBypassLowTargetsDkBlockSupported
    public boolean isBypassLowTargetSdkBlockSupported ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    isdebugfsmounted
    public boolean isDebugfsMounted ()

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

    بازگرداندن
    boolean اگر اشکال زدایی نصب شود true

    پرتاب می کند
    DeviceNotAvailableException
    isdeviceencryed
    public boolean isDeviceEncrypted ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    isDirectory
    public boolean isDirectory (String path)

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

    پارامترها
    path String

    بازگرداندن
    boolean

    پرتاب می کند
    DeviceNotAvailableException
    isenableadbroot
    public boolean isEnableAdbRoot ()

    بازگرداندن
    boolean اگر ریشه ADB باید در دستگاه فعال شود true

    isencryptionsupported
    public boolean isEncryptionSupported ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    قابل اجرا
    public boolean isExecutable (String fullPath)

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

    پارامترها
    fullPath String

    بازگرداندن
    boolean

    پرتاب می کند
    DeviceNotAvailableException
    isFastBootEbabled
    public boolean isFastbootEnabled ()

    اگر Fastboot برای دستگاه در دسترس است ، برگردید.

    بازگرداندن
    boolean

    بی سر
    public boolean isHeadless ()

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

    بازگرداندن
    boolean

    پرتاب می کند
    DeviceNotAvailableException
    isHeadlessSystemUsermode
    public boolean isHeadlessSystemUserMode ()

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

    بازگرداندن
    boolean

    پرتاب می کند
    DeviceNotAvailableException
    ismainuserpermanentadmin
    public boolean isMainUserPermanentAdmin ()

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

    بازگرداندن
    boolean

    پرتاب می کند
    DeviceNotAvailableException
    isMultiusersupported
    public boolean isMultiUserSupported ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    ispackageinstalled
    public boolean isPackageInstalled (String packageName, 
                    String userId)

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

    پارامترها
    packageName String : بسته ای که ما در حال بررسی آن هستیم.

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

    بازگرداندن
    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

    ایزوراس
    public boolean isUserRunning (int userId)

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

    پارامترها
    userId int

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

    پرتاب می کند
    DeviceNotAvailableException
    ایزوسر ثانیه
    public boolean isUserSecondary (int userId)

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

    پارامترها
    userId int

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

    پرتاب می کند
    DeviceNotAvailableException
    قابل استفاده
    public boolean isUserVisible (int userId)

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

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

    پارامترها
    userId int

    برمی گرداند
    boolean

    پرتاب می کند
    DeviceNotAvailableException
    isuservisibleindisplay
    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
    isvisiblebackgroundusssported
    public boolean isVisibleBackgroundUsersSupported ()

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

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

    بازگرداندن
    boolean

    پرتاب می کند
    DeviceNotAvailableException
    iswifienabled
    public boolean isWifiEnabled ()

    اگر WiFi فعال باشد ، آزمایش کنید.

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

    بازگرداندن
    boolean اگر WiFi فعال باشد true . اگر false باشد

    پرتاب می کند
    DeviceNotAvailableException
    listdisplayids
    public  listDisplayIds ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    ListDisplayidSforStartingVisibleBroundUsuS
    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    بازگرداندن

    پرتاب می کند
    DeviceNotAvailableException
    لیست کننده ها
    public  listUsers ()

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

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

    پرتاب می کند
    DeviceNotAvailableException
    لوبان
    public boolean logAnrs (ITestLogger logger)

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

    پارامترها
    logger ITestLogger : ITestLogger برای ورود به سیستم ANRS.

    بازگرداندن
    boolean اگر ورود به سیستم موفقیت آمیز بود ، در غیر این صورت نادرست بود.

    پرتاب می کند
    DeviceNotAvailableException
    لاگ
    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

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

    پارامترها
    dataName String : نامی که در آن Bugreport گزارش خواهد شد.

    listener ITestLogger : ITestLogger برای ورود به سیستم BugReport.

    بازگرداندن
    boolean اگر ورود به سیستم موفقیت آمیز بود ، در غیر این صورت نادرست بود.

    از روی لگد
    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 () جایگزین شوند.

    مگس
    public void mountDebugfs ()

    Mount Debugfs.

    پرتاب
    DeviceNotAvailableException
    غیر مو باکتری
    public void nonBlockingReboot ()

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

    پرتاب
    DeviceNotAvailableException
    پس از عمل
    public void postAdbRootAction ()

    اگر دستگاه نیاز به اقدامات خاصی دارد که باید بعد از ریشه ADB و قبل از بازگشت دستگاه به صورت آنلاین انجام شود ، نادیده بگیرید. Default implementation doesn't include any addition actions. adb root is not guaranteed to be enabled at this stage.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    postAdbUnrootAction
    public void postAdbUnrootAction ()

    Override if the device needs some specific actions to be taken after adb unroot and before the device is back online. Default implementation doesn't include any additional actions. adb root is not guaranteed to be disabled at this stage.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    postBootSetup
    public void postBootSetup ()

    Perform instructions to configure device for testing that after every boot.

    Should be called after device is fully booted/available

    In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot.

    Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)

    Throws
    DeviceNotAvailableException
    postInvocationTearDown
    public void postInvocationTearDown (Throwable exception)

    Extra steps for device specific required clean up that will be executed after the invocation is done.

    پارامترها
    exception Throwable : if any, the final exception raised by the invocation failure.

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

    Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.

    پارامترها
    info IBuildInfo : The IBuildInfo of the device.

    attributes MultiMap : The attributes stored in the invocation context

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

    Recursively pull directory contents from device.

    پارامترها
    deviceFilePath String : the absolute file path of the remote source

    localDir File : the local directory to pull files into

    userId int : the user id to pull from

    Returns
    boolean true if file was pulled successfully. false otherwise.

    Throws
    DeviceNotAvailableException
    pullDir
    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Recursively pull directory contents from device.

    پارامترها
    deviceFilePath String : the absolute file path of the remote source

    localDir File : the local directory to pull files into

    Returns
    boolean true if file was pulled successfully. false otherwise.

    Throws
    DeviceNotAvailableException
    pullFile
    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Retrieves a file off device.

    پارامترها
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    Returns
    boolean true if file was retrieved successfully. false otherwise.

    Throws
    DeviceNotAvailableException
    pullFile
    public File pullFile (String remoteFilePath, 
                    int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    پارامترها
    remoteFilePath String : the absolute path to file on device.

    userId int : The user id to pull from

    Returns
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Throws
    DeviceNotAvailableException
    pullFile
    public File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    پارامترها
    remoteFilePath String : the absolute path to file on device.

    برمی گرداند
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    پرتاب می کند
    DeviceNotAvailableException
    pullFile
    public boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId)

    Retrieves a file off device.

    پارامترها
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    Returns
    boolean true if file was retrieved successfully. false otherwise.

    Throws
    DeviceNotAvailableException
    pullFileContents
    public String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    پارامترها
    remoteFilePath String : the absolute path to file on device.

    Returns
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    Throws
    DeviceNotAvailableException
    pullFileFromExternal
    public File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    پارامترها
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    Returns
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

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

    Recursively push directory contents to device while excluding some directories that are filtered.

    پارامترها
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    Returns
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException
    pushDir
    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    پارامترها
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    Returns
    boolean true if file was pushed successfully. false otherwise.

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

    Recursively push directory contents to device.

    پارامترها
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    userId int : the user id to push to

    Returns
    boolean true if file was pushed successfully. false otherwise.

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

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    پارامترها
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    Returns
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException
    pushFile
    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Push a file to device. By default using a content provider.

    پارامترها
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    Returns
    boolean true if file was pushed successfully. false otherwise.

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

    Push a file to device. By default using a content provider.

    پارامترها
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    userId int : the userId to push to

    Returns
    boolean true if file was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException
    pushString
    public boolean pushString (String contents, 
                    String remoteFilePath)

    Push file created from a string to device

    پارامترها
    contents String : the contents of the file to push

    remoteFilePath String : the remote destination absolute file path

    Returns
    boolean true if string was pushed successfully. false otherwise.

    Throws
    DeviceNotAvailableException
    reboot
    public void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    پارامترها
    reason String : a reason for this reboot, or null if no reason is specified.

    پرتاب می کند
    DeviceNotAvailableException
    reboot
    public void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    Throws
    DeviceNotAvailableException
    rebootIntoBootloader
    public void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    Throws
    DeviceNotAvailableException
    rebootIntoFastbootd
    public void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    Throws
    DeviceNotAvailableException
    rebootIntoRecovery
    public void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    Throws
    DeviceNotAvailableException
    rebootIntoSideload
    public void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    Throws
    DeviceNotAvailableException
    rebootIntoSideload
    public void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    پارامترها
    autoReboot boolean : whether to automatically reboot the device after sideload

    Throws
    DeviceNotAvailableException
    rebootUntilOnline
    public void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    Throws
    DeviceNotAvailableException
    rebootUntilOnline
    public void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    پارامترها
    reason String : a reason for this reboot, or null if no reason is specified.

    Throws
    DeviceNotAvailableException
    rebootUserspace
    public void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    هشدار. Userspace reboot is currently under active development, use it on your own risk.

    Throws
    DeviceNotAvailableException
    rebootUserspaceUntilOnline
    public void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    Throws
    DeviceNotAvailableException
    recoverDevice
    public boolean recoverDevice ()

    Attempts to recover device communication.

    Returns
    boolean True if recovery attempted and successful, returns False if recovery was skipped

    Throws
    DeviceNotAvailableException if device is no longer available
    registerDeviceActionReceiver
    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registers a IDeviceActionReceiver for this device.

    All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

    پارامترها
    deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

    remountSystemReadOnly
    public void remountSystemReadOnly ()

    Make the system partition on the device read-only. May reboot the device.

    Throws
    DeviceNotAvailableException
    remountSystemWritable
    public void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    Throws
    DeviceNotAvailableException
    remountVendorReadOnly
    public void remountVendorReadOnly ()

    Make the vendor partition on the device read-only. May reboot the device.

    Throws
    DeviceNotAvailableException
    remountVendorWritable
    public void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    Throws
    DeviceNotAvailableException
    removeAdmin
    public boolean removeAdmin (String componentName, 
                    int userId)

    Remove given device admin in given user and return true if it is successful, false otherwise.

    پارامترها
    componentName String : of device admin to be removed.

    userId int : of user that the device admin lives in.

    Returns
    boolean True if it is successful, false otherwise.

    Throws
    DeviceNotAvailableException
    removeOwners
    public void removeOwners ()

    Remove all existing device profile owners with the best effort.

    Throws
    DeviceNotAvailableException
    removeUser
    public boolean removeUser (int userId)

    Remove a given user from the device.

    پارامترها
    userId int : of the user to remove

    Returns
    boolean true if we were successful in removing the user, false otherwise.

    پرتاب می کند
    DeviceNotAvailableException
    resetContentProviderSetup
    public void resetContentProviderSetup ()

    Reset the flag for content provider setup in order to trigger it again.

    runInstrumentationTests
    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    ITestLifeCycleReceiver... listeners)

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    پارامترها
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    Returns
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    پرتاب می کند
    DeviceNotAvailableException
    runInstrumentationTests
    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    پارامترها
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    Returns
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    Throws
    DeviceNotAvailableException
    runInstrumentationTestsAsUser
    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                     listeners)

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    پارامترها
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Returns
    boolean

    Throws
    DeviceNotAvailableException
    runInstrumentationTestsAsUser
    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    ITestLifeCycleReceiver... listeners)

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    پارامترها
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Returns
    boolean

    Throws
    DeviceNotAvailableException
    setConfiguration
    public void setConfiguration (IConfiguration configuration)

    Injects the IConfiguration in use.

    پارامترها
    configuration IConfiguration

    setConnectionAvdInfo
    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    پارامترها
    avdInfo GceAvdInfo

    setDate
    public void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    پارامترها
    date Date : specify a particular date; will use host date if null

    Throws
    DeviceNotAvailableException
    setDeviceOwner
    public boolean setDeviceOwner (String componentName, 
                    int userId)

    Set a device admin component as device owner in given user.

    پارامترها
    componentName String : of device admin to be device owner.

    userId int : of the user that the device owner lives in.

    Returns
    boolean True if it is successful, false otherwise.

    Throws
    DeviceNotAvailableException
    setDeviceState
    public void setDeviceState (TestDeviceState deviceState)

    Update the device's state.

    پارامترها
    deviceState TestDeviceState : the TestDeviceState

    setEmulatorOutputStream
    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    For emulator set SizeLimitedOutputStream to log output

    پارامترها
    output SizeLimitedOutputStream : to log the output

    setEmulatorProcess
    public void setEmulatorProcess (Process p)

    Sets the Process , when this device is an emulator.

    پارامترها
    p Process

    setFastbootEnabled
    public void setFastbootEnabled (boolean fastbootEnabled)

    Set the fastboot option for the device. Should be set when device is first allocated.

    پارامترها
    fastbootEnabled boolean : whether fastboot is available for the device or not

    setFastbootPath
    public void setFastbootPath (String fastbootPath)

    Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled() to be true, to have fastboot functions enabled.

    پارامترها
    fastbootPath String

    setIDevice
    public void setIDevice (IDevice newDevice)

    Update the IDevice associated with this ITestDevice.

    The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDevice

    پارامترها
    newDevice IDevice : the IDevice

    setLogStartDelay
    public void setLogStartDelay (int delay)

    Sets the time in ms to wait before starting logcat capture for a online device.

    پارامترها
    delay int : the delay in ms

    setOptions
    public void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    پارامترها
    options TestDeviceOptions

    setProperty
    public boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    پارامترها
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    Returns
    boolean returns True if the setprop command was successful, False otherwise.

    Throws
    DeviceNotAvailableException
    setRecovery
    public void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    پارامترها
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode
    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    پارامترها
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setSetting
    public void setSetting (String namespace, 
                    String key, 
                    String value)

    See setSetting(int, String, String, String) and performed on system user.

    پارامترها
    namespace String

    key String

    value String

    Throws
    DeviceNotAvailableException
    setSetting
    public void setSetting (int userId, 
                    String namespace, 
                    String key, 
                    String value)

    Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

    پارامترها
    userId int

    namespace String

    key String

    value String

    Throws
    DeviceNotAvailableException
    setTestLogger
    public void setTestLogger (ITestLogger testLogger)

    Injects the ITestLogger instance

    پارامترها
    testLogger ITestLogger

    setTrackingSerial
    public void setTrackingSerial (String trackingSerial)

    For device management purpose track the serial we use for referencing the device.

    پارامترها
    trackingSerial String

    setUseFastbootErase
    public void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    پارامترها
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat
    public void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    startUser
    public boolean startUser (int userId)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

    پارامترها
    userId int : of the user to start in the background

    Returns
    boolean true if the user was successfully started in the background.

    Throws
    DeviceNotAvailableException
    startUser
    public boolean startUser (int userId, 
                    boolean waitFlag)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

    پارامترها
    userId int : of the user to start in the background

    waitFlag boolean : will make the command wait until user is started and unlocked.

    Returns
    boolean true if the user was successfully started in the background.

    Throws
    DeviceNotAvailableException
    startVisibleBackgroundUser
    public boolean startVisibleBackgroundUser (int userId, 
                    int displayId, 
                    boolean waitFlag)

    Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

    NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

    پارامترها
    userId int : of the user to start in the background

    displayId int : display to start user visible on

    waitFlag boolean : will make the command wait until user is started and unlocked.

    Returns
    boolean true if the user was successfully started visible in the background.

    Throws
    DeviceNotAvailableException
    stopEmulatorOutput
    public void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat
    public void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    stopUser
    public boolean stopUser (int userId)

    Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

    پارامترها
    userId int : of the user to stop.

    Returns
    boolean true if the user was successfully stopped.

    Throws
    DeviceNotAvailableException
    stopUser
    public boolean stopUser (int userId, 
                    boolean waitFlag, 
                    boolean forceFlag)

    Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

    پارامترها
    userId int : of the user to stop.

    waitFlag boolean : will make the command wait until user is stopped.

    forceFlag boolean : will force stop the user.

    Returns
    boolean true if the user was successfully stopped.

    Throws
    DeviceNotAvailableException
    switchToAdbTcp
    public String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    Returns
    String the tcp serial number or null if device could not be switched

    Throws
    DeviceNotAvailableException
    switchToAdbUsb
    public boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    Returns
    boolean true if switch was successful, false otherwise.

    Throws
    DeviceNotAvailableException
    switchUser
    public boolean switchUser (int userId)

    Switch to another userId with a default timeout. switchUser(int, long) .

    پارامترها
    userId int

    Returns
    boolean True if the new userId matches the userId provider. False otherwise.

    Throws
    DeviceNotAvailableException
    switchUser
    public boolean switchUser (int userId, 
                    long timeout)

    Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

    پارامترها
    userId int

    timeout long : to wait before returning false for switch-user failed.

    Returns
    boolean True if the new userId matches the userId provider. False otherwise.

    Throws
    DeviceNotAvailableException
    syncFiles
    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    پارامترها
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    Returns
    boolean true if files were synced successfully. false otherwise.

    Throws
    DeviceNotAvailableException
    takeBugreport
    public Bugreport takeBugreport ()

    Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

    Returns
    Bugreport

    uninstallPackage
    public String uninstallPackage (String packageName)

    Uninstall an Android package from device.

    Parameters
    packageName String : the Android package to uninstall

    Returns
    String a String with an error code, or null if success.

    Throws
    DeviceNotAvailableException
    uninstallPackageForUser
    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Uninstall an Android package from device for a given user.

    Parameters
    packageName String : the Android package to uninstall

    userId int : the integer user id to uninstall for.

    Returns
    String a String with an error code, or null if success.

    Throws
    DeviceNotAvailableException
    unlockDevice
    public boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    Returns
    boolean true if successful or if the device is unencrypted.

    Throws
    DeviceNotAvailableException
    unmountDebugfs
    public void unmountDebugfs ()

    Unmount debugfs.

    Throws
    DeviceNotAvailableException
    waitForBootComplete
    public boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    پارامترها
    timeOut long : time in msecs to wait for the flag to be set

    Returns
    boolean true if device's boot complete flag is set within the timeout

    Throws
    DeviceNotAvailableException
    waitForDeviceAvailable
    public boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    Returns
    boolean True if device is available, False if recovery is disabled and unavailable.

    Throws
    DeviceNotAvailableException
    waitForDeviceAvailable
    public boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    Parameters
    waitTime long : the time in ms to wait

    Returns
    boolean True if device is available, False if recovery is disabled and unavailable.

    Throws
    DeviceNotAvailableException
    waitForDeviceAvailableInRecoverPath
    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Waits for the device to be responsive and available without considering recovery path.

    Parameters
    waitTime long

    Returns
    boolean True if device is available, False if unavailable.

    Throws
    DeviceNotAvailableException
    waitForDeviceBootloader
    public void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    Throws
    DeviceNotAvailableException
    waitForDeviceInRecovery
    public boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    Parameters
    waitTime long : the time in ms to wait

    Returns
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload
    public boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    Parameters
    waitTime long : the time in ms to wait

    Returns
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable
    public boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    Parameters
    waitTime long : the time in ms to wait

    Returns
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline
    public void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Throws
    DeviceNotAvailableException
    waitForDeviceOnline
    public void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    Parameters
    waitTime long : the time in ms to wait

    Throws
    DeviceNotAvailableException
    waitForDeviceShell
    public boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    Parameters
    waitTime long : the time in ms to wait

    Returns
    boolean true if device becomes responsive before waitTime elapses.

    Protected methods
    addExtraConnectionBuilderArgs
    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parameters
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand
    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection)

    Builds the OS command for the given adb shell command session and args

    Parameters
    command String

    forceExitStatusDetection boolean

    Returns
    String[]

    checkApiLevelAgainst
    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parameters
    feature String

    strictMinLevel int

    createRebootDeviceAction
    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Create a RebootDeviceAction to be used when performing a reboot action.

    Parameters
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Returns
    NativeDevice.RebootDeviceAction the created RebootDeviceAction .

    createRunUtil
    protected IRunUtil createRunUtil ()

    Returns
    IRunUtil

    doAdbReboot
    protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Perform a adb reboot.

    Parameters
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    ensureRuntimePermissionSupported
    protected void ensureRuntimePermissionSupported ()

    helper method to throw exception if runtime permission isn't supported

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    getApiLevelSafe
    protected int getApiLevelSafe ()

    Returns
    int

    getLogger
    protected ITestLogger getLogger ()

    Returns
    ITestLogger

    getRunUtil
    protected IRunUtil getRunUtil ()

    Get the RunUtil instance to use.

    Returns
    IRunUtil

    initializeConnection
    protected void initializeConnection (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    Parameters
    info IBuildInfo

    attributes MultiMap

    پرتاب می کند
    DeviceNotAvailableException
    TargetSetupError
    internalGetProperty
    protected String internalGetProperty (String propName, 
                    String fastbootVar, 
                    String description)

    Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.

    Parameters
    propName String : The name of the device property as returned by `adb shell getprop`

    fastbootVar String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted

    description String : A simple description of the variable. First letter should be capitalized.

    Returns
    String A string, possibly null or empty, containing the value of the given property

    Throws
    DeviceNotAvailableException
    isInRebootCallback
    protected boolean isInRebootCallback ()

    Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.

    Returns
    boolean

    isNewer
    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Return true if local file is newer than remote file. IFileEntry being accurate to the minute, in case of equal times, the file will be considered newer.

    Parameters
    localFile File

    entry IFileEntry

    Returns
    boolean

    notifyRebootEnded
    protected void notifyRebootEnded ()

    Notifies all IDeviceActionReceiver about reboot end event.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    notifyRebootStarted
    protected void notifyRebootStarted ()

    Notifies all IDeviceActionReceiver about reboot start event.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    performDeviceAction
    protected boolean performDeviceAction (String actionDescription, 
                    NativeDevice.DeviceAction action, 
                    int retryAttempts)

    Performs an action on this device. Attempts to recover device and optionally retry command if action fails.

    Parameters
    actionDescription String : a short description of action to be performed. Used for logging purposes only.

    action NativeDevice.DeviceAction : the action to be performed

    retryAttempts int : the retry attempts to make for action if it fails but recovery succeeds

    Returns
    boolean true if action was performed successfully

    Throws
    DeviceNotAvailableException if recovery attempt fails or max attempts done without success
    postAdbReboot
    protected void postAdbReboot ()

    Possible extra actions that can be taken after a reboot.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    prePostBootSetup
    protected void prePostBootSetup ()

    Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.

    Throws
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException
    pullFileInternal
    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    پارامترها
    remoteFilePath String

    localFile File

    Returns
    boolean

    Throws
    DeviceNotAvailableException
    setClock
    protected void setClock (Clock clock)

    Set the Clock instance to use.

    Parameters
    clock Clock

    setMicrodroidProcess
    protected void setMicrodroidProcess (Process process)

    Marks the TestDevice as microdroid and sets its CID.

    Parameters
    process Process : Process of the Microdroid VM.

    setTestDeviceOptions
    protected void setTestDeviceOptions ( deviceOptions)

    Parameters
    deviceOptions

    simpleFastbootCommand
    protected CommandResult simpleFastbootCommand (long timeout, 
                     envVarMap, 
                    String[] fullCmd)

    Executes a simple fastboot command with environment variables and report the status of the command.

    Parameters
    timeout long

    envVarMap

    fullCmd String

    Returns
    CommandResult

    simpleFastbootCommand
    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    Executes a simple fastboot command and report the status of the command.

    Parameters
    timeout long

    fullCmd String

    Returns
    CommandResult

    waitForDeviceNotAvailable
    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Wait to see the device going unavailable (stop reporting to adb).

    Parameters
    operationDesc String : The name of the operation that is waiting for unavailable.

    time long : The time to wait for unavailable to occur.

    Returns
    boolean True if device did become unavailable.