جهاز اختبار

public class TestDevice
extends NativeDevice

java.lang.Object
com.android.tradefed.device.NativeDevice
com.android.tradefed.device.TestDevice


تنفيذ ITestDevice لجهاز android مكدس كامل

ملخص

فئات متداخلة

class TestDevice.MicrodroidBuilder

منشئ يستخدم لإنشاء Microdroid TestDevice.

مجالات

public static final String DISMISS_KEYGUARD_CMD

الأوامر التي يمكن استخدامها لرفض حارس المفاتيح.

المنشئون العامة

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

الأساليب العامة

boolean clearErrorDialogs ()

محاولة استبعاد أي مربعات حوار خطأ معروضة حاليًا على واجهة مستخدم الجهاز.

int createUser (String name)

قم بإنشاء مستخدم باسم معين وعلامات افتراضية 0.

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)

محاولة تفريغ الكومة من خادم النظام.

getActiveApexes ()

قم بإحضار المعلومات حول APEXes التي تم تنشيطها على الجهاز.

getAllSettings (String namespace)

إرجاع أزواج قيمة المفتاح لمساحة الاسم المطلوبة.

String getAndroidId (int userId)

ابحث عن معرف android المرتبط بمعرّف المستخدم وأعده ، ويكون فارغًا إذا لم يتم العثور عليه.

getAndroidIds ()

قم بإنشاء خريطة لمعرفات android التي تم العثور عليها مطابقة لمعرفات المستخدم.

PackageInfo getAppPackageInfo (String packageName)

إحضار معلومات حول حزمة مثبتة على الجهاز.

getAppPackageInfos ()

إحضار معلومات الحزم المثبتة على الجهاز.

DeviceFoldableState getCurrentFoldableState ()

تُرجع الحالة القابلة للطي الحالية للجهاز أو تُرجع فارغة في حالة حدوث بعض المشكلات.

int getCurrentUser ()

إرجاع معرف المستخدم الحالي قيد التشغيل.

getFoldableStates ()

يُرجع قائمة الحالات القابلة للطي على الجهاز.

getInstalledPackageNames ()

إحضار أسماء حزم التطبيقات الموجودة على الجهاز.

KeyguardControllerState getKeyguardState ()

قم بإرجاع كائن للحصول على الحالة الحالية لحارس المفاتيح أو فارغ إذا لم يكن مدعومًا.

getMainlineModuleInfo ()

احصل على معلومات حول وحدات الخط الرئيسي المثبتة على الجهاز.

int getMaxNumberOfRunningUsersSupported ()

احصل على أكبر عدد ممكن من المستخدمين الذين يعملون في نفس الوقت.

int getMaxNumberOfUsersSupported ()

احصل على أقصى عدد من المستخدمين المدعومين.

String getMicrodroidCID ()
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, File certFile, boolean reinstall, String... extraArgs)

قم بتثبيت حزمة Android على الجهاز.

String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, 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, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

boolean isAppEnumerationSupported ()

تحقق مما إذا كان النظام الأساسي على الجهاز يدعم تعداد التطبيقات

boolean isMultiUserSupported ()

يحدد ما إذا كان يتم دعم تعدد المستخدمين.

boolean isPackageInstalled (String packageName)

استعلم عن اسم الحزمة المعطى للجهاز للتحقق مما إذا كان مثبتًا حاليًا أم لا.

boolean isPackageInstalled (String packageName, String userId)

استعلم عن الجهاز عن اسم حزمة معين ومعرف المستخدم المحدد للتحقق مما إذا كان مثبتًا حاليًا أم لا لهذا المستخدم.

boolean isUserRunning (int userId)

تحقق مما إذا كان مستخدم معين قيد التشغيل.

boolean isUserSecondary (int userId)

قم بإرجاع ما إذا كان المستخدم المحدد مستخدمًا ثانويًا وفقًا لعلامته.

listDisplayIds ()

قم بتجميع قائمة معرّف الشاشات المتوفرة على الجهاز كما تم الإبلاغ عن ذلك بواسطة "dumpsys SurfaceFlinger".

