با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice


یک API قابل اعتماد و سطح کمی بالاتر را برای دستگاه ID IDevice می دهد.

دستورات دستگاه را برای مقدار قابل تنظیم دوباره امتحان می کند و برای دستگاه هایی که پاسخگو نیستند یک رابط بازیابی دستگاه ارائه می دهد.

خلاصه

ثابت ها

int UNKNOWN_API_LEVEL

مقدار پیش‌فرض زمانی که سطح API قابل شناسایی نباشد

روش های عمومی

abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

abstract void clearLogcat ()

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

abstract void deleteFile (String deviceFilePath)

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

abstract boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

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

abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

روش کمکی برای بررسی اینکه آیا دستگاه از زمان UTC از دوره زمانی از دستگاه و ERROR(/TimeUnit) است یا خیر.

abstract boolean disableAdbRoot ()

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

abstract boolean doesFileExist (String deviceFilePath)

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

abstract boolean enableAdbRoot ()

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

abstract String executeAdbCommand (long timeout, String... commandArgs)

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

abstract String executeAdbCommand (String... commandArgs)

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

abstract CommandResult executeFastbootCommand (String... commandArgs)

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

abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs)

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

abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

abstract String executeShellCommand (String command)

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

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

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

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

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

abstract void executeShellCommand (String command, IShellOutputReceiver receiver)

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

abstract CommandResult executeShellV2Command (String command)

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

abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)

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

abstract CommandResult executeShellV2Command (String command, File pipeAsInput)

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

abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

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

abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit)

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

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

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

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

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

abstract CommandResult fastbootWipePartition (String partition)

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

abstract int getApiLevel ()

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

abstract String getBasebandVersion ()

روش آسان برای دریافت نسخه بیس باند (رادیویی) این دستگاه.

abstract Integer getBattery ()

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

abstract boolean getBooleanProperty (String name, boolean defaultValue)

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

abstract getBootHistory ()

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

abstract getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

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

abstract String getBootloaderVersion ()

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

abstract InputStreamSource getBugreport ()

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

abstract InputStreamSource getBugreportz ()

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

abstract String getBuildAlias ()

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

abstract String getBuildFlavor ()

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

abstract String getBuildId ()

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

abstract String getBuildSigningKeys ()

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

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

abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

abstract String[] getChildren (String deviceFilePath)

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

abstract String getDeviceClass ()

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

abstract long getDeviceDate ()

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

abstract DeviceDescriptor getDeviceDescriptor ()

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

abstract TestDeviceState getDeviceState ()

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

abstract long getDeviceTimeOffset (Date date)

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

abstract InputStreamSource getEmulatorOutput ()

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

abstract long getExternalStoreFreeSpace ()

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

abstract String getFastbootProductType ()

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

abstract String getFastbootProductVariant ()

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

abstract String getFastbootSerialNumber ()

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

abstract String getFastbootVariable (String variableName)

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

abstract IFileEntry getFileEntry (String path)

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

abstract IDevice getIDevice ()

ارجاعی به دستگاه ID IDevice مرتبط را برمی گرداند.

abstract long getIntProperty (String name, long defaultValue)

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

abstract long getLastExpectedRebootTimeMillis ()

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

abstract int getLaunchApiLevel ()

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

abstract InputStreamSource getLogcat ()

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

abstract InputStreamSource getLogcat (int maxBytes)

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

abstract InputStreamSource getLogcatDump ()

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

abstract InputStreamSource getLogcatSince (long date)

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

abstract String getMountPoint (String mountName)

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

abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

abstract getMountPointInfo ()

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

abstract long getPartitionFreeSpace (String partition)

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

abstract ProcessInfo getProcessByName (String processName)

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

abstract String getProcessPid (String process)

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

abstract String getProductType ()

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

abstract String getProductVariant ()

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

abstract String getProperty (String name)

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

abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

abstract String getSerialNumber ()

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

abstract getTombstones ()

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

abstract long getTotalMemory ()

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

abstract boolean getUseFastbootErase ()

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

