NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver , IManagedTestDevice , ITestLoggerReceiver

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

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

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

---

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

خلاصه

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

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

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

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

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

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

ثابت ها

INVALID_USER_ID

public static final int INVALID_USER_ID

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

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

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

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

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

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

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

فیلدها

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

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

NativeDevice

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

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

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

روش های عمومی

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

پرتاب می کند
DeviceNotAvailableException

بررسی اتصال

public boolean checkConnectivity ()

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

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

پرتاب می کند
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

پرتاب می کند
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

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

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

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

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

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

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

پرتاب می کند
DeviceNotAvailableException

createUser

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

createUser

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

createUser

public int createUser (String name)

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

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

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

پرتاب می کند
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

پرتاب می کند
DeviceNotAvailableException

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

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

برمی گرداند
DeviceInspectionResult

حذف فایل

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

پرتاب می کند
DeviceNotAvailableException

حذف فایل

public void deleteFile (String deviceFilePath)

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

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

پرتاب می کند
DeviceNotAvailableException

لغو ثبت DeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

پرتاب می کند
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean disableAdbRoot ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public void disableKeyguard ()

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

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean disableNetworkMonitor ()

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

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean disconnectFromWifi ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

پرتاب می کند
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

پرتاب می کند
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

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

پرتاب می کند
DeviceNotAvailableException

فعال کردن AdbRoot

public boolean enableAdbRoot ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean enableNetworkMonitor ()

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

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

پرتاب می کند
DeviceNotAvailableException

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

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

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

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

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public String executeAdbCommand (String... cmdArgs)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

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

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

اجرایLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

اجرایLongFastbootCommand

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

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

ShellCommand را اجرا کنید

public String executeShellCommand (String command)

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

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

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

پرتاب می کند
DeviceNotAvailableException

ShellCommand را اجرا کنید

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

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

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

پرتاب می کند
DeviceNotAvailableException

ShellCommand را اجرا کنید

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

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

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

پرتاب می کند
DeviceNotAvailableException

ShellCommand را اجرا کنید

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

پرتاب می کند
DeviceNotAvailableException

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd)

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

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

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

پرتاب می کند
DeviceNotAvailableException

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

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

پرتاب می کند
DeviceNotAvailableException

ShellV2Command را اجرا کنید

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

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

پرتاب می کند
DeviceNotAvailableException

ShellV2Command را اجرا کنید

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

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

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

برمی گرداند
CommandResult

پرتاب می کند
DeviceNotAvailableException

ShellV2Command را اجرا کنید

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

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

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

برمی گرداند
CommandResult

پرتاب می کند
DeviceNotAvailableException

ShellV2Command را اجرا کنید

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

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

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

برمی گرداند
CommandResult

پرتاب می کند
DeviceNotAvailableException

ShellV2Command را اجرا کنید

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

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

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

برمی گرداند
CommandResult

پرتاب می کند
DeviceNotAvailableException

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

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

پرتاب می کند
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

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

برمی گرداند
DeviceAllocationState

getAndroidId

public String getAndroidId (int userId)

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

پارامترها
userId	int

برمی گرداند
String

پرتاب می کند
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

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

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

پرتاب می کند
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

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

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

پرتاب می کند
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

پارامترها
packageName	String

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

پرتاب می کند
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

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

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

پرتاب می کند
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

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

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

پرتاب می کند
DeviceNotAvailableException

دریافت باتری

public Integer getBattery ()

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

برمی گرداند
Integer

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

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

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

پرتاب می کند
DeviceNotAvailableException

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

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

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

getBuildAlias

public String getBuildAlias ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

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

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

پرتاب می کند
DeviceNotAvailableException

getBuildId

public String getBuildId ()

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

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

پرتاب می کند
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

برمی گرداند
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

برمی گرداند
DeviceDescriptor

بچه ها بگیر

public String[] getChildren (String path)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

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

برمی گرداند
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

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

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

برمی گرداند
ContentProviderHandler

پرتاب می کند
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

