اعتبارًا من عام 2026، ولضمان توافقنا مع نموذج التطوير الثابت الرئيسي وضمان استقرار المنصة في المنظومة المتكاملة، سننشر الرمز المصدري في "مشروع Android مفتوح المصدر" (AOSP) في الربع الثاني والربع الرابع. لإنشاء AOSP والمساهمة فيه، ننصحك باستخدام android-latest-release بدلاً من aosp-main. سيشير فرع البيان android-latest-release دائمًا إلى أحدث إصدار تم إرساله إلى AOSP. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في مشروع Android المفتوح المصدر (AOSP).

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

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

TestDevice

TestDevice تنفيذ ITestDevice لجهاز Android كامل الميزات

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

‫LocalAndroidVirtualDevice وManagedRemoteDevice وNestedRemoteDevice وRemoteAndroidDevice وRemoteAndroidVirtualDevice

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

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

ملخّص

الفئات المتداخلة
`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)` لإعادة تشغيل جهاز.

الثوابت
`String`	`DEBUGFS_PATH`
`int`	`INVALID_USER_ID` القيمة المعروضة لأي رقم تعريف مستخدم غير صالح أو غير متوفّر: حدّدت UserHandle القيمة ‎-10000
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` العدد التلقائي لمحاولات إعادة تنفيذ الأمر
`String`	`SD_CARD`
`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()` تعرِض هذه السمة ما إذا كان مسموحًا بالتبديل إلى مستخدم SYSTEM بلا واجهة مستخدم رسومية.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` التحقّق مما إذا كانت إحدى الميزات متاحة حاليًا مع توفّر مستوى الحد الأدنى من التوافق
`boolean`	`checkConnectivity()` تأكَّد من أنّ الجهاز متصل بالشبكة.
`boolean`	`clearErrorDialogs()` محاولة إغلاق أي مربّعات حوار خطأ معروضة حاليًا على واجهة مستخدم الجهاز
`void`	`clearLastConnectedWifiNetwork()` يمحو شبكة Wi-Fi التي تم الاتصال بها آخر مرة.
`void`	`clearLogcat()` لحذف أي بيانات logcat متراكمة
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` الاتصال بشبكة Wi-Fi
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` الاتصال بشبكة Wi-Fi
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` الاتصال بشبكة Wi-Fi
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` الاتصال بشبكة Wi-Fi
`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
`DeviceInspectionResult`	`debugDeviceNotAvailable()` فحص جهاز وعرض معلومات تفصيلية عند تعذُّر الوصول إلى الجهاز
`void`	`deleteFile(String deviceFilePath, int userId)` طريقة مساعدة لحذف ملف أو دليل على الجهاز.
`void`	`deleteFile(String deviceFilePath)` طريقة مساعدة لحذف ملف أو دليل على الجهاز.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` تؤدي هذه الطريقة إلى إزالة `IDeviceActionReceiver` المسجَّلة.
`boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` طريقة مساعدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكل غير كامل من خلال مقارنة system_server الحالي بـ system_server السابق `ProcessInfo`.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` طريقة مساعدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكل غير كامل منذ وقت UTC منذ بداية الحقبة من الجهاز و`ERROR(/TimeUnit)`.
`boolean`	`disableAdbRoot()` يتم إيقاف الوصول إلى الجذر باستخدام أداة adb.
`void`	`disableKeyguard()` محاولات إيقاف قفل الشاشة
`boolean`	`disableNetworkMonitor()` يؤدي ذلك إلى إيقاف مراقبة الشبكة على الجهاز.
`boolean`	`disconnectFromWifi()` قطع الاتصال بشبكة Wi-Fi
`boolean`	`doesFileExist(String deviceFilePath, int userId)` طريقة مساعدة لتحديد ما إذا كان الملف على الجهاز متاحًا لمستخدم معيّن.
`boolean`	`doesFileExist(String deviceFilePath)` طريقة مساعدة لتحديد ما إذا كان الملف متوفّرًا على الجهاز.
`File`	`dumpHeap(String process, String devicePath)` محاولة تفريغ الذاكرة المؤقتة من system_server
`boolean`	`enableAdbRoot()` تفعيل الوصول إلى الجذر عبر adb
`boolean`	`enableNetworkMonitor()` تفعيل ميزة مراقبة الشبكة على الجهاز
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`String`	`executeAdbCommand(String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام.
`CommandResult`	`executeAdbV2Command(String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام.
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`CommandResult`	`executeAdbV2Command(long timeout, envMap, 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)` طريقة مساعدة تنفّذ أمر 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()` استرجاع المعلومات حول حِزم APEX المفعَّلة على الجهاز
`String`	`getAdbPath()` تعرض هذه السمة مسار ملف adb الثنائي المستخدَم.
	`getAllSettings(String namespace)` عرض أزواج المفتاح/القيمة لمساحة الاسم المطلوبة
`DeviceAllocationState`	`getAllocationState()` عرض حالة التخصيص الحالية للجهاز
`String`	`getAndroidId(int userId)` يمكنك العثور على android-id المرتبط بمعرّف المستخدم وإرجاعه، أو إرجاع قيمة فارغة في حال عدم العثور عليه.
	`getAndroidIds()` إنشاء خريطة لمعرّفات Android التي تم العثور عليها مطابقة لمعرّفات المستخدمين
`int`	`getApiLevel()` الحصول على مستوى واجهة برمجة التطبيقات للجهاز
`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()` يسترد هذا الأمر تقرير bugreportz من الجهاز.
`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()` تمثّل هذه السمة حالة الاتصال الحالية المرتبطة بالجهاز.
`ContentProviderHandler`	`getContentProvider(int userId)` تعرِض هذه السمة `ContentProviderHandler` أو قيمة فارغة إذا لم تكن متاحة.
`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()` طريقة سهلة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع Fastboot.
`String`	`getFastbootProductVariant()` طريقة سهلة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع Fastboot.
`String`	`getFastbootSerialNumber()` تعرض هذه السمة الرقم التسلسلي لوضع Fastboot.
`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 عملية إعادة التشغيل بالمللي ثانية منذ بداية الحقبة كما تم عرضها بواسطة `System.currentTimeMillis()`.
`int`	`getLaunchApiLevel()` الحصول على مستوى واجهة برمجة التطبيقات الذي تم إطلاقه أولاً على الجهاز
`InputStreamSource`	`getLogcat()` يحصل على مصدر لقطة لبيانات logcat.
`InputStreamSource`	`getLogcat(int maxBytes)` يحصل على لقطة من آخر `maxBytes` من بيانات logcat التي تم التقاطها.
`InputStreamSource`	`getLogcatDump()` الحصول على تفريغ لـ logcat الحالي للجهاز
`InputStreamSource`	`getLogcatSince(long date)` يحصل هذا الأمر على لقطة من مجموعة بث بيانات logcat التي تم التقاطها بدءًا من التاريخ المقدَّم.
`String`	`getMacAddress()` تعرِض هذه السمة عنوان MAC للجهاز، أو القيمة null إذا تعذّر طلب البحث من الجهاز.
`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` مع معرّف العملية ووقت بدء العملية المحدّدة.
`String`	`getProcessPid(String process)` تعرِض هذه السمة رقم تعريف العملية للخدمة أو القيمة الخالية في حال حدوث خطأ.
`String`	`getProductType()` طريقة سهلة للحصول على نوع منتج هذا الجهاز.
`String`	`getProductVariant()` طريقة سهلة للحصول على خيار المنتج لهذا الجهاز.
`String`	`getProperty(String name)` استرداد قيمة السمة المحدّدة من الجهاز
`ITestDevice.RecoveryMode`	`getRecoveryMode()` الحصول على وضع الاسترداد الحالي المستخدَم للجهاز
`InputStreamSource`	`getScreenshot(long displayId)` تلتقط هذه الطريقة لقطة شاشة من الجهاز الذي تمّ تحديد رقم تعريف العرض له.
`InputStreamSource`	`getScreenshot(String format)` لالتقاط لقطة شاشة من الجهاز
`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 في حال حدوث خطأ داخلي
`String`	`getTrackingSerial()` لأغراض إدارة الجهاز، احصل على الرقم التسلسلي المستخدَم لتتبُّع الجهاز.
	`getUninstallablePackageNames()` استرجاع أسماء حِزم التطبيقات التي يمكن إلغاء تثبيتها
`boolean`	`getUseFastbootErase()` تعرض هذه السمة ما إذا كان يجب استخدام الأمر fastboot erase أو fastboot format لمحو قسم على الجهاز.
`int`	`getUserFlags(int userId)` للعثور على علامات مستخدم معيّن وعرضها
	`getUserInfos()` تعرض هذه السمة خريطة تربط بين useId و`UserInfo` على الجهاز.
`int`	`getUserSerialNumber(int userId)` لعرض الرقم التسلسلي المرتبط بمعرّف المستخدم في حال العثور عليه، أو -10000 في أي حالات أخرى.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` معالجة DeviceEvent المحدّد معالجة DeviceEvent، التي قد تنقل هذا الجهاز أو لا تنقله إلى حالة تخصيص جديدة
`boolean`	`hasFeature(String feature)` التحقّق من توفّر ميزة على جهاز
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)` ابدأ عملية الربط بالجهاز.
`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 على الجهاز لمستخدم معيّن
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` تثبيت حِزم APK باستخدام الوضع التزايدي
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` التحقّق مما إذا كانت المنصة على الجهاز تتيح تعداد التطبيقات
`boolean`	`isBypassLowTargetSdkBlockSupported()` التحقّق ممّا إذا كانت المنصة على الجهاز تتيح تجاوز الحظر المفروض على تثبيت التطبيقات التي تستهدف إصدارًا قديمًا من حزمة تطوير البرامج (SDK)
`boolean`	`isDebugfsMounted()` تحقَّق ممّا إذا كان debugfs مثبّتًا.
`boolean`	`isDeviceEncrypted()` تعرِض هذه الإشارة ما إذا كان الجهاز مشفَّرًا.
`boolean`	`isDirectory(String path)` تعرض هذه السمة القيمة True إذا كان المسار على الجهاز عبارة عن دليل، والقيمة False في الحالات الأخرى.
`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()` اختبار ما إذا كانت شبكة Wi-Fi مفعّلة
	`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)` تسجيل رسالة في logcat للجهاز
`void`	`mountDebugfs()` تثبيت debugfs
`void`	`nonBlockingReboot()` يصدر هذا الأمر لإعادة تشغيل الجهاز، ويعود عند اكتمال الأمر وعندما لا يعود الجهاز مرئيًا لأداة تصحيح الأخطاء عبر Android.
`void`	`postAdbRootAction()` تجاوز إذا كان الجهاز يحتاج إلى اتّخاذ بعض الإجراءات المحدّدة بعد الحصول على إذن الوصول إلى الجذر عبر adb وقبل أن يعود الجهاز إلى الاتصال بالإنترنت.
`void`	`postAdbUnrootAction()` تجاوز إذا كان الجهاز يحتاج إلى اتّخاذ بعض الإجراءات المحدّدة بعد إلغاء الوصول إلى الجذر باستخدام adb وقبل إعادة الجهاز إلى وضع الاتصال بالإنترنت.
`void`	`postBootSetup()` اتّبِع التعليمات لضبط الجهاز على إجراء الاختبار بعد كل عملية إعادة تشغيل.
`void`	`postInvocationTearDown(Throwable exception)` خطوات إضافية لتنظيف البيانات المطلوبة الخاصة بالجهاز سيتم تنفيذها بعد اكتمال عملية الاستدعاء.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` خطوات إضافية لإعدادات الجهاز المطلوبة التي سيتم تنفيذها على الجهاز قبل مسار الاستدعاء
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` سحب محتوى الدليل بشكل متكرّر من الجهاز
`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)` يتم بشكل متكرر نقل محتوى الدليل إلى الجهاز مع استبعاد بعض الأدلة التي تم فلترتها.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` إرسال محتوى الدليل بشكل متكرر إلى الجهاز
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` إرسال محتوى الدليل بشكل متكرر إلى الجهاز
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` صيغة من `pushFile(File, String)` يمكنها اختياريًا مراعاة تقييم الحاجة إلى مقدّم المحتوى.
`boolean`	`pushFile(File localFile, String remoteFilePath)` إرسال ملف إلى الجهاز
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` إرسال ملف إلى الجهاز
`boolean`	`pushString(String contents, String remoteFilePath)` إرسال ملف تم إنشاؤه من سلسلة إلى الجهاز
`void`	`reboot(String reason)` يعيد تشغيل الجهاز في وضع adb مع الاحتفاظ بالقيمة `reason` المحدّدة عند إعادة التشغيل.
`void`	`reboot()` تعيد هذه السياسة تشغيل الجهاز في وضع تصحيح أخطاء Android.
`void`	`rebootIntoBootloader()` تعيد هذه السمة تشغيل الجهاز في وضع برنامج الإقلاع.
`void`	`rebootIntoFastbootd()` تعيد هذه السمة تشغيل الجهاز في وضع fastbootd.
`void`	`rebootIntoRecovery()` يعيد تشغيل الجهاز في وضع الاسترداد adb.
`void`	`rebootIntoSideload()` إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف باستخدام Android Debug Bridge (يُرجى العِلم أنّ هذا الوضع خاص ضمن وضع الاسترداد) يتم الحظر إلى أن يدخل الجهاز في وضع التحميل الجانبي
`void`	`rebootIntoSideload(boolean autoReboot)` إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف باستخدام Android Debug Bridge (يُرجى العِلم أنّ هذا الوضع خاص ضمن وضع الاسترداد) يتم الحظر إلى أن يدخل الجهاز في وضع التحميل الجانبي
`void`	`rebootUntilOnline()` بديل `reboot()` الذي يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android
`void`	`rebootUntilOnline(String reason)` بديل `reboot()` الذي يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android
`void`	`rebootUserspace()` يعيد تشغيل جزء مساحة المستخدم في الجهاز فقط.
`void`	`rebootUserspaceUntilOnline()` بديل `rebootUserspace()` ()} الذي يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android.
`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)` تُجري هذه الخدمة اختبارات الأجهزة وتوفّر إمكانية استرداد البيانات من الأجهزة.
`boolean`	`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`	`setAdbPath(String adbPath)` تضبط هذه السمة المسار إلى ملف adb الثنائي الذي يجب استخدامه.
`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)` اضبط خيار fastboot للجهاز.
`void`	`setFastbootPath(String fastbootPath)` تضبط هذه السمة المسار إلى ملف fastboot الثنائي الذي يجب استخدامه.
`void`	`setIDevice(IDevice newDevice)` عدِّل رقم تعريف الجهاز المرتبط بجهاز الاختبار هذا.
`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`	`setTrackingSerial(String trackingSerial)` لأغراض إدارة الأجهزة، يتم تتبُّع الرقم التسلسلي الذي نستخدمه للإشارة إلى الجهاز.
`void`	`setUseFastbootErase(boolean useFastbootErase)` تحديد ما إذا كان سيتم استخدام fastboot erase أو fastboot format لمحو قسم على الجهاز
`void`	`startLogcat()` ابدأ في تسجيل ناتج logcat من الجهاز في الخلفية.
`boolean`	`startTradeInModeTesting(int timeoutMs)` فعِّل وضع اختبار الاستبدال.
`boolean`	`startUser(int userId)` يبدأ تشغيل مستخدم معيّن في الخلفية إذا كان متوقفًا حاليًا.
`boolean`	`startUser(int userId, boolean waitFlag)` يبدأ تشغيل مستخدم معيّن في الخلفية إذا كان متوقفًا حاليًا.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` يبدأ مستخدمًا معيّنًا في الخلفية، ويكون مرئيًا في الشاشة المحدّدة (أي يسمح للمستخدم بتشغيل الأنشطة في تلك الشاشة).
`void`	`stopEmulatorOutput()` أغلِق ناتج المحاكي واحذفه.
`void`	`stopLogcat()` إيقاف تسجيل ناتج logcat من الجهاز وتجاهل بيانات logcat المحفوظة حاليًا
`void`	`stopTradeInModeTesting()` إيقاف اختبار وضع إعادة البيع
`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)` التبديل إلى userId آخر مع مهلة تلقائية
`boolean`	`switchUser(int userId, long timeout)` بدِّل إلى userId آخر مع المهلة المقدَّمة كموعد نهائي.
`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()` إلغاء تثبيت debugfs
`boolean`	`waitForBootComplete(long timeOut)` يتم الحظر إلى أن يتم ضبط علامة اكتمال عملية تمهيد الجهاز.
`boolean`	`waitForDeviceAvailable()` تنتظر هذه الحالة إلى أن يصبح الجهاز متجاوبًا ومتاحًا للاختبار.
`boolean`	`waitForDeviceAvailable(long waitTime)` تنتظر هذه الحالة إلى أن يصبح الجهاز متجاوبًا ومتاحًا للاختبار.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` ينتظر أن يصبح الجهاز متجاوبًا ومتاحًا بدون أخذ مسار الاسترداد في الاعتبار.
`void`	`waitForDeviceBootloader()` يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال Fastboot.
`void`	`waitForDeviceFastbootD()`
`boolean`	`waitForDeviceInRecovery(long waitTime)` يمنع الجهاز من أن يكون في حالة "استرداد adb" (يُرجى العِلم أنّ هذه الحالة تختلف عن `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` حظر الجهاز من أن يكون في حالة "التحميل الجانبي عبر adb"
`boolean`	`waitForDeviceNotAvailable(long waitTime)` حظر عدم توفّر الجهاز، أي عدم ظهوره في adb
`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)` نفِّذ عملية إعادة التشغيل عبر adb.
`void`	`ensureRuntimePermissionSupported()` طريقة مساعدة لعرض استثناء في حال عدم توفّر إذن التشغيل
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` احصل على مثيل `RunUtil` لاستخدامه.
`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(NativeDevice.RebootMode rebootMode)` الإجراءات الإضافية المحتملة التي يمكن اتّخاذها بعد إعادة التشغيل
`void`	`prePostBootSetup()` تسمح لكل نوع جهاز (AndroidNativeDevice وTestDevice) بتجاوز هذه الطريقة لإعدادات محدّدة بعد التشغيل.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` اضبط مثيل Clock المطلوب استخدامه.
`void`	`setMicrodroidProcess(Process process)` تضع علامة على TestDevice باعتباره microdroid وتضبط معرّف CID الخاص به.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` تنفيذ أمر fastboot بسيط باستخدام متغيرات البيئة والإبلاغ عن حالة الأمر
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` ينفّذ أمر fastboot بسيطًا ويبلغ عن حالة الأمر.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` انتظِر إلى أن يصبح الجهاز غير متاح (توقّف عن إرسال التقارير إلى adb).