abstract boolean isAdbRoot ()
abstract boolean isAdbTcp ()
abstract boolean isAppEnumerationSupported ()

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

abstract boolean isDeviceEncrypted ()

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

abstract boolean isDirectory (String deviceFilePath)

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

abstract boolean isEncryptionSupported ()

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

abstract boolean isExecutable (String fullPath)

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

abstract boolean isHeadless ()

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

abstract boolean isRuntimePermissionSupported ()

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

abstract boolean isStateBootloaderOrFastbootd ()

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

abstract boolean logAnrs ( ITestLogger logger)

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

abstract boolean logBugreport (String dataName, ITestLogger listener)

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

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

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

abstract void nonBlockingReboot ()

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

abstract void postBootSetup ()

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

default void postInvocationTearDown ()

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

abstract void postInvocationTearDown (Throwable invocationException)

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

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

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

abstract boolean pullDir (String deviceFilePath, File localDir)

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

abstract File pullFile (String remoteFilePath, int userId)

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

abstract File pullFile (String remoteFilePath)

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

abstract boolean pullFile (String remoteFilePath, File localFile)

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

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

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

abstract String pullFileContents (String remoteFilePath)

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

abstract File pullFileFromExternal (String remoteFilePath)

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

abstract boolean pushDir (File localDir, String deviceFilePath, excludedDirectories) pushDir (File localDir, String deviceFilePath, excludedDirectories)

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

abstract boolean pushDir (File localDir, String deviceFilePath)

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

abstract boolean pushFile (File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)

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

abstract boolean pushFile (File localFile, String deviceFilePath)

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

abstract boolean pushString (String contents, String deviceFilePath)

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

abstract void reboot ()

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

abstract void reboot (String reason)

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

abstract void rebootIntoBootloader ()

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

abstract void rebootIntoFastbootd ()

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

abstract void rebootIntoRecovery ()

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

abstract void rebootIntoSideload (boolean autoReboot)

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

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

abstract void rebootIntoSideload ()

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

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

abstract void rebootUntilOnline ()

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

abstract void rebootUntilOnline (String reason)

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

abstract void rebootUserspace ()

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

abstract void rebootUserspaceUntilOnline ()

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

abstract void remountSystemWritable ()

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

abstract void remountVendorWritable ()

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

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

روش آسان برای انجام ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) با یک یا چند شنونده به عنوان پارامتر ارسال شده است.

abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

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

abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)

مانند ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) اما آزمایش را برای یک کاربر مشخص اجرا می کند.

abstract 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)) برای کاربر داده شده

abstract void setDate (Date date)

تاریخ را روی دستگاه تنظیم می کند

توجه: تنظیم تاریخ در دستگاه نیاز به روت دارد

abstract void setOptions ( TestDeviceOptions options)

TestDeviceOptions را برای دستگاه تنظیم کنید

abstract boolean setProperty (String propKey, String propValue)

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

abstract void setRecovery ( IDeviceRecovery recovery)

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

abstract void setRecoveryMode ( ITestDevice.RecoveryMode mode)

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

abstract void setUseFastbootErase (boolean useFastbootErase)

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

abstract void startLogcat ()

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

abstract void stopEmulatorOutput ()

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

abstract void stopLogcat ()

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

abstract String switchToAdbTcp ()

دستگاه را به حالت adb-over-tcp تغییر دهید.

abstract boolean switchToAdbUsb ()

دستگاه را به حالت adb از طریق usb تغییر دهید.

abstract boolean syncFiles (File localFileDir, String deviceFilePath)

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

abstract Bugreport takeBugreport ()

یک Bugreport بگیرید و آن را در یک شی Bugreport برمی گرداند تا آن را مدیریت کند.

abstract boolean unlockDevice ()

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

abstract boolean waitForBootComplete (long timeOut)

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

abstract void waitForDeviceAvailable ()

منتظر می ماند تا دستگاه پاسخگو باشد و برای آزمایش در دسترس باشد.

abstract void waitForDeviceAvailable (long waitTime)