برمی گرداند
DeviceFoldableState

پرتاب می کند
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

برمی گرداند
int

پرتاب می کند
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

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

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

getDeviceDate

public long getDeviceDate ()

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

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

پرتاب می کند
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

برمی گرداند
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

برمی گرداند
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

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

برمی گرداند
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

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

پارامترها
date	Date

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

پرتاب می کند
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

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

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

getEmulatorProcess

public Process getEmulatorProcess ()

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

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

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

برمی گرداند
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

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

پرتاب می کند
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

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

برمی گرداند
String

getFastbootProductType

public String getFastbootProductType ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

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

برمی گرداند
String

getFastbootVariable

public String getFastbootVariable (String variableName)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

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

برمی گرداند
String

getFileEntry

public IFileEntry getFileEntry (String path)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

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

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

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

getFoldableStates

public  getFoldableStates ()

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

برمی گرداند

پرتاب می کند
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

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

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

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

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

پرتاب می کند
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

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

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

پرتاب می کند
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

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

پرتاب می کند
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

برمی گرداند
long

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

پرتاب می کند
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

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

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

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

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

برمی گرداند
InputStreamSource

getLogcat

public InputStreamSource getLogcat (int maxBytes)

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

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

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

برمی گرداند
InputStreamSource

getLogcatDump

public InputStreamSource getLogcatDump ()

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

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

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

getLogcatSince

public InputStreamSource getLogcatSince (long date)

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

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

برمی گرداند
InputStreamSource

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

public String getMacAddress ()

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

برمی گرداند
String

getMainUserId

public Integer getMainUserId ()

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

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

پرتاب می کند
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

پرتاب می کند
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

پرتاب می کند
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

پرتاب می کند
DeviceNotAvailableException

getMicrodroidProcess

public Process getMicrodroidProcess ()

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

getMonitor

public IDeviceStateMonitor getMonitor ()

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

برمی گرداند
IDeviceStateMonitor

getMountPoint

public String getMountPoint (String mountName)

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

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

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

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

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

پارامترها
mountpoint	String

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

پرتاب می کند
DeviceNotAvailableException

getMountPointInfo

public  getMountPointInfo ()

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

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

پرتاب می کند
DeviceNotAvailableException

getOptions

public TestDeviceOptions getOptions ()

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

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

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

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

پارامترها
partition	String

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

پرتاب می کند
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

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

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

پرتاب می کند
DeviceNotAvailableException

getProcessByName

public ProcessInfo getProcessByName (String processName)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getProcessPid

public String getProcessPid (String process)

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

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

برمی گرداند
String

پرتاب می کند
DeviceNotAvailableException

getProductType

public String getProductType ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

getProductVariant

public String getProductVariant ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

getProperty

public String getProperty (String name)

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

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

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

پرتاب می کند
DeviceNotAvailableException

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

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

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public InputStreamSource getScreenshot (String format)

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public InputStreamSource getScreenshot ()

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

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

پرتاب می کند
DeviceNotAvailableException

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

public String getSerialNumber ()

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

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

getSetting

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

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

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

برمی گرداند
String

پرتاب می کند
DeviceNotAvailableException

getSimOperator

public String getSimOperator ()

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

برمی گرداند
String

getSimState

public String getSimState ()

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

برمی گرداند
String

گرفتن سنگ قبر

public  getTombstones ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

getTotalMemory

public long getTotalMemory ()

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

برمی گرداند
long

getTrackingSerial

public String getTrackingSerial ()

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

برمی گرداند
String

getUninstalablePackageNames

public  getUninstallablePackageNames ()

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

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

پرتاب می کند
DeviceNotAvailableException

getUseFastbootErase

public boolean getUseFastbootErase ()

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

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

getUserFlags

public int getUserFlags (int userId)

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

پارامترها
userId	int

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

پرتاب می کند
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

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

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

پرتاب می کند
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

پارامترها
userId	int

برمی گرداند
int

پرتاب می کند
DeviceNotAvailableException

handleAlocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

