public class NativeDevice
extends Object
implements IConfigurationReceiver , IManagedTestDevice , ITestLoggerReceiver
java.lang.object | |
↳ | com.android.tradefed.device.NativeDevice |
اجرای پیشفرض دستگاههای اندرویدی ITestDevice
بدون پشته.
class | NativeDevice.AdbAction یک |
class | NativeDevice.AdbShellAction |
class | NativeDevice.RebootDeviceAction |
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) یک |
void | batchPrefetchStartupBuildProps () بهینهسازی میکرو (حدود 400 میلیلیتر) با واکشی از قبل همه لوازم مورد نیاز ما به جای فراخوانی «adb getprop» برای هر یک. |
boolean | canSwitchToHeadlessSystemUser () برمیگرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر. |
boolean | checkApiLevelAgainstNextRelease (int strictMinLevel) بررسی کنید که آیا یک ویژگی در حال حاضر با حداقل پشتیبانی پشتیبانی می شود یا خیر. |
boolean | checkConnectivity () بررسی کنید که دستگاه اتصال شبکه دارد. |
boolean | clearErrorDialogs () سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید. |
void | clearLastConnectedWifiNetwork () آخرین شبکه وای فای متصل را پاک می کند. |
void | clearLogcat () تمام داده های logcat انباشته شده را حذف می کند. |
boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) به شبکه وای فای متصل می شود. |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) به شبکه وای فای متصل می شود. |
boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) به شبکه وای فای متصل می شود.f |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) به شبکه وای فای متصل می شود. |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) گونه ای از |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) گونه ای از |
int | createUser (String name, boolean guest, boolean ephemeral) یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید |
int | createUser (String name) یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید. |
int | createUserNoThrow (String name) یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید. |
void | deleteFile (String deviceFilePath, int userId) روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه. |
void | deleteFile (String deviceFilePath) روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه. |
void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) |
boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) روش کمکی برای بررسی اینکه آیا دستگاه با مقایسه system_server فعلی با system_server |
boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) روش کمکی برای بررسی اینکه آیا دستگاه از زمان UTC از دوره زمانی از دستگاه و |
boolean | disableAdbRoot () ریشه adb را خاموش می کند. |
void | disableKeyguard () تلاش برای غیرفعال کردن محافظ صفحه کلید. |
boolean | disableNetworkMonitor () مانیتورینگ شبکه را در دستگاه غیرفعال می کند. |
boolean | disconnectFromWifi () از شبکه وای فای قطع می شود. |
boolean | doesFileExist (String deviceFilePath, int userId) روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر. |
boolean | doesFileExist (String deviceFilePath) روش کمکی برای تعیین وجود فایل روی دستگاه. |
File | dumpHeap (String process, String devicePath) سعی کنید پشته را از system_server تخلیه کنید. |
boolean | enableAdbRoot () ریشه adb را روشن می کند. |
boolean | enableNetworkMonitor () نظارت بر شبکه را بر روی دستگاه فعال می کند. |
String | executeAdbCommand (long timeout, String... cmdArgs) متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند. |
String | executeAdbCommand (long timeout, envMap, String... cmdArgs) executeAdbCommand (long timeout, envMap, String... cmdArgs) متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند. |
String | executeAdbCommand (String... cmdArgs) متد Helper که دستور adb را به عنوان دستور سیستم اجرا می کند. |
CommandResult | executeFastbootCommand (String... cmdArgs) روش Helper که یک فرمان fastboot را به عنوان یک فرمان سیستم با زمان پیش فرض 2 دقیقه اجرا می کند. |
CommandResult | executeFastbootCommand (long timeout, String... cmdArgs) متد Helper که دستور fastboot را به عنوان دستور سیستم اجرا می کند. |
CommandResult | executeLongFastbootCommand (String... cmdArgs) متد Helper که یک فرمان طولانی در حال اجرا fastboot را به عنوان فرمان سیستم اجرا می کند. |
CommandResult | executeLongFastbootCommand ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs) روش کمکی که یک فرمان طولانی در حال اجرا سریع بوت را به عنوان فرمان سیستم با متغیرهای محیط سیستم اجرا می کند. |
String | executeShellCommand (String command) متد Helper که یک دستور adb shell را اجرا می کند و خروجی را به صورت |
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 | executeShellV2Command (String cmd, OutputStream pipeToOutput) متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت |
CommandResult | executeShellV2Command (String cmd, File pipeAsInput) متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت |
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 | getCachedDeviceDescriptor (boolean shortDescriptor) اگر دستگاه اختصاص داده شده باشد، |
String[] | getChildren (String path) جایگزینی برای استفاده از |
AbstractConnection | getConnection () اتصال فعلی مرتبط با دستگاه. |
ContentProviderHandler | getContentProvider (int userId) |
DeviceFoldableState | getCurrentFoldableState () وضعیت تاشو فعلی دستگاه را برمیگرداند یا در صورت بروز برخی مشکلات، آن را خالی میکند. |
int | getCurrentUser () شناسه کاربر فعلی را برگردانید. |
String | getDeviceClass () کلاس دستگاه را دریافت کنید. |
long | getDeviceDate () تاریخ دستگاه را بر حسب میلیثانیه از آن دوره برگردانید. |
DeviceDescriptor | getDeviceDescriptor () یک |
DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) یک |
TestDeviceState | getDeviceState () وضعیت دستگاه را دریافت کنید. |
long | getDeviceTimeOffset (Date date) کمک کننده برای دریافت تفاوت زمانی بین دستگاه و یک |
InputStreamSource | getEmulatorOutput () جریان شبیه ساز stdout و stderr را دریافت کنید |
Process | getEmulatorProcess () |
final File | getExecuteShellCommandLog () گزارشی که شامل تمام گزارشهای |
long | getExternalStoreFreeSpace () روش کمکی برای تعیین میزان فضای خالی در حافظه خارجی دستگاه. |
String | getFastbootPath () مسیر باینری fastboot مورد استفاده را برمی گرداند. |
String | getFastbootProductType () روشی راحت برای دریافت نوع محصول این دستگاه در حالت فست بوت. |
String | getFastbootProductVariant () روشی راحت برای دریافت نوع محصول این دستگاه در حالت فست بوت. |
String | getFastbootSerialNumber () شماره سریال حالت فست بوت را برمی گرداند. |
String | getFastbootVariable (String variableName) مقدار متغیر fastboot داده شده را از دستگاه بازیابی کنید. |
String | getFastbootVersion () رشته نسخه باینری fastboot مورد استفاده را برمی گرداند. |
IFileEntry | getFileEntry (String path) یک مرجع به یک فایل راه دور در دستگاه را بازیابی کنید. |
IFileEntry | getFileEntry (FileListingService.FileEntry entry) کمک کننده غیر رسمی برای دریافت |
getFoldableStates () لیست حالت های تاشو را در دستگاه برمی گرداند. | |
IDevice | getIDevice () یک ارجاع به |
getInstalledPackageNames () نام بسته های برنامه موجود در دستگاه را واکشی کنید. | |
long | getIntProperty (String name, long defaultValue) مقدار صحیح ویژگی داده شده را از دستگاه برمیگرداند. |
String | getIpAddress () آدرس IP دستگاه را دریافت می کند. |
KeyguardControllerState | getKeyguardState () یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید. |
long | getLastExpectedRebootTimeMillis () آخرین باری را که APIهای Tradefed راهاندازی مجدد را در میلیثانیه از زمان EPOCH راهاندازی کردند، برمیگرداند که توسط |
int | getLaunchApiLevel () اولین سطح API راه اندازی شده دستگاه را دریافت کنید. |
InputStreamSource | getLogcat () یک جریان عکس فوری از داده های logcat را می گیرد. |
InputStreamSource | getLogcat (int maxBytes) یک جریان عکس فوری از آخرین |
InputStreamSource | getLogcatDump () یک روگرفت از logcat فعلی برای دستگاه دریافت کنید. |
InputStreamSource | getLogcatSince (long date) یک جریان عکس فوری از دادههای logcat گرفته شده را با شروع تاریخ ارائه شده میگیرد. |
String | getMacAddress () آدرس MAC دستگاه را برمیگرداند، در صورت عدم درخواست از دستگاه، باطل میشود. |
Integer | getMainUserId () شناسه اصلی کاربر را برمی گرداند. |
getMainlineModuleInfo () اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید. | |
int | getMaxNumberOfRunningUsersSupported () حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید. |
int | getMaxNumberOfUsersSupported () حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. |
Process | getMicrodroidProcess () |
IDeviceStateMonitor | getMonitor () |
String | getMountPoint (String mountName) نقطه اتصال را برمیگرداند. |
ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) |
getMountPointInfo () یک نسخه تجزیه شده از اطلاعات موجود در /proc/mounts در دستگاه را برمی گرداند | |
TestDeviceOptions | getOptions () گزینه های تست دستگاه را واکشی کنید. |
long | getPartitionFreeSpace (String partition) روش کمکی برای تعیین مقدار فضای خالی در پارتیشن دستگاه. |
Integer | getPrimaryUserId () شناسه کاربر اصلی را برمی گرداند. |
ProcessInfo | getProcessByName (String processName) متد Helper دستور "pidof" و "stat" را اجرا می کند و شی |
String | getProcessPid (String process) اگر مشکلی پیش آمده باشد، پید سرویس را برمیگرداند یا نول میکند. |
String | getProductType () روش راحت برای دریافت نوع محصول این دستگاه. |
String | getProductVariant () روش راحت برای دریافت نوع محصول این دستگاه. |
String | getProperty (String name) مقدار مشخصه داده شده را از دستگاه بازیابی کنید. |
ITestDevice.RecoveryMode | getRecoveryMode () حالت بازیابی فعلی مورد استفاده برای دستگاه را دریافت کنید. |
InputStreamSource | getScreenshot (String format) یک اسکرین شات از دستگاه می گیرد. |
InputStreamSource | getScreenshot (long displayId) یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد. |
InputStreamSource | getScreenshot (String format, boolean rescale) یک اسکرین شات از دستگاه می گیرد. |
InputStreamSource | getScreenshot () یک اسکرین شات از دستگاه می گیرد. |
String | getSerialNumber () روش آسان برای دریافت شماره سریال این دستگاه. |
String | getSetting (int userId, String namespace, String key) مقدار تنظیمات درخواستی را برگردانید. |
String | getSetting (String namespace, String key) |
String | getSimOperator () اپراتور سیم کارت را برگردانید یا اگر در دسترس نیست یا دستگاه در دسترس نیست، آن را خالی کنید. |
String | getSimState () وضعیت سیم کارت را برگردانید یا اگر در دسترس نیست یا دستگاه در دسترس نیست، آن را خالی کنید. |
getTombstones () لیست سنگ قبرها را از دستگاه ها واکشی و برگردانید. | |
long | getTotalMemory () حجم کل حافظه فیزیکی را بر حسب بایت یا -1 را در صورت خطای داخلی برمی گرداند |
String | getTrackingSerial () برای مدیریت دستگاه، سریال را برای ردیابی دستگاه استفاده کنید. |
getUninstallablePackageNames () نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید. | |
boolean | getUseFastbootErase () برای پاک کردن پارتیشن روی دستگاه از فرمت fastboot erase یا fastboot استفاده کنید. |
int | getUserFlags (int userId) پرچم های یک کاربر معین را پیدا کرده و برگردانید. |
getUserInfos () نقشه useId به | |
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 () اگر دستگاه در |
boolean | isUserRunning (int userId) بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر. |
boolean | isUserSecondary (int userId) آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر. |
boolean | isUserVisible (int userId) بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () نشان میدهد که آیا دستگاه به کاربران اجازه میدهد در پسزمینه در |
boolean | isVisibleBackgroundUsersSupported () نشان می دهد که آیا دستگاه به کاربران اجازه می دهد در پس زمینه قابل مشاهده باشند یا خیر. |
boolean | isWifiEnabled () تست کنید آیا وای فای فعال است یا خیر. |
listDisplayIds () لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید. | |
listDisplayIdsForStartingVisibleBackgroundUsers () لیستی از نمایشگرهایی را دریافت می کند که می توانند برای | |
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) یک فایل را از دستگاه بازیابی می کند، آن را در یک |
File | pullFile (String remoteFilePath) یک فایل را از دستگاه بازیابی می کند، آن را در یک |
boolean | pullFile (String remoteFilePath, File localFile, int userId) یک فایل را از دستگاه بازیابی می کند. |
String | pullFileContents (String remoteFilePath) یک فایل را از دستگاه بازیابی می کند و محتویات را برمی گرداند. |
File | pullFileFromExternal (String remoteFilePath) یک روش راحت برای بازیابی یک فایل از حافظه خارجی دستگاه، ذخیره آن در یک |
boolean | pushDir (File localFileDir, String deviceFilePath, excludedDirectories) pushDir (File localFileDir, String deviceFilePath, excludedDirectories) به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید در حالی که برخی دایرکتوری ها را که فیلتر شده اند حذف کنید. |
boolean | pushDir (File localFileDir, String deviceFilePath) به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید. |
boolean | pushDir (File localFileDir, String deviceFilePath, int userId) به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید. |
boolean | pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded) گونه ای از |
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 راهاندازی مجدد میکند و |
void | reboot () دستگاه را به حالت adb راه اندازی مجدد می کند. |
void | rebootIntoBootloader () دستگاه را به حالت بوت لودر راه اندازی مجدد می کند. |
void | rebootIntoFastbootd () دستگاه را در حالت فست بوت مجدد راه اندازی می کند. |
void | rebootIntoRecovery () دستگاه را به حالت بازیابی adb راه اندازی مجدد می کند. |
void | rebootIntoSideload () دستگاه را به حالت adb sideload مجدد راه اندازی می کند (توجه داشته باشید که این یک حالت ویژه در حال بازیابی است) مسدود می شود تا زمانی که دستگاه وارد حالت بار جانبی شود |
void | rebootIntoSideload (boolean autoReboot) دستگاه را به حالت adb sideload مجدد راه اندازی می کند (توجه داشته باشید که این یک حالت ویژه در حال بازیابی است) مسدود می شود تا زمانی که دستگاه وارد حالت بار جانبی شود |
void | rebootUntilOnline () جایگزینی برای |
void | rebootUntilOnline (String reason) جایگزینی برای |
void | rebootUserspace () فقط قسمتی از دستگاه را در فضای کاربر راه اندازی مجدد می کند. |
void | rebootUserspaceUntilOnline () جایگزینی برای |
boolean | recoverDevice () تلاش برای بازیابی ارتباطات دستگاه |
void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) |
void | remountSystemReadOnly () پارتیشن سیستم را روی دستگاه فقط خواندنی کنید. |
void | remountSystemWritable () پارتیشن سیستم روی دستگاه را قابل نوشتن کنید. |
void | remountVendorReadOnly () پارتیشن فروشنده روی دستگاه را فقط خواندنی کنید. |
void | remountVendorWritable () پارتیشن فروشنده روی دستگاه را قابل نوشتن کنید. |
boolean | removeAdmin (String componentName, int userId) ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود |
void | removeOwners () همه دارندگان نمایه دستگاه موجود را با بهترین تلاش حذف کنید. |
boolean | removeUser (int userId) یک کاربر معین را از دستگاه حذف کنید. |
void | resetContentProviderSetup () پرچم را برای راه اندازی ارائه دهنده محتوا بازنشانی کنید تا دوباره فعال شود. |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) روش آسان برای انجام |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) تست های ابزار دقیق را اجرا می کند و بازیابی دستگاه را فراهم می کند. |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) همانند |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) مانند |
void | setConfiguration ( IConfiguration configuration) |
final void | setConnectionAvdInfo ( GceAvdInfo avdInfo) |
void | setDate (Date date) تاریخ را روی دستگاه تنظیم می کند توجه: تنظیم تاریخ در دستگاه نیاز به روت دارد |
boolean | setDeviceOwner (String componentName, int userId) یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید. |
void | setDeviceState ( TestDeviceState deviceState) وضعیت دستگاه را به روز کنید. |
void | setEmulatorOutputStream ( SizeLimitedOutputStream output) برای شبیه ساز |
void | setEmulatorProcess (Process p) هنگامی که این دستگاه شبیه ساز است، |
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) |
boolean | setProperty (String propKey, String propValue) مقدار ویژگی داده شده را روی دستگاه تنظیم می کند. |
void | setRecovery ( IDeviceRecovery recovery) |
void | setRecoveryMode ( ITestDevice.RecoveryMode mode) حالت بازیابی فعلی را برای استفاده برای دستگاه تنظیم کنید. |
void | setSetting (String namespace, String key, String value) به |
void | setSetting (int userId, String namespace, String key, String value) یک مقدار تنظیم به فضای نام یک کاربر معین اضافه کنید. |
void | setTestLogger ( ITestLogger testLogger) نمونه |
void | setTrackingSerial (String trackingSerial) برای مدیریت دستگاه، سریالی را که برای ارجاع دستگاه استفاده می کنیم، ردیابی کنید. |
void | setUseFastbootErase (boolean useFastbootErase) تنظیم کنید که برای پاک کردن یک پارتیشن روی دستگاه از فرمت fastboot erase یا fastboot استفاده شود. |
void | startLogcat () شروع به گرفتن خروجی logcat از دستگاه در پس زمینه کنید. |
boolean | startUser (int userId) اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. |
boolean | startUser (int userId, boolean waitFlag) اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) کاربر مشخصی را در پسزمینه شروع میکند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه میدهد فعالیتها را در آن نمایشگر راهاندازی کند). |
void | stopEmulatorOutput () خروجی شبیه ساز را ببندید و حذف کنید. |
void | stopLogcat () گرفتن خروجی logcat از دستگاه را متوقف کنید و داده های ذخیره شده logcat را دور بریزید. |
boolean | stopUser (int userId) یک کاربر معین را متوقف می کند. |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) یک کاربر معین را متوقف کنید. |
String | switchToAdbTcp () دستگاه را به حالت adb-over-tcp تغییر دهید. |
boolean | switchToAdbUsb () دستگاه را به حالت adb از طریق usb تغییر دهید. |
boolean | switchUser (int userId) به userId دیگری با مهلت زمانی پیشفرض تغییر وضعیت دهید. |
boolean | switchUser (int userId, long timeout) به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید. |
boolean | syncFiles (File localFileDir, String deviceFilePath) به صورت تدریجی محتویات یک فهرست فایل محلی را با دستگاه همگام می کند. |
Bugreport | takeBugreport () یک Bugreport بگیرید و آن را در یک شی |
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» (توجه داشته باشید که این با |
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) یک |
IRunUtil | createRunUtil () |
void | doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason) یک راه اندازی مجدد adb انجام دهید. |
void | ensureRuntimePermissionSupported () روش کمکی برای پرتاب استثنا در صورت عدم پشتیبانی از مجوز زمان اجرا |
int | getApiLevelSafe () |
ITestLogger | getLogger () |
IRunUtil | getRunUtil () نمونه |
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) اگر فایل محلی جدیدتر از فایل راه دور باشد، |
void | notifyRebootEnded () به همه |
void | notifyRebootStarted () همه |
boolean | performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts) عملی را در این دستگاه انجام می دهد. |
void | postAdbReboot () اقدامات اضافی احتمالی که می توان پس از راه اندازی مجدد انجام داد. |
void | prePostBootSetup () به هر نوع دستگاه (AndroidNativeDevice، TestDevice) اجازه میدهد این روش را برای راهاندازی خاص پس از بوت لغو کند. |
boolean | pullFileInternal (String remoteFilePath, File localFile) |
void | setClock (Clock clock) نمونه ساعت را برای استفاده تنظیم کنید. |
void | setMicrodroidProcess (Process process) TestDevice را به عنوان microdroid علامت گذاری کرده و CID آن را تنظیم می کند. |
void | setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions) |
CommandResult | simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) یک فرمان ساده fastboot را با متغیرهای محیطی اجرا می کند و وضعیت دستور را گزارش می دهد. |
CommandResult | simpleFastbootCommand (long timeout, String[] fullCmd) یک فرمان ساده fastboot را اجرا می کند و وضعیت دستور را گزارش می دهد. |
boolean | waitForDeviceNotAvailable (String operationDesc, long time) منتظر بمانید تا دستگاه در دسترس نباشد (گزارش به adb را متوقف کنید). |
public static final int INVALID_USER_ID
مقدار بازگشتی برای هر شناسه کاربری نامعتبر/یافتنی: UserHandle مقدار -10000 را تعریف کرد
مقدار ثابت: -10000 (0xffffd8f0)
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
مقدار ثابت: 5000 (0x0000000000001388)
protected static final int MAX_RETRY_ATTEMPTS
تعداد پیش فرض دستور سعی مجدد برای انجام
مقدار ثابت: 2 (0x00000002)
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
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
یک TestDevice
ایجاد می کند.
پارامترها | |
---|---|
device | IDevice : IDevice مرتبط |
stateMonitor | IDeviceStateMonitor : مکانیسم IDeviceStateMonitor برای استفاده |
allocationMonitor | IDeviceMonitor : IDeviceMonitor برای اطلاع از تغییرات وضعیت تخصیص. می تواند پوچ باشد |
public void batchPrefetchStartupBuildProps ()
بهینهسازی میکرو (حدود 400 میلیلیتر) با واکشی از قبل همه لوازم مورد نیاز ما به جای فراخوانی «adb getprop» برای هر یک. یعنی واکشی همه ویژگی ها به همان سرعتی است که واکشی یکی است. مواردی مانند device.getApiLevel()، checkApiLevelAgainstNextRelease و getBuildAlias همگی «adb getprop» را در زیر هود صدا می کنند. ما آنها را در یک تماس واکشی می کنیم و NativeDevice.setProperty را فرا می خوانیم. حتی اگر این کار را انجام ندهیم، NativeDevice خودش setProperty را فراخوانی می کند و نتیجه را برای تماس های بعدی کش می کند. ما فقط کمی زودتر این کار را انجام می دهیم. اگر دستگاه در حال بازیابی است یا خطاهای دیگری در واکشی لوازم وجود دارد، ما فقط آنها را نادیده می گیریم.
public boolean canSwitchToHeadlessSystemUser ()
برمیگرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
بررسی کنید که آیا یک ویژگی در حال حاضر با حداقل پشتیبانی پشتیبانی می شود یا خیر. این روش قبل از اینکه سطح API افزایش یابد، ویژگیهای منتشر نشده را در نظر میگیرد.
پارامترها | |
---|---|
strictMinLevel | int : حداقل حداقل سطح ممکن که از این ویژگی پشتیبانی می کند. |
برمی گرداند | |
---|---|
boolean | اگر سطح پشتیبانی شود درست است. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean checkConnectivity ()
بررسی کنید که دستگاه اتصال شبکه دارد.
برمی گرداند | |
---|---|
boolean | true اگر دستگاه اتصال شبکه کار می کند، false . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean clearErrorDialogs ()
سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید.
برمی گرداند | |
---|---|
boolean | true اگر هیچ گفتگویی وجود نداشته باشد یا گفتگوها با موفقیت پاک شوند. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public void clearLastConnectedWifiNetwork ()
آخرین شبکه وای فای متصل را پاک می کند. این باید هنگام شروع فراخوانی جدید برای جلوگیری از اتصال به شبکه وای فای مورد استفاده در آزمایش قبلی پس از راهاندازی مجدد دستگاه خوانده شود.
public void clearLogcat ()
تمام داده های logcat انباشته شده را حذف می کند.
این برای مواردی مفید است که میخواهید مطمئن شوید ITestDevice#getLogcat()
فقط دادههای گزارش تولید شده پس از یک نقطه خاص (مانند فلش کردن یک دستگاه جدید و غیره) را برمیگرداند.
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
به شبکه وای فای متصل می شود.
وای فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز با یکی از شبکه های وای فای ارائه شده در نقشه wifiSsidToPsk برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice#disconnectFromWifi()
یا ITestDevice#clearLastConnectedWifiNetwork()
فراخوانی شود.
پارامترها | |
---|---|
wifiSsidToPsk | |
scanSsid | boolean : آیا باید SSIDهای مخفی این شبکه را اسکن کرد یا خیر. |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
به شبکه وای فای متصل می شود.
فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز به شبکه وای فای مشخص شده برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice#disconnectFromWifi()
یا ITestDevice#clearLastConnectedWifiNetwork()
فراخوانی شود.
پارامترها | |
---|---|
wifiSsid | String : وای فای ssid برای اتصال |
wifiPsk | String : عبارت عبور PSK یا اگر رمزگذاری نشده باشد، null است |
برمی گرداند | |
---|---|
boolean | اگر با موفقیت به شبکه وای فای متصل شوید true . false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean connectToWifiNetwork (wifiSsidToPsk)
به شبکه وای فای متصل می شود.
وای فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز با یکی از شبکه های وای فای ارائه شده در نقشه wifiSsidToPsk برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice#disconnectFromWifi()
یا ITestDevice#clearLastConnectedWifiNetwork()
فراخوانی شود.f
پارامترها | |
---|---|
wifiSsidToPsk |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
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 |
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
گونه ای از connectToWifiNetwork(String, String)
که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
پارامترها | |
---|---|
scanSsid | boolean : آیا باید SSID مخفی این شبکه را اسکن کرد |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
گونه ای از connectToWifiNetwork(String, String)
که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
برمی گرداند | |
---|---|
boolean | اگر با موفقیت به شبکه وای فای متصل شوید true . false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public int createUser (String name, boolean guest, boolean ephemeral)
یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
پارامترها | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
guest | boolean : فعال کردن پرچم کاربر --guest در حین ایجاد |
ephemeral | boolean : در حین ایجاد، پرچم کاربر را فعال کنید |
برمی گرداند | |
---|---|
int | شناسه کاربر ایجاد شده |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
پارامترها | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
guest | boolean : فعال کردن پرچم کاربر --guest در حین ایجاد |
ephemeral | boolean : در حین ایجاد، پرچم کاربر را فعال کنید |
forTesting | boolean : پرچم تست --برای آزمایش در حین ایجاد را فعال کنید |
برمی گرداند | |
---|---|
int | شناسه کاربر ایجاد شده |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public int createUser (String name)
یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
پارامترها | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
برمی گرداند | |
---|---|
int | عدد صحیح برای شناسه کاربری ایجاد شده |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public int createUserNoThrow (String name)
یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
پارامترها | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
برمی گرداند | |
---|---|
int | عدد صحیح برای شناسه کاربر ایجاد شده یا -1 برای خطا. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public void deleteFile (String deviceFilePath, int userId)
روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه.
پارامترها | |
---|---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه. |
userId | int : شناسه کاربری که باید از آن حذف شود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public void deleteFile (String deviceFilePath)
روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه.
پارامترها | |
---|---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
IDeviceActionReceiver
ثبت شده را حذف می کند.
پارامترها | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : یک IDeviceActionReceiver که حذف خواهد شد. |
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
روش کمکی برای بررسی اینکه آیا دستگاه با مقایسه system_server فعلی با system_server ProcessInfo
قبلی، نرمافزار راهاندازی شده است یا خیر. برای دریافت ProcessInfo
از getProcessByName(String)
استفاده کنید.
پارامترها | |
---|---|
prevSystemServerProcess | ProcessInfo : فرآیند system_server قبلی ProcessInfo . |
برمی گرداند | |
---|---|
boolean | true اگر دستگاه به صورت نرم راه اندازی شود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
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 |
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 |
public boolean doesFileExist (String deviceFilePath, int userId)
روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر.
پارامترها | |
---|---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه برای بررسی |
userId | int : شناسه کاربری که وجود فایل را با آن بررسی کنید |
برمی گرداند | |
---|---|
boolean | true در صورت وجود فایل، false در غیر این صورت. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean doesFileExist (String deviceFilePath)
روش کمکی برای تعیین وجود فایل روی دستگاه.
پارامترها | |
---|---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه برای بررسی |
برمی گرداند | |
---|---|
boolean | true در صورت وجود فایل، false در غیر این صورت. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public File dumpHeap (String process, String devicePath)
سعی کنید پشته را از system_server تخلیه کنید. این وظیفه تماس گیرنده است که فایل تخلیه شده را پاک کند.
پارامترها | |
---|---|
process | String : نام فرآیند دستگاهی که باید روی آن تخلیه شود. |
devicePath | String : مسیر روی دستگاه که در آن روگرفت را قرار دهید. این باید مکانی باشد که مجوزها اجازه آن را می دهند. |
برمی گرداند | |
---|---|
File | ERROR(/File) حاوی گزارش. اگر چیزی شکست خورده است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean enableAdbRoot ()
ریشه adb را روشن می کند. اگر تنظیم "enable-root" "false" باشد، پیامی را ثبت می کند و بدون فعال کردن root باز می گردد.
فعال کردن ریشه adb ممکن است باعث قطع اتصال دستگاه از adb شود. این روش تا زمانی که دستگاه در دسترس نباشد مسدود خواهد شد.
برمی گرداند | |
---|---|
boolean | در صورت موفقیت true |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean enableNetworkMonitor ()
نظارت بر شبکه را بر روی دستگاه فعال می کند.
برمی گرداند | |
---|---|
boolean | true اگر نظارت با موفقیت فعال شود. false اگر شکست خورد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String executeAdbCommand (long timeout, String... cmdArgs)
متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند.
executeShellCommand(String)
باید هر جا که امکان دارد استفاده شود، زیرا آن روش تشخیص خرابی و عملکرد بهتری را ارائه می دهد.
پارامترها | |
---|---|
timeout | long : زمان بر حسب میلی ثانیه قبل از اینکه دستگاه پاسخگو نباشد، 0 لیتر بدون وقفه |
cmdArgs | String : دستور adb و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
String | stdout از دستور. اگر دستور اجرا نشد null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند.
executeShellCommand(String)
باید در هر جایی که امکان دارد استفاده شود، زیرا آن روش تشخیص خرابی و عملکرد بهتری را ارائه می دهد.
پارامترها | |
---|---|
timeout | long : زمان بر حسب میلی ثانیه قبل از اینکه دستگاه پاسخگو نباشد، 0 لیتر بدون وقفه |
envMap | |
cmdArgs | String : دستور adb و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
String | stdout از دستور. اگر دستور اجرا نشد null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String executeAdbCommand (String... cmdArgs)
متد Helper که دستور adb را به عنوان دستور سیستم اجرا می کند.
executeShellCommand(String)
باید هر جا که امکان دارد استفاده شود، زیرا آن روش تشخیص خرابی و عملکرد بهتری را ارائه می دهد.
پارامترها | |
---|---|
cmdArgs | String : دستور adb و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
String | stdout از دستور. اگر دستور اجرا نشد null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeFastbootCommand (String... cmdArgs)
روش یاور که یک دستور fastboot را به عنوان یک دستور سیستم با یک زمان پیش فرض 2 دقیقه اجرا می کند.
انتظار می رود وقتی دستگاه در حال حاضر در حالت Fastboot قرار دارد ، استفاده شود.
پارامترها | |
---|---|
cmdArgs | String : دستور fastboot و آرگومان های اجرا |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
روش یاور که یک دستور fastboot را به عنوان یک دستور سیستم اجرا می کند.
انتظار می رود وقتی دستگاه در حال حاضر در حالت Fastboot قرار دارد ، استفاده شود.
پارامترها | |
---|---|
timeout | long : زمان در میلی ثانیه قبل از پایان فرمان |
cmdArgs | String : دستور fastboot و آرگومان های اجرا |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeLongFastbootCommand (String... cmdArgs)
روش یاور که یک دستور fastboot طولانی در حال اجرا را به عنوان یک دستور سیستم اجرا می کند.
یکسان با executeFastbootCommand(String)
به جز استفاده از یک زمان طولانی تر.
پارامترها | |
---|---|
cmdArgs | String : دستور fastboot و آرگومان های اجرا |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
روش یاور که یک دستور FastBoot در حال اجرا طولانی را به عنوان یک دستور سیستم با متغیرهای محیط سیستم اجرا می کند.
یکسان با executeFastbootCommand(String)
به جز استفاده از یک زمان طولانی تر.
پارامترها | |
---|---|
envVarMap | |
cmdArgs | String : دستور fastboot و آرگومان های اجرا |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String executeShellCommand (String command)
روش یاور که یک دستور پوسته ADB را اجرا می کند و خروجی را به عنوان یک String
باز می گرداند.
پارامترها | |
---|---|
command | String : دستور ADB Shell برای اجرا |
برمی گرداند | |
---|---|
String | خروجی پوسته |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
یک دستور ADB Shell را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
command | String : دستور ADB Shell برای اجرا |
receiver | IShellOutputReceiver : IShellOutputReceiver برای هدایت خروجی پوسته به. |
maxTimeToOutputShellResponse | long : حداکثر زمانی که در طی آن دستور مجاز به خروج هیچ پاسخی نیست. واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
یک دستور ADB Shell را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
command | String : دستور ADB Shell برای اجرا |
receiver | IShellOutputReceiver : IShellOutputReceiver برای هدایت خروجی پوسته به. |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است |
maxTimeToOutputShellResponse | long : حداکثر زمانی که در طی آن دستور مجاز به خروج هیچ پاسخی نیست. واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public void executeShellCommand (String command, IShellOutputReceiver receiver)
دستور ADB Shell داده شده را اجرا می کند ، در صورت عدم موفقیت فرمان ، چندین بار دوباره امتحان می شود.
یک شکل ساده تر از executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
با مقادیر پیش فرض.
پارامترها | |
---|---|
command | String : دستور ADB Shell برای اجرا |
receiver | IShellOutputReceiver : IShellOutputReceiver برای هدایت خروجی پوسته به. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeShellV2Command (String cmd)
روش یاور که یک دستور پوسته ADB را اجرا می کند و نتایج را به عنوان یک CommandResult
به درستی با خروجی وضعیت فرمان ، STDOUT و STDERR باز می گرداند.
پارامترها | |
---|---|
cmd | String : فرمان که باید اجرا شود. |
برمی گرداند | |
---|---|
CommandResult | نتیجه در CommandResult . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
روش یاور که یک دستور پوسته ADB را اجرا می کند و نتایج را به عنوان یک CommandResult
به درستی با خروجی وضعیت فرمان و STDERR باز می گرداند. STDOUT به جریان مشخص شده هدایت می شود.
پارامترها | |
---|---|
cmd | String : فرمان که باید اجرا شود. |
pipeToOutput | OutputStream : ERROR(/OutputStream) که در آن خروجی STD هدایت می شود یا تهی می شود. |
برمی گرداند | |
---|---|
CommandResult | نتیجه در CommandResult . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
روش یاور که یک دستور پوسته ADB را اجرا می کند و نتایج را به عنوان یک CommandResult
به درستی با خروجی وضعیت فرمان ، STDOUT و STDERR باز می گرداند.
پارامترها | |
---|---|
cmd | String : فرمان که باید اجرا شود. |
pipeAsInput | File : ERROR(/File) که به عنوان ورودی به دستور یا NULL لوله کشی می شود. |
برمی گرداند | |
---|---|
CommandResult | نتیجه در CommandResult . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
یک دستور ADB Shell را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
cmd | String : دستور ADB Shell برای اجرا |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود. |
برمی گرداند | |
---|---|
CommandResult |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
یک دستور ADB Shell را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
cmd | String : دستور ADB Shell برای اجرا |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
برمی گرداند | |
---|---|
CommandResult |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
یک دستور ADB Shell را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
cmd | String : دستور ADB Shell برای اجرا |
pipeAsInput | File : ERROR(/File) که به عنوان ورودی به دستور یا NULL لوله کشی می شود. |
pipeToOutput | OutputStream : ERROR(/OutputStream) که در آن خروجی STD هدایت می شود یا تهی می شود. |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود. |
برمی گرداند | |
---|---|
CommandResult |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
یک دستور ADB Shell را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
cmd | String : دستور ADB Shell برای اجرا |
pipeAsInput | File : ERROR(/File) که به عنوان ورودی به دستور یا NULL لوله کشی می شود. |
pipeToOutput | OutputStream : ERROR(/OutputStream) که در آن خروجی STD هدایت می شود یا تهی می شود. |
pipeToError | OutputStream : ERROR(/OutputStream) که در آن خطای STD هدایت می شود یا تهی می شود. |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور ؛ واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد بار برای امتحان مجدد در صورت عدم موفقیت به دلیل استثنا. اگر retryAttempts بدون موفقیت انجام شود ، DevicenotrespensiveException پرتاب می شود. |
برمی گرداند | |
---|---|
CommandResult |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public CommandResult fastbootWipePartition (String partition)
روش یاور که یک پارتیشن برای دستگاه را پاک می کند.
اگر getUseFastbootErase()
true
باشد ، از Fastboot Erase برای پاک کردن پارتیشن استفاده می شود. سپس دستگاه باید دفعه بعد که دستگاه چکمه می کند ، یک سیستم فایل ایجاد کند. در غیر این صورت ، از فرمت FastBoot استفاده می شود که یک سیستم فایل جدید در دستگاه ایجاد می کند.
انتظار می رود وقتی دستگاه در حال حاضر در حالت Fastboot قرار دارد ، استفاده شود.
پارامترها | |
---|---|
partition | String : پارتیشن برای پاک کردن |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publicgetActiveApexes ()
اطلاعات مربوط به Apexes فعال شده در دستگاه را واگذار کنید.
برمی گرداند | |
---|---|
ERROR(/Set) ApexInfo که در حال حاضر روی دستگاه فعال شده است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publicgetAllSettings (String namespace)
بازگشت جفت ارزش کلید از فضای نام درخواست شده.
پارامترها | |
---|---|
namespace | String : باید یکی از {"سیستم" ، "ایمن" ، "جهانی" باشد |
برمی گرداند | |
---|---|
نقشه جفت های مقدار کلید. اگر فضای نام پشتیبانی نشود ، تهی. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public DeviceAllocationState getAllocationState ()
حالت تخصیص فعلی دستگاه را برگردانید
برمی گرداند | |
---|---|
DeviceAllocationState |
public String getAndroidId (int userId)
Android-ID مرتبط با یک کاربر ، NULL را در صورت یافتن پیدا کنید و برگردانید.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
String |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publicgetAndroidIds ()
یک نقشه از شناسه های اندرویدی پیدا کنید که شناسه های کاربری مطابق با آن باشد. هیچ بیمه ای وجود ندارد که هر شناسه کاربر شناسه Android را در این عملکرد پیدا کند تا برخی از شناسه های کاربر ممکن است با NULL مطابقت داشته باشند.
برمی گرداند | |
---|---|
نقشه شناسه های اندرویدی که شناسه های کاربری مطابق با آن است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public int getApiLevel ()
سطح API دستگاه را دریافت کنید. پیش فرض به UNKNOWN_API_LEVEL
.
برمی گرداند | |
---|---|
int | یک عدد صحیح که سطح دستگاه API را نشان می دهد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public PackageInfo getAppPackageInfo (String packageName)
اطلاعات مربوط به بسته نصب شده در دستگاه را دریافت کنید.
پارامترها | |
---|---|
packageName | String |
برمی گرداند | |
---|---|
PackageInfo | اگر اطلاعات قابل بازیابی نباشد PackageInfo یا null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publicgetAppPackageInfos ()
اطلاعات بسته های نصب شده در دستگاه را واگذار کنید.
برمی گرداند | |
---|---|
ERROR(/List) PackageInfo در دستگاه نصب شده است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getBasebandVersion ()
روش راحتی برای دریافت نسخه BaseBand (رادیو) این دستگاه. دریافت نسخه رادیویی خاص دستگاه است ، بنابراین ممکن است اطلاعات صحیح را برای همه دستگاه ها برنگردد. این روش برای بازگشت اطلاعات نسخه صحیح به GSM.Version.BaseBand Propery متکی است. این برای برخی از دستگاه های CDMA دقیق نیست و نسخه برگشتی در اینجا ممکن است با نسخه گزارش شده از Fastboot مطابقت نداشته باشد و ممکن است نسخه را برای رادیو CDMA بازگرداند. TL ؛ DR این روش فقط نسخه دقیق را گزارش می کند اگر ویژگی GSM.Version.BaseBand همان نسخه برگشتی توسط fastboot getvar version-baseband
باشد.
برمی گرداند | |
---|---|
String | اگر نمی توان آن را تعیین کرد ، نسخه BaseBand String یا null (دستگاه هیچ رادیو یا نسخه نسخه ای ندارد) |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public Integer getBattery ()
اگر باتری در دسترس نباشد ، سطح باتری فعلی یک دستگاه یا تهی را برمی گرداند.
برمی گرداند | |
---|---|
Integer |
public boolean getBooleanProperty (String name, boolean defaultValue)
ارزش بولی از خاصیت داده شده را برمی گرداند.
پارامترها | |
---|---|
name | String : نام املاک |
defaultValue | boolean : مقدار پیش فرض برای بازگشت در صورت خالی بودن خاصیت یا وجود وجود ندارد. |
برمی گرداند | |
---|---|
boolean | true اگر این ملک دارای ارزش "1" ، "y" ، "yes" ، "on" یا "true" false اگر این ملک دارای ارزش "0" ، "n" ، "no" ، "off" ، "false" ، یا defaultValue در غیر این صورت. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publicgetBootHistory ()
روش یاور نقشه تاریخ بوت را با زمان بوت و دلیل بوت جمع می کند.
برمی گرداند | |
---|---|
نقشه زمان بوت (زمان UTC در دوم از زمان دوره) و دلیل بوت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
روش Helper نقشه تاریخ بوت را با زمان بوت و دلیل بوت از زمان مشخص از زمان استفاده از دستگاه از دستگاه و واحد زمان مشخص شده جمع می کند. دستگاه فعلی utcepochtime در میلی ثانیه را می توان با روش getDeviceDate()
بدست آورد.
پارامترها | |
---|---|
utcEpochTime | long : زمان دستگاه از زمان. |
timeUnit | TimeUnit : Time Unit TimeUnit . |
برمی گرداند | |
---|---|
نقشه زمان بوت (زمان UTC در دوم از زمان دوره) و دلیل بوت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getBootloaderVersion ()
روش راحتی برای به دست آوردن نسخه bootloader این دستگاه.
سعی در بازیابی نسخه bootloader از حالت فعلی دستگاه خواهد داشت. (یعنی اگر دستگاه در حالت FastBoot باشد ، سعی در بازیابی نسخه از Fastboot خواهد داشت)
برمی گرداند | |
---|---|
String | نسخه بوت String یا null در صورت عدم وجود آن |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public InputStreamSource getBugreport ()
یک Bugreport را از دستگاه بازیابی می کند.
اجرای این امر به ادامه کار بر روی دستگاه بدون SDCARD (یا جایی که هنوز SDCARD نصب نشده است) تضمین شده است.
برمی گرداند | |
---|---|
InputStreamSource | InputStreamSource که محتوای BugReport را در صورت تقاضا تولید می کند. در صورت خرابی ، InputStreamSource یک ERROR(/InputStream) ایجاد می کند. |
public InputStreamSource getBugreportz ()
یک Bugreportz را از دستگاه بازیابی می کند. Format BugReport شامل اصلی BugReport و سایر پرونده های ورود به سیستم است که برای اشکال زدایی مفید هستند.
فقط برای "نسخه ADB"> 1.0.36 پشتیبانی می شود
برمی گرداند | |
---|---|
InputStreamSource | InputStreamSource از پرونده ZIP حاوی Bugreportz ، در صورت عدم موفقیت ، تهی را برمی گرداند. |
public String getBuildAlias ()
بازیابی نام مستعار ساختاری که در حال حاضر دستگاه در حال اجرا است.
ساخت نام مستعار معمولاً یک رشته خواندنی تر از ساخت شناسه است (به طور معمول یک عدد برای ساختهای Nexus). به عنوان مثال ، نسخه نهایی Android 4.2 دارای Alias JDQ39 است ، و ساخت شناسه 573038
برمی گرداند | |
---|---|
String | در صورت عدم بازیابی ، نام مستعار ساخت یا بازگشت به ساخت شناسه |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getBuildFlavor ()
عطر و طعم ساخت را برای دستگاه بازیابی کنید.
برمی گرداند | |
---|---|
String | در صورت عدم بازیابی ، طعم ساخت یا تهی |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getBuildId ()
بازیابی ساخت دستگاه در حال حاضر در حال اجرا است.
برمی گرداند | |
---|---|
String | شناسه ساخت یا IBuildInfo#UNKNOWN_BUILD_ID اگر نتوانست بازیابی شود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getBuildSigningKeys ()
نوع کلید مورد استفاده برای امضای تصویر دستگاه را برمی گرداند
به طور معمول دستگاه های Android ممکن است با کلیدهای تست (مانند AOSP) یا کلیدهای آزاد شده (کنترل شده توسط تولید کنندگان دستگاه های جداگانه) امضا شوند.
برمی گرداند | |
---|---|
String | کلید امضای در صورت یافتن ، در غیر این صورت تهی است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public DeviceDescriptor getCachedDeviceDescriptor ()
در صورت اختصاص دستگاه ، یک DeviceDescriptor
CachedEscriptor را باز می گرداند ، در غیر این صورت DeviceDescriptor
فعلی را برمی گرداند.
برمی گرداند | |
---|---|
DeviceDescriptor |
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
در صورت اختصاص دستگاه ، یک DeviceDescriptor
CachedEscriptor را باز می گرداند ، در غیر این صورت DeviceDescriptor
فعلی را برمی گرداند.
پارامترها | |
---|---|
shortDescriptor | boolean : آیا توصیف کننده را به حداقل اطلاعات لخت محدود می کند یا نه |
برمی گرداند | |
---|---|
DeviceDescriptor |
public String[] getChildren (String path)
جایگزین برای استفاده از IFileEntry
که گاهی به دلیل مجوزها کار نمی کند.
پارامترها | |
---|---|
path | String : آیا مسیر روی دستگاه است که در آن جستجو را انجام دهید |
برمی گرداند | |
---|---|
String[] | آرایه ای از رشته ها حاوی تمام پرونده در یک مسیر روی دستگاه. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public AbstractConnection getConnection ()
اتصال فعلی مرتبط با دستگاه.
برمی گرداند | |
---|---|
AbstractConnection |
public ContentProviderHandler getContentProvider (int userId)
اگر در دسترس نباشد ، ContentProviderHandler
یا NULL را برمی گرداند.
اگر قبلاً با همان userId
ساخته شود ، می توان از ارائه دهنده محتوا استفاده مجدد کرد.
پارامترها | |
---|---|
userId | int : شناسه کاربر برای اولیه سازی ارائه دهنده محتوا با. |
برمی گرداند | |
---|---|
ContentProviderHandler |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public DeviceFoldableState getCurrentFoldableState ()
در صورت بروز برخی از مشکلات ، حالت تاشو فعلی دستگاه یا تهی را برمی گرداند.
برمی گرداند | |
---|---|
DeviceFoldableState |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public int getCurrentUser ()
شناسه کاربر فعلی در حال اجرا را برگردانید. در صورت خطا ، بازگشت -10000.
برمی گرداند | |
---|---|
int |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getDeviceClass ()
کلاس دستگاه را دریافت کنید.
برمی گرداند | |
---|---|
String | کلاس دستگاه String . |
public long getDeviceDate ()
تاریخ دستگاه را به صورت میلی ثانیه از زمان دوره برگردانید.
برمی گرداند | |
---|---|
long | تاریخ دستگاه در قالب EPOCH. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public DeviceDescriptor getDeviceDescriptor ()
برای دریافت اطلاعات در مورد آن بدون عبور از شیء دستگاه واقعی ، یک DeviceDescriptor
را از اطلاعات دستگاه برگردانید.
برمی گرداند | |
---|---|
DeviceDescriptor |
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
برای دریافت اطلاعات در مورد آن بدون عبور از شیء دستگاه واقعی ، یک DeviceDescriptor
را از اطلاعات دستگاه برگردانید.
پارامترها | |
---|---|
shortDescriptor | boolean : آیا توصیف کننده را به حداقل اطلاعات لخت محدود می کند یا نه |
برمی گرداند | |
---|---|
DeviceDescriptor |
public TestDeviceState getDeviceState ()
حالت دستگاه را دریافت کنید.
برمی گرداند | |
---|---|
TestDeviceState |
public long getDeviceTimeOffset (Date date)
یاور برای به دست آوردن اختلاف زمان بین دستگاه و یک ERROR(/Date)
. از زمان داخلی در داخل استفاده کنید.
پارامترها | |
---|---|
date | Date |
برمی گرداند | |
---|---|
long | تفاوت در میلی ثانیه |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public InputStreamSource getEmulatorOutput ()
جریان Emulator stdout و Stderr را دریافت کنید
برمی گرداند | |
---|---|
InputStreamSource | بازده شبیه ساز |
public Process getEmulatorProcess ()
Process
مربوط به این شبیه ساز را برگردانید.
برمی گرداند | |
---|---|
Process | Process یا null |
public final File getExecuteShellCommandLog ()
ورود به سیستم که شامل تمام سیاهههای مربوط executeShellCommand(String)
است.
برمی گرداند | |
---|---|
File |
public long getExternalStoreFreeSpace ()
روش یاور برای تعیین میزان فضای آزاد در ذخیره خارجی دستگاه.
برمی گرداند | |
---|---|
long | مقدار فضای آزاد در KB |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getFastbootPath ()
مسیر باینری Fastboot مورد استفاده را برمی گرداند. هنوز هم به isFastbootEnabled()
نیاز دارد تا درست باشد ، توابع FastBoot را فعال کنید.
برمی گرداند | |
---|---|
String |
public String getFastbootProductType ()
روش راحتی برای به دست آوردن نوع محصول این دستگاه در حالت FastBoot.
این روش فقط باید در صورت استفاده از دستگاه در Fastboot استفاده شود. این نوع کمی ایمن تر از روش عمومی getProductType()
در این حالت است ، زیرا Itestdevice می داند اگر دستگاه در حالت نادرست باشد یا پاسخگو نیست ، دستگاه را در Fastboot بازیابی می کند.
برمی گرداند | |
---|---|
String | نام نوع محصول String یا null در صورت عدم تعیین آن |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getFastbootProductVariant ()
روش راحتی برای به دست آوردن نوع محصول این دستگاه در حالت FastBoot.
این روش فقط باید در صورت استفاده از دستگاه در Fastboot استفاده شود. این نوع کمی ایمن تر از روش عمومی getProductType()
در این حالت است ، زیرا Itestdevice می داند اگر دستگاه در حالت نادرست باشد یا پاسخگو نیست ، دستگاه را در Fastboot بازیابی می کند.
برمی گرداند | |
---|---|
String | نام نوع محصول String یا null در صورت عدم تعیین آن |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getFastbootSerialNumber ()
شماره سریال حالت FastBoot را برمی گرداند.
برمی گرداند | |
---|---|
String |
public String getFastbootVariable (String variableName)
مقدار متغیر FastBoot داده شده را از دستگاه بازیابی کنید.
پارامترها | |
---|---|
variableName | String : نام متغیر |
برمی گرداند | |
---|---|
String | اگر وجود نداشته باشد مقدار خاصیت یا null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getFastbootVersion ()
رشته نسخه از باینری Fastboot را که مورد استفاده قرار می گیرد ، برمی گرداند. یا اگر مشکلی پیش آمد ، تهی.
برمی گرداند | |
---|---|
String |
public IFileEntry getFileEntry (String path)
یک مرجع به یک فایل از راه دور در دستگاه را بازیابی کنید.
پارامترها | |
---|---|
path | String : مسیر پرونده برای بازیابی. می تواند یک مسیر یا مسیر مطلق نسبت به '/' باشد. (IE هر دو "/سیستم" و "سیستم" نحو پشتیبانی می شود) |
برمی گرداند | |
---|---|
IFileEntry | اگر IFileEntry در path داده شده پیدا null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
یاور غیررسمی برای دریافت یک FileEntry
از یک مسیر غیر ریشه. FIXME: سیستم عامل FileTry را از هر مسیر در دسترس قرار دهید. (حتی غیر ریشه ای).
پارامترها | |
---|---|
entry | FileListingService.FileEntry : یک FileEntry لزوماً ریشه ندارد همانطور که DDMLIB نیاز دارد. |
برمی گرداند | |
---|---|
IFileEntry | یک FileTrywrapper نماینده Fileentry. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
publicgetFoldableStates ()
لیست حالتهای تاشو را در دستگاه برمی گرداند. با "CMD FEECTION_STATE PRINT-STATES" می توان به دست آورد.
برمی گرداند | |
---|---|
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public IDevice getIDevice ()
مرجع را به IDevice
DDMLIB مرتبط برمی گرداند.
هر بار که دستگاه جدا شود و از ADB جدا شود ، ممکن است یک IDevice
جدید توسط DDMS اختصاص یابد. بنابراین تماس گیرندگان نباید به IDevice
مراجعه کنند ، زیرا این مرجع ممکن است بی رنگ باشد.
برمی گرداند | |
---|---|
IDevice | IDevice |
publicgetInstalledPackageNames ()
نام بسته های برنامه موجود در دستگاه را واگذار کنید.
برمی گرداند | |
---|---|
ERROR(/Set) نام های بسته بندی String که در حال حاضر روی دستگاه نصب شده است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public long getIntProperty (String name, long defaultValue)
مقدار عدد صحیح خاصیت داده شده را از دستگاه باز می گرداند.
پارامترها | |
---|---|
name | String : نام املاک |
defaultValue | long : مقدار پیش فرض برای بازگشت در صورت خالی بودن خاصیت یا وجود ندارد. |
برمی گرداند | |
---|---|
long | مقدار خاصیت یا defaultValue اگر خاصیت خالی باشد ، وجود ندارد ، یا مقدار عدد صحیح ندارد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getIpAddress ()
آدرس IP دستگاه را دریافت می کند.
برمی گرداند | |
---|---|
String | آدرس IP دستگاه یا null اگر دستگاه آدرس IP ندارد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public KeyguardControllerState getKeyguardState ()
در صورت عدم پشتیبانی ، یک شیء را برگردانید تا وضعیت فعلی Keyguard یا NULL را بدست آورید.
برمی گرداند | |
---|---|
KeyguardControllerState | در صورت عدم پشتیبانی از پرس و جو KeyGuard ، یک KeyguardControllerState حاوی عکس فوری از وضعیت Keyguard و NULL باز می گردد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public long getLastExpectedRebootTimeMillis ()
بازگشت آخرین باری که API های مبادله ای از زمان بازگشت توسط System.currentTimeMillis()
راه اندازی مجدد در میلی ثانیه ایجاد کردند.
برمی گرداند | |
---|---|
long |
public int getLaunchApiLevel ()
اولین سطح API راه اندازی شده دستگاه را دریافت کنید. پیش فرض به UNKNOWN_API_LEVEL
.
برمی گرداند | |
---|---|
int | یک عدد صحیح که نشانگر اولین سطح API راه اندازی شده دستگاه است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public InputStreamSource getLogcat ()
یک جریان عکس از داده های logcat را به دست می آورد.
در دو حالت کار می کند:
TestDeviceOptions.getMaxLogcatDataSize()
بایت محتوای فعلی ضبط LogCat پس زمینه باز می گردد.برمی گرداند | |
---|---|
InputStreamSource |
public InputStreamSource getLogcat (int maxBytes)
یک جریان عکس از آخرین maxBytes
از داده های LogCat ضبط شده را به دست می آورد.
برای مواردی مفید است که می خواهید عکس های مکرر از داده های LogCat ضبط شده را ضبط کنید بدون اینکه در مجازات فضای دیسک بالقوه بزرگ برای گرفتن کل عکس فوری getLogcat()
وجود داشته باشد.
پارامترها | |
---|---|
maxBytes | int : حداکثر مقدار داده برای بازگشت. باید مقداری باشد که به راحتی می تواند در حافظه جای بگیرد |
برمی گرداند | |
---|---|
InputStreamSource |
public InputStreamSource getLogcatDump ()
یک زباله از logcat فعلی برای دستگاه دریافت کنید. بر خلاف getLogcat()
، این روش همیشه یک زباله استاتیک LogCat را برمی گرداند.
در صورت عدم دسترسی دستگاه ، هیچ چیز بازگردانده نمی شود.
برمی گرداند | |
---|---|
InputStreamSource | InputStreamSource از داده های logcat. در صورت عدم موفقیت در گرفتن داده های LogCat ، یک جریان خالی بازگردانده می شود. |
public InputStreamSource getLogcatSince (long date)
یک جریان عکس فوری از داده های LogCat ضبط شده را شروع می کند که از تاریخ ارائه شده است. زمان موجود در دستگاه باید از getDeviceDate()
استفاده شود.
پارامترها | |
---|---|
date | long : در میلی ثانیه از زمان فرمت زمان شروع عکس فوری تا زمان وجود. (می توان با استفاده از "تاریخ +٪ s" بدست آمد) |
برمی گرداند | |
---|---|
InputStreamSource |
public String getMacAddress ()
آدرس MAC دستگاه را برمی گرداند ، اگر نتواند از دستگاه پرس و جو کند.
برمی گرداند | |
---|---|
String |
public Integer getMainUserId ()
شناسه اصلی کاربر را برمی گرداند.
برمی گرداند | |
---|---|
Integer | کاربر کاربر اصلی در صورت وجود ، و در صورت عدم وجود کاربر اصلی ، تهی است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publicgetMainlineModuleInfo ()
اطلاعات مربوط به ماژول های اصلی نصب شده بر روی دستگاه را دریافت کنید.
برمی گرداند | |
---|---|
ERROR(/Set) ماژول های اصلی String در حال حاضر روی دستگاه نصب شده است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public int getMaxNumberOfRunningUsersSupported ()
حداکثر تعداد کاربران در حال اجرا را به طور همزمان پشتیبانی کنید. پیش فرض به 0.
برمی گرداند | |
---|---|
int | یک عدد صحیح که تعداد کاربران همزمان را نشان می دهد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public int getMaxNumberOfUsersSupported ()
حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. پیش فرض به 0.
برمی گرداند | |
---|---|
int | یک عدد صحیح که تعداد کاربران پشتیبانی شده را نشان می دهد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public Process getMicrodroidProcess ()
برمی گرداند | |
---|---|
Process | روند MicroDroid VM را برمی گرداند. اگر TestDevice میکرودروئید نیست ، تهی می کند. |
public IDeviceStateMonitor getMonitor ()
IDeviceStateMonitor
مرتبط با دستگاه را برگردانید.
برمی گرداند | |
---|---|
IDeviceStateMonitor |
public String getMountPoint (String mountName)
یک نقطه کوه را برمی گرداند.
اگر اطلاعات ذخیره شده در IDevice
در دسترس نباشد ، دستگاه را مستقیماً پرس و جو کنید.
TODO: این رفتار را به IDevice#getMountPoint(String)
منتقل کنید
پارامترها | |
---|---|
mountName | String : نام Mount Point |
برمی گرداند | |
---|---|
String | نقطه کوه یا null |
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
اگر این مسیر هیچ چیزی نصب نشده باشد یا در غیر این صورت در /proc /mounts به عنوان یک نقطه کوه ظاهر نشود ، یک MountPointInfo
متناسب با مسیر MountPoint مشخص شده را برمی null
.
پارامترها | |
---|---|
mountpoint | String |
برمی گرداند | |
---|---|
ITestDevice.MountPointInfo | ERROR(/List) MountPointInfo حاوی اطلاعات در "/proc/mounts" |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publicgetMountPointInfo ()
یک نسخه تجزیه شده از اطلاعات در /proc /mounts را بر روی دستگاه برمی گرداند
برمی گرداند | |
---|---|
ERROR(/List) MountPointInfo حاوی اطلاعات در "/proc/mounts" |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public TestDeviceOptions getOptions ()
گزینه های تست دستگاه را واکشی کنید.
برمی گرداند | |
---|---|
TestDeviceOptions | TestDeviceOptions مربوط به دستگاه تحت آزمایش. |
public long getPartitionFreeSpace (String partition)
روش یاور برای تعیین میزان فضای آزاد در پارتیشن دستگاه.
پارامترها | |
---|---|
partition | String |
برمی گرداند | |
---|---|
long | مقدار فضای آزاد در KB |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public Integer getPrimaryUserId ()
شناسه اصلی کاربر را برمی گرداند.
برمی گرداند | |
---|---|
Integer | کاربر کاربر اصلی در صورت وجود ، و در صورت عدم وجود کاربر اصلی ، تهی است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public ProcessInfo getProcessByName (String processName)
روش یاور دستور "Pidof" و "Stat" را اجرا می کند و شیء ProcessInfo
با PID و زمان شروع فرآیند فرآیند داده شده باز می گرداند.
پارامترها | |
---|---|
processName | String : رشته نام Proces. |
برمی گرداند | |
---|---|
ProcessInfo | فرآیند نام پردازنده داده شده |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getProcessPid (String process)
اگر مشکلی پیش آمد ، PID سرویس یا تهی را برمی گرداند.
پارامترها | |
---|---|
process | String : رشته نام Proces. |
برمی گرداند | |
---|---|
String |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getProductType ()
روش راحتی برای به دست آوردن نوع محصول این دستگاه.
اگر دستگاه در حالت ADB یا FastBoot باشد ، این روش کار خواهد کرد.
برمی گرداند | |
---|---|
String | نام نوع محصول String . تهی نخواهد بود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getProductVariant ()
روش راحتی برای به دست آوردن نوع محصول این دستگاه.
اگر دستگاه در حالت ADB یا FastBoot باشد ، این روش کار خواهد کرد.
برمی گرداند | |
---|---|
String | اگر نمی توان تعیین کرد نام نوع محصول String یا null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getProperty (String name)
مقدار خاصیت خاص را از دستگاه بازیابی کنید.
پارامترها | |
---|---|
name | String : نام املاک |
برمی گرداند | |
---|---|
String | اگر وجود نداشته باشد مقدار خاصیت یا null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public ITestDevice.RecoveryMode getRecoveryMode ()
حالت ریکاوری فعلی را که برای دستگاه استفاده می شود دریافت کنید.
برمی گرداند | |
---|---|
ITestDevice.RecoveryMode | حالت بازیابی فعلی که برای دستگاه استفاده می شود. |
public InputStreamSource getScreenshot (String format)
یک تصویر را از دستگاه می گیرد. توصیه می شود به جای رمزگذاری JPEG برای اندازه کوچکتر ، از GetScreenshot (قالب) استفاده کنید
پارامترها | |
---|---|
format | String : پشتیبانی شده PNG ، JPEG |
برمی گرداند | |
---|---|
InputStreamSource | اگر تصویر موفقیت آمیز نبود ، یک InputStreamSource از تصویر در قالب یا null وجود دارد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public InputStreamSource getScreenshot (long displayId)
یک تصویر را از دستگاه شناسه نمایش داده شده می گیرد. قالب PNG است.
TODO: برای پشتیبانی از "قالب" و "Rescale" ، پیاده سازی های فوق را گسترش دهید
پارامترها | |
---|---|
displayId | long : شناسه صفحه نمایش برای دریافت تصویر از صفحه نمایش. |
برمی گرداند | |
---|---|
InputStreamSource | اگر تصویر موفقیت آمیز نبود ، یک InputStreamSource از تصویر در قالب یا null وجود دارد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public InputStreamSource getScreenshot (String format, boolean rescale)
یک تصویر را از دستگاه می گیرد. توصیه می شود به جای آن با رمزگذاری JPEG برای اندازه کوچکتر getScreenshot(String)
استفاده کنید.
پارامترها | |
---|---|
format | String : پشتیبانی شده PNG ، JPEG |
rescale | boolean : در صورت کاهش تصویر برای کاهش اندازه تصویر حاصل باید نجات یابد |
برمی گرداند | |
---|---|
InputStreamSource | اگر تصویر موفقیت آمیز نبود ، یک InputStreamSource از تصویر در قالب یا null وجود دارد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public InputStreamSource getScreenshot ()
یک تصویر را از دستگاه می گیرد.
برمی گرداند | |
---|---|
InputStreamSource | اگر تصویر موفقیت آمیز نبود ، یک InputStreamSource از تصویر از تصویر با فرمت PNG یا null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getSerialNumber ()
روش راحتی برای دریافت شماره سریال این دستگاه.
برمی گرداند | |
---|---|
String | شماره سریال String |
public String getSetting (int userId, String namespace, String key)
مقدار تنظیم درخواست شده را برگردانید. فضای نام باید یکی از: {"سیستم" ، "ایمن" ، "جهانی" باشد
پارامترها | |
---|---|
userId | int |
namespace | String |
key | String |
برمی گرداند | |
---|---|
String | مقدار مرتبط با فضای نام: کلید یک کاربر. اگر یافت نشد NULL. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getSetting (String namespace, String key)
See getSetting(int, String, String)
ببینید و روی کاربر سیستم انجام شود.
پارامترها | |
---|---|
namespace | String |
key | String |
برمی گرداند | |
---|---|
String |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String getSimOperator ()
اگر در دسترس نباشد یا اگر دستگاه در دسترس نباشد ، اپراتور سیم کارت یا NULL را برگردانید.
برمی گرداند | |
---|---|
String |
public String getSimState ()
اگر در دسترس نیست یا دستگاه در دسترس نیست ، حالت سیم کارت یا تهی را برگردانید.
برمی گرداند | |
---|---|
String |
publicgetTombstones ()
لیست سنگ قبرها را از دستگاه ها واکشی کرده و برگردانید. به ریشه نیاز دارد.
روش بهترین تلاش است ، بنابراین اگر یک سنگ قبر به هر دلیلی کشیده شود ، از این لیست گم نمی شود. فقط یک DeviceNotAvailableException
روش را زودتر خاتمه می دهد.
برمی گرداند | |
---|---|
لیستی از پرونده های سنگ قبر ، در صورت عدم وجود سنگ قبر. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public long getTotalMemory ()
در صورت بروز خطای داخلی ، اندازه کل حافظه فیزیکی را در بایت یا -1 برمی گرداند
برمی گرداند | |
---|---|
long |
public String getTrackingSerial ()
برای هدف مدیریت دستگاه ، سریال مورد استفاده برای ردیابی دستگاه را دریافت کنید.
برمی گرداند | |
---|---|
String |
publicgetUninstallablePackageNames ()
نام های بسته برنامه را که می توان نصب کرد ، واکشی کنید. این در حال حاضر به عنوان بسته های غیر سیستم و بسته های به روز شده سیستم تعریف شده است.
برمی گرداند | |
---|---|
ERROR(/Set) نام های بسته String قابل حذف قابل حذف در حال حاضر روی دستگاه نصب شده است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean getUseFastbootErase ()
برای پاک کردن یک پارتیشن روی دستگاه ، از استفاده از Fastboot Erase یا FastBoot استفاده کنید.
برمی گرداند | |
---|---|
boolean | در صورت استفاده از فرمت Fastboot true در صورت استفاده از Fastboot از فرمت استفاده false شود. |
public int getUserFlags (int userId)
پرچم های یک کاربر خاص را پیدا و برگردانید. پرچم ها در کلاس "android.content.pm.userinfo" در پروژه منبع باز اندروید تعریف شده اند.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
int | پرچم های مرتبط با UserID در صورت یافتن ، -10000 در هر مورد دیگر ارائه شده است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publicgetUserInfos ()
نقشه UseID را به UserInfo
در دستگاه دریافت می کند. اگر خروجی از دستگاه همانطور که انتظار می رود ، DeviceRuntimeException
پرتاب می کند.
برمی گرداند | |
---|---|
لیست اشیاء UserInfo. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public int getUserSerialNumber (int userId)
شماره سریال مرتبط با کاربر را در صورت یافتن ، -10000 در هر مورد دیگر برگردانید.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
int |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
پردازش دستگاه داده شده. ممکن است دستگاه انتقال به حالت جدید. IDeviceMonitor
از هرگونه انتقال ایالتی مطلع می کند.
دستگاه را پردازش کنید ، که ممکن است این دستگاه را به حالت تخصیص جدید منتقل کند.
پارامترها | |
---|---|
event | DeviceEvent |
بازگرداندن | |
---|---|
IManagedTestDevice.DeviceEventResponse |
public boolean hasFeature (String feature)
بررسی کنید که آیا یک ویژگی در یک دستگاه موجود است یا خیر.
پارامترها | |
---|---|
feature | String : کدام قالب باید باشد "ویژگی: |
برمی گرداند | |
---|---|
boolean | اگر ویژگی پیدا شود ، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
یک بسته اندرویدی را روی دستگاه نصب کنید.
پارامترها | |
---|---|
packageFile | File : پرونده APK برای نصب |
reinstall | boolean : اگر مجدداً نصب شود true |
extraArgs | String : آرگومان های اضافی اختیاری برای عبور. برای گزینه های موجود به "ADB Shell PM -H" مراجعه کنید. |
برمی گرداند | |
---|---|
String | String با کد خطا یا در صورت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
یک بسته اندرویدی را روی دستگاه نصب کنید.
توجه: فقط از مواردی استفاده کنید که نیاز به کنترل صریح در اعطای مجوز زمان اجرا در زمان نصب داشته باشد ، باید این عملکرد را فراخوانی کنید.
پارامترها | |
---|---|
packageFile | File : پرونده APK برای نصب |
reinstall | boolean : اگر مجدداً نصب شود true |
grantPermissions | boolean : اگر تمام مجوزهای زمان اجرا در زمان نصب اعطا شود |
extraArgs | String : آرگومان های اضافی اختیاری برای عبور. برای گزینه های موجود به "ADB Shell PM -H" مراجعه کنید. |
بازگرداندن | |
---|---|
String | String با کد خطا یا در صورت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
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 |
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 |
public void invalidatePropertyCache ()
public boolean isAdbRoot ()
بازگرداندن | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isAdbTcp ()
بازگرداندن | |
---|---|
boolean |
public boolean isAppEnumerationSupported ()
بررسی کنید که آیا پلت فرم در دستگاه از شمارش برنامه پشتیبانی می کند
بازگرداندن | |
---|---|
boolean | اگر شمارش برنامه پشتیبانی شود ، در غیر این صورت نادرست است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isBypassLowTargetSdkBlockSupported ()
بررسی کنید که آیا پلت فرم در دستگاه از عبور از بلوک SDK هدف پایین در نصب برنامه پشتیبانی می کند
بازگرداندن | |
---|---|
boolean | اگر بلوک SDK با هدف پایین Bypass پشتیبانی شود ، در غیر این صورت نادرست است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isDebugfsMounted ()
بررسی کنید که آیا اشکال زدایی نصب شده است یا خیر.
بازگرداندن | |
---|---|
boolean | اگر اشکال زدایی نصب شود true |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isDeviceEncrypted ()
در صورت رمزگذاری دستگاه باز می گردد.
برمی گرداند | |
---|---|
boolean | اگر دستگاه رمزگذاری شود true . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isDirectory (String path)
اگر مسیر موجود در دستگاه یک فهرست باشد ، در غیر این صورت نادرست است.
پارامترها | |
---|---|
path | String |
بازگرداندن | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isEnableAdbRoot ()
بازگرداندن | |
---|---|
boolean | اگر ریشه ADB باید در دستگاه فعال شود true |
public boolean isEncryptionSupported ()
اگر رمزگذاری در دستگاه پشتیبانی شود ، باز می گردد.
بازگرداندن | |
---|---|
boolean | اگر دستگاه از رمزگذاری پشتیبانی کند ، true . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isExecutable (String fullPath)
اگر مسیر پرونده روی دستگاه یک پرونده اجرایی باشد ، در غیر این صورت نادرست است.
پارامترها | |
---|---|
fullPath | String |
بازگرداندن | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isFastbootEnabled ()
اگر Fastboot برای دستگاه در دسترس است ، برگردید.
بازگرداندن | |
---|---|
boolean |
public boolean isHeadless ()
اگر دستگاه بدون سر (بدون صفحه) باشد ، در غیر این صورت نادرست است.
بازگرداندن | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isHeadlessSystemUserMode ()
باز می گردد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند.
بازگرداندن | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isMainUserPermanentAdmin ()
باز می گردد که آیا کاربر اصلی یک مدیر دائمی است و نمی توان آن را به وضعیت غیر Admin حذف کرد یا کاهش یافت.
بازگرداندن | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isMultiUserSupported ()
تعیین می کند که آیا کاربر چند کاربر پشتیبانی می شود یا خیر.
بازگرداندن | |
---|---|
boolean | درست است اگر چند کاربر پشتیبانی شود ، در غیر این صورت نادرست است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isPackageInstalled (String packageName, String userId)
دستگاه را برای یک نام بسته خاص پرس و جو کنید و به شناسه کاربر داده شود تا بررسی کند که آیا در حال حاضر نصب شده است یا نه برای آن کاربر.
پارامترها | |
---|---|
packageName | String : بسته ای که ما در حال بررسی آن هستیم. |
userId | String : شناسه کاربری که ما در حال بررسی بسته بندی شده برای آن هستیم. در صورت تهی ، از کاربر اولیه صفر استفاده می شود. |
بازگرداندن | |
---|---|
boolean | اگر بسته به صورت نصب شده گزارش شود ، درست است. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isPackageInstalled (String packageName)
دستگاه را برای یک نام بسته خاص پرس و جو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.
پارامترها | |
---|---|
packageName | String |
بازگرداندن | |
---|---|
boolean | اگر بسته به صورت نصب شده گزارش شود ، درست است. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isRuntimePermissionSupported ()
بررسی کنید که آیا پلت فرم در دستگاه از اعطای مجوز زمان اجرا پشتیبانی می کند
بازگرداندن | |
---|---|
boolean | درست است اگر اجازه زمان اجرا پشتیبانی شود ، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isStateBootloaderOrFastbootd ()
اگر دستگاه در TestDeviceState#FASTBOOT
یا TestDeviceState.FASTBOOTD
باشد ، درست برمی گردد.
بازگرداندن | |
---|---|
boolean |
public boolean isUserRunning (int userId)
بررسی کنید که آیا یک کاربر خاص در حال اجرا است یا خیر.
پارامترها | |
---|---|
userId | int |
بازگرداندن | |
---|---|
boolean | درست است اگر کاربر در حال اجرا باشد ، در هر مورد دیگر نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isUserSecondary (int userId)
بازگردید که آیا کاربر مشخص شده یک کاربر ثانویه با توجه به پرچم های خود است.
پارامترها | |
---|---|
userId | int |
بازگرداندن | |
---|---|
boolean | اگر کاربر ثانویه باشد ، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isUserVisible (int userId)
بررسی می کند که آیا کاربر داده شده قابل مشاهده است.
کاربر "قابل مشاهده" کاربر است که با کاربر "انسانی" در تعامل است و از این رو قادر به راه اندازی فعالیت های پرتاب (به طور معمول در صفحه نمایش پیش فرض) است.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isUserVisibleOnDisplay (int userId, int displayId)
بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است.
کاربر "قابل مشاهده" کاربر است که با کاربر "انسانی" در تعامل است و از این رو قادر است فعالیت های پرتاب را در آن صفحه نمایش راه اندازی کند.
پارامترها | |
---|---|
userId | int |
displayId | int |
بازگرداندن | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
باز می گردد که آیا دستگاه اجازه می دهد تا کاربران در پس زمینه در ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
اگر این کار را انجام دهید ، می توانید با یک صفحه نمایش با استفاده از startVisibleBackgroundUser(int, int, boolean)
تماس بگیرید ، و صفحه ای را که توسط listDisplayIdsForStartingVisibleBackgroundUsers()
بازگردانده شده است (که باید شامل ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
بازگرداندن | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isVisibleBackgroundUsersSupported ()
باز می گردد که آیا دستگاه اجازه می دهد تا کاربران در پس زمینه قابل مشاهده باشند.
اگر این کار را انجام دهد ، می توانید با startVisibleBackgroundUser(int, int, boolean)
تماس بگیرید ، و صفحه ای را که توسط listDisplayIdsForStartingVisibleBackgroundUsers()
بازگردانده شده است.
بازگرداندن | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean isWifiEnabled ()
اگر WiFi فعال باشد ، آزمایش کنید.
بررسی می کند که آیا WiFi در دستگاه فعال است. برای ادعای وضعیت WiFi قبل از تست هایی که نباید با WiFi اجرا شود ، به عنوان مثال آزمایش داده های تلفن همراه مفید است.
بازگرداندن | |
---|---|
boolean | اگر WiFi فعال باشد true . اگر false باشد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publiclistDisplayIds ()
لیست شناسه نمایشگرهای موجود را بر روی دستگاه جمع آوری کنید که توسط "Dumpsys SurfaceFlinger" گزارش شده است.
بازگرداندن | |
---|---|
لیست نمایشگرها. پیش فرض همیشه نمایشگر پیش فرض 0 را برمی گرداند. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
لیست نمایشگرهایی را که می تواند برای start a user visible in the background
استفاده می شود ، دریافت می کند.
بازگرداندن | |
---|---|
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
publiclistUsers ()
لیست کاربران موجود در دستگاه را دریافت می کند. اگر خروجی از دستگاه همانطور که انتظار می رود ، DeviceRuntimeException
پرتاب می کند.
بازگرداندن | |
---|---|
لیست شناسه های کاربر. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean logAnrs (ITestLogger logger)
ANR ها را از دستگاه جمع آوری و وارد کنید.
پارامترها | |
---|---|
logger | ITestLogger : ITestLogger برای ورود به سیستم ANRS. |
بازگرداندن | |
---|---|
boolean | اگر ورود به سیستم موفقیت آمیز بود ، در غیر این صورت نادرست بود. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean logBugreport (String dataName, ITestLogger listener)
روش یاور برای گرفتن یک Bugreport و ورود به آن به خبرنگاران.
پارامترها | |
---|---|
dataName | String : نامی که در آن Bugreport گزارش خواهد شد. |
listener | ITestLogger : ITestLogger برای ورود به سیستم BugReport. |
بازگرداندن | |
---|---|
boolean | اگر ورود به سیستم موفقیت آمیز بود ، در غیر این صورت نادرست بود. |
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
پیام را در logcat دستگاه وارد کنید. این یک تماس ایمن است که حتی اگر ورود به سیستم از بین نرود ، پرتاب نمی شود.
پارامترها | |
---|---|
tag | String : برچسب ای که پیام خود را در LogCat وارد می کنیم. |
level | Log.LogLevel : سطح اشکال زدایی پیام در logcat. |
format | String : قالب پیام. |
args | Object : استدلال هایی که باید از طریق string.format () جایگزین شوند. |
public void mountDebugfs ()
Mount Debugfs.
پرتاب | |
---|---|
DeviceNotAvailableException |
public void nonBlockingReboot ()
یک دستور برای راه اندازی مجدد دستگاه را صادر می کند و به صورت کامل باز می گردد و وقتی دستگاه دیگر برای ADB قابل مشاهده نیست.
پرتاب | |
---|---|
DeviceNotAvailableException |
public void postAdbRootAction ()
اگر دستگاه نیاز به اقدامات خاصی دارد که باید بعد از ریشه ADB و قبل از بازگشت دستگاه به صورت آنلاین انجام شود ، نادیده بگیرید. Default implementation doesn't include any addition actions. adb root is not guaranteed to be enabled at this stage.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public void postAdbUnrootAction ()
Override if the device needs some specific actions to be taken after adb unroot and before the device is back online. Default implementation doesn't include any additional actions. adb root is not guaranteed to be disabled at this stage.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public void postBootSetup ()
Perform instructions to configure device for testing that after every boot.
Should be called after device is fully booted/available
In normal circumstances this method doesn't need to be called explicitly, as implementations should perform these steps automatically when performing a reboot.
Where it may need to be called is when device reboots due to other events (eg when a fastboot update command has completed)
Throws | |
---|---|
DeviceNotAvailableException |
public void postInvocationTearDown (Throwable exception)
Extra steps for device specific required clean up that will be executed after the invocation is done.
پارامترها | |
---|---|
exception | Throwable : if any, the final exception raised by the invocation failure. |
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Extra steps for device specific required setup that will be executed on the device prior to the invocation flow.
پارامترها | |
---|---|
info | IBuildInfo : The IBuildInfo of the device. |
attributes | MultiMap : The attributes stored in the invocation context |
Throws | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Recursively pull directory contents from device.
پارامترها | |
---|---|
deviceFilePath | String : the absolute file path of the remote source |
localDir | File : the local directory to pull files into |
userId | int : the user id to pull from |
Returns | |
---|---|
boolean | true if file was pulled successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean pullDir (String deviceFilePath, File localDir)
Recursively pull directory contents from device.
پارامترها | |
---|---|
deviceFilePath | String : the absolute file path of the remote source |
localDir | File : the local directory to pull files into |
Returns | |
---|---|
boolean | true if file was pulled successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean pullFile (String remoteFilePath, File localFile)
Retrieves a file off device.
پارامترها | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
Returns | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public File pullFile (String remoteFilePath, int userId)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
پارامترها | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
userId | int : The user id to pull from |
Returns | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Throws | |
---|---|
DeviceNotAvailableException |
public File pullFile (String remoteFilePath)
Retrieves a file off device, stores it in a local temporary ERROR(/File)
, and returns that File
.
پارامترها | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
برمی گرداند | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Retrieves a file off device.
پارامترها | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
localFile | File : the local file to store contents in. If non-empty, contents will be replaced. |
userId | int : The user id to pull from |
Returns | |
---|---|
boolean | true if file was retrieved successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public String pullFileContents (String remoteFilePath)
Retrieves a file off device, and returns the contents.
پارامترها | |
---|---|
remoteFilePath | String : the absolute path to file on device. |
Returns | |
---|---|
String | A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Throws | |
---|---|
DeviceNotAvailableException |
public File pullFileFromExternal (String remoteFilePath)
A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File)
, and return a reference to that File
.
پارامترها | |
---|---|
remoteFilePath | String : the path to file on device, relative to the device's external storage mountpoint |
Returns | |
---|---|
File | A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem) |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Recursively push directory contents to device while excluding some directories that are filtered.
پارامترها | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
excludedDirectories |
Returns | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean pushDir (File localFileDir, String deviceFilePath)
Recursively push directory contents to device.
پارامترها | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
Returns | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Recursively push directory contents to device.
پارامترها | |
---|---|
localFileDir | File : the local directory to push |
deviceFilePath | String : the absolute file path of the remote destination |
userId | int : the user id to push to |
Returns | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variant of pushFile(File, String)
which can optionally consider evaluating the need for the content provider.
پارامترها | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
evaluateContentProviderNeeded | boolean : whether to check if we need the content provider |
Returns | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean pushFile (File localFile, String remoteFilePath)
Push a file to device. By default using a content provider.
پارامترها | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
Returns | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean pushFile (File localFile, String remoteFilePath, int userId)
Push a file to device. By default using a content provider.
پارامترها | |
---|---|
localFile | File : the local file to push |
remoteFilePath | String : the remote destination absolute file path |
userId | int : the userId to push to |
Returns | |
---|---|
boolean | true if file was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean pushString (String contents, String remoteFilePath)
Push file created from a string to device
پارامترها | |
---|---|
contents | String : the contents of the file to push |
remoteFilePath | String : the remote destination absolute file path |
Returns | |
---|---|
boolean | true if string was pushed successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public void reboot (String reason)
Reboots the device into adb mode with given reason
to be persisted across reboot.
Blocks until device becomes available.
Last reboot reason can be obtained by querying sys.boot.reason
propety.
پارامترها | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public void reboot ()
Reboots the device into adb mode.
Blocks until device becomes available.
Throws | |
---|---|
DeviceNotAvailableException |
public void rebootIntoBootloader ()
Reboots the device into bootloader mode.
Blocks until device is in bootloader mode.
Throws | |
---|---|
DeviceNotAvailableException |
public void rebootIntoFastbootd ()
Reboots the device into fastbootd mode.
Blocks until device is in fastbootd mode.
Throws | |
---|---|
DeviceNotAvailableException |
public void rebootIntoRecovery ()
Reboots the device into adb recovery mode.
Blocks until device enters recovery
Throws | |
---|---|
DeviceNotAvailableException |
public void rebootIntoSideload ()
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
Throws | |
---|---|
DeviceNotAvailableException |
public void rebootIntoSideload (boolean autoReboot)
Reboots the device into adb sideload mode (note that this is a special mode under recovery)
Blocks until device enters sideload mode
پارامترها | |
---|---|
autoReboot | boolean : whether to automatically reboot the device after sideload |
Throws | |
---|---|
DeviceNotAvailableException |
public void rebootUntilOnline ()
An alternate to reboot()
that only blocks until device is online ie visible to adb.
Throws | |
---|---|
DeviceNotAvailableException |
public void rebootUntilOnline (String reason)
An alternate to reboot()
that only blocks until device is online ie visible to adb.
پارامترها | |
---|---|
reason | String : a reason for this reboot, or null if no reason is specified. |
Throws | |
---|---|
DeviceNotAvailableException |
public void rebootUserspace ()
Reboots only userspace part of device.
Blocks until device becomes available.
هشدار. Userspace reboot is currently under active development, use it on your own risk.
Throws | |
---|---|
DeviceNotAvailableException |
public void rebootUserspaceUntilOnline ()
An alternate to rebootUserspace()
()} that only blocks until device is online ie visible to adb.
Throws | |
---|---|
DeviceNotAvailableException |
public boolean recoverDevice ()
Attempts to recover device communication.
Returns | |
---|---|
boolean | True if recovery attempted and successful, returns False if recovery was skipped |
Throws | |
---|---|
DeviceNotAvailableException | if device is no longer available |
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registers a IDeviceActionReceiver
for this device.
All registered IDeviceActionReceiver
s will be notified before a device action starts and after the device action ends.
پارامترها | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : A IDeviceActionReceiver which will be registered. |
public void remountSystemReadOnly ()
Make the system partition on the device read-only. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
public void remountSystemWritable ()
Make the system partition on the device writable. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
public void remountVendorReadOnly ()
Make the vendor partition on the device read-only. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
public void remountVendorWritable ()
Make the vendor partition on the device writable. May reboot the device.
Throws | |
---|---|
DeviceNotAvailableException |
public boolean removeAdmin (String componentName, int userId)
Remove given device admin in given user and return true
if it is successful, false
otherwise.
پارامترها | |
---|---|
componentName | String : of device admin to be removed. |
userId | int : of user that the device admin lives in. |
Returns | |
---|---|
boolean | True if it is successful, false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public void removeOwners ()
Remove all existing device profile owners with the best effort.
Throws | |
---|---|
DeviceNotAvailableException |
public boolean removeUser (int userId)
Remove a given user from the device.
پارامترها | |
---|---|
userId | int : of the user to remove |
Returns | |
---|---|
boolean | true if we were successful in removing the user, false otherwise. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public void resetContentProviderSetup ()
Reset the flag for content provider setup in order to trigger it again.
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
with one or more listeners passed as parameters.
پارامترها | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners | ITestLifeCycleReceiver : the test result listener(s) |
Returns | |
---|---|
boolean | true if test command completed. false if it failed to complete, but recovery succeeded |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Runs instrumentation tests, and provides device recovery.
If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.
If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.
پارامترها | |
---|---|
runner | IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests |
listeners |
Returns | |
---|---|
boolean | true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
but runs the test for the given user.
پارامترها | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
Returns | |
---|---|
boolean |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
but runs the test for a given user.
پارامترها | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
Returns | |
---|---|
boolean |
Throws | |
---|---|
DeviceNotAvailableException |
public void setConfiguration (IConfiguration configuration)
Injects the IConfiguration
in use.
پارامترها | |
---|---|
configuration | IConfiguration |
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
پارامترها | |
---|---|
avdInfo | GceAvdInfo |
public void setDate (Date date)
Sets the date on device
Note: setting date on device requires root
پارامترها | |
---|---|
date | Date : specify a particular date; will use host date if null |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean setDeviceOwner (String componentName, int userId)
Set a device admin component as device owner in given user.
پارامترها | |
---|---|
componentName | String : of device admin to be device owner. |
userId | int : of the user that the device owner lives in. |
Returns | |
---|---|
boolean | True if it is successful, false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public void setDeviceState (TestDeviceState deviceState)
Update the device's state.
پارامترها | |
---|---|
deviceState | TestDeviceState : the TestDeviceState |
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
For emulator set SizeLimitedOutputStream
to log output
پارامترها | |
---|---|
output | SizeLimitedOutputStream : to log the output |
public void setEmulatorProcess (Process p)
Sets the Process
, when this device is an emulator.
پارامترها | |
---|---|
p | Process |
public void setFastbootEnabled (boolean fastbootEnabled)
Set the fastboot option for the device. Should be set when device is first allocated.
پارامترها | |
---|---|
fastbootEnabled | boolean : whether fastboot is available for the device or not |
public void setFastbootPath (String fastbootPath)
Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled()
to be true, to have fastboot functions enabled.
پارامترها | |
---|---|
fastbootPath | String |
public void setIDevice (IDevice newDevice)
Update the IDevice associated with this ITestDevice.
The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDevice
پارامترها | |
---|---|
newDevice | IDevice : the IDevice |
public void setLogStartDelay (int delay)
Sets the time in ms to wait before starting logcat capture for a online device.
پارامترها | |
---|---|
delay | int : the delay in ms |
public void setOptions (TestDeviceOptions options)
Set the TestDeviceOptions
for the device
پارامترها | |
---|---|
options | TestDeviceOptions |
public boolean setProperty (String propKey, String propValue)
Sets the given property value on the device. Requires adb root is true.
پارامترها | |
---|---|
propKey | String : The key targeted to be set. |
propValue | String : The property value to be set. |
Returns | |
---|---|
boolean | returns True if the setprop command was successful, False otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public void setRecovery (IDeviceRecovery recovery)
Set the IDeviceRecovery
to use for this device. Should be set when device is first allocated.
پارامترها | |
---|---|
recovery | IDeviceRecovery : the IDeviceRecovery |
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Set the current recovery mode to use for the device.
Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc
پارامترها | |
---|---|
mode | ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not. |
public void setSetting (String namespace, String key, String value)
See setSetting(int, String, String, String)
and performed on system user.
پارامترها | |
---|---|
namespace | String |
key | String |
value | String |
Throws | |
---|---|
DeviceNotAvailableException |
public void setSetting (int userId, String namespace, String key, String value)
Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}
پارامترها | |
---|---|
userId | int |
namespace | String |
key | String |
value | String |
Throws | |
---|---|
DeviceNotAvailableException |
public void setTestLogger (ITestLogger testLogger)
Injects the ITestLogger
instance
پارامترها | |
---|---|
testLogger | ITestLogger |
public void setTrackingSerial (String trackingSerial)
For device management purpose track the serial we use for referencing the device.
پارامترها | |
---|---|
trackingSerial | String |
public void setUseFastbootErase (boolean useFastbootErase)
Set whether to use fastboot erase or fastboot format to wipe a partition on the device.
پارامترها | |
---|---|
useFastbootErase | boolean : true if fastboot erase should be used or false if fastboot format should be used. |
public void startLogcat ()
Start capturing logcat output from device in the background.
Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.
When the device is no longer in use, stopLogcat()
must be called.
startLogcat()
and stopLogcat()
do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.
public boolean startUser (int userId)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.
پارامترها | |
---|---|
userId | int : of the user to start in the background |
Returns | |
---|---|
boolean | true if the user was successfully started in the background. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean startUser (int userId, boolean waitFlag)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.
پارامترها | |
---|---|
userId | int : of the user to start in the background |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Returns | |
---|---|
boolean | true if the user was successfully started in the background. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).
NOTE: this command doesn't check if the user exists, display is available, device supports such feature
, etc.
پارامترها | |
---|---|
userId | int : of the user to start in the background |
displayId | int : display to start user visible on |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Returns | |
---|---|
boolean | true if the user was successfully started visible in the background. |
Throws | |
---|---|
DeviceNotAvailableException |
public void stopEmulatorOutput ()
Close and delete the emulator output.
public void stopLogcat ()
Stop capturing logcat output from device, and discard currently saved logcat data.
Will have no effect if logcat output is not being captured.
public boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
پارامترها | |
---|---|
userId | int : of the user to stop. |
Returns | |
---|---|
boolean | true if the user was successfully stopped. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.
پارامترها | |
---|---|
userId | int : of the user to stop. |
waitFlag | boolean : will make the command wait until user is stopped. |
forceFlag | boolean : will force stop the user. |
Returns | |
---|---|
boolean | true if the user was successfully stopped. |
Throws | |
---|---|
DeviceNotAvailableException |
public String switchToAdbTcp ()
Switch device to adb-over-tcp mode.
Returns | |
---|---|
String | the tcp serial number or null if device could not be switched |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean switchToAdbUsb ()
Switch device to adb over usb mode.
Returns | |
---|---|
boolean | true if switch was successful, false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean switchUser (int userId)
Switch to another userId with a default timeout. switchUser(int, long)
.
پارامترها | |
---|---|
userId | int |
Returns | |
---|---|
boolean | True if the new userId matches the userId provider. False otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean switchUser (int userId, long timeout)
Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.
پارامترها | |
---|---|
userId | int |
timeout | long : to wait before returning false for switch-user failed. |
Returns | |
---|---|
boolean | True if the new userId matches the userId provider. False otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean syncFiles (File localFileDir, String deviceFilePath)
Incrementally syncs the contents of a local file directory to device.
Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.
Hidden files (with names starting with ".") will be ignored.
Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.
پارامترها | |
---|---|
localFileDir | File : the local file directory containing files to recursively push. |
deviceFilePath | String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail |
Returns | |
---|---|
boolean | true if files were synced successfully. false otherwise. |
Throws | |
---|---|
DeviceNotAvailableException |
public Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close()
.
Returns | |
---|---|
Bugreport |
public String uninstallPackage (String packageName)
Uninstall an Android package from device.
Parameters | |
---|---|
packageName | String : the Android package to uninstall |
Returns | |
---|---|
String | a String with an error code, or null if success. |
Throws | |
---|---|
DeviceNotAvailableException |
public String uninstallPackageForUser (String packageName, int userId)
Uninstall an Android package from device for a given user.
Parameters | |
---|---|
packageName | String : the Android package to uninstall |
userId | int : the integer user id to uninstall for. |
Returns | |
---|---|
String | a String with an error code, or null if success. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean unlockDevice ()
Unlocks the device if the device is in an encrypted state.
This method may restart the framework but will not callpostBootSetup()
. Therefore, the device might not be fully ready to be tested when this method returns.Returns | |
---|---|
boolean | true if successful or if the device is unencrypted. |
Throws | |
---|---|
DeviceNotAvailableException |
public void unmountDebugfs ()
Unmount debugfs.
Throws | |
---|---|
DeviceNotAvailableException |
public boolean waitForBootComplete (long timeOut)
Blocks until the device's boot complete flag is set.
پارامترها | |
---|---|
timeOut | long : time in msecs to wait for the flag to be set |
Returns | |
---|---|
boolean | true if device's boot complete flag is set within the timeout |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean waitForDeviceAvailable ()
Waits for the device to be responsive and available for testing. Uses default timeout.
Returns | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean waitForDeviceAvailable (long waitTime)
Waits for the device to be responsive and available for testing.
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Returns | |
---|---|
boolean | True if device is available, False if recovery is disabled and unavailable. |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Waits for the device to be responsive and available without considering recovery path.
Parameters | |
---|---|
waitTime | long |
Returns | |
---|---|
boolean | True if device is available, False if unavailable. |
Throws | |
---|---|
DeviceNotAvailableException |
public void waitForDeviceBootloader ()
Blocks until device is visible via fastboot. Use default timeout.
Throws | |
---|---|
DeviceNotAvailableException |
public boolean waitForDeviceInRecovery (long waitTime)
Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery
).
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Returns | |
---|---|
boolean | true if device boots into recovery before time expires. false otherwise |
public boolean waitForDeviceInSideload (long waitTime)
Blocks for the device to be in the 'adb sideload' state
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Returns | |
---|---|
boolean | true if device boots into sideload before time expires. false otherwise |
public boolean waitForDeviceNotAvailable (long waitTime)
Blocks for the device to be not available ie missing from adb
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Returns | |
---|---|
boolean | true if device becomes not available before time expires. false otherwise |
public void waitForDeviceOnline ()
Blocks until device is visible via adb. Uses default timeout
Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable()
instead.
Throws | |
---|---|
DeviceNotAvailableException |
public void waitForDeviceOnline (long waitTime)
Blocks until device is visible via adb.
Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable()
instead.
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Throws | |
---|---|
DeviceNotAvailableException |
public boolean waitForDeviceShell (long waitTime)
Waits for device to be responsive to a basic adb shell command.
Parameters | |
---|---|
waitTime | long : the time in ms to wait |
Returns | |
---|---|
boolean | true if device becomes responsive before waitTime elapses. |
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parameters | |
---|---|
builder | DefaultConnection.ConnectionBuilder |
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Builds the OS command for the given adb shell command session and args
Parameters | |
---|---|
command | String |
forceExitStatusDetection | boolean |
Returns | |
---|---|
String[] |
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parameters | |
---|---|
feature | String |
strictMinLevel | int |
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Create a RebootDeviceAction
to be used when performing a reboot action.
Parameters | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Returns | |
---|---|
NativeDevice.RebootDeviceAction | the created RebootDeviceAction . |
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Perform a adb reboot.
Parameters | |
---|---|
rebootMode | NativeDevice.RebootMode : a mode of this reboot. |
reason | String : for this reboot. |
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
protected void ensureRuntimePermissionSupported ()
helper method to throw exception if runtime permission isn't supported
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
protected int getApiLevelSafe ()
Returns | |
---|---|
int |
protected ITestLogger getLogger ()
Returns | |
---|---|
ITestLogger |
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parameters | |
---|---|
info | IBuildInfo |
attributes | MultiMap |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
protected String internalGetProperty (String propName, String fastbootVar, String description)
Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.
Parameters | |
---|---|
propName | String : The name of the device property as returned by `adb shell getprop` |
fastbootVar | String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted |
description | String : A simple description of the variable. First letter should be capitalized. |
Returns | |
---|---|
String | A string, possibly null or empty, containing the value of the given property |
Throws | |
---|---|
DeviceNotAvailableException |
protected boolean isInRebootCallback ()
Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.
Returns | |
---|---|
boolean |
protected boolean isNewer (File localFile, IFileEntry entry)
Return true
if local file is newer than remote file. IFileEntry
being accurate to the minute, in case of equal times, the file will be considered newer.
Parameters | |
---|---|
localFile | File |
entry | IFileEntry |
Returns | |
---|---|
boolean |
protected void notifyRebootEnded ()
Notifies all IDeviceActionReceiver
about reboot end event.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
protected void notifyRebootStarted ()
Notifies all IDeviceActionReceiver
about reboot start event.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Performs an action on this device. Attempts to recover device and optionally retry command if action fails.
Parameters | |
---|---|
actionDescription | String : a short description of action to be performed. Used for logging purposes only. |
action | NativeDevice.DeviceAction : the action to be performed |
retryAttempts | int : the retry attempts to make for action if it fails but recovery succeeds |
Returns | |
---|---|
boolean | true if action was performed successfully |
Throws | |
---|---|
DeviceNotAvailableException | if recovery attempt fails or max attempts done without success |
protected void postAdbReboot ()
Possible extra actions that can be taken after a reboot.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
protected void prePostBootSetup ()
Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.
Throws | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
protected boolean pullFileInternal (String remoteFilePath, File localFile)
پارامترها | |
---|---|
remoteFilePath | String |
localFile | File |
Returns | |
---|---|
boolean |
Throws | |
---|---|
DeviceNotAvailableException |
protected void setClock (Clock clock)
Set the Clock instance to use.
Parameters | |
---|---|
clock | Clock |
protected void setMicrodroidProcess (Process process)
Marks the TestDevice as microdroid and sets its CID.
Parameters | |
---|---|
process | Process : Process of the Microdroid VM. |
protected void setTestDeviceOptions (deviceOptions)
Parameters | |
---|---|
deviceOptions |
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Executes a simple fastboot command with environment variables and report the status of the command.
Parameters | |
---|---|
timeout | long |
envVarMap | |
fullCmd | String |
Returns | |
---|---|
CommandResult |
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Executes a simple fastboot command and report the status of the command.
Parameters | |
---|---|
timeout | long |
fullCmd | String |
Returns | |
---|---|
CommandResult |
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Wait to see the device going unavailable (stop reporting to adb).
Parameters | |
---|---|
operationDesc | String : The name of the operation that is waiting for unavailable. |
time | long : The time to wait for unavailable to occur. |
Returns | |
---|---|
boolean | True if device did become unavailable. |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2024-08-13 بهوقت ساعت هماهنگ جهانی.