TestDevice

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. 

الثوابت

String DISMISS_KEYGUARD_CMD

الأوامر التي يمكن استخدامها لإغلاق شاشة القفل

الإنشاءات العامة

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

الطُرق العامة

boolean canSwitchToHeadlessSystemUser()

تعرِض هذه السمة ما إذا كان مسموحًا بالتبديل إلى مستخدم SYSTEM بلا واجهة مستخدم رسومية.

boolean clearErrorDialogs()

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

int createUser(String name)

أنشئ مستخدمًا باسم معيّن وعلامات تلقائية بقيمة 0.

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

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

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

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

int createUserNoThrow(String name)

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

void disableKeyguard()

محاولات إيقاف قفل الشاشة

boolean doesFileExist(String deviceFilePath, int userId)

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

boolean doesFileExist(String deviceFilePath)

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

File dumpHeap(String process, String devicePath)

محاولة تفريغ الذاكرة المؤقتة من system_server

getActiveApexes()

استرجاع المعلومات حول حِزم APEX المفعَّلة على الجهاز

getAllSettings(String namespace)

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

String getAndroidId(int userId)

يمكنك العثور على android-id المرتبط بمعرّف المستخدم وإرجاعه، أو إرجاع قيمة فارغة في حال عدم العثور عليه.

getAndroidIds()

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

PackageInfo getAppPackageInfo(String packageName)

استرداد معلومات حول حزمة مثبَّتة على الجهاز

getAppPackageInfos()

استرداد معلومات الحِزم المثبَّتة على الجهاز

InputStreamSource getBugreport()

يستردّ تقرير خطأ من الجهاز.

InputStreamSource getBugreportz()

يسترد هذا الأمر تقرير bugreportz من الجهاز.

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

لعرض رقم تعريف المستخدم الحالي الذي يتم تشغيله

getFoldableStates()

تعرض هذه السمة قائمة بحالات الجهاز القابل للطي.

getInstalledPackageNames()

استرجاع أسماء حِزم التطبيقات المتوفّرة على الجهاز

KeyguardControllerState getKeyguardState()

تعرض هذه الدالة عنصرًا للحصول على الحالة الحالية لشاشة القفل أو قيمة فارغة إذا لم تكن متاحة.

Integer getMainUserId()

تعرِض هذه السمة رقم تعريف المستخدم الرئيسي.

getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

الحصول على الحد الأقصى لعدد المستخدمين الذين يمكنهم تشغيل التطبيق في الوقت نفسه

int getMaxNumberOfUsersSupported()

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

Integer getPrimaryUserId()

تعرِض هذه السمة رقم تعريف المستخدم الأساسي.

InputStreamSource getScreenshot(String format, boolean rescale)

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

InputStreamSource getScreenshot(long displayId)

تلتقط هذه الطريقة لقطة شاشة من الجهاز الذي تمّ تحديد رقم تعريف العرض له.

InputStreamSource getScreenshot(String format)

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

InputStreamSource getScreenshot()

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

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

عرض قيمة الإعداد المطلوب

String getSetting(String namespace, String key)

اطّلِع على getSetting(int, String, String) التي تم تنفيذها على مستخدم النظام.

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

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

String installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

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

String installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)

تثبيت حزمة Android على الجهاز لمستخدم معيّن

String installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

تثبيت حزمة Android على الجهاز لمستخدم معيّن

boolean installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)

تثبيت حِزم APK باستخدام الوضع التزايدي

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

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

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

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

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

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

boolean isAppEnumerationSupported()

التحقّق مما إذا كانت المنصة على الجهاز تتيح تعداد التطبيقات

boolean isHeadlessSystemUserMode()

تعرِض هذه السمة ما إذا كان الجهاز يستخدم وضع تشغيل بلا واجهة مستخدم رسومية.

boolean isMainUserPermanentAdmin()

تعرض هذه السمة ما إذا كان المستخدم الرئيسي مشرفًا دائمًا ولا يمكن حذفه أو خفض مستوى امتيازه إلى مستوى غير مشرف.

boolean isMultiUserSupported()

تحدِّد ما إذا كان يمكن استخدام حسابات متعدّدة.

boolean isPackageInstalled(String packageName, String userId)

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

boolean isPackageInstalled(String packageName)

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

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 setFirstBootloaderReboot()
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 stopUser(int userId, boolean waitFlag, boolean forceFlag)