listUsers ()

يحصل على قائمة المستخدمين على الجهاز.

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 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)

قم بالتبديل إلى معرف مستخدم آخر مع انتهاء المهلة المحددة كموعد نهائي.

String uninstallPackage (String packageName)

قم بإلغاء تثبيت حزمة Android من الجهاز.

String uninstallPackageForUser (String packageName, int userId)

قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين.

الطرق المحمية

AaptParser createParser (File appFile)
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

قم بإجراء إعادة تشغيل adb.

long getCheckNewUserSleep ()

يتعرض للاختبار.

long getHostCurrentTime ()

يتعرض للاختبار

void prePostBootSetup ()

يسمح لكل نوع جهاز (AndroidNativeDevice ، TestDevice) بتجاوز هذه الطريقة لإعداد ما بعد التمهيد المحدد.

مجالات

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

الأوامر التي يمكن استخدامها لرفض حارس المفاتيح.

المنشئون العامة

جهاز اختبار

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

الأساليب العامة

clearErrorDialogs

public boolean clearErrorDialogs ()

محاولة استبعاد أي مربعات حوار خطأ معروضة حاليًا على واجهة مستخدم الجهاز.

عائدات
boolean true في حالة عدم وجود مربعات حوار أو تم مسح الحوارات بنجاح. false خلاف ذلك.

رميات
DeviceNotAvailableException

createUser

public int createUser (String name)

قم بإنشاء مستخدم باسم معين وعلامات افتراضية 0.

المعلمات
name String : للمستخدم الذي سيتم إنشاؤه على الجهاز

عائدات
int العدد الصحيح لمعرف المستخدم الذي تم إنشاؤه

رميات
DeviceNotAvailableException

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

قم بإنشاء مستخدم باسم معين والعلامات المقدمة

المعلمات
name String : للمستخدم الذي سيتم إنشاؤه على الجهاز

guest boolean : تمكين إشارة المستخدم أثناء الإنشاء

ephemeral قيمة boolean : تمكين علامة المستخدم - الرمز الشخصي أثناء الإنشاء

عائدات
int معرف المستخدم الذي تم إنشاؤه

رميات
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

قم بإنشاء مستخدم باسم معين وعلامات افتراضية 0.

المعلمات
name String : للمستخدم الذي سيتم إنشاؤه على الجهاز

عائدات
int الرقم الصحيح لمعرف المستخدم الذي تم إنشاؤه أو -1 للخطأ.

رميات
DeviceNotAvailableException

تعطيل Keyguard

public void disableKeyguard ()

محاولات لتعطيل حارس المفاتيح.

انتظر أولاً حتى يصبح إرسال الإدخال جاهزًا ، يحدث هذا في نفس الوقت تقريبًا عندما يقوم الجهاز بإبلاغ BOOT_COMPLETE ، على ما يبدو بشكل غير متزامن ، لأن تنفيذ إطار العمل الحالي به حالة سباق عرضية. ثم يتم إرسال الأمر لإبعاد حارس المفاتيح (يعمل على الحراس غير الآمنين فقط)

رميات
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

طريقة مساعدة لتحديد ما إذا كان الملف على الجهاز موجودًا.

المعلمات
deviceFilePath String : المسار المطلق للملف المراد فحصه على الجهاز

عائدات
boolean true إذا كان الملف موجودًا ، أو false بخلاف ذلك.

رميات
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

طريقة مساعدة لتحديد ما إذا كان الملف الموجود على الجهاز موجودًا لمستخدم معين.

المعلمات
deviceFilePath String : المسار المطلق للملف المراد فحصه على الجهاز

userId int : معرف المستخدم المراد التحقق من وجود الملف على أساسه

عائدات
boolean true إذا كان الملف موجودًا ، أو false بخلاف ذلك.

رميات
DeviceNotAvailableException

كومة

public File dumpHeap (String process, 
                String devicePath)

محاولة تفريغ الكومة من خادم النظام. تقع على عاتق المتصل مسؤولية تنظيف الملف الملغى.

