جهاز اختباري

public class TestDevice
extends NativeDevice

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

الفئات الفرعية المباشرة المعروفة ManagedRemoteDevice وNestedRemoteDevice وRemoteAndroidDevice managedRemoteDevice يشير هذا المصطلح إلى جهاز يعمل داخل آلة افتراضية نديرها عن بُعد من خلال مثيل مقابس داخلها على جهاز افتراضي.  NestedRemoteDevice تمثيل للجهاز الذي يعمل داخل جهاز افتراضي لسمكة حبَّار عن بُعد  RemoteAndroidDevice تنفيذ ITestDevice لمجموعة كاملة من أجهزة Android المتصلة عبر adb Connect.

الفئات الفرعية المعروفة غير المباشرة LocalAndroidVirtualDevice وRemoteAndroidVirtualDevice LocalAndroidVirtualDevice فئة الأجهزة الافتراضية المحلية التي تعمل على مضيف TradeFed.  RemoteAndroidVirtualDevice تعمل هذه السياسة على تمديد سلوك "RemoteAndroidDevice" لجهاز Android المكدّس الذي يعمل في Google Compute Engine (Gce)

---

تنفيذ ITestDevice لجهاز Android الذي يحتوي على حزمة كاملة من الأجهزة

ملخّص

الصفوف المتداخلة
class	TestDevice.MicrodroidBuilder أداة إنشاء تُستخدم لإنشاء Microdroid TestDevice.

الحقول
public static final 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, 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() استرجاع المعلومات حول ملفات APK التي تم تفعيلها على الجهاز
	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(String format) يحصل على لقطة شاشة من الجهاز.
InputStreamSource	getScreenshot(long displayId) يحصل على لقطة شاشة من الجهاز الذي تم تقديم رقم تعريف الشاشة فيه.
String	getSetting(String namespace, String key) يمكنك الاطّلاع على getSetting(int, String, String) وتنفيذها على مستخدم النظام.
String	getSetting(int userId, String namespace, String key) عرض قيمة الإعداد المطلوب.
	getUninstallablePackageNames() جلب أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها.
int	getUserFlags(int userId) يمكنك العثور على علامات مستخدم معيّن وعرضها.
	getUserInfos() يحصل على خريطة UseId إلى UserInfo على الجهاز.
int	getUserSerialNumber(int userId) اعرض الرقم التسلسلي المرتبط برقم تعريف المستخدم (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) يوقِف الجهاز المصغّر، إن وجد.
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() يتحقق من الشروط المسبقة لتشغيل جهاز مصغّر.
boolean	supportsMicrodroid(boolean protectedVm) يتحقق من الشروط المسبقة لتشغيل جهاز مصغّر.
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 المضغوط كملف 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)

الطرق العامة

مستخدم canSwitchToHeadlessSystem

public boolean canSwitchToHeadlessSystemUser ()

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

مربعات حوار clearErrors

public boolean clearErrorDialogs ()

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

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

الرميات
DeviceNotAvailableException

إنشاء مستخدم

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: تفعيل ميزة إبلاغ المستخدم عن الحدث --الضيف أثناء الإنشاء
ephemeral	boolean: تفعيل علامة المستخدم -- المؤقتة أثناء الإنشاء
forTesting	boolean: تفعيل علامة الاختبار --للاختبار أثناء الإنشاء

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

الرميات
DeviceNotAvailableException

إنشاء مستخدم

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

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

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

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

الرميات
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

المعلمات
name	String: للمستخدم المطلوب إنشاؤه على الجهاز

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

الرميات
DeviceNotAvailableException

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

public void disableKeyguard ()

محاولات لإيقاف حارس المفاتيح.

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

الرميات
DeviceNotAvailableException

حالة الملف

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: اسم عملية تفريغ البيانات على الجهاز
devicePath	String: المسار على الجهاز حيث يتم وضع النفايات يجب أن يكون هذا موقعًا جغرافيًا الأذونات التي تسمح بها.

