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

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

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 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 waitFlag, boolean forceFlag)

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

boolean stopUser(int userId)

يوقف مستخدمًا معيّنًا.

boolean supportsMicrodroid()

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

boolean supportsMicrodroid(boolean protectedVm)

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

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

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

Bugreport takeBugreport()

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

String uninstallPackage(String packageName)

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

String uninstallPackageForUser(String packageName, int userId)

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

void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

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

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

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

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

TestDevice

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

الطرق العامة

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

المرتجعات
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, 
                boolean forTesting)

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

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

createUser

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

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

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

createUserNoThrow

public int createUserNoThrow (String name)

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

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

disableKeyguard

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

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"}
المرتجعات
خريطة أزواج المفتاح/القيمة قيمة فارغة إذا لم تكن مساحة الاسم متاحة.
عمليات الرمي
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

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 userId للمستخدم الرئيسي إذا كان هناك مستخدم رئيسي، وقيمة فارغة إذا لم يكن هناك مستخدم رئيسي
عمليات الرمي
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

الحصول على الحد الأقصى لعدد المستخدمين المسموح لهم بالتشغيل المتزامن القيمة التلقائية هي 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 من لقطة الشاشة بتنسيق png أو 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

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

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

المعلمات
packageName String: الحزمة التي نتحقّق مما إذا كانت مثبّتة.
userId 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 صحيح إذا تم تشغيل المستخدم بنجاح في الخلفية.
عمليات الرمي
DeviceNotAvailableException

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

المعلمات
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: صحيح إذا كان من المخطَّط تشغيل microdroid على جهاز افتراضي محمي.
المرتجعات
boolean تعرِض true إذا تم استيفاء الشروط المسبقة، وتعرِض false في الحالات الأخرى.

switchUser

public boolean switchUser (int 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

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

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

المرتجعات
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

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

المرتجعات
long

getHostCurrentTime

protected long getHostCurrentTime ()

متاح للاختبار

المرتجعات
long

prePostBootSetup

protected void prePostBootSetup ()

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

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