پارامترها
event	DeviceEvent

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

دارای ویژگی

public boolean hasFeature (String feature)

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

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

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

پرتاب می کند
DeviceNotAvailableException

installPackage

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

installPackage

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

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

installPackageForUser

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

installPackageForUser

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

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot است

public boolean isAdbRoot ()

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isAdbTcp

public boolean isAdbTcp ()

برمی گرداند
boolean

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

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

پرتاب می کند
DeviceNotAvailableException

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

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

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

پرتاب می کند
DeviceNotAvailableException

isDebugfsMounted است

public boolean isDebugfsMounted ()

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

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

پرتاب می کند
DeviceNotAvailableException

isDeviceEncrypted

public boolean isDeviceEncrypted ()

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

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

پرتاب می کند
DeviceNotAvailableException

isDirectory

public boolean isDirectory (String path)

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

پارامترها
path	String

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isEnableAdbRoot است

public boolean isEnableAdbRoot ()

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

isEncryptionSupported

public boolean isEncryptionSupported ()

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

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

پرتاب می کند
DeviceNotAvailableException

قابل اجرا است

public boolean isExecutable (String fullPath)

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

پارامترها
fullPath	String

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isFastbootEnabled است

public boolean isFastbootEnabled ()

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

برمی گرداند
boolean

بی سر است

public boolean isHeadless ()

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

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

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

پرتاب می کند
DeviceNotAvailableException

isPackageInstalled است

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

پرتاب می کند
DeviceNotAvailableException

isPackageInstalled است

public boolean isPackageInstalled (String packageName)

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

پارامترها
packageName	String

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

پرتاب می کند
DeviceNotAvailableException

isRuntimePermissionSupported است

public boolean isRuntimePermissionSupported ()

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

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

پرتاب می کند
DeviceNotAvailableException

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

برمی گرداند
boolean

isUserRunning

public boolean isUserRunning (int userId)

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

پارامترها
userId	int

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

پرتاب می کند
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

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

پارامترها
userId	int

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

پرتاب می کند
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

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

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

پارامترها
userId	int

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

isWifiEnabled است

public boolean isWifiEnabled ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

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

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

پرتاب می کند
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

برمی گرداند

پرتاب می کند
DeviceNotAvailableException

لیست کاربران

public  listUsers ()

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

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

پرتاب می کند
DeviceNotAvailableException

logAnrs

public boolean logAnrs (ITestLogger logger)

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

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

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

پرتاب می کند
DeviceNotAvailableException

گزارش logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

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

logOnDevice

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

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

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

mountDebugfs

public void mountDebugfs ()

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

پرتاب می کند
DeviceNotAvailableException

nonBlockingReboot

public void nonBlockingReboot ()

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

پرتاب می کند
DeviceNotAvailableException

postAdbRootAction

public void postAdbRootAction ()

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

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

postAdbUnrootAction

public void postAdbUnrootAction ()

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

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

postBootSetup

public void postBootSetup ()

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

preInvocationSetup

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

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

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

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

pullDir

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

پرتاب می کند
DeviceNotAvailableException

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

پرتاب می کند
DeviceNotAvailableException

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

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

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

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

پرتاب می کند
DeviceNotAvailableException

pullFile

public File pullFile (String remoteFilePath)

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

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

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

پرتاب می کند
DeviceNotAvailableException

pullFile

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

pullFileContents

public String pullFileContents (String remoteFilePath)

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

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

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

پرتاب می کند
DeviceNotAvailableException

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

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

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

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

پرتاب می کند
DeviceNotAvailableException

pushDir

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

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

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

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

پرتاب می کند
DeviceNotAvailableException

pushDir

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

pushFile

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

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

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

پرتاب می کند
DeviceNotAvailableException

pushFile

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public void reboot (String reason)

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

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public void reboot ()

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

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

پرتاب می کند
DeviceNotAvailableException

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

پرتاب می کند
DeviceNotAvailableException

rebootIntoFastbootd

public void rebootIntoFastbootd ()

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

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

