ITestDevice

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)

يتصل بشبكة واي فاي.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

يتصل بشبكة واي فاي.

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

يحصل على خريطة 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, 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 ()

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

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

checkConnectivity

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 الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi() أو ITestDevice#clearLastConnectedWifiNetwork() .

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

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

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

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.

ConnectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

يتصل بشبكة واي فاي.

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

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

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

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.

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 خلاف ذلك

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.

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 خلاف ذلك

رميات
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 : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء

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

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

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

createUser

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

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

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

guest boolean : قم بتمكين علامة المستخدم --ضيف أثناء الإنشاء

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

عائدات
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

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

dableKeyguard

public abstract void disableKeyguard ()

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

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

رميات
DeviceNotAvailableException

DisableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

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

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.

قطع الاتصالمنWifi

public abstract boolean disconnectFromWifi ()

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

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

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

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.

doFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

عائدات
boolean true في حالة وجود الملف، false في غير ذلك.

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

حدود
process String : اسم عملية الجهاز المطلوب تفريغها.

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 : يجب أن تكون واحدة من {"system"، "secure"، "global"}

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

رميات
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 مثبت على الجهاز.

رميات
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 للملف المضغوط الذي يحتوي على تقرير الأخطاء، ويُرجع قيمة فارغة في حالة الفشل.

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 devices_state".

عائدات

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

عائدات
ERROR(/Set) لأسماء حزم 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) من وحدات String الرئيسية المثبتة حاليًا على الجهاز.

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

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

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

getScreenshot

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

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

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

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

getScreenshot

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)

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

حدود
userId int

namespace String

key String

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

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

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

getUserFlags

public abstract int getUserFlags (int userId)

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

حدود
userId int

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

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

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

حدود
userId int

عائدات
int

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

hasFeature

public abstract boolean hasFeature (String feature)

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

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

عائدات
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 String تحتوي على رمز خطأ، أو null في حالة النجاح.

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.

ثبت المجموعة

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

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

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

حدود
packageFile File : ملف apk للتثبيت

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

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

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

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

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

installPackageForUser

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

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

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

حدود
packageFile File : ملف apk للتثبيت

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

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

userId int : معرف المستخدم الصحيح الذي سيتم التثبيت له.

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

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

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

installPackageForUser

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

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

حدود
packageFile File : ملف apk للتثبيت

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

userId int : معرف المستخدم الصحيح الذي سيتم التثبيت له.

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

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

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.

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, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

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

حدود
packageFiles : ملفات APK المحلية

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

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

userId int : معرف المستخدم الصحيح الذي سيتم التثبيت له.

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

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

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

installPackagesForUser

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

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

حدود
packageFiles : ملفات APK المحلية

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

userId int : معرف المستخدم الصحيح الذي سيتم التثبيت له.

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

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

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

installRemotePackages

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

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

حدود
remoteApkPaths : مسارات ملف APK عن بعد

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

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

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

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

installRemotePackages

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

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

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

حدود
remoteApkPaths : مسارات ملف APK عن بعد

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

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

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

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

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

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

عائدات
boolean

رميات
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

عائدات
boolean

رميات
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

حدود
packageName String

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

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

isUserRunning

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

isUserVisible

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، على سبيل المثال اختبارات بيانات الهاتف المحمول.

عائدات
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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

listener ITestLogger : ITestLogger لتسجيل تقرير الأخطاء.

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

تسجيل الجهازActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

يقوم بتسجيل IDeviceActionReceiver لهذا الجهاز.

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

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

RemoveAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

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

RemoveOwners

public abstract void removeOwners ()

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

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

RemoveUser

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

setSetting

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

setSetting

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

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

حدود
userId int

namespace String

key String

value String

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

startUser

public abstract boolean startUser (int userId)

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

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

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

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

startUser

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

com.takeBugreport

public abstract Bugreport takeBugreport ()

خذ تقرير الأخطاء وأعده داخل كائن Bugreport للتعامل معه. العودة فارغة في حالة الإصدار. يجب تنظيف الملف المشار إليه في كائن Bugreport عبر Bugreport.close() .

عائدات
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

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

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

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.

إلغاء التثبيتPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

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

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

رميات
DeviceNotAvailableException إذا انقطع الاتصال بالجهاز ولا يمكن استعادته.