المرتجعات
File	ERROR(/File) الذي يحتوي على التقرير. قيمة فارغة في حال حدوث خطأ.

الرميات
DeviceNotAvailableException

الحصول على ActiveApexes

public  getActiveApexes ()

استرجاع المعلومات حول ملفات APK التي تم تفعيلها على الجهاز

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

الرميات
DeviceNotAvailableException

الحصول على جميع الإعدادات

public  getAllSettings (String namespace)

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

المعلمات
namespace	String: يجب أن يكون أحد ما يلي {"system", "secure", "global"}

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

الرميات
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

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

المعلمات
userId	int

المرتجعات
String

الرميات
DeviceNotAvailableException

getAndroidId

public  getAndroidIds ()

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

المرتجعات
	تم العثور على خريطة لأرقام تعريف Android مطابقة لأرقام تعريف المستخدمين.

الرميات
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

المعلمات
packageName	String

المرتجعات
PackageInfo	PackageInfo أو null إذا تعذّر استرداد المعلومات.

الرميات
DeviceNotAvailableException

الحصول على AppPackageInfos

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، عليك إرجاع القيمة null (فارغ) في حالة الفشل.

الحالة getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

المرتجعات
DeviceFoldableState

الرميات
DeviceNotAvailableException

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

public int getCurrentUser ()

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

المرتجعات
int

الرميات
DeviceNotAvailableException

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

public  getFoldableStates ()

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

المرتجعات

الرميات
DeviceNotAvailableException

أسماء الحِزم المُثبّتة

public  getInstalledPackageNames ()

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

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

الرميات
DeviceNotAvailableException

الحصول على KeyguardState

public KeyguardControllerState getKeyguardState ()

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

المرتجعات
KeyguardControllerState	جهاز KeyguardControllerState يحتوي على نبذة عن حالة قفل المفاتيح وتعرض "Null" (فارغ) إذا لم يكن استعلام لوحة المفاتيح متاحًا.

الرميات
DeviceNotAvailableException

الحصول على معرّف المستخدم الرئيسي

public Integer getMainUserId ()

تعرض رقم تعريف المستخدم الرئيسي.

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

الرميات
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

الرميات
DeviceNotAvailableException

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

public int getMaxNumberOfRunningUsersSupported ()

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

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

الرميات
DeviceNotAvailableException

الحصول على MaxNumberOfUsers مجددًا

public int getMaxNumberOfUsersSupported ()

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

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

الرميات
DeviceNotAvailableException

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

public Integer getPrimaryUserId ()

تعرض معرّف المستخدم الأساسي.

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

الرميات
DeviceNotAvailableException

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

public InputStreamSource getScreenshot ()

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

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

الرميات
DeviceNotAvailableException

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

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

المعلمات
format	String: يمكن استخدام تنسيقات PNG وJPEG
rescale	boolean: إذا كان يجب إعادة ضبط لقطة الشاشة لتقليل حجم الصورة الناتجة

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

الرميات
DeviceNotAvailableException

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

public InputStreamSource getScreenshot (String format)

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

المعلمات
format	String: يمكن استخدام تنسيقات PNG وJPEG

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

الرميات
DeviceNotAvailableException

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

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

الرميات
DeviceNotAvailableException

الإعداد

public String getSetting (String namespace, 
                String key)

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

المعلمات
namespace	String
key	String

المرتجعات
String

الرميات
DeviceNotAvailableException

الإعداد

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

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

المعلمات
userId	int
namespace	String
key	String

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

الرميات
DeviceNotAvailableException

الحصول على UninstallablePackageNames

public  getUninstallablePackageNames ()

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

المرتجعات
	ERROR(/Set) من أسماء حزمة String القابلة للإزالة المثبّتة حاليًا على الخاص بك.

الرميات
DeviceNotAvailableException

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