پرتاب می کند
DeviceNotAvailableException

rebootIntoRecovery

public void rebootIntoRecovery ()

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

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

پرتاب می کند
DeviceNotAvailableException

rebootIntoSideload

public void rebootIntoSideload ()

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

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

پرتاب می کند
DeviceNotAvailableException

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

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

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

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

پرتاب می کند
DeviceNotAvailableException

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

public void rebootUntilOnline ()

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

پرتاب می کند
DeviceNotAvailableException

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

public void rebootUntilOnline (String reason)

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

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

پرتاب می کند
DeviceNotAvailableException

rebootUserspace

public void rebootUserspace ()

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

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

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

پرتاب می کند
DeviceNotAvailableException

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

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

پرتاب می کند
DeviceNotAvailableException

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

public boolean recoverDevice ()

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

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

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

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

پارامترها
deviceActionReceiver	IDeviceActionReceiver : یک IDeviceActionReceiver که ثبت خواهد شد.

remountSystemReadOnly

public void remountSystemReadOnly ()

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

پرتاب می کند
DeviceNotAvailableException

remountSystemWritable

public void remountSystemWritable ()

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

پرتاب می کند
DeviceNotAvailableException

remountVendorReadOnly

public void remountVendorReadOnly ()

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

پرتاب می کند
DeviceNotAvailableException

remountVendorWritable

public void remountVendorWritable ()

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

پرتاب می کند
DeviceNotAvailableException

حذف ادمین

public boolean removeAdmin (String componentName, 
                int userId)

ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود true برگردانید، در غیر این صورت false .

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

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

پرتاب می کند
DeviceNotAvailableException

حذف مالکان

public void removeOwners ()

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

پرتاب می کند
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

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

پارامترها
userId	int : کاربر برای حذف

برمی گرداند
boolean	درست است اگر در حذف کاربر موفق بودیم، در غیر این صورت نادرست است.

پرتاب می کند
DeviceNotAvailableException

resetContentProviderSetup

public void resetContentProviderSetup ()

پرچم را برای راه اندازی ارائه دهنده محتوا بازنشانی کنید تا دوباره فعال شود.

runInstrumentationTests

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

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

پارامترها
runner	IRemoteAndroidTestRunner : IRemoteAndroidTestRunner که تست ها را اجرا می کند
listeners	ITestLifeCycleReceiver : شنونده(های) نتیجه آزمایش

برمی گرداند
boolean	true اگر دستور تست تکمیل شود. اگر تکمیل نشد، false ، اما بازیابی با موفقیت انجام شد

پرتاب می کند
DeviceNotAvailableException

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

اگر قبل از اجرای آزمایشی اتصال با دستگاه قطع شود و بازیابی موفقیت آمیز باشد، همه شنوندگان از testRunFailed مطلع می شوند و "false" برگردانده می شود. دستور تست مجددا اجرا نمی شود. این به تماس گیرندگان واگذار می شود که در صورت لزوم دوباره تلاش کنند.

اگر قبل از اجرای آزمایشی اتصال با دستگاه قطع شود، و بازیابی ناموفق باشد، همه شنوندگان از testRunFailed مطلع می شوند و DeviceNotAvailableException پرتاب می شود.

پارامترها
runner	IRemoteAndroidTestRunner : IRemoteAndroidTestRunner که تست ها را اجرا می کند
listeners	: شنوندگان نتیجه آزمون

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

پرتاب می کند
DeviceNotAvailableException

runInstrumentationTestsAsUser

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

مانند ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) اما تست را برای کاربر مورد نظر اجرا می کند.

پارامترها
runner	IRemoteAndroidTestRunner
userId	int
listeners

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

runInstrumentationTestsAsUser

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

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

پارامترها
runner	IRemoteAndroidTestRunner
userId	int
listeners	ITestLifeCycleReceiver

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

پیکربندی set

public void setConfiguration (IConfiguration configuration)

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

پارامترها
configuration	IConfiguration

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