منتظر می ماند تا دستگاه پاسخگو باشد و برای آزمایش در دسترس باشد.

abstract void waitForDeviceBootloader ()

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

abstract boolean waitForDeviceInRecovery (long waitTime)

مسدود کردن دستگاه در حالت «بازیابی adb» (توجه داشته باشید که این با IDeviceRecovery است).

abstract boolean waitForDeviceInSideload (long waitTime)

مسدود کردن دستگاه در حالت "adb sideload".

abstract boolean waitForDeviceNotAvailable (long waitTime)

بلوک‌هایی که دستگاه در دسترس نیست، یعنی از adb موجود نیست

abstract void waitForDeviceOnline ()

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

abstract void waitForDeviceOnline (long waitTime)

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

abstract boolean waitForDeviceShell (long waitTime)

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

ثابت ها

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

مقدار پیش‌فرض زمانی که سطح API قابل شناسایی نباشد

مقدار ثابت: -1 (0xffffffff)

روش های عمومی

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

پرتاب می کند
DeviceNotAvailableException

clearLogcat

public abstract void clearLogcat ()

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

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

حذف فایل

public abstract void deleteFile (String deviceFilePath)

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

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

پرتاب می کند
DeviceNotAvailableException

دستگاه نرم افزار راه اندازی مجدد شد

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

پرتاب می کند
RuntimeException اگر دستگاه دلیل بوت غیرعادی داشته باشد
DeviceNotAvailableException

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

پرتاب می کند
RuntimeException اگر دستگاه دلیل بوت غیرعادی داشته باشد
DeviceNotAvailableException

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

public abstract boolean disableAdbRoot ()

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

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

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

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

فعال کردن AdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

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

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

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

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

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

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

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

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

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

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

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

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

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

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

مولفه های
commandArgs String : دستور fastboot و آرگومان هایی که باید اجرا شوند

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

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

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

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

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

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

مولفه های
timeout long : زمان بر حسب میلی ثانیه قبل از انقضای فرمان

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

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

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

اجرایLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

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

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

مولفه های
envVarMap : متغیرهای محیطی سیستم که دستور fastboot با آن اجرا می شود

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

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

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

اجرایLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

مولفه های
commandArgs String : دستور fastboot و آرگومان هایی که باید اجرا شوند

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

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

ShellCommand را اجرا کنید

public abstract String executeShellCommand (String command)

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

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

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

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

ShellCommand را اجرا کنید

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

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

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

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

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

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

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

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

ShellCommand را اجرا کنید

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

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

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

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

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

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

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

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

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

ShellCommand را اجرا کنید

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

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

ShellV2Command را اجرا کنید

public abstract CommandResult executeShellV2Command (String command)

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

مولفه های
command String : دستوری که باید اجرا شود.

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

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

ShellV2Command را اجرا کنید

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

مولفه های
command String : دستوری که باید اجرا شود.

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

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

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

ShellV2Command را اجرا کنید

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

مولفه های
command String : دستوری که باید اجرا شود.

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

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

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

ShellV2Command را اجرا کنید

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

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

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

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

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

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

برمی گرداند
CommandResult

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

همچنین ببینید:

ShellV2Command را اجرا کنید

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

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

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

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

برمی گرداند
CommandResult

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

همچنین ببینید:

ShellV2Command را اجرا کنید

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

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

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

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

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

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

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

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

برمی گرداند
CommandResult

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

همچنین ببینید:

ShellV2Command را اجرا کنید

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

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

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

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

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

pipeToError OutputStream : ERROR(/OutputStream) که در آن خطای std تغییر مسیر داده می‌شود یا null می‌شود.

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

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

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

برمی گرداند
CommandResult

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

همچنین ببینید:

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

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

getApiLevel

public abstract int getApiLevel ()

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

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

پرتاب می کند
DeviceNotAvailableException

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

دریافت باتری

public abstract Integer getBattery ()

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

برمی گرداند
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

مولفه های
name String : نام ملک

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