إيقاف مستخدم معيّن

boolean supportsMicrodroid()

للتحقّق من الشروط المسبقة لتشغيل جهاز microdroid

boolean supportsMicrodroid(boolean protectedVm)

للتحقّق من الشروط المسبقة لتشغيل جهاز microdroid

boolean switchUser(int userId)

التبديل إلى userId آخر مع مهلة تلقائية

boolean switchUser(int userId, long timeout)

بدِّل إلى userId آخر مع المهلة المقدَّمة كموعد نهائي.

Bugreport takeBugreport()

تأخذ هذه الدالة تقرير خطأ وتعرضه داخل عنصر Bugreport للتعامل معه.

String uninstallPackage(String packageName)

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

String uninstallPackageForUser(String packageName, int userId)

إزالة حزمة Android من الجهاز لمستخدم معيّن

void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

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

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

نفِّذ عملية إعادة التشغيل عبر adb.

InputStreamSource getBugreportInternal()
File getBugreportzInternal()

طريقة مساعدة داخلية للحصول على ملف bugreportz ZIP كـ ERROR(/File).

long getCheckNewUserSleep()

يتم عرضها لأغراض الاختبار.

long getHostCurrentTime()

معرَّض للاختبار

void prePostBootSetup()

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

الثوابت

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

الأوامر التي يمكن استخدامها لإغلاق شاشة القفل

Constant Value: "input keyevent 82"

الإنشاءات العامة

TestDevice

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

الطُرق العامة

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

تعرِض هذه السمة ما إذا كان مسموحًا بالتبديل إلى مستخدم SYSTEM بلا واجهة مستخدم رسومية.

المرتجعات
boolean

الرميات
DeviceNotAvailableException

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: تفعيل علامة المستخدم --guest أثناء الإنشاء
ephemeral ‫boolean: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء
المرتجعات
int معرّف المستخدم الذي تم إنشاؤه
الرميات
DeviceNotAvailableException

createUser

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

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

المعلمات
name ‫String: هو اسم المستخدم الذي سيتم إنشاؤه على الجهاز
guest boolean: تفعيل علامة المستخدم --guest أثناء الإنشاء
ephemeral ‫boolean: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء
forTesting boolean: تفعيل العلامة الاختبارية --for-testing أثناء الإنشاء
المرتجعات
int معرّف المستخدم الذي تم إنشاؤه
الرميات
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

المعلمات
name ‫String: هو اسم المستخدم الذي سيتم إنشاؤه على الجهاز
المرتجعات
int عدد صحيح يمثّل رقم تعريف المستخدم الذي تم إنشاؤه أو القيمة -1 في حال حدوث خطأ.
الرميات
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

محاولات إيقاف قفل الشاشة

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

الرميات
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

المعلمات
deviceFilePath ‫String: المسار المطلق للملف على الجهاز المطلوب التحقّق منه
userId ‫int: رقم تعريف المستخدم الذي سيتم التحقّق من توفّر الملف له
المرتجعات
boolean true إذا كان الملف متوفّرًا، false في الحالات الأخرى
الرميات
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

المعلمات
deviceFilePath ‫String: المسار المطلق للملف على الجهاز المطلوب التحقّق منه
المرتجعات
boolean true إذا كان الملف متوفّرًا، false في الحالات الأخرى
الرميات
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

محاولة تفريغ الذاكرة المؤقتة من system_server ويتحمّل المتصل مسؤولية تنظيف الملف الذي تم تفريغه.

المعلمات
process ‫String: اسم عملية الجهاز التي سيتم فيها dumpheap.
devicePath ‫String: المسار على الجهاز الذي سيتم وضع ملف التفريغ فيه يجب أن يكون هذا الموقع الجغرافي مسموحًا به بموجب الأذونات.
المرتجعات
File ERROR(/File) الذي يحتوي على التقرير قيمة فارغة في حال حدوث خطأ
الرميات
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

استرجاع المعلومات حول حِزم APEX المفعَّلة على الجهاز

المرتجعات
ERROR(/Set) من إجمالي ApexInfo تم تفعيله حاليًا على الجهاز
الرميات
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

المعلمات
namespace ‫String: يجب أن تكون إحدى القيم التالية: {"system", "secure", "global"}
المرتجعات
خريطة أزواج المفتاح/القيمة يتم عرض القيمة Null إذا كانت مساحة الاسم غير متاحة.
الرميات
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