المعلمات
process String : اسم عملية الجهاز المراد dumpheap تشغيلها.

devicePath String : المسار الموجود على الجهاز حيث يتم وضع التفريغ. يجب أن يكون هذا موقعًا تسمح به الأذونات.

عائدات
File ERROR(/File) الذي يحتوي على التقرير. لاغية إذا فشل شيء ما.

رميات
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

قم بإحضار المعلومات حول APEXes التي تم تنشيطها على الجهاز.

عائدات
تم تنشيط ERROR(/Set) ApexInfo على الجهاز حاليًا

رميات
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

إرجاع أزواج قيمة المفتاح لمساحة الاسم المطلوبة.

المعلمات
namespace String : يجب أن تكون واحدة من {"النظام" ، "الآمن" ، "العالمي"}

عائدات
خريطة أزواج القيمة الرئيسية. خالية إذا لم يتم دعم مساحة الاسم.

رميات
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

ابحث عن معرف android المرتبط بمعرّف المستخدم وأعده ، ويكون فارغًا إذا لم يتم العثور عليه.

المعلمات
userId int

عائدات
String

رميات
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

قم بإنشاء خريطة لمعرفات android التي تم العثور عليها مطابقة لمعرفات المستخدم. لا يوجد تأمين على أن كل معرف مستخدم سيجد معرف android مرتبطًا بهذه الوظيفة ، لذلك قد تتطابق بعض معرفات المستخدم مع قيمة خالية.

عائدات
تم العثور على خريطة معرفات android متطابقة مع معرفات المستخدم.

رميات
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

إحضار معلومات حول حزمة مثبتة على الجهاز.

المعلمات
packageName String

عائدات
PackageInfo PackageInfo أو null إذا تعذر استرداد المعلومات

رميات
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

إحضار معلومات الحزم المثبتة على الجهاز.

عائدات
تم تثبيت ERROR(/List) PackageInfo على الجهاز.

رميات
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

تُرجع الحالة القابلة للطي الحالية للجهاز أو تُرجع فارغة في حالة حدوث بعض المشكلات.

عائدات
DeviceFoldableState

رميات
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

إرجاع معرف المستخدم الحالي قيد التشغيل. في حالة حدوث خطأ ، قم بإرجاع -10000.

عائدات
int

رميات
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

يُرجع قائمة الحالات القابلة للطي على الجهاز. يمكن الحصول عليها باستخدام "cmd device_state print-States".

عائدات

رميات
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

إحضار أسماء حزم التطبيقات الموجودة على الجهاز.

عائدات
ERROR(/Set) من أسماء حزم String المثبتة حاليًا على الجهاز.

رميات
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

قم بإرجاع كائن للحصول على الحالة الحالية لحارس المفاتيح أو فارغ إذا لم يكن مدعومًا.

عائدات
KeyguardControllerState KeyguardControllerState تحتوي على لقطة لحالة حارس المفاتيح وتعيد Null إذا كان استعلام Keyguard غير مدعوم.

رميات
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

احصل على معلومات حول وحدات الخط الرئيسي المثبتة على الجهاز.

عائدات
ERROR(/Set) من وحدات String الرئيسية المثبتة حاليًا على الجهاز.

رميات
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

احصل على أكبر عدد ممكن من المستخدمين الذين يعملون في نفس الوقت. افتراضات على 0.

عائدات
int عدد صحيح يشير إلى عدد المستخدمين قيد التشغيل في وقت واحد

رميات
DeviceNotAvailableException

getMaxNumberOfUsers المدعومة

public int getMaxNumberOfUsersSupported ()

احصل على أقصى عدد من المستخدمين المدعومين. افتراضات على 0.

عائدات
int عدد صحيح يشير إلى عدد المستخدمين المدعومين

رميات
DeviceNotAvailableException

getMicrodroidCID

public String getMicrodroidCID ()

عائدات
String تُرجع CID الخاص بـ microdroid vm. إذا لم يكن TestDevice عبارة عن جهاز ميكرودرويد ، فقم بإرجاعه فارغًا.