الثوابت

DEBUGFS_PATH

public static final String DEBUGFS_PATH

Constant Value: "/sys/kernel/debug"

INVALID_USER_ID

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

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

Constant Value: 2 (0x00000002)

SD_CARD

protected static final String SD_CARD

القيمة الثابتة: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Constant Value: "/storage/emulated/"

الحقول

mOptions

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 لكل سمة، أي أنّ جلب جميع السمات يتم بالسرعة نفسها التي يتم بها جلب سمة واحدة. تستدعي جميع الدوال البرمجية، مثل device.getApiLevel()‎ وcheckApiLevelAgainstNextRelease وgetBuildAlias، الأمر `adb getprop` في الخلفية. نسترجعها في طلب واحد وننفّذ NativeDevice.setProperty. حتى إذا لم نفعل ذلك، ستطلب NativeDevice بنفسها تنفيذ setProperty وتخزين النتيجة مؤقتًا لاستخدامها في الطلبات المستقبلية. سنبدأ في تطبيقها قبل الموعد المحدد بقليل. إذا كان الجهاز في وضع الاسترداد أو حدثت أخطاء أخرى أثناء جلب الخصائص، سنتجاهلها.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

تعرِض هذه السمة ما إذا كان مسموحًا بالتبديل إلى مستخدم SYSTEM بلا واجهة مستخدم رسومية.