پارامترها
avdInfo	GceAvdInfo

setDate

public void setDate (Date date)

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

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

پارامترها
date	Date : تاریخ خاصی را مشخص کنید. در صورت null از تاریخ میزبان استفاده خواهد کرد

پرتاب می کند
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید.

پارامترها
componentName	String : مدیر دستگاه که مالک دستگاه باشد.
userId	int : کاربری که صاحب دستگاه در آن زندگی می کند.

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

پرتاب می کند
DeviceNotAvailableException

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

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

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

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

برای شبیه ساز SizeLimitedOutputStream برای ورود به خروجی تنظیم کنید

پارامترها
output	SizeLimitedOutputStream : برای ثبت خروجی

setEmulatorProcess

public void setEmulatorProcess (Process p)

هنگامی که این دستگاه شبیه ساز است، Process را تنظیم می کند.

پارامترها
p	Process

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

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

پارامترها
fastbootEnabled	boolean : آیا فست بوت برای دستگاه موجود است یا خیر

setFastbootPath

public void setFastbootPath (String fastbootPath)

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

پارامترها
fastbootPath	String

setIDevice

public void setIDevice (IDevice newDevice)

IDevice مرتبط با این ITestDevice را به روز کنید.

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

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

setLogStartDelay

public void setLogStartDelay (int delay)

زمان انتظار را قبل از شروع ضبط logcat برای یک دستگاه آنلاین بر حسب میلی ثانیه تنظیم می کند.

پارامترها
delay	int : تاخیر در ms

setOptions

public void setOptions (TestDeviceOptions options)

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

پارامترها
options	TestDeviceOptions

setProperty

public boolean setProperty (String propKey, 
                String propValue)

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

پارامترها
propKey	String : کلیدی که باید تنظیم شود.
propValue	String : مقدار خاصیت که باید تنظیم شود.

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

پرتاب می کند
DeviceNotAvailableException

setRecovery

public void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

پارامترها
mode	ITestDevice.RecoveryMode : حالت «بازیابی فقط تا آنلاین» باید روشن باشد یا خیر.

setSetting

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

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

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

پرتاب می کند
DeviceNotAvailableException

setSetting

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

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

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

پرتاب می کند
DeviceNotAvailableException

setTestLogger

public void setTestLogger (ITestLogger testLogger)

نمونه ITestLogger را تزریق می کند

پارامترها
testLogger	ITestLogger

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

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

پارامترها
trackingSerial	String

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

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

پارامترها
useFastbootErase	boolean : اگر از فرمت فست بوت استفاده شود true یا اگر از فرمت فست بوت استفاده شود false .

startLogcat

public void startLogcat ()

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

اگر خروجی logcat از قبل گرفته شده باشد، تاثیری نخواهد داشت. داده ها را می توان بعداً از طریق getLogcat بازیابی کرد.

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

startLogcat() و stopLogcat() معمولاً نیازی به فراخوانی در یک زمینه فراخوانی TF ندارند، زیرا چارچوب TF logcat را شروع و متوقف می کند.

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

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

پارامترها
timeoutMs	int

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

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

startUser

public boolean startUser (int userId)

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

پارامترها
userId	int : کاربر برای شروع در پس زمینه

برمی گرداند
boolean	درست است اگر کاربر با موفقیت در پس‌زمینه راه‌اندازی شده باشد.

پرتاب می کند
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پس‌زمینه راه‌اندازی می‌کند. اگر کاربر قبلاً در پس‌زمینه اجرا می‌شود، این روش یک NOOP است. امکان ارائه پرچم اضافی برای منتظر ماندن برای تأثیرگذاری عملیات.

پارامترها
userId	int : کاربر برای شروع در پس زمینه
waitFlag	boolean : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند.

برمی گرداند
boolean	درست است اگر کاربر با موفقیت در پس‌زمینه راه‌اندازی شده باشد.

پرتاب می کند
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

توجه: این دستور بررسی نمی کند که آیا کاربر وجود دارد، نمایشگر موجود است، device supports such feature و غیره.

