NativeDevice
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 ( به شبکه وای فای متصل می شود. |
boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) به شبکه وای فای متصل می شود. |
boolean | connectToWifiNetwork ( به شبکه وای فای متصل می شود.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 ایجاد کنید. |
DeviceInspectionResult | debugDeviceNotAvailable () یک دستگاه را بازرسی کنید و وقتی دستگاهی در دسترس نیست، اطلاعات دقیق را برگردانید. |
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, متد 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 ( روش کمکی که یک فرمان طولانی در حال اجرا سریع بوت را به عنوان فرمان سیستم با متغیرهای محیط سیستم اجرا می کند. |
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 () شماره سریال حالت fastboot را برمی گرداند. |
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 (long displayId) یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد. |
InputStreamSource | getScreenshot (String format) یک اسکرین شات از دستگاه می گیرد. |
InputStreamSource | getScreenshot (String format, boolean rescale) یک اسکرین شات از دستگاه می گیرد. |
InputStreamSource | getScreenshot () یک اسکرین شات از دستگاه می گیرد. |
String | getSerialNumber () روش آسان برای دریافت شماره سریال این دستگاه. |
String | getSetting (int userId, String namespace, String key) مقدار تنظیمات درخواستی را برگردانید. |
String | getSetting (String namespace, String key) |
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, به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید در حالی که برخی دایرکتوری ها را که فیلتر شده اند حذف کنید. |
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, تست های ابزار دقیق را اجرا می کند و بازیابی دستگاه را فراهم می کند. |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, مانند |
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 | startTradeInModeTesting (int timeoutMs) حالت معاملاتی آزمایشی را فعال کنید. |
boolean | startUser (int userId) اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. |
boolean | startUser (int userId, boolean waitFlag) اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) کاربر مشخصی را در پسزمینه شروع میکند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه میدهد فعالیتها را در آن نمایشگر راهاندازی کند). |
void | stopEmulatorOutput () خروجی شبیه ساز را ببندید و حذف کنید. |
void | stopLogcat () گرفتن خروجی logcat از دستگاه را متوقف کنید و داده های ذخیره شده logcat را دور بریزید. |
void | stopTradeInModeTesting () آزمایش حالت تجارت در را متوقف کنید. |
boolean | stopUser (int userId) یک کاربر معین را متوقف می کند. |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) یک کاربر معین را متوقف کنید. |
String | switchToAdbTcp () دستگاه را به حالت adb-over-tcp تغییر دهید. |
boolean | switchToAdbUsb () دستگاه را به حالت adb از طریق usb تغییر دهید. |
boolean | switchUser (int userId) به userId دیگری با مهلت زمانی پیشفرض تغییر وضعیت دهید. |
boolean | switchUser (int userId, long timeout) به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید. |
boolean | syncFiles (File localFileDir, String deviceFilePath) به صورت تدریجی محتویات یک فهرست فایل محلی را با دستگاه همگام می کند. |
Bugreport | takeBugreport () یک Bugreport بگیرید و آن را در یک شی |
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 ( |
CommandResult | simpleFastbootCommand (long timeout, یک فرمان ساده fastboot را با متغیرهای محیطی اجرا می کند و وضعیت دستور را گزارش می دهد. |
CommandResult | simpleFastbootCommand (long timeout, String[] fullCmd) یک فرمان ساده fastboot را اجرا می کند و وضعیت فرمان را گزارش می کند. |
boolean | waitForDeviceNotAvailable (String operationDesc, long time) منتظر بمانید تا دستگاه در دسترس نباشد (گزارش به adb را متوقف کنید). |
ثابت ها
INVALID_USER_ID
public static final int INVALID_USER_ID
مقدار بازگشتی برای هر شناسه کاربری نامعتبر/یافتنی: UserHandle مقدار -10000 را تعریف کرد
مقدار ثابت: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
مقدار ثابت: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
تعداد پیش فرض دستور سعی مجدد برای انجام
مقدار ثابت: 2 (0x00000002)
فیلدها
DEBUGFS_PATH
public static final String DEBUGFS_PATH
SD_CARD
protected static final String SD_CARD
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
mOptions
protected TestDeviceOptions mOptions
mStateMonitor
protected final IDeviceStateMonitor mStateMonitor
سازندگان عمومی
NativeDevice
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
یک TestDevice
ایجاد می کند.
پارامترها | |
---|---|
device | IDevice : IDevice مرتبط |
stateMonitor | IDeviceStateMonitor : مکانیسم IDeviceStateMonitor برای استفاده |
allocationMonitor | IDeviceMonitor : IDeviceMonitor برای اطلاع از تغییرات وضعیت تخصیص. می تواند پوچ باشد |
روش های عمومی
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
بهینهسازی میکرو (حدود 400 میلیلیتر) با واکشی از قبل همه لوازم مورد نیاز ما به جای فراخوانی «adb getprop» برای هر یک. یعنی واکشی همه ویژگی ها به همان سرعتی است که واکشی یکی است. مواردی مانند device.getApiLevel()، checkApiLevelAgainstNextRelease و getBuildAlias همگی «adb getprop» را در زیر هود صدا می کنند. ما آنها را در یک تماس واکشی می کنیم و NativeDevice.setProperty را فرا می خوانیم. حتی اگر این کار را انجام ندهیم، NativeDevice خودش setProperty را فراخوانی می کند و نتیجه را برای تماس های بعدی کش می کند. ما فقط کمی زودتر این کار را انجام می دهیم. اگر دستگاه در حال بازیابی است یا خطاهای دیگری در واکشی لوازم وجود دارد، ما فقط آنها را نادیده می گیریم.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
برمیگرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
بررسی کنید که آیا یک ویژگی در حال حاضر با حداقل پشتیبانی پشتیبانی می شود یا خیر. این روش قبل از اینکه سطح API افزایش یابد، ویژگیهای منتشر نشده را در نظر میگیرد.
پارامترها | |
---|---|
strictMinLevel | int : حداقل حداقل سطح ممکن که از این ویژگی پشتیبانی می کند. |
برمی گرداند | |
---|---|
boolean | اگر سطح پشتیبانی شود درست است. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
بررسی اتصال
public boolean checkConnectivity ()
بررسی کنید که دستگاه اتصال شبکه دارد.
برمی گرداند | |
---|---|
boolean | true اگر دستگاه اتصال شبکه کار می کند، false . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
clearErrorDialogs
public boolean clearErrorDialogs ()
سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید.
برمی گرداند | |
---|---|
boolean | true اگر هیچ گفتگویی وجود نداشته باشد یا گفتگوها با موفقیت پاک شوند. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
آخرین شبکه وای فای متصل را پاک می کند. این باید هنگام شروع فراخوانی جدید برای جلوگیری از اتصال به شبکه وای فای مورد استفاده در آزمایش قبلی پس از راهاندازی مجدد دستگاه خوانده شود.
clearLogcat
public void clearLogcat ()
تمام داده های logcat انباشته شده را حذف می کند.
این برای مواردی مفید است که میخواهید مطمئن شوید ITestDevice.getLogcat()
فقط دادههای گزارش تولید شده پس از یک نقطه خاص (مانند فلش کردن یک دستگاه جدید و غیره) را برمیگرداند.
اتصال به شبکه Wifi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
به شبکه وای فای متصل می شود.
وای فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز با یکی از شبکه های وای فای ارائه شده در نقشه wifiSsidToPsk برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice.disconnectFromWifi()
یا ITestDevice.clearLastConnectedWifiNetwork()
فراخوانی شود.
پارامترها | |
---|---|
wifiSsidToPsk | : نقشه ای از SSID وای فای به گذرواژه ها. |
scanSsid | boolean : آیا باید SSIDهای مخفی این شبکه را اسکن کرد یا خیر. |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
اتصال به شبکه Wifi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
به شبکه وای فای متصل می شود.
فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز به شبکه وای فای مشخص شده برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice.disconnectFromWifi()
یا ITestDevice.clearLastConnectedWifiNetwork()
فراخوانی شود.
پارامترها | |
---|---|
wifiSsid | String : وای فای ssid برای اتصال |
wifiPsk | String : عبارت عبور PSK یا اگر رمزگذاری نشده باشد، null است |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
اتصال به شبکه Wifi
public boolean connectToWifiNetwork (wifiSsidToPsk)
به شبکه وای فای متصل می شود.
وای فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز با یکی از شبکه های وای فای ارائه شده در نقشه wifiSsidToPsk برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice.disconnectFromWifi()
یا ITestDevice.clearLastConnectedWifiNetwork()
فراخوانی شود.f
پارامترها | |
---|---|
wifiSsidToPsk | : نقشه ای از SSID وای فای به گذرواژه ها. |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
اتصال به شبکه Wifi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
به شبکه وای فای متصل می شود.
فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز به شبکه وای فای مشخص شده برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice.disconnectFromWifi()
یا ITestDevice.clearLastConnectedWifiNetwork()
فراخوانی شود.
پارامترها | |
---|---|
wifiSsid | String : وای فای ssid برای اتصال |
wifiPsk | String : عبارت عبور PSK یا اگر رمزگذاری نشده باشد، null است |
scanSsid | boolean : آیا باید SSID مخفی این شبکه را اسکن کرد. |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ConnectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
گونه ای از connectToWifiNetwork(String, String)
که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
پارامترها | |
---|---|
scanSsid | boolean : آیا باید SSID مخفی این شبکه را اسکن کرد |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ConnectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
گونه ای از connectToWifiNetwork(String, String)
که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral)
یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
پارامترها | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
guest | boolean : فعال کردن پرچم کاربر --guest در حین ایجاد |
ephemeral | boolean : در حین ایجاد، پرچم کاربر را فعال کنید |
برمی گرداند | |
---|---|
int | شناسه کاربر ایجاد شده |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
پارامترها | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
guest | boolean : فعال کردن پرچم کاربر --guest در حین ایجاد |
ephemeral | boolean : در حین ایجاد، پرچم کاربر را فعال کنید |
forTesting | boolean : پرچم تست --برای آزمایش در حین ایجاد را فعال کنید |
برمی گرداند | |
---|---|
int | شناسه کاربر ایجاد شده |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name)
یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
پارامترها | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
برمی گرداند | |
---|---|
int | عدد صحیح برای شناسه کاربری ایجاد شده |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
پارامترها | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
برمی گرداند | |
---|---|
int | عدد صحیح برای شناسه کاربر ایجاد شده یا -1 برای خطا. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
debugDeviceNotAvailable
public DeviceInspectionResult debugDeviceNotAvailable ()
یک دستگاه را بازرسی کنید و وقتی دستگاهی در دسترس نیست، اطلاعات دقیق را برگردانید.
برمی گرداند | |
---|---|
DeviceInspectionResult |
حذف فایل
public void deleteFile (String deviceFilePath, int userId)
روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه.
پارامترها | |
---|---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه. |
userId | int : شناسه کاربری که باید از آن حذف شود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
حذف فایل
public void deleteFile (String deviceFilePath)
روش کمکی برای حذف یک فایل یا دایرکتوری در دستگاه.
پارامترها | |
---|---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
لغو ثبت DeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
IDeviceActionReceiver
ثبت شده را حذف می کند.
پارامترها | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : یک IDeviceActionReceiver که حذف خواهد شد. |
deviceSoftRestarted
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
روش کمکی برای بررسی اینکه آیا دستگاه با مقایسه system_server فعلی با system_server ProcessInfo
قبلی، نرمافزار راهاندازی شده است یا خیر. برای دریافت ProcessInfo
getProcessByName(String)
استفاده کنید.
پارامترها | |
---|---|
prevSystemServerProcess | ProcessInfo : فرآیند system_server قبلی ProcessInfo . |
برمی گرداند | |
---|---|
boolean | true اگر دستگاه به صورت نرم راه اندازی شود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
deviceSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
روش کمکی برای بررسی اینکه آیا دستگاه از زمان UTC از دوره زمانی از دستگاه و ERROR(/TimeUnit)
نرمافزار راهاندازی شده است یا خیر. Soft-Restart به system_server اشاره دارد که خارج از راهاندازی مجدد سخت دستگاه (برای مثال: راهاندازی مجدد درخواستی) مجدداً راهاندازی شده است. دستگاه فعلی utcEpochTime در میلی ثانیه را می توان با روش getDeviceDate()
بدست آورد.
پارامترها | |
---|---|
utcEpochTime | long : زمان دستگاه در ثانیه از زمان. |
timeUnit | TimeUnit : واحد زمان TimeUnit برای utcEpochTime داده شده. |
برمی گرداند | |
---|---|
boolean | true اگر دستگاه به صورت نرم راه اندازی شود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
غیرفعال کردن AdbRoot
public boolean disableAdbRoot ()
ریشه adb را خاموش می کند.
غیرفعال کردن ریشه adb ممکن است باعث قطع ارتباط دستگاه با adb شود. این روش تا زمانی که دستگاه در دسترس نباشد مسدود خواهد شد.
برمی گرداند | |
---|---|
boolean | در صورت موفقیت true |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
غیرفعال کردن کیگارد
public void disableKeyguard ()
تلاش برای غیرفعال کردن محافظ صفحه کلید.
ابتدا منتظر بمانید تا ارسال ورودی آماده شود، این تقریباً همزمان با گزارش دستگاه BOOT_COMPLETE، ظاهراً ناهمزمان، اتفاق میافتد، زیرا پیادهسازی چارچوب فعلی دارای شرایط مسابقه گاه به گاه است. سپس دستور رد کردن صفحه کلید ارسال می شود (فقط روی موارد غیر ایمن کار می کند)
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
شبکه مانیتور را غیرفعال کنید
public boolean disableNetworkMonitor ()
مانیتورینگ شبکه را در دستگاه غیرفعال می کند.
برمی گرداند | |
---|---|
boolean | true اگر نظارت با موفقیت غیرفعال شود. false اگر شکست خورد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
قطع اتصال از وای فای
public boolean disconnectFromWifi ()
از شبکه وای فای قطع می شود.
تمام شبکه ها را از لیست شبکه های شناخته شده حذف می کند و وای فای را غیرفعال می کند.
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت از شبکه وای فای قطع شود. false اگر قطع اتصال انجام نشد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر.
پارامترها | |
---|---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه برای بررسی |
userId | int : شناسه کاربری که وجود فایل را با آن بررسی کنید |
برمی گرداند | |
---|---|
boolean | true در صورت وجود فایل، false در غیر این صورت. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath)
روش کمکی برای تعیین وجود فایل روی دستگاه.
پارامترها | |
---|---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه برای بررسی |
برمی گرداند | |
---|---|
boolean | true در صورت وجود فایل، false در غیر این صورت. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
dumpHeap
public File dumpHeap (String process, String devicePath)
سعی کنید پشته را از system_server تخلیه کنید. این وظیفه تماس گیرنده است که فایل تخلیه شده را پاک کند.
پارامترها | |
---|---|
process | String : نام فرآیند دستگاهی که باید روی آن تخلیه شود. |
devicePath | String : مسیر روی دستگاه که در آن روگرفت را قرار دهید. این باید مکانی باشد که مجوزها اجازه آن را می دهند. |
برمی گرداند | |
---|---|
File | ERROR(/File) حاوی گزارش. اگر چیزی شکست خورده است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
فعال کردن AdbRoot
public boolean enableAdbRoot ()
ریشه adb را روشن می کند. اگر تنظیم "enable-root" "false" باشد، پیامی را ثبت می کند و بدون فعال کردن root باز می گردد.
فعال کردن ریشه adb ممکن است باعث قطع ارتباط دستگاه با adb شود. این روش تا زمانی که دستگاه در دسترس نباشد مسدود خواهد شد.
برمی گرداند | |
---|---|
boolean | در صورت موفقیت true |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
مانیتور شبکه را فعال کنید
public boolean enableNetworkMonitor ()
نظارت بر شبکه را بر روی دستگاه فعال می کند.
برمی گرداند | |
---|---|
boolean | true اگر نظارت با موفقیت فعال شود. false اگر شکست خورد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دستور Adb را اجرا کنید
public String executeAdbCommand (long timeout, String... cmdArgs)
متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند.
executeShellCommand(String)
باید هر جا که امکان دارد استفاده شود، زیرا آن روش تشخیص خرابی و عملکرد بهتری را ارائه می دهد.
پارامترها | |
---|---|
timeout | long : زمان بر حسب میلی ثانیه قبل از اینکه دستگاه پاسخگو نباشد، 0 لیتر بدون وقفه |
cmdArgs | String : دستور adb و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
String | stdout از دستور. اگر دستور اجرا نشد null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دستور Adb را اجرا کنید
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
متد Helper که یک دستور adb را به عنوان یک فرمان سیستم با یک بازه زمانی مشخص اجرا می کند.
executeShellCommand(String)
باید هر جا که امکان دارد استفاده شود، زیرا آن روش تشخیص خرابی و عملکرد بهتری را ارائه می دهد.
پارامترها | |
---|---|
timeout | long : زمان بر حسب میلی ثانیه قبل از اینکه دستگاه پاسخگو نباشد، 0 لیتر بدون وقفه |
envMap | : محیطی برای تنظیم دستور |
cmdArgs | String : دستور adb و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
String | stdout از دستور. اگر دستور اجرا نشد null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دستور Adb را اجرا کنید
public String executeAdbCommand (String... cmdArgs)
متد Helper که دستور adb را به عنوان دستور سیستم اجرا می کند.
executeShellCommand(String)
باید هر جا که امکان دارد استفاده شود، زیرا آن روش تشخیص خرابی و عملکرد بهتری را ارائه می دهد.
پارامترها | |
---|---|
cmdArgs | String : دستور adb و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
String | stdout از دستور. اگر دستور اجرا نشد null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دستور Fastboot Command را اجرا کنید
public CommandResult executeFastbootCommand (String... cmdArgs)
روش Helper که یک فرمان fastboot را به عنوان یک فرمان سیستم با زمان پیش فرض 2 دقیقه اجرا می کند.
انتظار می رود زمانی استفاده شود که دستگاه از قبل در حالت فست بوت است.
پارامترها | |
---|---|
cmdArgs | String : دستور fastboot و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دستور Fastboot Command را اجرا کنید
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
متد Helper که دستور fastboot را به عنوان دستور سیستم اجرا می کند.
انتظار می رود زمانی استفاده شود که دستگاه از قبل در حالت فست بوت است.
پارامترها | |
---|---|
timeout | long : زمان بر حسب میلی ثانیه قبل از انقضای فرمان |
cmdArgs | String : دستور fastboot و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
اجرایLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
متد Helper که یک فرمان طولانی در حال اجرا fastboot را به عنوان فرمان سیستم اجرا می کند.
با executeFastbootCommand(String)
یکسان است، به جز اینکه از زمان طولانی تری استفاده می کند.
پارامترها | |
---|---|
cmdArgs | String : دستور fastboot و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
اجرایLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
روش کمکی که یک فرمان طولانی در حال اجرا سریع بوت را به عنوان فرمان سیستم با متغیرهای محیط سیستم اجرا می کند.
با executeFastbootCommand(String)
یکسان است، به جز اینکه از زمان طولانی تری استفاده می کند.
پارامترها | |
---|---|
envVarMap | : متغیرهای محیطی سیستم که دستور fastboot با آنها اجرا می شود |
cmdArgs | String : دستور fastboot و آرگومان هایی که باید اجرا شوند |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellCommand را اجرا کنید
public String executeShellCommand (String command)
متد Helper که یک دستور adb shell را اجرا می کند و خروجی را به صورت String
برمی گرداند.
پارامترها | |
---|---|
command | String : دستور adb shell برای اجرا |
برمی گرداند | |
---|---|
String | خروجی پوسته |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellCommand را اجرا کنید
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
command | String : دستور adb shell برای اجرا |
receiver | IShellOutputReceiver : IShellOutputReceiver برای هدایت خروجی پوسته به آن. |
maxTimeToOutputShellResponse | long : حداکثر مدت زمانی که فرمان مجاز است هیچ پاسخی صادر نکند. واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر retryAttempts بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellCommand را اجرا کنید
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
command | String : دستور adb shell برای اجرا |
receiver | IShellOutputReceiver : IShellOutputReceiver برای هدایت خروجی پوسته به آن. |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور. واحد همانطور که در timeUnit مشخص شده است |
maxTimeToOutputShellResponse | long : حداکثر مدت زمانی که فرمان مجاز است هیچ پاسخی صادر نکند. واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر retryAttempts بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellCommand را اجرا کنید
public void executeShellCommand (String command, IShellOutputReceiver receiver)
دستور adb shell داده شده را اجرا می کند و در صورت شکست دستور چندین بار دوباره امتحان می کند.
شکل سادهتری از executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
با مقادیر پیشفرض.
پارامترها | |
---|---|
command | String : دستور adb shell برای اجرا |
receiver | IShellOutputReceiver : IShellOutputReceiver برای هدایت خروجی پوسته به آن. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellV2Command را اجرا کنید
public CommandResult executeShellV2Command (String cmd)
متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت CommandResult
با خروجی وضعیت فرمان، stdout و stderr به درستی پر می کند.
پارامترها | |
---|---|
cmd | String : دستوری که باید اجرا شود. |
برمی گرداند | |
---|---|
CommandResult | نتیجه در CommandResult . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellV2Command را اجرا کنید
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت CommandResult
که به درستی با خروجی وضعیت فرمان و stderr پر شده است برمی گرداند. stdout به جریان مشخص شده هدایت می شود.
پارامترها | |
---|---|
cmd | String : دستوری که باید اجرا شود. |
pipeToOutput | OutputStream : ERROR(/OutputStream) که در آن خروجی std تغییر مسیر داده میشود یا تهی میشود. |
برمی گرداند | |
---|---|
CommandResult | نتیجه در CommandResult . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellV2Command را اجرا کنید
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
متد Helper که یک دستور adb shell را اجرا می کند و نتایج را به صورت CommandResult
با خروجی وضعیت فرمان، stdout و stderr به درستی پر می کند.
پارامترها | |
---|---|
cmd | String : دستوری که باید اجرا شود. |
pipeAsInput | File : یک ERROR(/File) که به عنوان ورودی دستور یا null ارسال می شود. |
برمی گرداند | |
---|---|
CommandResult | نتیجه در CommandResult . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellV2Command را اجرا کنید
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
cmd | String : دستور adb shell برای اجرا |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور. واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر retryAttempts بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود. |
برمی گرداند | |
---|---|
CommandResult |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellV2Command را اجرا کنید
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
cmd | String : دستور adb shell برای اجرا |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور. واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
برمی گرداند | |
---|---|
CommandResult |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellV2Command را اجرا کنید
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
cmd | String : دستور adb shell برای اجرا |
pipeAsInput | File : یک ERROR(/File) که به عنوان ورودی دستور یا null ارسال می شود. |
pipeToOutput | OutputStream : ERROR(/OutputStream) که در آن خروجی std تغییر مسیر داده میشود یا تهی میشود. |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور. واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر retryAttempts بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود. |
برمی گرداند | |
---|---|
CommandResult |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
ShellV2Command را اجرا کنید
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
یک فرمان پوسته adb را با پارامترهای بیشتری برای کنترل رفتار فرمان اجرا می کند.
پارامترها | |
---|---|
cmd | String : دستور adb shell برای اجرا |
pipeAsInput | File : یک ERROR(/File) که به عنوان ورودی دستور یا null ارسال می شود. |
pipeToOutput | OutputStream : ERROR(/OutputStream) که در آن خروجی std تغییر مسیر داده میشود یا تهی میشود. |
pipeToError | OutputStream : ERROR(/OutputStream) که در آن خطای std تغییر مسیر داده می شود، یا null می شود. |
maxTimeoutForCommand | long : حداکثر زمان برای تکمیل دستور. واحد همانطور که در timeUnit مشخص شده است |
timeUnit | TimeUnit : واحد برای maxTimeToOutputShellResponse |
retryAttempts | int : حداکثر تعداد دفعات تکرار دستور در صورت عدم موفقیت به دلیل یک استثنا. اگر retryAttempts بدون موفقیت انجام شود، DeviceNotResponsiveException پرتاب می شود. |
برمی گرداند | |
---|---|
CommandResult |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
fastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
روش کمکی که یک پارتیشن را برای دستگاه پاک می کند.
اگر getUseFastbootErase()
true
باشد، از fastboot erase برای پاک کردن پارتیشن استفاده خواهد شد. سپس دستگاه باید در دفعه بعد که دستگاه بوت می شود یک سیستم فایل ایجاد کند. در غیر این صورت از فرمت fastboot استفاده می شود که یک فایل سیستم جدید در دستگاه ایجاد می کند.
انتظار می رود زمانی استفاده شود که دستگاه از قبل در حالت فست بوت است.
پارامترها | |
---|---|
partition | String : پارتیشنی که باید پاک شود |
برمی گرداند | |
---|---|
CommandResult | CommandResult حاوی خروجی فرمان است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
اطلاعات مربوط به APEX های فعال شده در دستگاه را واکشی کنید.
برمی گرداند | |
---|---|
| ERROR(/Set) ApexInfo در حال حاضر در دستگاه فعال شده است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
جفت مقدار کلید فضای نام درخواستی را برگردانید.
پارامترها | |
---|---|
namespace | String : باید یکی از {"system"، "secure"، "global"} باشد. |
برمی گرداند | |
---|---|
| نقشه جفت ارزش کلیدی اگر فضای نام پشتیبانی نشود، تهی است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
وضعیت تخصیص فعلی دستگاه را برگردانید
برمی گرداند | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
شناسه android مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
String |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getAndroidIds
publicgetAndroidIds ()
یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید. هیچ بیمه ای وجود ندارد که هر شناسه کاربری یک شناسه اندروید مرتبط با این تابع را پیدا کند، بنابراین برخی از شناسه های کاربر ممکن است با null مطابقت داشته باشند.
برمی گرداند | |
---|---|
| نقشه شناسه های اندروید، شناسه های کاربر منطبق را پیدا کرد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getApiLevel
public int getApiLevel ()
سطح API دستگاه را دریافت کنید. پیشفرض UNKNOWN_API_LEVEL
است.
برمی گرداند | |
---|---|
int | یک عدد صحیح که سطح API دستگاه را نشان می دهد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
اطلاعات مربوط به بسته نصب شده روی دستگاه را واکشی کنید.
پارامترها | |
---|---|
packageName | String |
برمی گرداند | |
---|---|
PackageInfo | PackageInfo یا در صورتی که اطلاعات قابل بازیابی نباشد، null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos
publicgetAppPackageInfos ()
اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید.
برمی گرداند | |
---|---|
| ERROR(/List) PackageInfo های نصب شده روی دستگاه. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
روش آسان برای دریافت نسخه بیس باند (رادیویی) این دستگاه. دریافت نسخه رادیویی مخصوص دستگاه است، بنابراین ممکن است اطلاعات صحیح را برای همه دستگاهها برنگرداند. این روش برای بازگرداندن اطلاعات نسخه صحیح به ویژگی gsm.version.baseband متکی است. این برای برخی از دستگاههای CDMA دقیق نیست و نسخه بازگشتی در اینجا ممکن است با نسخه گزارششده از fastboot مطابقت نداشته باشد و ممکن است نسخه را برای رادیو CDMA برگرداند. TL;DR این روش تنها در صورتی نسخه دقیق را گزارش میکند که ویژگی gsm.version.baseband با نسخه بازگردانده شده توسط fastboot getvar version-baseband
یکسان باشد.
برمی گرداند | |
---|---|
String | اگر نمی توان آن را تعیین کرد، نسخه باند پایه String یا null (دستگاه رادیو ندارد یا رشته نسخه قابل خواندن نیست) |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دریافت باتری
public Integer getBattery ()
سطح فعلی باتری یک دستگاه را برمیگرداند یا اگر سطح باتری در دسترس نباشد، Null را برمیگرداند.
برمی گرداند | |
---|---|
Integer |
getBooleanProperty
public boolean getBooleanProperty (String name, boolean defaultValue)
مقدار بولی ویژگی داده شده را برمی گرداند.
پارامترها | |
---|---|
name | String : نام ملک |
defaultValue | boolean : مقدار پیشفرض برای بازگشت در صورت خالی بودن یا نبودن ویژگی. |
برمی گرداند | |
---|---|
boolean | اگر ویژگی دارای مقدار "1" ، "y" ، "yes" ، "on" یا "true" true ، اگر ویژگی دارای مقدار "0" ، "n" ، "no" ، "off" ، "false" یا defaultValue باشد، false . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getBootHistory
publicgetBootHistory ()
روش Helper نقشه تاریخچه بوت را با زمان بوت و دلیل بوت جمع آوری می کند.
برمی گرداند | |
---|---|
| نقشه زمان راهاندازی (زمان UTC در ثانیه از زمان Epoch) و دلیل راهاندازی |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getBootHistorySince
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
روش Helper نقشه تاریخچه راهاندازی را با زمان بوت و دلیل راهاندازی از زمان معین از دوره زمانی از دستگاه و واحد زمانی مشخص شده جمعآوری میکند. دستگاه فعلی utcEpochTime در میلی ثانیه را می توان با روش getDeviceDate()
بدست آورد.
پارامترها | |
---|---|
utcEpochTime | long : زمان دستگاه از زمان. |
timeUnit | TimeUnit : واحد زمان TimeUnit . |
برمی گرداند | |
---|---|
| نقشه زمان راهاندازی (زمان UTC در ثانیه از زمان Epoch) و دلیل راهاندازی |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
روش راحت برای دریافت نسخه بوت لودر این دستگاه.
سعی خواهد کرد نسخه بوت لودر را از وضعیت فعلی دستگاه بازیابی کند. (یعنی اگر دستگاه در حالت فست بوت باشد، سعی می کند نسخه را از فست بوت بازیابی کند)
برمی گرداند | |
---|---|
String | نسخه بوت لودر String یا در صورتی که پیدا نشد null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
گزارش اشکال را از دستگاه بازیابی می کند.
اجرای این برای ادامه کار بر روی دستگاهی بدون sdcard (یا جایی که sdcard هنوز نصب نشده است) تضمین شده است.
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource که محتویات گزارش اشکال را در صورت تقاضا تولید می کند. در صورت خرابی، InputStreamSource یک ERROR(/InputStream) خالی تولید می کند. |
getBugreportz
public InputStreamSource getBugreportz ()
یک bugreportz را از دستگاه بازیابی می کند. اشکال گزارش فرمت زیپ حاوی گزارش اشکال اصلی و سایر فایلهای گزارش است که برای اشکالزدایی مفید هستند.
فقط برای «نسخه adb» > 1.0.36 پشتیبانی می شود
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از فایل فشرده حاوی bugreportz، در صورت خرابی، null را برگردانید. |
getBuildAlias
public String getBuildAlias ()
نام مستعار بیلدی که دستگاه در حال حاضر در حال اجرا است را بازیابی کنید.
نام مستعار Build معمولاً یک رشته خواناتر از build id است (معمولاً یک عدد برای ساختهای Nexus). به عنوان مثال، نسخه نهایی اندروید 4.2 دارای بیلد نام مستعار JDQ39 و شناسه ساخت 573038 است.
برمی گرداند | |
---|---|
String | نام مستعار ساخت یا بازگشت به شناسه ساخت در صورتی که بازیابی نشد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public String getBuildFlavor ()
طعم ساخت دستگاه را بازیابی کنید.
برمی گرداند | |
---|---|
String | طعم ساخت یا در صورتی که قابل بازیابی نباشد پوچ است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
بیلدی که دستگاه در حال اجرا است را بازیابی کنید.
برمی گرداند | |
---|---|
String | شناسه ساخت یا IBuildInfo.UNKNOWN_BUILD_ID اگر بازیابی نشد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public String getBuildSigningKeys ()
نوع کلید مورد استفاده برای امضای تصویر دستگاه را برمیگرداند
معمولاً دستگاههای Android ممکن است با کلیدهای آزمایشی (مانند AOSP) یا کلیدهای انتشار (که توسط سازندههای دستگاه کنترل میشوند) امضا شوند.
برمی گرداند | |
---|---|
String | اگر کلید امضا پیدا شد، در غیر این صورت باطل می شود. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
اگر دستگاه اختصاص داده شده باشد، DeviceDescriptor
ذخیره شده را برمیگرداند، در غیر این صورت DeviceDescriptor
فعلی را برمیگرداند.
برمی گرداند | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
اگر دستگاه اختصاص داده شده باشد، DeviceDescriptor
ذخیره شده را برمیگرداند، در غیر این صورت DeviceDescriptor
فعلی را برمیگرداند.
پارامترها | |
---|---|
shortDescriptor | boolean : اینکه آیا توصیفگر را به حداقل اطلاعات محدود کند یا نه |
برمی گرداند | |
---|---|
DeviceDescriptor |
بچه ها بگیر
public String[] getChildren (String path)
جایگزینی برای استفاده از IFileEntry
که گاهی اوقات به دلیل مجوزها کار نمی کند.
پارامترها | |
---|---|
path | String : مسیری است که در دستگاه باید جستجو را انجام داد |
برمی گرداند | |
---|---|
String[] | آرایه ای از رشته حاوی تمام فایل در یک مسیر در دستگاه. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
اتصال فعلی مرتبط با دستگاه.
برمی گرداند | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
ContentProviderHandler
را برمی گرداند یا اگر در دسترس نباشد، آن را خالی می کند.
اگر ارائهدهنده محتوا قبلاً با همان userId
ساخته شده باشد، میتوان دوباره از آن استفاده کرد.
پارامترها | |
---|---|
userId | int : شناسه کاربری برای مقداردهی اولیه ارائه دهنده محتوا. |
برمی گرداند | |
---|---|
ContentProviderHandler |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
وضعیت تاشو فعلی دستگاه را برمیگرداند یا در صورت بروز برخی مشکلات، آن را خالی میکند.
برمی گرداند | |
---|---|
DeviceFoldableState |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
شناسه کاربر فعلی را برگردانید. در صورت بروز خطا 10000- را برگردانید.
برمی گرداند | |
---|---|
int |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
کلاس دستگاه را دریافت کنید.
برمی گرداند | |
---|---|
String | کلاس دستگاه String |
getDeviceDate
public long getDeviceDate ()
تاریخ دستگاه را بر حسب میلیثانیه از آن دوره برگردانید.
برمی گرداند | |
---|---|
long | تاریخ دستگاه در قالب دوره ای. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
یک DeviceDescriptor
از اطلاعات دستگاه برگردانید تا اطلاعات مربوط به آن را بدون عبور از شی دستگاه واقعی دریافت کنید.
برمی گرداند | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
یک DeviceDescriptor
از اطلاعات دستگاه برگردانید تا اطلاعات مربوط به آن را بدون عبور از شی دستگاه واقعی دریافت کنید.
پارامترها | |
---|---|
shortDescriptor | boolean : اینکه آیا توصیفگر را به حداقل اطلاعات محدود کند یا نه |
برمی گرداند | |
---|---|
DeviceDescriptor |
getDeviceState
public TestDeviceState getDeviceState ()
وضعیت دستگاه را دریافت کنید.
برمی گرداند | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
کمک کننده برای دریافت تفاوت زمانی بین دستگاه و یک ERROR(/Date)
داده شده. از زمان Epoch به صورت داخلی استفاده کنید.
پارامترها | |
---|---|
date | Date |
برمی گرداند | |
---|---|
long | تفاوت در میلی ثانیه |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
جریان شبیه ساز stdout و stderr را دریافت کنید
برمی گرداند | |
---|---|
InputStreamSource | خروجی شبیه ساز |
getEmulatorProcess
public Process getEmulatorProcess ()
Process
مربوط به این شبیه ساز را برگردانید.
برمی گرداند | |
---|---|
Process | Process یا null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
گزارشی که شامل تمام گزارشهای executeShellCommand(String)
است.
برمی گرداند | |
---|---|
File |
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
روش کمکی برای تعیین میزان فضای خالی در حافظه خارجی دستگاه.
برمی گرداند | |
---|---|
long | مقدار فضای خالی در کیلوبایت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
مسیر باینری fastboot مورد استفاده را برمی گرداند. هنوز هم نیاز دارد که isFastbootEnabled()
درست باشد، تا توابع fastboot فعال باشند.
برمی گرداند | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
روشی راحت برای دریافت نوع محصول این دستگاه در حالت فست بوت.
این روش فقط در صورتی باید استفاده شود که دستگاه باید در فست بوت باشد. در این مورد، نوع آن کمی ایمنتر از متد getProductType()
عمومی است، زیرا ITestDevice میداند که اگر دستگاه در وضعیت نادرست باشد یا پاسخگو نباشد، دستگاه را در فستبوت بازیابی کند.
برمی گرداند | |
---|---|
String | نام نوع محصول String یا اگر قابل تعیین نباشد، null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getFastbootProductVariant
public String getFastbootProductVariant ()
روشی راحت برای دریافت نوع محصول این دستگاه در حالت فست بوت.
این روش فقط در صورتی باید استفاده شود که دستگاه باید در فست بوت باشد. در این مورد، نوع آن کمی ایمنتر از متد getProductType()
عمومی است، زیرا ITestDevice میداند که اگر دستگاه در وضعیت نادرست باشد یا پاسخگو نباشد، دستگاه را در فستبوت بازیابی کند.
برمی گرداند | |
---|---|
String | نام نوع محصول String یا اگر قابل تعیین نباشد، null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
شماره سریال حالت fastboot را برمی گرداند.
برمی گرداند | |
---|---|
String |
getFastbootVariable
public String getFastbootVariable (String variableName)
مقدار متغیر fastboot داده شده را از دستگاه بازیابی کنید.
پارامترها | |
---|---|
variableName | String : نام متغیر |
برمی گرداند | |
---|---|
String | مقدار خاصیت یا در صورت عدم وجود آن null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
رشته نسخه باینری fastboot مورد استفاده را برمی گرداند. یا اگر مشکلی پیش بیاید باطل می شود.
برمی گرداند | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
یک مرجع به یک فایل راه دور در دستگاه را بازیابی کنید.
پارامترها | |
---|---|
path | String : مسیر فایل برای بازیابی. می تواند یک مسیر یا مسیر مطلق نسبت به '/' باشد. (یعنی هر دو دستور "/system" و "system" پشتیبانی می شوند) |
برمی گرداند | |
---|---|
IFileEntry | IFileEntry یا null اگر فایل در path داده شده یافت نشد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
کمک کننده غیر رسمی برای دریافت FileEntry
از مسیر غیر ریشه. FIXME: سیستم FileEntry را مجدداً فاکتور کنید تا از هر مسیری در دسترس باشد. (حتی غیر ریشه).
پارامترها | |
---|---|
entry | FileListingService.FileEntry : یک FileEntry لزوماً آنطور که Ddmlib نیاز دارد روت نمی کند. |
برمی گرداند | |
---|---|
IFileEntry | یک FileEntryWrapper که نمایانگر FileEntry است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
لیست حالت های تاشو را در دستگاه برمی گرداند. می توان با "cmd device_state print-states" به دست آورد.
برمی گرداند | |
---|---|
|
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
یک ارجاع به IDevice
ddmlib مرتبط را برمیگرداند.
هر بار که دستگاه از adb جدا می شود و مجدداً وصل می شود، ممکن است یک IDevice
جدید توسط DDMS اختصاص داده شود. بنابراین تماس گیرندگان نباید یک مرجع به IDevice
نگه دارند، زیرا ممکن است آن مرجع قدیمی شود.
برمی گرداند | |
---|---|
IDevice | IDevice |
getInstalledPackageNames
publicgetInstalledPackageNames ()
نام بسته های برنامه موجود در دستگاه را واکشی کنید.
برمی گرداند | |
---|---|
| ERROR(/Set) نامهای بسته String که در حال حاضر روی دستگاه نصب شدهاند. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
مقدار صحیح ویژگی داده شده را از دستگاه برمیگرداند.
پارامترها | |
---|---|
name | String : نام ملک |
defaultValue | long : مقدار پیش فرض برای بازگشت در صورت خالی بودن یا نبودن ویژگی. |
برمی گرداند | |
---|---|
long | اگر ویژگی خالی باشد، وجود نداشته باشد یا مقدار صحیح نداشته باشد، مقدار ویژگی یا defaultValue . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getIpAddress
public String getIpAddress ()
آدرس IP دستگاه را دریافت می کند.
برمی گرداند | |
---|---|
String | آدرس IP دستگاه، یا اگر دستگاه آدرس IP نداشته باشد، null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید.
برمی گرداند | |
---|---|
KeyguardControllerState | یک KeyguardControllerState که حاوی یک عکس فوری از وضعیت نگهدارنده کلید است و در صورت عدم پشتیبانی از پرس و جوی Keyguard، Null را برمی گرداند. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public long getLastExpectedRebootTimeMillis ()
آخرین باری را که APIهای Tradefed راهاندازی مجدد را در میلیثانیه از زمان EPOCH راهاندازی کردند، برمیگرداند که توسط System.currentTimeMillis()
بازگردانده شده است.
برمی گرداند | |
---|---|
long |
getLaunchApiLevel
public int getLaunchApiLevel ()
اولین سطح API راه اندازی شده دستگاه را دریافت کنید. پیشفرض UNKNOWN_API_LEVEL
است.
برمی گرداند | |
---|---|
int | یک عدد صحیح که نشان دهنده اولین سطح API راه اندازی شده دستگاه است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
یک جریان عکس فوری از داده های logcat را می گیرد.
در دو حالت کار می کند:
TestDeviceOptions.getMaxLogcatDataSize()
از محتویات فعلی ضبط logcat پسزمینه برمیگردد.برمی گرداند | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
یک جریان عکس فوری از آخرین maxBytes
داده logcat گرفته شده را می گیرد.
برای مواردی مفید است که میخواهید عکسهای فوری مکرری از دادههای logcat گرفتهشده بگیرید، بدون اینکه جریمه فضای دیسک بالقوه بزرگی برای گرفتن کل عکس فوری getLogcat()
متحمل شوید.
پارامترها | |
---|---|
maxBytes | int : حداکثر مقدار داده برای بازگشت. باید مقداری باشد که به راحتی در حافظه جا شود |
برمی گرداند | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
یک روگرفت از logcat فعلی برای دستگاه دریافت کنید. برخلاف getLogcat()
، این متد همیشه یک dump ایستا از logcat را برمی گرداند.
این عیب را دارد که اگر دستگاه در دسترس نباشد، هیچ چیز برگردانده نخواهد شد.
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از داده های logcat. اگر نتواند داده های logcat را بگیرد، یک جریان خالی برگردانده می شود. |
getLogcatSince
public InputStreamSource getLogcatSince (long date)
یک جریان عکس فوری از دادههای logcat گرفته شده را با شروع تاریخ ارائه شده میگیرد. زمان روی دستگاه باید از getDeviceDate()
استفاده شود.
پارامترها | |
---|---|
date | long : در قالب میلی ثانیه از زمان شروع عکس فوری تا زمان حال. (با استفاده از "تاریخ +%s" قابل دریافت است) |
برمی گرداند | |
---|---|
InputStreamSource |
دریافت مک آدرس
public String getMacAddress ()
آدرس MAC دستگاه را برمیگرداند، در صورت عدم درخواست از دستگاه، باطل میشود.
برمی گرداند | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
شناسه اصلی کاربر را برمی گرداند.
برمی گرداند | |
---|---|
Integer | شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد null. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید.
برمی گرداند | |
---|---|
| ERROR(/Set) ماژول های خط اصلی String که در حال حاضر روی دستگاه نصب شده اند. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید. پیش فرض 0 است.
برمی گرداند | |
---|---|
int | یک عدد صحیح که تعداد کاربرانی که به طور همزمان در حال اجرا هستند را نشان می دهد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. پیش فرض 0 است.
برمی گرداند | |
---|---|
int | یک عدد صحیح که تعداد کاربران پشتیبانی شده را نشان می دهد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
برمی گرداند | |
---|---|
Process | فرآیند Microdroid VM را برمیگرداند. اگر TestDevice یک Microdroid نباشد، null را برمیگرداند. |
getMonitor
public IDeviceStateMonitor getMonitor ()
IDeviceStateMonitor
مرتبط با دستگاه را برگردانید.
برمی گرداند | |
---|---|
IDeviceStateMonitor |
getMountPoint
public String getMountPoint (String mountName)
نقطه اتصال را برمیگرداند.
اگر اطلاعات ذخیرهشده در IDevice
در دسترس نباشد، مستقیماً از دستگاه سؤال میکند.
TODO: این رفتار را به IDevice.getMountPoint(String)
منتقل کنید
پارامترها | |
---|---|
mountName | String : نام نقطه نصب |
برمی گرداند | |
---|---|
String | نقطه نصب یا null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
MountPointInfo
مربوط به مسیر mountpoint مشخص شده را برمیگرداند، یا اگر آن مسیر چیزی نصب نشده باشد یا بهطور دیگری در /proc/mounts بهعنوان یک نقطه mount ظاهر نشود، null
را برمیگرداند.
پارامترها | |
---|---|
mountpoint | String |
برمی گرداند | |
---|---|
ITestDevice.MountPointInfo | ERROR(/List) MountPointInfo حاوی اطلاعات در "/proc/mounts" |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
یک نسخه تجزیه شده از اطلاعات موجود در /proc/mounts در دستگاه را برمی گرداند
برمی گرداند | |
---|---|
| ERROR(/List) MountPointInfo حاوی اطلاعات در "/proc/mounts" |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getOptions
public TestDeviceOptions getOptions ()
گزینه های تست دستگاه را واکشی کنید.
برمی گرداند | |
---|---|
TestDeviceOptions | TestDeviceOptions مربوط به دستگاه تحت آزمایش. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
روش کمکی برای تعیین مقدار فضای خالی در پارتیشن دستگاه.
پارامترها | |
---|---|
partition | String |
برمی گرداند | |
---|---|
long | مقدار فضای خالی در کیلوبایت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId
public Integer getPrimaryUserId ()
شناسه کاربر اصلی را برمی گرداند.
برمی گرداند | |
---|---|
Integer | شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد، null. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
متد Helper دستور "pidof" و "stat" را اجرا می کند و شی ProcessInfo
با PID و زمان شروع فرآیند پردازش داده شده برمی گرداند.
پارامترها | |
---|---|
processName | String : نام فرآیند String. |
برمی گرداند | |
---|---|
ProcessInfo | ProcessInfo مربوط به processName داده شده |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
اگر مشکلی پیش آمده باشد، پید سرویس را برمیگرداند یا نول میکند.
پارامترها | |
---|---|
process | String : نام فرآیند String. |
برمی گرداند | |
---|---|
String |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
روش راحت برای دریافت نوع محصول این دستگاه.
اگر دستگاه در حالت adb یا fastboot باشد، این روش کار خواهد کرد.
برمی گرداند | |
---|---|
String | نام نوع محصول String پوچ نخواهد بود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
روش راحت برای دریافت نوع محصول این دستگاه.
اگر دستگاه در حالت adb یا fastboot باشد، این روش کار خواهد کرد.
برمی گرداند | |
---|---|
String | نام نوع محصول String یا اگر قابل تعیین نباشد، null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
مقدار مشخصه داده شده را از دستگاه بازیابی کنید.
پارامترها | |
---|---|
name | String : نام ملک |
برمی گرداند | |
---|---|
String | مقدار خاصیت یا در صورت عدم وجود آن null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
حالت بازیابی فعلی مورد استفاده برای دستگاه را دریافت کنید.
برمی گرداند | |
---|---|
ITestDevice.RecoveryMode | حالت بازیابی فعلی مورد استفاده برای دستگاه. |
دریافت اسکرین شات
public InputStreamSource getScreenshot (long displayId)
یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد. فرمت PNG است.
TODO: پیاده سازی های بالا را برای پشتیبانی از "قالب" و "مقیاس مجدد" گسترش دهید
پارامترها | |
---|---|
displayId | long : شناسه نمایش صفحه برای گرفتن اسکرین شات از آن. |
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دریافت اسکرین شات
public InputStreamSource getScreenshot (String format)
یک اسکرین شات از دستگاه می گیرد. توصیه می شود برای اندازه کوچکتر از getScreenshot (فرمت) به جای کدگذاری JPEG استفاده کنید
پارامترها | |
---|---|
format | String : پشتیبانی از PNG، JPEG |
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دریافت اسکرین شات
public InputStreamSource getScreenshot (String format, boolean rescale)
یک اسکرین شات از دستگاه می گیرد. توصیه می شود به جای آن از getScreenshot(String)
با رمزگذاری JPEG برای اندازه کوچکتر استفاده کنید.
پارامترها | |
---|---|
format | String : پشتیبانی از PNG، JPEG |
rescale | boolean : اگر اسکرین شات باید تغییر مقیاس داده شود تا اندازه تصویر حاصل کاهش یابد |
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دریافت اسکرین شات
public InputStreamSource getScreenshot ()
یک اسکرین شات از دستگاه می گیرد.
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از اسکرین شات با فرمت png یا در صورت عدم موفقیت اسکرین شات null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
دریافت شماره سریال
public String getSerialNumber ()
روش آسان برای دریافت شماره سریال این دستگاه.
برمی گرداند | |
---|---|
String | شماره سریال String |
getSetting
public String getSetting (int userId, String namespace, String key)
مقدار تنظیمات درخواستی را برگردانید. فضای نام باید یکی از موارد زیر باشد: {"system", "secure", "global"}
پارامترها | |
---|---|
userId | int |
namespace | String |
key | String |
برمی گرداند | |
---|---|
String | مقدار مربوط به فضای نام: کلید یک کاربر. اگر پیدا نشد، پوچ است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getSetting
public String getSetting (String namespace, String key)
getSetting(int, String, String)
ببینید و روی کاربر سیستم انجام شود.
پارامترها | |
---|---|
namespace | String |
key | String |
برمی گرداند | |
---|---|
String |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
اپراتور سیم کارت را برگردانید یا اگر در دسترس نیست یا دستگاه در دسترس نیست، آن را خالی کنید.
برمی گرداند | |
---|---|
String |
getSimState
public String getSimState ()
وضعیت سیم کارت را برگردانید یا اگر در دسترس نیست یا دستگاه در دسترس نیست، آن را خالی کنید.
برمی گرداند | |
---|---|
String |
گرفتن سنگ قبر
publicgetTombstones ()
لیست سنگ قبرها را از دستگاه ها واکشی و برگردانید. نیاز به روت دارد.
روش بهترین تلاش است، بنابراین اگر یک سنگ قبر به هر دلیلی کشیده نشود، در لیست گم می شود. فقط یک DeviceNotAvailableException
این روش را زودتر خاتمه می دهد.
برمی گرداند | |
---|---|
| لیستی از فایل های سنگ قبر، در صورت عدم وجود سنگ قبر خالی. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
حجم کل حافظه فیزیکی را بر حسب بایت یا -1 را در صورت خطای داخلی برمی گرداند
برمی گرداند | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
برای مدیریت دستگاه، سریال را برای ردیابی دستگاه استفاده کنید.
برمی گرداند | |
---|---|
String |
getUninstalablePackageNames
publicgetUninstallablePackageNames ()
نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید. این در حال حاضر به عنوان بسته های غیر سیستمی و بسته های سیستمی به روز شده تعریف می شود.
برمی گرداند | |
---|---|
| ERROR(/Set) نامهای بسته String غیرقابل نصب که در حال حاضر روی دستگاه نصب شدهاند. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getUseFastbootErase
public boolean getUseFastbootErase ()
برای پاک کردن پارتیشن روی دستگاه از فرمت fastboot erase یا fastboot استفاده کنید.
برمی گرداند | |
---|---|
boolean | true اگر از fastboot erase استفاده شود یا false اگر از فرمت fastboot استفاده شود. |
getUserFlags
public int getUserFlags (int userId)
پرچم های یک کاربر معین را پیدا کرده و برگردانید. پرچمها در کلاس «android.content.pm.UserInfo» در پروژه منبع باز Android تعریف شدهاند.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
int | پرچم های مرتبط با userId ارائه شده در صورت یافتن، -10000 در هر مورد دیگر. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getUserInfos
publicgetUserInfos ()
نقشه useId به UserInfo
را در دستگاه دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException
پرتاب می کند.
برمی گرداند | |
---|---|
| لیست اشیاء UserInfo |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
در صورت یافتن شماره سریال مرتبط به userId، در هر مورد دیگر -10000 را برگردانید.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
int |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
handleAlocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
DeviceEvent داده شده را پردازش کنید. ممکن است دستگاه به حالت جدید انتقال یابد. IDeviceMonitor
از هرگونه انتقال وضعیت مطلع می کند.
DeviceEvent را پردازش کنید، که ممکن است این دستگاه را به وضعیت تخصیص جدید منتقل کند یا نکند.
پارامترها | |
---|---|
event | DeviceEvent |
برمی گرداند | |
---|---|
IManagedTestDevice.DeviceEventResponse |
دارای ویژگی
public boolean hasFeature (String feature)
بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر.
پارامترها | |
---|---|
feature | String : کدام فرمت باید «feature: |
برمی گرداند | |
---|---|
boolean | اگر ویژگی پیدا شود درست است، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
بسته اندروید را روی دستگاه نصب کنید.
پارامترها | |
---|---|
packageFile | File : فایل apk برای نصب |
reinstall | boolean : true اگر نصب مجدد انجام شود |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
بسته اندروید را روی دستگاه نصب کنید.
توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.
پارامترها | |
---|---|
packageFile | File : فایل apk برای نصب |
reinstall | boolean : true اگر نصب مجدد انجام شود |
grantPermissions | boolean : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.
پارامترها | |
---|---|
packageFile | File : فایل apk برای نصب |
reinstall | boolean : true اگر نصب مجدد انجام شود |
userId | int : شناسه کاربری عدد صحیح برای نصب. |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.
توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.
پارامترها | |
---|---|
packageFile | File : فایل apk برای نصب |
reinstall | boolean : true اگر نصب مجدد انجام شود |
grantPermissions | boolean : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند |
userId | int : شناسه کاربری عدد صحیح برای نصب. |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbRoot است
public boolean isAdbRoot ()
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isAdbTcp
public boolean isAdbTcp ()
برمی گرداند | |
---|---|
boolean |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
بررسی کنید که آیا پلتفرم روی دستگاه از شمارش برنامه پشتیبانی میکند یا خیر
برمی گرداند | |
---|---|
boolean | اگر شمارش برنامه پشتیبانی شود درست است، در غیر این صورت نادرست است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
بررسی کنید که آیا پلتفرم روی دستگاه از دور زدن بلوک sdk هدف پایین در نصب برنامه پشتیبانی میکند یا خیر
برمی گرداند | |
---|---|
boolean | درست است اگر بلوک sdk با هدف پایین دور زدن پشتیبانی شود، در غیر این صورت نادرست است |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted است
public boolean isDebugfsMounted ()
بررسی کنید که آیا debugfs نصب شده است یا خیر.
برمی گرداند | |
---|---|
boolean | true اگر اشکال زدایی نصب شده باشد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public boolean isDeviceEncrypted ()
اگر دستگاه رمزگذاری شده باشد برمی گردد.
برمی گرداند | |
---|---|
boolean | اگر دستگاه رمزگذاری شده باشد true . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isDirectory
public boolean isDirectory (String path)
اگر مسیر روی دستگاه یک دایرکتوری است، True را برگردانید، در غیر این صورت false.
پارامترها | |
---|---|
path | String |
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot است
public boolean isEnableAdbRoot ()
برمی گرداند | |
---|---|
boolean | true اگر ریشه adb باید در دستگاه فعال باشد |
isEncryptionSupported
public boolean isEncryptionSupported ()
اگر رمزگذاری در دستگاه پشتیبانی شود، برمیگردد.
برمی گرداند | |
---|---|
boolean | true اگر دستگاه از رمزگذاری پشتیبانی کند. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
قابل اجرا است
public boolean isExecutable (String fullPath)
اگر مسیر فایل روی دستگاه یک فایل اجرایی باشد، True را برمیگرداند، در غیر این صورت false است.
پارامترها | |
---|---|
fullPath | String |
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled است
public boolean isFastbootEnabled ()
اگر فست بوت برای دستگاه موجود است، برگردید.
برمی گرداند | |
---|---|
boolean |
بی سر است
public boolean isHeadless ()
اگر دستگاه بدون هد است (بدون صفحه) true را برگردانید، در غیر این صورت false.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
نشان می دهد که آیا کاربر اصلی یک سرپرست دائمی است و نمی توان آن را حذف کرد یا به وضعیت غیر سرپرست تنزل داد.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isMultiUserSupported
public boolean isMultiUserSupported ()
تعیین می کند که آیا چند کاربر پشتیبانی می شود یا خیر.
برمی گرداند | |
---|---|
boolean | درست است اگر چند کاربر پشتیبانی می شود، نادرست در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isPackageInstalled است
public boolean isPackageInstalled (String packageName, String userId)
دستگاه را برای نام بسته معین و شناسه کاربری داده شده جستجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر.
پارامترها | |
---|---|
packageName | String : بسته ای که ما در حال بررسی آن هستیم که آیا نصب شده است. |
userId | String : شناسه کاربری که بسته را بررسی می کنیم برای آن نصب شده است. اگر null باشد، از کاربر اصلی صفر استفاده می شود. |
برمی گرداند | |
---|---|
boolean | درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isPackageInstalled است
public boolean isPackageInstalled (String packageName)
دستگاه را برای یک نام بسته جستجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.
پارامترها | |
---|---|
packageName | String |
برمی گرداند | |
---|---|
boolean | درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported است
public boolean isRuntimePermissionSupported ()
بررسی کنید که آیا پلتفرم روی دستگاه از اعطای مجوز زمان اجرا پشتیبانی می کند یا خیر
برمی گرداند | |
---|---|
boolean | اگر مجوز زمان اجرا پشتیبانی شود درست است، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
اگر دستگاه در TestDeviceState.FASTBOOT
یا TestDeviceState.FASTBOOTD
باشد، درست برمی گردد.
برمی گرداند | |
---|---|
boolean |
isUserRunning
public boolean isUserRunning (int userId)
بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
boolean | اگر کاربر در حال اجرا باشد درست است، در سایر موارد نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isUserSecondary
public boolean isUserSecondary (int userId)
آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر ثانویه باشد، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isUserVisible
public boolean isUserVisible (int userId)
بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر.
کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت ها را راه اندازی کند (معمولاً در صفحه نمایش پیش فرض).
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر.
کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت های خود را در آن نمایشگر راه اندازی کند.
پارامترها | |
---|---|
userId | int |
displayId | int |
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
نشان میدهد که آیا دستگاه به کاربران اجازه میدهد در پسزمینه در ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
قابل مشاهده باشند یا خیر.
اگر اینطور است، میتوانید startVisibleBackgroundUser(int, int, boolean)
فراخوانی کنید و نمایشگری را ارسال کنید که توسط listDisplayIdsForStartingVisibleBackgroundUsers()
(که باید شامل ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
باشد).
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
نشان می دهد که آیا دستگاه به کاربران اجازه می دهد در پس زمینه قابل مشاهده باشند یا خیر.
اگر اینطور است، می توانید startVisibleBackgroundUser(int, int, boolean)
فراخوانی کنید و نمایشگری را که توسط listDisplayIdsForStartingVisibleBackgroundUsers()
برگردانده شده است، ارسال کنید.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isWifiEnabled است
public boolean isWifiEnabled ()
تست کنید آیا وای فای فعال است یا خیر.
بررسی می کند که آیا وای فای در دستگاه فعال است یا خیر. برای اثبات وضعیت وای فای قبل از آزمایش هایی که نباید با وای فای اجرا شوند مفید است، به عنوان مثال آزمایش های داده تلفن همراه.
برمی گرداند | |
---|---|
boolean | true اگر وای فای فعال باشد. false در صورت غیرفعال بودن |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید.
برمی گرداند | |
---|---|
| لیست نمایشگرها پیش فرض همیشه نمایشگر پیش فرض 0 را برمی گرداند. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
لیستی از نمایشگرهایی را دریافت می کند که می توانند برای start a user visible in the background
استفاده شوند.
برمی گرداند | |
---|---|
|
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
لیست کاربران
publiclistUsers ()
لیست کاربران دستگاه را دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException
پرتاب می کند.
برمی گرداند | |
---|---|
| لیست شناسه های کاربر |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
logAnrs
public boolean logAnrs (ITestLogger logger)
ANR ها را از دستگاه جمع آوری و ثبت می کند.
پارامترها | |
---|---|
logger | ITestLogger : یک ITestLogger برای ثبت ANR ها. |
برمی گرداند | |
---|---|
boolean | اگر ثبت با موفقیت انجام شد درست است، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
گزارش logBugreport
public boolean logBugreport (String dataName, ITestLogger listener)
روش کمکی برای گرفتن گزارش اشکال و ورود آن به خبرنگاران.
پارامترها | |
---|---|
dataName | String : نامی که گزارش اشکال تحت آن گزارش می شود. |
listener | ITestLogger : یک ITestLogger برای ثبت گزارش اشکال. |
برمی گرداند | |
---|---|
boolean | اگر ثبت با موفقیت انجام شد درست است، در غیر این صورت نادرست است. |
logOnDevice
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
یک پیام را در logcat دستگاه ثبت کنید. این یک تماس ایمن است که حتی اگر ورود به سیستم با شکست مواجه شود، پرتاب نمی شود.
پارامترها | |
---|---|
tag | String : برچسبی که تحت آن پیام خود را در logcat ثبت می کنیم. |
level | Log.LogLevel : سطح اشکال زدایی پیام در logcat. |
format | String : قالب پیام. |
args | Object : آرگ هایی که باید از طریق String.format() جایگزین شوند. |
mountDebugfs
public void mountDebugfs ()
اشکال زدایی را سوار کنید.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
nonBlockingReboot
public void nonBlockingReboot ()
دستوری را برای راه اندازی مجدد دستگاه صادر می کند و با فرمان کامل و زمانی که دستگاه دیگر برای adb قابل مشاهده نیست، برمی گردد.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
اگر دستگاه نیاز به انجام برخی اقدامات خاص بعد از ریشه adb و قبل از اینکه دستگاه دوباره آنلاین شود، لغو شود. اجرای پیشفرض شامل هیچ اقدام اضافی نمیشود. ریشه adb در این مرحله تضمین نمی شود که فعال شود.
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
اگر دستگاه نیاز به انجام برخی اقدامات خاص پس از unroot adb و قبل از اینکه دستگاه دوباره آنلاین شود، لغو شود. اجرای پیشفرض شامل هیچ اقدام اضافی نمیشود. غیرفعال شدن ریشه adb در این مرحله تضمینی نیست.
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public void postBootSetup ()
دستورالعملهایی را برای پیکربندی دستگاه برای آزمایش آن پس از هر بار بوت انجام دهید.
باید پس از راهاندازی کامل/در دسترس بودن دستگاه فراخوانی شود
در شرایط عادی این روش نیازی به فراخوانی صریح ندارد، زیرا پیادهسازیها باید این مراحل را بهطور خودکار هنگام اجرای راهاندازی مجدد انجام دهند.
جایی که ممکن است نیاز به فراخوانی داشته باشد، زمانی است که دستگاه به دلیل رویدادهای دیگر راه اندازی مجدد می شود (مثلاً زمانی که فرمان به روز رسانی فست بوت کامل شده است)
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
مراحل اضافی برای پاکسازی مورد نیاز خاص دستگاه که پس از انجام فراخوانی اجرا می شود.
پارامترها | |
---|---|
exception | Throwable : در صورت وجود، آخرین استثنا ناشی از شکست فراخوانی. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
مراحل اضافی برای تنظیم مورد نیاز خاص دستگاه که قبل از جریان فراخوانی روی دستگاه اجرا می شود.
پارامترها | |
---|---|
info | IBuildInfo : IBuildInfo دستگاه. |
attributes | MultiMap : ویژگی هایی که در زمینه فراخوانی ذخیره می شوند |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
pullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
به صورت بازگشتی محتویات دایرکتوری را از دستگاه بکشید.
پارامترها | |
---|---|
deviceFilePath | String : مسیر فایل مطلق منبع راه دور |
localDir | File : فهرست محلی برای کشیدن فایلها در آن |
userId | int : شناسه کاربری که باید از آن خارج شود |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت کشیده شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pullDir
public boolean pullDir (String deviceFilePath, File localDir)
به صورت بازگشتی محتویات دایرکتوری را از دستگاه بکشید.
پارامترها | |
---|---|
deviceFilePath | String : مسیر فایل مطلق منبع راه دور |
localDir | File : فهرست محلی برای کشیدن فایلها در آن |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت کشیده شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile)
یک فایل را از دستگاه بازیابی می کند.
پارامترها | |
---|---|
remoteFilePath | String : مسیر مطلق فایل در دستگاه. |
localFile | File : فایل محلی برای ذخیره محتویات. اگر خالی نباشد، محتویات جایگزین خواهند شد. |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت بازیابی شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath, int userId)
یک فایل را از دستگاه بازیابی می کند، آن را در یک ERROR(/File)
موقت محلی ذخیره می کند و آن File
برمی گرداند.
پارامترها | |
---|---|
remoteFilePath | String : مسیر مطلق فایل در دستگاه. |
userId | int : شناسه کاربری که باید از آن خارج شود |
برمی گرداند | |
---|---|
File | یک ERROR(/File) حاوی محتویات فایل دستگاه، یا در صورت عدم موفقیت کپی به هر دلیلی (از جمله مشکلات سیستم فایل میزبان) null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
یک فایل را از دستگاه بازیابی می کند، آن را در یک ERROR(/File)
موقت محلی ذخیره می کند و آن File
برمی گرداند.
پارامترها | |
---|---|
remoteFilePath | String : مسیر مطلق فایل در دستگاه. |
برمی گرداند | |
---|---|
File | یک ERROR(/File) حاوی محتویات فایل دستگاه، یا در صورت عدم موفقیت کپی به هر دلیلی (از جمله مشکلات سیستم فایل میزبان) null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pullFile
public boolean pullFile (String remoteFilePath, File localFile, int userId)
یک فایل را از دستگاه بازیابی می کند.
پارامترها | |
---|---|
remoteFilePath | String : مسیر مطلق فایل در دستگاه. |
localFile | File : فایل محلی برای ذخیره محتویات. اگر خالی نباشد، محتویات جایگزین خواهند شد. |
userId | int : شناسه کاربری که باید از آن خارج شود |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت بازیابی شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
یک فایل را از دستگاه بازیابی می کند و محتویات را برمی گرداند.
پارامترها | |
---|---|
remoteFilePath | String : مسیر مطلق فایل در دستگاه. |
برمی گرداند | |
---|---|
String | String ای که حاوی محتویات فایل دستگاه است، یا اگر به هر دلیلی کپی نشد (از جمله مشکلات سیستم فایل میزبان) null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
یک روش راحت برای بازیابی یک فایل از حافظه خارجی دستگاه، ذخیره آن در یک ERROR(/File)
موقت محلی و بازگشت یک مرجع به آن File
.
پارامترها | |
---|---|
remoteFilePath | String : مسیر فایل روی دستگاه، نسبت به نقطه نصب حافظه خارجی دستگاه |
برمی گرداند | |
---|---|
File | یک ERROR(/File) حاوی محتویات فایل دستگاه، یا در صورت عدم موفقیت کپی به هر دلیلی (از جمله مشکلات سیستم فایل میزبان) null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید در حالی که برخی دایرکتوری ها را که فیلتر شده اند حذف کنید.
پارامترها | |
---|---|
localFileDir | File : دایرکتوری محلی برای فشار دادن |
deviceFilePath | String : مسیر فایل مطلق مقصد راه دور |
excludedDirectories | : مجموعه ای از نام دایرکتوری های حذف شده که نباید فشار داده شوند. |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت فشار داده شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید.
پارامترها | |
---|---|
localFileDir | File : دایرکتوری محلی برای فشار دادن |
deviceFilePath | String : مسیر فایل مطلق مقصد راه دور |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت فشار داده شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
به صورت بازگشتی محتویات دایرکتوری را به دستگاه فشار دهید.
پارامترها | |
---|---|
localFileDir | File : دایرکتوری محلی برای فشار دادن |
deviceFilePath | String : مسیر فایل مطلق مقصد راه دور |
userId | int : شناسه کاربری که باید به آن فشار دهید |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت فشار داده شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
گونه ای از pushFile(File, String)
که می تواند به صورت اختیاری ارزیابی نیاز به ارائه دهنده محتوا را در نظر بگیرد.
پارامترها | |
---|---|
localFile | File : فایل محلی برای فشار دادن |
remoteFilePath | String : مسیر فایل مطلق مقصد از راه دور |
evaluateContentProviderNeeded | boolean : بررسی کنیم که آیا به ارائه دهنده محتوا نیاز داریم یا خیر |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت فشار داده شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath)
یک فایل را به دستگاه فشار دهید. به طور پیش فرض با استفاده از یک ارائه دهنده محتوا.
پارامترها | |
---|---|
localFile | File : فایل محلی برای فشار دادن |
remoteFilePath | String : مسیر فایل مطلق مقصد از راه دور |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت فشار داده شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, int userId)
یک فایل را به دستگاه فشار دهید. به طور پیش فرض با استفاده از یک ارائه دهنده محتوا.
پارامترها | |
---|---|
localFile | File : فایل محلی برای فشار دادن |
remoteFilePath | String : مسیر فایل مطلق مقصد از راه دور |
userId | int : شناسه کاربری که باید به آن فشار دهید |
برمی گرداند | |
---|---|
boolean | true اگر فایل با موفقیت فشار داده شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
pushString
public boolean pushString (String contents, String remoteFilePath)
فایل فشار ایجاد شده از رشته ای به دستگاه
پارامترها | |
---|---|
contents | String : محتویات فایل برای فشار دادن |
remoteFilePath | String : مسیر فایل مطلق مقصد از راه دور |
برمی گرداند | |
---|---|
boolean | true اگر رشته با موفقیت فشار داده شود. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
راه اندازی مجدد
public void reboot (String reason)
دستگاه را به حالت adb راهاندازی مجدد میکند و reason
مشخصی برای ادامه راهاندازی مجدد دارد.
مسدود می شود تا زمانی که دستگاه در دسترس قرار گیرد.
آخرین دلیل راه اندازی مجدد را می توان با پرس و جوی sys.boot.reason
propety بدست آورد.
پارامترها | |
---|---|
reason | String : دلیلی برای این راهاندازی مجدد، یا اگر دلیلی مشخص نشده باشد، null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
راه اندازی مجدد
public void reboot ()
دستگاه را به حالت adb راه اندازی مجدد می کند.
مسدود می شود تا زمانی که دستگاه در دسترس قرار گیرد.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
rebootIntoBootloader
public void rebootIntoBootloader ()
دستگاه را به حالت بوت لودر راه اندازی مجدد می کند.
مسدود می شود تا زمانی که دستگاه در حالت بوت لودر قرار گیرد.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
rebootIntoFastbootd
public void rebootIntoFastbootd ()
دستگاه را در حالت فست بوت مجدد راه اندازی می کند.
مسدود می شود تا زمانی که دستگاه در حالت فست بوت قرار گیرد.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
دستگاه را به حالت بازیابی adb راه اندازی مجدد می کند.
مسدود می شود تا زمانی که دستگاه وارد بازیابی شود
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload ()
دستگاه را به حالت adb sideload مجدد راه اندازی می کند (توجه داشته باشید که این یک حالت ویژه در حال بازیابی است)
مسدود می شود تا زمانی که دستگاه وارد حالت بار جانبی شود
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
دستگاه را به حالت adb sideload مجدد راه اندازی می کند (توجه داشته باشید که این یک حالت ویژه در حال بازیابی است)
مسدود می شود تا زمانی که دستگاه وارد حالت بار جانبی شود
پارامترها | |
---|---|
autoReboot | boolean : آیا دستگاه پس از بارگذاری جانبی به طور خودکار راه اندازی مجدد شود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
راه اندازی مجدد تا آنلاین
public void rebootUntilOnline ()
جایگزینی برای reboot()
که فقط تا زمانی که دستگاه آنلاین شود مسدود می شود، یعنی برای adb قابل مشاهده است.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
راه اندازی مجدد تا آنلاین
public void rebootUntilOnline (String reason)
جایگزینی برای reboot()
که فقط تا زمانی که دستگاه آنلاین شود مسدود می شود، یعنی برای adb قابل مشاهده است.
پارامترها | |
---|---|
reason | String : دلیلی برای این راهاندازی مجدد، یا اگر دلیلی مشخص نشده باشد، null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
rebootUserspace
public void rebootUserspace ()
فقط قسمتی از دستگاه را در فضای کاربر راه اندازی مجدد می کند.
مسدود می شود تا زمانی که دستگاه در دسترس قرار گیرد.
هشدار. راه اندازی مجدد فضای کاربری در حال حاضر در حال توسعه فعال است، از آن با مسئولیت خود استفاده کنید.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
جایگزینی برای rebootUserspace()
()} که فقط تا زمانی که دستگاه آنلاین شود مسدود می شود، یعنی برای adb قابل مشاهده است.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
بازیابی دستگاه
public boolean recoverDevice ()
تلاش برای بازیابی ارتباطات دستگاه
برمی گرداند | |
---|---|
boolean | اگر بازیابی انجام شود و موفقیت آمیز باشد درست است، اگر بازیابی نادیده گرفته شود، False را برمیگرداند |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر دستگاه دیگر در دسترس نباشد |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
IDeviceActionReceiver
را برای این دستگاه ثبت می کند.
همه IDeviceActionReceiver
های ثبت شده قبل از شروع یک اقدام دستگاه و پس از پایان عملکرد دستگاه مطلع خواهند شد.
پارامترها | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : یک IDeviceActionReceiver که ثبت خواهد شد. |
remountSystemReadOnly
public void remountSystemReadOnly ()
پارتیشن سیستم را روی دستگاه فقط خواندنی کنید. ممکن است دستگاه را راه اندازی مجدد کند.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
پارتیشن سیستم روی دستگاه را قابل نوشتن کنید. ممکن است دستگاه را راه اندازی مجدد کند.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
پارتیشن فروشنده روی دستگاه را فقط خواندنی کنید. ممکن است دستگاه را راه اندازی مجدد کند.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
remountVendorWritable
public void remountVendorWritable ()
پارتیشن فروشنده روی دستگاه را قابل نوشتن کنید. ممکن است دستگاه را راه اندازی مجدد کند.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
حذف ادمین
public boolean removeAdmin (String componentName, int userId)
ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود true
برگردانید، در غیر این صورت false
.
پارامترها | |
---|---|
componentName | String : مدیر دستگاه که باید حذف شود. |
userId | int : کاربری که سرپرست دستگاه در آن زندگی می کند. |
برمی گرداند | |
---|---|
boolean | اگر موفقیت آمیز باشد درست است، در غیر این صورت نادرست. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
حذف مالکان
public void removeOwners ()
همه دارندگان نمایه دستگاه موجود را با بهترین تلاش حذف کنید.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
removeUser
public boolean removeUser (int userId)
یک کاربر معین را از دستگاه حذف کنید.
پارامترها | |
---|---|
userId | int : کاربر برای حذف |
برمی گرداند | |
---|---|
boolean | درست است اگر در حذف کاربر موفق بودیم، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
پرچم را برای راه اندازی ارائه دهنده محتوا بازنشانی کنید تا دوباره فعال شود.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
روش آسان برای انجام ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
با یک یا چند شنونده به عنوان پارامتر ارسال شده است.
پارامترها | |
---|---|
runner | IRemoteAndroidTestRunner : IRemoteAndroidTestRunner که تست ها را اجرا می کند |
listeners | ITestLifeCycleReceiver : شنونده(های) نتیجه آزمایش |
برمی گرداند | |
---|---|
boolean | true اگر دستور تست تکمیل شود. اگر تکمیل نشد، false ، اما بازیابی با موفقیت انجام شد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
تست های ابزار دقیق را اجرا می کند و بازیابی دستگاه را فراهم می کند.
اگر قبل از اجرای آزمایشی اتصال با دستگاه قطع شود و بازیابی موفقیت آمیز باشد، همه شنوندگان از testRunFailed مطلع می شوند و "false" برگردانده می شود. دستور تست مجددا اجرا نمی شود. این به تماس گیرندگان واگذار می شود که در صورت لزوم دوباره تلاش کنند.
اگر قبل از اجرای آزمایشی اتصال با دستگاه قطع شود، و بازیابی ناموفق باشد، همه شنوندگان از testRunFailed مطلع می شوند و DeviceNotAvailableException پرتاب می شود.
پارامترها | |
---|---|
runner | IRemoteAndroidTestRunner : IRemoteAndroidTestRunner که تست ها را اجرا می کند |
listeners | : شنوندگان نتیجه آزمون |
برمی گرداند | |
---|---|
boolean | true اگر دستور تست تکمیل شود. اگر به دلیل استثنای ارتباط دستگاه تکمیل نشد false ، اما بازیابی با موفقیت انجام شد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
مانند ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
اما تست را برای کاربر مورد نظر اجرا می کند.
پارامترها | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners |
|
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
مانند ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)
اما آزمایش را برای یک کاربر مشخص اجرا می کند.
پارامترها | |
---|---|
runner | IRemoteAndroidTestRunner |
userId | int |
listeners | ITestLifeCycleReceiver |
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
پیکربندی set
public void setConfiguration (IConfiguration configuration)
IConfiguration
در حال استفاده را تزریق می کند.
پارامترها | |
---|---|
configuration | IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
پارامترها | |
---|---|
avdInfo | GceAvdInfo |
setDate
public void setDate (Date date)
تاریخ را روی دستگاه تنظیم می کند
توجه: تنظیم تاریخ در دستگاه نیاز به روت دارد
پارامترها | |
---|---|
date | Date : تاریخ خاصی را مشخص کنید. در صورت null از تاریخ میزبان استفاده خواهد کرد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید.
پارامترها | |
---|---|
componentName | String : مدیر دستگاه که مالک دستگاه باشد. |
userId | int : کاربری که صاحب دستگاه در آن زندگی می کند. |
برمی گرداند | |
---|---|
boolean | اگر موفقیت آمیز باشد درست است، در غیر این صورت نادرست. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
وضعیت دستگاه را به روز کنید.
پارامترها | |
---|---|
deviceState | TestDeviceState : TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
برای شبیه ساز SizeLimitedOutputStream
برای ورود به خروجی تنظیم کنید
پارامترها | |
---|---|
output | SizeLimitedOutputStream : برای ثبت خروجی |
setEmulatorProcess
public void setEmulatorProcess (Process p)
هنگامی که این دستگاه شبیه ساز است، Process
را تنظیم می کند.
پارامترها | |
---|---|
p | Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
گزینه fastboot را برای دستگاه تنظیم کنید. زمانی که دستگاه برای اولین بار تخصیص داده می شود باید تنظیم شود.
پارامترها | |
---|---|
fastbootEnabled | boolean : آیا فست بوت برای دستگاه موجود است یا خیر |
setFastbootPath
public void setFastbootPath (String fastbootPath)
مسیر باینری fastboot را که باید استفاده شود را تعیین می کند. هنوز هم نیاز دارد که isFastbootEnabled()
درست باشد، تا توابع fastboot فعال باشند.
پارامترها | |
---|---|
fastbootPath | String |
setIDevice
public void setIDevice (IDevice newDevice)
IDevice مرتبط با این ITestDevice را به روز کنید.
IDevice جدید باید همان دستگاه فیزیکی مرجع فعلی را ارجاع دهد. این متد در صورتی فراخوانی می شود که DDMS یک دستگاه ID جدید اختصاص داده باشد
پارامترها | |
---|---|
newDevice | IDevice : IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
زمان انتظار را قبل از شروع ضبط logcat برای یک دستگاه آنلاین بر حسب میلی ثانیه تنظیم می کند.
پارامترها | |
---|---|
delay | int : تاخیر در ms |
setOptions
public void setOptions (TestDeviceOptions options)
TestDeviceOptions
را برای دستگاه تنظیم کنید
پارامترها | |
---|---|
options | TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
مقدار ویژگی داده شده را روی دستگاه تنظیم می کند. نیاز به ریشه adb درست است.
پارامترها | |
---|---|
propKey | String : کلیدی که باید تنظیم شود. |
propValue | String : مقدار خاصیت که باید تنظیم شود. |
برمی گرداند | |
---|---|
boolean | اگر دستور setprop موفقیت آمیز بود، True برمیگرداند، در غیر این صورت، False را برمیگرداند. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
setRecovery
public void setRecovery (IDeviceRecovery recovery)
IDeviceRecovery
را برای استفاده برای این دستگاه تنظیم کنید. زمانی که دستگاه برای اولین بار تخصیص داده می شود باید تنظیم شود.
پارامترها | |
---|---|
recovery | IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
حالت بازیابی فعلی را برای استفاده برای دستگاه تنظیم کنید.
برای کنترل روش بازیابی در هنگام مواجه شدن با مشکل ارتباط دستگاه استفاده می شود. توصیه می شود فقط در مواقع لزوم از این روش استفاده کنید (مثلاً وقتی فریمورک خراب است و غیره).
پارامترها | |
---|---|
mode | ITestDevice.RecoveryMode : حالت «بازیابی فقط تا آنلاین» باید روشن باشد یا خیر. |
setSetting
public void setSetting (String namespace, String key, String value)
به setSetting(int, String, String, String)
مراجعه کنید و در کاربر سیستم انجام شد.
پارامترها | |
---|---|
namespace | String |
key | String |
value | String |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
یک مقدار تنظیم به فضای نام یک کاربر معین اضافه کنید. برخی از تنظیمات فقط پس از راه اندازی مجدد در دسترس خواهند بود. فضای نام باید یکی از موارد زیر باشد: {"system", "secure", "global"}
پارامترها | |
---|---|
userId | int |
namespace | String |
key | String |
value | String |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
نمونه ITestLogger
را تزریق می کند
پارامترها | |
---|---|
testLogger | ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
برای مدیریت دستگاه، سریالی را که برای ارجاع دستگاه استفاده می کنیم، ردیابی کنید.
پارامترها | |
---|---|
trackingSerial | String |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
تنظیم کنید که برای پاک کردن یک پارتیشن روی دستگاه از فرمت fastboot erase یا fastboot استفاده شود.
پارامترها | |
---|---|
useFastbootErase | boolean : اگر از فرمت فست بوت استفاده شود true یا اگر از فرمت فست بوت استفاده شود false . |
startLogcat
public void startLogcat ()
شروع به گرفتن خروجی logcat از دستگاه در پس زمینه کنید.
اگر خروجی logcat از قبل گرفته شده باشد، تاثیری نخواهد داشت. داده ها را می توان بعداً از طریق getLogcat بازیابی کرد.
هنگامی که دستگاه دیگر در حال استفاده نیست، stopLogcat()
باید فراخوانی شود.
startLogcat()
و stopLogcat()
معمولاً نیازی به فراخوانی در یک زمینه فراخوانی TF ندارند، زیرا چارچوب TF logcat را شروع و متوقف می کند.
startTradeInModeTesting
public boolean startTradeInModeTesting (int timeoutMs)
حالت معاملاتی آزمایشی را فعال کنید. دستگاه پاک می شود و راه اندازی مجدد می شود.
پارامترها | |
---|---|
timeoutMs | int |
برمی گرداند | |
---|---|
boolean | اگر موفق بودیم درست، در غیر این صورت نادرست |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
startUser
public boolean startUser (int userId)
اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. اگر کاربر قبلاً در پسزمینه اجرا میشود، این روش یک NOOP است.
پارامترها | |
---|---|
userId | int : کاربر برای شروع در پس زمینه |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر با موفقیت در پسزمینه راهاندازی شده باشد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. اگر کاربر قبلاً در پسزمینه اجرا میشود، این روش یک NOOP است. امکان ارائه پرچم اضافی برای منتظر ماندن برای تأثیرگذاری عملیات.
پارامترها | |
---|---|
userId | int : کاربر برای شروع در پس زمینه |
waitFlag | boolean : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند. |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر با موفقیت در پسزمینه راهاندازی شده باشد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
کاربر مشخصی را در پسزمینه شروع میکند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه میدهد فعالیتها را در آن نمایشگر راهاندازی کند).
توجه: این دستور بررسی نمی کند که آیا کاربر وجود دارد، نمایشگر موجود است، device supports such feature
و غیره.
پارامترها | |
---|---|
userId | int : کاربر برای شروع در پس زمینه |
displayId | int : نمایش برای شروع قابل مشاهده کاربر |
waitFlag | boolean : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند. |
برمی گرداند | |
---|---|
boolean | true اگر کاربر با موفقیت شروع به کار کرده باشد در پس زمینه قابل مشاهده است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
خروجی شبیه ساز را ببندید و حذف کنید.
stopLogcat
public void stopLogcat ()
گرفتن خروجی logcat از دستگاه را متوقف کنید و داده های ذخیره شده logcat را دور بریزید.
اگر خروجی logcat گرفته نشود تاثیری نخواهد داشت.
stopTradeInModeTesting
public void stopTradeInModeTesting ()
آزمایش حالت تجارت در را متوقف کنید.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId)
یک کاربر معین را متوقف می کند. اگر کاربر قبلا متوقف شده باشد، این روش یک NOOP است. کاربر فعلی و سیستم را نمی توان متوقف کرد.
پارامترها | |
---|---|
userId | int : کاربر برای توقف. |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر با موفقیت متوقف شود. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
یک کاربر معین را متوقف کنید. امکان ارائه پرچمهای اضافی برای منتظر ماندن برای تأثیرگذاری عملیات و خاتمه اجباری کاربر. کاربر فعلی و سیستم را نمی توان متوقف کرد.
پارامترها | |
---|---|
userId | int : کاربر برای توقف. |
waitFlag | boolean : فرمان را منتظر می ماند تا کاربر متوقف شود. |
forceFlag | boolean : کاربر را مجبور به توقف می کند. |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر با موفقیت متوقف شود. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
دستگاه را به حالت adb-over-tcp تغییر دهید.
برمی گرداند | |
---|---|
String | شماره سریال tcp یا در صورت عدم تغییر دستگاه، null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
دستگاه را به حالت adb از طریق usb تغییر دهید.
برمی گرداند | |
---|---|
boolean | true اگر سوئیچ موفقیت آمیز بود، در غیر این صورت false . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId)
به userId دیگری با مهلت زمانی پیشفرض تغییر وضعیت دهید. switchUser(int, long)
.
پارامترها | |
---|---|
userId | int |
برمی گرداند | |
---|---|
boolean | اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId, long timeout)
به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید. پس از موفقیت آمیز بودن تغییر کاربر، محافظ صفحه کلید را غیرفعال کنید.
پارامترها | |
---|---|
userId | int |
timeout | long : منتظر ماندن قبل از بازگشت false برای سوئیچ کاربر ناموفق بود. |
برمی گرداند | |
---|---|
boolean | اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
به صورت تدریجی محتویات یک فهرست فایل محلی را با دستگاه همگام می کند.
با مقایسه مُهرهای زمانی فایلهای محلی با معادلهای راه دور، تصمیم میگیرد کدام فایلها را فشار دهد. فقط فایلهای «جدیدتر» یا ناموجود به دستگاه منتقل میشوند. بنابراین اگر فایل تنظیم شده روی دستگاه از قبل به روز باشد، سربار باید نسبتاً کوچک باشد.
فایل های مخفی (با نام هایی که با "." شروع می شوند) نادیده گرفته می شوند.
مثال استفاده: syncFiles("/tmp/files"، "/sdcard") یک دایرکتوری /sdcard/files را در صورتی که از قبل وجود نداشته باشد ایجاد می کند و به صورت بازگشتی محتویات /tmp/files را به /sdcard/files فشار می دهد.
پارامترها | |
---|---|
localFileDir | File : فهرست فایل محلی حاوی فایل هایی برای فشار دادن بازگشتی. |
deviceFilePath | String : ریشه مسیر فایل مطلق مقصد راه دور. همه دایرکتوری ها در مسیر فایل باید قابل خواندن باشند. یعنی فشار دادن به /data/local/tmp زمانی که adb روت نیست با شکست مواجه خواهد شد |
برمی گرداند | |
---|---|
boolean | اگر فایل ها با موفقیت همگام سازی شوند true . false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
takeBugreport
public Bugreport takeBugreport ()
یک Bugreport بگیرید و آن را در یک شی Bugreport
برمی گرداند تا آن را مدیریت کند. در صورت مشکل، باطل برگردانید. فایل ارجاع شده در شی Bugreport باید از طریق Bugreport.close()
پاک شود.
برمی گرداند | |
---|---|
Bugreport |
UninstallPackage
public String uninstallPackage (String packageName)
یک بسته Android را از دستگاه حذف نصب کنید.
پارامترها | |
---|---|
packageName | String : بسته Android برای حذف نصب |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
یک بسته Android را برای یک کاربر خاص از دستگاه حذف نصب کنید.
پارامترها | |
---|---|
packageName | String : بسته Android برای حذف نصب |
userId | int : شناسه کاربری عدد صحیح برای حذف نصب. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
باز کردن قفل دستگاه
public boolean unlockDevice ()
اگر دستگاه در حالت رمزگذاری شده باشد، قفل دستگاه را باز می کند.
این متد ممکن است چارچوب را مجددا راه اندازی کند اماpostBootSetup()
را فراخوانی نخواهد کرد. بنابراین، ممکن است هنگام بازگشت این روش، دستگاه به طور کامل برای آزمایش آماده نباشد.برمی گرداند | |
---|---|
boolean | در صورت موفقیت یا عدم رمزگذاری دستگاه true . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
UnmountDebugfs
public void unmountDebugfs ()
حذف اشکال زدایی
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
مسدود می شود تا زمانی که پرچم کامل بوت دستگاه تنظیم شود.
پارامترها | |
---|---|
timeOut | long : زمان انتظار برای تنظیم پرچم بر حسب میلی ثانیه |
برمی گرداند | |
---|---|
boolean | درست است اگر پرچم کامل بوت دستگاه در مدت زمان تعیین شده تنظیم شود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
منتظر می ماند تا دستگاه پاسخگو و برای آزمایش در دسترس باشد. از مهلت زمانی پیشفرض استفاده میکند.
برمی گرداند | |
---|---|
boolean | اگر دستگاه در دسترس باشد درست است، اگر بازیابی غیرفعال و در دسترس نباشد نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
منتظر می ماند تا دستگاه پاسخگو و برای آزمایش در دسترس باشد.
پارامترها | |
---|---|
waitTime | long : زمان انتظار بر حسب ms |
برمی گرداند | |
---|---|
boolean | اگر دستگاه در دسترس باشد درست است، اگر بازیابی غیرفعال و در دسترس نباشد نادرست است. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
منتظر می ماند تا دستگاه بدون در نظر گرفتن مسیر بازیابی پاسخگو و در دسترس باشد.
پارامترها | |
---|---|
waitTime | long |
برمی گرداند | |
---|---|
boolean | درست اگر دستگاه در دسترس باشد، نادرست اگر در دسترس نباشد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
مسدود می شود تا زمانی که دستگاه از طریق فست بوت قابل مشاهده باشد. از مهلت زمانی پیش فرض استفاده کنید.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
مسدود کردن دستگاه در حالت «بازیابی adb» (توجه داشته باشید که این با IDeviceRecovery
متفاوت است).
پارامترها | |
---|---|
waitTime | long : زمان انتظار بر حسب ms |
برمی گرداند | |
---|---|
boolean | true اگر دستگاه قبل از انقضای زمان به بازیابی راه اندازی شود. false در غیر این صورت |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
مسدود کردن دستگاه در حالت "adb sideload".
پارامترها | |
---|---|
waitTime | long : زمان انتظار بر حسب ms |
برمی گرداند | |
---|---|
boolean | true اگر دستگاه قبل از انقضای زمان در بار جانبی بوت شود. false در غیر این صورت |
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
بلوکهایی که دستگاه در دسترس نیست، یعنی از adb موجود نیست
پارامترها | |
---|---|
waitTime | long : زمان انتظار بر حسب ms |
برمی گرداند | |
---|---|
boolean | true اگر دستگاه قبل از انقضای زمان در دسترس نباشد. false در غیر این صورت |
waitForDeviceOnline
public void waitForDeviceOnline ()
مسدود می شود تا زمانی که دستگاه از طریق adb قابل مشاهده باشد. از مهلت زمانی پیشفرض استفاده میکند
توجه داشته باشید که دستگاه ممکن است لزوماً به دستورات پس از تکمیل پاسخگو نباشد. به جای آن از waitForDeviceAvailable()
استفاده کنید.
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
مسدود می شود تا زمانی که دستگاه از طریق adb قابل مشاهده باشد.
توجه داشته باشید که دستگاه ممکن است لزوماً به دستورات پس از تکمیل پاسخگو نباشد. به جای آن از waitForDeviceAvailable()
استفاده کنید.
پارامترها | |
---|---|
waitTime | long : زمان انتظار بر حسب ms |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
منتظر می ماند تا دستگاه به یک دستور اولیه پوسته adb پاسخ دهد.
پارامترها | |
---|---|
waitTime | long : زمان انتظار بر حسب ms |
برمی گرداند | |
---|---|
boolean | true اگر دستگاه قبل از سپری شدن waitTime پاسخگو شود. |
روش های محافظت شده
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
پارامترها | |
---|---|
builder | DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
دستور OS را برای جلسه دستور adb shell داده شده می سازد و args می کند
پارامترها | |
---|---|
command | String |
forceExitStatusDetection | boolean |
برمی گرداند | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
پارامترها | |
---|---|
feature | String |
strictMinLevel | int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
یک RebootDeviceAction
ایجاد کنید تا در هنگام انجام یک عمل راه اندازی مجدد استفاده شود.
پارامترها | |
---|---|
rebootMode | NativeDevice.RebootMode : حالتی از این راهاندازی مجدد. |
reason | String : برای این راه اندازی مجدد. |
برمی گرداند | |
---|---|
NativeDevice.RebootDeviceAction | RebootDeviceAction ایجاد شده |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
یک راه اندازی مجدد adb انجام دهید.
پارامترها | |
---|---|
rebootMode | NativeDevice.RebootMode : حالتی از این راهاندازی مجدد. |
reason | String : برای این راه اندازی مجدد. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
sureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
روش کمکی برای پرتاب استثنا در صورت عدم پشتیبانی از مجوز زمان اجرا
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
برمی گرداند | |
---|---|
int |
getRunUtil
protected IRunUtil getRunUtil ()
نمونه RunUtil
را برای استفاده دریافت کنید.
برمی گرداند | |
---|---|
IRunUtil |
InitializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
پارامترها | |
---|---|
info | IBuildInfo |
attributes | MultiMap |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | |
TargetSetupError |
insideGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
یک ویژگی دستگاه را از کش ddmlib به طور پیشفرض واکشی کنید و بسته به اینکه دستگاه در Fastboot باشد یا خیر، به «adb shell getprop» یا «fastboot getvar» برگردید.
پارامترها | |
---|---|
propName | String : نام ویژگی دستگاه که توسط «adb shell getprop» برگردانده شده است |
fastbootVar | String : نام متغیر fastboot معادل query. اگر null ، کوئری فست بوت انجام نخواهد شد |
description | String : یک توضیح ساده از متغیر. حرف اول باید بزرگ باشد. |
برمی گرداند | |
---|---|
String | یک رشته، احتمالا null یا خالی، حاوی مقدار خاصیت داده شده |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
isInRebootCallback است
protected boolean isInRebootCallback ()
برمیگرداند که آیا فراخوانهای راهاندازی مجدد در حال حاضر اجرا میشوند یا خیر. اگر درست باشد، تمام api های عمومی برای راه اندازی مجدد باید غیرفعال شوند.
برمی گرداند | |
---|---|
boolean |
جدیدتر است
protected boolean isNewer (File localFile, IFileEntry entry)
اگر فایل محلی جدیدتر از فایل راه دور باشد، true
برگردانید. IFileEntry
با دقت به دقیقه، در صورت مساوی بودن، فایل جدیدتر در نظر گرفته می شود.
پارامترها | |
---|---|
localFile | File |
entry | IFileEntry |
برمی گرداند | |
---|---|
boolean |
notifyRebootEnded
protected void notifyRebootEnded ()
به همه IDeviceActionReceiver
درباره رویداد پایان راهاندازی مجدد اطلاع میدهد.
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
همه IDeviceActionReceiver
در مورد رویداد شروع راه اندازی مجدد مطلع می کند.
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
performDeviceAction
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
عملی را در این دستگاه انجام می دهد. سعی میکند دستگاه را بازیابی کند و در صورت عدم موفقیت، فرمان را دوباره امتحان کنید.
پارامترها | |
---|---|
actionDescription | String : شرح کوتاهی از اقدامی که باید انجام شود. فقط برای اهداف ورود به سیستم استفاده می شود. |
action | NativeDevice.DeviceAction : اقدامی که باید انجام شود |
retryAttempts | int : تلاش مجدد برای انجام عمل در صورت شکست اما بازیابی موفق است |
برمی گرداند | |
---|---|
boolean | true اگر اقدام با موفقیت انجام شود |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر تلاش برای بازیابی با شکست مواجه شد یا حداکثر تلاش بدون موفقیت انجام شد |
postAdbReboot
protected void postAdbReboot ()
اقدامات اضافی احتمالی که می توان پس از راه اندازی مجدد انجام داد.
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
prePostBootSetup
protected void prePostBootSetup ()
به هر نوع دستگاه (AndroidNativeDevice، TestDevice) اجازه میدهد این روش را برای راهاندازی خاص پس از بوت لغو کند.
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
pullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
پارامترها | |
---|---|
remoteFilePath | String |
localFile | File |
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
setClock
protected void setClock (Clock clock)
نمونه ساعت را برای استفاده تنظیم کنید.
پارامترها | |
---|---|
clock | Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
TestDevice را به عنوان microdroid علامت گذاری کرده و CID آن را تنظیم می کند.
پارامترها | |
---|---|
process | Process : فرآیند Microdroid VM. |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
پارامترها | |
---|---|
deviceOptions | |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
یک فرمان ساده fastboot را با متغیرهای محیطی اجرا می کند و وضعیت دستور را گزارش می دهد.
پارامترها | |
---|---|
timeout | long |
envVarMap |
|
fullCmd | String |
برمی گرداند | |
---|---|
CommandResult |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
یک فرمان ساده fastboot را اجرا می کند و وضعیت فرمان را گزارش می کند.
پارامترها | |
---|---|
timeout | long |
fullCmd | String |
برمی گرداند | |
---|---|
CommandResult |
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
منتظر بمانید تا دستگاه در دسترس نباشد (گزارش به adb را متوقف کنید).
پارامترها | |
---|---|
operationDesc | String : نام عملیاتی که در انتظار آن در دسترس نیست. |
time | long : زمان انتظار برای رخ دادن غیرقابل دسترس بودن. |
برمی گرداند | |
---|---|
boolean | اگر دستگاه در دسترس نباشد درست است. |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-03-26 بهوقت ساعت هماهنگ جهانی.