جهاز ITest

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


يوفر واجهة برمجة تطبيقات موثوقة وذات مستوى أعلى قليلاً لجهاز ddmlib IDevice .

يعيد أوامر الجهاز لمقدار قابل للتكوين ، ويوفر واجهة استرداد للجهاز للأجهزة التي لا تستجيب.

ملخص

فئات متداخلة

class ITestDevice.ApexInfo

فئة بنية بسيطة لتخزين معلومات حول APEX واحد

class ITestDevice.MountPointInfo

فئة بنية بسيطة لتخزين المعلومات حول نقطة تحميل واحدة

enum ITestDevice.RecoveryMode

الطرق العامة

abstract boolean checkConnectivity ()

تحقق من اتصال الجهاز بالشبكة.

abstract boolean clearErrorDialogs ()

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

abstract void clearLastConnectedWifiNetwork ()

مسح آخر شبكة wifi متصلة.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

يتصل بشبكة wifi.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

يتصل بشبكة wifi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

يتصل بشبكة wifi.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

يتصل بشبكة wifi.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

متغير من connectToWifiNetwork(String, String) يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

متغير من connectToWifiNetwork(String, String) لا يتصل إلا إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.

abstract int createUser (String name)

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

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

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

abstract int createUserNoThrow (String name)

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

abstract void disableKeyguard ()

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

abstract boolean disableNetworkMonitor ()

تعطيل مراقبة الشبكة على الجهاز.

abstract boolean disconnectFromWifi ()

قطع الاتصال بشبكة wifi.

abstract boolean doesFileExist (String deviceFilePath, int userId)

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

abstract File dumpHeap (String process, String devicePath)

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

abstract boolean enableNetworkMonitor ()

تمكن مراقبة الشبكة على الجهاز.

abstract getActiveApexes ()

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

abstract getAllSettings (String namespace)

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

abstract String getAndroidId (int userId)

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

abstract getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract getAppPackageInfos ()

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

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

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

abstract getFoldableStates ()

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

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

يحصل على عنوان IP الخاص بالجهاز.

abstract KeyguardControllerState getKeyguardState ()

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

abstract getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

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

abstract int getMaxNumberOfUsersSupported ()

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

abstract TestDeviceOptions getOptions ()

إحضار خيارات الاختبار للجهاز.

abstract Integer getPrimaryUserId ()

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

abstract InputStreamSource getScreenshot ()

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

abstract InputStreamSource getScreenshot (String format, boolean rescale)

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

abstract InputStreamSource getScreenshot (String format)

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

abstract InputStreamSource getScreenshot (long displayId)

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

abstract String getSetting (String namespace, String key)

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

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

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

abstract getUninstallablePackageNames ()

قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها.

abstract int getUserFlags (int userId)

ابحث عن أعلام مستخدم معين وقم بإعادتها.

abstract getUserInfos ()

يحصل على خريطة معرف الاستخدام UserInfo المستخدم على الجهاز.

abstract int getUserSerialNumber (int userId)

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

abstract boolean hasFeature (String feature)

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

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

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

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

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

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

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

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

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

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزمة واحدة رئيسية وحزم مقسمة إضافية).

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) موجودة على جهاز Android.

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) لمستخدم معين.

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) لمستخدم معين.

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) موجودة على جهاز Android.

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) موجودة على جهاز Android.

abstract boolean isMultiUserSupported ()

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

abstract boolean isPackageInstalled (String packageName)

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

abstract boolean isPackageInstalled (String packageName, String userId)

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

abstract boolean isUserRunning (int userId)

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

abstract boolean isUserSecondary (int userId)

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

abstract boolean isWifiEnabled ()

اختبر ما إذا تم تمكين wifi.

abstract listDisplayIds ()

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

abstract listUsers ()

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

abstract boolean removeAdmin (String componentName, int userId)

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

abstract void removeOwners ()

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

abstract boolean removeUser (int userId)

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

abstract boolean setDeviceOwner (String componentName, int userId)

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

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

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

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

أضف قيمة الإعداد إلى مساحة الاسم لمستخدم معين.

abstract boolean startUser (int userId)

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

abstract boolean startUser (int userId, boolean waitFlag)

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

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

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

abstract boolean stopUser (int userId)

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

abstract boolean switchUser (int userId)

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

abstract boolean switchUser (int userId, long timeout)

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

abstract String uninstallPackage (String packageName)

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

abstract String uninstallPackageForUser (String packageName, int userId)

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

الطرق العامة

تحقق من الاتصال

public abstract boolean checkConnectivity ()

تحقق من اتصال الجهاز بالشبكة.

عائدات
boolean true إذا كان الجهاز به اتصال شبكة يعمل ، false في الاتجاه المعاكس.

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

مسح آخر شبكة wifi متصلة. يجب استدعاء هذا عند بدء استدعاء جديد لتجنب الاتصال بشبكة wifi المستخدمة في الاختبار السابق بعد إعادة تشغيل الجهاز.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