پارامترها
userId	int : کاربر برای شروع در پس زمینه
displayId	int : نمایش برای شروع قابل مشاهده کاربر
waitFlag	boolean : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند.

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

پرتاب می کند
DeviceNotAvailableException

stopEmulatorOutput

public void stopEmulatorOutput ()

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

stopLogcat

public void stopLogcat ()

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

اگر خروجی logcat گرفته نشود تاثیری نخواهد داشت.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

آزمایش حالت تجارت در را متوقف کنید.

پرتاب می کند
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

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

پارامترها
userId	int : کاربر برای توقف.

برمی گرداند
boolean	درست است اگر کاربر با موفقیت متوقف شود.

پرتاب می کند
DeviceNotAvailableException

stopUser

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

یک کاربر معین را متوقف کنید. امکان ارائه پرچم‌های اضافی برای منتظر ماندن برای تأثیرگذاری عملیات و خاتمه اجباری کاربر. کاربر فعلی و سیستم را نمی توان متوقف کرد.

پارامترها
userId	int : کاربر برای توقف.
waitFlag	boolean : فرمان را منتظر می ماند تا کاربر متوقف شود.
forceFlag	boolean : کاربر را مجبور به توقف می کند.

برمی گرداند
boolean	درست است اگر کاربر با موفقیت متوقف شود.

پرتاب می کند
DeviceNotAvailableException

switchToAdbTcp

public String switchToAdbTcp ()

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

برمی گرداند
String	شماره سریال tcp یا در صورت عدم تغییر دستگاه، null

پرتاب می کند
DeviceNotAvailableException

switchToAdbUsb

public boolean switchToAdbUsb ()

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

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

پرتاب می کند
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId)

به userId دیگری با مهلت زمانی پیش‌فرض تغییر وضعیت دهید. switchUser(int, long) .

پارامترها
userId	int

برمی گرداند
boolean	اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است.

پرتاب می کند
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

پارامترها
userId	int
timeout	long : منتظر ماندن قبل از بازگشت false برای سوئیچ کاربر ناموفق بود.

برمی گرداند
boolean	اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است.

پرتاب می کند
DeviceNotAvailableException

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

با مقایسه مُهرهای زمانی فایل‌های محلی با معادل‌های راه دور، تصمیم می‌گیرد کدام فایل‌ها را فشار دهد. فقط فایل‌های «جدیدتر» یا ناموجود به دستگاه منتقل می‌شوند. بنابراین اگر فایل تنظیم شده روی دستگاه از قبل به روز باشد، سربار باید نسبتاً کوچک باشد.

فایل های مخفی (با نام هایی که با "." شروع می شوند) نادیده گرفته می شوند.

مثال استفاده: syncFiles("/tmp/files"، "/sdcard") یک دایرکتوری /sdcard/files را در صورتی که از قبل وجود نداشته باشد ایجاد می کند و به صورت بازگشتی محتویات /tmp/files را به /sdcard/files فشار می دهد.

پارامترها
localFileDir	File : فهرست فایل محلی حاوی فایل هایی برای فشار دادن بازگشتی.
deviceFilePath	String : ریشه مسیر فایل مطلق مقصد راه دور. همه دایرکتوری ها در مسیر فایل باید قابل خواندن باشند. یعنی فشار دادن به /data/local/tmp زمانی که adb روت نیست با شکست مواجه خواهد شد

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

پرتاب می کند
DeviceNotAvailableException

takeBugreport

public Bugreport takeBugreport ()

یک Bugreport بگیرید و آن را در یک شی Bugreport برمی گرداند تا آن را مدیریت کند. در صورت مشکل، باطل برگردانید. فایل ارجاع شده در شی Bugreport باید از طریق Bugreport.close() پاک شود.

برمی گرداند
Bugreport

UninstallPackage

public String uninstallPackage (String packageName)

یک بسته Android را از دستگاه حذف نصب کنید.

پارامترها
packageName	String : بسته Android برای حذف نصب

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

