تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

NativeDevice

public class NativeDevice
extends Object implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.device.NativeDevice

الفئات الفرعية المباشرة المعروفة

جهاز اختبار

جهاز اختبار تنفيذ ITestDevice لجهاز أندرويد كامل المكدس

الفئات الفرعية غير المباشرة المعروفة

LocalAndroidVirtualDevice ، ManagedRemoteDevice ، NestedRemoteDevice ، RemoteAndroidDevice ، RemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	فئة الأجهزة الافتراضية المحلية التي تعمل على مضيف TradeFed.
ManagedRemoteDevice	جهاز يعمل داخل جهاز افتراضي نديره عن بعد عبر مثيل Tradefed داخل الجهاز الافتراضي.
NestedRemoteDevice	تمثيل الجهاز الذي يعمل داخل جهاز Cuttlefish VM البعيد.
جهاز Android البعيد	تنفيذ `ITestDevice` لجهاز أندرويد متكامل متصل عبر اتصال adb.
RemoteAndroidVirtualDevice	يعمل على توسيع سلوك `RemoteAndroidDevice` لجهاز Android متكامل يعمل في Google Compute Engine (Gce).

التنفيذ الافتراضي لأجهزة Android غير الكاملة من ITestDevice .

ملخص

فصول متداخلة
`class`	`NativeDevice.AdbAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` أثناء تشغيل أمر "adb ...." الخاص بنظام التشغيل.
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` لإعادة تشغيل الجهاز.

الثوابت
`int`	`INVALID_USER_ID` القيمة التي تم إرجاعها لأي معرف مستخدم غير صالح/لم يتم العثور عليه: حدد UserHandle القيمة -10000
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` العدد الافتراضي لمحاولات إعادة محاولة تنفيذ الأمر

مجالات
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

المقاولين العامة
`NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` يقوم بإنشاء `TestDevice` .

الأساليب العامة
`void`	`batchPrefetchStartupBuildProps ()` التحسين الجزئي (حوالي 400 ملي) عن طريق الجلب المسبق لجميع العناصر التي نحتاجها بدلاً من استدعاء "adb getprop" لكل واحدة.
`boolean`	`canSwitchToHeadlessSystemUser ()` إرجاع ما إذا كان مسموحًا بالتبديل إلى مستخدم النظام مقطوع الرأس.
`boolean`	`checkApiLevelAgainstNextRelease (int strictMinLevel)` تحقق مما إذا كانت الميزة مدعومة حاليًا أم لا في ظل الحد الأدنى من مستوى الدعم.
`boolean`	`checkConnectivity ()` تأكد من أن الجهاز لديه اتصال بالشبكة.
`boolean`	`clearErrorDialogs ()` حاول استبعاد أي مربعات حوار خطأ معروضة حاليًا على واجهة مستخدم الجهاز.
`void`	`clearLastConnectedWifiNetwork ()` مسح آخر شبكة wifi متصلة.
`void`	`clearLogcat ()` يحذف أي بيانات logcat المتراكمة.
`boolean`	`connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)` `connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)` يتصل بشبكة واي فاي.
`boolean`	`connectToWifiNetwork (String wifiSsid, String wifiPsk)` يتصل بشبكة واي فاي.
`boolean`	`connectToWifiNetwork ( wifiSsidToPsk)` `connectToWifiNetwork ( wifiSsidToPsk)` يتصل بشبكة wifi.f
`boolean`	`connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)` يتصل بشبكة واي فاي.
`boolean`	`connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)` متغير من `connectToWifiNetwork(String, String)` الذي يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.
`boolean`	`connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)` متغير من `connectToWifiNetwork(String, String)` الذي يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.
`int`	`createUser (String name, boolean guest, boolean ephemeral)` قم بإنشاء مستخدم باسم معين والأعلام المقدمة
`int`	`createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)` قم بإنشاء مستخدم باسم معين والأعلام المقدمة
`int`	`createUser (String name)` أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.
`int`	`createUserNoThrow (String name)` أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.
`void`	`deleteFile (String deviceFilePath)` طريقة مساعدة لحذف ملف أو دليل على الجهاز.
`void`	`deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)` يزيل `IDeviceActionReceiver` المسجل .
`boolean`	`deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)` طريقة مساعدة للتحقق مما إذا كان الجهاز قد تمت إعادة تشغيله من خلال مقارنة خادم النظام الحالي مع خادم System_server السابق `ProcessInfo` .
`boolean`	`deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)` طريقة مساعدة للتحقق مما إذا كان الجهاز قد تمت إعادة تشغيله بشكل بسيط منذ وقت UTC منذ فترة من الجهاز `ERROR(/TimeUnit)` .
`boolean`	`disableAdbRoot ()` يقوم بإيقاف تشغيل جذر adb.
`void`	`disableKeyguard ()` محاولات لتعطيل حارس المفاتيح.
`boolean`	`disableNetworkMonitor ()` تعطيل مراقبة الشبكة على الجهاز.
`boolean`	`disconnectFromWifi ()` قطع الاتصال بشبكة wifi.
`boolean`	`doesFileExist (String deviceFilePath, int userId)` طريقة مساعدة لتحديد ما إذا كان الملف الموجود على الجهاز موجودًا لمستخدم معين.
`boolean`	`doesFileExist (String deviceFilePath)` طريقة مساعدة لتحديد ما إذا كان الملف الموجود على الجهاز موجودًا أم لا.
`File`	`dumpHeap (String process, String devicePath)` محاولة تفريغ الكومة من system_server.
`boolean`	`enableAdbRoot ()` يقوم بتشغيل بنك التنمية الآسيوي الجذر.
`boolean`	`enableNetworkMonitor ()` تمكين مراقبة الشبكة على الجهاز.
`String`	`executeAdbCommand (long timeout, String... cmdArgs)` أسلوب مساعد يقوم بتنفيذ أمر adb كأمر نظام مع انتهاء المهلة المحددة.
`String`	`executeAdbCommand (long timeout, envMap, String... cmdArgs)` `executeAdbCommand (long timeout, envMap, String... cmdArgs)` أسلوب مساعد يقوم بتنفيذ أمر adb كأمر نظام مع انتهاء المهلة المحددة.
`String`	`executeAdbCommand (String... cmdArgs)` الطريقة المساعدة التي تنفذ أمر adb كأمر نظام.
`CommandResult`	`executeFastbootCommand (String... cmdArgs)` أسلوب مساعد يقوم بتنفيذ أمر fastboot كأمر نظام مع مهلة افتراضية مدتها دقيقتين.
`CommandResult`	`executeFastbootCommand (long timeout, String... cmdArgs)` طريقة المساعد التي تنفذ أمر fastboot كأمر نظام.
`CommandResult`	`executeLongFastbootCommand (String... cmdArgs)` طريقة المساعد التي تنفذ أمر fastboot طويل الأمد كأمر نظام.
`CommandResult`	`executeLongFastbootCommand ( envVarMap, String... cmdArgs)` `executeLongFastbootCommand ( envVarMap, String... cmdArgs)` أسلوب مساعد ينفذ أمر fastboot طويل الأمد كأمر نظام مع متغيرات بيئة النظام.
`String`	`executeShellCommand (String command)` الأسلوب المساعد الذي ينفذ أمر adb Shell ويعيد الإخراج `String` .
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` ينفذ أمر adb shell، مع المزيد من المعلمات للتحكم في سلوك الأمر.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` ينفذ أمر adb shell، مع المزيد من المعلمات للتحكم في سلوك الأمر.
`void`	`executeShellCommand (String command, IShellOutputReceiver receiver)` ينفذ أمر adb Shell المحدد، ويعيد المحاولة عدة مرات في حالة فشل الأمر.
`CommandResult`	`executeShellV2Command (String cmd)` أسلوب مساعد ينفذ أمر adb Shell ويعيد النتائج على هيئة `CommandResult` التي يتم ملؤها بشكل صحيح بمخرجات حالة الأمر وstdout وstderr.
`CommandResult`	`executeShellV2Command (String cmd, OutputStream pipeToOutput)` الأسلوب المساعد الذي ينفذ أمر adb Shell ويعيد النتائج على شكل `CommandResult` التي يتم ملؤها بشكل صحيح بمخرجات حالة الأمر وstderr.
`CommandResult`	`executeShellV2Command (String cmd, File pipeAsInput)` أسلوب مساعد ينفذ أمر adb Shell ويعيد النتائج على شكل `CommandResult` التي يتم ملؤها بشكل صحيح بمخرجات حالة الأمر وstdout وstderr.
`CommandResult`	`executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` ينفذ أمر adb shell، مع المزيد من المعلمات للتحكم في سلوك الأمر.
`CommandResult`	`executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` ينفذ أمر adb shell، مع المزيد من المعلمات للتحكم في سلوك الأمر.
`CommandResult`	`executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` ينفذ أمر adb shell، مع المزيد من المعلمات للتحكم في سلوك الأمر.
`CommandResult`	`executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` ينفذ أمر adb shell، مع المزيد من المعلمات للتحكم في سلوك الأمر.
`CommandResult`	`fastbootWipePartition (String partition)` الطريقة المساعدة التي تمسح قسمًا للجهاز.
	`getActiveApexes ()` جلب المعلومات حول APEXes المنشط على الجهاز.
	`getAllSettings (String namespace)` إرجاع أزواج القيمة الرئيسية لمساحة الاسم المطلوبة.
`DeviceAllocationState`	`getAllocationState ()` إرجاع حالة التخصيص الحالية للجهاز
`String`	`getAndroidId (int userId)` ابحث عن معرف android المرتبط بمعرف المستخدم وأعده، ويكون فارغًا إذا لم يتم العثور عليه.
	`getAndroidIds ()` قم بإنشاء خريطة لمعرفات android التي تم العثور عليها مطابقة لمعرفات المستخدمين.
`int`	`getApiLevel ()` احصل على مستوى API للجهاز.
`PackageInfo`	`getAppPackageInfo (String packageName)` جلب معلومات حول الحزمة المثبتة على الجهاز.
	`getAppPackageInfos ()` جلب معلومات الحزم المثبتة على الجهاز.
`String`	`getBasebandVersion ()` الطريقة الملائمة للحصول على إصدار النطاق الأساسي (الراديو) لهذا الجهاز.
`Integer`	`getBattery ()` يُرجع مستوى البطارية الحالي لجهاز ما أو يُرجع Null إذا كان مستوى البطارية غير متاح.
`boolean`	`getBooleanProperty (String name, boolean defaultValue)` إرجاع قيمة منطقية للخاصية المحددة.
	`getBootHistory ()` تقوم الطريقة المساعدة بجمع خريطة محفوظات التمهيد مع وقت التمهيد وسبب التمهيد.
	`getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)` يقوم الأسلوب المساعد بجمع خريطة سجل التمهيد مع وقت التمهيد وسبب التمهيد منذ الوقت المحدد منذ العصر من الجهاز ووحدة الوقت المحددة.
`String`	`getBootloaderVersion ()` طريقة ملائمة للحصول على إصدار أداة تحميل التشغيل لهذا الجهاز.
`InputStreamSource`	`getBugreport ()` استرداد تقرير الأخطاء من الجهاز.
`InputStreamSource`	`getBugreportz ()` يسترد تقرير الأخطاء من الجهاز.
`String`	`getBuildAlias ()` استرجع الاسم المستعار للإصدار الذي يعمل عليه الجهاز حاليًا.
`String`	`getBuildFlavor ()` استرجاع نكهة البناء للجهاز.
`String`	`getBuildId ()` قم باسترجاع البنية التي يعمل عليها الجهاز حاليا.
`String`	`getBuildSigningKeys ()` إرجاع نوع المفتاح المستخدم لتوقيع صورة الجهاز عادةً ما يتم توقيع أجهزة Android باستخدام مفاتيح الاختبار (كما هو الحال في AOSP) أو مفاتيح الإصدار (التي تسيطر عليها الشركات المصنعة للأجهزة الفردية)
`DeviceDescriptor`	`getCachedDeviceDescriptor ()` يتم إرجاع `DeviceDescriptor` المخزن مؤقتًا إذا تم تخصيص الجهاز، وإلا فإنه يتم إرجاع `DeviceDescriptor` الحالي.
`DeviceDescriptor`	`getCachedDeviceDescriptor (boolean shortDescriptor)` يتم إرجاع `DeviceDescriptor` المخزن مؤقتًا إذا تم تخصيص الجهاز، وإلا فإنه يتم إرجاع `DeviceDescriptor` الحالي.
`String[]`	`getChildren (String path)` بديل لاستخدام `IFileEntry` الذي لن يعمل أحيانًا بسبب الأذونات.
`AbstractConnection`	`getConnection ()` الاتصال الحالي المرتبط بالجهاز.
`DeviceFoldableState`	`getCurrentFoldableState ()` يُرجع الحالة الحالية القابلة للطي للجهاز أو فارغة في حالة حدوث بعض المشكلات.
`int`	`getCurrentUser ()` قم بإرجاع معرف المستخدم الحالي قيد التشغيل.
`String`	`getDeviceClass ()` الحصول على فئة الجهاز.
`long`	`getDeviceDate ()` إرجاع تاريخ الجهاز بالمللي ثانية منذ العصر.
`DeviceDescriptor`	`getDeviceDescriptor ()` قم بإرجاع `DeviceDescriptor` من معلومات الجهاز للحصول على معلومات عنه دون تمرير كائن الجهاز الفعلي.
`DeviceDescriptor`	`getDeviceDescriptor (boolean shortDescriptor)` قم بإرجاع `DeviceDescriptor` من معلومات الجهاز للحصول على معلومات عنه دون تمرير كائن الجهاز الفعلي.
`TestDeviceState`	`getDeviceState ()` الحصول على حالة الجهاز.
`long`	`getDeviceTimeOffset (Date date)` مساعد للحصول على الفارق الزمني بين الجهاز `ERROR(/Date)` .
`InputStreamSource`	`getEmulatorOutput ()` احصل على دفق المحاكي stdout وstderr
`Process`	`getEmulatorProcess ()` قم بإرجاع `Process` المقابلة لهذا المحاكي.
`final File`	`getExecuteShellCommandLog ()` السجل الذي يحتوي على كافة سجلات `executeShellCommand(String)` .
`long`	`getExternalStoreFreeSpace ()` طريقة مساعدة لتحديد مقدار المساحة الحرة على وحدة التخزين الخارجية للجهاز.
`String`	`getFastbootPath ()` يُرجع مسار ملف fastboot الثنائي المُستخدم.
`String`	`getFastbootProductType ()` طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
`String`	`getFastbootProductVariant ()` طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
`String`	`getFastbootSerialNumber ()` إرجاع الرقم التسلسلي لوضع التشغيل السريع.
`String`	`getFastbootVariable (String variableName)` قم باسترجاع قيمة متغير fastboot المعطاة من الجهاز.
`String`	`getFastbootVersion ()` إرجاع سلسلة إصدار ثنائي fastboot المستخدم.
`IFileEntry`	`getFileEntry (String path)` استرداد إشارة إلى ملف بعيد على الجهاز.
`IFileEntry`	`getFileEntry (FileListingService.FileEntry entry)` مساعد غير رسمي للحصول على `FileEntry` من مسار غير جذر.
	`getFoldableStates ()` إرجاع قائمة الحالات القابلة للطي على الجهاز.
