INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

زیر کلاس های غیر مستقیم شناخته شده IManagedTestDevice ، ITestDevice ، LocalAndroidVirtualDevice ، ManagedRemoteDevice ، NativeDevice ، NestedRemoteDevice ، RemoteAndroidDevice ، RemoteAndroidVirtualDevice ، TestDevice IManagedTestDevice ITestDevice که چرخه عمر آن مدیریت می شود. ITestDevice یک API قابل اعتماد و سطح کمی بالاتر را برای IDevice ddmlib ارائه می دهد. LocalAndroid Virtual Device کلاس برای دستگاه های مجازی محلی که روی هاست TradeFed اجرا می شوند. ManagedRemoteDevice دستگاهی که در داخل یک ماشین مجازی اجرا می شود که ما از راه دور از طریق یک نمونه Tradefed در داخل VM آن را مدیریت می کنیم. NativeDevice اجرای پیش‌فرض دستگاه‌های اندرویدی ITestDevice بدون پشته. NestedRemoteDevice نمایش دستگاه در حال اجرا در داخل یک ماشین مجازی Cuttlefish از راه دور. RemoteAndroidDevice پیاده سازی ITestDevice برای یک دستگاه اندرویدی تمام پشته متصل از طریق adb connect. RemoteAndroid Virtual Device رفتار RemoteAndroidDevice برای یک دستگاه Android با پشته کامل که در موتور محاسباتی Google (Gce) اجرا می شود، گسترش می دهد. TestDevice پیاده سازی ITestDevice برای یک دستگاه اندرویدی تمام پشته

---

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

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

خلاصه