پرتاب می کند
DeviceNotAvailableException

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

یک بسته Android را برای یک کاربر خاص از دستگاه حذف نصب کنید.

پارامترها
packageName	String : بسته Android برای حذف نصب
userId	int : شناسه کاربری عدد صحیح برای حذف نصب.

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

پرتاب می کند
DeviceNotAvailableException

باز کردن قفل دستگاه

public boolean unlockDevice ()

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

این متد ممکن است چارچوب را مجددا راه اندازی کند اما postBootSetup() را فراخوانی نخواهد کرد. بنابراین، ممکن است هنگام بازگشت این روش، دستگاه به طور کامل برای آزمایش آماده نباشد.

برمی گرداند
boolean	در صورت موفقیت یا عدم رمزگذاری دستگاه true .

پرتاب می کند
DeviceNotAvailableException

UnmountDebugfs

public void unmountDebugfs ()

حذف اشکال زدایی

پرتاب می کند
DeviceNotAvailableException

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

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

پارامترها
timeOut	long : زمان انتظار برای تنظیم پرچم بر حسب میلی ثانیه

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

پرتاب می کند
DeviceNotAvailableException

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

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

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

پرتاب می کند
DeviceNotAvailableException

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

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

پارامترها
waitTime	long : زمان انتظار بر حسب ms

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

پرتاب می کند
DeviceNotAvailableException

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

پارامترها
waitTime	long

برمی گرداند
boolean	درست اگر دستگاه در دسترس باشد، نادرست اگر در دسترس نباشد.

پرتاب می کند
DeviceNotAvailableException

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

پرتاب می کند
DeviceNotAvailableException

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

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

پارامترها
waitTime	long : زمان انتظار بر حسب ms

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

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

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

پارامترها
waitTime	long : زمان انتظار بر حسب ms

برمی گرداند
boolean	true اگر دستگاه قبل از انقضای زمان در بار جانبی بوت شود. false در غیر این صورت

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

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

پارامترها
waitTime	long : زمان انتظار بر حسب ms

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

waitForDeviceOnline

public void waitForDeviceOnline ()

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

توجه داشته باشید که دستگاه ممکن است لزوماً به دستورات پس از تکمیل پاسخگو نباشد. به جای آن از waitForDeviceAvailable() استفاده کنید.

پرتاب می کند
DeviceNotAvailableException

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

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

توجه داشته باشید که دستگاه ممکن است لزوماً به دستورات پس از تکمیل پاسخگو نباشد. به جای آن از waitForDeviceAvailable() استفاده کنید.

پارامترها
waitTime	long : زمان انتظار بر حسب ms

پرتاب می کند
DeviceNotAvailableException

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

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

پارامترها
waitTime	long : زمان انتظار بر حسب ms

برمی گرداند
boolean	true اگر دستگاه قبل از سپری شدن waitTime پاسخگو شود.

روش های محافظت شده

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

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

buildAdbShellCommand

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

دستور OS را برای جلسه دستور adb shell داده شده می سازد و args می کند

پارامترها
command	String
forceExitStatusDetection	boolean

برمی گرداند
String[]

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

پارامترها
feature	String
strictMinLevel	int

createRebootDeviceAction

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

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

پارامترها
rebootMode	NativeDevice.RebootMode : حالتی از این راه‌اندازی مجدد.
reason	String : برای این راه اندازی مجدد.

برمی گرداند
NativeDevice.RebootDeviceAction	RebootDeviceAction ایجاد شده

createRunUtil

protected IRunUtil createRunUtil ()

برمی گرداند
IRunUtil

doAdbReboot

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

یک راه اندازی مجدد adb انجام دهید.

پارامترها
rebootMode	NativeDevice.RebootMode : حالتی از این راه‌اندازی مجدد.
reason	String : برای این راه اندازی مجدد.

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

sureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

روش کمکی برای پرتاب استثنا در صورت عدم پشتیبانی از مجوز زمان اجرا

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

getApiLevelSafe