المرتجعات
`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 ()

يمحو شبكة Wi-Fi التي تم الاتصال بها آخر مرة. يجب استدعاء هذا الإجراء عند بدء عملية استدعاء جديدة لتجنُّب الاتصال بشبكة Wi-Fi المستخدَمة في الاختبار السابق بعد إعادة تشغيل الجهاز.

clearLogcat

public void clearLogcat ()

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

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

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

الاتصال بشبكة Wi-Fi

يتم تفعيل شبكة Wi-Fi والحظر إلى أن يتم الاتصال بنجاح بإحدى شبكات Wi-Fi المحدّدة في خريطة wifiSsidToPsk. بعد إنشاء اتصال، ستحاول الآلة الافتراضية استعادة الاتصال بعد كل إعادة تشغيل إلى أن يتم استدعاء ITestDevice.disconnectFromWifi() أو ITestDevice.clearLastConnectedWifiNetwork().

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

المرتجعات
`boolean`	‫`true` في حال الاتصال بشبكة Wi-Fi بنجاح `false` غير ذلك

الرميات
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

الاتصال بشبكة Wi-Fi

يتم تفعيل شبكة Wi-Fi والحظر إلى أن يتم إنشاء اتصال ناجح بشبكة Wi-Fi المحدّدة. بعد إنشاء اتصال، ستحاول الآلة الافتراضية استعادة الاتصال بعد كل عملية إعادة تشغيل إلى أن يتم استدعاء ITestDevice.disconnectFromWifi() أو ITestDevice.clearLastConnectedWifiNetwork().

المعلمات
`wifiSsid`	`String`: معرّف SSID لشبكة Wi-Fi المطلوب الاتصال بها
`wifiPsk`	‫`String`: عبارة مرور PSK أو قيمة فارغة إذا لم يكن مشفّرًا

المرتجعات
`boolean`	‫`true` في حال الاتصال بشبكة Wi-Fi بنجاح `false` غير ذلك

الرميات
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

الاتصال بشبكة Wi-Fi

يتم تفعيل شبكة Wi-Fi والحظر إلى أن يتم الاتصال بنجاح بإحدى شبكات Wi-Fi المحدّدة في خريطة wifiSsidToPsk. بعد إنشاء اتصال، ستحاول الآلة الافتراضية استعادة الاتصال بعد كل عملية إعادة تشغيل إلى أن يتم استدعاء ITestDevice.disconnectFromWifi() أو ITestDevice.clearLastConnectedWifiNetwork().

المعلمات
`wifiSsidToPsk`	‫: خريطة لمعرّفات SSID لشبكات Wi-Fi وكلمات المرور

المرتجعات
`boolean`	‫`true` في حال الاتصال بشبكة Wi-Fi بنجاح `false` غير ذلك

الرميات
`DeviceNotAvailableException`

connectToWifiNetwork

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

الاتصال بشبكة Wi-Fi

المعلمات
`wifiSsid`	`String`: معرّف SSID لشبكة Wi-Fi المطلوب الاتصال بها
`wifiPsk`	‫`String`: عبارة مرور PSK أو قيمة فارغة إذا لم يكن مشفّرًا
`scanSsid`	‫`boolean`: لتحديد ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة.

المرتجعات
`boolean`	‫`true` في حال الاتصال بشبكة Wi-Fi بنجاح `false` غير ذلك

الرميات
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

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

إصدار من connectToWifiNetwork(String, String) لا يتصل إلا إذا كان الجهاز غير متصل بشبكة حاليًا.

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

المرتجعات
`boolean`	‫`true` في حال الاتصال بشبكة Wi-Fi بنجاح `false` غير ذلك

الرميات
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

إصدار من connectToWifiNetwork(String, String) لا يتصل إلا إذا كان الجهاز غير متصل بشبكة حاليًا.

المرتجعات
`boolean`	‫`true` في حال الاتصال بشبكة Wi-Fi بنجاح `false` غير ذلك

الرميات
`DeviceNotAvailableException`

createUser

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

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

المعلمات
`name`	‫`String`: هو اسم المستخدم الذي سيتم إنشاؤه على الجهاز
`guest`	`boolean`: تفعيل علامة المستخدم --guest أثناء الإنشاء
`ephemeral`	‫`boolean`: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء

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

الرميات
`DeviceNotAvailableException`

createUser

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

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

المعلمات
`name`	‫`String`: هو اسم المستخدم الذي سيتم إنشاؤه على الجهاز
`guest`	`boolean`: تفعيل علامة المستخدم --guest أثناء الإنشاء
`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`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

فحص جهاز وعرض معلومات تفصيلية عند تعذُّر الوصول إلى الجهاز

المرتجعات
`DeviceInspectionResult`

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

الرميات
`DeviceNotAvailableException`

deleteFile

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 الحالي بـ system_server السابق ProcessInfo. استخدِم getProcessByName(String) للحصول على ProcessInfo.

المعلمات
`prevSystemServerProcess`	‫`ProcessInfo`: عملية system_server السابقة `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`

disableAdbRoot

public boolean disableAdbRoot ()

يتم إيقاف الوصول إلى الجذر باستخدام أداة adb.

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

المرتجعات
`boolean`	‫`true` في حال النجاح

الرميات
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

محاولات إيقاف قفل الشاشة

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

الرميات
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

يؤدي ذلك إلى إيقاف مراقبة الشبكة على الجهاز.

المرتجعات
`boolean`	‫`true` إذا تم إيقاف ميزة التتبُّع بنجاح `false` في حال تعذّر ذلك.

الرميات
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

قطع الاتصال بشبكة Wi-Fi

يزيل هذا الإجراء جميع الشبكات من قائمة الشبكات المعروفة ويوقف شبكة Wi-Fi.

المرتجعات
`boolean`	‫`true` في حال قطع الاتصال بشبكة Wi-Fi بنجاح `false` في حال تعذّر إلغاء الربط.

الرميات
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

المرتجعات
`boolean`	`true` إذا كان الملف متوفّرًا، `false` في الحالات الأخرى

الرميات
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

المعلمات
`deviceFilePath`	‫`String`: المسار المطلق للملف على الجهاز المطلوب التحقّق منه

المرتجعات
`boolean`	`true` إذا كان الملف متوفّرًا، `false` في الحالات الأخرى

الرميات
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

المرتجعات
`File`	`ERROR(/File)` الذي يحتوي على التقرير قيمة فارغة في حال حدوث خطأ

الرميات
`DeviceNotAvailableException`

enableAdbRoot

public boolean enableAdbRoot ()

تفعيل الوصول إلى الجذر عبر adb إذا كان الإعداد "enable-root" مضبوطًا على "false"، سيتم تسجيل رسالة وسيتم الرجوع بدون تفعيل الوصول إلى الجذر.

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

المرتجعات
`boolean`	‫`true` في حال النجاح

الرميات
`DeviceNotAvailableException`

enableNetworkMonitor

public boolean enableNetworkMonitor ()

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

المرتجعات
`boolean`	‫`true` إذا تم تفعيل ميزة التتبُّع بنجاح `false` في حال تعذّر ذلك.

الرميات
`DeviceNotAvailableException`

executeAdbCommand

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

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

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

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

المرتجعات
`String`	الناتج القياسي من الأمر ‫`null` إذا تعذّر تنفيذ الأمر

الرميات
`DeviceNotAvailableException`

executeAdbCommand

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

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

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

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

المرتجعات
`String`	الناتج القياسي من الأمر ‫`null` إذا تعذّر تنفيذ الأمر

الرميات
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

المعلمات
`cmdArgs`	`String`: أمر adb والوسيطات المطلوب تنفيذها

المرتجعات
`String`	الناتج القياسي من الأمر ‫`null` إذا تعذّر تنفيذ الأمر

الرميات
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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

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

المعلمات
`cmdArgs`	`String`: أمر adb والوسيطات المطلوب تنفيذها

المرتجعات
`CommandResult`	‫CommandResult الذي يحتوي على ناتج الأمر

الرميات
`DeviceNotAvailableException`

executeAdbV2Command

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

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

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

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

المرتجعات
`CommandResult`	‫CommandResult الذي يحتوي على ناتج الأمر

الرميات
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... cmdArgs)

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

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

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

المرتجعات
`CommandResult`	‫CommandResult الذي يحتوي على ناتج الأمر

الرميات
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

طريقة مساعدة تنفّذ أمر fastboot كأمر نظام بمهلة تلقائية تبلغ دقيقتَين.

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

المعلمات
`cmdArgs`	‫`String`: أمر fastboot والوسيطات المطلوب تنفيذها

المرتجعات
`CommandResult`	‫CommandResult الذي يحتوي على ناتج الأمر

الرميات
`DeviceNotAvailableException`

executeFastbootCommand

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

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

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

المعلمات
`timeout`	‫`long`: الوقت بالملّي ثانية قبل انتهاء صلاحية الأمر
`cmdArgs`	‫`String`: أمر fastboot والوسيطات المطلوب تنفيذها

المرتجعات
`CommandResult`	‫CommandResult الذي يحتوي على ناتج الأمر

الرميات
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

مطابقة executeFastbootCommand(String)، ولكنها تستخدم مهلة أطول.

المعلمات
`cmdArgs`	‫`String`: أمر fastboot والوسيطات المطلوب تنفيذها

المرتجعات
`CommandResult`	‫CommandResult الذي يحتوي على ناتج الأمر

الرميات
`DeviceNotAvailableException`

executeLongFastbootCommand

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

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

مطابقة executeFastbootCommand(String)، ولكنها تستخدم مهلة أطول.

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

المرتجعات
`CommandResult`	‫CommandResult الذي يحتوي على ناتج الأمر

الرميات
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

طريقة مساعدة تنفّذ أمر adb shell وتعرض الناتج على شكل String.

المعلمات
`command`	‫`String`: أمر adb shell المطلوب تنفيذه

المرتجعات
`String`	ناتج الصدفة

الرميات
`DeviceNotAvailableException`

executeShellCommand

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

ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.

المعلمات
`command`	‫`String`: أمر adb shell المطلوب تنفيذه
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` لتوجيه ناتج الصدفة المباشر إليه.
`maxTimeToOutputShellResponse`	‫`long`: الحد الأقصى للمدة الزمنية التي يُسمح فيها للأمر بعدم عرض أي استجابة، ويتم تحديد الوحدة كما هو موضّح في `timeUnit`
`timeUnit`	`TimeUnit`: وحدة `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: الحد الأقصى لعدد محاولات إعادة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب حدوث استثناء. سيتم عرض DeviceNotResponsiveException إذا تم تنفيذ `retryAttempts` بدون نجاح.

الرميات
`DeviceNotAvailableException`

executeShellCommand

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

ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.

المعلمات
`command`	‫`String`: أمر adb shell المطلوب تنفيذه
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` لتوجيه ناتج الصدفة المباشر إليه.
`maxTimeoutForCommand`	`long`: الحد الأقصى لمهلة اكتمال الأمر، ويتم تحديد الوحدة كما هو موضّح في `timeUnit`
`maxTimeToOutputShellResponse`	‫`long`: الحد الأقصى للمدة الزمنية التي يُسمح فيها للأمر بعدم عرض أي استجابة، ويتم تحديد الوحدة كما هو موضّح في `timeUnit`
`timeUnit`	`TimeUnit`: وحدة `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: الحد الأقصى لعدد المرات التي يمكن فيها إعادة محاولة تنفيذ الأمر إذا تعذّر تنفيذه بسبب حدوث استثناء. سيتم عرض DeviceNotResponsiveException إذا تم تنفيذ `retryAttempts` بدون نجاح.

الرميات
`DeviceNotAvailableException`

executeShellCommand

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` لتوجيه ناتج الصدفة المباشر إليه.

الرميات
`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)` حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة null.

المرتجعات
`CommandResult`	النتيجة باللغة `CommandResult`

الرميات
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

طريقة مساعِدة تنفّذ أمر adb shell وتعرض النتائج على شكل CommandResult يتم ملؤه بشكل صحيح بناتج حالة الأمر وstdout وstderr.

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