`IDevice`	`getIDevice ()` تقوم بإرجاع مرجع إلى ddmlib `IDevice` المرتبط.
	`getInstalledPackageNames ()` جلب أسماء حزم التطبيقات الموجودة على الجهاز.
`long`	`getIntProperty (String name, long defaultValue)` إرجاع قيمة عددية للخاصية المحددة من الجهاز.
`String`	`getIpAddress ()` يحصل على عنوان IP الخاص بالجهاز.
`KeyguardControllerState`	`getKeyguardState ()` قم بإرجاع كائن للحصول على الحالة الحالية للوحة المفاتيح أو فارغة إذا لم تكن مدعومة.
`long`	`getLastExpectedRebootTimeMillis ()` إرجاع آخر مرة قامت فيها Tradefed APIs بتشغيل عملية إعادة التشغيل بالمللي ثانية منذ EPOCH كما تم إرجاعها بواسطة `System.currentTimeMillis()` .
`int`	`getLaunchApiLevel ()` احصل على أول مستوى API تم إطلاقه بالجهاز.
`InputStreamSource`	`getLogcat ()` الاستيلاء على دفق لقطة من بيانات logcat.
`InputStreamSource`	`getLogcat (int maxBytes)` احصل على دفق لقطة لآخر `maxBytes` من بيانات logcat الملتقطة.
`InputStreamSource`	`getLogcatDump ()` احصل على تفريغ السجل الحالي للجهاز.
`InputStreamSource`	`getLogcatSince (long date)` احصل على دفق لقطة من بيانات logcat التي تم التقاطها بدءًا من التاريخ المقدم.
`String`	`getMacAddress ()` يُرجع عنوان MAC الخاص بالجهاز، ويكون فارغًا إذا فشل في الاستعلام من الجهاز.
`Integer`	`getMainUserId ()` إرجاع معرف المستخدم الرئيسي.
	`getMainlineModuleInfo ()` احصل على معلومات حول الوحدات الرئيسية المثبتة على الجهاز.
`int`	`getMaxNumberOfRunningUsersSupported ()` احصل على الحد الأقصى لعدد المستخدمين المدعومين الذين يعملون في نفس الوقت.
`int`	`getMaxNumberOfUsersSupported ()` احصل على الحد الأقصى لعدد المستخدمين المدعومين.
`Process`	`getMicrodroidProcess ()`
`IDeviceStateMonitor`	`getMonitor ()` قم بإرجاع `IDeviceStateMonitor` المرتبط بالجهاز.
`String`	`getMountPoint (String mountName)` إرجاع نقطة التحميل.
`ITestDevice.MountPointInfo`	`getMountPointInfo (String mountpoint)` يُرجع `MountPointInfo` المطابق لمسار نقطة التثبيت المحدد، أو `null` إذا لم يكن هذا المسار يحتوي على أي شيء مُثبت أو لا يظهر في /proc/mounts كنقطة تثبيت.
	`getMountPointInfo ()` يُرجع نسخة مُحللة من المعلومات الموجودة في /proc/mounts على الجهاز
`TestDeviceOptions`	`getOptions ()` جلب خيارات الاختبار للجهاز.
`long`	`getPartitionFreeSpace (String partition)` طريقة مساعدة لتحديد مقدار المساحة الحرة على قسم الجهاز.
`Integer`	`getPrimaryUserId ()` إرجاع معرف المستخدم الأساسي.
`ProcessInfo`	`getProcessByName (String processName)` يقوم الأسلوب المساعد بتشغيل الأمر "pidof" و"stat" وإرجاع كائن `ProcessInfo` بمعرف PID ووقت بدء العملية للعملية المحددة.
`String`	`getProcessPid (String process)` يُرجع معرف الخدمة أو يكون فارغًا إذا حدث خطأ ما.
`String`	`getProductType ()` طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز.
`String`	`getProductVariant ()` طريقة ملائمة للحصول على متغير المنتج لهذا الجهاز.
`String`	`getProperty (String name)` استرداد قيمة الخاصية المعطاة من الجهاز.
`ITestDevice.RecoveryMode`	`getRecoveryMode ()` احصل على وضع الاسترداد الحالي المستخدم للجهاز.
`InputStreamSource`	`getScreenshot (String format)` يلتقط لقطة شاشة من الجهاز.
`InputStreamSource`	`getScreenshot (long displayId)` يلتقط لقطة شاشة من الجهاز المحدد بمعرف العرض.
`InputStreamSource`	`getScreenshot (String format, boolean rescale)` يلتقط لقطة شاشة من الجهاز.
`InputStreamSource`	`getScreenshot ()` يلتقط لقطة شاشة من الجهاز.
`String`	`getSerialNumber ()` طريقة ملائمة للحصول على الرقم التسلسلي لهذا الجهاز.
`String`	`getSetting (int userId, String namespace, String key)` قم بإرجاع قيمة الإعداد المطلوب.
`String`	`getSetting (String namespace, String key)` راجع `getSetting(int, String, String)` ويتم إجراؤه على مستخدم النظام.
`String`	`getSimOperator ()` قم بإرجاع مشغل بطاقة SIM أو فارغًا إذا لم يكن متاحًا أو إذا كان الجهاز غير متاح.
`String`	`getSimState ()` قم بإرجاع حالة بطاقة SIM أو فارغة إذا لم تكن متوفرة أو كان الجهاز غير متوفر.
	`getTombstones ()` جلب وإرجاع قائمة شواهد القبور من الأجهزة.
`long`	`getTotalMemory ()` يُرجع إجمالي حجم الذاكرة الفعلية بالبايت أو -1 في حالة حدوث خطأ داخلي
	`getUninstallablePackageNames ()` قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها.
`boolean`	`getUseFastbootErase ()` تعرف على ما إذا كنت تريد استخدام مسح fastboot أو تنسيق fastboot لمسح قسم على الجهاز.
`int`	`getUserFlags (int userId)` البحث عن إشارات مستخدم معين وإعادتها.
	`getUserInfos ()` يحصل على خريطة useId لمعلومات `UserInfo` على الجهاز.
`int`	`getUserSerialNumber (int userId)` إعادة الرقم التسلسلي المرتبط بمعرف المستخدم إذا وجد، -10000 في أي حالات أخرى.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent (DeviceEvent event)` معالجة حدث الجهاز المحدد. قم بمعالجة DeviceEvent، الذي قد ينقل أو لا ينقل هذا الجهاز إلى حالة تخصيص جديدة.
`boolean`	`hasFeature (String feature)` تحقق مما إذا كانت الميزة متوفرة على الجهاز.
`String`	`installPackage (File packageFile, boolean reinstall, String... extraArgs)` تثبيت حزمة Android على الجهاز.
`String`	`installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` تثبيت حزمة Android على الجهاز.
`String`	`installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)` تثبيت حزمة Android على الجهاز لمستخدم معين.
`String`	`installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` تثبيت حزمة Android على الجهاز لمستخدم معين.
`void`	`invalidatePropertyCache ()`
`boolean`	`isAdbRoot ()`
`boolean`	`isAdbTcp ()`
`boolean`	`isAppEnumerationSupported ()` تحقق مما إذا كان النظام الأساسي الموجود على الجهاز يدعم تعداد التطبيقات
`boolean`	`isBypassLowTargetSdkBlockSupported ()` تحقق مما إذا كان النظام الأساسي الموجود على الجهاز يدعم تجاوز كتلة sdk ذات الهدف المنخفض عند عمليات تثبيت التطبيق
`boolean`	`isDebugfsMounted ()` تحقق مما إذا تم تثبيت debugfs.
`boolean`	`isDeviceEncrypted ()` يعود إذا كان الجهاز مشفرًا.
`boolean`	`isDirectory (String path)` يُرجع صحيحًا إذا كان المسار الموجود على الجهاز عبارة عن دليل، ويُرجع خطأً بخلاف ذلك.
`boolean`	`isEnableAdbRoot ()`
`boolean`	`isEncryptionSupported ()` يُرجع إذا كان التشفير مدعومًا على الجهاز.
`boolean`	`isExecutable (String fullPath)` يُرجع صحيحًا إذا كان مسار الملف على الجهاز ملفًا قابلاً للتنفيذ، ويُرجع خطأ إذا كان خلاف ذلك.
`boolean`	`isFastbootEnabled ()` ارجع إذا كان fastboot متاحًا للجهاز.
`boolean`	`isHeadless ()` يُرجع صحيحًا إذا كان الجهاز بدون رأس (بدون شاشة)، ويُرجع صحيحًا إذا كان خلاف ذلك.
`boolean`	`isHeadlessSystemUserMode ()` إرجاع ما إذا كان الجهاز يستخدم وضع مستخدم النظام بدون رأس.
`boolean`	`isMainUserPermanentAdmin ()` لعرض ما إذا كان المستخدم الرئيسي هو مسؤول دائم ولا يمكن حذفه أو خفض رتبته إلى حالة غير مسؤول.
`boolean`	`isMultiUserSupported ()` يحدد ما إذا كان يتم دعم المستخدمين المتعددين.
`boolean`	`isPackageInstalled (String packageName, String userId)` استعلم عن الجهاز للحصول على اسم حزمة معين ومعرف المستخدم المحدد للتحقق مما إذا كان مثبتًا حاليًا أم لا لهذا المستخدم.
`boolean`	`isPackageInstalled (String packageName)` استعلم عن الجهاز للحصول على اسم حزمة معين للتحقق مما إذا كان مثبتًا حاليًا أم لا.
`boolean`	`isRuntimePermissionSupported ()` تحقق مما إذا كان النظام الأساسي الموجود على الجهاز يدعم منح إذن وقت التشغيل
`boolean`	`isStateBootloaderOrFastbootd ()` يُرجع صحيحًا إذا كان الجهاز في `TestDeviceState#FASTBOOT` أو `TestDeviceState.FASTBOOTD` .
`boolean`	`isUserRunning (int userId)` تحقق مما إذا كان مستخدم معين قيد التشغيل.
`boolean`	`isUserSecondary (int userId)` قم بإرجاع ما إذا كان المستخدم المحدد مستخدمًا ثانويًا وفقًا لعلاماته.
`boolean`	`isUserVisible (int userId)` يتحقق مما إذا كان المستخدم المحدد مرئيًا.
`boolean`	`isUserVisibleOnDisplay (int userId, int displayId)` يتحقق مما إذا كان المستخدم المحدد مرئيًا في الشاشة المحددة.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported ()` يُرجع ما إذا كان الجهاز يسمح للمستخدمين ببدء الظهور في الخلفية في `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` .
`boolean`	`isVisibleBackgroundUsersSupported ()` إرجاع ما إذا كان الجهاز يسمح للمستخدمين ببدء الظهور في الخلفية.
`boolean`	`isWifiEnabled ()` اختبار ما إذا تم تمكين واي فاي.
	`listDisplayIds ()` قم بتجميع قائمة معرفات شاشات العرض المتوفرة على الجهاز كما ورد في "dumpsys SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers ()` يحصل على قائمة العروض التي يمكن استخدامها `start a user visible in the background` .
	`listUsers ()` يحصل على قائمة المستخدمين على الجهاز.
