يعيد أوامر الجهاز لمقدار قابل للتكوين ، ويوفر واجهة استرداد للجهاز للأجهزة التي لا تستجيب.
فئات متداخلة |
---|
class | ITestDevice.ApexInfo فئة بنية بسيطة لتخزين معلومات حول APEX واحد |
class | ITestDevice.MountPointInfo فئة بنية بسيطة لتخزين المعلومات حول نقطة تحميل واحدة |
الأساليب العامة |
---|
abstract boolean | canSwitchToHeadlessSystemUser () إرجاع ما إذا كان مسموحًا بالانتقال إلى مستخدم النظام بدون رأس. |
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, boolean forTesting) قم بإنشاء مستخدم باسم معين والعلامات المقدمة |
abstract int | createUser (String name, boolean guest, boolean ephemeral) قم بإنشاء مستخدم باسم معين والعلامات المقدمة |
abstract int | createUserNoThrow (String name) قم بإنشاء مستخدم باسم معين وعلامات افتراضية 0. |
abstract void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) يزيل IDeviceActionReceiver المسجل. |
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 InputStreamSource | getBugreport () يسترجع تقرير خطأ من الجهاز. |
abstract InputStreamSource | getBugreportz () يسترجع تقرير الأخطاء من الجهاز. |
abstract DeviceFoldableState | getCurrentFoldableState () تُرجع الحالة القابلة للطي الحالية للجهاز أو تُرجع فارغة في حالة حدوث بعض المشكلات. |
abstract int | getCurrentUser () إرجاع معرف المستخدم الحالي قيد التشغيل. |
abstract | getFoldableStates () يُرجع قائمة الحالات القابلة للطي على الجهاز. |
abstract | getInstalledPackageNames () إحضار أسماء حزم التطبيقات الموجودة على الجهاز. |
abstract String | getIpAddress () يحصل على عنوان IP الخاص بالجهاز. |
abstract KeyguardControllerState | getKeyguardState () قم بإرجاع كائن للحصول على الحالة الحالية لحارس المفاتيح أو فارغ إذا لم يكن مدعومًا. |
abstract Integer | getMainUserId () إرجاع معرف المستخدم الرئيسي. |
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, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) موجودة على جهاز Android. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) قم بتثبيت تطبيق Android مكون من عدة ملفات APK (حزم مقسمة رئيسية وإضافية) موجودة على جهاز Android. |
abstract boolean | isHeadlessSystemUserMode () يُرجع ما إذا كان الجهاز يستخدم وضع مستخدم نظام مقطوعة الرأس. |
abstract boolean | isMainUserPermanentAdmin () لعرض ما إذا كان المستخدم الرئيسي مسؤولًا دائمًا ولا يمكن حذفه أو الرجوع إلى حالة غير المسؤول. |
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 | isUserVisible (int userId) للتحقق مما إذا كان المستخدم المحدد مرئيًا. |
abstract boolean | isUserVisibleOnDisplay (int userId, int displayId) للتحقق مما إذا كان المستخدم المحدد مرئيًا في الشاشة المحددة. |
abstract boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () يُرجع ما إذا كان الجهاز يسمح للمستخدمين بالبدء في الظهور في الخلفية في ERROR(/java.android.view.Display#DEFAULT_DISPLAY) . |
abstract boolean | isVisibleBackgroundUsersSupported () يُرجع ما إذا كان الجهاز يسمح للمستخدمين بالبدء في الظهور في الخلفية. |
abstract boolean | isWifiEnabled () اختبر ما إذا تم تمكين wifi. |
abstract | listDisplayIds () قم بتجميع قائمة معرّف الشاشات المتوفرة على الجهاز كما تم الإبلاغ عن ذلك بواسطة "dumpsys SurfaceFlinger". |
abstract | listDisplayIdsForStartingVisibleBackgroundUsers () الحصول على قائمة الشاشات التي يمكن استخدامها start a user visible in the background . |
abstract | listUsers () يحصل على قائمة المستخدمين على الجهاز. |
abstract boolean | logBugreport (String dataName, ITestLogger listener) طريقة مساعدة لأخذ تقرير خطأ وتسجيله للمراسلين. |
abstract void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) يسجل IDeviceActionReceiver لهذا الجهاز. |
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 | startVisibleBackgroundUser (int userId, int displayId, 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 Bugreport | takeBugreport () خذ تقرير خطأ وأعده داخل كائن Bugreport للتعامل معه. |
abstract String | uninstallPackage (String packageName) قم بإلغاء تثبيت حزمة Android من الجهاز. |
abstract String | uninstallPackageForUser (String packageName, int userId) قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين. |
الأساليب العامة
canSwitchToHeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
إرجاع ما إذا كان مسموحًا بالانتقال إلى مستخدم النظام بدون رأس.
تحقق من الاتصال
public abstract boolean checkConnectivity ()
تحقق من اتصال هذا الجهاز بالشبكة.
عائدات |
---|
boolean | true إذا كان الجهاز به اتصال شبكة يعمل ، false في الاتجاه المعاكس. |
clearErrorDialogs
public abstract boolean clearErrorDialogs ()
محاولة استبعاد أي مربعات حوار خطأ معروضة حاليًا على واجهة مستخدم الجهاز.
عائدات |
---|
boolean | true في حالة عدم وجود مربعات حوار أو تم مسح الحوارات بنجاح. false ذلك كاذبة. |
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 |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
يتصل بشبكة wifi.
يقوم بتشغيل wifi والحظر حتى يتم إجراء اتصال ناجح بإحدى شبكات wifi الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال ، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi()
أو ITestDevice#clearLastConnectedWifiNetwork()
.
حدود |
---|
wifiSsidToPsk | : خريطة wifi SSID لكلمات المرور. |
عائدات |
---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. خلاف ذلك false |
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 |
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 |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
متغير من connectToWifiNetwork(String, String)
يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.
حدود |
---|
scanSsid | boolean : ما إذا كان سيتم البحث عن SSID المخفي لهذه الشبكة |
عائدات |
---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. خلاف ذلك false |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
متغير من connectToWifiNetwork(String, String)
يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.
عائدات |
---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. خلاف ذلك false |
createUser
public abstract int createUser (String name)
قم بإنشاء مستخدم باسم معين وعلامات افتراضية 0.
حدود |
---|
name | String : للمستخدم الذي سيتم إنشاؤه على الجهاز |
عائدات |
---|
int | العدد الصحيح لمعرف المستخدم الذي تم إنشاؤه |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
قم بإنشاء مستخدم باسم معين والعلامات المقدمة
حدود |
---|
name | String : للمستخدم الذي سيتم إنشاؤه على الجهاز |
guest | boolean : تمكين إشارة المستخدم أثناء الإنشاء |
ephemeral | boolean : تمكين علامة المستخدم - الرمز الشخصي أثناء الإنشاء |
forTesting | boolean : تمكين علامة الاختبار - للاختبار أثناء الإنشاء |
عائدات |
---|
int | معرف المستخدم الذي تم إنشاؤه |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
قم بإنشاء مستخدم باسم معين والعلامات المقدمة
حدود |
---|
name | String : للمستخدم الذي سيتم إنشاؤه على الجهاز |
guest | boolean : تمكين إشارة المستخدم أثناء الإنشاء |
ephemeral | boolean : تمكين علامة المستخدم - الرمز الشخصي أثناء الإنشاء |
عائدات |
---|
int | معرف المستخدم الذي تم إنشاؤه |
createUserNoThrow
public abstract int createUserNoThrow (String name)
قم بإنشاء مستخدم باسم معين وعلامات افتراضية 0.
حدود |
---|
name | String : للمستخدم الذي سيتم إنشاؤه على الجهاز |
عائدات |
---|
int | العدد الصحيح لمعرف المستخدم الذي تم إنشاؤه أو -1 للخطأ. |
تعطيل Keyguard
public abstract void disableKeyguard ()
محاولات لتعطيل حارس المفاتيح.
انتظر أولاً حتى يصبح إرسال الإدخال جاهزًا ، يحدث هذا في نفس الوقت تقريبًا عندما يقوم الجهاز بإبلاغ BOOT_COMPLETE ، على ما يبدو بشكل غير متزامن ، لأن تنفيذ إطار العمل الحالي به حالة سباق عرضية. ثم يتم إرسال الأمر لإبعاد حارس المفاتيح (يعمل على الحراس غير الآمنين فقط)
DisableNetworkMonitor
public abstract boolean disableNetworkMonitor ()
تعطيل مراقبة الشبكة على الجهاز.
عائدات |
---|
boolean | true إذا تم تعطيل المراقبة بنجاح. false إذا فشلت. |
قطع الاتصال من واي فاي
public abstract boolean disconnectFromWifi ()
قطع الاتصال بشبكة wifi.
يزيل جميع الشبكات من قائمة الشبكات المعروفة ويعطل wifi.
عائدات |
---|
boolean | true إذا تم قطع الاتصال بشبكة wifi بنجاح. false إذا فشل قطع الاتصال. |
doesFileExist
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
طريقة مساعدة لتحديد ما إذا كان الملف الموجود على الجهاز موجودًا لمستخدم معين.
حدود |
---|
deviceFilePath | String : المسار المطلق للملف المراد فحصه على الجهاز |
userId | int : معرف المستخدم المراد التحقق من وجود الملف على أساسه |
عائدات |
---|
boolean | true إذا كان الملف موجودًا ، false بخلاف ذلك. |
كومة
public abstract File dumpHeap (String process,
String devicePath)
محاولة تفريغ الكومة من خادم النظام. تقع على عاتق المتصل مسؤولية تنظيف الملف الملغى.
حدود |
---|
process | String : اسم عملية الجهاز المراد dumpheap تشغيلها. |
devicePath | String : المسار الموجود على الجهاز حيث يتم وضع التفريغ. يجب أن يكون هذا موقعًا تسمح به الأذونات. |
عائدات |
---|
File | ERROR(/File) الذي يحتوي على التقرير. لاغية إذا فشل شيء ما. |
تمكين NetworkMonitor
public abstract boolean enableNetworkMonitor ()
تمكن مراقبة الشبكة على الجهاز.
عائدات |
---|
boolean | true إذا تم تمكين المراقبة بنجاح. false إذا فشلت. |
getActiveApexes
public abstract getActiveApexes ()
إحضار المعلومات حول APEXes التي تم تنشيطها على الجهاز.
getAllSettings
public abstract getAllSettings (String namespace)
إرجاع أزواج قيمة المفتاح لمساحة الاسم المطلوبة.
حدود |
---|
namespace | String : يجب أن تكون واحدة من {"النظام" ، "الآمن" ، "العالمي"} |
عائدات |
---|
| خريطة أزواج القيمة الرئيسية. خالية إذا لم يتم دعم مساحة الاسم. |
getAndroidId
public abstract String getAndroidId (int userId)
ابحث عن معرف android المرتبط بمعرّف المستخدم وأعده ، ويكون فارغًا إذا لم يتم العثور عليه.
getAndroidIds
public abstract getAndroidIds ()
قم بإنشاء خريطة لمعرفات android التي تم العثور عليها مطابقة لمعرفات المستخدم. لا يوجد تأمين على أن كل معرف مستخدم سيجد معرف android مرتبطًا بهذه الوظيفة ، لذلك قد تتطابق بعض معرفات المستخدم مع قيمة خالية.
عائدات |
---|
| تم العثور على خريطة معرفات android متطابقة مع معرفات المستخدم. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
إحضار معلومات حول حزمة مثبتة على الجهاز.
getAppPackageInfos
public abstract getAppPackageInfos ()
إحضار معلومات الحزم المثبتة على الجهاز.
getBugreport
public abstract InputStreamSource getBugreport ()
يسترجع تقرير خطأ من الجهاز.
تنفيذ هذا مضمون لمواصلة العمل على جهاز بدون بطاقة sdcard (أو حيث لم يتم تركيب بطاقة sdcard بعد).
getBugreportz
public abstract InputStreamSource getBugreportz ()
يسترجع تقرير الأخطاء من الجهاز. يحتوي تقرير الأخطاء بتنسيق Zip على تقرير الأخطاء الرئيسي وملفات السجل الأخرى المفيدة لتصحيح الأخطاء.
مدعوم فقط لـ "إصدار adb"> 1.0.36
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
تُرجع الحالة القابلة للطي الحالية للجهاز أو تُرجع فارغة في حالة حدوث بعض المشكلات.
getCurrentUser
public abstract int getCurrentUser ()
إرجاع معرف المستخدم الحالي قيد التشغيل. في حالة حدوث خطأ ، قم بإرجاع -10000.
getFoldableStates
public abstract getFoldableStates ()
يُرجع قائمة الحالات القابلة للطي على الجهاز. يمكن الحصول عليها باستخدام "حالات الطباعة cmd device_state".
getInstalledPackageNames
public abstract getInstalledPackageNames ()
إحضار أسماء حزم التطبيقات الموجودة على الجهاز.
getIpAddress
public abstract String getIpAddress ()
يحصل على عنوان IP الخاص بالجهاز.
عائدات |
---|
String | عنوان IP الخاص بالجهاز ، أو null إذا لم يكن للجهاز عنوان IP |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
قم بإرجاع كائن للحصول على الحالة الحالية لحارس المفاتيح أو فارغ إذا لم يكن مدعومًا.
getMainUserId
public abstract Integer getMainUserId ()
إرجاع معرف المستخدم الرئيسي.
عائدات |
---|
Integer | معرف المستخدم للمستخدم الرئيسي إذا كان هناك واحد ، وخالٍ إذا لم يكن هناك مستخدم رئيسي. |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
احصل على معلومات حول وحدات الخط الرئيسي المثبتة على الجهاز.
public abstract int getMaxNumberOfRunningUsersSupported ()
احصل على أكبر عدد ممكن من المستخدمين الذين يعملون في نفس الوقت. افتراضات على 0.
عائدات |
---|
int | عدد صحيح يشير إلى عدد المستخدمين قيد التشغيل في وقت واحد |
public abstract int getMaxNumberOfUsersSupported ()
احصل على أقصى عدد من المستخدمين المدعومين. افتراضات على 0.
عائدات |
---|
int | عدد صحيح يشير إلى عدد المستخدمين المدعومين |
getOptions
public abstract TestDeviceOptions getOptions ()
إحضار خيارات الاختبار للجهاز.
getPrimaryUserId
public abstract Integer getPrimaryUserId ()
إرجاع معرف المستخدم الأساسي.
عائدات |
---|
Integer | معرف المستخدم للمستخدم الأساسي إذا كان هناك واحد ، وخالٍ إذا لم يكن هناك مستخدم أساسي. |
الحصول على لقطة شاشة
public abstract InputStreamSource getScreenshot ()
يلتقط لقطة شاشة من الجهاز.
الحصول على لقطة شاشة
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
يلتقط لقطة شاشة من الجهاز. يوصى باستخدام getScreenshot(String)
بدلاً من ترميز JPEG لحجم أصغر.
حدود |
---|
format | String : دعم PNG و JPEG |
rescale | boolean : إذا كان يجب تغيير حجم لقطة الشاشة لتقليل حجم الصورة الناتجة |
الحصول على لقطة شاشة
public abstract InputStreamSource getScreenshot (String format)
يلتقط لقطة شاشة من الجهاز. يوصى باستخدام getScreenshot (التنسيق) بدلاً من ترميز JPEG لحجم أصغر
حدود |
---|
format | String : دعم PNG و JPEG |
الحصول على لقطة شاشة
public abstract InputStreamSource getScreenshot (long displayId)
يأخذ لقطة شاشة من الجهاز المعطى معرّف العرض. التنسيق هو PNG.
TODO: تمديد عمليات التنفيذ أعلاه لدعم "التنسيق" و "إعادة القياس"
حدود |
---|
displayId | long : معرّف عرض الشاشة للحصول على لقطة شاشة منه. |
getSetting
public abstract String getSetting (String namespace,
String key)
راجع getSetting(int, String, String)
ويتم إجراؤه على مستخدم النظام.
حدود |
---|
namespace | String |
key | String |
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
إرجاع قيمة الإعداد المطلوب. يجب أن تكون مساحة الاسم واحدة من: {"نظام" ، "آمن" ، "عالمي"}
حدود |
---|
userId | int |
namespace | String |
key | String |
عائدات |
---|
String | القيمة المرتبطة بمساحة الاسم: مفتاح المستخدم. لاغية إذا لم يتم العثور عليها. |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. يتم تعريف هذا حاليًا على أنه حزم غير متعلقة بالنظام وحزم النظام المحدثة.
عائدات |
---|
| ERROR(/Set) في أسماء حزم String غير القابلة للتثبيت المثبتة حاليًا على الجهاز. |
getUserFlags
public abstract int getUserFlags (int userId)
ابحث عن أعلام مستخدم معين وقم بإعادتها. يتم تحديد العلامات في فئة "android.content.pm.UserInfo" في مشروع Android مفتوح المصدر.
عائدات |
---|
int | العلامات المرتبطة بـ userId المقدمة إن وجدت ، -10000 في أي حالات أخرى. |
getUserInfos
public abstract getUserInfos ()
يحصل على خريطة معرف الاستخدام UserInfo
على الجهاز. سيتم طرح DeviceRuntimeException
إذا لم يكن الإخراج من الجهاز كما هو متوقع.
عائدات |
---|
| قائمة كائنات معلومات المستخدم. |
رميات |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
getUserSerialNumber
public abstract int getUserSerialNumber (int userId)
قم بإرجاع الرقم التسلسلي المرتبط بمعرف المستخدم إذا وجد ، -10000 في أي حالات أخرى.
ميزة
public abstract boolean hasFeature (String feature)
تحقق مما إذا كانت الميزة متاحة على الجهاز.
حدود |
---|
feature | String : أي تنسيق يجب أن يكون "feature: " أو " " مباشرة. |
عائدات |
---|
boolean | صحيح إذا تم العثور على ميزة ، خطأ إذا كان العكس. |
ثبت المجموعة
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 إذا نجحت. |
ثبت المجموعة
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 إذا نجحت. |
تثبيت الحزم
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,
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 | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز. |
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 | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي على الجهاز. |
isHeadlessSystemUserMode
public abstract boolean isHeadlessSystemUserMode ()
يُرجع ما إذا كان الجهاز يستخدم وضع مستخدم نظام مقطوعة الرأس.
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
لعرض ما إذا كان المستخدم الرئيسي مسؤولًا دائمًا ولا يمكن حذفه أو الرجوع إلى حالة غير المسؤول.
isMultiUserSupported
public abstract boolean isMultiUserSupported ()
يحدد ما إذا كان يتم دعم تعدد المستخدمين.
عائدات |
---|
boolean | صواب إذا تم دعم عدة مستخدمين ، خطأ بخلاف ذلك |
isPackage مثبت
public abstract boolean isPackageInstalled (String packageName)
استعلم عن اسم الحزمة المعطى للجهاز للتحقق مما إذا كان مثبتًا حاليًا أم لا.
عائدات |
---|
boolean | صحيح إذا تم الإبلاغ عن الحزمة على أنها مثبتة. خطأ خلاف ذلك. |
isPackage مثبت
public abstract boolean isPackageInstalled (String packageName,
String userId)
استعلم عن الجهاز عن اسم حزمة معين ومعرف المستخدم المحدد للتحقق مما إذا كان مثبتًا حاليًا أم لا لهذا المستخدم.
حدود |
---|
packageName | String : الحزمة التي نتحقق من تثبيتها. |
userId | String : معرف المستخدم الذي نتحقق من الحزمة مثبت من أجله. إذا كانت القيمة خالية ، فسيتم استخدام الصفر الأساسي للمستخدم. |
عائدات |
---|
boolean | صحيح إذا تم الإبلاغ عن الحزمة على أنها مثبتة. خطأ خلاف ذلك. |
قيد التشغيل
public abstract boolean isUserRunning (int userId)
تحقق مما إذا كان مستخدم معين قيد التشغيل.
عائدات |
---|
boolean | صحيح إذا كان المستخدم يعمل ، خطأ في كل الحالات الأخرى. |
isUserSecondary
public abstract boolean isUserSecondary (int userId)
قم بإرجاع ما إذا كان المستخدم المحدد مستخدمًا ثانويًا وفقًا لعلامته.
عائدات |
---|
boolean | صواب إذا كان المستخدم ثانويًا ، أو خطأ بخلاف ذلك. |
غير مرئي
public abstract boolean isUserVisible (int userId)
للتحقق مما إذا كان المستخدم المحدد مرئيًا.
المستخدم "المرئي" هو مستخدم يتفاعل مع المستخدم "البشري" وبالتالي يكون قادرًا على بدء أنشطة التشغيل (عادةً في العرض الافتراضي).
isUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
للتحقق مما إذا كان المستخدم المحدد مرئيًا في الشاشة المحددة.
المستخدم "المرئي" هو مستخدم يتفاعل مع المستخدم "البشري" وبالتالي يمكنه إطلاق أنشطة الإطلاق في تلك الشاشة.
حدود |
---|
userId | int |
displayId | int |
isWifiEnabled
public abstract boolean isWifiEnabled ()
اختبر ما إذا تم تمكين wifi.
يتحقق مما إذا تم تمكين wifi على الجهاز. مفيد لتأكيد حالة wifi قبل الاختبارات التي لا ينبغي أن تعمل مع wifi ، مثل اختبارات بيانات الهاتف المحمول.
عائدات |
---|
boolean | true إذا تم تمكين wifi. false إذا تم تعطيله |
listDisplayIds
public abstract listDisplayIds ()
قم بتجميع قائمة معرّف الشاشات المتوفرة على الجهاز كما تم الإبلاغ عن ذلك بواسطة "dumpsys SurfaceFlinger".
عائدات |
---|
| قائمة العروض. يعيد الإعداد الافتراضي دائمًا العرض الافتراضي 0. |
listDisplayIdsForStartingVisibleBackgroundUsers
public abstract listDisplayIdsForStartingVisibleBackgroundUsers ()
الحصول على قائمة الشاشات التي يمكن استخدامها start a user visible in the background
.
listUsers
public abstract listUsers ()
يحصل على قائمة المستخدمين على الجهاز. سيتم طرح DeviceRuntimeException
إذا لم يكن الإخراج من الجهاز كما هو متوقع.
عائدات |
---|
| قائمة هويات المستخدمين. |
رميات |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
تسجيل الدخول
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
طريقة مساعدة لأخذ تقرير خطأ وتسجيله للمراسلين.
حدود |
---|
dataName | String : الاسم الذي سيتم الإبلاغ عن تقرير الخطأ تحته. |
listener | ITestLogger : ITestLogger لتسجيل تقرير الخطأ. |
عائدات |
---|
boolean | صحيح إذا كان التسجيل ناجحًا ، أو خطأ إذا كان العكس. |
إزالة
public abstract boolean removeAdmin (String componentName,
int userId)
قم بإزالة مسؤول الجهاز المحدد في مستخدم معين وإرجاع true
إذا كان ناجحًا ، false
في الحالات الأخرى.
حدود |
---|
componentName | String : من مسؤول الجهاز المراد إزالته. |
userId | int : للمستخدم الذي يعيش فيه مشرف الجهاز. |
عائدات |
---|
boolean | صحيح إذا كان ناجحًا ، وخطئًا على خلاف ذلك. |
إزالة المالكين
public abstract void removeOwners ()
قم بإزالة جميع مالكي ملفات تعريف الجهاز الحاليين بأفضل جهد.
إزالة المستخدم
public abstract boolean removeUser (int userId)
إزالة مستخدم معين من الجهاز.
حدود |
---|
userId | int : للمستخدم المراد إزالته |
عائدات |
---|
boolean | true if we were successful in removing the user, false otherwise. |
setDeviceOwner
public abstract boolean setDeviceOwner (String componentName,
int userId)
Set a device admin component as device owner in given user.
حدود |
---|
componentName | String : of device admin to be device owner. |
userId | int : of the user that the device owner lives in. |
عائدات |
---|
boolean | True if it is successful, false otherwise. |
setSetting
public abstract void setSetting (String namespace,
String key,
String value)
See setSetting(int, String, String, String)
and performed on system user.
حدود |
---|
namespace | String |
key | String |
value | String |
setSetting
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}
حدود |
---|
userId | int |
namespace | String |
key | String |
value | String |
startUser
public abstract boolean startUser (int userId)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.
حدود |
---|
userId | int : of the user to start in the background |
عائدات |
---|
boolean | true if the user was successfully started in the background. |
startUser
public abstract boolean startUser (int userId,
boolean waitFlag)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.
حدود |
---|
userId | int : of the user to start in the background |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
عائدات |
---|
boolean | true if the user was successfully started in the background. |
startVisibleBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).
NOTE: this command doesn't check if the user exists, display is available, device supports such feature
, etc.
حدود |
---|
userId | int : of the user to start in the background |
displayId | int : display to start user visible on |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
عائدات |
---|
boolean | true if the user was successfully started visible in the background. |
stopUser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.
حدود |
---|
userId | int : of the user to stop. |
waitFlag | boolean : will make the command wait until user is stopped. |
forceFlag | boolean : will force stop the user. |
عائدات |
---|
boolean | true if the user was successfully stopped. |
stopUser
public abstract boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
حدود |
---|
userId | int : of the user to stop. |
عائدات |
---|
boolean | true if the user was successfully stopped. |
switchUser
public abstract boolean switchUser (int userId)
Switch to another userId with a default timeout. switchUser(int, long)
.
عائدات |
---|
boolean | True if the new userId matches the userId provider. False otherwise. |
switchUser
public abstract boolean switchUser (int userId,
long timeout)
Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.
حدود |
---|
userId | int |
timeout | long : to wait before returning false for switch-user failed. |
عائدات |
---|
boolean | True if the new userId matches the userId provider. False otherwise. |
takeBugreport
public abstract Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close()
.
uninstallPackage
public abstract String uninstallPackage (String packageName)
Uninstall an Android package from device.
حدود |
---|
packageName | String : the Android package to uninstall |
عائدات |
---|
String | a String with an error code, or null if success. |
uninstallPackageForUser
public abstract String uninstallPackageForUser (String packageName,
int userId)
Uninstall an Android package from device for a given user.
حدود |
---|
packageName | String : the Android package to uninstall |
userId | int : the integer user id to uninstall for. |
عائدات |
---|
String | a String with an error code, or null if success. |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-07-19 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]