المرتجعات
`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)` سيتم نقله كإدخال إلى الأمر، أو قيمة فارغة.
`pipeToOutput`	‫`OutputStream`: `ERROR(/OutputStream)` حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة 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)` سيتم نقله كإدخال إلى الأمر، أو قيمة فارغة.
`pipeToOutput`	‫`OutputStream`: `ERROR(/OutputStream)` حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة null.
`pipeToError`	‫`OutputStream`: `ERROR(/OutputStream)` حيث سيتم إعادة توجيه الخطأ المعياري، أو لا شيء.
`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 ()

استرجاع المعلومات حول حِزم APEX المفعَّلة على الجهاز

المرتجعات
	`ERROR(/Set)` من إجمالي `ApexInfo` تم تفعيله حاليًا على الجهاز

الرميات
`DeviceNotAvailableException`

getAdbPath

public String getAdbPath ()

تعرض هذه السمة مسار ملف adb الثنائي المستخدَم.

المرتجعات
`String`

getAllSettings

public  getAllSettings (String namespace)

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

المعلمات
`namespace`	‫`String`: يجب أن تكون إحدى القيم التالية: {"system", "secure", "global"}

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

الرميات
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

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

المرتجعات
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

يمكنك العثور على android-id المرتبط بمعرّف المستخدم وإرجاعه، أو إرجاع قيمة فارغة في حال عدم العثور عليه.

المعلمات
`userId`	`int`

المرتجعات
`String`

الرميات
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

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

المرتجعات
	خريطة لأرقام تعريف Android التي تم العثور عليها مطابقة لأرقام تعريف المستخدمين

الرميات
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

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

المرتجعات
`int`	عدد صحيح يشير إلى مستوى واجهة برمجة التطبيقات للجهاز

الرميات
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

استرداد معلومات حول حزمة مثبَّتة على الجهاز

المعلمات
`packageName`	`String`

المرتجعات
`PackageInfo`	`PackageInfo` أو `null` في حال تعذّر استرداد المعلومات

الرميات
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

استرداد معلومات الحِزم المثبَّتة على الجهاز

المرتجعات
	`ERROR(/List)` من حِزم `PackageInfo` المثبَّتة على الجهاز

الرميات
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

طريقة سهلة للحصول على إصدار النطاق الأساسي (الراديو) لهذا الجهاز. يختلف الحصول على إصدار الراديو من جهاز إلى آخر، لذا قد لا يعرض المعلومات الصحيحة لجميع الأجهزة. تعتمد هذه الطريقة على السمة gsm.version.baseband لعرض معلومات الإصدار الصحيحة. لا يكون هذا الإجراء دقيقًا بالنسبة إلى بعض أجهزة CDMA، وقد لا يتطابق الإصدار المعروض هنا مع الإصدار الذي يتم عرضه من خلال fastboot، وقد لا يعرض الإصدار الخاص براديو CDMA. باختصار، لا تعرض هذه الطريقة الإصدار الدقيق إلا إذا كانت قيمة السمة gsm.version.baseband هي نفسها قيمة الإصدار الذي تعرضه fastboot getvar version-baseband.

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

الرميات
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

تعرِض هذه السمة مستوى شحن البطارية الحالي للجهاز أو القيمة Null إذا كان مستوى شحن البطارية غير متاح.

المرتجعات
`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 ()

تجمع طريقة المساعدة خريطة سجلّ بدء التشغيل مع وقت بدء التشغيل وسببه.

المرتجعات
	خريطة لوقت بدء التشغيل (بالتوقيت العالمي المنسّق بالثواني منذ بدء حساب الفترة) وسبب بدء التشغيل

الرميات
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

تجمع طريقة المساعدة خريطة سجلّ بدء التشغيل مع وقت بدء التشغيل وسبب بدء التشغيل منذ الوقت المحدّد منذ بداية الحقبة من الجهاز ووحدة الوقت المحدّدة. يمكن الحصول على utcEpochTime الحالي للجهاز بالمللي ثانية باستخدام الطريقة getDeviceDate().

المعلمات
`utcEpochTime`	‫`long`: وقت الجهاز منذ بدء حساب الفترة.
`timeUnit`	`TimeUnit`: الوحدة الزمنية `TimeUnit`

المرتجعات
	خريطة لوقت بدء التشغيل (بالتوقيت العالمي المنسّق بالثواني منذ بدء حساب الفترة) وسبب بدء التشغيل

الرميات
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

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

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

المرتجعات
`String`	`String` إصدار برنامج الإقلاع أو `null` إذا تعذّر العثور عليه

الرميات
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

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

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

المرتجعات
`InputStreamSource`	`InputStreamSource` التي ستنتج محتوى تقرير الأخطاء عند الطلب في حال حدوث خطأ، ستنتج `InputStreamSource` قيمة `ERROR(/InputStream)` فارغة.

getBugreportz

public InputStreamSource getBugreportz ()

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

لا يتوافق إلا مع الإصدار "adb version" الأحدث من 1.0.36

المرتجعات
`InputStreamSource`	`InputStreamSource` لملف zip الذي يحتوي على bugreportz، أو قيمة فارغة في حال حدوث خطأ.

getBuildAlias

public String getBuildAlias ()

استرداد الاسم المستعار للإصدار الذي يعمل عليه الجهاز حاليًا

عادةً ما يكون الاسم المستعار للإصدار سلسلة أكثر قابلية للقراءة من رقم تعريف الإصدار (عادةً ما يكون رقمًا لإصدارات 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`

getChildren

public String[] getChildren (String path)

بديل لاستخدام IFileEntry قد لا يعمل أحيانًا بسبب الأذونات

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

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

الرميات
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

تمثّل هذه السمة حالة الاتصال الحالية المرتبطة بالجهاز.

المرتجعات
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

تعرِض هذه السمة ContentProviderHandler أو قيمة فارغة إذا لم تكن متاحة.

يمكن إعادة استخدام موفّر المحتوى إذا تم إنشاؤه من قبل باستخدام userId نفسه.

المعلمات
`userId`	‫`int`: رقم تعريف المستخدم الذي سيتم استخدامه لتهيئة موفّر المحتوى.

المرتجعات
`ContentProviderHandler`

الرميات
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

المرتجعات
`DeviceFoldableState`

الرميات
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

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

المرتجعات
`int`

الرميات
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

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

المرتجعات
`String`	فئة الجهاز `String`

getDeviceDate

public long getDeviceDate ()

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

المرتجعات
`long`	تاريخ الجهاز بتنسيق epoch

الرميات
`DeviceNotAvailableException`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

المرتجعات
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

يمكنك عرض 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" و "system" متوافق).

المرتجعات
`IFileEntry`	`IFileEntry` أو `null` إذا تعذّر العثور على الملف في `path` المحدّد

الرميات
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

أداة مساعدة غير رسمية للحصول على FileEntry من مسار غير أساسي FIXME: إعادة تصميم نظام FileEntry ليكون متاحًا من أي مسار. (حتى غير الجذر).

المعلمات
`entry`	‫`FileListingService.FileEntry`: `FileEntry` ليس بالضرورة أن يكون الجذر كما تتطلّبه Ddmlib.

المرتجعات
`IFileEntry`	a FileEntryWrapper representing the FileEntry.

الرميات
	com.android.tradefed.device.DeviceNotAvailableException
`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 إذا كان طلب البحث عن شاشة القفل غير متاح.

الرميات
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

المرتجعات
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

الحصول على مستوى واجهة برمجة التطبيقات الذي تم إطلاقه أولاً على الجهاز القيمة التلقائية هي UNKNOWN_API_LEVEL.

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

الرميات
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

يحصل على مصدر لقطة لبيانات logcat.

تعمل هذه الميزة في وضعَين:

إذا كان يتم حاليًا تسجيل logcat في الخلفية، سيتم عرض ما يصل إلى TestDeviceOptions.getMaxLogcatDataSize() بايت من المحتوى الحالي لعملية تسجيل logcat في الخلفية

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

المرتجعات
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

يحصل على لقطة من آخر maxBytes من بيانات logcat التي تم التقاطها.

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

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

المرتجعات
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

من عيوب هذه الطريقة أنّه لن يتم عرض أي نتائج إذا تعذّر الوصول إلى الجهاز.

المرتجعات
`InputStreamSource`	`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)` من وحدات APEX الرئيسية المثبَّتة حاليًا على الجهاز`String`

الرميات
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

الحصول على الحد الأقصى لعدد المستخدمين الذين يمكنهم تشغيل التطبيق في الوقت نفسه القيمة التلقائية هي 0.

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

الرميات
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

الحصول على الحد الأقصى لعدد المستخدمين المسموح بهم القيمة التلقائية هي 0.

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

الرميات
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

المرتجعات
`Process`	تعرض هذه السمة عملية جهاز Microdroid الافتراضي. إذا لم يكن TestDevice جهاز Microdroid، يتم عرض قيمة فارغة.

getMonitor

public IDeviceStateMonitor getMonitor ()

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

المرتجعات
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

تعرِض هذه السمة نقطة تثبيت.

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

TODO: move this behavior to IDevice.getMountPoint(String)

المعلمات
`mountName`	`String`: اسم نقطة التثبيت

المرتجعات
`String`	نقطة التثبيت أو `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

تعرض هذه الدالة MountPointInfo يتوافق مع مسار نقطة التثبيت المحدّد، أو null إذا لم يكن هناك أي شيء مثبّت في هذا المسار أو إذا لم يظهر في /proc/mounts كنقطة تثبيت.

المعلمات
`mountpoint`	`String`

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

الرميات
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

تعرض هذه السمة نسخة محلَّلة من المعلومات الواردة في /proc/mounts على الجهاز

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

الرميات
`DeviceNotAvailableException`

getOptions

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)

ينفّذ الإجراء المساعد الأمرَين "pidof" و "stat" ويعرض العنصر ProcessInfo مع معرّف العملية ووقت بدء العملية المحدّدة.

المعلمات
`processName`	‫`String`: سلسلة اسم العملية

المرتجعات
`ProcessInfo`	ProcessInfo of given processName

الرميات
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

تعرِض هذه السمة رقم تعريف العملية للخدمة أو القيمة الخالية في حال حدوث خطأ.

المعلمات
`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 (long displayId)

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

TODO: extend the implementations above to support 'format' and 'rescale'

المعلمات
`displayId`	`long`: المعرّف المعروض للشاشة التي سيتم أخذ لقطة شاشة منها

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

الرميات
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

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

المعلمات
`format`	`String`: PNG وJPEG

المرتجعات
`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 أو قيمة فارغة إذا لم يكن متاحًا أو إذا لم يكن الجهاز متاحًا

المرتجعات
`String`

getSimState

public String getSimState ()

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

المرتجعات
`String`

getTombstones

public  getTombstones ()

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