برمی گرداند
boolean true اگر ویژگی دارای مقدار "1" ، "y" ، "yes" ، "on" ، یا "true" ، اگر ویژگی دارای ارزش "0" ، "n" ، "no" ، "off" باشد، false است. "false" defaultValue در غیر این صورت مقدار پیش فرض.

پرتاب می کند
DeviceNotAvailableException

getBootHistory

public abstract  getBootHistory ()

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

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

پرتاب می کند
DeviceNotAvailableException

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

مولفه های
utcEpochTime long : زمان دستگاه از زمان.

timeUnit TimeUnit : واحد زمان TimeUnit .

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

پرتاب می کند
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

برمی گرداند
String نام مستعار بیلد یا اگر بازیابی نشد به بیلد id برگردید

پرتاب می کند
DeviceNotAvailableException

getBuildFlavor

public abstract String getBuildFlavor ()

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

برمی گرداند
String طعم ساخت و یا اگر آن را نمی توان بازیابی کرد پوچ

پرتاب می کند
DeviceNotAvailableException

getBuildId

public abstract String getBuildId ()

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

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

پرتاب می کند
DeviceNotAvailableException

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

برمی گرداند
DeviceDescriptor

بچه ها بگیر

public abstract String[] getChildren (String deviceFilePath)

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

مولفه های
deviceFilePath String : مسیری است که در دستگاه باید در آن جستجو انجام شود

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

پرتاب می کند
DeviceNotAvailableException

getDeviceClass

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

پرتاب می کند
DeviceNotAvailableException

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

برمی گرداند
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

برمی گرداند
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

مولفه های
date Date

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

پرتاب می کند
DeviceNotAvailableException

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

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

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

برمی گرداند
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

مولفه های
variableName String : نام متغیر

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

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

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getIDevice

public abstract IDevice getIDevice ()

ارجاعی به دستگاه ID IDevice مرتبط را برمی گرداند.

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

برمی گرداند
IDevice دستگاه IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

مولفه های
name String : نام ملک

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

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

پرتاب می کند
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

برمی گرداند
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

پرتاب می کند
DeviceNotAvailableException

getLogcat