`boolean`	`logAnrs ( ITestLogger logger)` يجمع ويسجل أخطاء ANR من الجهاز.
`boolean`	`logBugreport (String dataName, ITestLogger listener)` طريقة مساعدة لأخذ تقرير الأخطاء وتسجيله للصحفيين.
`void`	`logOnDevice (String tag, Log.LogLevel level, String format, Object... args)` قم بتسجيل رسالة في سجل الجهاز.
`void`	`mountDebugfs ()` جبل التصحيحات.
`void`	`nonBlockingReboot ()` يصدر أمرًا لإعادة تشغيل الجهاز ويعود عند اكتمال الأمر وعندما لا يعد الجهاز مرئيًا لـ adb.
`void`	`postAdbRootAction ()` قم بالتجاوز إذا كان الجهاز يحتاج إلى اتخاذ بعض الإجراءات المحددة بعد جذر adb وقبل إعادة اتصال الجهاز بالإنترنت.
`void`	`postAdbUnrootAction ()` قم بالتجاوز إذا كان الجهاز يحتاج إلى اتخاذ بعض الإجراءات المحددة بعد إلغاء تجذير بنك التنمية الآسيوي وقبل إعادة اتصال الجهاز بالإنترنت.
`void`	`postBootSetup ()` قم بتنفيذ التعليمات لتكوين الجهاز لاختبار ذلك بعد كل عملية تمهيد.
`void`	`postInvocationTearDown (Throwable exception)` خطوات إضافية للتنظيف المطلوب الخاص بالجهاز والتي سيتم تنفيذها بعد انتهاء الاستدعاء.
`void`	`preInvocationSetup ( IBuildInfo info, MultiMap <String, String> attributes)` خطوات إضافية للإعداد المطلوب الخاص بالجهاز والتي سيتم تنفيذها على الجهاز قبل تدفق الاستدعاء.
`boolean`	`pullDir (String deviceFilePath, File localDir)` سحب محتويات الدليل بشكل متكرر من الجهاز.
`boolean`	`pullFile (String remoteFilePath, File localFile)` استرداد ملف من الجهاز.
`File`	`pullFile (String remoteFilePath, int userId)` يسترد ملفًا من الجهاز، ويخزنه في ملف `ERROR(/File)` مؤقت محلي، ويعيد هذا `File` .
`File`	`pullFile (String remoteFilePath)` يسترد ملفًا من الجهاز، ويخزنه في ملف `ERROR(/File)` مؤقت محلي، ويعيد هذا `File` .
`boolean`	`pullFile (String remoteFilePath, File localFile, int userId)` استرداد ملف من الجهاز.
`String`	`pullFileContents (String remoteFilePath)` يسترد ملفًا من الجهاز، ويعيد محتوياته.
`File`	`pullFileFromExternal (String remoteFilePath)` طريقة ملائمة لاسترداد ملف من وحدة التخزين الخارجية للجهاز، وتخزينه في ملف `ERROR(/File)` مؤقت محلي، وإرجاع مرجع إلى هذا `File` .
`boolean`	`pushDir (File localFileDir, String deviceFilePath, excludedDirectories)` `pushDir (File localFileDir, String deviceFilePath, excludedDirectories)` دفع محتويات الدليل بشكل متكرر إلى الجهاز مع استبعاد بعض الأدلة التي تمت تصفيتها.
`boolean`	`pushDir (File localFileDir, String deviceFilePath)` دفع محتويات الدليل بشكل متكرر إلى الجهاز.
`boolean`	`pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` متغير من `pushFile(File, String)` والذي يمكنه بشكل اختياري التفكير في تقييم الحاجة إلى موفر المحتوى.
`boolean`	`pushFile (File localFile, String remoteFilePath)` ادفع ملفًا إلى الجهاز.
`boolean`	`pushString (String contents, String remoteFilePath)` دفع الملف الذي تم إنشاؤه من سلسلة إلى الجهاز
`void`	`reboot (String reason)` يعيد تشغيل الجهاز في وضع adb مع وجود `reason` للاستمرار أثناء إعادة التشغيل.
`void`	`reboot ()` يعيد تشغيل الجهاز في وضع adb.
`void`	`rebootIntoBootloader ()` يعيد تشغيل الجهاز في وضع أداة تحميل التشغيل.
`void`	`rebootIntoFastbootd ()` يعيد تشغيل الجهاز إلى وضع fastbootd.
`void`	`rebootIntoRecovery ()` يعيد تشغيل الجهاز في وضع الاسترداد adb.
`void`	`rebootIntoSideload ()` يعيد تشغيل الجهاز في وضع التحميل الجانبي لـ adb (لاحظ أن هذا وضع خاص قيد الاسترداد) يتم الحظر حتى يدخل الجهاز في وضع التحميل الجانبي
`void`	`rebootIntoSideload (boolean autoReboot)` يعيد تشغيل الجهاز في وضع التحميل الجانبي لـ adb (لاحظ أن هذا وضع خاص قيد الاسترداد) يتم الحظر حتى يدخل الجهاز في وضع التحميل الجانبي
`void`	`rebootUntilOnline ()` بديل لإعادة `reboot()` والذي يحظر فقط حتى يصبح الجهاز متصلاً بالإنترنت، أي مرئي لـ adb.
`void`	`rebootUntilOnline (String reason)` بديل لإعادة `reboot()` والذي يحظر فقط حتى يصبح الجهاز متصلاً بالإنترنت، أي مرئي لـ adb.
`void`	`rebootUserspace ()` يعيد تشغيل جزء مساحة المستخدم فقط من الجهاز.
`void`	`rebootUserspaceUntilOnline ()` بديل لـ `rebootUserspace()` ()} الذي يحظر فقط حتى يصبح الجهاز متصلاً بالإنترنت، أي مرئي لـ adb.
`boolean`	`recoverDevice ()` محاولات لاستعادة اتصالات الجهاز.
`void`	`registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)` يقوم بتسجيل `IDeviceActionReceiver` لهذا الجهاز.
`void`	`remountSystemReadOnly ()` جعل قسم النظام على الجهاز للقراءة فقط.
`void`	`remountSystemWritable ()` جعل قسم النظام على الجهاز قابلاً للكتابة.
`void`	`remountVendorReadOnly ()` اجعل قسم البائع على الجهاز للقراءة فقط.
`void`	`remountVendorWritable ()` جعل قسم البائع على الجهاز قابلاً للكتابة.
`boolean`	`removeAdmin (String componentName, int userId)` قم بإزالة مسؤول الجهاز المحدد في مستخدم معين وإرجاع `true` إذا كان ناجحًا، `false` إذا كان خلاف ذلك.
`void`	`removeOwners ()` قم بإزالة جميع مالكي ملفات تعريف الجهاز الحاليين بأقصى جهد.
`boolean`	`removeUser (int userId)` إزالة مستخدم معين من الجهاز.
`void`	`resetContentProviderSetup ()` قم بإعادة تعيين العلامة لإعداد موفر المحتوى لتشغيلها مرة أخرى.
`boolean`	`runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` طريقة ملائمة لتنفيذ `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` مع تمرير مستمع واحد أو أكثر كمعلمات.
`boolean`	`runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)` `runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)` يقوم بإجراء اختبارات الأجهزة، ويوفر إمكانية استرداد الجهاز.
`boolean`	`runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)` `runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners)` نفس الخطأ مثل `ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))` ولكنه يقوم بإجراء الاختبار للمستخدم المحدد.
`boolean`	`runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` مثل `ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)` ولكنه يقوم بإجراء الاختبار لمستخدم معين.
`void`	`setConfiguration ( IConfiguration configuration)` يقوم بإدخال `IConfiguration` قيد الاستخدام.
`final void`	`setConnectionAvdInfo ( GceAvdInfo avdInfo)`
`void`	`setDate (Date date)` يضبط التاريخ على الجهاز ملاحظة: تحديد التاريخ على الجهاز يتطلب الجذر
`boolean`	`setDeviceOwner (String componentName, int userId)` قم بتعيين مكون مسؤول الجهاز كمالك للجهاز في مستخدم معين.
`void`	`setDeviceState ( TestDeviceState deviceState)` تحديث حالة الجهاز.
`void`	`setEmulatorOutputStream ( SizeLimitedOutputStream output)` بالنسبة للمحاكي، قم بتعيين `SizeLimitedOutputStream` لتسجيل الإخراج
`void`	`setEmulatorProcess (Process p)` يضبط `Process` ، عندما يكون هذا الجهاز محاكيًا.
`void`	`setFastbootEnabled (boolean fastbootEnabled)` اضبط خيار التشغيل السريع للجهاز.
`void`	`setFastbootPath (String fastbootPath)` يضبط المسار إلى ملف fastboot الثنائي الذي يجب استخدامه.
`void`	`setIDevice (IDevice newDevice)` قم بتحديث IDevice المرتبط بـ ITestDevice هذا.
`void`	`setLogStartDelay (int delay)` يضبط الوقت بالمللي ثانية للانتظار قبل بدء التقاط logcat لجهاز متصل بالإنترنت.
`void`	`setOptions ( TestDeviceOptions options)` قم بتعيين `TestDeviceOptions` للجهاز
`boolean`	`setProperty (String propKey, String propValue)` يضبط قيمة الخاصية المحددة على الجهاز.
`void`	`setRecovery ( IDeviceRecovery recovery)` قم بتعيين `IDeviceRecovery` لاستخدامه لهذا الجهاز.
`void`	`setRecoveryMode ( ITestDevice.RecoveryMode mode)` اضبط وضع الاسترداد الحالي الذي سيتم استخدامه للجهاز.
`void`	`setSetting (String namespace, String key, String value)` راجع `setSetting(int, String, String, String)` ويتم تنفيذها على مستخدم النظام.
`void`	`setSetting (int userId, String namespace, String key, String value)` أضف قيمة إعداد إلى مساحة الاسم لمستخدم معين.
`void`	`setTestLogger ( ITestLogger testLogger)` يقوم بإدخال مثيل `ITestLogger`
`void`	`setUseFastbootErase (boolean useFastbootErase)` قم بتعيين ما إذا كنت تريد استخدام مسح fastboot أو تنسيق fastboot لمسح قسم على الجهاز.
`void`	`startLogcat ()` ابدأ في التقاط إخراج logcat من الجهاز في الخلفية.
`boolean`	`startUser (int userId)` يبدأ تشغيل مستخدم معين في الخلفية إذا كان متوقفًا حاليًا.
`boolean`	`startUser (int userId, boolean waitFlag)` يبدأ تشغيل مستخدم معين في الخلفية إذا كان متوقفًا حاليًا.
`boolean`	`startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)` يبدأ مستخدمًا معينًا في الخلفية، ويكون مرئيًا في شاشة العرض المحددة (أي السماح للمستخدم ببدء الأنشطة في تلك الشاشة).
`void`	`stopEmulatorOutput ()` أغلق وحذف إخراج المحاكي.
`void`	`stopLogcat ()` توقف عن التقاط مخرجات logcat من الجهاز، وتجاهل بيانات logcat المحفوظة حاليًا.
`boolean`	`stopUser (int userId)` توقف مستخدم معين.
`boolean`	`stopUser (int userId, boolean waitFlag, boolean forceFlag)` إيقاف مستخدم معين.
`String`	`switchToAdbTcp ()` قم بتبديل الجهاز إلى وضع adb-over-tcp.
`boolean`	`switchToAdbUsb ()` قم بتبديل الجهاز إلى adb عبر وضع USB.
`boolean`	`switchUser (int userId)` قم بالتبديل إلى معرف مستخدم آخر بمهلة افتراضية.
`boolean`	`switchUser (int userId, long timeout)` قم بالتبديل إلى معرف مستخدم آخر مع تحديد المهلة المحددة كموعد نهائي.
`boolean`	`syncFiles (File localFileDir, String deviceFilePath)` يقوم بمزامنة محتويات دليل الملفات المحلي بشكل متزايد مع الجهاز.
`Bugreport`	`takeBugreport ()` خذ تقرير الأخطاء وأعده داخل كائن `Bugreport` للتعامل معه.
`String`	`uninstallPackage (String packageName)` قم بإلغاء تثبيت حزمة Android من الجهاز.
`String`	`uninstallPackageForUser (String packageName, int userId)` قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين.
`boolean`	`unlockDevice ()` يفتح قفل الجهاز إذا كان الجهاز في حالة مشفرة.
`void`	`unmountDebugfs ()` إلغاء تحميل التصحيحات.
`boolean`	`waitForBootComplete (long timeOut)` يتم الحظر حتى يتم تعيين علامة اكتمال تشغيل الجهاز.
`boolean`	`waitForDeviceAvailable ()` ينتظر حتى يستجيب الجهاز ويكون متاحًا للاختبار.
`boolean`	`waitForDeviceAvailable (long waitTime)` ينتظر حتى يستجيب الجهاز ويكون متاحًا للاختبار.
`boolean`	`waitForDeviceAvailableInRecoverPath (long waitTime)` ينتظر حتى يصبح الجهاز مستجيبًا ومتاحًا دون النظر في مسار الاسترداد.
`void`	`waitForDeviceBootloader ()` يتم الحظر حتى يصبح الجهاز مرئيًا عبر fastboot.
`boolean`	`waitForDeviceInRecovery (long waitTime)` كتل الجهاز ليكون في حالة "adb Recovery" (لاحظ أن هذا يختلف عن `IDeviceRecovery` ).
`boolean`	`waitForDeviceInSideload (long waitTime)` كتل للجهاز ليكون في حالة "adb Sideload".
`boolean`	`waitForDeviceNotAvailable (long waitTime)` الكتل الخاصة بالجهاز غير متوفرة، أي أنها مفقودة من بنك التنمية الآسيوي
`void`	`waitForDeviceOnline ()` يتم الحظر حتى يصبح الجهاز مرئيًا عبر adb.
`void`	`waitForDeviceOnline (long waitTime)` يتم الحظر حتى يصبح الجهاز مرئيًا عبر adb.
`boolean`	`waitForDeviceShell (long waitTime)` ينتظر حتى يستجيب الجهاز لأمر adb Shell الأساسي.

الأساليب المحمية
`void`	`addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand (String command, boolean forceExitStatusDetection)` ينشئ أمر نظام التشغيل لجلسة أوامر adb shell المعينة والوسائط
`void`	`checkApiLevelAgainst (String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction ( NativeDevice.RebootMode rebootMode, String reason)` قم بإنشاء `RebootDeviceAction` لاستخدامه عند تنفيذ إجراء إعادة التشغيل.
`IRunUtil`	`createRunUtil ()`
`void`	`doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)` إجراء إعادة تشغيل بنك التنمية الآسيوي.
`void`	`ensureRuntimePermissionSupported ()` أسلوب مساعد لطرح الاستثناء إذا كان إذن وقت التشغيل غير مدعوم
`int`	`getApiLevelSafe ()`
`ITestLogger`	`getLogger ()`
`IRunUtil`	`getRunUtil ()` احصل على مثيل `RunUtil` لاستخدامه.
`void`	`initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes)`
`String`	`internalGetProperty (String propName, String fastbootVar, String description)` قم بإحضار خاصية الجهاز، من ذاكرة التخزين المؤقت ddmlib افتراضيًا، ثم ارجع إلى إما `adb shell getprop` أو `fastboot getvar` اعتمادًا على ما إذا كان الجهاز في Fastboot أم لا.
`boolean`	`isInRebootCallback ()` إرجاع ما إذا كانت عمليات رد الاتصال الخاصة بإعادة التشغيل قيد التنفيذ حاليًا أم لا.
`boolean`	`isNewer (File localFile, IFileEntry entry)` يُرجع `true` إذا كان الملف المحلي أحدث من الملف البعيد.
`void`	`notifyRebootEnded ()` يقوم بإعلام كافة `IDeviceActionReceiver` حول حدث نهاية إعادة التشغيل.
`void`	`notifyRebootStarted ()` يخطر كافة `IDeviceActionReceiver` حول حدث بدء إعادة التشغيل.
`boolean`	`performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` ينفذ إجراءً على هذا الجهاز.
`void`	`postAdbReboot ()` الإجراءات الإضافية المحتملة التي يمكن اتخاذها بعد إعادة التشغيل.
`void`	`prePostBootSetup ()` يسمح لكل نوع جهاز (AndroidNativeDevice، TestDevice) بتجاوز هذه الطريقة لإعداد محدد بعد التمهيد.
`boolean`	`pullFileInternal (String remoteFilePath, File localFile)`
`void`	`setClock (Clock clock)` قم بتعيين مثيل الساعة للاستخدام.
`void`	`setMicrodroidProcess (Process process)` وضع علامة على جهاز الاختبار على أنه microdroid وتعيين CID الخاص به.
`void`	`setTestDeviceOptions ( deviceOptions)` `setTestDeviceOptions ( deviceOptions)`
`CommandResult`	`simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd)` `simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd)` ينفذ أمر fastboot بسيطًا باستخدام متغيرات البيئة ويبلغ عن حالة الأمر.
`CommandResult`	`simpleFastbootCommand (long timeout, String[] fullCmd)` ينفذ أمر fastboot بسيطًا ويبلغ عن حالة الأمر.
`boolean`	`waitForDeviceNotAvailable (String operationDesc, long time)` انتظر حتى يصبح الجهاز غير متاح (أوقف إرسال التقارير إلى بنك التنمية الآسيوي).