getPrimaryUserId

public Integer getPrimaryUserId ()

إرجاع معرف المستخدم الأساسي.

عائدات
Integer معرف المستخدم للمستخدم الأساسي إذا كان هناك واحد ، وخالٍ إذا لم يكن هناك مستخدم أساسي.

رميات
DeviceNotAvailableException

الحصول على لقطة شاشة

public InputStreamSource getScreenshot ()

يلتقط لقطة شاشة من الجهاز.

عائدات
InputStreamSource مصدر InputStreamSource لقطة الشاشة بتنسيق png ، أو null إذا لم تنجح لقطة الشاشة.

رميات
DeviceNotAvailableException

الحصول على لقطة شاشة

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

يلتقط لقطة شاشة من الجهاز. يوصى باستخدام getScreenshot(String) بدلاً من ترميز JPEG لحجم أصغر.

المعلمات
format String : دعم PNG و JPEG

rescale boolean : إذا كان يجب تغيير حجم لقطة الشاشة لتقليل حجم الصورة الناتجة

عائدات
InputStreamSource مصدر InputStreamSource لقطة الشاشة بتنسيق ، أو null إذا لم تنجح لقطة الشاشة.

رميات
DeviceNotAvailableException

الحصول على لقطة شاشة

public InputStreamSource getScreenshot (String format)

يلتقط لقطة شاشة من الجهاز. يوصى باستخدام getScreenshot (التنسيق) بدلاً من ترميز JPEG لحجم أصغر

المعلمات
format String : دعم PNG و JPEG

عائدات
InputStreamSource مصدر InputStreamSource لقطة الشاشة بتنسيق ، أو null إذا لم تنجح لقطة الشاشة.

رميات
DeviceNotAvailableException

الحصول على لقطة شاشة

public InputStreamSource getScreenshot (long displayId)

يأخذ لقطة شاشة من الجهاز المعطى معرّف العرض. التنسيق هو PNG.

TODO: تمديد عمليات التنفيذ أعلاه لدعم "التنسيق" و "إعادة القياس"

المعلمات
displayId long : معرّف عرض الشاشة للحصول على لقطة شاشة منه.

عائدات
InputStreamSource مصدر InputStreamSource لقطة الشاشة بتنسيق ، أو null إذا لم تنجح لقطة الشاشة.

رميات
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

راجع getSetting(int, String, String) ويتم إجراؤه على مستخدم النظام.

المعلمات
namespace String

key String

عائدات
String

رميات
DeviceNotAvailableException

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

إرجاع قيمة الإعداد المطلوب. يجب أن تكون مساحة الاسم واحدة مما يلي: {"نظام" ، "آمن" ، "عالمي"}

المعلمات
userId int

namespace String

key String

عائدات
String القيمة المرتبطة بمساحة الاسم: مفتاح المستخدم. لاغية إذا لم يتم العثور عليها.

رميات
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. يتم تعريف هذا حاليًا على أنه حزم غير متعلقة بالنظام ، وحزم نظام محدثة.

عائدات
ERROR(/Set) في أسماء حزم String غير القابلة للتثبيت المثبتة حاليًا على الجهاز.

رميات
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

ابحث عن أعلام مستخدم معين وقم بإعادتها. يتم تحديد العلامات في فئة "android.content.pm.UserInfo" في مشروع Android مفتوح المصدر.

المعلمات
userId int

عائدات
int العلامات المرتبطة بـ userId المقدمة إن وجدت ، -10000 في أي حالات أخرى.

رميات
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

يحصل على خريطة معرف الاستخدام UserInfo المستخدم على الجهاز. سيتم DeviceRuntimeException إذا لم يكن الإخراج من الجهاز كما هو متوقع.

عائدات
قائمة كائنات معلومات المستخدم.

رميات
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

قم بإرجاع الرقم التسلسلي المرتبط بمعرف المستخدم إذا وجد ، -10000 في أي حالات أخرى.

المعلمات
userId int

عائدات
int

رميات
DeviceNotAvailableException

ميزة