public abstract InputStreamSource getLogcat ()

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

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

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

    برمی گرداند
    InputStreamSource

  • getLogcat

    public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

    برمی گرداند
    InputStreamSource

    getLogcatDump

    public abstract InputStreamSource getLogcatDump ()

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

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

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

    getLogcatSince

    public abstract InputStreamSource getLogcatSince (long date)

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

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

    برمی گرداند
    InputStreamSource

    getMountPoint

    public abstract String getMountPoint (String mountName)

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

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

    TODO: move this behavior to IDevice#getMountPoint(String)

    مولفه های
    mountName String : the name of the mount point

    برمی گرداند
    String the mount point or null

    همچنین ببینید:

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Returns a MountPointInfo corresponding to the specified mountpoint path, or null if that path has nothing mounted or otherwise does not appear in /proc/mounts as a mountpoint.

    مولفه های
    mountpoint String

    برمی گرداند
    ITestDevice.MountPointInfo A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

    پرتاب می کند
    DeviceNotAvailableException

    همچنین ببینید:

    getMountPointInfo

    public abstract  getMountPointInfo ()

    Returns a parsed version of the information in /proc/mounts on the device

    برمی گرداند
    A ERROR(/List) of MountPointInfo containing the information in "/proc/mounts"

    پرتاب می کند
    DeviceNotAvailableException

    getPartitionFreeSpace

    public abstract long getPartitionFreeSpace (String partition)

    Helper method to determine amount of free space on device partition.

    مولفه های
    partition String

    برمی گرداند
    long the amount of free space in KB

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getProcessByName

    public abstract ProcessInfo getProcessByName (String processName)

    Helper method runs the "pidof" and "stat" command and returns ProcessInfo object with PID and process start time of the given process.

    مولفه های
    processName String : the proces name String.

    برمی گرداند
    ProcessInfo ProcessInfo of given processName

    پرتاب می کند
    DeviceNotAvailableException

    getProcessPid

    public abstract String getProcessPid (String process)

    Returns the pid of the service or null if something went wrong.

    مولفه های
    process String : The proces name String.

    برمی گرداند
    String

    پرتاب می کند
    DeviceNotAvailableException

    getProductType

    public abstract String getProductType ()

    Convenience method to get the product type of this device.

    This method will work if device is in either adb or fastboot mode.

    برمی گرداند
    String the String product type name. Will not be null

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered, or if product type can not be determined

    getProductVariant

    public abstract String getProductVariant ()

    Convenience method to get the product variant of this device.

    This method will work if device is in either adb or fastboot mode.

    برمی گرداند
    String the String product variant name or null if it cannot be determined

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    getProperty

    public abstract String getProperty (String name)

    Retrieve the given property value from the device.

    مولفه های
    name String : the property name

    برمی گرداند
    String the property value or null if it does not exist

    پرتاب می کند
    DeviceNotAvailableException

    getRecoveryMode

    public abstract ITestDevice.RecoveryMode getRecoveryMode ()

    Get the current recovery mode used for the device.

    برمی گرداند
    ITestDevice.RecoveryMode the current recovery mode used for the device.

    getSerialNumber

    public abstract String getSerialNumber ()

    Convenience method to get serial number of this device.

    برمی گرداند
    String the String serial number

    getTombstones

    public abstract  getTombstones ()

    Fetch and return the list of tombstones from the devices. Requires root.

    method is best-effort so if one tombstone fails to be pulled for any reason it will be missing from the list. Only a DeviceNotAvailableException will terminate the method early.

    برمی گرداند
    A list of tombstone files, empty if no tombstone.

    پرتاب می کند
    DeviceNotAvailableException

    همچنین ببینید:

    getTotalMemory

    public abstract long getTotalMemory ()

    Returns total physical memory size in bytes or -1 in case of internal error

    برمی گرداند
    long

    getUseFastbootErase

    public abstract boolean getUseFastbootErase ()

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

    برمی گرداند
    boolean true if fastboot erase will be used or false if fastboot format will be used.

    همچنین ببینید:

    isAdbRoot

    public abstract boolean isAdbRoot ()

    برمی گرداند
    boolean true if device currently has adb root, false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    isAdbTcp

    public abstract boolean isAdbTcp ()

    برمی گرداند
    boolean true if device is connected to adb-over-tcp, false otherwise.

    isAppEnumerationSupported

    public abstract boolean isAppEnumerationSupported ()

    Check whether platform on device supports app enumeration

    برمی گرداند
    boolean True if app enumeration is supported, false otherwise

    پرتاب می کند
    DeviceNotAvailableException

    isDeviceEncrypted

    public abstract boolean isDeviceEncrypted ()

    Returns if the device is encrypted.

    برمی گرداند
    boolean true if the device is encrypted.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    isDirectory

    public abstract boolean isDirectory (String deviceFilePath)

    Return True if the path on the device is a directory, false otherwise.

    مولفه های
    deviceFilePath String

    برمی گرداند
    boolean

    پرتاب می کند
    DeviceNotAvailableException

    isEncryptionSupported

    public abstract boolean isEncryptionSupported ()

    Returns if encryption is supported on the device.

    برمی گرداند
    boolean true if the device supports encryption.

    پرتاب می کند
    DeviceNotAvailableException

    isExecutable

    public abstract boolean isExecutable (String fullPath)

    Returns True if the file path on the device is an executable file, false otherwise.

    مولفه های
    fullPath String

    برمی گرداند
    boolean

    پرتاب می کند
    DeviceNotAvailableException

    isHeadless

    public abstract boolean isHeadless ()

    Return true if the device is headless (no screen), false otherwise.

    برمی گرداند
    boolean

    پرتاب می کند
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public abstract boolean isRuntimePermissionSupported ()

    Check whether platform on device supports runtime permission granting

    برمی گرداند
    boolean True if runtime permission are supported, false otherwise.

    پرتاب می کند
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public abstract boolean isStateBootloaderOrFastbootd ()

    Returns true if device is in TestDeviceState#FASTBOOT or TestDeviceState.FASTBOOTD .

    برمی گرداند
    boolean

    logAnrs

    public abstract boolean logAnrs (ITestLogger logger)

    Collects and log ANRs from the device.

    مولفه های
    logger ITestLogger : an ITestLogger to log the ANRs.

    برمی گرداند
    boolean True if the logging was successful, false otherwise.

    پرتاب می کند
    DeviceNotAvailableException

    logBugreport

    public abstract boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Helper method to take a bugreport and log it to the reporters.

    مولفه های
    dataName String : name under which the bugreport will be reported.

    listener ITestLogger : an ITestLogger to log the bugreport.

    برمی گرداند
    boolean True if the logging was successful, false otherwise.

    logOnDevice

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

    Log a message in the logcat of the device. This is a safe call that will not throw even if the logging fails.

    مولفه های
    tag String : The tag under which we log our message in the logcat.

    level Log.LogLevel : The debug level of the message in the logcat.

    format String : The message format.

    args Object : the args to be replaced via String.format().

    nonBlockingReboot

    public abstract void nonBlockingReboot ()

    Issues a command to reboot device and returns on command complete and when device is no longer visible to adb.

    پرتاب می کند
    DeviceNotAvailableException

    postBootSetup

    public abstract 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 if connection with device is lost and cannot be recovered.

    postInvocationTearDown

    public void postInvocationTearDown ()

    This method is deprecated.
    Use postInvocationTearDown(Throwable) instead.

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

    postInvocationTearDown

    public abstract void postInvocationTearDown (Throwable invocationException)

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

    مولفه های
    invocationException 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

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

    pullDir

    public abstract 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

    برمی گرداند
    boolean true if file was pulled successfully. false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract 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

    برمی گرداند
    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 if connection with device is lost and cannot be recovered.

    pullFile

    public abstract File pullFile (String remoteFilePath)

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

    مولفه های
    remoteFilePath String : the absolute path to file on device.

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

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract 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.

    برمی گرداند
    boolean true if file was retrieved successfully. false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFile

    public abstract 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

    برمی گرداند
    boolean true if file was retrieved successfully. false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pullFileContents

    public abstract String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    مولفه های
    remoteFilePath String : the absolute path to file on device.

    برمی گرداند
    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 abstract 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

    برمی گرداند
    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 if connection with device is lost and cannot be recovered.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath, 
                     excludedDirectories)

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

    مولفه های
    localDir 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.

    برمی گرداند
    boolean true if file was pushed successfully. false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushDir

    public abstract boolean pushDir (File localDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    مولفه های
    localDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    برمی گرداند
    boolean true if file was pushed successfully. false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath, 
                    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

    deviceFilePath String : the remote destination absolute file path

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

    برمی گرداند
    boolean true if file was pushed successfully. false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushFile

    public abstract boolean pushFile (File localFile, 
                    String deviceFilePath)

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

    مولفه های
    localFile File : the local file to push

    deviceFilePath String : the remote destination absolute file path

    برمی گرداند
    boolean true if file was pushed successfully. false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    pushString

    public abstract boolean pushString (String contents, 
                    String deviceFilePath)

    Push file created from a string to device

    مولفه های
    contents String : the contents of the file to push

    deviceFilePath String : the remote destination absolute file path

    برمی گرداند
    boolean true if string was pushed successfully. false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    reboot

    public abstract void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    پرتاب می کند
    DeviceNotAvailableException if device is not available after reboot

    reboot

    public abstract void reboot (String reason)

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

    Blocks until device becomes available.

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

    مولفه های
    reason String : a reason for this reboot, or null if no reason is specified.

    پرتاب می کند
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoBootloader

    public abstract void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    rebootIntoFastbootd

    public abstract void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    rebootIntoRecovery

    public abstract void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    پرتاب می کند
    DeviceNotAvailableException if device is not available after reboot

    rebootIntoSideload

    public abstract 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

    پرتاب می کند
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootIntoSideload

    public abstract void rebootIntoSideload ()

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

    Blocks until device enters sideload mode

    پرتاب می کند
    DeviceNotAvailableException if device is not in sideload after reboot

    rebootUntilOnline

    public abstract void rebootUntilOnline ()

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

    پرتاب می کند
    DeviceNotAvailableException if device is not available after reboot

    rebootUntilOnline

    public abstract 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 if device is not available after reboot

    همچنین ببینید:

    rebootUserspace

    public abstract void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    WARNING. Userspace reboot is currently under active development, use it on your own risk.

    پرتاب می کند
    DeviceNotAvailableException if device is not available after reboot

    rebootUserspaceUntilOnline

    public abstract void rebootUserspaceUntilOnline ()

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

    پرتاب می کند
    DeviceNotAvailableException if device is not available after reboot

    remountSystemWritable

    public abstract void remountSystemWritable ()

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

    پرتاب می کند
    DeviceNotAvailableException

    remountVendorWritable

    public abstract void remountVendorWritable ()

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

    پرتاب می کند
    DeviceNotAvailableException

    runInstrumentationTests

    public abstract 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)

    برمی گرداند
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    runInstrumentationTests

    public abstract 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

    برمی گرداند
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered. ie test command failed to complete and recovery failed.

    runInstrumentationTestsAsUser

    public abstract 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

    برمی گرداند
    boolean

    پرتاب می کند
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public abstract 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

    برمی گرداند
    boolean

    پرتاب می کند
    DeviceNotAvailableException

    setDate

    public abstract 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

    پرتاب می کند
    DeviceNotAvailableException

    setOptions

    public abstract void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    مولفه های
    options TestDeviceOptions

    setProperty

    public abstract 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.

    برمی گرداند
    boolean returns True if the setprop command was successful, False otherwise.

    پرتاب می کند
    DeviceNotAvailableException

    setRecovery

    public abstract 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 abstract 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.

    setUseFastbootErase

    public abstract 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 abstract 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.

    stopEmulatorOutput

    public abstract void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public abstract 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.

    switchToAdbTcp

    public abstract String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    برمی گرداند
    String the tcp serial number or null if device could not be switched

    پرتاب می کند
    DeviceNotAvailableException

    switchToAdbUsb

    public abstract boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    برمی گرداند
    boolean true if switch was successful, false otherwise.

    پرتاب می کند
    DeviceNotAvailableException

    syncFiles

    public abstract 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

    برمی گرداند
    boolean true if files were synced successfully. false otherwise.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    takeBugreport

    public abstract 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() .

    برمی گرداند
    Bugreport

    unlockDevice

    public abstract 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.

    برمی گرداند
    boolean true if successful or if the device is unencrypted.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.
    UnsupportedOperationException if encryption is not supported on the device.

    waitForBootComplete

    public abstract 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

    برمی گرداند
    boolean true if device's boot complete flag is set within the timeout

    پرتاب می کند
    DeviceNotAvailableException

    waitForDeviceAvailable

    public abstract void waitForDeviceAvailable ()

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

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceAvailable

    public abstract void waitForDeviceAvailable (long waitTime)

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

    مولفه های
    waitTime long : the time in ms to wait

    پرتاب می کند
    DeviceNotAvailableException if device is still unresponsive after waitTime expires.

    waitForDeviceBootloader

    public abstract void waitForDeviceBootloader ()

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

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceInRecovery

    public abstract 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

    برمی گرداند
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload

    public abstract boolean waitForDeviceInSideload (long waitTime)

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

    مولفه های
    waitTime long : the time in ms to wait

    برمی گرداند
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable

    public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

    مولفه های
    waitTime long : the time in ms to wait

    برمی گرداند
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline

    public abstract 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.

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceOnline

    public abstract 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

    پرتاب می کند
    DeviceNotAvailableException if connection with device is lost and cannot be recovered.

    waitForDeviceShell

    public abstract boolean waitForDeviceShell (long waitTime)

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

    مولفه های
    waitTime long : the time in ms to wait

    برمی گرداند
    boolean true if device becomes responsive before waitTime elapses.