جهاز ITest

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


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

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

ملخص

فئات متداخلة

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)

محاولة تفريغ الكومة من 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 ()

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

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

إرجاع ما إذا كان مسموحًا بالانتقال إلى مستخدم النظام بدون رأس.

عائدات
boolean

رميات
DeviceNotAvailableException

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

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

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

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

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

createUser

public abstract int createUser (String name)

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

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

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

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

createUser

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

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

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

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

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

forTesting boolean : تمكين علامة الاختبار - للاختبار أثناء الإنشاء

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

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

createUser

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

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

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

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

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

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

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

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

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

إلغاء تسجيل جهاز الاستقبال

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

يزيل IDeviceActionReceiver المسجل.

حدود
deviceActionReceiver IDeviceActionReceiver : جهاز IDeviceActionReceiver الذي ستتم إزالته.

تعطيل 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) الذي يحتوي على التقرير. لاغية إذا فشل شيء ما.

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

تمكين NetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

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

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

getActiveApexes

public abstract  getActiveApexes ()

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

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

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

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

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

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

getAndroidId

public abstract String getAndroidId (int userId)

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

حدود
userId int

عائدات
String

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

getAndroidIds

public abstract  getAndroidIds ()

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

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

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

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

حدود
packageName String

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

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

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

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

getBugreport

public abstract InputStreamSource getBugreport ()

يسترجع تقرير خطأ من الجهاز.

تنفيذ هذا مضمون لمواصلة العمل على جهاز بدون بطاقة sdcard (أو حيث لم يتم تركيب بطاقة sdcard بعد).

عائدات
InputStreamSource مصدر InputStreamSource الذي سينتج محتويات تقرير الأخطاء عند الطلب. في حالة الفشل ، سينتج InputStreamSource ERROR(/InputStream) .

getBugreportz

public abstract InputStreamSource getBugreportz ()

يسترجع تقرير الأخطاء من الجهاز. يحتوي تقرير الأخطاء بتنسيق Zip على تقرير الأخطاء الرئيسي وملفات السجل الأخرى المفيدة لتصحيح الأخطاء.

مدعوم فقط لـ "إصدار adb"> 1.0.36

عائدات
InputStreamSource InputStreamSource للملف المضغوط الذي يحتوي على bugreportz ، يتم إرجاعه فارغًا في حالة الفشل.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

عائدات
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

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

عائدات
int

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

getFoldableStates

public abstract  getFoldableStates ()

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

عائدات

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

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

getIpAddress

public abstract String getIpAddress ()

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

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

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

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

getMainUserId

public abstract Integer getMainUserId ()

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

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

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsers المدعومة

public abstract int getMaxNumberOfUsersSupported ()

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

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

رميات
com.android.tradefed.device.DeviceNotAvailableException
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 إذا لم تنجح لقطة الشاشة.

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

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

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

حدود
format String : دعم PNG و JPEG

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

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

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

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

public abstract InputStreamSource getScreenshot (String format)

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

حدود
format String : دعم PNG و JPEG

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

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

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

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

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

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

حدود
namespace String

key String

عائدات
String

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

getSetting

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

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

حدود
userId int

namespace String

key String

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

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

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

getUserFlags

public abstract int getUserFlags (int userId)

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

حدود
userId int

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

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

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 في أي حالات أخرى.

حدود
userId int

عائدات
int

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

ميزة

public abstract boolean hasFeature (String feature)

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

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

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

رميات
com.android.tradefed.device.DeviceNotAvailableException
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 ERROR(/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 ERROR(/String) برمز خطأ ، أو null إذا نجحت.

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

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 ERROR(/String) برمز خطأ ، أو null إذا نجحت.

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

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 ERROR(/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 ERROR(/String) برمز خطأ ، أو null إذا نجحت.

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

تثبيت الحزم

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 ERROR(/String) برمز خطأ ، أو null إذا نجحت.

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

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 ERROR(/String) برمز خطأ ، أو null إذا نجحت.

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

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 ERROR(/String) برمز خطأ ، أو null إذا نجحت.

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

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 ERROR(/String) برمز خطأ ، أو null إذا نجحت.

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

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 ERROR(/String) برمز خطأ ، أو null إذا نجحت.

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

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

يُرجع ما إذا كان الجهاز يستخدم وضع مستخدم نظام مقطوعة الرأس.

عائدات
boolean

رميات
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

عائدات
boolean

رميات
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

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

isPackage مثبت

public abstract boolean isPackageInstalled (String packageName)

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

حدود
packageName String

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

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

isPackage مثبت

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

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

قيد التشغيل

public abstract boolean isUserRunning (int userId)

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

حدود
userId int

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

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

حدود
userId int

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

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

غير مرئي

public abstract boolean isUserVisible (int userId)

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

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

حدود
userId int

عائدات
boolean

رميات
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

حدود
userId int

displayId int

عائدات
boolean

رميات
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

عائدات
boolean

رميات
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

عائدات
boolean

رميات
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

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

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

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

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

listDisplayIds

public abstract  listDisplayIds ()

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

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

عائدات

رميات
DeviceNotAvailableException

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 صحيح إذا كان التسجيل ناجحًا ، أو خطأ إذا كان العكس.

RegisterDeviceActionR Receiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

يسجل IDeviceActionReceiver لهذا الجهاز.

سيتم إخطار جميع IDeviceActionReceiver المسجلة قبل بدء إجراء الجهاز وبعد انتهاء إجراء الجهاز.

حدود
deviceActionReceiver IDeviceActionReceiver : معرف IDeviceActionReceiver الذي سيتم تسجيله.

إزالة

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

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

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

public abstract void removeOwners ()

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

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

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

public abstract boolean removeUser (int userId)

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

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

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

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

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

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

ضبط

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

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

حدود
namespace String

key String

value String

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

ضبط

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

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

حدود
userId int

namespace String

key String

value String

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

بدء المستخدم

public abstract boolean startUser (int userId)

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

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

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

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

بدء المستخدم

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

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

startVisibleBackgroundUser

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

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

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

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

displayId int : عرض لبدء المستخدم مرئيًا على

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

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

رميات
DeviceNotAvailableException

stopUser

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

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

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

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

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

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

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

stopUser

public abstract boolean stopUser (int userId)

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

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

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

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

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

public abstract boolean switchUser (int userId)

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

حدود
userId int

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

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

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

public abstract boolean switchUser (int userId, 
                long timeout)

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

حدود
userId int

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

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

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

TakeBugreport

public abstract Bugreport takeBugreport ()

خذ تقرير خطأ وأعده داخل كائن Bugreport للتعامل معه. العودة فارغة في حالة الإصدار. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

عائدات
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Uninstall an Android package from device.

حدود
packageName String : the Android package to uninstall

عائدات
String a ERROR(/String) with an error code, or null if success.

رميات
DeviceNotAvailableException if connection with device is lost and cannot be recovered.

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 ERROR(/String) with an error code, or null if success.

رميات
DeviceNotAvailableException if connection with device is lost and cannot be recovered.