ثابت ها
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 String	executeAdbCommand (long timeout, envMap, String... commandArgs) executeAdbCommand (long timeout, envMap, String... commandArgs) متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند.
abstract CommandResult	executeFastbootCommand (long timeout, String... commandArgs) متد Helper که دستور fastboot را به عنوان دستور سیستم اجرا می کند.
abstract CommandResult	executeFastbootCommand (String... commandArgs) روش Helper که یک فرمان fastboot را به عنوان یک فرمان سیستم با زمان پیش فرض 2 دقیقه اجرا می کند.
abstract CommandResult	executeLongFastbootCommand (String... commandArgs) متد Helper که یک فرمان طولانی در حال اجرا fastboot را به عنوان فرمان سیستم اجرا می کند.
abstract CommandResult	executeLongFastbootCommand ( envVarMap, String... commandArgs) executeLongFastbootCommand ( envVarMap, String... commandArgs) روش کمکی که یک فرمان طولانی در حال اجرا سریع بوت را به عنوان فرمان سیستم با متغیرهای محیط سیستم اجرا می کند.
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 shell داده شده را اجرا می کند و در صورت شکست دستور چندین بار دوباره امتحان می کند.
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 String	getBuildAlias () نام مستعار بیلدی که دستگاه در حال حاضر در حال اجرا است را بازیابی کنید.
abstract String	getBuildFlavor () طعم ساخت دستگاه را بازیابی کنید.
abstract String	getBuildId () بیلدی که دستگاه در حال اجرا است را بازیابی کنید.
abstract String	getBuildSigningKeys () نوع کلید مورد استفاده برای امضای تصویر دستگاه را برمی‌گرداند معمولاً دستگاه‌های Android ممکن است با کلیدهای آزمایشی (مانند AOSP) یا کلیدهای انتشار (که توسط سازنده‌های دستگاه کنترل می‌شوند) امضا شوند.
abstract DeviceDescriptor	getCachedDeviceDescriptor () اگر دستگاه اختصاص داده شده باشد، DeviceDescriptor ذخیره شده را برمی‌گرداند، در غیر این صورت DeviceDescriptor فعلی را برمی‌گرداند.
abstract DeviceDescriptor	getCachedDeviceDescriptor (boolean shortDescriptor) اگر دستگاه اختصاص داده شده باشد، DeviceDescriptor ذخیره شده را برمی‌گرداند، در غیر این صورت DeviceDescriptor فعلی را برمی‌گرداند.
abstract String[]	getChildren (String deviceFilePath) جایگزینی برای استفاده از IFileEntry که گاهی اوقات به دلیل مجوزها کار نمی کند.
abstract AbstractConnection	getConnection () اتصال مرتبط با دستگاه را برمی‌گرداند.
abstract String	getDeviceClass () کلاس دستگاه را دریافت کنید.
abstract long	getDeviceDate () تاریخ دستگاه را بر حسب میلی‌ثانیه از آن دوره برگردانید.
abstract DeviceDescriptor	getDeviceDescriptor () یک DeviceDescriptor را از اطلاعات دستگاه برگردانید تا اطلاعات مربوط به آن را بدون عبور از شی دستگاه واقعی دریافت کنید.
abstract DeviceDescriptor	getDeviceDescriptor (boolean shortDescriptor) یک 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 () شماره سریال حالت فست بوت را برمی گرداند.
abstract String	getFastbootVariable (String variableName) مقدار متغیر fastboot داده شده را از دستگاه بازیابی کنید.
abstract IFileEntry	getFileEntry (String path) یک مرجع به یک فایل راه دور در دستگاه را بازیابی کنید.
abstract IDevice	getIDevice () یک ارجاع به IDevice ddmlib مرتبط را برمی‌گرداند.
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	isBypassLowTargetSdkBlockSupported () بررسی کنید که آیا پلتفرم روی دستگاه از دور زدن بلوک sdk هدف پایین در نصب برنامه پشتیبانی می‌کند یا خیر
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 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	remountSystemReadOnly () پارتیشن سیستم را روی دستگاه فقط خواندنی کنید.
abstract void	remountSystemWritable () پارتیشن سیستم روی دستگاه را قابل نوشتن کنید.
abstract void	remountVendorReadOnly () پارتیشن فروشنده روی دستگاه را فقط خواندنی کنید.
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, 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 boolean	runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) مانند ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) اما آزمایش را برای یک کاربر مشخص اجرا می کند.
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 boolean	unlockDevice () اگر دستگاه در حالت رمزگذاری شده باشد، قفل دستگاه را باز می کند.
abstract boolean	waitForBootComplete (long timeOut) مسدود می شود تا زمانی که پرچم کامل بوت دستگاه تنظیم شود.
abstract boolean	waitForDeviceAvailable () منتظر می ماند تا دستگاه پاسخگو و برای آزمایش در دسترس باشد.
abstract boolean	waitForDeviceAvailable (long waitTime) منتظر می ماند تا دستگاه پاسخگو و برای آزمایش در دسترس باشد.
abstract boolean	waitForDeviceAvailableInRecoverPath (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	اگر سطح پشتیبانی شود درست است. در غیر این صورت نادرست است.

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

clearLogcat

public abstract void clearLogcat ()

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

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

حذف فایل

public abstract void deleteFile (String deviceFilePath)

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

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

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

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

پرتاب می کند
RuntimeException	اگر دستگاه دلیل بوت غیرعادی داشته باشد
	com.android.tradefed.device.DeviceNotAvailableException
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	اگر دستگاه دلیل بوت غیرعادی داشته باشد
	com.android.tradefed.device.DeviceNotAvailableException
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	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

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

اجرایLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

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

اجرایLongFastbootCommand

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

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

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

مولفه های
envVarMap	: متغیرهای محیطی سیستم که دستور fastboot با آنها اجرا می شود
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 بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

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

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

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

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 بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

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

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

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

ShellCommand را اجرا کنید

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

ShellV2Command را اجرا کنید

public 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 بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

برمی گرداند
CommandResult

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

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

• executeShellV2Command(String)
• TimeUtil

ShellV2Command را اجرا کنید

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

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

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

برمی گرداند
CommandResult

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

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

• executeShellV2Command(String)
• TimeUtil

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 بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

برمی گرداند
CommandResult

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

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

• executeShellV2Command(String)
• TimeUtil

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 بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود.

برمی گرداند
CommandResult

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

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

• executeShellV2Command(String)
• TimeUtil

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 دستگاه را نشان می دهد

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

برمی گرداند
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

برمی گرداند
DeviceDescriptor

بچه ها بگیر

public abstract String[] getChildren (String deviceFilePath)

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

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

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

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

getConnection

public abstract AbstractConnection getConnection ()

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

برمی گرداند
AbstractConnection

getDeviceClass

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

برمی گرداند
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

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

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

برمی گرداند
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 داده شده یافت نشد

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

getIDevice

public abstract IDevice getIDevice ()

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

هر بار که دستگاه از 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 راه اندازی شده دستگاه است

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

getLogcat

public abstract InputStreamSource getLogcat ()

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

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

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

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

برمی گرداند
InputStreamSource

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

Useful for cases when you want to capture frequent snapshots of the captured logcat data without incurring the potentially big disk space penalty of getting the entire getLogcat() snapshot.

مولفه های
maxBytes	int : the maximum amount of data to return. Should be an amount that can comfortably fit in memory

برمی گرداند
InputStreamSource

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

Get a dump of the current logcat for device. Unlike getLogcat() , this method will always return a static dump of the logcat.

Has the disadvantage that nothing will be returned if device is not reachable.

برمی گرداند
InputStreamSource	a InputStreamSource of the logcat data. An empty stream is returned if fail to capture logcat data.

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

Grabs a snapshot stream of captured logcat data starting the date provided. The time on the device should be used getDeviceDate() .

مولفه های
date	long : in millisecond since epoch format of when to start the snapshot until present. (can be be obtained using 'date +%s')

برمی گرداند
InputStreamSource

getMountPoint

public abstract String getMountPoint (String mountName)

Returns a mount point.

Queries the device directly if the cached info in IDevice is not available.

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

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

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

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

• IDevice.getMountPoint(String)

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

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

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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

گرفتن سنگ قبر

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.

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

پرتاب می کند
DeviceNotAvailableException

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

• Tombstones documentation

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.

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

• fastbootWipePartition(String)

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

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

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

Check whether platform on device supports bypassing low target sdk block on app installs

برمی گرداند
boolean	True if bypass low target sdk block is supported, false otherwise

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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

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

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

Returns if encryption is supported on the device.

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

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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

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.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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 ()

این روش منسوخ شده است.
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
	com.android.tradefed.device.DeviceNotAvailableException
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

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

• reboot(String)

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

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

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

remountSystemWritable

public abstract void remountSystemWritable ()

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

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

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

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

remountVendorWritable

public abstract void remountVendorWritable ()

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

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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, 
                 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

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

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

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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.

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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.

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

• fastbootWipePartition(String)

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

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

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Switch device to adb over usb mode.

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

پرتاب می کند
	com.android.tradefed.device.DeviceNotAvailableException
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.

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

برمی گرداند
boolean	True if device is available, False if recovery is disabled and unavailable.

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

برمی گرداند
boolean	True if device is available, False if recovery is disabled and unavailable.

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

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

مولفه های
waitTime	long

برمی گرداند
boolean	True if device is available, False if unavailable.

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

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.