الثوابت

هوية مستخدم غير صالحه

public static final int INVALID_USER_ID

القيمة التي تم إرجاعها لأي معرف مستخدم غير صالح/لم يتم العثور عليه: حدد UserHandle القيمة -10000

القيمة الثابتة: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

القيمة الثابتة: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

العدد الافتراضي لمحاولات إعادة محاولة تنفيذ الأمر

القيمة الثابتة: 2 (0x00000002)

مجالات

DEBUGFS_PATH

public static final String DEBUGFS_PATH

بطاقة الذاكرة

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

مخيارات

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

المقاولين العامة

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

يقوم بإنشاء TestDevice .

حدود
`device`	`IDevice` : `IDevice` المرتبط
`stateMonitor`	`IDeviceStateMonitor` : آلية `IDeviceStateMonitor` المراد استخدامها
`allocationMonitor`	`IDeviceMonitor` : `IDeviceMonitor` للإبلاغ عن تغييرات حالة التخصيص. يمكن أن تكون فارغة

الأساليب العامة

BatchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

التحسين الجزئي (حوالي 400 ملي) عن طريق الجلب المسبق لجميع العناصر التي نحتاجها بدلاً من استدعاء "adb getprop" لكل واحدة. أي أن جلب كافة الخصائص هو بنفس السرعة التي يتم بها جلب واحدة. أشياء مثل devices.getApiLevel() وcheckApiLevelAgainstNextRelease وgetBuildAlias كلها تستدعي `adb getprop` تحت الغطاء. نقوم بإحضارها في مكالمة واحدة ونتصل بـ NativeDevice.setProperty. حتى إذا لم نفعل ذلك، فسوف يقوم NativeDevice بنفسه باستدعاء setProperty وتخزين النتيجة مؤقتًا للمكالمات المستقبلية. نحن نفعل ذلك في وقت سابق قليلا. إذا كان الجهاز في مرحلة الاسترداد أو كانت هناك أخطاء أخرى في جلب الدعائم، فإننا نتجاهلها فقط.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

حدود
`strictMinLevel`	`int` : الحد الأدنى الصارم للمستوى الممكن الذي يدعم الميزة.

عائدات
`boolean`	صحيح إذا كان المستوى مدعومًا. باطل غير ذلك.

رميات
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

تأكد من أن الجهاز لديه اتصال بالشبكة.

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

رميات
`DeviceNotAvailableException`

ClearErrorDialogs

public boolean clearErrorDialogs ()

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

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

رميات
`DeviceNotAvailableException`

ClearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

com.clearLogcat

public void clearLogcat ()

يحذف أي بيانات logcat المتراكمة.

يعد هذا مفيدًا للحالات التي تريد فيها التأكد من ITestDevice#getLogcat() لا يُرجع إلا بيانات السجل التي تم إنتاجها بعد نقطة معينة (مثل بعد تحديث إصدار جهاز جديد، وما إلى ذلك).

ConnectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

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

رميات
`DeviceNotAvailableException`

ConnectToWifiNetwork

public 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 boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

رميات
`DeviceNotAvailableException`

ConnectToWifiNetwork

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

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

حدود
`wifiSsid`	`String` : wifi ssid للاتصال به
`wifiPsk`	`String` : عبارة مرور PSK أو فارغة إذا كانت غير مشفرة
`scanSsid`	`boolean` : ما إذا كان سيتم البحث عن SSID المخفي لهذه الشبكة.

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

رميات
`DeviceNotAvailableException`

ConnectToWifiNetworkIfNeeded

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

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

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

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

رميات
`DeviceNotAvailableException`

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

رميات
`DeviceNotAvailableException`

createUser

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

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

حدود
`name`	`String` : من المستخدم لإنشائها على الجهاز
`guest`	`boolean` : قم بتمكين علامة المستخدم --ضيف أثناء الإنشاء
`ephemeral`	`boolean` : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء

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

رميات
`DeviceNotAvailableException`

createUser

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

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

حدود
`name`	`String` : من المستخدم لإنشائها على الجهاز
`guest`	`boolean` : قم بتمكين علامة المستخدم --ضيف أثناء الإنشاء
`ephemeral`	`boolean` : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء
`forTesting`	`boolean` : قم بتمكين علامة الاختبار --for-testing أثناء الإنشاء

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

رميات
`DeviceNotAvailableException`

createUser

public int createUser (String name)

أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.

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

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

رميات
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.

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

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

رميات
`DeviceNotAvailableException`

حذف ملف

public void deleteFile (String deviceFilePath)

طريقة مساعدة لحذف ملف أو دليل على الجهاز.

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

رميات
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

DeviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

طريقة مساعدة للتحقق مما إذا كان الجهاز قد تمت إعادة تشغيله من خلال مقارنة خادم النظام الحالي مع خادم System_server السابق ProcessInfo . استخدم getProcessByName(String) للحصول على ProcessInfo .

حدود
`prevSystemServerProcess`	`ProcessInfo` : العملية السابقة لخادم النظام `ProcessInfo` .

عائدات
`boolean`	`true` إذا تم إعادة تشغيل الجهاز

رميات
`DeviceNotAvailableException`

DeviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

طريقة مساعدة للتحقق مما إذا كان الجهاز قد تمت إعادة تشغيله بشكل بسيط منذ وقت UTC منذ فترة من الجهاز ERROR(/TimeUnit) . تشير عملية إعادة التشغيل الناعمة إلى إعادة تشغيل system_server خارج عملية إعادة التشغيل الثابتة للجهاز (على سبيل المثال: إعادة التشغيل المطلوبة). يمكن الحصول على الجهاز الحالي utcEpochTime بالميلي ثانية عن طريق طريقة getDeviceDate() .

حدود
`utcEpochTime`	`long` : وقت الجهاز بالثانية منذ العصر.
`timeUnit`	`TimeUnit` : وحدة الوقت `TimeUnit` لـ utcEpochTime المحدد.

عائدات
`boolean`	`true` إذا تم إعادة تشغيل الجهاز

رميات
`DeviceNotAvailableException`

this.disableAdbRoot

public boolean disableAdbRoot ()

يقوم بإيقاف تشغيل جذر adb.

قد يؤدي تعطيل جذر adb إلى قطع اتصال الجهاز بـ adb. سيتم حظر هذه الطريقة حتى يتوفر الجهاز.

عائدات
`boolean`	`true` إذا نجحت.

رميات
`DeviceNotAvailableException`

dableKeyguard

public void disableKeyguard ()

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

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

رميات
`DeviceNotAvailableException`

DisableNetworkMonitor

public boolean disableNetworkMonitor ()

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

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

رميات
`DeviceNotAvailableException`

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

public boolean disconnectFromWifi ()

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

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

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

رميات
`DeviceNotAvailableException`

doFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

حدود
`deviceFilePath`	`String` : المسار المطلق للملف الموجود على الجهاز المراد فحصه
`userId`	`int` : معرف المستخدم الذي يتم من خلاله التحقق من وجود الملف

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

رميات
`DeviceNotAvailableException`

doFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

رميات
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

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

رميات
`DeviceNotAvailableException`

تمكينAdbRoot

public boolean enableAdbRoot ()

يقوم بتشغيل بنك التنمية الآسيوي الجذر. إذا كان إعداد "تمكين الجذر" "خطأ"، فسيتم تسجيل رسالة والعودة دون تمكين الجذر.

قد يؤدي تمكين adb root إلى قطع اتصال الجهاز بـ adb. سيتم حظر هذه الطريقة حتى يتوفر الجهاز.

عائدات
`boolean`	`true` إذا نجحت.

رميات
`DeviceNotAvailableException`

تمكينNetworkMonitor

public boolean enableNetworkMonitor ()

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

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

رميات
`DeviceNotAvailableException`

تنفيذAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

أسلوب مساعد يقوم بتنفيذ أمر adb كأمر نظام مع انتهاء المهلة المحددة.

يجب استخدام executeShellCommand(String) بدلاً من ذلك حيثما كان ذلك ممكنًا، حيث توفر هذه الطريقة اكتشافًا أفضل للفشل وأداءً أفضل.

حدود
`timeout`	`long` : الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، 0L لعدم وجود مهلة
`cmdArgs`	`String` : أمر adb والوسائط المراد تشغيلها

عائدات
`String`	stdout من الأمر. `null` إذا فشل الأمر في التنفيذ.

رميات
`DeviceNotAvailableException`

تنفيذAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

أسلوب مساعد يقوم بتنفيذ أمر adb كأمر نظام مع انتهاء المهلة المحددة.

حدود
`timeout`	`long` : الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، 0L لعدم وجود مهلة
`envMap`	: بيئة لتعيين الأمر
`cmdArgs`	`String` : أمر adb والوسائط المطلوب تشغيلها

عائدات
`String`	stdout من الأمر. `null` إذا فشل الأمر في التنفيذ.

رميات
`DeviceNotAvailableException`

تنفيذAdbCommand

public String executeAdbCommand (String... cmdArgs)

الطريقة المساعدة التي تنفذ أمر adb كأمر نظام.

حدود
`cmdArgs`	`String` : أمر adb والوسائط المراد تشغيلها

عائدات
`String`	stdout من الأمر. `null` إذا فشل الأمر في التنفيذ.

رميات
`DeviceNotAvailableException`

تنفيذ FastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

أسلوب مساعد يقوم بتنفيذ أمر fastboot كأمر نظام مع مهلة افتراضية مدتها دقيقتين.

من المتوقع استخدامه عندما يكون الجهاز في وضع التشغيل السريع بالفعل.

حدود
`cmdArgs`	`String` : أمر fastboot والوسائط المطلوب تشغيلها

عائدات
`CommandResult`	CommandResult الذي يحتوي على إخراج الأمر

رميات
`DeviceNotAvailableException`

تنفيذ FastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

طريقة المساعد التي تنفذ أمر fastboot كأمر نظام.

من المتوقع استخدامه عندما يكون الجهاز في وضع التشغيل السريع بالفعل.

حدود
`timeout`	`long` : الوقت بالمللي ثانية قبل انتهاء صلاحية الأمر
`cmdArgs`	`String` : أمر fastboot والوسائط المطلوب تشغيلها

عائدات
`CommandResult`	CommandResult الذي يحتوي على إخراج الأمر

رميات
`DeviceNotAvailableException`

تنفيذ LongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

طريقة المساعد التي تنفذ أمر fastboot طويل الأمد كأمر نظام.

مطابق لـ executeFastbootCommand(String) باستثناء أنه يستخدم مهلة أطول.

حدود
`cmdArgs`	`String` : أمر fastboot والوسائط للتشغيل

عائدات
`CommandResult`	CommandResult التي تحتوي على إخراج الأوامر

رميات
`DeviceNotAvailableException`

ExecutElongfastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

طريقة HELPER التي تنفذ أمر Fastboot طويل المدى كأمر نظام مع متغيرات بيئة النظام.

مطابق لـ executeFastbootCommand(String) باستثناء ما يستخدم مهلة أطول.

حدود
`envVarMap`	: متغيرات بيئة النظام التي يعمل عليها أمر fastboot
`cmdArgs`	`String` : أمر fastboot والوسائط للتشغيل

عائدات
`CommandResult`	CommandResult التي تحتوي على إخراج الأوامر

رميات
`DeviceNotAvailableException`

التنفيذيين

public String executeShellCommand (String command)

طريقة المساعد التي تنفذ الأمر ADB Shell ويعيد الإخراج String .

حدود
`command`	`String` : أمر ADB Shell لتشغيله

عائدات
`String`	إخراج الصدفة

رميات
`DeviceNotAvailableException`

التنفيذيين

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
`command`	`String` : أمر ADB Shell لتشغيله
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` لتوجيه الإخراج shell إلى.
`maxTimeToOutputShellResponse`	`long` : الحد الأقصى لمقدار الوقت الذي يُسمح خلاله للأمر بعدم إخراج أي استجابة ؛ الوحدة كما هو محدد في `timeUnit`
`timeUnit`	`TimeUnit` : وحدة `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ `retryAttempts` دون نجاح.

رميات
`DeviceNotAvailableException`

التنفيذيين

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
`command`	`String` : أمر ADB Shell لتشغيله
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` لتوجيه الإخراج shell إلى.
`maxTimeoutForCommand`	`long` : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في `timeUnit`
`maxTimeToOutputShellResponse`	`long` : الحد الأقصى لمقدار الوقت الذي يُسمح خلاله للأمر بعدم إخراج أي استجابة ؛ الوحدة كما هو محدد في `timeUnit`
`timeUnit`	`TimeUnit` : وحدة `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ `retryAttempts` دون نجاح.

رميات
`DeviceNotAvailableException`

التنفيذيين

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

ينفذ الأمر ADB SHELL المعطى ، إعادة المحاولة عدة مرات في حالة فشل الأمر.

شكل أبسط من executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) مع القيم الافتراضية.

حدود
`command`	`String` : أمر ADB Shell لتشغيله
`receiver`	`IShellOutputReceiver` : `IShellOutputReceiver` لتوجيه الإخراج shell إلى.

رميات
`DeviceNotAvailableException`

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd)