يتصل بشبكة wifi.

يقوم بتشغيل wifi والحظر حتى يتم إجراء اتصال ناجح بإحدى شبكات wifi الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال ، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل حتى يتم ITestDevice#disconnectFromWifi() أو ITestDevice#clearLastConnectedWifiNetwork() .

المعلمات
wifiSsidToPsk : خريطة wifi SSID لكلمات المرور.

scanSsid boolean : ما إذا كان سيتم البحث عن معرّفات SSID المخفية لهذه الشبكة.

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

يتصل بشبكة wifi.

يقوم بتشغيل wifi والحظر حتى يتم إجراء اتصال ناجح بإحدى شبكات wifi الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال ، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل حتى يتم ITestDevice#disconnectFromWifi() أو ITestDevice#clearLastConnectedWifiNetwork() .

المعلمات
wifiSsidToPsk : خريطة wifi SSID لكلمات المرور.

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

يتصل بشبكة wifi.

يقوم بتشغيل wifi والحظر حتى يتم إجراء اتصال ناجح بشبكة wifi المحددة. بمجرد إجراء الاتصال ، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل حتى يتم ITestDevice#disconnectFromWifi() أو ITestDevice#clearLastConnectedWifiNetwork() .

المعلمات
wifiSsid String : wifi ssid للاتصال به

wifiPsk String : عبارة مرور PSK أو خالية إذا لم يتم تشفيرها

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

يتصل بشبكة wifi.

يقوم بتشغيل wifi والحظر حتى يتم إجراء اتصال ناجح بشبكة wifi المحددة. بمجرد إجراء الاتصال ، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل حتى يتم ITestDevice#disconnectFromWifi() أو ITestDevice#clearLastConnectedWifiNetwork() .

المعلمات
wifiSsid String : wifi ssid للاتصال به

wifiPsk String : عبارة مرور PSK أو خالية إذا لم يتم تشفيرها

scanSsid boolean : ما إذا كان سيتم البحث عن SSID المخفي لهذه الشبكة.

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

متغير من connectToWifiNetwork(String, String) يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.

المعلمات
scanSsid boolean : ما إذا كان سيتم البحث عن SSID المخفي لهذه الشبكة

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

متغير من connectToWifiNetwork(String, String) يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

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

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

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

رميات
DeviceNotAvailableException

createUser

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

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

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

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

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

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

رميات
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

رميات
DeviceNotAvailableException

تعطيل Keyguard

public abstract void disableKeyguard ()

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

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

رميات
DeviceNotAvailableException

DisableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

تعطيل مراقبة الشبكة على الجهاز.

عائدات
boolean true إذا تم تعطيل المراقبة بنجاح. false إذا فشلت.

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

قطع الاتصال من واي فاي

public abstract boolean disconnectFromWifi ()

قطع الاتصال بشبكة wifi.

يزيل جميع الشبكات من قائمة الشبكات المعروفة ويعطل wifi.

عائدات
boolean true إذا تم قطع الاتصال بشبكة wifi بنجاح. false إذا فشل قطع الاتصال.

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

كومة

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

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

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

رميات
DeviceNotAvailableException

تمكين NetworkMonitor

public abstract boolean enableNetworkMonitor ()

تمكن مراقبة الشبكة على الجهاز.

عائدات
boolean true إذا تم تمكين المراقبة بنجاح. false إذا فشلت.

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

getActiveApexes

public abstract  getActiveApexes ()

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

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

رميات
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

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

رميات
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

المعلمات
userId int

عائدات
String

رميات
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

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

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

رميات
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

المعلمات
packageName String

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

رميات
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

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

رميات
DeviceNotAvailableException

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

عائدات
DeviceFoldableState

رميات
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

عائدات
int

رميات
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

عائدات

رميات
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

رميات
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

يحصل على عنوان IP الخاص بالجهاز.

عائدات
String عنوان IP الخاص بالجهاز ، أو null إذا لم يكن للجهاز عنوان IP

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

رميات
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

رميات
DeviceNotAvailableException

getMaxNumberOfUsers المدعومة

public abstract int getMaxNumberOfUsersSupported ()

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

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

رميات
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

إحضار خيارات الاختبار للجهاز.

عائدات
TestDeviceOptions TestDeviceOptions المتعلقة بالجهاز قيد الاختبار.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

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

رميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException إذا كان الإخراج من الجهاز ليس كما هو متوقع.
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot ()

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

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

رميات
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

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

رميات
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot (String format)

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

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

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

رميات
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

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

رميات
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

المعلمات
namespace String

key String

عائدات
String

رميات
DeviceNotAvailableException

getSetting

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

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

المعلمات
userId int

namespace String

key String

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

رميات
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

رميات
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

المعلمات
userId int

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

رميات
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

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

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

المعلمات
userId int

عائدات
int

رميات
DeviceNotAvailableException

ميزة

public abstract boolean hasFeature (String feature)

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

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

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