protected int getApiLevelSafe ()

برمی گرداند
int

getLogger

protected ITestLogger getLogger ()

برمی گرداند
ITestLogger

getRunUtil

protected IRunUtil getRunUtil ()

نمونه RunUtil را برای استفاده دریافت کنید.

برمی گرداند
IRunUtil

InitializeConnection

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

پارامترها
info	IBuildInfo
attributes	MultiMap

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

insideGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

یک ویژگی دستگاه را از کش ddmlib به طور پیش‌فرض واکشی کنید و بسته به اینکه دستگاه در Fastboot باشد یا خیر، به «adb shell getprop» یا «fastboot getvar» برگردید.

پارامترها
propName	String : نام ویژگی دستگاه که توسط «adb shell getprop» برگردانده شده است
fastbootVar	String : نام متغیر fastboot معادل query. اگر null ، کوئری فست بوت انجام نخواهد شد
description	String : یک توضیح ساده از متغیر. حرف اول باید بزرگ باشد.

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

پرتاب می کند
DeviceNotAvailableException

isInRebootCallback است

protected boolean isInRebootCallback ()

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

برمی گرداند
boolean

جدیدتر است

protected boolean isNewer (File localFile, 
                IFileEntry entry)

اگر فایل محلی جدیدتر از فایل راه دور باشد، true برگردانید. IFileEntry با دقت به دقیقه، در صورت مساوی بودن، فایل جدیدتر در نظر گرفته می شود.

پارامترها
localFile	File
entry	IFileEntry

برمی گرداند
boolean

notifyRebootEnded

protected void notifyRebootEnded ()

به همه IDeviceActionReceiver درباره رویداد پایان راه‌اندازی مجدد اطلاع می‌دهد.

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

notifyRebootStarted

protected void notifyRebootStarted ()

همه IDeviceActionReceiver در مورد رویداد شروع راه اندازی مجدد مطلع می کند.

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

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

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

پارامترها
actionDescription	String : شرح کوتاهی از اقدامی که باید انجام شود. فقط برای اهداف ورود به سیستم استفاده می شود.
action	NativeDevice.DeviceAction : اقدامی که باید انجام شود
retryAttempts	int : تلاش مجدد برای انجام عمل در صورت شکست اما بازیابی موفق است

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

پرتاب می کند
DeviceNotAvailableException	اگر تلاش برای بازیابی با شکست مواجه شد یا حداکثر تلاش بدون موفقیت انجام شد

postAdbReboot

protected void postAdbReboot ()

اقدامات اضافی احتمالی که می توان پس از راه اندازی مجدد انجام داد.

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

prePostBootSetup

protected void prePostBootSetup ()

به هر نوع دستگاه (AndroidNativeDevice، TestDevice) اجازه می‌دهد این روش را برای راه‌اندازی خاص پس از بوت لغو کند.

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

پارامترها
remoteFilePath	String
localFile	File

برمی گرداند
boolean

پرتاب می کند
DeviceNotAvailableException

setClock

protected void setClock (Clock clock)

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

پارامترها
clock	Clock

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

TestDevice را به عنوان microdroid علامت گذاری کرده و CID آن را تنظیم می کند.

پارامترها
process	Process : فرآیند Microdroid VM.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

پارامترها
deviceOptions

simpleFastbootCommand

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

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

پارامترها
timeout	long
envVarMap
fullCmd	String

برمی گرداند
CommandResult

simpleFastbootCommand

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

یک فرمان ساده fastboot را اجرا می کند و وضعیت فرمان را گزارش می کند.

پارامترها
timeout	long
fullCmd	String

برمی گرداند
CommandResult

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

منتظر بمانید تا دستگاه در دسترس نباشد (گزارش به adb را متوقف کنید).

پارامترها
operationDesc	String : نام عملیاتی که در انتظار آن در دسترس نیست.
time	long : زمان انتظار برای رخ دادن غیرقابل دسترس بودن.

برمی گرداند
boolean	اگر دستگاه در دسترس نباشد درست است.