الطريقة هي الأفضل، لذا إذا تعذّر سحب علامة حذف لأي سبب، ستكون مفقودة من القائمة. لن يؤدي إلى إنهاء الطريقة مبكرًا سوى DeviceNotAvailableException.

المرتجعات
	قائمة بملفات علامات الحذف، وتكون فارغة إذا لم تكن هناك علامات حذف.

الرميات
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

تعرض هذه السمة إجمالي حجم الذاكرة الفعلية بالبايت أو القيمة -1 في حال حدوث خطأ داخلي

المرتجعات
`long`

getTrackingSerial

public String getTrackingSerial ()

لأغراض إدارة الجهاز، احصل على الرقم التسلسلي المستخدَم لتتبُّع الجهاز.

المرتجعات
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

المرتجعات
	تمثّل هذه السمة `ERROR(/Set)` أسماء حِزم `String` غير قابلة للإزالة ومثبَّتة حاليًا على الجهاز.

الرميات
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

تعرض هذه السمة ما إذا كان يجب استخدام الأمر fastboot erase أو fastboot format لمحو قسم على الجهاز.

المرتجعات
`boolean`	`true` إذا كان سيتم استخدام fastboot erase أو `false` إذا كان سيتم استخدام fastboot format.

getUserFlags

public int getUserFlags (int userId)

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

المعلمات
`userId`	`int`

المرتجعات
`int`	الأعلام المرتبطة برقم تعريف المستخدم المقدَّم في حال العثور عليه، أو -10000 في أي حالات أخرى

الرميات
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

تعرض هذه السمة خريطة تربط بين useId وUserInfo على الجهاز. سيتم عرض الخطأ DeviceRuntimeException إذا لم تكن النتائج من الجهاز على النحو المتوقّع.

المرتجعات
	قائمة عناصر UserInfo

الرميات
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

لعرض الرقم التسلسلي المرتبط بمعرّف المستخدم في حال العثور عليه، أو -10000 في أي حالات أخرى.

المعلمات
`userId`	`int`

المرتجعات
`int`

الرميات
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

المعلمات
`event`	`DeviceEvent`

المرتجعات
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

التحقّق من توفّر ميزة على جهاز

المعلمات
`feature`	‫`String`: يجب أن يكون التنسيق "feature:" أو "" مباشرةً.

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

الرميات
`DeviceNotAvailableException`

initializeConnection

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

ابدأ عملية الربط بالجهاز. يتم استدعاء هذه الطريقة من خلال preInvocationSetup، ولكن في حالات نادرة، قد يلزم استدعاؤها بشكل منفصل عند إنشاء الاتصال أثناء إعداد الجهاز.

المعلمات
`info`	`IBuildInfo`
`attributes`	`MultiMap`

الرميات
`DeviceNotAvailableException`
`TargetSetupError`

installPackage

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`

installPackage

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`: هو رقم تعريف المستخدم الصحيح الذي سيتم التثبيت له.
`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`: هو رقم تعريف المستخدم الصحيح الذي سيتم التثبيت له.
`extraArgs`	`String`: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.

المرتجعات
`String`	`String` مع رمز خطأ، أو `null` في حال النجاح

الرميات
`DeviceNotAvailableException`

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

تثبيت حِزم APK باستخدام الوضع التزايدي

المعلمات
`apkFiles`	استبدِل `File` بملفات APK المطلوب تثبيتها.
`extraArgs`	`String`
`userId`	`String`

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

المرتجعات
`boolean`

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

التحقّق مما إذا كانت المنصة على الجهاز تتيح تعداد التطبيقات

المرتجعات
`boolean`	صحيح إذا كان تعداد التطبيقات متاحًا، وخطأ في الحالات الأخرى

الرميات
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

التحقّق ممّا إذا كانت المنصة على الجهاز تتيح تجاوز الحظر المفروض على تثبيت التطبيقات التي تستهدف إصدارًا قديمًا من حزمة تطوير البرامج (SDK)

المرتجعات
`boolean`	قيمة صحيحة إذا كان من الممكن تجاوز حظر استهداف الإصدارات المنخفضة من حزمة تطوير البرامج (SDK)، وقيمة خاطئة في الحالات الأخرى

الرميات
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

تحقَّق ممّا إذا كان debugfs مثبّتًا.

المرتجعات
`boolean`	‫`true` إذا تم تثبيت debugfs

الرميات
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

تعرِض هذه الإشارة ما إذا كان الجهاز مشفَّرًا.

المرتجعات
`boolean`	‫`true` إذا كان الجهاز مشفّرًا

الرميات
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

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

المعلمات
`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`

isFastbootEnabled

public boolean isFastbootEnabled ()

تعرِض هذه السمة ما إذا كان وضع Fastboot متاحًا للجهاز.

المرتجعات
`boolean`

isHeadless

public boolean isHeadless ()

عرض "صحيح" إذا كان الجهاز بدون شاشة، و"خطأ" في الحالات الأخرى

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

isMultiUserSupported

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`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

التحقّق ممّا إذا كانت المنصة على الجهاز تتيح منح أذونات أثناء التشغيل

المرتجعات
`boolean`	تكون القيمة "صحيح" إذا كانت أذونات وقت التشغيل متاحة، و"خطأ" في الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

تعرِض هذه السمة القيمة "صحيح" إذا كان الجهاز في TestDeviceState.FASTBOOT أو TestDeviceState.FASTBOOTD.

المرتجعات
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

التحقّق ممّا إذا كان مستخدم معيّنًا نشطًا

المعلمات
`userId`	`int`

المرتجعات
`boolean`	تكون القيمة "صحيح" إذا كان المستخدم يمارس رياضة الجري، وتكون "خطأ" في كل الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

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

المعلمات
`userId`	`int`

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

الرميات
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

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

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

المعلمات
`userId`	`int`

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

تتحقّق هذه الطريقة ممّا إذا كان المستخدم المحدّد مرئيًا في العرض المحدّد.

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

المعلمات
`userId`	`int`
`displayId`	`int`

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

اختبار ما إذا كانت شبكة Wi-Fi مفعّلة

للتحقّق ممّا إذا كانت شبكة Wi-Fi مفعَّلة على الجهاز مفيدة لتأكيد حالة شبكة Wi-Fi قبل إجراء الاختبارات التي لا يجب تشغيلها باستخدام شبكة Wi-Fi، مثل اختبارات بيانات الجوّال.

المرتجعات
`boolean`	‫`true` إذا كانت شبكة Wi-Fi مفعّلة ‫`false` في حال إيقافها

الرميات
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

اجمع قائمة بمعرّفات الشاشات المتاحة على الجهاز كما تمّت الإشارة إليها من خلال "dumpsys SurfaceFlinger".

المرتجعات
	تمثّل هذه السمة قائمة بالشاشات. تعرض القيمة التلقائية دائمًا القيمة التلقائية 0.

الرميات
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

تعرض هذه الطريقة قائمة الشاشات التي يمكن استخدامها في start a user visible in the background.

المرتجعات

الرميات
`DeviceNotAvailableException`

listUsers

public  listUsers ()

تعرض هذه الطريقة قائمة بالمستخدمين على الجهاز. سيتم عرض الخطأ DeviceRuntimeException إذا لم يكن الناتج من الجهاز على النحو المتوقّع.

المرتجعات
	قائمة أرقام تعريف المستخدمين

الرميات
`DeviceNotAvailableException`

logAnrs

public boolean logAnrs (ITestLogger logger)

تجمع هذه الخدمة أخطاء ANR وتسجّلها من الجهاز.

المعلمات
`logger`	‫`ITestLogger`: هو `ITestLogger` لتسجيل أخطاء ANR.

المرتجعات
`boolean`	صحيح إذا تم التسجيل بنجاح، وخطأ في الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

المعلمات
`dataName`	‫`String`: الاسم الذي سيتم الإبلاغ عنه في تقرير الأخطاء.
`listener`	`ITestLogger`: `ITestLogger` لتسجيل تقرير الأخطاء

المرتجعات
`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`: الوسيطات التي سيتم استبدالها باستخدام String.format().

mountDebugfs

public void mountDebugfs ()

تثبيت debugfs

الرميات
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

يصدر هذا الأمر لإعادة تشغيل الجهاز، ويعود عند اكتمال الأمر وعندما لا يعود الجهاز مرئيًا لأداة تصحيح الأخطاء عبر Android.

الرميات
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

يمكنك تجاهل هذا الخيار إذا كان الجهاز يحتاج إلى اتّخاذ بعض الإجراءات المحدّدة بعد تفعيل وضع الجذر في adb وقبل إعادة الجهاز إلى الإنترنت. لا يتضمّن التنفيذ التلقائي أي إجراءات إضافية، ولا نضمن تفعيل adb root في هذه المرحلة.

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

postAdbUnrootAction

public void postAdbUnrootAction ()

تجاوز إذا كان الجهاز يحتاج إلى اتّخاذ بعض الإجراءات المحدّدة بعد إلغاء الوصول إلى الجذر باستخدام adb وقبل إعادة الجهاز إلى وضع الاتصال بالإنترنت. لا يتضمّن التنفيذ التلقائي أي إجراءات إضافية، ولا يمكن ضمان إيقاف adb root في هذه المرحلة.

الرميات
	com.android.tradefed.device.DeviceNotAvailableException
`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, 
                int userId)

سحب محتوى الدليل بشكل متكرّر من الجهاز

المعلمات
`deviceFilePath`	‫`String`: المسار المطلق للملف المصدر البعيد
`localDir`	`File`: الدليل المحلي الذي سيتم سحب الملفات إليه
`userId`	`int`: رقم تعريف المستخدم الذي سيتم استرداده

المرتجعات
`boolean`	‫`true` إذا تم سحب الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

سحب محتوى الدليل بشكل متكرّر من الجهاز

المعلمات
`deviceFilePath`	‫`String`: المسار المطلق للملف المصدر البعيد
`localDir`	`File`: الدليل المحلي الذي سيتم سحب الملفات إليه

المرتجعات
`boolean`	‫`true` إذا تم سحب الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

يستردّ ملفًا من الجهاز.

المعلمات
`remoteFilePath`	‫`String`: المسار المطلق للملف على الجهاز
`localFile`	‫`File`: الملف المحلي الذي سيتم تخزين المحتوى فيه. في حال عدم توفّر قيمة فارغة، سيتم استبدال المحتوى.

المرتجعات
`boolean`	‫`true` إذا تم استرداد الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

يسترد هذا الإجراء ملفًا من الجهاز ويخزّنه في ERROR(/File) مؤقتة محلية، ثم يعرض File.

المعلمات
`remoteFilePath`	‫`String`: المسار المطلق للملف على الجهاز
`userId`	`int`: رقم تعريف المستخدم الذي سيتم استرداده

المرتجعات
`File`	قيمة `ERROR(/File)` تحتوي على محتوى ملف الجهاز، أو `null` إذا تعذّرت عملية النسخ لأي سبب (بما في ذلك المشاكل في نظام الملفات المضيف)