رميات
DeviceNotAvailableException

ثبت المجموعة

public abstract String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

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

المعلمات
packageFile File : ملف apk للتثبيت

reinstall boolean : true إذا كان يجب إجراء إعادة التثبيت

extraArgs String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة.

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

ثبت المجموعة

public abstract 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 في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.
UnsupportedOperationException إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز.

installPackageForUser

public abstract 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 في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.
UnsupportedOperationException إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز.

installPackageForUser

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

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

المعلمات
packageFile File : ملف apk للتثبيت

reinstall boolean : true إذا كان يجب إجراء إعادة التثبيت

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

extraArgs String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة.

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

تثبيت الحزم

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزمة واحدة رئيسية وحزم مقسمة إضافية). راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم apk إلى عدة ملفات.

المعلمات
packageFiles : ملفات apk المحلية

reinstall boolean : true إذا كان يجب إجراء إعادة التثبيت

extraArgs String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة.

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.
UnsupportedOperationException إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز.

تثبيت الحزم

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) موجودة على جهاز Android. راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم apk إلى عدة ملفات.

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

المعلمات
packageFiles : مسارات ملفات apk البعيدة المراد تثبيتها

reinstall boolean : true إذا كان يجب إجراء إعادة التثبيت

grantPermissions boolean : إذا كان يجب منح جميع أذونات وقت التشغيل في وقت التثبيت

extraArgs String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة.

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.
UnsupportedOperationException إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز.

installPackagesForUser

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) لمستخدم معين. راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم apk إلى عدة ملفات.

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

المعلمات
packageFiles : ملفات apk المحلية

reinstall boolean : true إذا كان يجب إجراء إعادة التثبيت

grantPermissions boolean : إذا كان يجب منح جميع أذونات وقت التشغيل في وقت التثبيت

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

extraArgs String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة.

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.
UnsupportedOperationException إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز.

installPackagesForUser

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) لمستخدم معين. راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم apk إلى عدة ملفات.

المعلمات
packageFiles : ملفات apk المحلية

reinstall boolean : true إذا كان يجب إجراء إعادة التثبيت

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

extraArgs String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة.

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.
UnsupportedOperationException إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز.

installRemotePackages

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) موجودة على جهاز Android. راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم apk إلى عدة ملفات.

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

المعلمات
remoteApkPaths : مسارات ملفات apk البعيدة

reinstall boolean : true إذا كان يجب إجراء إعادة التثبيت

grantPermissions boolean : إذا كان يجب منح جميع أذونات وقت التشغيل في وقت التثبيت

extraArgs String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة.

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.
UnsupportedOperationException إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز.

installRemotePackages

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

قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) موجودة على جهاز Android. راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم apk إلى عدة ملفات.

المعلمات
remoteApkPaths : مسارات ملفات apk البعيدة

reinstall boolean : true إذا كان يجب إجراء إعادة التثبيت

extraArgs String : وسيطات إضافية اختيارية لتمريرها. راجع "adb shell pm -h" لمعرفة الخيارات المتاحة.

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.
UnsupportedOperationException إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز.

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

رميات
DeviceNotAvailableException

isPackage مثبت

public abstract boolean isPackageInstalled (String packageName)

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

المعلمات
packageName String

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

رميات
DeviceNotAvailableException

isPackage مثبت

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

رميات
DeviceNotAvailableException

قيد التشغيل

public abstract boolean isUserRunning (int userId)

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

المعلمات
userId int

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

رميات
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

المعلمات
userId int

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

رميات
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

اختبر ما إذا تم تمكين wifi.

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

عائدات
boolean true إذا تم تمكين wifi. false إذا تم تعطيله

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

listDisplayIds

public abstract  listDisplayIds ()

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

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

رميات
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

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

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

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

إزالة

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

رميات
DeviceNotAvailableException

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

public abstract void removeOwners ()

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

رميات
DeviceNotAvailableException

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

public abstract boolean removeUser (int userId)

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

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

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

رميات
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

رميات
DeviceNotAvailableException

ضبط

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

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

المعلمات
namespace String

key String

value String

رميات
DeviceNotAvailableException

ضبط

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

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

المعلمات
userId int

namespace String

key String

value String

رميات
DeviceNotAvailableException

بدء المستخدم

public abstract boolean startUser (int userId)

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

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

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

رميات
DeviceNotAvailableException

بدء المستخدم

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

رميات
DeviceNotAvailableException

stopUser

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

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

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

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

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

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

رميات
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

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

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

رميات
DeviceNotAvailableException

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

public abstract boolean switchUser (int userId)

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

المعلمات
userId int

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

رميات
DeviceNotAvailableException

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

public abstract boolean switchUser (int userId, 
                long timeout)

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

المعلمات
userId int

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

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

رميات
DeviceNotAvailableException

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

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

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

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

رميات
DeviceNotAvailableException في حالة فقد الاتصال بالجهاز ولا يمكن استعادته.