يمكنك العثور على android-id المرتبط بمعرّف المستخدم وإرجاعه، أو إرجاع قيمة فارغة في حال عدم العثور عليه.

المعلمات
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

getBugreport

public InputStreamSource getBugreport ()

يستردّ تقرير خطأ من الجهاز.

يُضمن استمرار عمل هذه الميزة على جهاز بدون بطاقة sdcard (أو في حال لم يتم تركيب بطاقة sdcard بعد).

المرتجعات
InputStreamSource InputStreamSource التي ستنتج محتوى تقرير الأخطاء عند الطلب في حال حدوث خطأ، ستنتج InputStreamSource قيمة ERROR(/InputStream) فارغة.

getBugreportz

public InputStreamSource getBugreportz ()

يسترد هذا الأمر تقرير bugreportz من الجهاز. يحتوي تقرير الخطأ بتنسيق Zip على تقرير الخطأ الرئيسي وملفات سجلّ أخرى مفيدة لتصحيح الأخطاء.

لا يتوافق إلا مع الإصدار "adb version" الأحدث من 1.0.36

المرتجعات
InputStreamSource InputStreamSource لملف zip الذي يحتوي على bugreportz، أو قيمة فارغة في حال حدوث خطأ.

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 إذا كان طلب البحث عن شاشة القفل غير متاح.
الرميات
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

تعرِض هذه السمة رقم تعريف المستخدم الرئيسي.

المرتجعات
Integer معرّف المستخدم الرئيسي إذا كان هناك مستخدم رئيسي، والقيمة null إذا لم يكن هناك مستخدم رئيسي
الرميات
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

الحصول على الحد الأقصى لعدد المستخدمين الذين يمكنهم تشغيل التطبيق في الوقت نفسه القيمة التلقائية هي 0.

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

الحصول على الحد الأقصى لعدد المستخدمين المسموح بهم القيمة التلقائية هي 0.

المرتجعات
int عدد صحيح يشير إلى عدد المستخدمين المسموح بهم
الرميات
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

تعرِض هذه السمة رقم تعريف المستخدم الأساسي.

المرتجعات
Integer معرّف المستخدم الأساسي إذا كان هناك مستخدم أساسي، والقيمة null إذا لم يكن هناك مستخدم أساسي
الرميات
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

المعلمات
format String: PNG وJPEG
rescale ‫boolean: ما إذا كان يجب إعادة تحجيم لقطة الشاشة لتقليل حجم الصورة الناتجة
المرتجعات
InputStreamSource InputStreamSource من لقطة الشاشة بالتنسيق، أو null إذا لم تنجح لقطة الشاشة.
الرميات
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

TODO: extend the implementations above to support 'format' and 'rescale'

المعلمات
displayId long: المعرّف المعروض للشاشة التي سيتم أخذ لقطة شاشة منها
المرتجعات
InputStreamSource InputStreamSource من لقطة الشاشة بالتنسيق، أو null إذا لم تنجح لقطة الشاشة.
الرميات
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format)

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

المعلمات
format String: PNG وJPEG
المرتجعات
InputStreamSource InputStreamSource من لقطة الشاشة بالتنسيق، أو null إذا لم تنجح لقطة الشاشة.
الرميات
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot ()

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

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

getSetting

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

عرض قيمة الإعداد المطلوب يجب أن تكون مساحة الاسم واحدة مما يلي: {"system", "secure", "global"}

المعلمات
userId int

namespace String

key String

المرتجعات
String القيمة المرتبطة بالمساحة:مفتاح الخاص بمستخدِم. تكون القيمة فارغة إذا لم يتم العثور على أي نتائج.
الرميات
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

اطّلِع على getSetting(int, String, String) التي تم تنفيذها على مستخدم النظام.

المعلمات
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 الأعلام المرتبطة برقم تعريف المستخدم المقدَّم في حال العثور عليه، أو -10000 في أي حالات أخرى
الرميات
DeviceNotAvailableException

getUserInfos

public  getUserInfos ()

تعرض هذه السمة خريطة تربط بين useId وUserInfo على الجهاز. سيتم عرض الخطأ DeviceRuntimeException إذا لم تكن النتائج من الجهاز على النحو المتوقّع.

