فصول متداخلة |
---|
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 () يحصل على خريطة useId 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 | 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) يقوم بإيقاف تشغيل جهاز 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 من الجهاز لمستخدم معين. |
void | waitForSnapuserd ( SnapuserdWaitPhase currentPhase) |
مجالات
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 : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء |
forTesting | boolean : قم بتمكين علامة الاختبار --for-testing أثناء الإنشاء |
عائدات |
---|
int | معرف المستخدم الذي تم إنشاؤه |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
قم بإنشاء مستخدم باسم معين والأعلام المقدمة
حدود |
---|
name | String : من المستخدم لإنشائها على الجهاز |
guest | boolean : قم بتمكين علامة المستخدم --ضيف أثناء الإنشاء |
ephemeral | boolean : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء |
عائدات |
---|
int | معرف المستخدم الذي تم إنشاؤه |
createUserNoThrow
public int createUserNoThrow (String name)
أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.
حدود |
---|
name | String : من المستخدم لإنشائها على الجهاز |
عائدات |
---|
int | العدد الصحيح لمعرف المستخدم الذي تم إنشاؤه أو -1 للخطأ. |
dableKeyguard
public void disableKeyguard ()
محاولات لتعطيل حارس المفاتيح.
انتظر أولاً حتى يصبح إرسال الإدخال جاهزًا، ويحدث هذا في نفس الوقت تقريبًا عندما يقوم الجهاز بالإبلاغ عن BOOT_COMPLETE، بشكل غير متزامن على ما يبدو، لأن تنفيذ إطار العمل الحالي له حالة سباق عرضية. ثم يتم إرسال الأمر لإغلاق حارس المفاتيح (يعمل على المفاتيح غير الآمنة فقط)
doFileExist
public boolean doesFileExist (String deviceFilePath)
طريقة مساعدة لتحديد ما إذا كان الملف الموجود على الجهاز موجودًا أم لا.
حدود |
---|
deviceFilePath | String : المسار المطلق للملف الموجود على الجهاز المراد فحصه |
عائدات |
---|
boolean | true في حالة وجود الملف، false في غير ذلك. |
doFileExist
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 ()
جلب المعلومات حول APEXes المنشط على الجهاز.
getAllSettings
public getAllSettings (String namespace)
إرجاع أزواج القيمة الرئيسية لمساحة الاسم المطلوبة.
حدود |
---|
namespace | String : يجب أن تكون واحدة من {"system"، "secure"، "global"} |
عائدات |
---|
| خريطة أزواج القيمة الرئيسية. فارغة إذا كانت مساحة الاسم غير مدعومة. |
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 devices_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 | معرف المستخدم للمستخدم الأساسي إذا كان هناك واحد، وفارغ إذا لم يكن هناك مستخدم أساسي. |
getScreenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
يلتقط لقطة شاشة من الجهاز. يوصى باستخدام getScreenshot(String)
بدلاً من ذلك مع تشفير JPEG للحجم الأصغر.
حدود |
---|
format | String : مدعومة PNG، JPEG |
rescale | boolean : إذا كان يجب إعادة قياس لقطة الشاشة لتقليل حجم الصورة الناتجة |
getScreenshot
public InputStreamSource getScreenshot (String format)
يلتقط لقطة شاشة من الجهاز. يوصى باستخدام getScreenshot(format) بدلاً من ذلك مع تشفير JPEG للحجم الأصغر
حدود |
---|
format | String : مدعومة PNG، JPEG |
getScreenshot
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 | القيمة المرتبطة بمساحة الاسم:مفتاح المستخدم. فارغة إذا لم يتم العثور عليها. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. يتم تعريف هذا حاليًا على أنه الحزم غير التابعة للنظام، وحزم النظام المحدثة.
getUserFlags
public int getUserFlags (int userId)
البحث عن إشارات مستخدم معين وإعادتها. يتم تعريف العلامات في فئة "android.content.pm.UserInfo" في مشروع Android مفتوح المصدر.
عائدات |
---|
int | العلامات المرتبطة بمعرف المستخدم المقدم إذا تم العثور عليه، -10000 في أي حالات أخرى. |
getUserInfos
public getUserInfos ()
يحصل على خريطة useId UserInfo
على الجهاز. سيتم طرح DeviceRuntimeException
إذا لم يكن الإخراج من الجهاز كما هو متوقع.
عائدات |
---|
| قائمة كائنات UserInfo. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
إعادة الرقم التسلسلي المرتبط بمعرف المستخدم إذا وجد، -10000 في أي حالات أخرى.
hasFeature
public boolean hasFeature (String feature)
تحقق مما إذا كانت الميزة متوفرة على الجهاز.
حدود |
---|
feature | String : التنسيق الذي يجب أن يكون "الميزة: " أو " " مباشرة. |
عائدات |
---|
boolean | صحيح إذا تم العثور على الميزة، وخطأ فيما عدا ذلك. |
ثبت المجموعة
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
تثبيت حزمة Android على الجهاز.
حدود |
---|
packageFile | File : ملف apk للتثبيت |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
extraArgs | String : وسيطات إضافية اختيارية للتمرير. راجع "adb Shell PM -h" للتعرف على الخيارات المتاحة. |
عائدات |
---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
ثبت المجموعة
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" للتعرف على الخيارات المتاحة. |
عائدات |
---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
ثبت المجموعة
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" للتعرف على الخيارات المتاحة. |
عائدات |
---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
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" للتعرف على الخيارات المتاحة. |
عائدات |
---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
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" للتعرف على الخيارات المتاحة. |
عائدات |
---|
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 |
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 |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
تحقق مما إذا كان النظام الأساسي الموجود على الجهاز يدعم تعداد التطبيقات
عائدات |
---|
boolean | صحيح إذا كان تعداد التطبيق مدعومًا، وخطأ إذا كان غير ذلك |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
إرجاع ما إذا كان الجهاز يستخدم وضع مستخدم النظام بدون رأس.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
لعرض ما إذا كان المستخدم الرئيسي هو مسؤول دائم ولا يمكن حذفه أو خفض رتبته إلى حالة غير مسؤول.
isMultiUserSupported
public boolean isMultiUserSupported ()
يحدد ما إذا كان يتم دعم المستخدمين المتعددين.
عائدات |
---|
boolean | صحيح إذا كان هناك دعم لعدة مستخدمين، وخطأ إذا كان غير ذلك |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
استعلم عن الجهاز للحصول على اسم حزمة معين للتحقق مما إذا كان مثبتًا حاليًا أم لا.
عائدات |
---|
boolean | صحيح إذا تم الإبلاغ عن الحزمة على أنها مثبتة. باطل غير ذلك. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
استعلم عن الجهاز للحصول على اسم حزمة معين ومعرف المستخدم المحدد للتحقق مما إذا كان مثبتًا حاليًا أم لا لهذا المستخدم.
حدود |
---|
packageName | String : الحزمة التي نتحقق من تثبيتها. |
userId | String : معرف المستخدم الذي نتحقق من تثبيت الحزمة عليه. إذا كان فارغًا، فسيتم استخدام المستخدم الأساسي صفر. |
عائدات |
---|
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. |
listUsers
public listUsers ()
يحصل على قائمة المستخدمين على الجهاز. سيتم طرح DeviceRuntimeException
إذا لم يكن الإخراج من الجهاز كما هو متوقع.
عائدات |
---|
| قائمة معرفات المستخدمين. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
طريقة مساعدة لأخذ تقرير الأخطاء وتسجيله للصحفيين.
حدود |
---|
dataName | String : الاسم الذي سيتم بموجبه الإبلاغ عن تقرير الأخطاء. |
listener | ITestLogger : ITestLogger لتسجيل تقرير الأخطاء. |
عائدات |
---|
boolean | صحيح إذا تم التسجيل بنجاح، وخطأ فيما عدا ذلك. |
notifySnapuuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
حدود |
---|
waitPhase | SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
خطوات إضافية للتنظيف المطلوب الخاص بالجهاز والتي سيتم تنفيذها بعد انتهاء الاستدعاء.
حدود |
---|
exception | Throwable : إن وجد، الاستثناء الأخير الناتج عن فشل الاستدعاء. |
RemoveAdmin
public boolean removeAdmin (String componentName,
int userId)
قم بإزالة مسؤول الجهاز المحدد في مستخدم معين وإرجاع true
إذا كان ناجحًا، false
إذا كان خلاف ذلك.
حدود |
---|
componentName | String : من مسؤول الجهاز المراد إزالته. |
userId | int : للمستخدم الذي يعيش فيه مسؤول الجهاز. |
عائدات |
---|
boolean | صحيح إذا نجح، وباطل فيما عدا ذلك. |
RemoveOwners
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 |
ShutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
يقوم بإيقاف تشغيل جهاز microdroid، إذا كان موجودًا.
حدود |
---|
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 ()
التحقق من الشروط المسبقة لتشغيل 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 | صحيح إذا كان معرف المستخدم الجديد يتطابق مع موفر معرف المستخدم. باطل غير ذلك. |
com.takeBugreport
public Bugreport takeBugreport ()
خذ تقرير الأخطاء وأعده داخل كائن Bugreport
للتعامل معه. العودة فارغة في حالة الإصدار. يجب تنظيف الملف المشار إليه في كائن Bugreport عبر Bugreport.close()
.
uninstallPackage
public String uninstallPackage (String packageName)
قم بإلغاء تثبيت حزمة Android من الجهاز.
حدود |
---|
packageName | String : حزمة Android المراد إلغاء تثبيتها |
عائدات |
---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
إلغاء التثبيتPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين.
حدود |
---|
packageName | String : حزمة Android المراد إلغاء تثبيتها |
userId | int : معرف المستخدم الصحيح الذي سيتم إلغاء تثبيته. |
عائدات |
---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
حدود |
---|
currentPhase | SnapuserdWaitPhase |
الأساليب المحمية
createParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
إجراء إعادة تشغيل بنك التنمية الآسيوي.
حدود |
---|
rebootMode | NativeDevice.RebootMode : وضع إعادة التشغيل هذا. |
reason | String : لإعادة التشغيل هذه. |
getBugreportzInternal
protected File getBugreportzInternal ()
طريقة المساعد الداخلي للحصول على ملف bugreportz المضغوط ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
تعرض للاختبار.
getHostCurrentTime
protected long getHostCurrentTime ()
تعرض للاختبار
prePostBootSetup
protected void prePostBootSetup ()
يسمح لكل نوع جهاز (AndroidNativeDevice، TestDevice) بتجاوز هذه الطريقة لإعداد محدد بعد التمهيد.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2024-04-02 (حسب التوقيت العالمي المتفَّق عليه)
[{
"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":"غير ذلك"
}]
{
"last_modified": "تاريخ التعديل الأخير: 2024-04-02 (حسب التوقيت العالمي المتفَّق عليه)",
"state": ""
}