إعادة محاولة أوامر الجهاز بمبلغ قابل للتكوين، وتوفير واجهة استرداد الجهاز للأجهزة التي لا تستجيب.
فصول متداخلة |
---|
class | ITestDevice.ApexInfo فئة بنية بسيطة لتخزين المعلومات حول APEX واحد |
class | ITestDevice.MountPointInfo فئة بنية بسيطة لتخزين المعلومات حول نقطة تحميل واحدة |
الأساليب العامة |
---|
abstract boolean | canSwitchToHeadlessSystemUser () إرجاع ما إذا كان مسموحًا بالتبديل إلى مستخدم النظام مقطوع الرأس. |
abstract boolean | checkConnectivity () تأكد من أن الجهاز لديه اتصال بالشبكة. |
abstract boolean | clearErrorDialogs () حاول استبعاد أي مربعات حوار خطأ معروضة حاليًا على واجهة مستخدم الجهاز. |
abstract void | clearLastConnectedWifiNetwork () مسح آخر شبكة wifi متصلة. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) يتصل بشبكة واي فاي. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) يتصل بشبكة واي فاي. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) يتصل بشبكة واي فاي. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) يتصل بشبكة واي فاي. |
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 | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) قم بإنشاء مستخدم باسم معين والأعلام المقدمة |
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) محاولة تفريغ الكومة من system_server. |
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 (String format, boolean rescale) يلتقط لقطة شاشة من الجهاز. |
abstract InputStreamSource | getScreenshot (String format) يلتقط لقطة شاشة من الجهاز. |
abstract InputStreamSource | getScreenshot (long displayId) يلتقط لقطة شاشة من الجهاز المحدد بمعرف العرض. |
abstract InputStreamSource | getScreenshot () يلتقط لقطة شاشة من الجهاز. |
abstract String | getSetting (int userId, String namespace, String key) قم بإرجاع قيمة الإعداد المطلوب. |
abstract String | getSetting (String namespace, String key) راجع getSetting(int, String, String) ويتم إجراؤه على مستخدم النظام. |
abstract | getUninstallablePackageNames () قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. |
abstract int | getUserFlags (int userId) البحث عن إشارات مستخدم معين وإعادتها. |
abstract | getUserInfos () يحصل على خريطة useId 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, int userId, String... extraArgs) تثبيت حزمة Android على الجهاز لمستخدم معين. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, 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, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة رئيسية واحدة وإضافية مقسمة) لمستخدم معين. |
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 | 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, String userId) استعلم عن الجهاز للحصول على اسم حزمة معين ومعرف المستخدم المحدد للتحقق مما إذا كان مثبتًا حاليًا أم لا لهذا المستخدم. |
abstract boolean | isPackageInstalled (String packageName) استعلم عن الجهاز للحصول على اسم حزمة معين للتحقق مما إذا كان مثبتًا حاليًا أم لا. |
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 () اختبار ما إذا تم تمكين واي فاي. |
abstract | listDisplayIds () قم بتجميع قائمة معرفات شاشات العرض المتوفرة على الجهاز كما ورد في "dumpsys SurfaceFlinger". |
abstract | listDisplayIdsForStartingVisibleBackgroundUsers () يحصل على قائمة العروض التي يمكن استخدامها start a user visible in the background . |
abstract | listUsers () يحصل على قائمة المستخدمين على الجهاز. |
abstract boolean | logBugreport (String dataName, ITestLogger listener) طريقة مساعدة لأخذ تقرير الأخطاء وتسجيله للصحفيين. |
default void | notifySnapuserd ( SnapuserdWaitPhase waitPhase) قم بإعلام الجهاز بالانتظار حتى اكتمال snapuserd. |
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) توقف مستخدم معين. |
abstract boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) إيقاف مستخدم معين. |
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 من الجهاز لمستخدم معين. |
default void | waitForSnapuserd ( SnapuserdWaitPhase currentPhase) إذا كان متوقعًا، فانتظر حتى يكتمل snapuserd. |
الأساليب العامة
canSwitchToHeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
إرجاع ما إذا كان مسموحًا بالتبديل إلى مستخدم النظام مقطوع الرأس.
checkConnectivity
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)
يتصل بشبكة واي فاي.
يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بإحدى شبكات wifi الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi()
أو ITestDevice#clearLastConnectedWifiNetwork()
.
حدود |
---|
wifiSsidToPsk | : خريطة معرفات SSID واي فاي لكلمات المرور. |
عائدات |
---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك |
ConnectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
يتصل بشبكة واي فاي.
يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بإحدى شبكات wifi الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi()
أو ITestDevice#clearLastConnectedWifiNetwork()
.
حدود |
---|
wifiSsidToPsk | : خريطة معرفات SSID واي فاي لكلمات المرور. |
scanSsid | boolean : ما إذا كان سيتم البحث عن معرفات SSID المخفية لهذه الشبكة. |
عائدات |
---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك |
ConnectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
يتصل بشبكة واي فاي.
يقوم بتشغيل 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 المحددة. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء 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)
قم بإنشاء مستخدم باسم معين والأعلام المقدمة
حدود |
---|
name | String : من المستخدم لإنشائها على الجهاز |
guest | boolean : قم بتمكين علامة المستخدم --ضيف أثناء الإنشاء |
ephemeral | boolean : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء |
عائدات |
---|
int | معرف المستخدم الذي تم إنشاؤه |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
قم بإنشاء مستخدم باسم معين والأعلام المقدمة
حدود |
---|
name | String : من المستخدم لإنشائها على الجهاز |
guest | boolean : قم بتمكين علامة المستخدم --ضيف أثناء الإنشاء |
ephemeral | boolean : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء |
forTesting | boolean : قم بتمكين علامة الاختبار --for-testing أثناء الإنشاء |
عائدات |
---|
int | معرف المستخدم الذي تم إنشاؤه |
createUserNoThrow
public abstract int createUserNoThrow (String name)
أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.
حدود |
---|
name | String : من المستخدم لإنشائها على الجهاز |
عائدات |
---|
int | العدد الصحيح لمعرف المستخدم الذي تم إنشاؤه أو -1 للخطأ. |
dableKeyguard
public abstract void disableKeyguard ()
محاولات لتعطيل حارس المفاتيح.
انتظر أولاً حتى يصبح إرسال الإدخال جاهزًا، ويحدث هذا في نفس الوقت تقريبًا عندما يقوم الجهاز بالإبلاغ عن BOOT_COMPLETE، بشكل غير متزامن على ما يبدو، لأن تنفيذ إطار العمل الحالي له حالة سباق عرضية. ثم يتم إرسال الأمر لإغلاق حارس المفاتيح (يعمل على المفاتيح غير الآمنة فقط)
DisableNetworkMonitor
public abstract boolean disableNetworkMonitor ()
تعطيل مراقبة الشبكة على الجهاز.
عائدات |
---|
boolean | true إذا تم تعطيل المراقبة بنجاح. false إذا فشلت. |
قطع الاتصالمنWifi
public abstract boolean disconnectFromWifi ()
قطع الاتصال بشبكة wifi.
إزالة جميع الشبكات من قائمة الشبكات المعروفة وتعطيل wifi.
عائدات |
---|
boolean | true إذا تم قطع الاتصال بشبكة wifi بنجاح. false إذا فشل قطع الاتصال. |
doFileExist
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
طريقة مساعدة لتحديد ما إذا كان الملف الموجود على الجهاز موجودًا لمستخدم معين.
حدود |
---|
deviceFilePath | String : المسار المطلق للملف الموجود على الجهاز المراد فحصه |
userId | int : معرف المستخدم الذي يتم من خلاله التحقق من وجود الملف |
عائدات |
---|
boolean | true في حالة وجود الملف، false في غير ذلك. |
dumpHeap
public abstract File dumpHeap (String process,
String devicePath)
محاولة تفريغ الكومة من system_server. تقع على عاتق المتصل مسؤولية تنظيف الملف الذي تم تفريغه.
حدود |
---|
process | String : اسم عملية الجهاز المطلوب تفريغها. |
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 : يجب أن تكون واحدة من {"system"، "secure"، "global"} |
عائدات |
---|
| خريطة أزواج القيمة الرئيسية. فارغة إذا كانت مساحة الاسم غير مدعومة. |
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 devices_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 | معرف المستخدم للمستخدم الأساسي إذا كان هناك واحد، وفارغ إذا لم يكن هناك مستخدم أساسي. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
يلتقط لقطة شاشة من الجهاز. يوصى باستخدام getScreenshot(String)
بدلاً من ذلك مع تشفير JPEG للحجم الأصغر.
حدود |
---|
format | String : مدعومة PNG، JPEG |
rescale | boolean : إذا كان يجب إعادة قياس لقطة الشاشة لتقليل حجم الصورة الناتجة |
getScreenshot
public abstract InputStreamSource getScreenshot (String format)
يلتقط لقطة شاشة من الجهاز. يوصى باستخدام getScreenshot(format) بدلاً من ذلك مع تشفير JPEG للحجم الأصغر
حدود |
---|
format | String : مدعومة PNG، JPEG |
getScreenshot
public abstract InputStreamSource getScreenshot (long displayId)
يلتقط لقطة شاشة من الجهاز المحدد بمعرف العرض. التنسيق هو PNG.
TODO: توسيع التطبيقات المذكورة أعلاه لدعم "التنسيق" و"إعادة القياس"
حدود |
---|
displayId | long : معرف العرض الخاص بالشاشة للحصول على لقطة شاشة منها. |
getScreenshot
public abstract InputStreamSource getScreenshot ()
يلتقط لقطة شاشة من الجهاز.
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
قم بإرجاع قيمة الإعداد المطلوب. يجب أن تكون مساحة الاسم واحدة مما يلي: {"system"، "secure"، "global"}
حدود |
---|
userId | int |
namespace | String |
key | String |
عائدات |
---|
String | القيمة المرتبطة بمساحة الاسم:مفتاح المستخدم. فارغة إذا لم يتم العثور عليها. |
getSetting
public abstract String getSetting (String namespace,
String key)
راجع getSetting(int, String, String)
ويتم إجراؤه على مستخدم النظام.
حدود |
---|
namespace | String |
key | String |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. يتم تعريف هذا حاليًا على أنه الحزم غير التابعة للنظام، وحزم النظام المحدثة.
getUserFlags
public abstract int getUserFlags (int userId)
البحث عن إشارات مستخدم معين وإعادتها. يتم تعريف العلامات في فئة "android.content.pm.UserInfo" في مشروع Android مفتوح المصدر.
عائدات |
---|
int | العلامات المرتبطة بمعرف المستخدم المقدم إذا تم العثور عليه، -10000 في أي حالات أخرى. |
getUserInfos
public abstract getUserInfos ()
يحصل على خريطة useId UserInfo
على الجهاز. سيتم طرح DeviceRuntimeException
إذا لم يكن الإخراج من الجهاز كما هو متوقع.
عائدات |
---|
| قائمة كائنات UserInfo. |
رميات |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
getUserSerialNumber
public abstract int getUserSerialNumber (int userId)
إعادة الرقم التسلسلي المرتبط بمعرف المستخدم إذا وجد، -10000 في أي حالات أخرى.
hasFeature
public abstract boolean hasFeature (String feature)
تحقق مما إذا كانت الميزة متوفرة على الجهاز.
حدود |
---|
feature | String : التنسيق الذي يجب أن يكون "الميزة: " أو " " مباشرة. |
عائدات |
---|
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,
int userId,
String... extraArgs)
تثبيت حزمة Android على الجهاز لمستخدم معين.
حدود |
---|
packageFile | File : ملف apk للتثبيت |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
userId | int : معرف المستخدم الصحيح الذي سيتم التثبيت له. |
extraArgs | String : وسيطات إضافية اختيارية للتمرير. راجع "adb Shell PM -h" للتعرف على الخيارات المتاحة. |
عائدات |
---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
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 | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
installPackages
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 | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
installPackages
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,
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 | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
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 | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
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 | صحيح إذا كان هناك دعم لعدة مستخدمين، وخطأ إذا كان غير ذلك |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName,
String userId)
استعلم عن الجهاز للحصول على اسم حزمة معين ومعرف المستخدم المحدد للتحقق مما إذا كان مثبتًا حاليًا أم لا لهذا المستخدم.
حدود |
---|
packageName | String : الحزمة التي نتحقق من تثبيتها. |
userId | String : معرف المستخدم الذي نتحقق من تثبيت الحزمة عليه. إذا كان فارغًا، فسيتم استخدام المستخدم الأساسي صفر. |
عائدات |
---|
boolean | صحيح إذا تم الإبلاغ عن الحزمة على أنها مثبتة. باطل غير ذلك. |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName)
استعلم عن الجهاز للحصول على اسم حزمة معين للتحقق مما إذا كان مثبتًا حاليًا أم لا.
عائدات |
---|
boolean | صحيح إذا تم الإبلاغ عن الحزمة على أنها مثبتة. باطل غير ذلك. |
isUserRunning
public abstract boolean isUserRunning (int userId)
تحقق مما إذا كان مستخدم معين قيد التشغيل.
عائدات |
---|
boolean | صحيح إذا كان المستخدم قيد التشغيل، وخطأ في كل الحالات الأخرى. |
isUserSecondary
public abstract boolean isUserSecondary (int userId)
قم بإرجاع ما إذا كان المستخدم المحدد مستخدمًا ثانويًا وفقًا لعلاماته.
عائدات |
---|
boolean | صحيح إذا كان المستخدم ثانويًا، وخطأ فيما عدا ذلك. |
isUserVisible
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، على سبيل المثال اختبارات بيانات الهاتف المحمول.
عائدات |
---|
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 | |
logBugreport
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
طريقة مساعدة لأخذ تقرير الأخطاء وتسجيله للصحفيين.
حدود |
---|
dataName | String : الاسم الذي سيتم بموجبه الإبلاغ عن تقرير الأخطاء. |
listener | ITestLogger : ITestLogger لتسجيل تقرير الأخطاء. |
عائدات |
---|
boolean | صحيح إذا تم التسجيل بنجاح، وخطأ فيما عدا ذلك. |
notifySnapuuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
قم بإعلام الجهاز بالانتظار حتى اكتمال snapuserd.
حدود |
---|
waitPhase | SnapuserdWaitPhase |
RemoveAdmin
public abstract boolean removeAdmin (String componentName,
int userId)
قم بإزالة مسؤول الجهاز المحدد في مستخدم معين وإرجاع true
إذا كان ناجحًا، false
إذا كان خلاف ذلك.
حدود |
---|
componentName | String : من مسؤول الجهاز المراد إزالته. |
userId | int : للمستخدم الذي يعيش فيه مسؤول الجهاز. |
عائدات |
---|
boolean | صحيح إذا نجح، وباطل فيما عدا ذلك. |
RemoveOwners
public abstract void removeOwners ()
قم بإزالة جميع مالكي ملفات تعريف الجهاز الحاليين بأقصى جهد.
RemoveUser
public abstract boolean removeUser (int userId)
إزالة مستخدم معين من الجهاز.
حدود |
---|
userId | int : للمستخدم المراد إزالته |
عائدات |
---|
boolean | صحيح إذا نجحنا في إزالة المستخدم، وخطأ فيما عدا ذلك. |
setDeviceOwner
public abstract boolean setDeviceOwner (String componentName,
int userId)
قم بتعيين مكون مسؤول الجهاز كمالك للجهاز في مستخدم معين.
حدود |
---|
componentName | String : من مسؤول الجهاز ليكون مالك الجهاز. |
userId | int : للمستخدم الذي يعيش فيه مالك الجهاز. |
عائدات |
---|
boolean | صحيح إذا نجح، وباطل فيما عدا ذلك. |
setSetting
public abstract void setSetting (String namespace,
String key,
String value)
راجع setSetting(int, String, String, String)
ويتم تنفيذها على مستخدم النظام.
حدود |
---|
namespace | String |
key | String |
value | String |
setSetting
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
أضف قيمة إعداد إلى مساحة الاسم لمستخدم معين. لن تكون بعض الإعدادات متاحة إلا بعد إعادة التشغيل. يجب أن تكون مساحة الاسم واحدة مما يلي: {"system"، "secure"، "global"}
حدود |
---|
userId | int |
namespace | String |
key | String |
value | String |
startUser
public abstract boolean startUser (int userId)
يبدأ تشغيل مستخدم معين في الخلفية إذا كان متوقفًا حاليًا. إذا كان المستخدم يعمل بالفعل في الخلفية، فهذه الطريقة هي NOOP.
حدود |
---|
userId | int : للمستخدم أن يبدأ في الخلفية |
عائدات |
---|
boolean | صحيح إذا تم بدء تشغيل المستخدم بنجاح في الخلفية. |
startUser
public abstract boolean startUser (int userId,
boolean waitFlag)
يبدأ تشغيل مستخدم معين في الخلفية إذا كان متوقفًا حاليًا. إذا كان المستخدم يعمل بالفعل في الخلفية، فهذه الطريقة هي NOOP. من الممكن توفير علامة إضافية لانتظار تفعيل العملية.
حدود |
---|
userId | int : للمستخدم أن يبدأ في الخلفية |
waitFlag | boolean : سيجعل الأمر ينتظر حتى يبدأ المستخدم ويفتح قفله. |
عائدات |
---|
boolean | صحيح إذا تم بدء تشغيل المستخدم بنجاح في الخلفية. |
startVisibleBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
يبدأ مستخدمًا معينًا في الخلفية، ويكون مرئيًا في شاشة العرض المحددة (أي السماح للمستخدم ببدء الأنشطة في تلك الشاشة).
ملاحظة: لا يتحقق هذا الأمر من وجود المستخدم، أو توفر العرض، device supports such feature
، وما إلى ذلك.
حدود |
---|
userId | int : للمستخدم أن يبدأ في الخلفية |
displayId | int : عرض لبدء ظهور المستخدم عليه |
waitFlag | boolean : سيجعل الأمر ينتظر حتى يبدأ المستخدم ويفتح قفله. |
عائدات |
---|
boolean | true إذا بدأ المستخدم بنجاح مرئية في الخلفية. |
stopUser
public abstract boolean stopUser (int userId)
توقف مستخدم معين. إذا تم إيقاف المستخدم بالفعل، فهذه الطريقة هي NOOP. لا يمكن إيقاف المستخدم الحالي ومستخدم النظام.
حدود |
---|
userId | int : من المستخدم أن يتوقف. |
عائدات |
---|
boolean | صحيح إذا تم إيقاف المستخدم بنجاح. |
stopUser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
إيقاف مستخدم معين. من الممكن توفير إشارات إضافية لانتظار تفعيل العملية وإنهاء المستخدم بالقوة. لا يمكن إيقاف المستخدم الحالي ومستخدم النظام.
حدود |
---|
userId | int : من المستخدم أن يتوقف. |
waitFlag | boolean : سيجعل الأمر ينتظر حتى يتم إيقاف المستخدم. |
forceFlag | boolean : سيفرض إيقاف المستخدم. |
عائدات |
---|
boolean | صحيح إذا تم إيقاف المستخدم بنجاح. |
تغير المستخدم
public abstract boolean switchUser (int userId)
قم بالتبديل إلى معرف مستخدم آخر بمهلة افتراضية. switchUser(int, long)
.
عائدات |
---|
boolean | صحيح إذا كان معرف المستخدم الجديد يتطابق مع موفر معرف المستخدم. باطل غير ذلك. |
تغير المستخدم
public abstract boolean switchUser (int userId,
long timeout)
قم بالتبديل إلى معرف مستخدم آخر مع تحديد المهلة المحددة كموعد نهائي. محاولة تعطيل حماية المفاتيح بعد نجاح تغيير المستخدم.
حدود |
---|
userId | int |
timeout | long : للانتظار قبل إرجاع الخطأ لفشل تبديل المستخدم. |
عائدات |
---|
boolean | صحيح إذا كان معرف المستخدم الجديد يتطابق مع موفر معرف المستخدم. باطل غير ذلك. |
com.takeBugreport
public abstract Bugreport takeBugreport ()
خذ تقرير الأخطاء وأعده داخل كائن Bugreport
للتعامل معه. العودة فارغة في حالة الإصدار. يجب تنظيف الملف المشار إليه في كائن Bugreport عبر Bugreport.close()
.
uninstallPackage
public abstract String uninstallPackage (String packageName)
قم بإلغاء تثبيت حزمة Android من الجهاز.
حدود |
---|
packageName | String : حزمة Android المراد إلغاء تثبيتها |
عائدات |
---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
إلغاء التثبيتPackageForUser
public abstract String uninstallPackageForUser (String packageName,
int userId)
قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين.
حدود |
---|
packageName | String : حزمة Android المراد إلغاء تثبيتها |
userId | int : معرف المستخدم الصحيح الذي سيتم إلغاء تثبيته. |
عائدات |
---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
إذا كان متوقعًا، فانتظر حتى يكتمل snapuserd.
حدود |
---|
currentPhase | SnapuserdWaitPhase |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2024-04-02 (حسب التوقيت العالمي المتفَّق عليه)
[{
"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":"غير ذلك"
}]