المرتجعات
قائمة عناصر UserInfo
الرميات
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

لعرض الرقم التسلسلي المرتبط بمعرّف المستخدم في حال العثور عليه، أو -10000 في أي حالات أخرى.

المعلمات
userId int

المرتجعات
int

الرميات
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

التحقّق من توفّر ميزة على جهاز

المعلمات
feature ‫String: يجب أن يكون التنسيق "feature:" أو "" مباشرةً.
المرتجعات
boolean صحيح إذا تم العثور على الميزة، وخطأ في الحالات الأخرى.
الرميات
DeviceNotAvailableException

installPackage

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

installPackage

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

installPackage

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, 
                int userId, 
                String... extraArgs)

تثبيت حزمة Android على الجهاز لمستخدم معيّن

المعلمات
packageFile ‫File: ملف APK المطلوب تثبيته
reinstall boolean: true إذا كان يجب إعادة التثبيت
userId ‫int: هو رقم تعريف المستخدم الصحيح الذي سيتم التثبيت له.
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

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

تثبيت حِزم APK باستخدام الوضع التزايدي

المعلمات
apkFiles استبدِل File بملفات APK المطلوب تثبيتها.
extraArgs String

userId String

المرتجعات
boolean

الرميات
DeviceNotAvailableException

installPackages

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

المعلمات
packageFiles

reinstall boolean

extraArgs String

المرتجعات
String

الرميات
DeviceNotAvailableException

installPackages

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, 
                int userId, 
                String... extraArgs)

المعلمات
packageFiles

reinstall boolean

userId int

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

installRemotePackages

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

المعلمات
remoteApkPaths

reinstall boolean

extraArgs String

المرتجعات
String

الرميات
DeviceNotAvailableException

installRemotePackages

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

المعلمات
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

المرتجعات
String

الرميات
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

التحقّق مما إذا كانت المنصة على الجهاز تتيح تعداد التطبيقات

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

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

تعرِض هذه السمة ما إذا كان الجهاز يستخدم وضع تشغيل بلا واجهة مستخدم رسومية.

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

تعرض هذه السمة ما إذا كان المستخدم الرئيسي مشرفًا دائمًا ولا يمكن حذفه أو خفض مستوى امتيازه إلى مستوى غير مشرف.

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

تحدِّد ما إذا كان يمكن استخدام حسابات متعدّدة.

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

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

المعلمات
packageName ‫String: الحزمة التي نتحقّق من تثبيتها.
userId ‫String: رقم تعريف المستخدم الذي نتحقّق من تثبيت الحزمة عليه. إذا كانت القيمة فارغة، سيتم استخدام القيمة صفر للمستخدم الأساسي.
المرتجعات
boolean تكون القيمة "صحيح" إذا تم الإبلاغ عن تثبيت الحزمة. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.
الرميات
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

المعلمات
packageName String

المرتجعات
boolean تكون القيمة "صحيح" إذا تم الإبلاغ عن تثبيت الحزمة. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.
الرميات
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

التحقّق ممّا إذا كان مستخدم معيّنًا نشطًا

المعلمات
userId int

المرتجعات
boolean تكون القيمة "صحيح" إذا كان المستخدم يمارس رياضة الجري، وتكون "خطأ" في كل الحالات الأخرى.
الرميات
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

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

المعلمات
userId int

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

isUserVisible

public boolean isUserVisible (int userId)

تتحقّق هذه الطريقة ممّا إذا كان المستخدم المحدّد مرئيًا.

المستخدم "المرئي" هو المستخدم الذي يتفاعل مع المستخدم "البشري" وبالتالي يمكنه بدء الأنشطة (عادةً في الشاشة التلقائية).

المعلمات
userId int

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

تتحقّق هذه الطريقة ممّا إذا كان المستخدم المحدّد مرئيًا في العرض المحدّد.

المستخدم "المرئي" هو المستخدم الذي يتفاعل مع المستخدم "البشري"، وبالتالي يمكنه بدء الأنشطة في تلك الشاشة.

المعلمات
userId int

displayId int

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

