public interface ITestDevice
implements INativeDevice
com.android.tradefed.device.ITestDevice |
یک API قابل اعتماد و سطح کمی بالاتر را برای IDevice
ddmlib ارائه می دهد.
دستورات دستگاه را برای مقدار قابل تنظیم دوباره امتحان می کند و برای دستگاه هایی که پاسخگو نیستند یک رابط بازیابی دستگاه ارائه می دهد.
class | ITestDevice.ApexInfo یک کلاس ساختاری ساده برای ذخیره اطلاعات در مورد یک APEX |
class | ITestDevice.MountPointInfo یک کلاس ساختاری ساده برای ذخیره اطلاعات در مورد یک نقطه نصب |
abstract boolean | canSwitchToHeadlessSystemUser () برمیگرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر. |
abstract boolean | checkConnectivity () بررسی کنید که دستگاه اتصال شبکه دارد. |
abstract boolean | clearErrorDialogs () سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید. |
abstract void | clearLastConnectedWifiNetwork () آخرین شبکه وای فای متصل را پاک می کند. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) به شبکه وای فای متصل می شود. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) به شبکه وای فای متصل می شود. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) به شبکه وای فای متصل می شود. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) به شبکه وای فای متصل می شود. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) گونه ای از |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) گونه ای از |
abstract int | createUser (String name) یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید. |
abstract int | createUser (String name, boolean guest, boolean ephemeral) یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید |
abstract int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید |
abstract int | createUserNoThrow (String name) یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید. |
abstract void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) |
abstract void | disableKeyguard () تلاش برای غیرفعال کردن محافظ صفحه کلید. |
abstract boolean | disableNetworkMonitor () مانیتورینگ شبکه را در دستگاه غیرفعال می کند. |
abstract boolean | disconnectFromWifi () از شبکه وای فای قطع می شود. |
abstract boolean | doesFileExist (String deviceFilePath, int userId) روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر. |
abstract File | dumpHeap (String process, String devicePath) سعی کنید پشته را از system_server تخلیه کنید. |
abstract boolean | enableNetworkMonitor () نظارت بر شبکه را بر روی دستگاه فعال می کند. |
abstract | getActiveApexes () اطلاعات مربوط به APEX های فعال شده در دستگاه را واکشی کنید. |
abstract | getAllSettings (String namespace) جفت مقدار کلید فضای نام درخواستی را برگردانید. |
abstract String | getAndroidId (int userId) شناسه android مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null. |
abstract | getAndroidIds () یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید. |
abstract PackageInfo | getAppPackageInfo (String packageName) اطلاعات مربوط به بسته نصب شده روی دستگاه را واکشی کنید. |
abstract | getAppPackageInfos () اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید. |
abstract InputStreamSource | getBugreport () گزارش اشکال را از دستگاه بازیابی می کند. |
abstract InputStreamSource | getBugreportz () یک bugreportz را از دستگاه بازیابی می کند. |
abstract DeviceFoldableState | getCurrentFoldableState () وضعیت تاشو فعلی دستگاه را برمیگرداند یا در صورت بروز برخی مشکلات، آن را خالی میکند. |
abstract int | getCurrentUser () شناسه کاربر فعلی را برگردانید. |
abstract | getFoldableStates () لیست حالت های تاشو را در دستگاه برمی گرداند. |
abstract | getInstalledPackageNames () نام بسته های برنامه موجود در دستگاه را واکشی کنید. |
abstract String | getIpAddress () آدرس IP دستگاه را دریافت می کند. |
abstract KeyguardControllerState | getKeyguardState () یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید. |
abstract Integer | getMainUserId () شناسه اصلی کاربر را برمی گرداند. |
abstract | getMainlineModuleInfo () اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید. |
abstract int | getMaxNumberOfRunningUsersSupported () حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید. |
abstract int | getMaxNumberOfUsersSupported () حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. |
abstract TestDeviceOptions | getOptions () گزینه های تست دستگاه را واکشی کنید. |
abstract Integer | getPrimaryUserId () شناسه کاربر اصلی را برمی گرداند. |
abstract InputStreamSource | getScreenshot (String format, boolean rescale) یک اسکرین شات از دستگاه می گیرد. |
abstract InputStreamSource | getScreenshot (String format) یک اسکرین شات از دستگاه می گیرد. |
abstract InputStreamSource | getScreenshot (long displayId) یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد. |
abstract InputStreamSource | getScreenshot () یک اسکرین شات از دستگاه می گیرد. |
abstract String | getSetting (int userId, String namespace, String key) مقدار تنظیمات درخواستی را برگردانید. |
abstract String | getSetting (String namespace, String key) |
abstract | getUninstallablePackageNames () نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید. |
abstract int | getUserFlags (int userId) پرچم های یک کاربر معین را پیدا کرده و برگردانید. |
abstract | getUserInfos () نقشه useId به |
abstract int | getUserSerialNumber (int userId) در صورت یافتن شماره سریال مرتبط به userId، در هر مورد دیگر -10000 را برگردانید. |
abstract boolean | hasFeature (String feature) بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر. |
abstract String | installPackage (File packageFile, boolean reinstall, String... extraArgs) بسته اندروید را روی دستگاه نصب کنید. |
abstract String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) بسته اندروید را روی دستگاه نصب کنید. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید. |
default String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) را نصب کنید. |
default String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) یک برنامه اندرویدی ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) که روی دستگاه اندرویدی قرار دارند را نصب کنید. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) برای یک کاربر خاص نصب کنید. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) برای یک کاربر خاص نصب کنید. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) یک برنامه اندرویدی ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) که روی دستگاه اندرویدی قرار دارند را نصب کنید. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) یک برنامه اندرویدی ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) که روی دستگاه اندرویدی قرار دارند را نصب کنید. |
abstract boolean | isHeadlessSystemUserMode () نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر. |
abstract boolean | isMainUserPermanentAdmin () نشان می دهد که آیا کاربر اصلی یک سرپرست دائمی است و نمی توان آن را حذف کرد یا به وضعیت غیر سرپرست تنزل داد. |
abstract boolean | isMultiUserSupported () تعیین می کند که آیا چند کاربر پشتیبانی می شود یا خیر. |
abstract boolean | isPackageInstalled (String packageName, String userId) دستگاه را برای نام بسته معین و شناسه کاربری داده شده جستجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر. |
abstract boolean | isPackageInstalled (String packageName) دستگاه را برای یک نام بسته جستجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر. |
abstract boolean | isUserRunning (int userId) بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر. |
abstract boolean | isUserSecondary (int userId) آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر. |
abstract boolean | isUserVisible (int userId) بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر. |
abstract boolean | isUserVisibleOnDisplay (int userId, int displayId) بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر. |
abstract boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () نشان میدهد که آیا دستگاه به کاربران اجازه میدهد در پسزمینه در |
abstract boolean | isVisibleBackgroundUsersSupported () نشان می دهد که آیا دستگاه به کاربران اجازه می دهد در پس زمینه قابل مشاهده باشند یا خیر. |
abstract boolean | isWifiEnabled () تست کنید آیا وای فای فعال است یا خیر. |
abstract | listDisplayIds () لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید. |
abstract | listDisplayIdsForStartingVisibleBackgroundUsers () لیستی از نمایشگرهایی را دریافت می کند که می توانند برای |
abstract | listUsers () لیست کاربران دستگاه را دریافت می کند. |
abstract boolean | logBugreport (String dataName, ITestLogger listener) روش کمکی برای گرفتن گزارش اشکال و ورود آن به خبرنگاران. |
default void | notifySnapuserd ( SnapuserdWaitPhase waitPhase) به دستگاه اطلاع دهید تا منتظر تکمیل snapuserd باشد. |
abstract void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) |
abstract boolean | removeAdmin (String componentName, int userId) ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود |
abstract void | removeOwners () همه دارندگان نمایه دستگاه موجود را با بهترین تلاش حذف کنید. |
abstract boolean | removeUser (int userId) یک کاربر معین را از دستگاه حذف کنید. |
abstract boolean | setDeviceOwner (String componentName, int userId) یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید. |
abstract void | setSetting (String namespace, String key, String value) به |
abstract void | setSetting (int userId, String namespace, String key, String value) یک مقدار تنظیم به فضای نام یک کاربر معین اضافه کنید. |
abstract boolean | startUser (int userId) اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. |
abstract boolean | startUser (int userId, boolean waitFlag) اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. |
abstract boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) کاربر مشخصی را در پسزمینه شروع میکند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه میدهد فعالیتها را در آن نمایشگر راهاندازی کند). |
abstract boolean | stopUser (int userId) یک کاربر معین را متوقف می کند. |
abstract boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) یک کاربر معین را متوقف کنید. |
abstract boolean | switchUser (int userId) به userId دیگری با مهلت زمانی پیشفرض تغییر وضعیت دهید. |
abstract boolean | switchUser (int userId, long timeout) به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید. |
abstract Bugreport | takeBugreport () یک Bugreport بگیرید و آن را در یک شی |
abstract String | uninstallPackage (String packageName) یک بسته Android را از دستگاه حذف نصب کنید. |
abstract String | uninstallPackageForUser (String packageName, int userId) یک بسته Android را برای یک کاربر خاص از دستگاه حذف نصب کنید. |
default void | waitForSnapuserd ( SnapuserdWaitPhase currentPhase) اگر انتظار می رود، صبر کنید تا snapuserd کامل شود. |
public abstract boolean canSwitchToHeadlessSystemUser ()
برمیگرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstract boolean checkConnectivity ()
بررسی کنید که دستگاه اتصال شبکه دارد.
برمی گرداند | |
---|---|
boolean | true اگر دستگاه اتصال شبکه کار می کند، false . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract boolean clearErrorDialogs ()
سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید.
برمی گرداند | |
---|---|
boolean | true اگر هیچ گفتگویی وجود نداشته باشد یا گفتگوها با موفقیت پاک شوند. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract void clearLastConnectedWifiNetwork ()
آخرین شبکه وای فای متصل را پاک می کند. این باید هنگام شروع فراخوانی جدید برای جلوگیری از اتصال به شبکه وای فای مورد استفاده در آزمایش قبلی پس از راهاندازی مجدد دستگاه خوانده شود.
public abstract boolean connectToWifiNetwork (wifiSsidToPsk)
به شبکه وای فای متصل می شود.
وای فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز با یکی از شبکه های وای فای ارائه شده در نقشه wifiSsidToPsk برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice#disconnectFromWifi()
یا ITestDevice#clearLastConnectedWifiNetwork()
فراخوانی شود.
مولفه های | |
---|---|
wifiSsidToPsk |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
به شبکه وای فای متصل می شود.
وای فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز با یکی از شبکه های وای فای ارائه شده در نقشه wifiSsidToPsk برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice#disconnectFromWifi()
یا ITestDevice#clearLastConnectedWifiNetwork()
فراخوانی شود.
مولفه های | |
---|---|
wifiSsidToPsk | |
scanSsid | boolean : آیا باید SSIDهای مخفی این شبکه را اسکن کرد یا خیر. |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
به شبکه وای فای متصل می شود.
فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز به شبکه وای فای مشخص شده برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice#disconnectFromWifi()
یا ITestDevice#clearLastConnectedWifiNetwork()
فراخوانی شود.
مولفه های | |
---|---|
wifiSsid | String : وای فای ssid برای اتصال |
wifiPsk | String : عبارت عبور PSK یا اگر رمزگذاری نشده باشد، null است |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
به شبکه وای فای متصل می شود.
فای را روشن می کند و مسدود می کند تا زمانی که اتصال موفقیت آمیز به شبکه وای فای مشخص شده برقرار شود. هنگامی که یک اتصال برقرار شد، نمونه سعی می کند پس از هر بار راه اندازی مجدد، اتصال را بازیابی کند تا زمانی که ITestDevice#disconnectFromWifi()
یا ITestDevice#clearLastConnectedWifiNetwork()
فراخوانی شود.
مولفه های | |
---|---|
wifiSsid | String : وای فای ssid برای اتصال |
wifiPsk | String : عبارت عبور PSK یا اگر رمزگذاری نشده باشد، null است |
scanSsid | boolean : آیا باید SSID مخفی این شبکه را اسکن کرد. |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
گونه ای از connectToWifiNetwork(String, String)
که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
مولفه های | |
---|---|
scanSsid | boolean : آیا باید SSID مخفی این شبکه را اسکن کرد |
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
گونه ای از connectToWifiNetwork(String, String)
که فقط در صورتی متصل می شود که دستگاه در حال حاضر اتصال شبکه نداشته باشد.
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت به شبکه وای فای متصل شوید. false در غیر این صورت |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int createUser (String name)
یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
مولفه های | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
برمی گرداند | |
---|---|
int | عدد صحیح برای شناسه کاربری ایجاد شده |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int createUser (String name, boolean guest, boolean ephemeral)
یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
مولفه های | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
guest | boolean : فعال کردن پرچم کاربر --guest در حین ایجاد |
ephemeral | boolean : در حین ایجاد، پرچم کاربر را فعال کنید |
برمی گرداند | |
---|---|
int | شناسه کاربر ایجاد شده |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
مولفه های | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
guest | boolean : فعال کردن پرچم کاربر --guest در حین ایجاد |
ephemeral | boolean : در حین ایجاد، پرچم کاربر را فعال کنید |
forTesting | boolean : پرچم تست --برای آزمایش در حین ایجاد را فعال کنید |
برمی گرداند | |
---|---|
int | شناسه کاربر ایجاد شده |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int createUserNoThrow (String name)
یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
مولفه های | |
---|---|
name | String : کاربر برای ایجاد در دستگاه |
برمی گرداند | |
---|---|
int | عدد صحیح برای شناسه کاربر ایجاد شده یا -1 برای خطا. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
IDeviceActionReceiver
ثبت شده را حذف می کند.
مولفه های | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : یک IDeviceActionReceiver که حذف خواهد شد. |
public abstract void disableKeyguard ()
تلاش برای غیرفعال کردن محافظ صفحه کلید.
ابتدا منتظر بمانید تا ارسال ورودی آماده شود، این تقریباً همزمان با گزارش دستگاه BOOT_COMPLETE، ظاهراً ناهمزمان، اتفاق میافتد، زیرا پیادهسازی چارچوب فعلی دارای شرایط مسابقه گاه به گاه است. سپس دستور رد کردن صفحه کلید ارسال می شود (فقط روی موارد غیر ایمن کار می کند)
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstract boolean disableNetworkMonitor ()
مانیتورینگ شبکه را در دستگاه غیرفعال می کند.
برمی گرداند | |
---|---|
boolean | true اگر نظارت با موفقیت غیرفعال شود. false اگر شکست خورد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract boolean disconnectFromWifi ()
از شبکه وای فای قطع می شود.
تمام شبکه ها را از لیست شبکه های شناخته شده حذف می کند و وای فای را غیرفعال می کند.
برمی گرداند | |
---|---|
boolean | true اگر با موفقیت از شبکه وای فای قطع شود. false اگر قطع اتصال انجام نشد. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract boolean doesFileExist (String deviceFilePath, int userId)
روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر.
مولفه های | |
---|---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه برای بررسی |
userId | int : شناسه کاربری که وجود فایل را با آن بررسی کنید |
برمی گرداند | |
---|---|
boolean | true در صورت وجود فایل، false در غیر این صورت. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract File dumpHeap (String process, String devicePath)
سعی کنید پشته را از system_server تخلیه کنید. این وظیفه تماس گیرنده است که فایل تخلیه شده را پاک کند.
مولفه های | |
---|---|
process | String : نام فرآیند دستگاهی که باید روی آن تخلیه شود. |
devicePath | String : مسیر روی دستگاه که در آن روگرفت را قرار دهید. این باید مکانی باشد که مجوزها اجازه آن را می دهند. |
برمی گرداند | |
---|---|
File | ERROR(/File) حاوی گزارش. اگر چیزی شکست خورده است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean enableNetworkMonitor ()
نظارت بر شبکه را بر روی دستگاه فعال می کند.
برمی گرداند | |
---|---|
boolean | true اگر نظارت با موفقیت فعال شود. false اگر شکست خورد |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstractgetActiveApexes ()
اطلاعات مربوط به APEX های فعال شده در دستگاه را واکشی کنید.
برمی گرداند | |
---|---|
ERROR(/Set) ApexInfo در حال حاضر در دستگاه فعال شده است |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetAllSettings (String namespace)
جفت مقدار کلید فضای نام درخواستی را برگردانید.
مولفه های | |
---|---|
namespace | String : باید یکی از {"system"، "secure"، "global"} باشد. |
برمی گرداند | |
---|---|
نقشه جفت ارزش کلیدی اگر فضای نام پشتیبانی نشود، تهی است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract String getAndroidId (int userId)
شناسه android مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null.
مولفه های | |
---|---|
userId | int |
برمی گرداند | |
---|---|
String |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetAndroidIds ()
یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید. هیچ بیمه ای وجود ندارد که هر شناسه کاربری یک شناسه اندروید مرتبط با این تابع را پیدا کند، بنابراین برخی از شناسه های کاربر ممکن است با null مطابقت داشته باشند.
برمی گرداند | |
---|---|
نقشه شناسه های اندروید، شناسه های کاربر منطبق را پیدا کرد. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract PackageInfo getAppPackageInfo (String packageName)
اطلاعات مربوط به بسته نصب شده روی دستگاه را واکشی کنید.
مولفه های | |
---|---|
packageName | String |
برمی گرداند | |
---|---|
PackageInfo | PackageInfo یا در صورتی که اطلاعات قابل بازیابی نباشد، null |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetAppPackageInfos ()
اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید.
برمی گرداند | |
---|---|
ERROR(/List) PackageInfo های نصب شده روی دستگاه. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract InputStreamSource getBugreport ()
گزارش اشکال را از دستگاه بازیابی می کند.
اجرای این برای ادامه کار بر روی دستگاهی بدون sdcard (یا جایی که sdcard هنوز نصب نشده است) تضمین شده است.
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource که محتویات گزارش اشکال را در صورت تقاضا تولید می کند. در صورت خرابی، InputStreamSource یک ERROR(/InputStream) خالی تولید می کند. |
public abstract InputStreamSource getBugreportz ()
یک bugreportz را از دستگاه بازیابی می کند. اشکال گزارش فرمت زیپ حاوی گزارش اشکال اصلی و سایر فایلهای گزارش است که برای اشکالزدایی مفید هستند.
فقط برای «نسخه adb» > 1.0.36 پشتیبانی می شود
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از فایل فشرده حاوی bugreportz، در صورت خرابی، null را برگردانید. |
public abstract DeviceFoldableState getCurrentFoldableState ()
وضعیت تاشو فعلی دستگاه را برمیگرداند یا در صورت بروز برخی مشکلات، آن را خالی میکند.
برمی گرداند | |
---|---|
DeviceFoldableState |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int getCurrentUser ()
شناسه کاربر فعلی را برگردانید. در صورت بروز خطا 10000- را برگردانید.
برمی گرداند | |
---|---|
int |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetFoldableStates ()
لیست حالت های تاشو را در دستگاه برمی گرداند. می توان با "cmd device_state print-states" به دست آورد.
برمی گرداند | |
---|---|
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetInstalledPackageNames ()
نام بسته های برنامه موجود در دستگاه را واکشی کنید.
برمی گرداند | |
---|---|
ERROR(/Set) نامهای بسته String که در حال حاضر روی دستگاه نصب شدهاند. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract String getIpAddress ()
آدرس IP دستگاه را دریافت می کند.
برمی گرداند | |
---|---|
String | آدرس IP دستگاه، یا اگر دستگاه آدرس IP نداشته باشد، null |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract KeyguardControllerState getKeyguardState ()
یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید.
برمی گرداند | |
---|---|
KeyguardControllerState | یک KeyguardControllerState که حاوی یک عکس فوری از وضعیت نگهدارنده کلید است و در صورت عدم پشتیبانی از پرس و جوی Keyguard، Null را برمی گرداند. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract Integer getMainUserId ()
شناسه اصلی کاربر را برمی گرداند.
برمی گرداند | |
---|---|
Integer | شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد null. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceRuntimeException | اگر خروجی دستگاه مطابق انتظار نباشد. |
DeviceNotAvailableException |
public abstractgetMainlineModuleInfo ()
اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید.
برمی گرداند | |
---|---|
ERROR(/Set) ماژول های خط اصلی String که در حال حاضر روی دستگاه نصب شده اند. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int getMaxNumberOfRunningUsersSupported ()
حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید. پیشفرض 0 است.
برمی گرداند | |
---|---|
int | یک عدد صحیح که تعداد کاربرانی که به طور همزمان در حال اجرا هستند را نشان می دهد |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int getMaxNumberOfUsersSupported ()
حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. پیشفرض 0 است.
برمی گرداند | |
---|---|
int | یک عدد صحیح که تعداد کاربران پشتیبانی شده را نشان می دهد |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract TestDeviceOptions getOptions ()
گزینه های تست دستگاه را واکشی کنید.
برمی گرداند | |
---|---|
TestDeviceOptions | TestDeviceOptions مربوط به دستگاه تحت آزمایش. |
public abstract Integer getPrimaryUserId ()
شناسه کاربر اصلی را برمی گرداند.
برمی گرداند | |
---|---|
Integer | شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد، null. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceRuntimeException | اگر خروجی دستگاه مطابق انتظار نباشد. |
DeviceNotAvailableException |
public abstract InputStreamSource getScreenshot (String format, boolean rescale)
یک اسکرین شات از دستگاه می گیرد. توصیه می شود به جای آن getScreenshot(String)
با رمزگذاری JPEG برای اندازه کوچکتر استفاده کنید.
مولفه های | |
---|---|
format | String : پشتیبانی از PNG، JPEG |
rescale | boolean : اگر اسکرین شات باید تغییر مقیاس داده شود تا اندازه تصویر حاصل کاهش یابد |
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات null . |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract InputStreamSource getScreenshot (String format)
یک اسکرین شات از دستگاه می گیرد. توصیه می شود برای اندازه کوچکتر از getScreenshot (فرمت) به جای کدگذاری JPEG استفاده کنید
مولفه های | |
---|---|
format | String : پشتیبانی از PNG، JPEG |
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات null . |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract InputStreamSource getScreenshot (long displayId)
یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد. فرمت PNG است.
TODO: پیاده سازی های بالا را برای پشتیبانی از "قالب" و "مقیاس مجدد" گسترش دهید
مولفه های | |
---|---|
displayId | long : شناسه نمایش صفحه برای گرفتن اسکرین شات از آن. |
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از اسکرین شات در قالب، یا در صورت عدم موفقیت اسکرین شات null . |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract InputStreamSource getScreenshot ()
یک اسکرین شات از دستگاه می گیرد.
برمی گرداند | |
---|---|
InputStreamSource | یک InputStreamSource از اسکرین شات با فرمت png یا در صورت عدم موفقیت اسکرین شات null . |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract String getSetting (int userId, String namespace, String key)
مقدار تنظیمات درخواستی را برگردانید. فضای نام باید یکی از موارد زیر باشد: {"system", "secure", "global"}
مولفه های | |
---|---|
userId | int |
namespace | String |
key | String |
برمی گرداند | |
---|---|
String | مقدار مربوط به فضای نام: کلید یک کاربر. اگر پیدا نشد، پوچ |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract String getSetting (String namespace, String key)
getSetting(int, String, String)
ببینید و روی کاربر سیستم انجام شود.
مولفه های | |
---|---|
namespace | String |
key | String |
برمی گرداند | |
---|---|
String |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetUninstallablePackageNames ()
نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید. این در حال حاضر به عنوان بسته های غیر سیستمی و بسته های سیستمی به روز شده تعریف می شود.
برمی گرداند | |
---|---|
ERROR(/Set) نامهای بسته String غیرقابل نصب که در حال حاضر روی دستگاه نصب شدهاند. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int getUserFlags (int userId)
پرچم های یک کاربر معین را پیدا کرده و برگردانید. پرچمها در کلاس «android.content.pm.UserInfo» در پروژه منبع باز Android تعریف شدهاند.
مولفه های | |
---|---|
userId | int |
برمی گرداند | |
---|---|
int | پرچم های مرتبط با userId ارائه شده در صورت یافتن، -10000 در هر مورد دیگر. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetUserInfos ()
نقشه useId به UserInfo
را در دستگاه دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException
پرتاب می کند.
برمی گرداند | |
---|---|
لیست اشیاء UserInfo |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException |
public abstract int getUserSerialNumber (int userId)
در صورت یافتن شماره سریال مرتبط به userId، در هر مورد دیگر -10000 را برگردانید.
مولفه های | |
---|---|
userId | int |
برمی گرداند | |
---|---|
int |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean hasFeature (String feature)
بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر.
مولفه های | |
---|---|
feature | String : کدام فرمت باید «feature: |
برمی گرداند | |
---|---|
boolean | اگر ویژگی پیدا شود درست است، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract String installPackage (File packageFile, boolean reinstall, String... extraArgs)
بسته اندروید را روی دستگاه نصب کنید.
مولفه های | |
---|---|
packageFile | File : فایل apk برای نصب |
reinstall | boolean : true اگر نصب مجدد انجام شود |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract 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 | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
UnsupportedOperationException | اگر مجوز زمان اجرا توسط پلت فرم روی دستگاه پشتیبانی نمی شود. |
public abstract String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید.
مولفه های | |
---|---|
packageFile | File : فایل apk برای نصب |
reinstall | boolean : true اگر نصب مجدد انجام شود |
userId | int : شناسه کاربری عدد صحیح برای نصب. |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstract 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 | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
UnsupportedOperationException | اگر مجوز زمان اجرا توسط پلت فرم روی دستگاه پشتیبانی نمی شود. |
public String installPackages (packageFiles, boolean reinstall, String... extraArgs)
یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) را نصب کنید. در مورد نحوه تقسیم apk به چندین فایل به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.
مولفه های | |
---|---|
packageFiles | |
reinstall | boolean : true اگر نصب مجدد انجام شود |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
UnsupportedOperationException | اگر مجوز زمان اجرا توسط پلت فرم روی دستگاه پشتیبانی نمی شود. |
public String installPackages (packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
یک برنامه اندرویدی ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) که روی دستگاه اندرویدی قرار دارند را نصب کنید. در مورد نحوه تقسیم apk به چندین فایل به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.
توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.
مولفه های | |
---|---|
packageFiles | |
reinstall | boolean : true اگر نصب مجدد انجام شود |
grantPermissions | boolean : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
UnsupportedOperationException | اگر مجوز زمان اجرا توسط پلت فرم روی دستگاه پشتیبانی نمی شود. |
public String installPackagesForUser (packageFiles, boolean reinstall, int userId, String... extraArgs)
یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) برای یک کاربر خاص نصب کنید. در مورد نحوه تقسیم apk به چندین فایل به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.
مولفه های | |
---|---|
packageFiles | |
reinstall | boolean : true اگر نصب مجدد انجام شود |
userId | int : شناسه کاربری عدد صحیح برای نصب. |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
UnsupportedOperationException | اگر مجوز زمان اجرا توسط پلت فرم روی دستگاه پشتیبانی نمی شود. |
public String installPackagesForUser (packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
یک برنامه اندروید ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) برای یک کاربر خاص نصب کنید. در مورد نحوه تقسیم apk به چندین فایل به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.
توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.
مولفه های | |
---|---|
packageFiles | |
reinstall | boolean : true اگر نصب مجدد انجام شود |
grantPermissions | boolean : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند |
userId | int : شناسه کاربری عدد صحیح برای نصب. |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
UnsupportedOperationException | اگر مجوز زمان اجرا توسط پلت فرم روی دستگاه پشتیبانی نمی شود. |
public String installRemotePackages (remoteApkPaths, boolean reinstall, String... extraArgs)
یک برنامه اندرویدی ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) که روی دستگاه اندرویدی قرار دارند را نصب کنید. در مورد نحوه تقسیم apk به چندین فایل به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.
مولفه های | |
---|---|
remoteApkPaths | |
reinstall | boolean : true اگر نصب مجدد انجام شود |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
UnsupportedOperationException | اگر مجوز زمان اجرا توسط پلت فرم روی دستگاه پشتیبانی نمی شود. |
public String installRemotePackages (remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
یک برنامه اندرویدی ساخته شده از چندین فایل APK (یک بسته اصلی و اضافی) که روی دستگاه اندرویدی قرار دارند را نصب کنید. در مورد نحوه تقسیم apk به چندین فایل به "https://developer.android.com/studio/build/configure-apk-splits" مراجعه کنید.
توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.
مولفه های | |
---|---|
remoteApkPaths | |
reinstall | boolean : true اگر نصب مجدد انجام شود |
grantPermissions | boolean : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند | |
---|---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
UnsupportedOperationException | اگر مجوز زمان اجرا توسط پلت فرم روی دستگاه پشتیبانی نمی شود. |
public abstract boolean isHeadlessSystemUserMode ()
نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstract boolean isMainUserPermanentAdmin ()
نشان می دهد که آیا کاربر اصلی یک سرپرست دائمی است و نمی توان آن را حذف کرد یا به وضعیت غیر سرپرست تنزل داد.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstract boolean isMultiUserSupported ()
تعیین می کند که آیا چند کاربر پشتیبانی می شود یا خیر.
برمی گرداند | |
---|---|
boolean | درست است اگر چند کاربر پشتیبانی می شود، نادرست در غیر این صورت |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean isPackageInstalled (String packageName, String userId)
دستگاه را برای نام بسته معین و شناسه کاربری داده شده جستجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر.
مولفه های | |
---|---|
packageName | String : بسته ای که ما در حال بررسی آن هستیم که آیا نصب شده است. |
userId | String : شناسه کاربری که بسته را بررسی می کنیم برای آن نصب شده است. اگر null باشد، از کاربر اصلی صفر استفاده می شود. |
برمی گرداند | |
---|---|
boolean | درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean isPackageInstalled (String packageName)
دستگاه را برای یک نام بسته جستجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.
مولفه های | |
---|---|
packageName | String |
برمی گرداند | |
---|---|
boolean | درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean isUserRunning (int userId)
بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر.
مولفه های | |
---|---|
userId | int |
برمی گرداند | |
---|---|
boolean | اگر کاربر در حال اجرا باشد درست است، در سایر موارد نادرست است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean isUserSecondary (int userId)
آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر.
مولفه های | |
---|---|
userId | int |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر ثانویه باشد، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean isUserVisible (int userId)
بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر.
کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت ها را راه اندازی کند (معمولاً در صفحه نمایش پیش فرض).
مولفه های | |
---|---|
userId | int |
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstract boolean isUserVisibleOnDisplay (int userId, int displayId)
بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر.
کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت های خود را در آن نمایشگر راه اندازی کند.
مولفه های | |
---|---|
userId | int |
displayId | int |
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
نشان میدهد که آیا دستگاه به کاربران اجازه میدهد در پسزمینه در ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
قابل مشاهده باشند یا خیر.
اگر اینطور است، میتوانید startVisibleBackgroundUser(int, int, boolean)
را فراخوانی کنید و نمایشگری را ارسال کنید که توسط listDisplayIdsForStartingVisibleBackgroundUsers()
(که باید شامل ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
باشد).
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstract boolean isVisibleBackgroundUsersSupported ()
نشان می دهد که آیا دستگاه به کاربران اجازه می دهد در پس زمینه قابل مشاهده باشند یا خیر.
اگر اینطور است، می توانید startVisibleBackgroundUser(int, int, boolean)
را فراخوانی کنید و نمایشگری را که توسط listDisplayIdsForStartingVisibleBackgroundUsers()
برگردانده شده است، ارسال کنید.
برمی گرداند | |
---|---|
boolean |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstract boolean isWifiEnabled ()
تست کنید آیا وای فای فعال است یا خیر.
بررسی می کند که آیا وای فای در دستگاه فعال است یا خیر. برای اثبات وضعیت وای فای قبل از آزمایش هایی که نباید با وای فای اجرا شوند مفید است، به عنوان مثال آزمایش های داده تلفن همراه.
برمی گرداند | |
---|---|
boolean | true اگر وای فای فعال باشد. false در صورت غیرفعال بودن |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر ارتباط با دستگاه قطع شده و قابل بازیابی نیست. |
public abstractlistDisplayIds ()
لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید.
برمی گرداند | |
---|---|
لیست نمایشگرها پیش فرض همیشه نمایشگر پیش فرض 0 را برمی گرداند. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractlistDisplayIdsForStartingVisibleBackgroundUsers ()
لیستی از نمایشگرهایی را دریافت می کند که می توانند برای start a user visible in the background
استفاده شوند.
برمی گرداند | |
---|---|
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstractlistUsers ()
لیست کاربران دستگاه را دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException
پرتاب می کند.
برمی گرداند | |
---|---|
لیست شناسه های کاربر |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException |
public abstract boolean logBugreport (String dataName, ITestLogger listener)
روش کمکی برای گرفتن گزارش اشکال و ورود آن به خبرنگاران.
مولفه های | |
---|---|
dataName | String : نامی که گزارش اشکال تحت آن گزارش می شود. |
listener | ITestLogger : یک ITestLogger برای ثبت گزارش اشکال. |
برمی گرداند | |
---|---|
boolean | اگر ثبت با موفقیت انجام شد درست است، در غیر این صورت نادرست است. |
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
به دستگاه اطلاع دهید تا منتظر تکمیل snapuserd باشد.
مولفه های | |
---|---|
waitPhase | SnapuserdWaitPhase |
public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
IDeviceActionReceiver
را برای این دستگاه ثبت می کند.
همه IDeviceActionReceiver
های ثبت شده قبل از شروع یک اقدام دستگاه و پس از پایان عملکرد دستگاه مطلع خواهند شد.
مولفه های | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : یک IDeviceActionReceiver که ثبت خواهد شد. |
public abstract boolean removeAdmin (String componentName, int userId)
ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود true
برگردانید، در غیر این صورت false
.
مولفه های | |
---|---|
componentName | String : مدیر دستگاه که باید حذف شود. |
userId | int : کاربری که سرپرست دستگاه در آن زندگی می کند. |
برمی گرداند | |
---|---|
boolean | اگر موفقیت آمیز باشد درست است، در غیر این صورت نادرست. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract void removeOwners ()
تمام صاحبان پروفایل دستگاه موجود را با بهترین تلاش حذف کنید.
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract boolean removeUser (int userId)
یک کاربر داده شده را از دستگاه حذف کنید.
مولفه های | |
---|---|
userId | int : از کاربر برای حذف |
برمی گرداند | |
---|---|
boolean | درست است اگر ما در حذف کاربر موفق بودیم ، در غیر این صورت نادرست. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract boolean setDeviceOwner (String componentName, int userId)
یک مؤلفه مدیر دستگاه را به عنوان صاحب دستگاه در کاربر داده شده تنظیم کنید.
مولفه های | |
---|---|
componentName | String : مدیر دستگاه برای مالک دستگاه. |
userId | int : از کاربر که صاحب دستگاه در آن زندگی می کند. |
برمی گرداند | |
---|---|
boolean | درست است اگر موفق باشد ، در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract void setSetting (String namespace, String key, String value)
به setSetting(int, String, String, String)
مراجعه کنید و در کاربر سیستم انجام شود.
مولفه های | |
---|---|
namespace | String |
key | String |
value | String |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract void setSetting (int userId, String namespace, String key, String value)
مقدار تنظیم را به فضای نام یک کاربر خاص اضافه کنید. برخی از تنظیمات فقط پس از راه اندازی مجدد در دسترس خواهند بود. فضای نام باید یکی از: {"سیستم" ، "ایمن" ، "جهانی" باشد
مولفه های | |
---|---|
userId | int |
namespace | String |
key | String |
value | String |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract boolean startUser (int userId)
اگر در حال حاضر متوقف شود ، یک کاربر معین را در پس زمینه شروع می کند. اگر کاربر قبلاً در پس زمینه کار کند ، این روش یک NOOP است.
مولفه های | |
---|---|
userId | int : از کاربر برای شروع در پس زمینه |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر با موفقیت در پس زمینه شروع شود. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract boolean startUser (int userId, boolean waitFlag)
اگر در حال حاضر متوقف شود ، یک کاربر معین را در پس زمینه شروع می کند. اگر کاربر قبلاً در پس زمینه کار کند ، این روش یک NOOP است. امکان تهیه پرچم اضافی برای انتظار برای انجام کار وجود دارد.
مولفه های | |
---|---|
userId | int : از کاربر برای شروع در پس زمینه |
waitFlag | boolean : تا زمانی که کاربر شروع و قفل شود ، دستور را صبر می کند. |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر با موفقیت در پس زمینه شروع شود. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
یک کاربر داده شده را در پس زمینه شروع می کند ، که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه می دهد فعالیت هایی را در آن نمایشگر راه اندازی کند).
توجه: این دستور بررسی نمی کند که آیا کاربر وجود دارد ، نمایش در دسترس است ، device supports such feature
.
مولفه های | |
---|---|
userId | int : از کاربر برای شروع در پس زمینه |
displayId | int : نمایشگر برای شروع کاربر قابل مشاهده است |
waitFlag | boolean : تا زمانی که کاربر شروع و قفل شود ، دستور را صبر می کند. |
برمی گرداند | |
---|---|
boolean | true اگر کاربر با موفقیت در پس زمینه قابل مشاهده بود. |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
public abstract boolean stopUser (int userId)
یک کاربر خاص را متوقف می کند. اگر کاربر از قبل متوقف شود ، این روش NOOP است. نمی توان کاربر فعلی و سیستم را متوقف کرد.
مولفه های | |
---|---|
userId | int : از کاربر برای متوقف کردن. |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر با موفقیت متوقف شد. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
یک کاربر خاص را متوقف کنید. فراهم کردن پرچم های اضافی برای انتظار برای عملکرد و زور که کاربر را خاتمه می دهد. نمی توان کاربر فعلی و سیستم را متوقف کرد.
مولفه های | |
---|---|
userId | int : از کاربر برای متوقف کردن. |
waitFlag | boolean : این دستور را تا زمانی که کاربر متوقف شود صبر می کند. |
forceFlag | boolean : باعث می شود کاربر متوقف شود. |
برمی گرداند | |
---|---|
boolean | درست است اگر کاربر با موفقیت متوقف شد. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract boolean switchUser (int userId)
با یک زمان پیش فرض به یک کاربر دیگر بروید. switchUser(int, long)
.
مولفه های | |
---|---|
userId | int |
برمی گرداند | |
---|---|
boolean | اگر کاربر جدید با ارائه دهنده کاربر مطابقت داشته باشد ، درست است. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract boolean switchUser (int userId, long timeout)
به عنوان مهلت به عنوان مهلت ارائه شده به یک کاربر دیگر تغییر دهید. پس از موفقیت در تغییر کاربر ، تلاش برای غیرفعال کردن KeyGuard را انجام دهید.
مولفه های | |
---|---|
userId | int |
timeout | long : صبر کنید تا قبل از بازگشت کاذب برای کاربر سوئیچ انجام نشد. |
برمی گرداند | |
---|---|
boolean | اگر کاربر جدید با ارائه دهنده کاربر مطابقت داشته باشد ، درست است. در غیر این صورت نادرست است. |
پرتاب می کند | |
---|---|
| com.android.tradefed.device.devicenotavailableablexception |
DeviceNotAvailableException |
public abstract Bugreport takeBugreport ()
یک BugReport بگیرید و آن را درون یک شیء Bugreport
برگردانید تا آن را اداره کنید. در صورت بروز مسئله ، تهی را برگردانید. پرونده ارجاع شده در شیء BugReport باید از طریق Bugreport.close()
تمیز شود.
برمی گرداند | |
---|---|
Bugreport |
public abstract String uninstallPackage (String packageName)
بسته اندرویدی را از دستگاه حذف کنید.
مولفه های | |
---|---|
packageName | String : بسته اندرویدی برای حذف نصب |
برمی گرداند | |
---|---|
String | String با کد خطا یا در صورت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر اتصال با دستگاه از بین برود و قابل بازیابی نباشد. |
public abstract String uninstallPackageForUser (String packageName, int userId)
بسته اندرویدی را از دستگاه برای یک کاربر خاص حذف کنید.
مولفه های | |
---|---|
packageName | String : بسته اندرویدی برای حذف نصب |
userId | int : شناسه کاربر عدد صحیح برای حذف آن. |
برمی گرداند | |
---|---|
String | String با کد خطا یا در صورت null . |
پرتاب می کند | |
---|---|
DeviceNotAvailableException | اگر اتصال با دستگاه از بین برود و قابل بازیابی نباشد. |
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
در صورت انتظار ، صبر کنید تا Snapuserd تکمیل شود.
مولفه های | |
---|---|
currentPhase | SnapuserdWaitPhase |
پرتاب می کند | |
---|---|
DeviceNotAvailableException |
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2024-04-02 بهوقت ساعت هماهنگ جهانی.