public int getUserFlags (int userId)

يمكنك العثور على علامات مستخدم معيّن وعرضها. يتم تحديد العلامات في "android.content.pm.UserInfo" الصف في مشروع مفتوح المصدر لنظام Android.

المعلمات
userId	int

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

الرميات
DeviceNotAvailableException

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

public  getUserInfos ()

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

المرتجعات
	قائمة كائنات UserInfo.

الرميات
DeviceNotAvailableException

الحصول على UserSerialNumber

public int getUserSerialNumber (int userId)

اعرض الرقم التسلسلي المرتبط برقم تعريف المستخدم (userId) إن تم العثور عليه، والذي يبلغ -10000 في أي حالات أخرى.

المعلمات
userId	int

المرتجعات
int

الرميات
DeviceNotAvailableException

تحتوي على ميزة

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

حزم install

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

المعلمات
packageFiles
reinstall	boolean
extraArgs	String

المرتجعات
String

الرميات
DeviceNotAvailableException

حزم install

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

متوافق مع عبارة isAppEnumeration

public boolean isAppEnumerationSupported ()

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

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

الرميات
DeviceNotAvailableException

isheadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

متوافق مع متعدد المستخدمين

public boolean isMultiUserSupported ()

يُحدِّد هذا الإعداد ما إذا كانت الميزة متاحة لمستخدمين متعددين.

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

الرميات
DeviceNotAvailableException

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

public boolean isPackageInstalled (String packageName)

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

المعلمات
packageName	String

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

الرميات
DeviceNotAvailableException

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

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

الرميات
DeviceNotAvailableException

قيد التشغيل

public boolean isUserRunning (int userId)

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

المعلمات
userId	int

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

الرميات
DeviceNotAvailableException

مستخدم ثانوي

public boolean isUserSecondary (int userId)

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

المعلمات
userId	int

المرتجعات
boolean	true إذا كان المستخدم ثانويًا، وعلى false في الحالات الأخرى.

الرميات
DeviceNotAvailableException

يكون Userمرئي

public boolean isUserVisible (int userId)

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

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

المعلمات
userId	int

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isUserمرئيOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

المعلمات
userId	int
displayId	int

المرتجعات
boolean

الرميات
DeviceNotAvailableException

متاح

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

متاح

public boolean isVisibleBackgroundUsersSupported ()

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

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

أرقام تعريف قائمة العرض

public  listDisplayIds ()

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

المرتجعات
	قائمة الشاشات يُرجع الإعداد التلقائي دائمًا قيمة العرض التلقائي 0.

الرميات
DeviceNotAvailableException

listDisplayIdsForOpenVisualUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

الحصول على قائمة الشاشات التي يمكن استخدامها من أجل start a user visible in the background.

المرتجعات

الرميات
DeviceNotAvailableException

قائمة المستخدمين

public  listUsers ()

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

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

الرميات
DeviceNotAvailableException

LogBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

طريقة مساعِدة لتدوين تقرير خطأ وتسجيله للمراسلين الصحفيين

المعلمات
dataName	String: الاسم الذي سيتم الإبلاغ بموجبه عن تقرير الأخطاء
listener	ITestLogger: ITestLogger لتسجيل تقرير الخطأ

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

إرسال إشعار

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

المعلمات
waitPhase	SnapuserdWaitPhase

سلسلة إجراءات ما بعد الاستدعاء

public void postInvocationTearDown (Throwable exception)

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

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

إزالة مسؤول

public boolean removeAdmin (String componentName, 
                int userId)

عليك إزالة مشرف الجهاز المحدّد من مستخدم معيّن وعرض true إذا تم ذلك بنجاح، أو عرض false بخلاف ذلك.

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

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

الرميات
DeviceNotAvailableException

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

public void removeOwners ()

يمكنك إزالة جميع مالكي الملفات الشخصية الحالية للأجهزة مع بذل قصارى جهدك.