تعرض هذه السمة ما إذا كان الجهاز يسمح للمستخدمين ببدء التطبيق بشكل مرئي في الخلفية في ERROR(/java.android.view.Display#DEFAULT_DISPLAY).

إذا كان الأمر كذلك، يمكنك استدعاء startVisibleBackgroundUser(int, int, boolean)، مع تمرير عرض تم إرجاعه بواسطة listDisplayIdsForStartingVisibleBackgroundUsers() (الذي يجب أن يتضمّن ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

تعرض هذه السمة ما إذا كان الجهاز يسمح للمستخدمين ببدء التطبيق بشكل مرئي في الخلفية.

إذا كان الأمر كذلك، يمكنك استدعاء startVisibleBackgroundUser(int, int, boolean)، مع تمرير عرض تم إرجاعه بواسطة listDisplayIdsForStartingVisibleBackgroundUsers().

المرتجعات
boolean

الرميات
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

اجمع قائمة بمعرّفات الشاشات المتاحة على الجهاز كما تمّت الإشارة إليها من خلال "dumpsys SurfaceFlinger".

المرتجعات
تمثّل هذه السمة قائمة بالشاشات. تعرض القيمة التلقائية دائمًا القيمة التلقائية 0.
الرميات
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

تعرض هذه الطريقة قائمة الشاشات التي يمكن استخدامها في start a user visible in the background.

المرتجعات
الرميات
DeviceNotAvailableException

listUsers

public  listUsers ()

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

المرتجعات
قائمة أرقام تعريف المستخدمين
الرميات
DeviceNotAvailableException

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

طريقة مساعدة لأخذ تقرير خطأ وتسجيله لدى المراسلين.

المعلمات
dataName ‫String: الاسم الذي سيتم الإبلاغ عنه في تقرير الأخطاء.
listener ITestLogger: ITestLogger لتسجيل تقرير الأخطاء
المرتجعات
boolean صحيح إذا تم التسجيل بنجاح، وخطأ في الحالات الأخرى.

notifySnapuserd

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 صحيح إذا كانت العملية ناجحة، وخطأ في الحالات الأخرى.
الرميات
DeviceNotAvailableException

removeOwners

public void removeOwners ()

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

الرميات
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

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

المعلمات
userId ‫int: معرّف المستخدم المطلوب إزالته
المرتجعات
boolean صحيح إذا نجحنا في إزالة المستخدم، وخطأ في الحالات الأخرى.
الرميات
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

تعيين أحد مكونات مشرف الجهاز كمالك للجهاز في حساب مستخدم معيّن

المعلمات
componentName String: من مشرف الجهاز ليكون مالك الجهاز.
userId int: الخاصة بالمستخدم الذي يعيش فيه مالك الجهاز.
المرتجعات
boolean صحيح إذا كانت العملية ناجحة، وخطأ في الحالات الأخرى.
الرميات
DeviceNotAvailableException

setFirstBootloaderReboot

public void setFirstBootloaderReboot ()

setSetting

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

اطّلِع على setSetting(int, String, String, String) التي تم تنفيذها على مستخدم النظام.

المعلمات
namespace String

key String

value String

الرميات
DeviceNotAvailableException

setSetting

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

أضِف قيمة إعداد إلى مساحة الاسم الخاصة بمستخدم معيّن. لن تتوفّر بعض الإعدادات إلا بعد إعادة التشغيل. يجب أن تكون مساحة الاسم واحدة مما يلي: {"system", "secure", "global"}

المعلمات
userId int

namespace String

key String

value String

الرميات
DeviceNotAvailableException

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

يؤدي هذا الإجراء إلى إيقاف جهاز microdroid، إذا كان متوفّرًا.

المعلمات
microdroidDevice ITestDevice

الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public boolean startUser (int userId)

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

المعلمات
userId ‫int: تمثّل هذه السمة المستخدم الذي سيتم تشغيل التطبيق في الخلفية.
المرتجعات
boolean تعرض القيمة "true" إذا تم بدء المستخدم بنجاح في الخلفية.
الرميات
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

المعلمات
userId ‫int: تمثّل هذه السمة المستخدم الذي سيتم تشغيل التطبيق في الخلفية.
waitFlag سيؤدي استخدام boolean إلى إيقاف الأمر مؤقتًا إلى أن يتم بدء تشغيل المستخدم وفتح قفله.
المرتجعات
boolean تعرض القيمة "true" إذا تم بدء المستخدم بنجاح في الخلفية.
الرميات
DeviceNotAvailableException

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

يبدأ مستخدمًا معيّنًا في الخلفية، ويكون مرئيًا في الشاشة المحدّدة (أي يسمح للمستخدم بتشغيل الأنشطة في تلك الشاشة).

ملاحظة: لا يتحقّق هذا الأمر مما إذا كان المستخدم موجودًا أو ما إذا كان العرض متاحًا أو device supports such feature أو غير ذلك.

المعلمات
userId ‫int: تمثّل هذه السمة المستخدم الذي سيتم تشغيل التطبيق في الخلفية.
displayId ‫int: عرض بدء ظهور المستخدم
waitFlag سيؤدي استخدام boolean إلى إيقاف الأمر مؤقتًا إلى أن يتم بدء تشغيل المستخدم وفتح قفله.
المرتجعات
boolean ‫true إذا تم بدء المستخدم بنجاح في الخلفية
الرميات
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

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

المعلمات
userId int: تمثّل هذه السمة معرّف المستخدم الذي سيتم إيقافه.
المرتجعات
boolean صحيح إذا تم إيقاف المستخدم بنجاح.
الرميات
DeviceNotAvailableException

stopUser

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

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

المعلمات
userId int: تمثّل هذه السمة معرّف المستخدم الذي سيتم إيقافه.
waitFlag ‫boolean: سيؤدي إلى انتظار الأمر إلى أن يتم إيقاف المستخدم.
forceFlag ‫boolean: سيتم فرض إيقاف المستخدم.
المرتجعات
boolean صحيح إذا تم إيقاف المستخدم بنجاح.
الرميات
DeviceNotAvailableException

supportsMicrodroid

public boolean supportsMicrodroid ()

للتحقّق من الشروط المسبقة لتشغيل جهاز microdroid

المرتجعات
boolean تعرض القيمة true إذا تم استيفاء الشروط المسبقة، والقيمة false في الحالات الأخرى.

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

للتحقّق من الشروط المسبقة لتشغيل جهاز microdroid

المعلمات
protectedVm ‫boolean: تكون القيمة true إذا كان من المفترض أن يتم تشغيل microdroid على جهاز افتراضي محمي.
المرتجعات
boolean تعرض القيمة true إذا تم استيفاء الشروط المسبقة، والقيمة false في الحالات الأخرى.

switchUser

public boolean switchUser (int userId)

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

المعلمات
userId int

المرتجعات
boolean تعرض القيمة "صحيح" إذا كان رقم تعريف المستخدم الجديد يتطابق مع موفّر رقم تعريف المستخدم. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.
الرميات
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId, 
                long timeout)

بدِّل إلى userId آخر مع تحديد المهلة المقدَّمة كموعد نهائي. محاولة إيقاف قفل الشاشة بعد نجاح عملية تبديل المستخدم

المعلمات
userId int

timeout ‫long: للانتظار قبل عرض القيمة false في حال تعذُّر التبديل بين المستخدمين
المرتجعات
boolean تعرض القيمة "صحيح" إذا كان رقم تعريف المستخدم الجديد يتطابق مع موفّر رقم تعريف المستخدم. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.
الرميات
DeviceNotAvailableException

takeBugreport

public Bugreport takeBugreport ()

تأخذ هذه الدالة تقرير خطأ وتعرضه داخل عنصر Bugreport للتعامل معه. تعرِض قيمة فارغة في حال حدوث مشكلة. يجب تنظيف الملف المشار إليه في عنصر Bugreport باستخدام Bugreport.close().

المرتجعات
Bugreport

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

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

المعلمات
currentPhase SnapuserdWaitPhase

الرميات
DeviceNotAvailableException

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

createParser

protected AaptParser createParser (File appFile)

المعلمات
appFile File

المرتجعات
AaptParser

doAdbReboot

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

نفِّذ عملية إعادة التشغيل عبر adb.

المعلمات
rebootMode ‫NativeDevice.RebootMode: وضع إعادة التشغيل هذا
reason ‫String: لإعادة التشغيل هذه.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

المرتجعات
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

طريقة مساعدة داخلية للحصول على ملف bugreportz ZIP كـ ERROR(/File).

المرتجعات
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

يتم عرضها لأغراض الاختبار.

المرتجعات
long

getHostCurrentTime

protected long getHostCurrentTime ()

معرَّض للاختبار

المرتجعات
long

prePostBootSetup

protected void prePostBootSetup ()

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

الرميات
DeviceNotAvailableException