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

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

InputStreamSource getScreenshot (String format)

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

InputStreamSource getScreenshot (String format, boolean rescale)

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

InputStreamSource getScreenshot ()

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

String getSerialNumber ()

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

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

مقدار تنظیمات درخواستی را برگردانید.

String getSetting (String namespace, String key)

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

String getSimOperator ()

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

String getSimState ()

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

getTombstones ()

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

long getTotalMemory ()

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

String getTrackingSerial ()

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

getUninstallablePackageNames ()

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

boolean getUseFastbootErase ()

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

int getUserFlags (int userId)

پرچم های یک کاربر معین را پیدا کرده و برگردانید.

getUserInfos ()

نقشه useId به UserInfo را در دستگاه دریافت می کند.

int getUserSerialNumber (int userId)

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

IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

DeviceEvent داده شده را پردازش کنید.

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

boolean hasFeature (String feature)

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

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

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

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

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

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

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

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

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

void invalidatePropertyCache ()
boolean isAdbRoot ()

boolean isAdbTcp ()
boolean isAppEnumerationSupported ()

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

boolean isBypassLowTargetSdkBlockSupported ()

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

boolean isDebugfsMounted ()

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

boolean isDeviceEncrypted ()

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

boolean isDirectory (String path)

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

boolean isEnableAdbRoot ()
boolean isEncryptionSupported ()

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

boolean isExecutable (String fullPath)

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

boolean isFastbootEnabled ()

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

boolean isHeadless ()

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

boolean isHeadlessSystemUserMode ()

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

boolean isMainUserPermanentAdmin ()

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

boolean isMultiUserSupported ()

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

boolean isPackageInstalled (String packageName, String userId)

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

boolean isPackageInstalled (String packageName)

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

boolean isRuntimePermissionSupported ()

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

boolean isStateBootloaderOrFastbootd ()

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

boolean isUserRunning (int userId)

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

boolean isUserSecondary (int userId)

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

boolean isUserVisible (int userId)

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

boolean isUserVisibleOnDisplay (int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

boolean isVisibleBackgroundUsersSupported ()

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

boolean isWifiEnabled ()

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

listDisplayIds ()

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

listDisplayIdsForStartingVisibleBackgroundUsers ()

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

listUsers ()

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

boolean logAnrs ( ITestLogger logger)

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

boolean logBugreport (String dataName, ITestLogger listener)

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

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

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

void mountDebugfs ()

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

void nonBlockingReboot ()

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

void postAdbRootAction ()

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

void postAdbUnrootAction ()

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

void postBootSetup ()

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

void postInvocationTearDown (Throwable exception)

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

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

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

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

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

boolean pullDir (String deviceFilePath, File localDir)

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

boolean pullFile (String remoteFilePath, File localFile)

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

File pullFile (String remoteFilePath, int userId)

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

File pullFile (String remoteFilePath)

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

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

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

String pullFileContents (String remoteFilePath)

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

File pullFileFromExternal (String remoteFilePath)

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

boolean pushDir (File localFileDir, String deviceFilePath, excludedDirectories) 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 که حذف خواهد شد.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

پرتاب می کند
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

timeUnit TimeUnit : واحد زمان TimeUnit برای utcEpochTime داده شده.

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean disableAdbRoot ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public void disableKeyguard ()

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

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean disableNetworkMonitor ()

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

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean disconnectFromWifi ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int : شناسه کاربری که وجود فایل را با آن بررسی کنید

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

پرتاب می کند
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

پرتاب می کند
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

فعال کردن AdbRoot

public boolean enableAdbRoot ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean enableNetworkMonitor ()

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

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

پرتاب می کند
DeviceNotAvailableException

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

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

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

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

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

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

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

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

envMap : محیطی برای تنظیم دستور

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

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

پرتاب می کند
DeviceNotAvailableException

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

public String executeAdbCommand (String... cmdArgs)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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 باز می گرداند ، در غیر این صورت DeviceDescriptor فعلی را برمی گرداند.

برمی گرداند
DeviceDescriptor

getCachedDevicedEscriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

در صورت اختصاص دستگاه ، یک DeviceDescriptor باز می گرداند ، در غیر این صورت 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 اگر پرونده در path داده IFileEntry پیدا null

پرتاب می کند
DeviceNotAvailableException

GetFileentry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

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

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

پرتاب می کند
com.android.tradefed.device.DeviceNotAvailableException
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 به عنوان یک نقطه کوه ظاهر نشود null یک MountPointInfo متناسب با مسیر MountPoint مشخص شده را برمی گرداند.

    پارامترها
    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 (long displayId)

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

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

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

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

    پرتاب می کند
    DeviceNotAvailableException

    getscreenshot

    public InputStreamSource getScreenshot (String format)

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

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

    برمی گرداند
    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 در true استفاده از فرمت Fastboot false در صورت استفاده از Fastboot از فرمت استفاده می شود.

    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 و قبل از بازگشت دستگاه به صورت آنلاین انجام شود ، نادیده بگیرید. اجرای پیش فرض شامل اقدامات اضافی نیست. ADB Root تضمین نمی شود که در این مرحله فعال شود.

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

    پس از عمل

    public void postAdbUnrootAction ()

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

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

    پس از بوت

    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)

    پرتاب می کند
    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

    پرتاب می کند
    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 در غیر این صورت

    پرتاب می کند
    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 در غیر این صورت

    پرتاب می کند
    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 در غیر این صورت

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

    پرتاب می کند
    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.

    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)

    پرتاب می کند
    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 در غیر این صورت

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

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

    پرتاب می کند
    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 در غیر این صورت

    پرتاب می کند
    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 در غیر این صورت

    پرتاب می کند
    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 در غیر این صورت

    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 در غیر این صورت

    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 در غیر این صورت

    پرتاب می کند
    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 در غیر این صورت

    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 در غیر این صورت

    Throws
    DeviceNotAvailableException

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

    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.

    Throws
    DeviceNotAvailableException

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

    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.

    پرتاب می کند
    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.

    Throws
    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

    Throws
    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

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

    IConfiguration در حال استفاده را تزریق می کند.

    پارامترها
    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. در غیر این صورت نادرست است.

    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. در غیر این صورت نادرست است.

    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 در غیر این صورت

    پرتاب می کند
    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.

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

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

    پرتاب می کند
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

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

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

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

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

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

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

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

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

    پارامترها
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

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

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

    پارامترها
    command String

    forceExitStatusDetection boolean

    Returns
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

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

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

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

    پارامترها
    info IBuildInfo

    attributes MultiMap

    Throws
    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.

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

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

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

    پارامترها
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Marks the TestDevice as microdroid and sets its CID.

    پارامترها
    process Process : Process of the Microdroid VM.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

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

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

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

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