public boolean hasFeature (String feature)

تحقق مما إذا كانت الميزة متاحة على الجهاز.

المعلمات
feature String : أي تنسيق يجب أن يكون "feature: " أو " " مباشرة.

عائدات
boolean صحيح إذا تم العثور على ميزة ، خطأ في خلاف ذلك.

رميات
DeviceNotAvailableException

ثبت المجموعة

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 إذا نجحت.

رميات
DeviceNotAvailableException

ثبت المجموعة

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 إذا نجحت.

رميات
DeviceNotAvailableException

ثبت المجموعة

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 إذا نجحت.

رميات
DeviceNotAvailableException

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 إذا نجحت.

رميات
DeviceNotAvailableException

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 إذا نجحت.

رميات
DeviceNotAvailableException

تثبيت الحزم

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

المعلمات
packageFiles

reinstall boolean

extraArgs String

عائدات
String

رميات
DeviceNotAvailableException

تثبيت الحزم

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

المعلمات
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

عائدات
String

رميات
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

المعلمات
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

عائدات
String

رميات
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

المعلمات
packageFiles

reinstall boolean

userId int

extraArgs String

عائدات
String

رميات
DeviceNotAvailableException

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

المعلمات
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

عائدات
String

رميات
DeviceNotAvailableException

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

المعلمات
remoteApkPaths

reinstall boolean

extraArgs String

عائدات
String

رميات
DeviceNotAvailableException

هو التطبيق التعداد المدعوم

public boolean isAppEnumerationSupported ()

تحقق مما إذا كان النظام الأساسي على الجهاز يدعم تعداد التطبيقات

عائدات
boolean صحيح إذا كان تعداد التطبيق مدعومًا ، أو خطأ إذا كان خلاف ذلك

رميات
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

يحدد ما إذا كان يتم دعم تعدد المستخدمين.

عائدات
boolean صحيح إذا تم دعم عدة مستخدمين ، خطأ إذا كان العكس

رميات
DeviceNotAvailableException

isPackage مثبت

public boolean isPackageInstalled (String packageName)

استعلم عن اسم الحزمة المعطى للجهاز للتحقق مما إذا كان مثبتًا حاليًا أم لا.

المعلمات
packageName String

عائدات
boolean صحيح إذا تم الإبلاغ عن الحزمة على أنها مثبتة. خطأ خلاف ذلك.

رميات
DeviceNotAvailableException

isPackage مثبت

public boolean isPackageInstalled (String packageName, 
                String userId)

استعلم عن الجهاز عن اسم حزمة معين ومعرف المستخدم المحدد للتحقق مما إذا كان مثبتًا حاليًا أم لا لهذا المستخدم.

المعلمات
packageName String : الحزمة التي نتحقق من تثبيتها.

userId String : معرف المستخدم الذي نتحقق من الحزمة مثبت من أجله. إذا كانت القيمة خالية ، فسيتم استخدام الصفر الأساسي للمستخدم.

عائدات
boolean صحيح إذا تم الإبلاغ عن الحزمة على أنها مثبتة. خطأ خلاف ذلك.

رميات
DeviceNotAvailableException

قيد التشغيل

public boolean isUserRunning (int userId)

تحقق مما إذا كان مستخدم معين قيد التشغيل.

المعلمات
userId int

عائدات
boolean صحيح إذا كان المستخدم يعمل ، خطأ في كل الحالات الأخرى.

رميات
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

قم بإرجاع ما إذا كان المستخدم المحدد مستخدمًا ثانويًا وفقًا لعلامته.

المعلمات
userId int

عائدات
boolean صحيح إذا كان المستخدم ثانويًا ، بينما يكون خطأ بخلاف ذلك.

رميات
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

قم بتجميع قائمة معرّف الشاشات المتوفرة على الجهاز كما تم الإبلاغ عن ذلك بواسطة "dumpsys SurfaceFlinger".

عائدات
قائمة العروض. يعيد الإعداد الافتراضي دائمًا العرض الافتراضي 0.

رميات
DeviceNotAvailableException

listUsers