طريقة المساعد التي تنفذ أمر ADB Shell ويعيد النتائج كأوامر CommandResult بشكل صحيح مع إخراج حالة الأمر ، STDOUT و STDERR.

حدود
`cmd`	`String` : الأمر الذي يجب تشغيله.

عائدات
`CommandResult`	النتيجة في `CommandResult` .

رميات
`DeviceNotAvailableException`

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

طريقة المساعد التي تنفذ الأمر ADB Shell وإرجاع النتائج كأمرات CommandResult التي يتم ملؤها بشكل صحيح مع إخراج حالة الأمر و STDERR. يتم توجيه stdout إلى الدفق المحدد.

حدود
`cmd`	`String` : الأمر الذي يجب تشغيله.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` حيث سيتم إعادة توجيه إخراج STD أو NULL.

عائدات
`CommandResult`	النتيجة في `CommandResult` .

رميات
`DeviceNotAvailableException`

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

طريقة HELPER التي تنفذ أمر ADB Shell ويعيد النتائج كأحد CommandResult بشكل صحيح مع إخراج حالة الأمر ، STDOUT و STDERR.

حدود
`cmd`	`String` : الأمر الذي يجب تشغيله.
`pipeAsInput`	`File` : `ERROR(/File)` سيتم أن يتم إدخاله كإدخال إلى الأمر ، أو NULL.

عائدات
`CommandResult`	النتيجة في `CommandResult` .

رميات
`DeviceNotAvailableException`

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
`cmd`	`String` : أمر ADB Shell لتشغيله
`maxTimeoutForCommand`	`long` : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في `timeUnit`
`timeUnit`	`TimeUnit` : وحدة `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ `retryAttempts` دون نجاح.

عائدات
`CommandResult`

رميات
`DeviceNotAvailableException`

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
`cmd`	`String` : أمر ADB Shell لتشغيله
`maxTimeoutForCommand`	`long` : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في `timeUnit`
`timeUnit`	`TimeUnit` : وحدة `maxTimeToOutputShellResponse`

عائدات
`CommandResult`

رميات
`DeviceNotAvailableException`

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
`cmd`	`String` : أمر ADB Shell لتشغيله
`pipeAsInput`	`File` : `ERROR(/File)` سيتم أن يتم إدخاله كإدخال إلى الأمر ، أو NULL.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` حيث سيتم إعادة توجيه إخراج STD أو NULL.
`maxTimeoutForCommand`	`long` : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في `timeUnit`
`timeUnit`	`TimeUnit` : وحدة `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ `retryAttempts` دون نجاح.

عائدات
`CommandResult`

رميات
`DeviceNotAvailableException`

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
`cmd`	`String` : أمر ADB Shell لتشغيله
`pipeAsInput`	`File` : `ERROR(/File)` سيتم أن يتم إدخاله كإدخال إلى الأمر ، أو NULL.
`pipeToOutput`	`OutputStream` : `ERROR(/OutputStream)` حيث سيتم إعادة توجيه إخراج STD أو NULL.
`pipeToError`	`OutputStream` : `ERROR(/OutputStream)` حيث سيتم إعادة توجيه خطأ STD أو NULL.
`maxTimeoutForCommand`	`long` : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في `timeUnit`
`timeUnit`	`TimeUnit` : وحدة `maxTimeToOutputShellResponse`
`retryAttempts`	`int` : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ `retryAttempts` دون نجاح.

عائدات
`CommandResult`

رميات
`DeviceNotAvailableException`

FastBootWipePartition

public CommandResult fastbootWipePartition (String partition)

طريقة المساعد التي تمسح قسم للجهاز.

إذا كان getUseFastbootErase() true ، فسيتم استخدام Fastboot Erase لمسح القسم. يجب على الجهاز بعد ذلك إنشاء نظام ملفات في المرة القادمة التي يقوم بها الجهاز. خلاف ذلك ، يتم استخدام تنسيق Fastboot والذي سيقوم بإنشاء نظام ملفات جديد على الجهاز.

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

حدود
`partition`	`String` : القسم للمسح

عائدات
`CommandResult`	CommandResult التي تحتوي على إخراج الأوامر

رميات
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

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

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

رميات
`DeviceNotAvailableException`

getAllsettings

public  getAllSettings (String namespace)

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

حدود
`namespace`	`String` : يجب أن تكون واحدة من {"System" ، "Secure" ، "Global"}

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

رميات
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

إرجاع حالة التخصيص الحالية للجهاز

عائدات
`DeviceAllocationState`

getandroidid

public String getAndroidId (int userId)

ابحث وإرجاع معرف Android المرتبط بـ UserD ، NULL إذا لم يتم العثور عليه.

حدود
`userId`	`int`

عائدات
`String`

رميات
`DeviceNotAvailableException`

getandroidids

public  getAndroidIds ()

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

عائدات
	وجدت Map of Android IDS معرفات المستخدم مطابقة.

رميات
`DeviceNotAvailableException`

getApilevel

public int getApiLevel ()

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

عائدات
`int`	عدد صحيح يشير إلى مستوى API للجهاز

رميات
`DeviceNotAvailableException`

getAppackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

حدود
`packageName`	`String`

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

رميات
`DeviceNotAvailableException`

getAppackageInfos

public  getAppPackageInfos ()

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

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

رميات
`DeviceNotAvailableException`

getBaseBandversion

public String getBasebandVersion ()

طريقة الراحة للحصول على إصدار Baseband (راديو) من هذا الجهاز. إن الحصول على إصدار الراديو محدد للجهاز ، لذلك قد لا يعيد المعلومات الصحيحة لجميع الأجهزة. تعتمد هذه الطريقة على GSM.Version.BaseBand Propery لإرجاع معلومات الإصدار الصحيحة. هذا ليس دقيقًا لبعض أجهزة CDMA وقد لا يتطابق الإصدار الذي يتم إرجاعه إلى الإصدار الذي تم الإبلاغ عنه من Fastboot وقد لا يعيد الإصدار لراديو CDMA. TL ؛ DR هذه الطريقة تقارير فقط إصدار دقيق إذا كانت خاصية GSM.Version.BaseBand هي نفسها التي يتم إرجاعها بواسطة fastboot getvar version-baseband .

عائدات
`String`	إصدار `String` الأساسي أو `null` إذا كان لا يمكن تحديده (لا يمكن قراءة الجهاز أو سلسلة الإصدار)

رميات
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

إرجاع مستوى البطارية الحالي للجهاز أو الفارغ إذا لم يكن مستوى البطارية متاحًا.

عائدات
`Integer`

getBooleAnproperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

إرجاع القيمة المنطقية للممتلكات المحددة.

حدود
`name`	`String` : اسم الخاصية
`defaultValue`	`boolean` : القيمة الافتراضية للعودة إذا كانت الخاصية فارغة أو غير موجودة.

عائدات
`boolean`	`true` إذا كان للخاصية قيمة `"1"` أو `"y"` أو `"yes"` أو `"on"` أو `"true"` ، أو `false` إذا كان للممتلكات قيمة `"0"` ، `"n"` ، `"no"` ، `"off"` ، `"false"` ، أو `defaultValue` خلاف ذلك.

رميات
`DeviceNotAvailableException`

getBoothistory

public  getBootHistory ()

تقوم طريقة Helper بجمع خريطة تاريخ التمهيد مع وقت التمهيد وسبب التمهيد.

عائدات
	خريطة وقت التمهيد (وقت UTC في الثانية منذ عصر) وعقل التمهيد

رميات
`DeviceNotAvailableException`

getBoothistorysince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

تقوم طريقة Helper بجمع خريطة تاريخ التمهيد مع سبب التمهيد وسبب التمهيد منذ الوقت المحدد منذ فترة من الجهاز والوحدة الزمنية المحددة. يمكن الحصول على الجهاز الحالي UtcepochTime بالمللي ثانية عن طريق Method getDeviceDate() .

حدود
`utcEpochTime`	`long` : وقت الجهاز منذ فترة.
`timeUnit`	`TimeUnit` : وحدة الوقت `TimeUnit` .

عائدات
	خريطة وقت التمهيد (وقت UTC في الثانية منذ عصر) وعقل التمهيد

رميات
`DeviceNotAvailableException`

getBootloaderversion

public String getBootloaderVersion ()

طريقة الراحة للحصول على إصدار Bootloader من هذا الجهاز.

سيحاول استرداد إصدار تحميل التمهيد من الحالة الحالية للجهاز. (أي إذا كان الجهاز في وضع Fastboot ، فسوف يحاول استرداد الإصدار من Fastboot)

عائدات
`String`	إصدار `String` bootloader أو `null` إذا كان لا يمكن العثور عليه

رميات
`DeviceNotAvailableException`

getBugReport

public InputStreamSource getBugreport ()

يسترجع bugreport من الجهاز.

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

عائدات
`InputStreamSource`	`InputStreamSource` الذي ينتج محتويات bugreport عند الطلب. في حالة الفشل ، ستنتج `InputStreamSource` `ERROR(/InputStream)` .

getBugreportz

public InputStreamSource getBugreportz ()

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

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

عائدات
`InputStreamSource`	A `InputStreamSource` من ملف zip الذي يحتوي على bugreportz ، إرجاع فارغ في حالة الفشل.

getBuildalias

public String getBuildAlias ()

استرجع الاسم المستعار للبناء الذي يعمل عليه الجهاز حاليًا.

عادةً ما يكون Build Alias سلسلة أكثر قابلية للقراءة من معرف الإنشاء (عادةً رقم للبناء Nexus). على سبيل المثال ، لقد قام إصدار Android 4.2 النهائي ببناء الاسم المستعار JDQ39 ، وبناء معرف 573038

عائدات
`String`	الاسم المستعار أو التراجع إلى معرف البناء إذا لم يتم استرداده

رميات
`DeviceNotAvailableException`

getBuildFlavor

public String getBuildFlavor ()

استرداد نكهة البناء للجهاز.

عائدات
`String`	نكهة البناء أو الفارغ إذا لم يتم استردادها

رميات
`DeviceNotAvailableException`

getBuildid

public String getBuildId ()

استرداد البناء يعمل الجهاز حاليًا.

عائدات
`String`	معرف الإنشاء أو `IBuildInfo#UNKNOWN_BUILD_ID` إذا لم يتم استرداده

رميات
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

إرجاع نوع المفتاح المستخدم للتوقيع على صورة الجهاز

عادةً ما يتم توقيع أجهزة Android باستخدام مفاتيح الاختبار (كما هو الحال في AOSP) أو مفاتيح الإصدار (التي يتم التحكم فيها من قبل الشركات المصنعة للأجهزة الفردية)

عائدات
`String`	مفتاح التوقيع إذا وجدت ، لاغية خلاف ذلك.

رميات
`DeviceNotAvailableException`

getCacheddevicedescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

إرجاع DeviceDescriptor المخزنة مؤقتًا إذا تم تخصيص الجهاز ، وإلا بإرجاع DeviceDescriptor الحالي.

عائدات
`DeviceDescriptor`

getCacheddevicedescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

إرجاع DeviceDescriptor المخزنة مؤقتًا إذا تم تخصيص الجهاز ، وإلا بإرجاع DeviceDescriptor الحالي.

حدود
`shortDescriptor`	`boolean` : ما إذا كان يجب الحد من الواصف إلى الحد الأدنى من المعلومات أو عدمه

عائدات
`DeviceDescriptor`

جادش

public String[] getChildren (String path)

بديل لاستخدام IFileEntry الذي لن يعمل في بعض الأحيان بسبب الأذونات.

حدود
`path`	`String` : هل المسار على الجهاز حيث يجري البحث

عائدات
`String[]`	مجموعة من السلسلة التي تحتوي على جميع الملفات في مسار على الجهاز.

رميات
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

الاتصال الحالي المرتبط بالجهاز.

عائدات
`AbstractConnection`

getCurrentFoldablestate

public DeviceFoldableState getCurrentFoldableState ()

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

عائدات
`DeviceFoldableState`

رميات
`DeviceNotAvailableException`

getCurrentuser

public int getCurrentUser ()

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

عائدات
`int`

رميات
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

احصل على فئة الجهاز.

عائدات
`String`	فئة جهاز `String` .

getDevicedate

public long getDeviceDate ()

إرجاع تاريخ الجهاز بالميلي ثانية منذ فترة.

عائدات
`long`	تاريخ الجهاز بتنسيق العصر.

رميات
`DeviceNotAvailableException`

getDevicedescriptor

public DeviceDescriptor getDeviceDescriptor ()

إرجاع A DeviceDescriptor من معلومات الجهاز للحصول على معلومات عليها دون تمرير كائن الجهاز الفعلي.

عائدات
`DeviceDescriptor`

getDevicedescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

إرجاع A DeviceDescriptor من معلومات الجهاز للحصول على معلومات عليها دون تمرير كائن الجهاز الفعلي.

حدود
`shortDescriptor`	`boolean` : ما إذا كان يجب الحد من الواصف إلى الحد الأدنى من المعلومات أو عدمه

عائدات
`DeviceDescriptor`

getDevicestate

public TestDeviceState getDeviceState ()

احصل على حالة الجهاز.

عائدات
`TestDeviceState`

getDevicetimeOffset

public long getDeviceTimeOffset (Date date)

المساعد للحصول على فرق الوقت بين الجهاز ERROR(/Date) . استخدم وقت الحقبة داخليًا.

حدود
`date`	`Date`

عائدات
`long`	الفرق في ميلي ثانية

رميات
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

احصل على تيار المحاكي stdout و stderr

عائدات
`InputStreamSource`	إخراج المحاكي

GetEmulatorProcess

public Process getEmulatorProcess ()

إرجاع Process المقابلة لهذا المحاكي.

عائدات
`Process`	`Process` أو `null`

getExecuteshellCommandLog

public final File getExecuteShellCommandLog ()

السجل الذي يحتوي على جميع سجلات executeShellCommand(String) .

عائدات
`File`

getExternalStorefreespace

public long getExternalStoreFreeSpace ()

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

عائدات
`long`	مقدار المساحة الحرة بالكيبل

رميات
`DeviceNotAvailableException`

GetFastBootpath

public String getFastbootPath ()

إرجاع مسار الثنائي fastboot المستخدمة. لا يزال يتطلب isFastbootEnabled() أن تكون صحيحة ، لتمكين وظائف Fastboot.

