فئات متداخلة |
---|
class | TestDevice.MicrodroidBuilder منشئ يستخدم لإنشاء Microdroid TestDevice. |
مجالات |
---|
public static final String | DISMISS_KEYGUARD_CMD الأوامر التي يمكن استخدامها لرفض حارس المفاتيح. |
الأساليب العامة |
---|
boolean | canSwitchToHeadlessSystemUser () إرجاع ما إذا كان مسموحًا بالانتقال إلى مستخدم النظام بدون رأس. |
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 () إحضار المعلومات حول APEXes التي تم تنشيطها على الجهاز. |
| getAllSettings (String namespace) إرجاع أزواج قيمة المفتاح لمساحة الاسم المطلوبة. |
String | getAndroidId (int userId) ابحث عن معرف android المرتبط بمعرّف المستخدم وأعده ، ويكون فارغًا إذا لم يتم العثور عليه. |
| getAndroidIds () قم بإنشاء خريطة لمعرفات android التي تم العثور عليها مطابقة لمعرفات المستخدم. |
PackageInfo | getAppPackageInfo (String packageName) إحضار معلومات حول حزمة مثبتة على الجهاز. |
| getAppPackageInfos () إحضار معلومات الحزم المثبتة على الجهاز. |
InputStreamSource | getBugreport () يسترجع تقرير خطأ من الجهاز. |
InputStreamSource | getBugreportz () يسترجع تقرير الأخطاء من الجهاز. |
DeviceFoldableState | getCurrentFoldableState () تُرجع الحالة القابلة للطي الحالية للجهاز أو تُرجع فارغة في حالة حدوث بعض المشكلات. |
int | getCurrentUser () إرجاع معرف المستخدم الحالي قيد التشغيل. |
| getFoldableStates () يُرجع قائمة الحالات القابلة للطي على الجهاز. |
| getInstalledPackageNames () إحضار أسماء حزم التطبيقات الموجودة على الجهاز. |
KeyguardControllerState | getKeyguardState () قم بإرجاع كائن للحصول على الحالة الحالية لحارس المفاتيح أو فارغ إذا لم يكن مدعومًا. |
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 () يحصل على خريطة معرف الاستخدام UserInfo على الجهاز. |
int | getUserSerialNumber (int userId) قم بإرجاع الرقم التسلسلي المرتبط بمعرف المستخدم إذا وجد ، -10000 في أي حالات أخرى. |
boolean | hasFeature (String feature) تحقق مما إذا كانت الميزة متاحة على الجهاز. |
String | installPackage (File packageFile, boolean reinstall, String... extraArgs) قم بتثبيت حزمة Android على الجهاز. |
String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) قم بتثبيت حزمة Android على الجهاز. |
String | installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs) قم بتثبيت حزمة Android على الجهاز. |
String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) قم بتثبيت حزمة Android على الجهاز لمستخدم معين. |
String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) قم بتثبيت حزمة Android على الجهاز لمستخدم معين. |
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 | 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) يقوم بإيقاف تشغيل جهاز microdroid ، إن وجد. |
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) قم بالتبديل إلى معرف مستخدم آخر بمهلة افتراضية. |
boolean | switchUser (int userId, long timeout) قم بالتبديل إلى معرف مستخدم آخر مع انتهاء المهلة المحددة كموعد نهائي. |
Bugreport | takeBugreport () خذ تقرير خطأ وأعده داخل كائن Bugreport للتعامل معه. |
String | uninstallPackage (String packageName) قم بإلغاء تثبيت حزمة Android من الجهاز. |
String | uninstallPackageForUser (String packageName, int userId) قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين. |
مجالات
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
الأوامر التي يمكن استخدامها لرفض حارس المفاتيح.
المنشئون العامة
الأساليب العامة
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
إرجاع ما إذا كان مسموحًا بالانتقال إلى مستخدم النظام بدون رأس.
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 : تمكين إشارة المستخدم أثناء الإنشاء |
ephemeral | boolean : تمكين علامة المستخدم - الرمز الشخصي أثناء الإنشاء |
forTesting | boolean : تمكين علامة الاختبار - للاختبار أثناء الإنشاء |
عائدات |
---|
int | معرف المستخدم الذي تم إنشاؤه |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
قم بإنشاء مستخدم باسم معين والعلامات المقدمة
حدود |
---|
name | String : للمستخدم الذي سيتم إنشاؤه على الجهاز |
guest | boolean : تمكين إشارة المستخدم أثناء الإنشاء |
ephemeral | boolean : تمكين علامة المستخدم - الرمز الشخصي أثناء الإنشاء |
عائدات |
---|
int | معرف المستخدم الذي تم إنشاؤه |
createUserNoThrow
public int createUserNoThrow (String name)
قم بإنشاء مستخدم باسم معين وعلامات افتراضية 0.
حدود |
---|
name | String : للمستخدم الذي سيتم إنشاؤه على الجهاز |
عائدات |
---|
int | العدد الصحيح لمعرف المستخدم الذي تم إنشاؤه أو -1 للخطأ. |
تعطيل Keyguard
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 بخلاف ذلك. |
كومة
public File dumpHeap (String process,
String devicePath)
محاولة تفريغ الكومة من system_server. تقع على عاتق المتصل مسؤولية تنظيف الملف الملغى.
حدود |
---|
process | String : اسم عملية الجهاز المراد dumpheap تشغيلها. |
devicePath | String : المسار الموجود على الجهاز حيث يتم وضع التفريغ. يجب أن يكون هذا موقعًا تسمح به الأذونات. |
عائدات |
---|
File | ERROR(/File) الذي يحتوي على التقرير. لاغية إذا فشل شيء ما. |
getActiveApexes
public getActiveApexes ()
إحضار المعلومات حول APEXes التي تم تنشيطها على الجهاز.
getAllSettings
public getAllSettings (String namespace)
إرجاع أزواج قيمة المفتاح لمساحة الاسم المطلوبة.
حدود |
---|
namespace | String : يجب أن تكون واحدة من {"النظام" ، "الآمن" ، "العالمي"} |
عائدات |
---|
| خريطة أزواج القيمة الرئيسية. خالية إذا لم يتم دعم مساحة الاسم. |
getAndroidId
public String getAndroidId (int userId)
ابحث عن معرف android المرتبط بمعرّف المستخدم وأعده ، ويكون فارغًا إذا لم يتم العثور عليه.
getAndroidIds
public getAndroidIds ()
قم بإنشاء خريطة لمعرفات android التي تم العثور عليها مطابقة لمعرفات المستخدم. لا يوجد تأمين على أن كل معرف مستخدم سيجد معرف android مرتبطًا بهذه الوظيفة ، لذلك قد تتطابق بعض معرفات المستخدم مع قيمة خالية.
عائدات |
---|
| تم العثور على خريطة معرفات android متطابقة مع معرفات المستخدم. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
إحضار معلومات حول حزمة مثبتة على الجهاز.
getAppPackageInfos
public getAppPackageInfos ()
إحضار معلومات الحزم المثبتة على الجهاز.
getBugreport
public InputStreamSource getBugreport ()
يسترجع تقرير خطأ من الجهاز.
تنفيذ هذا مضمون لمواصلة العمل على جهاز بدون بطاقة sdcard (أو حيث لم يتم تركيب بطاقة sdcard بعد).
getBugreportz
public InputStreamSource getBugreportz ()
يسترجع تقرير الأخطاء من الجهاز. يحتوي تقرير الأخطاء بتنسيق Zip على تقرير الأخطاء الرئيسي وملفات السجل الأخرى المفيدة لتصحيح الأخطاء.
مدعوم فقط لـ "إصدار adb"> 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
تُرجع الحالة القابلة للطي الحالية للجهاز أو تُرجع فارغة في حالة حدوث بعض المشكلات.
getCurrentUser
public int getCurrentUser ()
إرجاع معرف المستخدم الحالي قيد التشغيل. في حالة حدوث خطأ ، قم بإرجاع -10000.
getFoldableStates
public getFoldableStates ()
يُرجع قائمة الحالات القابلة للطي على الجهاز. يمكن الحصول عليها باستخدام "حالات الطباعة cmd device_state".
getInstalledPackageNames
public getInstalledPackageNames ()
إحضار أسماء حزم التطبيقات الموجودة على الجهاز.
getKeyguardState
public KeyguardControllerState getKeyguardState ()
قم بإرجاع كائن للحصول على الحالة الحالية لحارس المفاتيح أو فارغ إذا لم يكن مدعومًا.
getMainUserId
public Integer getMainUserId ()
إرجاع معرف المستخدم الرئيسي.
عائدات |
---|
Integer | معرف المستخدم للمستخدم الرئيسي إذا كان هناك واحد ، وخالٍ إذا لم يكن هناك مستخدم رئيسي. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
احصل على معلومات حول وحدات الخط الرئيسي المثبتة على الجهاز.
public int getMaxNumberOfRunningUsersSupported ()
احصل على أكبر عدد ممكن من المستخدمين الذين يعملون في نفس الوقت. افتراضات على 0.
عائدات |
---|
int | عدد صحيح يشير إلى عدد المستخدمين قيد التشغيل في وقت واحد |
public int getMaxNumberOfUsersSupported ()
احصل على أقصى عدد من المستخدمين المدعومين. افتراضات على 0.
عائدات |
---|
int | عدد صحيح يشير إلى عدد المستخدمين المدعومين |
getPrimaryUserId
public Integer getPrimaryUserId ()
إرجاع معرف المستخدم الأساسي.
عائدات |
---|
Integer | معرف المستخدم للمستخدم الأساسي إذا كان هناك واحد ، وخالٍ إذا لم يكن هناك مستخدم أساسي. |
الحصول على لقطة شاشة
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)
إرجاع قيمة الإعداد المطلوب. يجب أن تكون مساحة الاسم واحدة من: {"نظام" ، "آمن" ، "عالمي"}
حدود |
---|
userId | int |
namespace | String |
key | String |
عائدات |
---|
String | القيمة المرتبطة بمساحة الاسم: مفتاح المستخدم. لاغية إذا لم يتم العثور عليها. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. يتم تعريف هذا حاليًا على أنه حزم غير متعلقة بالنظام وحزم النظام المحدثة.
getUserFlags
public int getUserFlags (int userId)
ابحث عن أعلام مستخدم معين وقم بإعادتها. يتم تحديد العلامات في فئة "android.content.pm.UserInfo" في مشروع Android مفتوح المصدر.
عائدات |
---|
int | العلامات المرتبطة بـ userId المقدمة إن وجدت ، -10000 في أي حالات أخرى. |
getUserInfos
public getUserInfos ()
يحصل على خريطة معرف الاستخدام UserInfo
على الجهاز. سيتم طرح DeviceRuntimeException
إذا لم يكن الإخراج من الجهاز كما هو متوقع.
عائدات |
---|
| قائمة كائنات معلومات المستخدم. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
قم بإرجاع الرقم التسلسلي المرتبط بمعرف المستخدم إذا وجد ، -10000 في أي حالات أخرى.
ميزة
public boolean hasFeature (String feature)
تحقق مما إذا كانت الميزة متاحة على الجهاز.
حدود |
---|
feature | String : أي تنسيق يجب أن يكون "feature: " أو " " مباشرة. |
عائدات |
---|
boolean | صحيح إذا تم العثور على ميزة ، خطأ إذا كان العكس. |
ثبت المجموعة
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
قم بتثبيت حزمة Android على الجهاز.
حدود |
---|
packageFile | File : ملف apk للتثبيت |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
extraArgs | String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة. |
ثبت المجموعة
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
قم بتثبيت حزمة Android على الجهاز.
ملاحظة: فقط حالات الاستخدام التي تتطلب تحكمًا صريحًا لمنح إذن وقت التشغيل في وقت التثبيت يجب أن تستدعي هذه الوظيفة.
حدود |
---|
packageFile | File : ملف apk للتثبيت |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
grantPermissions | boolean : إذا كان يجب منح جميع أذونات وقت التشغيل في وقت التثبيت |
extraArgs | String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة. |
ثبت المجموعة
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
قم بتثبيت حزمة Android على الجهاز.
ملاحظة: فقط حالات الاستخدام التي تتطلب تحكمًا صريحًا لمنح إذن وقت التشغيل في وقت التثبيت يجب أن تستدعي هذه الوظيفة.
حدود |
---|
packageFile | File : ملف apk للتثبيت |
certFile | File : true إذا كان يجب إجراء إعادة التثبيت |
reinstall | boolean : إذا كان يجب منح جميع أذونات وقت التشغيل في وقت التثبيت |
extraArgs | String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
قم بتثبيت حزمة Android على الجهاز لمستخدم معين.
ملاحظة: فقط حالات الاستخدام التي تتطلب تحكمًا صريحًا لمنح إذن وقت التشغيل في وقت التثبيت يجب أن تستدعي هذه الوظيفة.
حدود |
---|
packageFile | File : ملف apk للتثبيت |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
grantPermissions | boolean : إذا كان يجب منح جميع أذونات وقت التشغيل في وقت التثبيت |
userId | int : معرف المستخدم الصحيح للتثبيت من أجل. |
extraArgs | String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
قم بتثبيت حزمة Android على الجهاز لمستخدم معين.
حدود |
---|
packageFile | File : ملف apk للتثبيت |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
userId | int : معرف المستخدم الصحيح للتثبيت من أجل. |
extraArgs | String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة. |
تثبيت الحزم
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
حدود |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
تثبيت الحزم
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 |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
حدود |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
حدود |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
هو التطبيق التعداد المدعوم
public boolean isAppEnumerationSupported ()
تحقق مما إذا كان النظام الأساسي على الجهاز يدعم تعداد التطبيقات
عائدات |
---|
boolean | صحيح إذا كان تعداد التطبيق مدعومًا ، أو خطأ إذا كان خلاف ذلك |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
يُرجع ما إذا كان الجهاز يستخدم وضع مستخدم نظام مقطوعة الرأس.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
لعرض ما إذا كان المستخدم الرئيسي مسؤولًا دائمًا ولا يمكن حذفه أو الرجوع إلى حالة غير المسؤول.
isMultiUserSupported
public boolean isMultiUserSupported ()
يحدد ما إذا كان يتم دعم تعدد المستخدمين.
عائدات |
---|
boolean | صواب إذا تم دعم عدة مستخدمين ، خطأ بخلاف ذلك |
isPackage مثبت
public boolean isPackageInstalled (String packageName)
استعلم عن اسم الحزمة المعطى للجهاز للتحقق مما إذا كان مثبتًا حاليًا أم لا.
عائدات |
---|
boolean | صحيح إذا تم الإبلاغ عن الحزمة على أنها مثبتة. خطأ خلاف ذلك. |
isPackage مثبت
public boolean isPackageInstalled (String packageName,
String userId)
استعلم عن الجهاز عن اسم حزمة معين ومعرف المستخدم المحدد للتحقق مما إذا كان مثبتًا حاليًا أم لا لهذا المستخدم.
حدود |
---|
packageName | String : الحزمة التي نتحقق من تثبيتها. |
userId | String : معرف المستخدم الذي نتحقق من الحزمة مثبت من أجله. إذا كانت القيمة خالية ، فسيتم استخدام الصفر الأساسي للمستخدم. |
عائدات |
---|
boolean | صحيح إذا تم الإبلاغ عن الحزمة على أنها مثبتة. خطأ خلاف ذلك. |
قيد التشغيل
public boolean isUserRunning (int userId)
تحقق مما إذا كان مستخدم معين قيد التشغيل.
عائدات |
---|
boolean | صحيح إذا كان المستخدم يعمل ، خطأ في كل الحالات الأخرى. |
isUserSecondary
public boolean isUserSecondary (int userId)
قم بإرجاع ما إذا كان المستخدم المحدد مستخدمًا ثانويًا وفقًا لعلامته.
عائدات |
---|
boolean | صواب إذا كان المستخدم ثانويًا ، أو خطأ بخلاف ذلك. |
غير مرئي
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
.
listUsers
public listUsers ()
يحصل على قائمة المستخدمين على الجهاز. سيتم طرح DeviceRuntimeException
إذا لم يكن الإخراج من الجهاز كما هو متوقع.
عائدات |
---|
| قائمة هويات المستخدمين. |
تسجيل الدخول
public boolean logBugreport (String dataName,
ITestLogger listener)
طريقة مساعدة لأخذ تقرير خطأ وتسجيله للمراسلين.
حدود |
---|
dataName | String : الاسم الذي سيتم الإبلاغ عن تقرير الخطأ تحته. |
listener | ITestLogger : ITestLogger لتسجيل تقرير الخطأ. |
عائدات |
---|
boolean | صحيح إذا كان التسجيل ناجحًا ، أو خطأ إذا كان العكس. |
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 ()
قم بإزالة جميع مالكي ملفات تعريف الجهاز الحاليين بأفضل جهد.
إزالة المستخدم
public boolean removeUser (int userId)
إزالة مستخدم معين من الجهاز.
حدود |
---|
userId | int : للمستخدم المراد إزالته |
عائدات |
---|
boolean | صحيح إذا نجحنا في إزالة المستخدم ، وخطأ بخلاف ذلك. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
قم بتعيين مكون مسؤول الجهاز كمالك للجهاز في مستخدم معين.
حدود |
---|
componentName | String : من مشرف الجهاز ليكون مالك الجهاز. |
userId | int : للمستخدم الذي يعيش فيه مالك الجهاز. |
عائدات |
---|
boolean | صحيح إذا كان ناجحًا ، وخطئًا على خلاف ذلك. |
ضبط
public void setSetting (int userId,
String namespace,
String key,
String value)
أضف قيمة الإعداد إلى مساحة الاسم لمستخدم معين. لن تكون بعض الإعدادات متاحة إلا بعد إعادة التشغيل. يجب أن تكون مساحة الاسم واحدة من: {"نظام" ، "آمن" ، "عالمي"}
حدود |
---|
userId | int |
namespace | String |
key | String |
value | String |
الاغلاق
public void shutdownMicrodroid (ITestDevice microdroidDevice)
يقوم بإيقاف تشغيل جهاز microdroid ، إن وجد.
حدود |
---|
microdroidDevice | ITestDevice |
بدء المستخدم
public boolean startUser (int userId)
يبدأ مستخدمًا معينًا في الخلفية إذا تم إيقافه حاليًا. إذا كان المستخدم يعمل بالفعل في الخلفية ، فهذه الطريقة هي NOOP.
حدود |
---|
userId | int : للمستخدم للبدء في الخلفية |
عائدات |
---|
boolean | صحيح إذا كان المستخدم قد بدأ بنجاح في الخلفية. |
بدء المستخدم
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 ()
يتحقق من الشروط المسبقة لتشغيل microdroid.
عائدات |
---|
boolean | يعود صحيحًا إذا تم استيفاء الشروط المسبقة ، خطأ في الحالات الأخرى. |
يدعم
public boolean supportsMicrodroid (boolean protectedVm)
يتحقق من الشروط المسبقة لتشغيل microdroid.
حدود |
---|
protectedVm | boolean : صحيح إذا كان microdroid يهدف إلى التشغيل على جهاز افتراضي محمي. |
عائدات |
---|
boolean | يعود صحيحًا إذا تم استيفاء الشروط المسبقة ، خطأ في الحالات الأخرى. |
تغير المستخدم
public boolean switchUser (int userId)
قم بالتبديل إلى معرف مستخدم آخر بمهلة افتراضية. switchUser(int, long)
.
عائدات |
---|
boolean | صواب إذا تطابق معرف المستخدم الجديد مع موفر معرف المستخدم. خطأ خلاف ذلك. |
تغير المستخدم
public boolean switchUser (int userId,
long timeout)
قم بالتبديل إلى معرف مستخدم آخر مع انتهاء المهلة المحددة كموعد نهائي. محاولة تعطيل حماية المفاتيح بعد نجاح تغيير المستخدم.
حدود |
---|
userId | int |
timeout | long : الانتظار قبل إعادة الخطأ لفشل التبديل-المستخدم. |
عائدات |
---|
boolean | صواب إذا تطابق معرف المستخدم الجديد مع موفر معرف المستخدم. خطأ خلاف ذلك. |
TakeBugreport
public Bugreport takeBugreport ()
خذ تقرير خطأ وأعده داخل كائن Bugreport
للتعامل معه. العودة فارغة في حالة الإصدار. يجب تنظيف الملف المشار إليه في كائن Bugreport عبر Bugreport.close()
.
uninstallPackage
public String uninstallPackage (String packageName)
قم بإلغاء تثبيت حزمة Android من الجهاز.
حدود |
---|
packageName | String : حزمة Android المطلوب إلغاء تثبيتها |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين.
حدود |
---|
packageName | String : حزمة Android المطلوب إلغاء تثبيتها |
userId | int : رقم تعريف المستخدم الصحيح لإلغاء التثبيت من أجله. |
الطرق المحمية
إنشاء المحلل اللغوي
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
قم بإجراء إعادة تشغيل adb.
حدود |
---|
rebootMode | NativeDevice.RebootMode : وضع لإعادة التشغيل. |
reason | String : لعملية إعادة التشغيل هذه. |
getBugreportzInternal
protected File getBugreportzInternal ()
طريقة المساعد الداخلي للحصول على ملف bugreportz zip ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
يتعرض للاختبار.
getHostCurrentTime
protected long getHostCurrentTime ()
يتعرض للاختبار
الإعداد المسبق للتمهيد
protected void prePostBootSetup ()
يسمح لكل نوع جهاز (AndroidNativeDevice ، TestDevice) بتجاوز هذه الطريقة لإعداد ما بعد التمهيد المحدد.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-04-28 (حسب التوقيت العالمي المتفَّق عليه)
[]
[]