الرميات
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

يسترد هذا الإجراء ملفًا من الجهاز ويخزّنه في ERROR(/File) مؤقتة محلية، ثم يعرض File.

المعلمات
`remoteFilePath`	‫`String`: المسار المطلق للملف على الجهاز

المرتجعات
`File`	قيمة `ERROR(/File)` تحتوي على محتوى ملف الجهاز، أو `null` إذا تعذّرت عملية النسخ لأي سبب (بما في ذلك المشاكل في نظام ملفات المضيف)

الرميات
`DeviceNotAvailableException`

pullFile

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

يستردّ ملفًا من الجهاز.

المعلمات
`remoteFilePath`	‫`String`: المسار المطلق للملف على الجهاز
`localFile`	‫`File`: الملف المحلي الذي سيتم تخزين المحتوى فيه. في حال عدم توفّر قيمة فارغة، سيتم استبدال المحتوى.
`userId`	`int`: رقم تعريف المستخدم الذي سيتم استرداده

المرتجعات
`boolean`	‫`true` إذا تم استرداد الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pullFileContents

public String pullFileContents (String remoteFilePath)

يسترد هذا الإجراء ملفًا من الجهاز ويعرض محتواه.

المعلمات
`remoteFilePath`	‫`String`: المسار المطلق للملف على الجهاز

المرتجعات
`String`	قيمة `String` تحتوي على محتوى ملف الجهاز، أو `null` إذا تعذّرت عملية النسخ لأي سبب (بما في ذلك المشاكل في نظام ملفات المضيف)

الرميات
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

طريقة سهلة لاسترداد ملف من وحدة التخزين الخارجية للجهاز، وتخزينه في ERROR(/File) مؤقت محلي، وعرض مرجع إلى هذا File.

المعلمات
`remoteFilePath`	‫`String`: مسار الملف على الجهاز، بالنسبة إلى نقطة ربط مساحة التخزين الخارجية للجهاز

المرتجعات
`File`	قيمة `ERROR(/File)` تحتوي على محتوى ملف الجهاز، أو `null` إذا تعذّرت عملية النسخ لأي سبب (بما في ذلك المشاكل في نظام ملفات المضيف)

الرميات
`DeviceNotAvailableException`

pushDir

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

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

المعلمات
`localFileDir`	‫`File`: الدليل المحلي الذي سيتم إرساله
`deviceFilePath`	`String`: المسار المطلق للملف الخاص بالوجهة البعيدة
`excludedDirectories`	‫: مجموعة من أسماء الدلائل المستبعَدة التي لا يجب إرسالها

المرتجعات
`boolean`	‫`true` إذا تم إرسال الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

إرسال محتوى الدليل بشكل متكرر إلى الجهاز

المعلمات
`localFileDir`	‫`File`: الدليل المحلي الذي سيتم إرساله
`deviceFilePath`	`String`: المسار المطلق للملف الخاص بالوجهة البعيدة

المرتجعات
`boolean`	‫`true` إذا تم إرسال الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

إرسال محتوى الدليل بشكل متكرر إلى الجهاز

المعلمات
`localFileDir`	‫`File`: الدليل المحلي الذي سيتم إرساله
`deviceFilePath`	`String`: المسار المطلق للملف الخاص بالوجهة البعيدة
`userId`	‫`int`: رقم تعريف المستخدم الذي سيتم إرسال الإشعار إليه

المرتجعات
`boolean`	‫`true` إذا تم إرسال الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pushFile

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

صيغة من pushFile(File, String) يمكنها اختياريًا مراعاة تقييم الحاجة إلى مقدّم المحتوى.

المعلمات
`localFile`	‫`File`: الملف المحلي الذي سيتم إرساله
`remoteFilePath`	‫`String`: المسار المطلق للملف في الوجهة البعيدة
`evaluateContentProviderNeeded`	‫`boolean`: لتحديد ما إذا كنا بحاجة إلى مقدّم المحتوى

المرتجعات
`boolean`	‫`true` إذا تم إرسال الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

إرسال ملف إلى الجهاز باستخدام موفّر محتوى تلقائيًا

المعلمات
`localFile`	‫`File`: الملف المحلي الذي سيتم إرساله
`remoteFilePath`	‫`String`: المسار المطلق للملف في الوجهة البعيدة

المرتجعات
`boolean`	‫`true` إذا تم إرسال الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pushFile

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

إرسال ملف إلى الجهاز باستخدام موفّر محتوى تلقائيًا

المعلمات
`localFile`	‫`File`: الملف المحلي الذي سيتم إرساله
`remoteFilePath`	‫`String`: المسار المطلق للملف في الوجهة البعيدة
`userId`	‫`int`: userId الذي سيتم إرسال الإشعار إليه

المرتجعات
`boolean`	‫`true` إذا تم إرسال الملف بنجاح `false` في ما عدا ذلك.

الرميات
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

إرسال ملف تم إنشاؤه من سلسلة إلى الجهاز

المعلمات
`contents`	`String`: محتوى الملف الذي سيتم إرساله
`remoteFilePath`	‫`String`: المسار المطلق للملف في الوجهة البعيدة

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

الرميات
`DeviceNotAvailableException`

إعادة تشغيل

public void reboot (String reason)

يعيد تشغيل الجهاز في وضع adb مع الاحتفاظ بالقيمة reason المحدّدة عند إعادة التشغيل.

يتم الحظر إلى أن يصبح الجهاز متاحًا.

يمكن الحصول على سبب إعادة التشغيل الأخيرة من خلال طلب البحث عن السمة sys.boot.reason.

المعلمات
`reason`	‫`String`: سبب إعادة التشغيل، أو `null` إذا لم يتم تحديد أي سبب

الرميات
`DeviceNotAvailableException`

إعادة تشغيل

public void reboot ()

تعيد هذه السياسة تشغيل الجهاز في وضع تصحيح أخطاء Android.

يتم الحظر إلى أن يصبح الجهاز متاحًا.

الرميات
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

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

يتم الحظر إلى أن يصبح الجهاز في وضع برنامج الإقلاع.

الرميات
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

تعيد هذه السمة تشغيل الجهاز في وضع fastbootd.

يتم الحظر إلى أن يصبح الجهاز في وضع fastbootd.

الرميات
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

يعيد تشغيل الجهاز في وضع الاسترداد adb.

يتم الحظر إلى أن يدخل الجهاز في وضع الاسترداد

الرميات
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف باستخدام Android Debug Bridge (يُرجى العِلم أنّ هذا الوضع خاص ضمن وضع الاسترداد)

يتم الحظر إلى أن يدخل الجهاز في وضع التحميل الجانبي

الرميات
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

يتم الحظر إلى أن يدخل الجهاز في وضع التحميل الجانبي

المعلمات
`autoReboot`	`boolean`: ما إذا كان سيتم تلقائيًا إعادة تشغيل الجهاز بعد التثبيت من مصدر غير معروف

الرميات
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

بديل reboot() الذي يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android

الرميات
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline (String reason)

بديل reboot() الذي يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android

المعلمات
`reason`	‫`String`: سبب إعادة التشغيل، أو `null` إذا لم يتم تحديد أي سبب

الرميات
`DeviceNotAvailableException`

rebootUserspace

public void rebootUserspace ()

يعيد تشغيل جزء مساحة المستخدم في الجهاز فقط.

يتم الحظر إلى أن يصبح الجهاز متاحًا.

تحذير يتم حاليًا تطوير ميزة إعادة التشغيل في مساحة المستخدم، لذا يمكنك استخدامها على مسؤوليتك الخاصة.

الرميات
`DeviceNotAvailableException`

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

بديل rebootUserspace() ()} الذي يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android.

الرميات
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

محاولات استعادة التواصل مع الجهاز

المرتجعات
`boolean`	صحيح إذا تمت محاولة الاسترداد بنجاح، وتعرض "خطأ" إذا تم تخطّي الاسترداد

الرميات
`DeviceNotAvailableException`	في حال لم يعُد الجهاز متاحًا

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

تسجّل هذه السمة IDeviceActionReceiver لهذا الجهاز.

سيتم إرسال إشعار إلى جميع IDeviceActionReceiver المسجّلة قبل بدء إجراء على الجهاز وبعد انتهائه.

المعلمات
`deviceActionReceiver`	‫`IDeviceActionReceiver`: `IDeviceActionReceiver` سيتم تسجيله.

remountSystemReadOnly

public void remountSystemReadOnly ()

اجعل قسم النظام على الجهاز للقراءة فقط. قد تتم إعادة تشغيل الجهاز.

الرميات
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

اجعل قسم النظام على الجهاز قابلاً للكتابة. قد تتم إعادة تشغيل الجهاز.

الرميات
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

اجعل قسم المورّد على الجهاز للقراءة فقط. قد تتم إعادة تشغيل الجهاز.

الرميات
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

اجعل قسم المورّد على الجهاز قابلاً للكتابة. قد تتم إعادة تشغيل الجهاز.

الرميات
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

إزالة مشرف الجهاز المحدّد في المستخدم المحدّد وعرض true في حال نجاح العملية، أو false في حال عدم نجاحها

المعلمات
`componentName`	`String`: من مشرف الجهاز الذي ستتم إزالته.
`userId`	`int`: هو معرّف المستخدم الذي يقع فيه مشرف الجهاز.

المرتجعات
`boolean`	صحيح إذا كانت العملية ناجحة، وخطأ في الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

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

الرميات
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

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

المعلمات
`userId`	‫`int`: معرّف المستخدم المطلوب إزالته

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

الرميات
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

أعِد ضبط العلامة لإعداد مقدّم المحتوى من أجل تشغيلها مرة أخرى.

runInstrumentationTests

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

طريقة سهلة لتنفيذ ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) باستخدام مستمع واحد أو أكثر يتم تمريرهم كمعلَمات

المعلمات
`runner`	‫`IRemoteAndroidTestRunner`: `IRemoteAndroidTestRunner` الذي يُجري الاختبارات
`listeners`	‫`ITestLifeCycleReceiver`: أدوات معالجة نتائج الاختبار

المرتجعات
`boolean`	‫`true` إذا اكتمل أمر الاختبار ‫`false` إذا تعذّر إكمالها، ولكن تم استردادها بنجاح

الرميات
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

تُجري هذه الخدمة اختبارات الأجهزة وتوفّر إمكانية استرداد البيانات من الأجهزة.

في حال فقدان الاتصال بالجهاز قبل اكتمال عملية التشغيل التجريبي، ونجاح عملية الاسترداد، سيتم إبلاغ جميع المستمعين بأنّ عملية testRunFailed قد حدثت وسيتم عرض القيمة "false". لن تتم إعادة تنفيذ أمر الاختبار. ويعود للمتصلين محاولة الاتصال مرة أخرى إذا لزم الأمر.

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