عائدات
`String`

GetFastBootProductType

public String getFastbootProductType ()

طريقة الراحة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع Fastboot.

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

عائدات
`String`	اسم نوع منتج `String` أو `null` إذا كان لا يمكن تحديده

رميات
`DeviceNotAvailableException`

GetFastBootProductVariant

public String getFastbootProductVariant ()

طريقة الراحة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع Fastboot.

عائدات
`String`	اسم نوع منتج `String` أو `null` إذا كان لا يمكن تحديده

رميات
`DeviceNotAvailableException`

GetFastBootSerialNumber

public String getFastbootSerialNumber ()

إرجاع الرقم التسلسلي لوضع Fastboot.

عائدات
`String`

GetFastBootvariable

public String getFastbootVariable (String variableName)

استرداد قيمة متغير Fastboot المعطى من الجهاز.

حدود
`variableName`	`String` : الاسم المتغير

عائدات
`String`	قيمة الخاصية أو `null` إذا لم تكن موجودة

رميات
`DeviceNotAvailableException`

GetFastbootversion

public String getFastbootVersion ()

إرجاع سلسلة الإصدار من Fastboot الثنائي المستخدمة. أو لاغية إذا حدث خطأ ما.

عائدات
`String`

getFileentry

public IFileEntry getFileEntry (String path)

استرداد مرجع إلى ملف بعيد على الجهاز.

حدود
`path`	`String` : مسار الملف للاسترداد. يمكن أن يكون مسارًا أو مسارًا مطلقًا بالنسبة إلى "/". (أي كلا من "/النظام" و "System" Syntax مدعوم)

عائدات
`IFileEntry`	`IFileEntry` أو `null` إذا كان لا يمكن العثور على ملف في `path` المعطى

رميات
`DeviceNotAvailableException`

getFileentry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

المساعد غير الرسمي للحصول على FileEntry من مسار غير الجذر. FixMe: Refactor نظام fileentry لتوفيره من أي مسار. (حتى غير الجذر).

حدود
`entry`	`FileListingService.FileEntry` : `FileEntry` لا بالضرورة الجذر كما يتطلب ddmlib.

عائدات
`IFileEntry`	fileEntryWrapper تمثل fileentry.

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

getFoldablestates

public  getFoldableStates ()

إرجاع قائمة الحالات القابلة للطي على الجهاز. يمكن الحصول عليها باستخدام "CMD Device_State Print-States".

عائدات

رميات
`DeviceNotAvailableException`

getidevice

public IDevice getIDevice ()

إرجاع إشارة إلى ddmlib IDevice المرتبطة.

قد يتم تخصيص IDevice الجديد بواسطة DDMS في كل مرة يقوم فيها الجهاز بفصل وإعادة الاتصال من ADB. وبالتالي ، يجب ألا يحتفظ المتصلين بالإشارة إلى IDevice ، لأن هذه المرجع قد تصبح قديمة.

عائدات
`IDevice`	`IDevice`

getInstalledPackagenames

public  getInstalledPackageNames ()

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

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

رميات
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

إرجاع قيمة عدد صحيح للخاصية المحددة من الجهاز.

حدود
`name`	`String` : اسم الخاصية
`defaultValue`	`long` : القيمة الافتراضية للعودة إذا كانت الخاصية فارغة أو غير موجودة.

عائدات
`long`	قيمة الخاصية أو `defaultValue` إذا كانت الخاصية فارغة ، أو غير موجودة ، أو ليس لها قيمة عدد صحيح.

رميات
`DeviceNotAvailableException`

getipaddress

public String getIpAddress ()

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

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

رميات
`DeviceNotAvailableException`

getKeyGuardState

public KeyguardControllerState getKeyguardState ()

أعد كائن للحصول على الوضع الحالي للحارس الرئيسي أو الفارغ إذا لم يكن مدعومًا.

عائدات
`KeyguardControllerState`	`KeyguardControllerState` يحتوي على لقطة من حالة الحارس الرئيسي وإرجاع NULL إذا لم يتم دعم الاستعلام keyguard.

رميات
`DeviceNotAvailableException`

getLastExpectedRebOottimemillis

public long getLastExpectedRebootTimeMillis ()

إرجاع آخر مرة أدت واجهات برمجة التطبيقات Tradefed Tradefed إلى إعادة تشغيل بالميلي ثانية منذ عصرها كما تم إرجاعها بواسطة System.currentTimeMillis() .

عائدات
`long`

getLaunchapilevel

public int getLaunchApiLevel ()

احصل على أول مستوى API الذي تم إطلاقه للجهاز. الإعدادات الافتراضية إلى UNKNOWN_API_LEVEL .

عائدات
`int`	عدد صحيح يشير إلى أول مستوى API الذي تم إطلاقه من الجهاز

رميات
`DeviceNotAvailableException`

getlogcat

public InputStreamSource getLogcat ()

الاستيلاء على دفق لقطة لبيانات logcat.

يعمل في وضعين:

إذا تم التقاط logcat حاليًا في الخلفية ، فسيعود إلى TestDeviceOptions.getMaxLogcatDataSize() بايت للمحتويات الحالية لالتقاط الخلفية لوجات

خلاف ذلك ، سيقوم بإرجاع تفريغ ثابت لبيانات logcat إذا كان الجهاز يستجيب حاليًا

عائدات
`InputStreamSource`

getlogcat

public InputStreamSource getLogcat (int maxBytes)

يمسك بدد لقطة لآخر maxBytes من بيانات logcat الملتقطة.

مفيد للحالات التي تريد فيها التقاط لقطات متكررة لبيانات logcat التي تم التقاطها دون تكبد عقوبة مساحة القرص الكبيرة المحتملة في الحصول على لقطة getLogcat() بالكامل.

حدود
`maxBytes`	`int` : الحد الأقصى لمقدار البيانات للعودة. يجب أن يكون كمية يمكن أن تتناسب بشكل مريح في الذاكرة

عائدات
`InputStreamSource`

getLogCatdump

public InputStreamSource getLogcatDump ()

احصل على تفريغ لوجاتك الحالية للجهاز. على عكس getLogcat() ، ستعيد هذه الطريقة دائمًا تفريغًا ثابتًا من logcat.

لديه عيب مفاده أنه لن يتم إرجاع أي شيء إذا كان الجهاز غير قابل للوصول.

عائدات
`InputStreamSource`	A `InputStreamSource` من بيانات logcat. يتم إرجاع دفق فارغ إذا فشل في التقاط بيانات logcat.

getLogcatsince

public InputStreamSource getLogcatSince (long date)

الاستيلاء على دفق لقطة لبيانات logcat الملتقطة بدءا من التاريخ المقدم. يجب استخدام الوقت على الجهاز getDeviceDate() .

