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 

الحقول

public static final String DISMISS_KEYGUARD_CMD

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

وظائف الإنشاء العامة

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

الطرق العامة

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

جلب المعلومات عن حسابات APEX التي تم تفعيلها على الجهاز

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

الحصول على الحد الأقصى لعدد الأجهزة المتوافقة التي تعمل بنظام التشغيل Android في آنٍ واحد

int getMaxNumberOfUsersSupported()

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

Integer getPrimaryUserId()

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

InputStreamSource getScreenshot()

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

InputStreamSource getScreenshot(String format, boolean rescale)

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

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot(String format)

يحصل على لقطة شاشة من الجهاز.

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)

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

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

String installPackagesForUser( packageFiles, boolean reinstall, 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)

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

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)

بدِّل إلى 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)

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

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

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

InputStreamSource getBugreportInternal()
File getBugreportzInternal()

طريقة المساعدة الداخلية للحصول على ملف zip لتقرير bugreportz بتنسيق ERROR(/File)

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)

الطرق العامة

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

مربعات حوار clearErrors

public boolean clearErrorDialogs ()

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

المرتجعات
boolean true إذا لم تكن هناك مربّعات حوار أو تم محو مربّعات الحوار بنجاح. false بخلاف ذلك
عمليات الرمي
DeviceNotAvailableException

createUser

public int createUser (String name)

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

المعلمات
name String: للمستخدم المطلوب إنشاؤه على الجهاز
المرتجعات
int العدد الصحيح لمعرّف المستخدم الذي تم إنشاؤه
عمليات الرمي
DeviceNotAvailableException

إنشاء مستخدم

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

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

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

إنشاء مستخدم

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

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

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

createUserNoThrow

public int createUserNoThrow (String name)

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

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

إيقاف قفل المفاتيح

public void disableKeyguard ()

يحاول إيقاف شاشة القفل.

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

الرميات
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

ويفعل الملف

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

محاولة تفريغ الحِزمة من system_server ويقع على عاتق المتصل مسؤولية حذف الملف الذي تم تفريغه.

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

الحصول على ActiveApexes

public  getActiveApexes ()

جلب المعلومات عن حسابات APEX التي تم تفعيلها على الجهاز

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

getAllSettings

public  getAllSettings (String namespace)

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

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

getAndroidId

public String getAndroidId (int userId)

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

المعلمات
userId int

المرتجعات
String

الرميات
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

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

المرتجعات
تم العثور على خريطة لأرقام تعريف 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 ()

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

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

المرتجعات
InputStreamSource InputStreamSource الذي سيُنشئ محتوى تقرير الأخطاء عند الطلب في حال تعذُّر ذلك، سيُنشئ InputStreamSource ERROR(/InputStream) فارغًا.

getBugreportz

public InputStreamSource getBugreportz ()

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

لا تتوفّر هذه الميزة إلا لإصدار "adb" الأحدث من 1.0.36.

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

الحالة getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

المرتجعات
DeviceFoldableState

الرميات
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

المرتجعات
int

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

الحالات القابلة للطي

public  getFoldableStates ()

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

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

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

الحصول على KeyguardState

public KeyguardControllerState getKeyguardState ()

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

المرتجعات
KeyguardControllerState KeyguardControllerState يحتوي على لقطة شاشة لحالة شاشة القفل ويعرض القيمة Null إذا لم يكن طلب البحث عن شاشة القفل متوافقًا.
عمليات الرمي
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

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

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

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

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

public int getMaxNumberOfRunningUsersSupported ()

الحصول على الحد الأقصى لعدد الأجهزة المتوافقة التي تعمل بنظام التشغيل Android في آنٍ واحد القيمة التلقائية هي 0.

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

getPrimaryUserId

public Integer getPrimaryUserId ()

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

المرتجعات
Integer userId للمستخدم الأساسي إذا كان موجودًا، وتكون فارغة إذا لم يكن هناك مستخدم أساسي.
عمليات الرمي
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot ()

يحصل على لقطة شاشة من الجهاز.

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

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

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

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

getScreenshot

public InputStreamSource getScreenshot (String format)

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

المعلمات
format String: يمكن استخدام تنسيقات PNG وJPEG
المرتجعات
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)

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

المعلمات
userId int

namespace String

key String

المرتجعات
String القيمة المرتبطة بـ namespace:key الخاصة بمستخدم قيمة فارغة إذا لم يتم العثور على القيمة
عمليات الرمي
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

المرتجعات
ERROR(/Set) من أسماء الحِزم String التي لا يمكن إلغاء تثبيتها والمثبَّتة حاليًا على الجهاز
عمليات الرمي
DeviceNotAvailableException

الحصول على علامات المستخدم

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)

اعرض الرقم التسلسلي المرتبط بمعرّف المستخدم (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, 
                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

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

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

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

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

المعلمات
packageName String

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

تم تثبيت الحزمة

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

isUserRunning

public boolean isUserRunning (int userId)

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

المعلمات
userId int

المرتجعات
boolean True إذا كان المستخدم قيد التشغيل، وfalse في كل الحالات الأخرى.
عمليات الرمي
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

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

المعلمات
userId int

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

isUserVisible

public boolean isUserVisible (int userId)

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

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

المعلمات
userId int

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isUserمرئيOnDisplay

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

إزالة مستخدم

public boolean removeUser (int userId)

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

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

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

مستخدم البدء

public boolean startUser (int userId)

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

المعلمات
userId int: للمستخدم للبدء في الخلفية
المرتجعات
boolean صحيح إذا تم تشغيل المستخدم بنجاح في الخلفية.
الرميات
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

المعلمات
userId int: للمستخدم للبدء في الخلفية
waitFlag boolean: سيجعل الأمر ينتظر حتى يتم بدء تشغيل المستخدم وفتح قفله.
المرتجعات
boolean صحيح إذا تم تشغيل المستخدم بنجاح في الخلفية.
عمليات الرمي
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, 
                boolean waitFlag, 
                boolean forceFlag)

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

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

stopUser

public boolean stopUser (int userId)

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

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

supportsMicrodroid

public boolean supportsMicrodroid ()

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

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

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

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

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

مبدِّل المستخدِم

public boolean switchUser (int userId)

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

المعلمات
userId int

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

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

المعلمات
userId int

timeout long: الانتظار قبل عرض قيمة false لخطأ switch-user
المرتجعات
boolean صحيح إذا كان معرّف المستخدم الجديد يتطابق مع مقدّم معرّف المستخدم. خطأ في الحالات الأخرى.
عمليات الرمي
DeviceNotAvailableException

takeBugreport

public Bugreport takeBugreport ()

تأخذ تقرير أخطاء وتُعيده داخل عنصر Bugreport للتعامل معه. عرض القيمة null في حال حدوث مشكلة يجب تنظيف الملف المُشار إليه في عنصر 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

إعادة تشغيل

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

طريقة المساعدة الداخلية للحصول على ملف zip لتقرير bugreportz بتنسيق ERROR(/File)

المرتجعات
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

تمّ عرضها للاختبار.

المرتجعات
long

getHostCurrentTime

protected long getHostCurrentTime ()

المجموعة التجريبية للاختبار

المرتجعات
long

prePostBootSetup

protected void prePostBootSetup ()

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

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