المعلمات
`runner`	‫`IRemoteAndroidTestRunner`: `IRemoteAndroidTestRunner` الذي يُجري الاختبارات
`listeners`	‫: أدوات معالجة نتائج الاختبار

المرتجعات
`boolean`	‫`true` إذا اكتمل أمر الاختبار ‫`false` إذا تعذّر إكمالها بسبب خطأ في التواصل مع الجهاز، ولكن تم استرداد البيانات بنجاح

الرميات
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean 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)) ولكنها تجري الاختبار للمستخدم المحدّد.

المعلمات
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

تعمل هذه السمة مثل ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) ولكنها تجري الاختبار لمستخدم معيّن.

المعلمات
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

setAdbPath

public void setAdbPath (String adbPath)

تضبط هذه السمة المسار إلى ملف adb الثنائي الذي يجب استخدامه.

المعلمات
`adbPath`	`String`

setConfiguration

public void setConfiguration (IConfiguration configuration)

يُدرِج IConfiguration المستخدَم.

المعلمات
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

المعلمات
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

تضبط هذه السمة التاريخ على الجهاز

ملاحظة: يتطلّب ضبط التاريخ على الجهاز الوصول إلى الجذر

المعلمات
`date`	`Date`: تحديد تاريخ معيّن، وسيتم استخدام تاريخ المضيف إذا كان `null`

الرميات
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

تعيين أحد مكونات مشرف الجهاز كمالك للجهاز في حساب مستخدم معيّن

المعلمات
`componentName`	`String`: من مشرف الجهاز ليكون مالك الجهاز.
`userId`	`int`: الخاصة بالمستخدم الذي يعيش فيه مالك الجهاز.

المرتجعات
`boolean`	صحيح إذا كانت العملية ناجحة، وخطأ في الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

تعديل حالة الجهاز

المعلمات
`deviceState`	`TestDeviceState`: `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

بالنسبة إلى مجموعة المحاكي، اضبط SizeLimitedOutputStream لتسجيل الناتج

المعلمات
`output`	‫`SizeLimitedOutputStream`: لتسجيل الناتج

setEmulatorProcess

public void setEmulatorProcess (Process p)

تضبط هذه السمة Process عندما يكون هذا الجهاز محاكيًا.

المعلمات
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

اضبط خيار fastboot للجهاز. يجب ضبط هذا الحقل عند تخصيص الجهاز للمرة الأولى.

المعلمات
`fastbootEnabled`	‫`boolean`: ما إذا كان fastboot متاحًا للجهاز أم لا

setFastbootPath

public void setFastbootPath (String fastbootPath)

تضبط هذه السمة المسار إلى ملف fastboot الثنائي الذي يجب استخدامه. لا يزال يتطلّب أن تكون قيمة isFastbootEnabled() صحيحة لتفعيل وظائف fastboot.

المعلمات
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

عدِّل رقم تعريف الجهاز المرتبط بجهاز الاختبار هذا.

يجب أن يشير معرّف الجهاز الجديد إلى الجهاز الفعلي نفسه الذي يشير إليه المعرّف الحالي. سيتم استدعاء هذه الطريقة إذا خصّص DDMS معرّف IDevice جديدًا

المعلمات
`newDevice`	`IDevice`: `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

تضبط هذه السمة الوقت بالمللي ثانية الذي يجب انتظاره قبل بدء عملية تسجيل logcat لجهاز متصل بالإنترنت.

المعلمات
`delay`	‫`int`: التأخير بالملي ثانية

setOptions

public void setOptions (TestDeviceOptions options)

ضبط TestDeviceOptions للجهاز

المعلمات
`options`	`TestDeviceOptions`

setProperty

public boolean setProperty (String propKey, 
                String propValue)

تضبط هذه الطريقة قيمة السمة المحدّدة على الجهاز. يجب أن تكون قيمة adb root هي "صحيح".

المعلمات
`propKey`	`String`: المفتاح المستهدَف الذي سيتم ضبطه.
`propValue`	‫`String`: قيمة السمة التي سيتم ضبطها.

المرتجعات
`boolean`	تعرض `True` إذا تم تنفيذ الأمر setprop بنجاح، أو False في الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

setRecovery

public void setRecovery (IDeviceRecovery recovery)

اضبط الرقم IDeviceRecovery الذي تريد استخدامه لهذا الجهاز. يجب ضبط هذا الحقل عند تخصيص الجهاز للمرة الأولى.

المعلمات
`recovery`	`IDeviceRecovery`: `IDeviceRecovery`

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

تُستخدَم للتحكّم في طريقة الاسترداد التي يجب استخدامها عند مواجهة مشكلة في التواصل مع الجهاز. يُنصح باستخدام هذه الطريقة بشكل محدود عند الحاجة فقط (على سبيل المثال، عندما يكون إطار العمل غير متاح، وما إلى ذلك).

المعلمات
`mode`	استبدِل `ITestDevice.RecoveryMode` بما إذا كان يجب تفعيل وضع "استعادة البيانات إلى حين الاتصال بالإنترنت فقط" أو إيقافه.

setSetting

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

اطّلِع على setSetting(int, String, String, String) التي تم تنفيذها على مستخدم النظام.

المعلمات
`namespace`	`String`
`key`	`String`
`value`	`String`

الرميات
`DeviceNotAvailableException`

setSetting

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

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

المعلمات
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

الرميات
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

إدخال مثيل ITestLogger

المعلمات
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

لأغراض إدارة الأجهزة، يتم تتبُّع الرقم التسلسلي الذي نستخدمه للإشارة إلى الجهاز.

المعلمات
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

تحديد ما إذا كان سيتم استخدام fastboot erase أو fastboot format لمحو قسم على الجهاز

المعلمات
`useFastbootErase`	`boolean`: `true` إذا كان يجب استخدام fastboot erase أو `false` إذا كان يجب استخدام fastboot format.

startLogcat

public void startLogcat ()

ابدأ في تسجيل ناتج logcat من الجهاز في الخلفية.

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

عندما لا يكون الجهاز قيد الاستخدام، يجب استدعاء stopLogcat().

لا يلزم عادةً استدعاء startLogcat() وstopLogcat() عند استخدام سياق استدعاء TF، لأنّ إطار عمل TF سيبدأ logcat ويتوقّف.

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

فعِّل وضع اختبار الاستبدال. سيتم محو بيانات الجهاز وإعادة تشغيله.

المعلمات
`timeoutMs`	`int`

المرتجعات
`boolean`	صحيح إذا نجحنا، خطأ في الحالات الأخرى

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

startUser

public boolean startUser (int userId)

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

المعلمات
`userId`	‫`int`: تمثّل هذه السمة المستخدم الذي سيتم تشغيل التطبيق في الخلفية.

المرتجعات
`boolean`	تعرض القيمة "true" إذا تم بدء المستخدم بنجاح في الخلفية.

الرميات
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

المعلمات
`userId`	‫`int`: تمثّل هذه السمة المستخدم الذي سيتم تشغيل التطبيق في الخلفية.
`waitFlag`	سيؤدي استخدام `boolean` إلى إيقاف الأمر مؤقتًا إلى أن يتم بدء تشغيل المستخدم وفتح قفله.

المرتجعات
`boolean`	تعرض القيمة "true" إذا تم بدء المستخدم بنجاح في الخلفية.

الرميات
`DeviceNotAvailableException`

startVisibleBackgroundUser

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

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

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

المعلمات
`userId`	‫`int`: تمثّل هذه السمة المستخدم الذي سيتم تشغيل التطبيق في الخلفية.
`displayId`	‫`int`: عرض بدء ظهور المستخدم
`waitFlag`	سيؤدي استخدام `boolean` إلى إيقاف الأمر مؤقتًا إلى أن يتم بدء تشغيل المستخدم وفتح قفله.

المرتجعات
`boolean`	‫`true` إذا تم بدء المستخدم بنجاح في الخلفية

الرميات
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

أغلِق ناتج المحاكي واحذفه.

stopLogcat

public void stopLogcat ()

إيقاف تسجيل ناتج logcat من الجهاز وتجاهل بيانات logcat المحفوظة حاليًا

لن يكون لها أي تأثير إذا لم يتم تسجيل ناتج logcat.

stopTradeInModeTesting

public void stopTradeInModeTesting ()

إيقاف اختبار وضع إعادة البيع

الرميات
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

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

المعلمات
`userId`	`int`: تمثّل هذه السمة معرّف المستخدم الذي سيتم إيقافه.

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

الرميات
`DeviceNotAvailableException`

stopUser

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

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

المعلمات
`userId`	`int`: تمثّل هذه السمة معرّف المستخدم الذي سيتم إيقافه.
`waitFlag`	‫`boolean`: سيؤدي إلى انتظار الأمر إلى أن يتم إيقاف المستخدم.
`forceFlag`	‫`boolean`: سيتم فرض إيقاف المستخدم.

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

الرميات
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

بدِّل الجهاز إلى وضع adb-over-tcp.

المرتجعات
`String`	الرقم التسلسلي لبروتوكول TCP أو `null` إذا تعذّر تبديل الجهاز

الرميات
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

بدِّل الجهاز إلى وضع adb عبر USB.

المرتجعات
`boolean`	‫`true` إذا تم التبديل بنجاح، و`false` في الحالات الأخرى

الرميات
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

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

المعلمات
`userId`	`int`

المرتجعات
`boolean`	تعرض القيمة "صحيح" إذا كان رقم تعريف المستخدم الجديد يتطابق مع موفّر رقم تعريف المستخدم. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

الرميات
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

بدِّل إلى userId آخر مع المهلة المقدَّمة كموعد نهائي. محاولة إيقاف قفل الشاشة بعد نجاح عملية تبديل المستخدم

المعلمات
`userId`	`int`
`timeout`	‫`long`: للانتظار قبل عرض القيمة false في حال تعذُّر التبديل بين المستخدمين

المرتجعات
`boolean`	تعرض القيمة "صحيح" إذا كان رقم تعريف المستخدم الجديد يتطابق مع موفّر رقم تعريف المستخدم. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.

الرميات
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

تتم مزامنة محتوى دليل ملف محلي مع الجهاز بشكل تدريجي.

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

سيتم تجاهل الملفات المخفية (التي تبدأ أسماؤها بـ ".").

مثال على الاستخدام: سيؤدي تنفيذ syncFiles("/tmp/files", "/sdcard") إلى إنشاء دليل /sdcard/files إذا لم يكن متوفّرًا، كما سيؤدي إلى نقل محتوى /tmp/files بشكل متكرر إلى /sdcard/files.