حدود
`date`	`long` : بالميلي ثانية منذ تنسيق عصر وقت بدء اللقطة حتى الآن. (يمكن الحصول عليها باستخدام "Date +٪ S ')

عائدات
`InputStreamSource`

getMacaddress

public String getMacAddress ()

إرجاع عنوان MAC للجهاز ، NULL إذا فشل في الاستعلام من الجهاز.

عائدات
`String`

getMainuserId

public Integer getMainUserId ()

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

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

رميات
`DeviceNotAvailableException`

getMainlinemoduleInfo

public  getMainlineModuleInfo ()

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

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

رميات
`DeviceNotAvailableException`

getMaxNumberOfRunningussSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

رميات
`DeviceNotAvailableException`

getMaxNumberOfSssupported

public int getMaxNumberOfUsersSupported ()

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

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

رميات
`DeviceNotAvailableException`

GetMicrodrocess

public Process getMicrodroidProcess ()

عائدات
`Process`	إرجاع عملية Microdroid VM. إذا لم يكن TestDevice عبارة عن microdroid ، فإن إرجاع Null.

getMonitor

public IDeviceStateMonitor getMonitor ()

إرجاع IDeviceStateMonitor المرتبطة بالجهاز.

عائدات
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

إرجاع نقطة جبل.

الاستعلامات على الجهاز مباشرة إذا لم تتوفر المعلومات المخزنة مؤقتًا في IDevice .

TODO: انقل هذا السلوك إلى IDevice#getMountPoint(String)

حدود
`mountName`	`String` : اسم جبل بوينت

عائدات
`String`	جبل بوينت أو `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

إرجاع جهاز MountPointInfo المقابل لمسار Mountpoint المحدد ، أو null إذا لم يكن هذا المسار مثبتًا أو لا يظهر في /PROC /Mounts كنقطة تركيب.

حدود
`mountpoint`	`String`

عائدات
`ITestDevice.MountPointInfo`	`ERROR(/List)` من `MountPointInfo` يحتوي على المعلومات في "/proc/mounts"

رميات
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

إرجاع نسخة محسورة من المعلومات في /proc /mounts على الجهاز

عائدات
	`ERROR(/List)` من `MountPointInfo` يحتوي على المعلومات في "/proc/mounts"

رميات
`DeviceNotAvailableException`

etcoptions

public TestDeviceOptions getOptions ()

جلب خيارات الاختبار للجهاز.

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

getPartitionFreespace

public long getPartitionFreeSpace (String partition)

طريقة المساعد لتحديد مقدار المساحة الحرة على قسم الجهاز.

حدود
`partition`	`String`

عائدات
`long`	مقدار المساحة الحرة بالكيبل

رميات
`DeviceNotAvailableException`

getPrimaryuserId

public Integer getPrimaryUserId ()

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

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

رميات
`DeviceNotAvailableException`

getProcessByName

public ProcessInfo getProcessByName (String processName)

تقوم طريقة Helper بتشغيل أمر "pidof" و "STAT" وإرجاع كائن ProcessInfo مع PID ووقت بدء العملية للعملية المحددة.

حدود
`processName`	`String` : سلسلة الأسماء.

عائدات
`ProcessInfo`	ProcessInfo من اسم المعالجة المعطى

رميات
`DeviceNotAvailableException`

getProcesspid

public String getProcessPid (String process)

إرجاع PID من الخدمة أو لاغية إذا حدث خطأ ما.

حدود
`process`	`String` : سلسلة الأسماء.

عائدات
`String`

رميات
`DeviceNotAvailableException`

getProductType

public String getProductType ()

طريقة الراحة للحصول على نوع المنتج لهذا الجهاز.

ستعمل هذه الطريقة إذا كان الجهاز في وضع ADB أو Fastboot.

عائدات
`String`	اسم نوع المنتج `String` . لن يكون فارغا

رميات
`DeviceNotAvailableException`

GetProductVariant

public String getProductVariant ()

طريقة الراحة للحصول على متغير المنتج لهذا الجهاز.

ستعمل هذه الطريقة إذا كان الجهاز في وضع ADB أو Fastboot.

عائدات
`String`	اسم المنتج `String` أو `null` إذا كان لا يمكن تحديده

رميات
`DeviceNotAvailableException`

GetProperty

public String getProperty (String name)

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

حدود
`name`	`String` : اسم الخاصية

عائدات
`String`	قيمة الخاصية أو `null` إذا لم تكن موجودة

رميات
`DeviceNotAvailableException`

GetRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

احصل على وضع الاسترداد الحالي المستخدم للجهاز.

عائدات
`ITestDevice.RecoveryMode`	وضع الاسترداد الحالي المستخدم للجهاز.

getScreenshot

public InputStreamSource getScreenshot (String format)

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

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

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

رميات
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

TODO: تمديد التطبيقات أعلاه لدعم "التنسيق" و "Rescale"

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

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

رميات
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

حدود
`format`	`String` : مدعوم PNG ، JPEG
`rescale`	`boolean` : إذا كان ينبغي إعادة قياس لقطة الشاشة لتقليل حجم الصورة الناتجة

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

رميات
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

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

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

رميات
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

طريقة الراحة للحصول على العدد التسلسلي لهذا الجهاز.

عائدات
`String`	الرقم التسلسلي `String`

getSetting

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

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

حدود
`userId`	`int`
`namespace`	`String`
`key`	`String`

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

رميات
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

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

حدود
`namespace`	`String`
`key`	`String`

عائدات
`String`

رميات
`DeviceNotAvailableException`

getSimoperator

public String getSimOperator ()

إرجاع مشغل بطاقة SIM أو NULL إذا لم يكن متاحًا أو إذا لم يكن الجهاز متاحًا.

عائدات
`String`

getSimstate

public String getSimState ()

إرجاع حالة بطاقة SIM أو NULL إذا لم يكن متاحًا أو غير متوفر.

عائدات
`String`

getTombstones

public  getTombstones ()

جلب وإعادة قائمة شواهد القبور من الأجهزة. يتطلب الجذر.

الطريقة هي أفضل آثار ، لذا إذا فشل أحد شاهد القبور في سحبه لأي سبب من الأسباب ، فستكون مفقودًا من القائمة. فقط DeviceNotAvailableException سوف ينهي الطريقة في وقت مبكر.

عائدات
	قائمة ملفات Tombstone ، فارغة إذا لم يكن هناك قبر.

رميات
`DeviceNotAvailableException`

getTotalmemory

public long getTotalMemory ()

إرجاع حجم الذاكرة الفيزيائية الكلية بالبايت أو -1 في حالة وجود خطأ داخلي

عائدات
`long`

getuninstallablePackagenames

public  getUninstallablePackageNames ()

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

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

رميات
`DeviceNotAvailableException`

getusefastbooterase

public boolean getUseFastbootErase ()

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

عائدات
`boolean`	`true` إذا تم استخدام محو Fastboot أو `false` إذا تم استخدام تنسيق Fastboot.

getUserFlags

public int getUserFlags (int userId)

ابحث وإرجاع أعلام مستخدم معين. يتم تعريف الأعلام في "Android.content.pm.userinfo" في مشروع Android Open Source.

حدود
`userId`	`int`

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

رميات
`DeviceNotAvailableException`

getuserinfos

public  getUserInfos ()

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

عائدات
	قائمة كائنات userInfo.

رميات
`DeviceNotAvailableException`

getUserialNumber

public int getUserSerialNumber (int userId)

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

حدود
`userId`	`int`

عائدات
`int`

رميات
`DeviceNotAvailableException`

handleallocationevent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

معالجة الجهاز المعطى. قد ينتقل إلى الجهاز إلى حالة جديدة. سوف إبلاغ IDeviceMonitor بأي تحولات دولة.

قم بمعالجة الجهاز ، الذي قد ينتقل أو لا ينتقل هذا الجهاز إلى حالة تخصيص جديدة.

حدود
`event`	`DeviceEvent`

عائدات
`IManagedTestDevice.DeviceEventResponse`

hasfeature

public boolean hasFeature (String feature)

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

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

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

رميات
`DeviceNotAvailableException`

ثبت المجموعة

public 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 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`

InstallPackageForuser

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

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

حدود
`packageFile`	`File` : ملف APK للتثبيت
`reinstall`	`boolean` : `true` إذا كان ينبغي إجراء إعادة التثبيت
`userId`	`int` : معرف مستخدم INTEGER للتثبيت ل.
`extraArgs`	`String` : وسيطات إضافية اختيارية لتمريرها. انظر "ADB Shell PM -H" للحصول على الخيارات المتاحة.

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

رميات
`DeviceNotAvailableException`

InstallPackageForuser

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

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

حدود
`packageFile`	`File` : ملف APK للتثبيت
`reinstall`	`boolean` : `true` إذا كان ينبغي إجراء إعادة التثبيت
`grantPermissions`	`boolean` : إذا كان ينبغي منح جميع أذونات وقت التشغيل في وقت التثبيت
`userId`	`int` : معرف مستخدم INTEGER للتثبيت ل.
`extraArgs`	`String` : وسيطات إضافية اختيارية لتمريرها. انظر "ADB Shell PM -H" للحصول على الخيارات المتاحة.

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

رميات
`DeviceNotAvailableException`

PerforaidePropertyCache

public void invalidatePropertyCache ()

isadbroot

public boolean isAdbRoot ()

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

ISADBTCP

public boolean isAdbTcp ()

عائدات
`boolean`

isAppenumerationsuported

public boolean isAppEnumerationSupported ()

تحقق مما إذا كان النظام الأساسي على الجهاز يدعم تعداد التطبيق

عائدات
`boolean`	صحيح إذا تم دعم تعداد التطبيق ، خطأ خلاف ذلك

رميات
`DeviceNotAvailableException`

IsbypasslowtargetSdkblocksupported

public boolean isBypassLowTargetSdkBlockSupported ()

تحقق مما إذا كان النظام الأساسي على الجهاز يدعم تجاوز كتلة SDK المستهدفة المنخفضة على تثبيت التطبيق

عائدات
`boolean`	صحيح إذا تم دعم كتلة SDK LOW الهدف المنخفضة ، فكل خلاف ذلك

رميات
`DeviceNotAvailableException`

isDebugfsmounted

public boolean isDebugfsMounted ()

تحقق مما إذا كان DebuGFs مثبتة.

عائدات
`boolean`	`true` إذا تم تثبيت DebuGFs

رميات
`DeviceNotAvailableException`

isdeviceencrypted

public boolean isDeviceEncrypted ()

إرجاع إذا تم تشفير الجهاز.

عائدات
`boolean`	`true` إذا تم تشفير الجهاز.

رميات
`DeviceNotAvailableException`

isdirectory

public boolean isDirectory (String path)

إرجاع صحيح إذا كان المسار الموجود على الجهاز دليلًا ، خطأ خلاف ذلك.

حدود
`path`	`String`

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

ISENABLEADBROOT

public boolean isEnableAdbRoot ()

عائدات
`boolean`	`true` إذا كان يجب تمكين جذر ADB على الجهاز

isencryptionsupported

public boolean isEncryptionSupported ()

إرجاع إذا تم دعم التشفير على الجهاز.

عائدات
`boolean`	`true` إذا كان الجهاز يدعم التشفير.

رميات
`DeviceNotAvailableException`

isexecutable

public boolean isExecutable (String fullPath)

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

حدود
`fullPath`	`String`

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

istfastbootenabled

public boolean isFastbootEnabled ()

العودة إذا كان Fastboot متاح للجهاز.

عائدات
`boolean`

غيره

public boolean isHeadless ()

إرجاع صحيح إذا كان الجهاز بلا رأس (بدون شاشة) ، خطأ خلاف ذلك.

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

isheadlesssystemusermode

public boolean isHeadlessSystemUserMode ()

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

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

IsmainuserPermanentadmin

public boolean isMainUserPermanentAdmin ()

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

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

ismultiusersuported

public boolean isMultiUserSupported ()

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

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

رميات
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

رميات
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

حدود
`packageName`	`String`

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

رميات
`DeviceNotAvailableException`

isruntimepermissionsuported

public boolean isRuntimePermissionSupported ()

تحقق مما إذا كان النظام الأساسي على الجهاز يدعم منح إذن وقت التشغيل

عائدات
`boolean`	صحيح إذا تم دعم إذن وقت التشغيل ، خطأ خلاف ذلك.

رميات
`DeviceNotAvailableException`

isStateBootloaderOrfastbootd

public boolean isStateBootloaderOrFastbootd ()

إرجاع صحيح إذا كان الجهاز في TestDeviceState#FASTBOOT أو TestDeviceState.FASTBOOTD .

عائدات
`boolean`

isuserrunning

public boolean isUserRunning (int userId)

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

حدود
`userId`	`int`

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

رميات
`DeviceNotAvailableException`

isuSeSecondary

public boolean isUserSecondary (int userId)

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

حدود
`userId`	`int`

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

رميات
`DeviceNotAvailableException`

isUsuservisible

public boolean isUserVisible (int userId)

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

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

حدود
`userId`	`int`

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

isUSERVISIBLEONDISPLAY

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

حدود
`userId`	`int`
`displayId`	`int`

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

isVisibleBackgroundUsersondefaultDisplaySuported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

isvisiblebackgrounduserssuported

public boolean isVisibleBackgroundUsersSupported ()

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

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

Iswifienabled

public boolean isWifiEnabled ()

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

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

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

رميات
`DeviceNotAvailableException`

listdisplayids

public  listDisplayIds ()

جمع قائمة معرف العرض المتاح على الجهاز كما ذكرت "Dumpsys SurfaceFlinger".

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

رميات
`DeviceNotAvailableException`

ListDisplayIDSForStartingVisiblebackers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

عائدات

رميات
`DeviceNotAvailableException`

قائمة

public  listUsers ()

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

عائدات
	قائمة معرفات المستخدم.

رميات
`DeviceNotAvailableException`

لوجان

public boolean logAnrs (ITestLogger logger)

يجمع وتسجيل ANRs من الجهاز.

حدود
`logger`	`ITestLogger` : `ITestLogger` لتسجيل ANRS.

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

رميات
`DeviceNotAvailableException`

logbugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

طريقة المساعد لأخذ bugreport وتسجيله على المراسلين.

حدود
`dataName`	`String` : الاسم الذي سيتم بموجبه الإبلاغ عن bugreport.
`listener`	`ITestLogger` : `ITestLogger` لتسجيل bugreport.

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

logondevice

public void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

تسجيل رسالة في logcat من الجهاز. هذه مكالمة آمنة لن ترمي حتى إذا فشل التسجيل.

حدود
`tag`	`String` : العلامة التي ندرسها رسالتنا في logcat.
`level`	`Log.LogLevel` : مستوى التصحيح للرسالة في logcat.
`format`	`String` : تنسيق الرسالة.
`args`	`Object` : يتم استبدال args عبر string.format ().

Mountdebugfs

public void mountDebugfs ()

جبل debugfs.

رميات
`DeviceNotAvailableException`

NonblockingReboot

public void nonBlockingReboot ()

يصدر أمرًا لإعادة تشغيل الجهاز والإرجاع على الأمر ، وعندما لم يعد الجهاز مرئيًا لـ ADB.

رميات
`DeviceNotAvailableException`

postadbrootaction

public void postAdbRootAction ()

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

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

postadbunrotaction

public void postAdbUnrootAction ()

تجاوز إذا كان الجهاز يحتاج إلى بعض الإجراءات المحددة التي يتعين اتخاذها بعد ADB Unroot وقبل العودة إلى الجهاز عبر الإنترنت. لا يتضمن التنفيذ الافتراضي أي إجراءات إضافية. لا يضمن جذر ADB تعطيله في هذه المرحلة.

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

postbootsetup

public void postBootSetup ()

قم بإجراء تعليمات لتكوين الجهاز لاختبار ذلك بعد كل التمهيد.

يجب أن يتم استدعاؤه بعد أن يتم تشغيل الجهاز بالكامل/متاح

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

حيث قد يلزم استدعاءها هو عندما يعيد تشغيل الجهاز بسبب الأحداث الأخرى (على سبيل المثال عند اكتمال أمر تحديث Fastboot)

رميات
`DeviceNotAvailableException`

postinvocationTeardown

public void postInvocationTearDown (Throwable exception)

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

حدود
`exception`	`Throwable` : إن وجد ، الاستثناء الأخير الذي أثاره فشل الاحتجاج.

preInvocationSetup

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

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

حدود
`info`	`IBuildInfo` : `IBuildInfo` من الجهاز.
`attributes`	`MultiMap` : السمات المخزنة في سياق الاحتجاج

رميات
`DeviceNotAvailableException`
`TargetSetupError`

Pulldir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Recursively pull directory contents from device.

حدود
`deviceFilePath`	`String` : the absolute file path of the remote source
`localDir`	`File` : the local directory to pull files into

عائدات
`boolean`	`true` if file was pulled successfully. `false` خلاف ذلك.

رميات
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

Retrieves a file off device.

حدود
`remoteFilePath`	`String` : the absolute path to file on device.
`localFile`	`File` : the local file to store contents in. If non-empty, contents will be replaced.

عائدات
`boolean`	`true` if file was retrieved successfully. `false` خلاف ذلك.

رميات
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

حدود
`remoteFilePath`	`String` : the absolute path to file on device.
`userId`	`int` : The user id to pull from

عائدات
`File`	A `ERROR(/File)` containing the contents of the device file, or `null` if the copy failed for any reason (including problems with the host filesystem)

رميات
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

حدود
`remoteFilePath`	`String` : the absolute path to file on device.

عائدات
`File`	A `ERROR(/File)` containing the contents of the device file, or `null` if the copy failed for any reason (including problems with the host filesystem)

رميات
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

Retrieves a file off device.

حدود
`remoteFilePath`	`String` : the absolute path to file on device.
`localFile`	`File` : the local file to store contents in. If non-empty, contents will be replaced.
`userId`	`int` : The user id to pull from

عائدات
`boolean`	`true` if file was retrieved successfully. `false` خلاف ذلك.

رميات
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

Retrieves a file off device, and returns the contents.

حدود
`remoteFilePath`	`String` : the absolute path to file on device.

عائدات
`String`	A `String` containing the contents of the device file, or `null` if the copy failed for any reason (including problems with the host filesystem)

رميات
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

حدود
`remoteFilePath`	`String` : the path to file on device, relative to the device's external storage mountpoint

عائدات
`File`	A `ERROR(/File)` containing the contents of the device file, or `null` if the copy failed for any reason (including problems with the host filesystem)

رميات
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

Recursively push directory contents to device while excluding some directories that are filtered.

حدود
`localFileDir`	`File` : the local directory to push
`deviceFilePath`	`String` : the absolute file path of the remote destination
`excludedDirectories`	: Set of excluded directories names that shouldn't be pushed.

عائدات
`boolean`	`true` if file was pushed successfully. `false` خلاف ذلك.

رميات
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Recursively push directory contents to device.

حدود
`localFileDir`	`File` : the local directory to push
`deviceFilePath`	`String` : the absolute file path of the remote destination

عائدات
`boolean`	`true` if file was pushed successfully. `false` خلاف ذلك.

رميات
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

حدود
`localFile`	`File` : the local file to push
`remoteFilePath`	`String` : the remote destination absolute file path
`evaluateContentProviderNeeded`	`boolean` : whether to check if we need the content provider

عائدات
`boolean`	`true` if file was pushed successfully. `false` خلاف ذلك.

رميات
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

Push a file to device. By default using a content provider.

حدود
`localFile`	`File` : the local file to push
`remoteFilePath`	`String` : the remote destination absolute file path

عائدات
`boolean`	`true` if file was pushed successfully. `false` خلاف ذلك.

رميات
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Push file created from a string to device

حدود
`contents`	`String` : the contents of the file to push
`remoteFilePath`	`String` : the remote destination absolute file path

عائدات
`boolean`	`true` if string was pushed successfully. `false` خلاف ذلك.

رميات
`DeviceNotAvailableException`

اعادة التشغيل

public void reboot (String reason)

Reboots the device into adb mode with given reason to be persisted across reboot.

Blocks until device becomes available.

Last reboot reason can be obtained by querying sys.boot.reason propety.

حدود
`reason`	`String` : a reason for this reboot, or `null` if no reason is specified.

رميات
`DeviceNotAvailableException`

اعادة التشغيل

public void reboot ()

Reboots the device into adb mode.

Blocks until device becomes available.

رميات
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

Reboots the device into bootloader mode.

Blocks until device is in bootloader mode.

رميات
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

Reboots the device into fastbootd mode.

Blocks until device is in fastbootd mode.

رميات
`DeviceNotAvailableException`

إعادة التمهيد إلى الانتعاش

public void rebootIntoRecovery ()

Reboots the device into adb recovery mode.

Blocks until device enters recovery

رميات
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

Reboots the device into adb sideload mode (note that this is a special mode under recovery)

Blocks until device enters sideload mode

رميات
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

Reboots the device into adb sideload mode (note that this is a special mode under recovery)

Blocks until device enters sideload mode

حدود
`autoReboot`	`boolean` : whether to automatically reboot the device after sideload

رميات
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

An alternate to reboot() that only blocks until device is online ie visible to adb.

رميات
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

An alternate to reboot() that only blocks until device is online ie visible to adb.

حدود
`reason`	`String` : a reason for this reboot, or `null` if no reason is specified.

رميات
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

Reboots only userspace part of device.

Blocks until device becomes available.

تحذير. Userspace reboot is currently under active development, use it on your own risk.

رميات
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

رميات
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

Attempts to recover device communication.

عائدات
`boolean`	True if recovery attempted and successful, returns False if recovery was skipped

رميات
`DeviceNotAvailableException`	if device is no longer available

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registers a IDeviceActionReceiver for this device.

All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

حدود
`deviceActionReceiver`	`IDeviceActionReceiver` : A `IDeviceActionReceiver` which will be registered.

remountSystemReadOnly

public void remountSystemReadOnly ()

Make the system partition on the device read-only. May reboot the device.

رميات
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

Make the system partition on the device writable. May reboot the device.

رميات
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

Make the vendor partition on the device read-only. May reboot the device.

رميات
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

Make the vendor partition on the device writable. May reboot the device.

رميات
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Remove given device admin in given user and return true if it is successful, false otherwise.

حدود
`componentName`	`String` : of device admin to be removed.
`userId`	`int` : of user that the device admin lives in.

عائدات
`boolean`	True if it is successful, false otherwise.

رميات
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Remove all existing device profile owners with the best effort.

رميات
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Remove a given user from the device.

حدود
`userId`	`int` : of the user to remove

عائدات
`boolean`	true if we were successful in removing the user, false otherwise.

رميات
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

Reset the flag for content provider setup in order to trigger it again.

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                ITestLifeCycleReceiver... listeners)

Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