public  listUsers ()

يحصل على قائمة المستخدمين على الجهاز. سيتم DeviceRuntimeException إذا لم يكن الإخراج من الجهاز كما هو متوقع.

عائدات
قائمة هويات المستخدمين.

رميات
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

خطوات إضافية للتنظيف المطلوب المحدد للجهاز والذي سيتم تنفيذه بعد إتمام الاستدعاء.

المعلمات
exception Throwable : الاستثناء النهائي الذي يثيره عدم الاحتجاج إن وجد.

إزالة

public boolean removeAdmin (String componentName, 
                int userId)

قم بإزالة مسؤول الجهاز المحدد في مستخدم معين وإرجاع true إذا كان ناجحًا ، false في الحالات الأخرى.

المعلمات
componentName String : من مسؤول الجهاز المراد إزالته.

userId int : للمستخدم الذي يعيش فيه مشرف الجهاز.

عائدات
boolean صحيح إذا كان ناجحًا ، وخطئًا على خلاف ذلك.

رميات
DeviceNotAvailableException

إزالة المالكين

public void removeOwners ()

قم بإزالة جميع مالكي ملفات تعريف الجهاز الحاليين بأفضل جهد.

رميات
DeviceNotAvailableException

إزالة المستخدم

public boolean removeUser (int userId)

إزالة مستخدم معين من الجهاز.

المعلمات
userId int : للمستخدم المراد إزالته

عائدات
boolean صحيح إذا نجحنا في إزالة المستخدم ، وخطأ بخلاف ذلك.

رميات
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

قم بتعيين مكون مسؤول الجهاز كمالك للجهاز في مستخدم معين.

المعلمات
componentName String : من مشرف الجهاز ليكون مالك الجهاز.

userId int : للمستخدم الذي يعيش فيه مالك الجهاز.

عائدات
boolean صحيح إذا كان ناجحًا ، وخطئًا على خلاف ذلك.

رميات
DeviceNotAvailableException

ضبط

public void setSetting (String namespace, 
                String key, 
                String value)

انظر setSetting(int, String, String, String) ويتم إجراؤها على مستخدم النظام.

المعلمات
namespace String

key String

value String

رميات
DeviceNotAvailableException

ضبط

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

أضف قيمة الإعداد إلى مساحة الاسم لمستخدم معين. لن تكون بعض الإعدادات متاحة إلا بعد إعادة التشغيل. يجب أن تكون مساحة الاسم واحدة مما يلي: {"نظام" ، "آمن" ، "عالمي"}

المعلمات
userId int

namespace String

key String

value String

رميات
DeviceNotAvailableException

الاغلاق

public void shutdownMicrodroid (ITestDevice microdroidDevice)

يقوم بإيقاف تشغيل جهاز microdroid ، إن وجد.

المعلمات
microdroidDevice ITestDevice

رميات
DeviceNotAvailableException

بدء المستخدم

public boolean startUser (int userId)

يبدأ مستخدمًا معينًا في الخلفية إذا تم إيقافه حاليًا. إذا كان المستخدم يعمل بالفعل في الخلفية ، فهذه الطريقة هي NOOP.

المعلمات
userId int : للمستخدم للبدء في الخلفية

عائدات
boolean صحيح إذا كان المستخدم قد بدأ بنجاح في الخلفية.

رميات
DeviceNotAvailableException

بدء المستخدم

public boolean startUser (int userId, 
                boolean waitFlag)

يبدأ مستخدمًا معينًا في الخلفية إذا تم إيقافه حاليًا. إذا كان المستخدم يعمل بالفعل في الخلفية ، فهذه الطريقة هي NOOP. من الممكن توفير علامة إضافية لانتظار تفعيل العملية.

المعلمات
userId int : للمستخدم للبدء في الخلفية

waitFlag boolean : سيجعل الأمر ينتظر حتى يتم بدء تشغيل المستخدم وإلغاء قفله.

عائدات
boolean صحيح إذا كان المستخدم قد بدأ بنجاح في الخلفية.

رميات
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

