کلاس های تو در تو |
---|
class | TestDevice.MicrodroidBuilder سازنده ای که برای ایجاد یک Microdroid TestDevice استفاده می شود. |
فیلدها |
---|
public static final String | DISMISS_KEYGUARD_CMD دستوراتی که می توان از آنها برای حذف صفحه کلید استفاده کرد. |
روش های عمومی |
---|
boolean | canSwitchToHeadlessSystemUser () برمیگرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر. |
boolean | clearErrorDialogs () سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید. |
int | createUser (String name) یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید. |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید |
int | createUser (String name, boolean guest, boolean ephemeral) یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید |
int | createUserNoThrow (String name) یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید. |
void | disableKeyguard () تلاش برای غیرفعال کردن محافظ صفحه کلید. |
boolean | doesFileExist (String deviceFilePath) روش کمکی برای تعیین وجود فایل روی دستگاه. |
boolean | doesFileExist (String deviceFilePath, int userId) روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر. |
File | dumpHeap (String process, String devicePath) سعی کنید پشته را از system_server تخلیه کنید. |
| getActiveApexes () اطلاعات مربوط به APEX های فعال شده در دستگاه را واکشی کنید. |
| getAllSettings (String namespace) جفت مقدار کلید فضای نام درخواستی را برگردانید. |
String | getAndroidId (int userId) شناسه android مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null. |
| getAndroidIds () یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید. |
PackageInfo | getAppPackageInfo (String packageName) اطلاعات مربوط به بسته نصب شده روی دستگاه را واکشی کنید. |
| getAppPackageInfos () اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید. |
InputStreamSource | getBugreport () گزارش اشکال را از دستگاه بازیابی می کند. |
InputStreamSource | getBugreportz () یک bugreportz را از دستگاه بازیابی می کند. |
DeviceFoldableState | getCurrentFoldableState () وضعیت تاشو فعلی دستگاه را برمیگرداند یا در صورت بروز برخی مشکلات، آن را خالی میکند. |
int | getCurrentUser () شناسه کاربر فعلی را برگردانید. |
| getFoldableStates () لیست حالت های تاشو را در دستگاه برمی گرداند. |
| getInstalledPackageNames () نام بسته های برنامه موجود در دستگاه را واکشی کنید. |
KeyguardControllerState | getKeyguardState () یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید. |
Integer | getMainUserId () شناسه اصلی کاربر را برمی گرداند. |
| getMainlineModuleInfo () اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید. |
int | getMaxNumberOfRunningUsersSupported () حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید. |
int | getMaxNumberOfUsersSupported () حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. |
Integer | getPrimaryUserId () شناسه کاربر اصلی را برمی گرداند. |
InputStreamSource | getScreenshot () یک اسکرین شات از دستگاه می گیرد. |
InputStreamSource | getScreenshot (String format, boolean rescale) یک اسکرین شات از دستگاه می گیرد. |
InputStreamSource | getScreenshot (String format) یک اسکرین شات از دستگاه می گیرد. |
InputStreamSource | getScreenshot (long displayId) یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد. |
String | getSetting (String namespace, String key) getSetting(int, String, String) ببینید و روی کاربر سیستم انجام شود. |
String | getSetting (int userId, String namespace, String key) مقدار تنظیمات درخواستی را برگردانید. |
| getUninstallablePackageNames () نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید. |
int | getUserFlags (int userId) پرچم های یک کاربر معین را پیدا کرده و برگردانید. |
| getUserInfos () نقشه useId به UserInfo را در دستگاه دریافت می کند. |
int | getUserSerialNumber (int userId) در صورت یافتن شماره سریال مرتبط به userId، در هر مورد دیگر -10000 را برگردانید. |
boolean | hasFeature (String feature) بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر. |
String | installPackage (File packageFile, boolean reinstall, String... extraArgs) بسته اندروید را روی دستگاه نصب کنید. |
String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) بسته اندروید را روی دستگاه نصب کنید. |
String | installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs) بسته اندروید را روی دستگاه نصب کنید. |
String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید. |
String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) یک بسته اندرویدی را برای یک کاربر خاص روی دستگاه نصب کنید. |
String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) |
String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) |
boolean | isAppEnumerationSupported () بررسی کنید که آیا پلتفرم روی دستگاه از شمارش برنامه پشتیبانی میکند یا خیر |
boolean | isHeadlessSystemUserMode () نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر. |
boolean | isMainUserPermanentAdmin () نشان می دهد که آیا کاربر اصلی یک سرپرست دائمی است و نمی توان آن را حذف کرد یا به وضعیت غیر سرپرست تنزل داد. |
boolean | isMultiUserSupported () تعیین می کند که آیا چند کاربر پشتیبانی می شود یا خیر. |
boolean | isPackageInstalled (String packageName) دستگاه را برای یک نام بسته جستجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر. |
boolean | isPackageInstalled (String packageName, String userId) دستگاه را برای نام بسته معین و شناسه کاربری داده شده جستجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر. |
boolean | isUserRunning (int userId) بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر. |
boolean | isUserSecondary (int userId) آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر. |
boolean | isUserVisible (int userId) بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () نشان میدهد که آیا دستگاه به کاربران اجازه میدهد در پسزمینه در ERROR(/java.android.view.Display#DEFAULT_DISPLAY) قابل مشاهده باشند یا خیر. |
boolean | isVisibleBackgroundUsersSupported () نشان می دهد که آیا دستگاه به کاربران اجازه می دهد در پس زمینه قابل مشاهده باشند یا خیر. |
| listDisplayIds () لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید. |
| listDisplayIdsForStartingVisibleBackgroundUsers () لیستی از نمایشگرهایی را دریافت می کند که می توانند برای start a user visible in the background استفاده شوند. |
| listUsers () لیست کاربران دستگاه را دریافت می کند. |
boolean | logBugreport (String dataName, ITestLogger listener) روش کمکی برای گرفتن گزارش اشکال و ورود آن به خبرنگاران. |
void | notifySnapuserd ( SnapuserdWaitPhase waitPhase) |
void | postInvocationTearDown (Throwable exception) مراحل اضافی برای پاکسازی مورد نیاز خاص دستگاه که پس از انجام فراخوانی اجرا می شود. |
boolean | removeAdmin (String componentName, int userId) ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود true برگردانید، در غیر این صورت false . |
void | removeOwners () همه دارندگان نمایه دستگاه موجود را با بهترین تلاش حذف کنید. |
boolean | removeUser (int userId) یک کاربر معین را از دستگاه حذف کنید. |
boolean | setDeviceOwner (String componentName, int userId) یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید. |
void | setSetting (String namespace, String key, String value) به setSetting(int, String, String, String) مراجعه کنید و در کاربر سیستم انجام شد. |
void | setSetting (int userId, String namespace, String key, String value) یک مقدار تنظیم به فضای نام یک کاربر معین اضافه کنید. |
void | shutdownMicrodroid ( ITestDevice microdroidDevice) در صورت وجود، دستگاه میکرودروئید را خاموش می کند. |
boolean | startUser (int userId) اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. |
boolean | startUser (int userId, boolean waitFlag) اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. |
boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) کاربر مشخصی را در پسزمینه شروع میکند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه میدهد فعالیتها را در آن نمایشگر راهاندازی کند). |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) یک کاربر معین را متوقف کنید. |
boolean | stopUser (int userId) یک کاربر معین را متوقف می کند. |
boolean | supportsMicrodroid () پیششرطهای اجرای microdroid را بررسی میکند. |
boolean | supportsMicrodroid (boolean protectedVm) پیششرطهای اجرای microdroid را بررسی میکند. |
boolean | switchUser (int userId) به userId دیگری با مهلت زمانی پیشفرض تغییر وضعیت دهید. |
boolean | switchUser (int userId, long timeout) به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید. |
Bugreport | takeBugreport () یک Bugreport بگیرید و آن را در یک شی Bugreport برمی گرداند تا آن را مدیریت کند. |
String | uninstallPackage (String packageName) یک بسته Android را از دستگاه حذف نصب کنید. |
String | uninstallPackageForUser (String packageName, int userId) یک بسته Android را برای یک کاربر خاص از دستگاه حذف نصب کنید. |
void | waitForSnapuserd ( SnapuserdWaitPhase currentPhase) |
فیلدها
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
دستوراتی که می توان از آنها برای حذف صفحه کلید استفاده کرد.
سازندگان عمومی
روش های عمومی
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
برمیگرداند که آیا مجاز است به کاربر SYSTEM بدون سر تغییر کند یا خیر.
clearErrorDialogs
public boolean clearErrorDialogs ()
سعی کنید هر گفتگوی خطای نمایش داده شده در رابط کاربری دستگاه را رد کنید.
برمی گرداند |
---|
boolean | true اگر هیچ گفتگویی وجود نداشته باشد یا گفتگوها با موفقیت پاک شوند. false در غیر این صورت |
createUser
public int createUser (String name)
یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
پارامترها |
---|
name | String : کاربر برای ایجاد در دستگاه |
برمی گرداند |
---|
int | عدد صحیح برای شناسه کاربری ایجاد شده |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
پارامترها |
---|
name | String : کاربر برای ایجاد در دستگاه |
guest | boolean : فعال کردن پرچم کاربر --guest در حین ایجاد |
ephemeral | boolean : در حین ایجاد، پرچم کاربر را فعال کنید |
forTesting | boolean : پرچم تست --برای آزمایش در حین ایجاد را فعال کنید |
برمی گرداند |
---|
int | شناسه کاربر ایجاد شده |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
یک کاربر با نام مشخص و پرچم های ارائه شده ایجاد کنید
پارامترها |
---|
name | String : کاربر برای ایجاد در دستگاه |
guest | boolean : فعال کردن پرچم کاربر --guest در حین ایجاد |
ephemeral | boolean : در حین ایجاد، پرچم کاربر را فعال کنید |
برمی گرداند |
---|
int | شناسه کاربر ایجاد شده |
createUserNoThrow
public int createUserNoThrow (String name)
یک کاربر با نام مشخص و پرچم های پیش فرض 0 ایجاد کنید.
پارامترها |
---|
name | String : کاربر برای ایجاد در دستگاه |
برمی گرداند |
---|
int | عدد صحیح برای شناسه کاربر ایجاد شده یا -1 برای خطا. |
غیرفعال کردن کیگارد
public void disableKeyguard ()
تلاش برای غیرفعال کردن محافظ صفحه کلید.
ابتدا منتظر بمانید تا ارسال ورودی آماده شود، این تقریباً همزمان با گزارش دستگاه BOOT_COMPLETE، ظاهراً ناهمزمان، اتفاق میافتد، زیرا پیادهسازی چارچوب فعلی دارای شرایط مسابقه گاه به گاه است. سپس دستور رد کردن صفحه کلید ارسال می شود (فقط روی موارد غیر ایمن کار می کند)
doesFileExist
public boolean doesFileExist (String deviceFilePath)
روش کمکی برای تعیین وجود فایل روی دستگاه.
پارامترها |
---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه برای بررسی |
برمی گرداند |
---|
boolean | true در صورت وجود فایل، false در غیر این صورت. |
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
روش کمکی برای تعیین اینکه آیا فایل روی دستگاه برای یک کاربر خاص وجود دارد یا خیر.
پارامترها |
---|
deviceFilePath | String : مسیر مطلق فایل روی دستگاه برای بررسی |
userId | int : شناسه کاربری که وجود فایل را با آن بررسی کنید |
برمی گرداند |
---|
boolean | true در صورت وجود فایل، false در غیر این صورت. |
dumpHeap
public File dumpHeap (String process,
String devicePath)
سعی کنید پشته را از system_server تخلیه کنید. این وظیفه تماس گیرنده است که فایل تخلیه شده را پاک کند.
پارامترها |
---|
process | String : نام فرآیند دستگاهی که باید روی آن تخلیه شود. |
devicePath | String : مسیر روی دستگاه که در آن روگرفت را قرار دهید. این باید مکانی باشد که مجوزها اجازه آن را می دهند. |
برمی گرداند |
---|
File | ERROR(/File) حاوی گزارش. اگر چیزی شکست خورده است. |
getActiveApexes
public getActiveApexes ()
اطلاعات مربوط به APEX های فعال شده در دستگاه را واکشی کنید.
getAllSettings
public getAllSettings (String namespace)
جفت مقدار کلید فضای نام درخواستی را برگردانید.
پارامترها |
---|
namespace | String : باید یکی از {"system"، "secure"، "global"} باشد. |
برمی گرداند |
---|
| نقشه جفت ارزش کلیدی اگر فضای نام پشتیبانی نشود، تهی است. |
getAndroidId
public String getAndroidId (int userId)
شناسه android مرتبط با userId را پیدا کرده و برگردانید، در صورت یافت نشدن آن null.
getAndroidIds
public getAndroidIds ()
یک نقشه از شناسه های اندرویدی که با شناسه های کاربر منطبق پیدا شده اند ایجاد کنید. هیچ بیمه ای وجود ندارد که هر شناسه کاربری یک شناسه اندروید مرتبط با این تابع را پیدا کند، بنابراین برخی از شناسه های کاربر ممکن است با null مطابقت داشته باشند.
برمی گرداند |
---|
| نقشه شناسه های اندروید، شناسه های کاربر منطبق را پیدا کرد. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
اطلاعات مربوط به بسته نصب شده روی دستگاه را واکشی کنید.
پارامترها |
---|
packageName | String |
getAppPackageInfos
public getAppPackageInfos ()
اطلاعات بسته های نصب شده روی دستگاه را واکشی کنید.
getBugreport
public InputStreamSource getBugreport ()
گزارش اشکال را از دستگاه بازیابی می کند.
اجرای این برای ادامه کار بر روی دستگاهی بدون sdcard (یا جایی که sdcard هنوز نصب نشده است) تضمین شده است.
getBugreportz
public InputStreamSource getBugreportz ()
یک bugreportz را از دستگاه بازیابی می کند. اشکال گزارش فرمت زیپ حاوی گزارش اشکال اصلی و سایر فایلهای گزارش است که برای اشکالزدایی مفید هستند.
فقط برای «نسخه adb» > 1.0.36 پشتیبانی می شود
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
وضعیت تاشو فعلی دستگاه را برمیگرداند یا در صورت بروز برخی مشکلات، آن را خالی میکند.
getCurrentUser
public int getCurrentUser ()
شناسه کاربر فعلی را برگردانید. در صورت بروز خطا 10000- را برگردانید.
getFoldableStates
public getFoldableStates ()
لیست حالت های تاشو را در دستگاه برمی گرداند. می توان با "cmd device_state print-states" به دست آورد.
getInstalledPackageNames
public getInstalledPackageNames ()
نام بسته های برنامه موجود در دستگاه را واکشی کنید.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
یک شی را برگردانید تا وضعیت فعلی صفحه کلید را دریافت کنید یا در صورت عدم پشتیبانی، null را دریافت کنید.
getMainUserId
public Integer getMainUserId ()
شناسه اصلی کاربر را برمی گرداند.
برمی گرداند |
---|
Integer | شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد null. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
اطلاعات مربوط به ماژول های خط اصلی نصب شده روی دستگاه را دریافت کنید.
برمی گرداند |
---|
| ERROR(/Set) ماژول های خط اصلی String که در حال حاضر روی دستگاه نصب شده اند. |
public int getMaxNumberOfRunningUsersSupported ()
حداکثر تعداد کاربرانی که به طور همزمان در حال اجرا هستند را دریافت کنید. پیشفرض 0 است.
برمی گرداند |
---|
int | یک عدد صحیح که تعداد کاربرانی که به طور همزمان در حال اجرا هستند را نشان می دهد |
public int getMaxNumberOfUsersSupported ()
حداکثر تعداد کاربران پشتیبانی شده را دریافت کنید. پیشفرض 0 است.
برمی گرداند |
---|
int | یک عدد صحیح که تعداد کاربران پشتیبانی شده را نشان می دهد |
getPrimaryUserId
public Integer getPrimaryUserId ()
شناسه کاربر اصلی را برمی گرداند.
برمی گرداند |
---|
Integer | شناسه کاربر اصلی در صورت وجود، و اگر کاربر اصلی وجود نداشته باشد، null. |
دریافت اسکرین شات
public InputStreamSource getScreenshot ()
یک اسکرین شات از دستگاه می گیرد.
دریافت اسکرین شات
public InputStreamSource getScreenshot (String format,
boolean rescale)
یک اسکرین شات از دستگاه می گیرد. توصیه می شود به جای آن getScreenshot(String)
با رمزگذاری JPEG برای اندازه کوچکتر استفاده کنید.
پارامترها |
---|
format | String : PNG، JPEG پشتیبانی می شود |
rescale | boolean : اگر اسکرین شات باید تغییر مقیاس داده شود تا اندازه تصویر حاصل کاهش یابد |
دریافت اسکرین شات
public InputStreamSource getScreenshot (String format)
یک اسکرین شات از دستگاه می گیرد. توصیه می شود برای اندازه کوچکتر از getScreenshot (فرمت) به جای کدگذاری JPEG استفاده کنید
پارامترها |
---|
format | String : PNG، JPEG پشتیبانی می شود |
دریافت اسکرین شات
public InputStreamSource getScreenshot (long displayId)
یک اسکرین شات از دستگاهی که شناسه نمایش داده شده را می گیرد. فرمت PNG است.
TODO: پیاده سازی های بالا را برای پشتیبانی از "قالب" و "مقیاس مجدد" گسترش دهید
پارامترها |
---|
displayId | long : شناسه نمایش صفحه برای گرفتن اسکرین شات از آن. |
getSetting
public String getSetting (String namespace,
String key)
getSetting(int, String, String)
ببینید و روی کاربر سیستم انجام شود.
پارامترها |
---|
namespace | String |
key | String |
getSetting
public String getSetting (int userId,
String namespace,
String key)
مقدار تنظیمات درخواستی را برگردانید. فضای نام باید یکی از موارد زیر باشد: {"system", "secure", "global"}
پارامترها |
---|
userId | int |
namespace | String |
key | String |
برمی گرداند |
---|
String | مقدار مربوط به فضای نام: کلید یک کاربر. اگر پیدا نشد، پوچ است. |
getUninstalablePackageNames
public getUninstallablePackageNames ()
نام بسته های برنامه را که می توان حذف نصب کرد واکشی کنید. این در حال حاضر به عنوان بسته های غیر سیستمی و بسته های سیستمی به روز شده تعریف می شود.
برمی گرداند |
---|
| ERROR(/Set) نامهای بسته String غیرقابل نصب که در حال حاضر روی دستگاه نصب شدهاند. |
getUserFlags
public int getUserFlags (int userId)
پرچم های یک کاربر معین را پیدا کرده و برگردانید. پرچمها در کلاس «android.content.pm.UserInfo» در پروژه منبع باز Android تعریف شدهاند.
برمی گرداند |
---|
int | پرچم های مرتبط با userId ارائه شده در صورت یافتن، -10000 در هر مورد دیگر. |
getUserInfos
public getUserInfos ()
نقشه useId به UserInfo
را در دستگاه دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException
پرتاب می کند.
برمی گرداند |
---|
| لیست اشیاء UserInfo |
getUserSerialNumber
public int getUserSerialNumber (int userId)
در صورت یافتن شماره سریال مرتبط به userId، در هر مورد دیگر -10000 را برگردانید.
دارای ویژگی
public boolean hasFeature (String feature)
بررسی کنید که آیا یک ویژگی در دستگاه موجود است یا خیر.
پارامترها |
---|
feature | String : کدام فرمت باید «feature: "یا" "مستقیم. |
برمی گرداند |
---|
boolean | اگر ویژگی پیدا شود درست است، در غیر این صورت نادرست است. |
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 . |
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 . |
installPackage
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
بسته اندروید را روی دستگاه نصب کنید.
توجه: فقط مواردی که نیاز به کنترل صریح اعطای مجوز زمان اجرا در زمان نصب دارند باید این تابع را فراخوانی کنند.
پارامترها |
---|
packageFile | File : فایل apk برای نصب |
certFile | File : true اگر نصب مجدد انجام شود |
reinstall | boolean : اگر همه مجوزهای زمان اجرا باید در زمان نصب داده شوند |
extraArgs | String : آرگومان های اضافی اختیاری برای ارسال. برای گزینههای موجود به «adb shell pm -h» مراجعه کنید. |
برمی گرداند |
---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
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 . |
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 . |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
پارامترها |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
پارامترها |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
پارامترها |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
پارامترها |
---|
packageFiles | |
reinstall | boolean |
userId | int |
extraArgs | String |
RemotePackages را نصب کنید
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
پارامترها |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
RemotePackages را نصب کنید
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
پارامترها |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
بررسی کنید که آیا پلتفرم روی دستگاه از شمارش برنامه پشتیبانی میکند یا خیر
برمی گرداند |
---|
boolean | اگر شمارش برنامه پشتیبانی شود درست است، در غیر این صورت نادرست است |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
نشان می دهد که آیا دستگاه از حالت کاربر سیستم بدون سر استفاده می کند یا خیر.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
نشان می دهد که آیا کاربر اصلی یک سرپرست دائمی است و نمی توان آن را حذف کرد یا به وضعیت غیر سرپرست تنزل داد.
isMultiUserSupported
public boolean isMultiUserSupported ()
تعیین می کند که آیا چند کاربر پشتیبانی می شود یا خیر.
برمی گرداند |
---|
boolean | درست است اگر چند کاربر پشتیبانی می شود، نادرست در غیر این صورت |
isPackageInstalled است
public boolean isPackageInstalled (String packageName)
دستگاه را برای یک نام بسته جستجو کنید تا بررسی کنید که آیا در حال حاضر نصب شده است یا خیر.
پارامترها |
---|
packageName | String |
برمی گرداند |
---|
boolean | درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است. |
isPackageInstalled است
public boolean isPackageInstalled (String packageName,
String userId)
دستگاه را برای نام بسته معین و شناسه کاربری داده شده جستجو کنید تا بررسی کنید که آیا در حال حاضر برای آن کاربر نصب شده است یا خیر.
پارامترها |
---|
packageName | String : بسته ای که ما در حال بررسی آن هستیم که آیا نصب شده است. |
userId | String : شناسه کاربری که بسته را بررسی می کنیم برای آن نصب شده است. اگر null باشد، از کاربر اصلی صفر استفاده خواهد شد. |
برمی گرداند |
---|
boolean | درست است اگر بسته به عنوان نصب شده گزارش شود. در غیر این صورت نادرست است. |
isUserRunning
public boolean isUserRunning (int userId)
بررسی کنید که آیا یک کاربر مشخص در حال اجرا است یا خیر.
برمی گرداند |
---|
boolean | اگر کاربر در حال اجرا باشد درست است، در سایر موارد نادرست است. |
isUserSecondary
public boolean isUserSecondary (int userId)
آیا کاربر مشخص شده با توجه به پرچم های آن کاربر ثانویه است یا خیر.
برمی گرداند |
---|
boolean | درست است اگر کاربر ثانویه باشد، در غیر این صورت نادرست است. |
isUserVisible
public boolean isUserVisible (int userId)
بررسی می کند که آیا کاربر داده شده قابل مشاهده است یا خیر.
کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت ها را راه اندازی کند (معمولاً در صفحه نمایش پیش فرض).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
بررسی می کند که آیا کاربر داده شده در صفحه نمایش داده شده قابل مشاهده است یا خیر.
کاربر "مرئی" کاربری است که با کاربر "انسان" در تعامل است و از این رو می تواند فعالیت های خود را در آن نمایشگر راه اندازی کند.
پارامترها |
---|
userId | int |
displayId | int |
listDisplayIds
public listDisplayIds ()
لیستی از شناسه نمایشگرهای موجود در دستگاه را که توسط "dumpsys SurfaceFlinger" گزارش شده است، جمع آوری کنید.
برمی گرداند |
---|
| لیست نمایشگرها پیش فرض همیشه نمایشگر پیش فرض 0 را برمی گرداند. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
لیستی از نمایشگرهایی را دریافت می کند که می توانند برای start a user visible in the background
استفاده شوند.
لیست کاربران
public listUsers ()
لیست کاربران دستگاه را دریافت می کند. اگر خروجی از دستگاه مطابق انتظار نباشد، DeviceRuntimeException
پرتاب می کند.
برمی گرداند |
---|
| لیست شناسه های کاربر |
گزارش logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
روش کمکی برای گرفتن گزارش اشکال و ورود آن به خبرنگاران.
پارامترها |
---|
dataName | String : نامی که گزارش اشکال تحت آن گزارش می شود. |
listener | ITestLogger : یک ITestLogger برای ثبت گزارش اشکال. |
برمی گرداند |
---|
boolean | اگر ثبت با موفقیت انجام شد درست است، در غیر این صورت نادرست است. |
اطلاع رسانی به اسناپوسرد
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
پارامترها |
---|
waitPhase | SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
مراحل اضافی برای پاکسازی مورد نیاز خاص دستگاه که پس از انجام فراخوانی اجرا می شود.
پارامترها |
---|
exception | Throwable : در صورت وجود، آخرین استثنا ناشی از شکست فراخوانی. |
حذف ادمین
public boolean removeAdmin (String componentName,
int userId)
ادمین دستگاه داده شده را در کاربر مشخص حذف کنید و اگر موفقیت آمیز بود true
برگردانید، در غیر این صورت false
.
پارامترها |
---|
componentName | String : مدیر دستگاه که باید حذف شود. |
userId | int : کاربری که سرپرست دستگاه در آن زندگی می کند. |
برمی گرداند |
---|
boolean | اگر موفقیت آمیز باشد درست است، در غیر این صورت نادرست. |
حذف مالکان
public void removeOwners ()
همه دارندگان نمایه دستگاه موجود را با بهترین تلاش حذف کنید.
removeUser
public boolean removeUser (int userId)
یک کاربر معین را از دستگاه حذف کنید.
پارامترها |
---|
userId | int : کاربر برای حذف |
برمی گرداند |
---|
boolean | درست است اگر در حذف کاربر موفق بودیم، در غیر این صورت نادرست است. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
یک جزء سرپرست دستگاه را به عنوان مالک دستگاه در کاربر مشخص تنظیم کنید.
پارامترها |
---|
componentName | String : مدیر دستگاه که مالک دستگاه باشد. |
userId | int : کاربری که صاحب دستگاه در آن زندگی می کند. |
برمی گرداند |
---|
boolean | اگر موفقیت آمیز باشد درست است، در غیر این صورت نادرست. |
setSetting
public void setSetting (String namespace,
String key,
String value)
به setSetting(int, String, String, String)
مراجعه کنید و در کاربر سیستم انجام شد.
پارامترها |
---|
namespace | String |
key | String |
value | String |
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)
یک مقدار تنظیم به فضای نام یک کاربر معین اضافه کنید. برخی از تنظیمات فقط پس از راه اندازی مجدد در دسترس خواهند بود. فضای نام باید یکی از موارد زیر باشد: {"system", "secure", "global"}
پارامترها |
---|
userId | int |
namespace | String |
key | String |
value | String |
خاموش کردن میکرودروید
public void shutdownMicrodroid (ITestDevice microdroidDevice)
در صورت وجود، دستگاه میکرودروید را خاموش می کند.
پارامترها |
---|
microdroidDevice | ITestDevice |
startUser
public boolean startUser (int userId)
اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. اگر کاربر قبلاً در پسزمینه اجرا میشود، این روش یک NOOP است.
پارامترها |
---|
userId | int : کاربر برای شروع در پس زمینه |
برمی گرداند |
---|
boolean | درست است اگر کاربر با موفقیت در پسزمینه راهاندازی شده باشد. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
اگر کاربر در حال حاضر متوقف شده باشد، کاربر مشخصی را در پسزمینه راهاندازی میکند. اگر کاربر قبلاً در پسزمینه اجرا میشود، این روش یک NOOP است. امکان ارائه پرچم اضافی برای منتظر ماندن برای تأثیرگذاری عملیات.
پارامترها |
---|
userId | int : کاربر برای شروع در پس زمینه |
waitFlag | boolean : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند. |
برمی گرداند |
---|
boolean | درست است اگر کاربر با موفقیت در پسزمینه راهاندازی شده باشد. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
کاربر مشخصی را در پسزمینه شروع میکند که در صفحه نمایش داده شده قابل مشاهده است (یعنی به کاربر اجازه میدهد فعالیتها را در آن نمایشگر راهاندازی کند).
توجه: این دستور بررسی نمی کند که آیا کاربر وجود دارد، نمایشگر موجود است، device supports such feature
و غیره.
پارامترها |
---|
userId | int : کاربر برای شروع در پس زمینه |
displayId | int : نمایش برای شروع قابل مشاهده کاربر |
waitFlag | boolean : دستور را مجبور می کند تا زمانی که کاربر راه اندازی شده و قفل آن باز شود منتظر بماند. |
برمی گرداند |
---|
boolean | true اگر کاربر با موفقیت شروع به کار کرده باشد در پس زمینه قابل مشاهده است. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
یک کاربر معین را متوقف کنید. امکان ارائه پرچمهای اضافی برای منتظر ماندن برای تأثیرگذاری عملیات و خاتمه اجباری کاربر. کاربر فعلی و سیستم را نمی توان متوقف کرد.
پارامترها |
---|
userId | int : کاربر برای توقف. |
waitFlag | boolean : فرمان را منتظر می ماند تا کاربر متوقف شود. |
forceFlag | boolean : کاربر را مجبور به توقف می کند. |
برمی گرداند |
---|
boolean | درست است اگر کاربر با موفقیت متوقف شود. |
stopUser
public boolean stopUser (int userId)
یک کاربر معین را متوقف می کند. اگر کاربر قبلا متوقف شده باشد، این روش یک NOOP است. کاربر فعلی و سیستم را نمی توان متوقف کرد.
پارامترها |
---|
userId | int : کاربر برای توقف. |
برمی گرداند |
---|
boolean | درست است اگر کاربر با موفقیت متوقف شود. |
از میکرودروید پشتیبانی می کند
public boolean supportsMicrodroid ()
پیششرطهای اجرای میکرودروئید را بررسی میکند.
برمی گرداند |
---|
boolean | اگر پیششرطها برآورده شوند true و در غیر این صورت false برمیگرداند. |
از میکرودروید پشتیبانی می کند
public boolean supportsMicrodroid (boolean protectedVm)
پیششرطهای اجرای microdroid را بررسی میکند.
پارامترها |
---|
protectedVm | boolean : درست است اگر microdroid برای اجرا در VM محافظت شده در نظر گرفته شده باشد. |
برمی گرداند |
---|
boolean | اگر پیششرطها برآورده شوند true و در غیر این صورت false برمیگرداند. |
switchUser
public boolean switchUser (int userId)
به userId دیگری با مهلت زمانی پیشفرض تغییر وضعیت دهید. switchUser(int, long)
.
برمی گرداند |
---|
boolean | اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است. |
switchUser
public boolean switchUser (int userId,
long timeout)
به شناسه کاربری دیگری با مهلت زمانی ارائه شده به عنوان مهلت تغییر دهید. پس از موفقیت آمیز بودن تغییر کاربر، محافظ صفحه کلید را غیرفعال کنید.
پارامترها |
---|
userId | int |
timeout | long : منتظر ماندن قبل از بازگشت false برای سوئیچ کاربر ناموفق بود. |
برمی گرداند |
---|
boolean | اگر شناسه کاربری جدید با ارائه دهنده شناسه کاربر مطابقت داشته باشد، درست است. در غیر این صورت نادرست است. |
takeBugreport
public Bugreport takeBugreport ()
یک Bugreport بگیرید و آن را در یک شی Bugreport
برمی گرداند تا آن را مدیریت کند. در صورت مشکل، باطل برگردانید. فایل ارجاع شده در شی Bugreport باید از طریق Bugreport.close()
پاک شود.
UninstallPackage
public String uninstallPackage (String packageName)
یک بسته Android را از دستگاه حذف نصب کنید.
پارامترها |
---|
packageName | String : بسته Android برای حذف نصب |
برمی گرداند |
---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
یک بسته Android را برای یک کاربر خاص از دستگاه حذف نصب کنید.
پارامترها |
---|
packageName | String : بسته Android برای حذف نصب |
userId | int : شناسه کاربری عدد صحیح برای حذف نصب. |
برمی گرداند |
---|
String | یک String با کد خطا، یا در صورت موفقیت null . |
منتظر اسناپوسرد باشید
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
پارامترها |
---|
currentPhase | SnapuserdWaitPhase |
روش های محافظت شده
createParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
یک راه اندازی مجدد adb انجام دهید.
پارامترها |
---|
rebootMode | NativeDevice.RebootMode : حالتی از این راهاندازی مجدد. |
reason | String : برای این راه اندازی مجدد. |
getBugreportzInternal
protected File getBugreportzInternal ()
روش Internal Helper برای دریافت فایل zip bugreportz به صورت ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
در معرض آزمایش قرار گرفته است.
getHostCurrentTime
protected long getHostCurrentTime ()
در معرض آزمایش قرار گرفته است
prePostBootSetup
protected void prePostBootSetup ()
به هر نوع دستگاه (AndroidNativeDevice، TestDevice) اجازه میدهد این روش را برای راهاندازی خاص پس از بوت لغو کند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2024-09-24 بهوقت ساعت هماهنگ جهانی.
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"اطلاعاتی که نیاز دارم وجود ندارد"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"بیشازحد پیچیده/ مراحل بسیار زیاد"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"قدیمی"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"مشکل ترجمه"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشکل کد / نمونهها"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غیره"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"درک آسان"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"مشکلم را برطرف کرد"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غیره"
}]
{"lastModified": "\u062a\u0627\u0631\u06cc\u062e \u0622\u062e\u0631\u06cc\u0646 \u0628\u0647\u200c\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06cc 2024-09-24 \u0628\u0647\u200c\u0648\u0642\u062a \u0633\u0627\u0639\u062a \u0647\u0645\u0627\u0647\u0646\u06af \u062c\u0647\u0627\u0646\u06cc."}
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2024-09-24 بهوقت ساعت هماهنگ جهانی."]]