الرميات
DeviceNotAvailableException

إزالة مستخدم

public boolean removeUser (int userId)

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

المعلمات
userId	int: للمستخدم المطلوب إزالته

المرتجعات
boolean	true إذا نجحنا في إزالة المستخدم، على false وإلا.

الرميات
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

ضبط مكوِّن مشرف الجهاز كمالك للجهاز في مستخدم معيَّن.

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

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

الرميات
DeviceNotAvailableException

ضبط الإعداد

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

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

المعلمات
namespace	String
key	String
value	String

الرميات
DeviceNotAvailableException

ضبط الإعداد

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

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

المعلمات
userId	int
namespace	String
key	String
value	String

الرميات
DeviceNotAvailableException

إيقاف التشغيل المصغّر

public void shutdownMicrodroid (ITestDevice microdroidDevice)

يوقِف الجهاز المصغّر، إن وجد.

المعلمات
microdroidDevice	ITestDevice

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

مستخدم البدء

public boolean startUser (int userId)

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

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

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

الرميات
DeviceNotAvailableException

مستخدم البدء

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

الرميات
DeviceNotAvailableException

مستخدم خلفية مرئي

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

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

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

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

المرتجعات
boolean	true إذا تم بدء ظهور حساب المستخدم بنجاح في الخلفية.

الرميات
DeviceNotAvailableException

إيقاف المستخدم

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

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

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

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

الرميات
DeviceNotAvailableException

إيقاف المستخدم

public boolean stopUser (int userId)

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

المعلمات
userId	int: للمستخدم المطلوب إيقافه.

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

الرميات
DeviceNotAvailableException

يدعم Microdroid

public boolean supportsMicrodroid ()

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

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

يدعم Microdroid

public boolean supportsMicrodroid (boolean protectedVm)

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

المعلمات
protectedVm	boolean: "صحيح" إذا كان الجهاز المصغّر متوافقًا مع أجهزة افتراضية محمية.

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

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

public boolean switchUser (int userId)

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

المعلمات
userId	int

المرتجعات
boolean	صحيح في حال تطابق رقم تعريف المستخدم الجديد مع موفِّر رقم تعريف المستخدم. خطأ في الحالات الأخرى.

الرميات
DeviceNotAvailableException

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

public boolean switchUser (int userId, 
                long timeout)

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

المعلمات
userId	int
timeout	long: يجب الانتظار قبل عرض الخطأ "خطأ" لتعذُّر تغيير المستخدم.

المرتجعات
boolean	صحيح في حال تطابق رقم تعريف المستخدم الجديد مع موفِّر رقم تعريف المستخدم. خطأ في الحالات الأخرى.

الرميات
DeviceNotAvailableException

TakeBugreport

public Bugreport takeBugreport ()

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

المرتجعات
Bugreport

إلغاء تثبيت الحزمة

public String uninstallPackage (String packageName)

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

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

المرتجعات
String	أو String مع رمز خطأ، أو null في حال النجاح.

الرميات
DeviceNotAvailableException

إلغاء تثبيت PackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

المعلمات
packageName	String: حزمة Android المطلوب إلغاء تثبيتها
userId	int: العدد الصحيح لرقم تعريف المستخدم المطلوب إلغاء التثبيت له

المرتجعات
String	أو String مع رمز خطأ، أو null في حال النجاح.

الرميات
DeviceNotAvailableException

انتظار لـ Snapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

المعلمات
currentPhase	SnapuserdWaitPhase

الرميات
DeviceNotAvailableException

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

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

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

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

المرتجعات
File

الحصول على CheckNewUserSleep

protected long getCheckNewUserSleep ()

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

المرتجعات
long

الحصول على المضيف الحالي

protected long getHostCurrentTime ()

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

المرتجعات
long

إعداد prePostBootSetup

protected void prePostBootSetup ()

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

الرميات
DeviceNotAvailableException