المعلمات
`localFileDir`	`File`: دليل الملفات المحلية الذي يحتوي على الملفات التي سيتم إرسالها بشكل متكرر.
`deviceFilePath`	`String`: جذر المسار المطلق للملف الوجهة البعيد يجب أن تكون جميع الدلائل في مسار الملف قابلة للقراءة. على سبيل المثال، سيؤدي إرسال الملف إلى /data/local/tmp عندما لا يكون adb هو الجذر إلى حدوث خطأ.

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

الرميات
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

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

المرتجعات
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

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

المعلمات
`packageName`	‫`String`: حزمة Android المطلوب إلغاء تثبيتها

المرتجعات
`String`	`String` مع رمز خطأ، أو `null` في حال النجاح

الرميات
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

إزالة حزمة Android من الجهاز لمستخدم معيّن

المعلمات
`packageName`	‫`String`: حزمة Android المطلوب إلغاء تثبيتها
`userId`	‫`int`: رقم تعريف المستخدم الصحيح المطلوب إلغاء تثبيت التطبيق له.

المرتجعات
`String`	`String` مع رمز خطأ، أو `null` في حال النجاح

الرميات
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

يفتح قفل الجهاز إذا كان مشفَّرًا.

قد تعيد هذه الطريقة تشغيل إطار العمل ولكنّها لن تستدعي postBootSetup(). لذلك، قد لا يكون الجهاز جاهزًا تمامًا للاختبار عند عرض هذه الطريقة.

المرتجعات
`boolean`	‫`true` في حال نجاح العملية أو إذا كان الجهاز غير مشفّر

الرميات
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

إلغاء تثبيت debugfs

الرميات
`DeviceNotAvailableException`

waitForBootComplete

public boolean waitForBootComplete (long timeOut)

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

المعلمات
`timeOut`	‫`long`: الوقت بالملّي ثانية الذي يجب انتظاره إلى أن يتم ضبط العلامة

المرتجعات
`boolean`	صحيح إذا تم ضبط علامة اكتمال عملية تشغيل الجهاز خلال المهلة المحددة

الرميات
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

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

المرتجعات
`boolean`	"صحيح" إذا كان الجهاز متاحًا، و"خطأ" إذا كان خيار الاسترداد غير مفعّل وغير متاح.

الرميات
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

تنتظر هذه الحالة إلى أن يصبح الجهاز متجاوبًا ومتاحًا للاختبار.

المعلمات
`waitTime`	‫`long`: الوقت المطلوب الانتظار فيه بالملي ثانية

المرتجعات
`boolean`	"صحيح" إذا كان الجهاز متاحًا، و"خطأ" إذا كان خيار الاسترداد غير مفعّل وغير متاح.

الرميات
`DeviceNotAvailableException`

waitForDeviceAvailableInRecoverPath

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

ينتظر أن يصبح الجهاز متجاوبًا ومتاحًا بدون أخذ مسار الاسترداد في الاعتبار.

المعلمات
`waitTime`	`long`

المرتجعات
`boolean`	"صحيح" إذا كان الجهاز متاحًا، و"خطأ" إذا لم يكن متاحًا.

الرميات
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال Fastboot. استخدام المهلة التلقائية

الرميات
`DeviceNotAvailableException`

waitForDeviceFastbootD

public void waitForDeviceFastbootD ()

الرميات
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

يمنع الجهاز من أن يكون في حالة "استرداد adb" (يُرجى العِلم أنّ هذه الحالة تختلف عن IDeviceRecovery).

المعلمات
`waitTime`	‫`long`: الوقت المطلوب الانتظار فيه بالملي ثانية

المرتجعات
`boolean`	`true` إذا تم تشغيل الجهاز في وضع الاسترداد قبل انتهاء الوقت `false` خلاف ذلك

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

حظر الجهاز من أن يكون في حالة "التحميل الجانبي عبر adb"

المعلمات
`waitTime`	‫`long`: الوقت المطلوب الانتظار فيه بالملي ثانية

المرتجعات
`boolean`	`true` إذا تم تشغيل الجهاز في وضع التحميل الجانبي قبل انتهاء الوقت. `false` خلاف ذلك

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

حظر عدم توفّر الجهاز، أي عدم ظهوره في adb

المعلمات
`waitTime`	‫`long`: الوقت المطلوب الانتظار فيه بالملي ثانية

المرتجعات
`boolean`	`true` إذا أصبح الجهاز غير متاح قبل انتهاء الوقت `false` خلاف ذلك

waitForDeviceOnline

public void waitForDeviceOnline ()

يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال adb. استخدام المهلة التلقائية

يُرجى العِلم أنّه قد لا يستجيب الجهاز للأوامر عند اكتمال العملية. استخدِم waitForDeviceAvailable() بدلاً من ذلك.

الرميات
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال adb.

يُرجى العِلم أنّه قد لا يستجيب الجهاز للأوامر عند اكتمال العملية. استخدِم waitForDeviceAvailable() بدلاً من ذلك.

المعلمات
`waitTime`	‫`long`: الوقت المطلوب الانتظار فيه بالملي ثانية

الرميات
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

تنتظر هذه الحالة استجابة الجهاز لأمر adb shell أساسي.

المعلمات
`waitTime`	‫`long`: الوقت المطلوب الانتظار فيه بالملي ثانية

المرتجعات
`boolean`	`true` إذا أصبح الجهاز متجاوبًا قبل انقضاء مدة `waitTime`

الطُرق المحمية

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

المعلمات
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

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

تنشئ هذه الدالة أمر نظام التشغيل لجلسة أمر adb shell المحدّدة والمعلَمات

المعلمات
`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)

أنشئ RebootDeviceAction لاستخدامه عند تنفيذ إجراء إعادة التشغيل.

المعلمات
`rebootMode`	‫`NativeDevice.RebootMode`: وضع إعادة التشغيل هذا
`reason`	‫`String`: لإعادة التشغيل هذه.

المرتجعات
`NativeDevice.RebootDeviceAction`	`RebootDeviceAction` الذي تم إنشاؤه

createRunUtil

protected IRunUtil createRunUtil ()

المرتجعات
`IRunUtil`

doAdbReboot

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

نفِّذ عملية إعادة التشغيل عبر adb.

المعلمات
`rebootMode`	‫`NativeDevice.RebootMode`: وضع إعادة التشغيل هذا
`reason`	‫`String`: لإعادة التشغيل هذه.

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

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

طريقة مساعدة لعرض استثناء في حال عدم توفّر إذن التشغيل

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

getApiLevelSafe

protected int getApiLevelSafe ()

المرتجعات
`int`

getLogger

protected ITestLogger getLogger ()

المرتجعات
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

احصل على مثيل RunUtil لاستخدامه.

المرتجعات
`IRunUtil`

internalGetProperty

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

يتم استرداد إحدى خصائص الجهاز من ذاكرة التخزين المؤقت ddmlib تلقائيًا، مع الرجوع إلى `adb shell getprop` أو `fastboot getvar` حسب ما إذا كان الجهاز في وضع Fastboot أم لا.

المعلمات
`propName`	‫`String`: اسم خاصية الجهاز كما يتم عرضه من خلال الأمر `adb shell getprop`
`fastbootVar`	`String`: اسم متغيّر fastboot المكافئ الذي سيتم طلبه. إذا كانت القيمة `null`، لن تتم محاولة طلب fastboot
`description`	‫`String`: وصف بسيط للمتغير. يجب أن يكون الحرف الأول كبيرًا.

المرتجعات
`String`	سلسلة، ربما `null` أو فارغة، تحتوي على قيمة السمة المحدّدة

الرميات
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

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

المرتجعات
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

إرجاع true إذا كان الملف المحلي أحدث من الملف البعيد IFileEntry أن يكون دقيقًا إلى الدقيقة، وفي حال تساوي الأوقات، سيتم اعتبار الملف أحدث.

المعلمات
`localFile`	`File`
`entry`	`IFileEntry`

المرتجعات
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

يُرسِل إشعارًا إلى جميع IDeviceActionReceiver بشأن حدث انتهاء إعادة التشغيل.

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

notifyRebootStarted

protected void notifyRebootStarted ()

يُرسِل إشعارًا إلى جميع IDeviceActionReceiver بشأن حدث بدء إعادة التشغيل.

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

performDeviceAction

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

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

المعلمات
`actionDescription`	‫`String`: وصف موجز للإجراء المطلوب تنفيذه يُستخدَم لأغراض التسجيل فقط.
`action`	‫`NativeDevice.DeviceAction`: الإجراء المطلوب تنفيذه
`retryAttempts`	‫`int`: محاولات إعادة تنفيذ الإجراء في حال تعذّر تنفيذه ولكن تم استرداده بنجاح

المرتجعات
`boolean`	‫`true` إذا تم تنفيذ الإجراء بنجاح

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

postAdbReboot

protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

الإجراءات الإضافية المحتملة التي يمكن اتّخاذها بعد إعادة التشغيل

المعلمات
`rebootMode`	`NativeDevice.RebootMode`

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

prePostBootSetup

protected void prePostBootSetup ()

تسمح لكل نوع جهاز (AndroidNativeDevice وTestDevice) بتجاوز هذه الطريقة لإعدادات محدّدة بعد التشغيل.

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

المعلمات
`remoteFilePath`	`String`
`localFile`	`File`

المرتجعات
`boolean`

الرميات
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

اضبط مثيل Clock المطلوب استخدامه.

المعلمات
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

تضع علامة على TestDevice باعتباره microdroid وتضبط معرّف CID الخاص به.

المعلمات
`process`	`Process`: عملية الجهاز الافتراضي Microdroid

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

المعلمات
`deviceOptions`

simpleFastbootCommand

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

تنفيذ أمر fastboot بسيط باستخدام متغيرات البيئة والإبلاغ عن حالة الأمر

المعلمات
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

المرتجعات
`CommandResult`

simpleFastbootCommand

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

ينفّذ أمر fastboot بسيطًا ويبلغ عن حالة الأمر.

المعلمات
`timeout`	`long`
`fullCmd`	`String`

المرتجعات
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

انتظِر إلى أن يصبح الجهاز غير متاح (توقّف عن إرسال البيانات إلى adb).

المعلمات
`operationDesc`	`String`: اسم العملية التي تنتظر أن يصبح المورد متاحًا.
`time`	‫`long`: الوقت الذي يجب انتظاره قبل حدوث الخطأ "غير متوفّر".

المرتجعات
`boolean`	صحيح إذا أصبح الجهاز غير متاح.

NativeDevice

ملخّص

الفئات المتداخلة

الثوابت

الحقول

الإنشاءات العامة

الطُرق العامة

الطُرق المحمية

الثوابت

DEBUGFS_PATH

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

SD_CARD

STORAGE_EMULATED

الحقول

mOptions

mStateMonitor

الإنشاءات العامة

NativeDevice

الطُرق العامة

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAdbPath

getAllSettings

getAllocationState

getAndroidId