وقف مستخدم معين. من الممكن توفير إشارات إضافية لانتظار تفعيل العملية وإجبار المستخدم على الإنهاء. لا يمكن إيقاف المستخدم الحالي والنظام.

المعلمات
userId int : من المستخدم لإيقاف.

waitFlag boolean : سيجعل الأمر ينتظر حتى يتم إيقاف المستخدم.

forceFlag قيمة boolean : ستفرض إيقاف المستخدم.

عائدات
boolean صحيح إذا تم إيقاف المستخدم بنجاح.

رميات
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

يوقف مستخدم معين. إذا تم إيقاف المستخدم بالفعل ، فهذه الطريقة هي NOOP. لا يمكن إيقاف المستخدم الحالي والنظام.

المعلمات
userId int : من المستخدم لإيقاف.

عائدات
boolean صحيح إذا تم إيقاف المستخدم بنجاح.

رميات
DeviceNotAvailableException

يدعم

public boolean supportsMicrodroid ()

يتحقق من الشروط المسبقة لتشغيل microdroid.

عائدات
boolean يعود صحيحًا إذا تم استيفاء الشروط المسبقة ، خطأ في الحالات الأخرى.

يدعم

public boolean supportsMicrodroid (boolean protectedVm)

يتحقق من الشروط المسبقة لتشغيل microdroid.

المعلمات
protectedVm boolean : صحيح إذا كان microdroid يهدف إلى التشغيل على جهاز افتراضي محمي.

عائدات
boolean يعود صحيحًا إذا تم استيفاء الشروط المسبقة ، خطأ في الحالات الأخرى.

تغير المستخدم

public boolean switchUser (int userId)

قم بالتبديل إلى معرف مستخدم آخر بمهلة افتراضية. switchUser(int, long) .

المعلمات
userId int

عائدات
boolean صواب إذا تطابق معرف المستخدم الجديد مع موفر معرف المستخدم. خطأ خلاف ذلك.

رميات
DeviceNotAvailableException

تغير المستخدم

public boolean switchUser (int userId, 
                long timeout)

قم بالتبديل إلى معرف مستخدم آخر مع انتهاء المهلة المحددة كموعد نهائي. محاولة تعطيل حماية المفاتيح بعد نجاح تغيير المستخدم.

المعلمات
userId int

timeout long : الانتظار قبل إعادة الخطأ لفشل التبديل-المستخدم.

عائدات
boolean صواب إذا تطابق معرف المستخدم الجديد مع موفر معرف المستخدم. خطأ خلاف ذلك.

رميات
DeviceNotAvailableException

uninstallPackage

public String uninstallPackage (String packageName)

قم بإلغاء تثبيت حزمة Android من الجهاز.

المعلمات
packageName String : حزمة Android المطلوب إلغاء تثبيتها

عائدات
String String برمز خطأ ، أو null إذا نجحت.

رميات
DeviceNotAvailableException

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين.

المعلمات
packageName String : حزمة Android المطلوب إلغاء تثبيتها

userId int : رقم تعريف المستخدم الصحيح لإلغاء التثبيت من أجله.

عائدات
String String برمز خطأ ، أو null إذا نجحت.

رميات
DeviceNotAvailableException

الطرق المحمية

إنشاء المحلل اللغوي

protected AaptParser createParser (File appFile)

المعلمات
appFile File

عائدات
AaptParser

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

قم بإجراء إعادة تشغيل adb.

المعلمات
rebootMode NativeDevice.RebootMode : وضع لإعادة التشغيل.

reason String : لعملية إعادة التشغيل هذه.

رميات
DeviceNotAvailableException

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

يتعرض للاختبار.

عائدات
long

getHostCurrentTime

protected long getHostCurrentTime ()

يتعرض للاختبار

عائدات
long

الإعداد المسبق للتمهيد

protected void prePostBootSetup ()

يسمح لكل نوع جهاز (AndroidNativeDevice ، TestDevice) بتجاوز هذه الطريقة لإعداد ما بعد التمهيد المحدد.

رميات
DeviceNotAvailableException