حدود
`runner`	`IRemoteAndroidTestRunner` : the `IRemoteAndroidTestRunner` which runs the tests
`listeners`	`ITestLifeCycleReceiver` : the test result listener(s)

عائدات
`boolean`	`true` if test command completed. `false` if it failed to complete, but recovery succeeded

رميات
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Runs instrumentation tests, and provides device recovery.

If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

حدود
`runner`	`IRemoteAndroidTestRunner` : the `IRemoteAndroidTestRunner` which runs the tests
`listeners`	: the test result listeners

عائدات
`boolean`	`true` if test command completed. `false` if it failed to complete due to device communication exception, but recovery succeeded

رميات
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                 listeners)

Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

حدود
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

حدود
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Injects the IConfiguration in use.

حدود
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

حدود
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

Sets the date on device

Note: setting date on device requires root

حدود
`date`	`Date` : specify a particular date; will use host date if `null`

رميات
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Set a device admin component as device owner in given user.

حدود
`componentName`	`String` : of device admin to be device owner.
`userId`	`int` : of the user that the device owner lives in.

عائدات
`boolean`	True if it is successful, false otherwise.

رميات
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Update the device's state.

حدود
`deviceState`	`TestDeviceState` : the `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

For emulator set SizeLimitedOutputStream to log output

حدود
`output`	`SizeLimitedOutputStream` : to log the output

setEmulatorProcess

public void setEmulatorProcess (Process p)

Sets the Process , when this device is an emulator.

حدود
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Set the fastboot option for the device. Should be set when device is first allocated.

حدود
`fastbootEnabled`	`boolean` : whether fastboot is available for the device or not

setFastbootPath

public void setFastbootPath (String fastbootPath)

Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled() to be true, to have fastboot functions enabled.

حدود
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Update the IDevice associated with this ITestDevice.

The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDevice

حدود
`newDevice`	`IDevice` : the `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

Sets the time in ms to wait before starting logcat capture for a online device.

حدود
`delay`	`int` : the delay in ms

setOptions

public void setOptions (TestDeviceOptions options)

Set the TestDeviceOptions for the device

حدود
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

Sets the given property value on the device. Requires adb root is true.

حدود
`propKey`	`String` : The key targeted to be set.
`propValue`	`String` : The property value to be set.

عائدات
`boolean`	returns `True` if the setprop command was successful, False otherwise.

رميات
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

حدود
`recovery`	`IDeviceRecovery` : the `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

Set the current recovery mode to use for the device.

Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

حدود
`mode`	`ITestDevice.RecoveryMode` : whether 'recover till online only' mode should be on or not.

setSetting

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

See setSetting(int, String, String, String) and performed on system user.

حدود
`namespace`	`String`
`key`	`String`
`value`	`String`

رميات
`DeviceNotAvailableException`

setSetting

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

Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

حدود
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

رميات
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Injects the ITestLogger instance

حدود
`testLogger`	`ITestLogger`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

حدود
`useFastbootErase`	`boolean` : `true` if fastboot erase should be used or `false` if fastboot format should be used.

startLogcat

public void startLogcat ()

Start capturing logcat output from device in the background.

Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

When the device is no longer in use, stopLogcat() must be called.

startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

startUser

public boolean startUser (int userId)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

حدود
`userId`	`int` : of the user to start in the background

عائدات
`boolean`	true if the user was successfully started in the background.

رميات
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

حدود
`userId`	`int` : of the user to start in the background
`waitFlag`	`boolean` : will make the command wait until user is started and unlocked.

عائدات
`boolean`	true if the user was successfully started in the background.

رميات
`DeviceNotAvailableException`

startVisibleBackgroundUser

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

Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

حدود
`userId`	`int` : of the user to start in the background
`displayId`	`int` : display to start user visible on
`waitFlag`	`boolean` : will make the command wait until user is started and unlocked.

عائدات
`boolean`	`true` if the user was successfully started visible in the background.

رميات
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Close and delete the emulator output.

stopLogcat

public void stopLogcat ()

Stop capturing logcat output from device, and discard currently saved logcat data.

Will have no effect if logcat output is not being captured.

stopUser

public boolean stopUser (int userId)

Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

حدود
`userId`	`int` : of the user to stop.

عائدات
`boolean`	true if the user was successfully stopped.

رميات
`DeviceNotAvailableException`

stopUser

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

Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

حدود
`userId`	`int` : of the user to stop.
`waitFlag`	`boolean` : will make the command wait until user is stopped.
`forceFlag`	`boolean` : will force stop the user.

عائدات
`boolean`	true if the user was successfully stopped.

رميات
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

Switch device to adb-over-tcp mode.

عائدات
`String`	the tcp serial number or `null` if device could not be switched

رميات
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

Switch device to adb over usb mode.

عائدات
`boolean`	`true` if switch was successful, `false` otherwise.

رميات
`DeviceNotAvailableException`

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

public boolean switchUser (int userId)

Switch to another userId with a default timeout. switchUser(int, long) .

حدود
`userId`	`int`

عائدات
`boolean`	True if the new userId matches the userId provider. False otherwise.

رميات
`DeviceNotAvailableException`

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

public boolean switchUser (int userId, 
                long timeout)

Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

حدود
`userId`	`int`
`timeout`	`long` : to wait before returning false for switch-user failed.

عائدات
`boolean`	True if the new userId matches the userId provider. False otherwise.

رميات
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Incrementally syncs the contents of a local file directory to device.

Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

Hidden files (with names starting with ".") will be ignored.

Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

حدود
`localFileDir`	`File` : the local file directory containing files to recursively push.
`deviceFilePath`	`String` : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

عائدات
`boolean`	`true` if files were synced successfully. `false` خلاف ذلك.

رميات
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

عائدات
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

Uninstall an Android package from device.

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

عائدات
`String`	a `String` with an error code, or `null` if success.

رميات
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Uninstall an Android package from device for a given user.

حدود
`packageName`	`String` : the Android package to uninstall
`userId`	`int` : the integer user id to uninstall for.

عائدات
`String`	a `String` with an error code, or `null` if success.

رميات
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

Unlocks the device if the device is in an encrypted state.

This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

عائدات
`boolean`	`true` if successful or if the device is unencrypted.

رميات
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

Unmount debugfs.

رميات
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

Blocks until the device's boot complete flag is set.

حدود
`timeOut`	`long` : time in msecs to wait for the flag to be set

عائدات
`boolean`	true if device's boot complete flag is set within the timeout

رميات
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

Waits for the device to be responsive and available for testing. Uses default timeout.

عائدات
`boolean`	True if device is available, False if recovery is disabled and unavailable.

رميات
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

Waits for the device to be responsive and available for testing.

حدود
`waitTime`	`long` : the time in ms to wait

عائدات
`boolean`	True if device is available, False if recovery is disabled and unavailable.

رميات
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Waits for the device to be responsive and available without considering recovery path.

حدود
`waitTime`	`long`

عائدات
`boolean`	True if device is available, False if unavailable.

رميات
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

Blocks until device is visible via fastboot. Use default timeout.

رميات
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

حدود
`waitTime`	`long` : the time in ms to wait

عائدات
`boolean`	`true` if device boots into recovery before time expires. `false` otherwise

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

Blocks for the device to be in the 'adb sideload' state

حدود
`waitTime`	`long` : the time in ms to wait

عائدات
`boolean`	`true` if device boots into sideload before time expires. `false` otherwise

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

Blocks for the device to be not available ie missing from adb

حدود
`waitTime`	`long` : the time in ms to wait

عائدات
`boolean`	`true` if device becomes not available before time expires. `false` otherwise

waitForDeviceOnline

public void waitForDeviceOnline ()

Blocks until device is visible via adb. Uses default timeout

Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

رميات
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

Blocks until device is visible via adb.

Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

حدود
`waitTime`	`long` : the time in ms to wait

رميات
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

Waits for device to be responsive to a basic adb shell command.

حدود
`waitTime`	`long` : the time in ms to wait

عائدات
`boolean`	`true` if device becomes responsive before `waitTime` elapses.

الأساليب المحمية

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

حدود
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

Builds the OS command for the given adb shell command session and args

حدود
`command`	`String`
`forceExitStatusDetection`	`boolean`

عائدات
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

حدود
`feature`	`String`
`strictMinLevel`	`int`

createRebootDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

Create a RebootDeviceAction to be used when performing a reboot action.

حدود
`rebootMode`	`NativeDevice.RebootMode` : a mode of this reboot.
`reason`	`String` : for this reboot.

عائدات
`NativeDevice.RebootDeviceAction`	the created `RebootDeviceAction` .

createRunUtil

protected IRunUtil createRunUtil ()

عائدات
`IRunUtil`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Perform a adb reboot.

حدود
`rebootMode`	`NativeDevice.RebootMode` : a mode of this reboot.
`reason`	`String` : for this reboot.

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

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

helper method to throw exception if runtime permission isn't supported

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

getApiLevelSafe

protected int getApiLevelSafe ()

عائدات
`int`

getLogger

protected ITestLogger getLogger ()

عائدات
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

Get the RunUtil instance to use.

عائدات
`IRunUtil`

initializeConnection

protected void initializeConnection (IBuildInfo info, 
                MultiMap<String, String> attributes)

حدود
`info`	`IBuildInfo`
`attributes`	`MultiMap`

رميات
`DeviceNotAvailableException`
`TargetSetupError`

internalGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.

حدود
`propName`	`String` : The name of the device property as returned by `adb shell getprop`
`fastbootVar`	`String` : The name of the equivalent fastboot variable to query. if `null` , fastboot query will not be attempted
`description`	`String` : A simple description of the variable. First letter should be capitalized.

عائدات
`String`	A string, possibly `null` or empty, containing the value of the given property

رميات
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.

عائدات
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Return true if local file is newer than remote file. IFileEntry being accurate to the minute, in case of equal times, the file will be considered newer.

حدود
`localFile`	`File`
`entry`	`IFileEntry`

عائدات
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

Notifies all IDeviceActionReceiver about reboot end event.

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

notifyRebootStarted

protected void notifyRebootStarted ()

Notifies all IDeviceActionReceiver about reboot start event.

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

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

Performs an action on this device. Attempts to recover device and optionally retry command if action fails.

حدود
`actionDescription`	`String` : a short description of action to be performed. Used for logging purposes only.
`action`	`NativeDevice.DeviceAction` : the action to be performed
`retryAttempts`	`int` : the retry attempts to make for action if it fails but recovery succeeds

عائدات
`boolean`	`true` if action was performed successfully

رميات
`DeviceNotAvailableException`	if recovery attempt fails or max attempts done without success

postAdbReboot

protected void postAdbReboot ()

Possible extra actions that can be taken after a reboot.

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

prePostBootSetup

protected void prePostBootSetup ()

Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

حدود
`remoteFilePath`	`String`
`localFile`	`File`

عائدات
`boolean`

رميات
`DeviceNotAvailableException`

اضبط الساعة

protected void setClock (Clock clock)

Set the Clock instance to use.

حدود
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Marks the TestDevice as microdroid and sets its CID.

حدود
`process`	`Process` : Process of the Microdroid VM.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

حدود
`deviceOptions`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

Executes a simple fastboot command with environment variables and report the status of the command.

حدود
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

عائدات
`CommandResult`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

Executes a simple fastboot command and report the status of the command.

حدود
`timeout`	`long`
`fullCmd`	`String`

عائدات
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Wait to see the device going unavailable (stop reporting to adb).

حدود
`operationDesc`	`String` : The name of the operation that is waiting for unavailable.
`time`	`long` : The time to wait for unavailable to occur.

عائدات
`boolean`	True if device did become unavailable.

NativeDevice

ملخص

فصول متداخلة

الثوابت

مجالات

المقاولين العامة

الأساليب العامة

الأساليب المحمية

الثوابت

هوية مستخدم غير صالحه

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

مجالات

DEBUGFS_PATH

بطاقة الذاكرة

STORAGE_EMULATED

مخيارات

mStateMonitor

المقاولين العامة

NativeDevice

الأساليب العامة

BatchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

ClearErrorDialogs

ClearLastConnectedWifiNetwork

com.clearLogcat

ConnectToWifiNetwork

ConnectToWifiNetwork

ConnectToWifiNetwork

ConnectToWifiNetwork

ConnectToWifiNetworkIfNeeded

ConnectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

حذف ملف

deregisterDeviceActionReceiver

DeviceSoftRestarted

DeviceSoftRestartedSince

this.disableAdbRoot

dableKeyguard

DisableNetworkMonitor

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

doFileExist

doFileExist

dumpHeap

تمكينAdbRoot

تمكينNetworkMonitor

تنفيذAdbCommand

تنفيذAdbCommand

تنفيذAdbCommand

تنفيذ FastbootCommand

تنفيذ FastbootCommand

تنفيذ LongFastbootCommand

ExecutElongfastbootCommand

التنفيذيين

التنفيذيين

التنفيذيين

التنفيذيين

ExecuteShellV2Command

ExecuteShellV2Command

ExecuteShellV2Command

ExecuteShellV2Command

ExecuteShellV2Command

ExecuteShellV2Command

ExecuteShellV2Command

FastBootWipePartition

getActiveApexes

getAllsettings

getAllocationState

getandroidid

getandroidids

getApilevel

getAppackageInfo

getAppackageInfos

getBaseBandversion

getBattery