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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

الإجراءات العامة
`String`	`adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)` تثبيت حزمة Android على الجهاز باستخدام أمر adb
`String`	`adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` تثبيت حزمة Android على الجهاز باستخدام أمر adb
`void`	`batchPrefetchStartupBuildProps()` تحسين بسيط (حوالي 400 جزء من الثانية) من خلال جلب جميع الخصائص التي نحتاجها مسبقًا بدلاً من استدعاء "adb getprop" لكل خاصية.
`boolean`	`canSwitchToHeadlessSystemUser()` تعرِض هذه السمة ما إذا كان مسموحًا بالتبديل إلى مستخدم SYSTEM بلا واجهة مستخدم رسومية.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` التحقّق مما إذا كانت إحدى الميزات متاحة حاليًا عند توفّر مستوى الحد الأدنى من التوافق
`boolean`	`checkConnectivity()` تأكَّد من أنّ الجهاز متصل بالشبكة.
`boolean`	`clearErrorDialogs()` محاولة إغلاق أي مربّعات حوار خطأ معروضة حاليًا على واجهة مستخدم الجهاز
`void`	`clearLastConnectedWifiNetwork()` يمحو شبكة Wi-Fi التي تم الاتصال بها آخر مرة.
`void`	`clearLogcat()` يحذف أي بيانات logcat متراكمة.
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` أحد أشكال `connectToWifiNetwork(String,String)` الذي لا يتصل إلا إذا كان الجهاز غير متصل بشبكة حاليًا.
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)` أحد أشكال `connectToWifiNetwork(String,String)` الذي لا يتصل إلا إذا كان الجهاز غير متصل بشبكة حاليًا.
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)` الاتصال بشبكة Wi-Fi
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)` الاتصال بشبكة Wi-Fi
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)` الاتصال بشبكة Wi-Fi
`IWifiHelper.WifiConnectionResult`	`connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)` الاتصال بشبكة Wi-Fi
`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) المنقضي منذ بداية حقبة يونكس من الجهاز و`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(String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام.
`String`	`executeAdbCommand(long timeout, Map<String, String> envMap, String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`CommandResult`	`executeAdbV2Command(String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام.
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> envMap, String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> envMap, int retryAttempts, String... cmdArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` طريقة مساعدة تنفّذ أمر fastboot كأمر نظام بمهلة تلقائية تبلغ دقيقتَين.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` طريقة مساعدة تنفّذ أمر fastboot كأمر نظام.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` طريقة مساعدة تنفّذ أمر fastboot طويلاً كأمر نظام.
`CommandResult`	`executeLongFastbootCommand(Map<String, String> 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, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.
`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, OutputStream pipeToOutput)` طريقة مساعدة تنفّذ أمر adb shell وتعرض النتائج كـ `CommandResult` مملوء بشكل صحيح بناتج حالة الأمر وstderr.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.
`CommandResult`	`executeShellV2Command(String cmd, IShellOutputReceiver receiver)` طريقة مساعدة تنفّذ أمر adb shell وتعرض النتائج على شكل `CommandResult` مملوء بشكل صحيح بناتج حالة الأمر وstdout وstderr.
`CommandResult`	`fastbootOemRamdumpNow()` طريقة مساعدة تؤدي إلى تشغيل ramdump من وضع fastboot.
`CommandResult`	`fastbootWipePartition(String partition)` طريقة مساعدة تمحو قسمًا من الجهاز.
`Set<ITestDevice.ApexInfo>`	`getActiveApexes()` استرجاع المعلومات حول حِزم APEX المفعَّلة على الجهاز
`String`	`getAdbPath()` تعرض هذه السمة مسار ملف adb الثنائي المستخدَم.
`Map<String, String>`	`getAllSettings(String namespace)` عرض أزواج المفتاح/القيمة لمساحة الاسم المطلوبة
`DeviceAllocationState`	`getAllocationState()` عرض حالة التخصيص الحالية للجهاز
`String`	`getAndroidId(int userId)` تعرض هذه الطريقة رقم تعريف Android المرتبط بمعرّف المستخدم، أو القيمة null إذا لم يتم العثور على رقم تعريف Android.
`Map<Integer, String>`	`getAndroidIds()` إنشاء خريطة لمعرّفات Android التي تم العثور عليها مطابقة لمعرّفات المستخدمين
`int`	`getApiLevel()` الحصول على مستوى واجهة برمجة التطبيقات للجهاز
`int`	`getApiLevelFull()` تشبه `getApiLevel()`، ولكنها تعرض الإصدار الكامل.
`PackageInfo`	`getAppPackageInfo(String packageName)` استرجاع معلومات حول حزمة مثبَّتة على الجهاز
`List<PackageInfo>`	`getAppPackageInfos()` استرداد معلومات الحِزم المثبَّتة على الجهاز
`String`	`getBasebandVersion()` طريقة سهلة للحصول على إصدار النطاق الأساسي (الراديو) لهذا الجهاز.
`Integer`	`getBattery()` تعرض هذه السمة مستوى البطارية الحالي للجهاز أو القيمة Null إذا كان مستوى البطارية غير متوفّر.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` تعرض هذه الدالة القيمة المنطقية للسمة المحدّدة.
`Map<Long, String>`	`getBootHistory()` تجمع طريقة المساعدة خريطة سجلّ بدء التشغيل مع وقت بدء التشغيل وسببه.
`Map<Long, String>`	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` تجمع طريقة المساعدة خريطة سجلّ بدء التشغيل مع وقت بدء التشغيل وسبب بدء التشغيل منذ الوقت المحدّد منذ بداية الحقبة من الجهاز ووحدة الوقت المحدّدة.
`String`	`getBootloaderVersion()` طريقة سهلة للحصول على إصدار برنامج الإقلاع على هذا الجهاز.
`InputStreamSource`	`getBugreport()` يستردّ تقرير خطأ من الجهاز.
`InputStreamSource`	`getBugreportz()` يستردّ هذا الأمر تقرير bugreportz من الجهاز.
`String`	`getBuildAlias()` استرداد الاسم المستعار للإصدار الذي يعمل عليه الجهاز حاليًا
`String`	`getBuildFlavor()` استرداد نوع الإصدار للجهاز
`String`	`getBuildId()` استرداد الإصدار الذي يعمل به الجهاز حاليًا
`String`	`getBuildSigningKeys()` تعرِض هذه السمة نوع المفتاح المستخدَم لتوقيع صورة الجهاز. عادةً ما يتم توقيع أجهزة Android باستخدام مفاتيح اختبار (كما هو الحال في مشروع Android المفتوح المصدر) أو مفاتيح إصدار (يتحكّم فيها مصنّعو الأجهزة الفردية).
`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)` دالة مساعدة للحصول على فرق الوقت بين الجهاز وقيمة `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` من مسار غير أساسي
`Set<DeviceFoldableState>`	`getFoldableStates()` تعرض هذه السمة قائمة بحالات الجهاز القابل للطي.
`IDevice`	`getIDevice()` تعرض هذه السمة مرجعًا إلى ddmlib `IDevice` المرتبط.
`Set<String>`	`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()` تعرِض هذه السمة رقم تعريف المستخدم الرئيسي.
`Set<String>`	`getMainlineModuleInfo()` الحصول على معلومات حول الوحدات الرئيسية المثبَّتة على الجهاز
`int`	`getMaxNumberOfRunningUsersSupported()` الحصول على الحد الأقصى لعدد المستخدمين الذين يمكنهم تشغيل التطبيق في الوقت نفسه
`int`	`getMaxNumberOfUsersSupported(String userType)` الحصول على الحد الأقصى لعدد المستخدمين المسموح به لنوع المستخدم المحدّد
`int`	`getMaxNumberOfUsersSupported()` احصل على الحد الأقصى لعدد المستخدمين القابلين للتبديل، باستثناء الضيوف.
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` عرض `IDeviceStateMonitor` المرتبط بالجهاز
`String`	`getMountPoint(String mountName)` تعرِض هذه السمة نقطة تثبيت.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` تعرض هذه السمة `MountPointInfo` المقابل لمسار نقطة التثبيت المحدّد، أو `null` إذا لم يتم تثبيت أي شيء في هذا المسار أو إذا لم يظهر في /proc/mounts كنقطة تثبيت.
`List<ITestDevice.MountPointInfo>`	`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()` الحصول على وضع الاسترداد الحالي المستخدَم للجهاز
`int`	`getRemainingCreatableUserCount(String userType)` تعرِض هذه السمة عدد المستخدمين من نوع المستخدم المحدّد الذين يمكن إنشاؤهم على هذا الجهاز.
`InputStreamSource`	`getScreenshot(Long displayId, String format, boolean rescale)` تأخذ هذه الطريقة لقطة شاشة من الجهاز الذي تمّ تحديد رقم تعريف العرض له بالتنسيق المتوافق.
`InputStreamSource`	`getScreenshot(String format)` لالتقاط لقطة شاشة من الجهاز
`InputStreamSource`	`getScreenshot(long displayId)` تلتقط هذه الطريقة لقطة شاشة من الجهاز الذي تمّ تحديد رقم تعريف العرض له.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` لالتقاط لقطة شاشة من الجهاز
`InputStreamSource`	`getScreenshot()` لالتقاط لقطة شاشة من الجهاز
`String`	`getSerialNumber()` طريقة سهلة للحصول على الرقم التسلسلي لهذا الجهاز.
`String`	`getSetting(int userId, String namespace, String key)` عرض قيمة الإعداد المطلوب
`String`	`getSetting(String namespace, String key)` اطّلِع على `getSetting(int,String,String)` الذي تم تنفيذه على مستخدم النظام.
`String`	`getSimOperator()` إرجاع مشغّل شريحة SIM أو قيمة فارغة إذا لم يكن متاحًا أو إذا لم يكن الجهاز متاحًا
`String`	`getSimState()` إرجاع حالة شريحة SIM أو قيمة فارغة إذا لم تكن متاحة أو إذا لم يكن الجهاز متاحًا
`List<File>`	`getTombstones()` استرداد قائمة علامات الحذف من الأجهزة وعرضها
`long`	`getTotalMemory()` تعرض هذه السمة إجمالي حجم الذاكرة الفعلية بالبايت أو القيمة -1 في حال حدوث خطأ داخلي.
`String`	`getTrackingSerial()` لأغراض إدارة الجهاز، احصل على الرقم التسلسلي المستخدَم لتتبُّع الجهاز.
`Set<String>`	`getUninstallablePackageNames()` استرجاع أسماء حِزم التطبيقات التي يمكن إلغاء تثبيتها
`boolean`	`getUseFastbootErase()` تعرض هذه السمة ما إذا كان سيتم استخدام fastboot erase أو fastboot format لمحو قسم على الجهاز.
`int`	`getUserFlags(int userId)` للعثور على علامات مستخدم معيّن وعرضها
`Map<Integer, UserInfo>`	`getUserInfos()` تعرض هذه السمة خريطة تربط بين useId و`UserInfo` على الجهاز.
`int`	`getUserSerialNumber(int userId)` لعرض الرقم التسلسلي المرتبط بمعرّف المستخدم في حال العثور عليه، أو -10000 في أي حالات أخرى.
`int`	`getUserVisibleOnDisplay(int displayId)` تعرض هذه السمة رقم تعريف المستخدم المرئي على الشاشة المحدّدة.
`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, boolean grantPermissions, String... extraArgs)` تثبيت حزمة Android على الجهاز
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` تثبيت حزمة Android على الجهاز
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` تثبيت حزمة Android على الجهاز لمستخدم معيّن
`String`	`installPackageForUser(File packageFile, boolean reinstall, 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`	`isShellV2Support()`
`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 مفعّلة
`Set<Long>`	`listDisplayIds()` اجمع قائمة بمعرّفات الشاشات المتاحة على الجهاز كما تم الإبلاغ عنها من خلال "dumpsys SurfaceFlinger".
`Set<Integer>`	`listDisplayIdsForStartingVisibleBackgroundUsers()` تعرض هذه السمة قائمة الشاشات التي يمكن استخدامها في `start a user visible in the background`.
`ArrayList<Integer>`	`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 root وقبل أن يعود الجهاز إلى الاتصال بالإنترنت.
`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`	`pullDir(String deviceFilePath, File localDir, int userId, long timeout)` سحب محتوى الدليل بشكل متكرّر من الجهاز
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId, long timeout)` يستردّ ملفًا من الجهاز.
`boolean`	`pullFile(String remoteFilePath, File localFile)` يستردّ ملفًا من الجهاز.
`File`	`pullFile(String remoteFilePath, int userId)` يسترد هذا الإجراء ملفًا من الجهاز ويخزّنه في `File` مؤقتة محلية، ثم يعرض `File`.
`File`	`pullFile(String remoteFilePath)` يسترد هذا الإجراء ملفًا من الجهاز ويخزّنه في `File` مؤقتة محلية، ثم يعرض `File`.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` يستردّ ملفًا من الجهاز.
`String`	`pullFileContents(String remoteFilePath)` يسترد هذا الإجراء ملفًا من الجهاز ويعرض محتواه.
`File`	`pullFileFromExternal(String remoteFilePath)` طريقة سهلة لاسترداد ملف من وحدة التخزين الخارجية للجهاز وتخزينه في `File` مؤقت محلي، ثم إرجاع مرجع إلى هذا `File`.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` إرسال محتوى الدليل بشكل متكرر إلى الجهاز
`boolean`	`pushDir(File localFileDir, String deviceFilePath, Set<String> excludedDirectories)` دفع محتويات الدليل بشكل متكرر إلى الجهاز مع استبعاد بعض الأدلة التي تم فلترتها
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` إرسال محتوى الدليل بشكل متكرر إلى الجهاز
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` صيغة `pushFile(File,String)` يمكنها اختياريًا مراعاة تقييم الحاجة إلى مقدّم المحتوى.
`boolean`	`pushFile(File localFile, String remoteFilePath)` إرسال ملف إلى الجهاز
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` إرسال ملف إلى الجهاز
`boolean`	`pushString(String contents, String remoteFilePath)` إرسال ملف تم إنشاؤه من سلسلة إلى الجهاز
`void`	`reboot(String reason)` تعيد هذه السمة تشغيل الجهاز في وضع تصحيح الأخطاء عبر adb مع الاحتفاظ بالقيمة `reason` المحدّدة عند إعادة التشغيل.
`String`	`reboot(String command, String reason)` يعيد تشغيل الجهاز باستخدام `command` المحدّد.
`void`	`reboot()` تعيد هذه السمة تشغيل الجهاز في وضع تصحيح أخطاء adb.
`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, Collection<ITestLifeCycleReceiver> listeners)` تنفيذ اختبارات الأجهزة وتوفير إمكانية استرداد البيانات من الجهاز
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` طريقة سهلة لتنفيذ `runInstrumentationTests(IRemoteAndroidTestRunner,Collection)` باستخدام مستمع واحد أو أكثر يتم تمريرهم كمعلَمات.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)` هي نفسها `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)` عدِّل رقم تعريف الجهاز المرتبط بـ ITestDevice.
`void`	`setLogStartDelay(int delay)` تضبط هذه السمة الوقت بالمللي ثانية الذي يجب الانتظار خلاله قبل بدء عملية تسجيل logcat لجهاز متصل بالإنترنت.
`void`	`setOptions(TestDeviceOptions options)` ضبط `TestDeviceOptions` للجهاز
`boolean`	`setProperty(String propKey, String propValue)` تضبط هذه الطريقة قيمة السمة المحدّدة على الجهاز.
`void`	`setRecovery(IDeviceRecovery recovery)` اضبط الرقم `IDeviceRecovery` الذي تريد استخدامه لهذا الجهاز.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` تضبط هذه السمة وضع الاسترداد الحالي الذي سيتم استخدامه للجهاز.
`void`	`setSetting(String namespace, String key, String value)` اطّلِع على `setSetting(int,String,String,String)` الذي تم تنفيذه على مستخدم النظام.
`void`	`setSetting(int userId, String namespace, String key, String value)` أضِف قيمة إعداد إلى مساحة الاسم الخاصة بمستخدم معيّن.
`void`	`setTestLogger(ITestLogger testLogger)` إدخال مثيل `ITestLogger`
`void`	`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 sideload"
`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, boolean oldShellCommand)` إنشاء أمر نظام التشغيل لجلسة أمر 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`	`pullFileWithAdbCommand(String remoteFilePath, File localFile, long timeout)`
`void`	`setClock(Clock clock)` اضبط مثيل Clock المطلوب استخدامه.
`void`	`setMicrodroidProcess(Process process)` يضع علامة على TestDevice باعتباره microdroid ويضبط معرّف CID الخاص به.
`void`	`setTestDeviceOptions(Map<String, String> deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` ينفّذ أمر fastboot بسيطًا ويبلغ عن حالة الأمر.
`CommandResult`	`simpleFastbootCommand(long timeout, Map<String, String> envVarMap, 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

Constant Value: "/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` لإعلامك بالتغييرات في حالة التخصيص يمكن أن تكون القيمة فارغة

الإجراءات العامة

adbInstallPackage

public String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

تثبيت حزمة Android على الجهاز باستخدام أمر adb

المعلَمات
`packageFile`	‫`File`: ملف APK المطلوب تثبيته
`reinstall`	`boolean`: `true` إذا كان يجب إعادة التثبيت
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.

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

عمليات الطرح
`DeviceNotAvailableException`

adbInstallPackage

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

تثبيت حزمة Android على الجهاز باستخدام أمر adb

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

المعلَمات
`packageFile`	‫`File`: ملف APK المطلوب تثبيته
`reinstall`	`boolean`: `true` إذا كان يجب إعادة التثبيت
`grantPermissions`	‫`boolean`: لتحديد ما إذا كان يجب منح جميع أذونات وقت التشغيل عند التثبيت
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.

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

عمليات الطرح
`DeviceNotAvailableException`

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() لا تعرض سوى بيانات السجلّ التي تم إنتاجها بعد نقطة معيّنة (مثل بعد تثبيت إصدار جديد من الجهاز، وما إلى ذلك).

connectToWifiNetworkIfNeededWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

المرتجعات
`IWifiHelper.WifiConnectionResult`	الرمز `WifiConnectionResult` الذي يشير إلى حالة الاتصال

عمليات الطرح
`DeviceNotAvailableException`

connectToWifiNetworkIfNeededWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

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

المرتجعات
`IWifiHelper.WifiConnectionResult`	الرمز `WifiConnectionResult` الذي يشير إلى حالة الاتصال

عمليات الطرح
`DeviceNotAvailableException`

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

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

المرتجعات
`IWifiHelper.WifiConnectionResult`	الرمز `WifiConnectionResult` الذي يشير إلى حالة الاتصال

عمليات الطرح
`DeviceNotAvailableException`

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

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

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

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

المرتجعات
`IWifiHelper.WifiConnectionResult`	الرمز `WifiConnectionResult` الذي يشير إلى حالة الاتصال

عمليات الطرح
`DeviceNotAvailableException`

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

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

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

المرتجعات
`IWifiHelper.WifiConnectionResult`	الرمز `WifiConnectionResult` الذي يشير إلى حالة الاتصال

عمليات الطرح
`DeviceNotAvailableException`

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

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

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

المرتجعات
`IWifiHelper.WifiConnectionResult`	الرمز `WifiConnectionResult` الذي يشير إلى حالة الاتصال

عمليات الطرح
`DeviceNotAvailableException`

createUser

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`
`IllegalStateException`

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

createUser

public int createUser (String name)

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

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

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

عمليات الطرح
`DeviceNotAvailableException`
`IllegalStateException`

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) المنقضي منذ بداية حقبة يونكس من الجهاز وTimeUnit. تشير إعادة التشغيل السلسة إلى إعادة تشغيل system_server خارج عملية إعادة التشغيل الكاملة للجهاز (على سبيل المثال: إعادة التشغيل المطلوبة). يمكن الحصول على utcEpochTime للجهاز الحالي بالمللي ثانية باستخدام الطريقة getDeviceDate().

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

المرتجعات
`boolean`	‫`true` في حال إعادة تشغيل الجهاز بشكل بسيط

عمليات الطرح
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

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

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

عمليات الطرح
`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`: اسم عملية الجهاز التي سيتم تفريغ الذاكرة المؤقتة فيها.
`devicePath`	‫`String`: المسار على الجهاز الذي سيتم وضع ملف التفريغ فيه يجب أن يكون هذا الموقع الجغرافي موقعًا تسمح الأذونات بتسجيل الفيديو فيه.

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                Map<String, String> envMap, 
                String... cmdArgs)

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

executeAdbV2Command

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

executeAdbV2Command

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                int retryAttempts, 
                String... cmdArgs)

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

المعلَمات
`timeout`	‫`long`: الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، 0L لعدم وجود مهلة
`envMap`	‫`Map`: البيئة التي سيتم ضبطها للأمر
`retryAttempts`	`int`: الحد الأقصى لعدد محاولات إعادة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب حدوث استثناء. سيتم عرض DeviceNotResponsiveException إذا تم تنفيذ `retryAttempts` بدون نجاح.
`cmdArgs`	استبدِل `String` بأمر adb والوسيطات التي سيتم تنفيذها.

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

عمليات الطرح
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`
`UnsupportedOperationException`

executeFastbootCommand

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

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`
`UnsupportedOperationException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`
`UnsupportedOperationException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (Map<String, String> envVarMap, 
                String... cmdArgs)

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`
`UnsupportedOperationException`

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,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, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

المعلَمات
`cmd`	‫`String`: أمر adb shell المطلوب تنفيذه
`pipeAsInput`	‫`File`: `File` سيتم نقله كإدخال إلى الأمر، أو قيمة فارغة.
`pipeToOutput`	‫`OutputStream`: `OutputStream` حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة null.
`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)

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

المعلَمات
`cmd`	`String`: الأمر الذي يجب تنفيذه.
`pipeAsInput`	‫`File`: `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, 
                OutputStream pipeToOutput)

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

المعلَمات
`cmd`	`String`: الأمر الذي يجب تنفيذه.
`pipeToOutput`	‫`OutputStream`: `OutputStream` حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة null.

المرتجعات
`CommandResult`	النتيجة باللغة `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`: `File` سيتم نقله كإدخال إلى الأمر، أو قيمة فارغة.
`pipeToOutput`	‫`OutputStream`: `OutputStream` حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة null.
`pipeToError`	‫`OutputStream`: `OutputStream` حيث سيتم إعادة توجيه الخطأ المعياري، أو لا شيء.
`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, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

المعلَمات
`cmd`	‫`String`: أمر adb shell المطلوب تنفيذه
`pipeAsInput`	‫`File`: `File` سيتم نقله كإدخال إلى الأمر، أو قيمة فارغة.
`pipeToOutput`	‫`OutputStream`: `OutputStream` حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة null.
`pipeToError`	‫`OutputStream`: `OutputStream` حيث سيتم إعادة توجيه الخطأ المعياري، أو لا شيء.
`maxTimeoutForCommand`	`long`: الحد الأقصى لمهلة اكتمال الأمر، ويتم تحديد الوحدة كما هو موضّح في `timeUnit`
`maxTimeToOutputShellResponse`	‫`long`: الحد الأقصى للمدة الزمنية التي يُسمح فيها للأمر بعدم عرض أي استجابة، ويتم تحديد الوحدة كما هو موضّح في `timeUnit`
`timeUnit`	`TimeUnit`: وحدة `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: الحد الأقصى لعدد محاولات إعادة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب حدوث استثناء. سيتم عرض DeviceNotResponsiveException إذا تم تنفيذ `retryAttempts` بدون نجاح.

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

عمليات الطرح
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                IShellOutputReceiver receiver)

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

المعلَمات
`cmd`	`String`: الأمر الذي يجب تنفيذه.
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver` لتوجيه ناتج الصدفة المباشر إليه.

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

عمليات الطرح
`DeviceNotAvailableException`

fastbootOemRamdumpNow

public CommandResult fastbootOemRamdumpNow ()

طريقة مساعدة تؤدي إلى تشغيل ramdump من وضع fastboot.

تنفِّذ هذه الطريقة الأمر "oem ramdump now". على عكس ERROR(/#executeFastbootCommand())، لا يحاول هذا الأمر إعادة المحاولة أو استرداد الجهاز إذا تعذّر تنفيذ الأمر أو كانت الحالة غير صالحة، لأنّ النتيجة المقصودة هي تعطُّل الجهاز. من المتوقّع استخدام هذا الخيار عندما يكون الجهاز في وضع Fastboot.

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

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

المعلَمات
`partition`	استبدِل `String` بالقسم المطلوب محوه

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

عمليات الطرح
`DeviceNotAvailableException`

getActiveApexes

public Set<ITestDevice.ApexInfo> getActiveApexes ()

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

المرتجعات
`Set<ITestDevice.ApexInfo>`	`Set` من إجمالي `ApexInfo` بطاقة تم تفعيلها حاليًا على الجهاز

عمليات الطرح
`DeviceNotAvailableException`

getAdbPath

public String getAdbPath ()

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

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

getAllSettings

public Map<String, String> getAllSettings (String namespace)

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

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

المرتجعات
`Map<String, String>`	خريطة أزواج المفتاح/القيمة قيمة فارغة إذا كانت مساحة الاسم غير متاحة.

عمليات الطرح
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

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

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

getAndroidId

public String getAndroidId (int userId)

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

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

القيم المُعادة
`String`

عمليات الطرح
`DeviceNotAvailableException`

getAndroidIds

public Map<Integer, String> getAndroidIds ()

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

المرتجعات
`Map<Integer, String>`	خريطة لأرقام تعريف Android التي تم العثور عليها مطابقة لأرقام تعريف المستخدمين

عمليات الطرح
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

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

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

عمليات الطرح
`DeviceNotAvailableException`

getApiLevelFull

public int getApiLevelFull ()

تشبه getApiLevel()، ولكنها تعرض الإصدار الكامل.

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

عمليات الطرح
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

getAppPackageInfos

public List<PackageInfo> getAppPackageInfos ()

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

المرتجعات
`List<PackageInfo>`	`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 Map<Long, String> getBootHistory ()

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

المرتجعات
`Map<Long, String>`	خريطة لوقت بدء التشغيل (بالتوقيت العالمي المنسّق بالثواني منذ بداية حقبة يونكس) وسبب بدء التشغيل

عمليات الطرح
`DeviceNotAvailableException`

getBootHistorySince

public Map<Long, String> getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

المرتجعات
`Map<Long, String>`	خريطة لوقت بدء التشغيل (بالتوقيت العالمي المنسّق بالثواني منذ بداية حقبة يونكس) وسبب بدء التشغيل

عمليات الطرح
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

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

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

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

عمليات الطرح
`DeviceNotAvailableException`
`UnsupportedOperationException`

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

لا تتوفّر إلا للإصدارات الأحدث من 1.0.36 من "أداة تصحيح أخطاء Android"

المرتجعات
`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 باستخدام مفاتيح اختبار (كما هو الحال في مشروع Android المفتوح المصدر) أو مفاتيح إصدار (يتحكّم فيها مصنّعو الأجهزة الفردية).

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

دالة مساعدة للحصول على فرق الوقت بين الجهاز وقيمة 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`
`UnsupportedOperationException`

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

عمليات الطرح
`DeviceNotAvailableException`
`UnsupportedOperationException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

تعرض هذه السمة الرقم التسلسلي لوضع Fastboot.

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

getFastbootVariable

public String getFastbootVariable (String variableName)

استرداد قيمة متغيّر fastboot المحدّدة من الجهاز

المعلَمات
`variableName`	`String`: اسم المتغيّر

المرتجعات
`String`	قيمة السمة أو `null` إذا لم تكن متوفرة

عمليات الطرح
`DeviceNotAvailableException`
`UnsupportedOperationException`

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 Set<DeviceFoldableState> getFoldableStates ()

تعرض هذه السمة قائمة بحالات الجهاز القابل للطي. يمكن الحصول عليها باستخدام الأمر "cmd device_state print-states".

المرتجعات
`Set<DeviceFoldableState>`

عمليات الطرح
`DeviceNotAvailableException`

getIDevice

public IDevice getIDevice ()

تعرض هذه السمة مرجعًا إلى ddmlib IDevice المرتبط.

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

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

getInstalledPackageNames

public Set<String> getInstalledPackageNames ()

استرجاع أسماء حِزم التطبيقات المتوفّرة على الجهاز

المرتجعات
`Set<String>`	‫`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 إذا كان الجهاز يستجيب حاليًا.

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

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

المرتجعات
`Set<String>`	`Set` من وحدات `String` الرئيسية المثبَّتة حاليًا على الجهاز

عمليات الطرح
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

عمليات الطرح
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported (String userType)

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

المعلَمات
`userType`	‫`String`: نوع المستخدم، كما هو محدّد في UserManager، مثل "android.os.usertype.full.SECONDARY".

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

عمليات الطرح
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

احصل على الحد الأقصى لعدد المستخدمين القابلين للتبديل، باستثناء الضيوف. بعد الإصدار 36 من واجهة برمجة التطبيقات، لا يتضمّن المستخدمين غير القابلين للتبديل (مثل الملفات الشخصية). القيمة التلقائية هي 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: نقل هذا السلوك إلى IDevice.getMountPoint(String)

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

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

getMountPointInfo

public List<ITestDevice.MountPointInfo> getMountPointInfo ()

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

المرتجعات
`List<ITestDevice.MountPointInfo>`	`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`	معرّف المستخدم الأساسي إذا كان هناك مستخدم أساسي، وقيمة فارغة إذا لم يكن هناك مستخدم أساسي

عمليات الطرح
`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`	وضع الاسترداد الحالي المستخدَم للجهاز

getRemainingCreatableUserCount

public int getRemainingCreatableUserCount (String userType)

تعرِض هذه السمة عدد المستخدمين من نوع المستخدم المحدّد الذين يمكن إنشاؤهم على هذا الجهاز.

المعلَمات
`userType`	‫`String`: نوع المستخدم، كما هو محدّد في UserManager، مثل "android.os.usertype.full.SECONDARY".

المرتجعات
`int`	عدد المستخدمين من نوع المستخدم المحدّد الذين يمكن إضافتهم

عمليات الطرح
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

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

المعلَمات
`displayId`	`Long`: المعرّف المعروض للشاشة التي سيتم أخذ لقطة شاشة منها.
`format`	`String`: PNG أو JPEG
`rescale`	‫`boolean`: ما إذا كان يجب إعادة تحجيم لقطة الشاشة لتقليل حجم الصورة الناتجة

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

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

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

المرتجعات
`List<File>`	قائمة بملفات "شواهد القبور"، وتكون فارغة إذا لم يكن هناك أي ملفات.

عمليات الطرح
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

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

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

getTrackingSerial

public String getTrackingSerial ()

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

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

getUninstallablePackageNames

public Set<String> getUninstallablePackageNames ()

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

المرتجعات
`Set<String>`	‫`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 Map<Integer, UserInfo> getUserInfos ()

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

المرتجعات
`Map<Integer, UserInfo>`	قائمة عناصر UserInfo

عمليات الطرح
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

القيم المُعادة
`int`

عمليات الطرح
`DeviceNotAvailableException`

getUserVisibleOnDisplay

public int getUserVisibleOnDisplay (int displayId)

تعرض هذه السمة رقم تعريف المستخدم المرئي على الشاشة المحدّدة.

المعلَمات
`displayId`	‫`int`: رقم تعريف شاشة العرض

المرتجعات
`int`	معرّف المستخدم المرئي على الشاشة المحدّدة. ولا يفرّق بين مستخدم الخلفية المرئي ومستخدم المقدّمة الحالي لأنّ كلا النوعين مرئيان. للتفريق بينهما، قارِنها بنتيجة استدعاء getCurrentUser().

عمليات الطرح
`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, 
                boolean grantPermissions, 
                String... extraArgs)

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

المعلَمات
`packageFile`	‫`File`: ملف APK المطلوب تثبيته
`reinstall`	`boolean`: `true` إذا كان يجب إعادة التثبيت
`grantPermissions`	‫`boolean`: لتحديد ما إذا كان يجب منح جميع أذونات وقت التشغيل عند التثبيت
`extraArgs`	`String`: وسيطات إضافية اختيارية لتمريرها راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.

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

عمليات الطرح
`DeviceNotAvailableException`

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`

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`

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`

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 root على الجهاز

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

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

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

يتحقّق هذا الإجراء أيضًا من config_enableMultiUserUI. بناءً على الطلب، يُسمح لنا بافتراض أنّ الأجهزة التي ينطبق عليها هذا الشرط تم ضبطها للسماح بإضافة مستخدمين ثانويين من خلال أداة adb.

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

isShellV2Support

public boolean isShellV2Support ()

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

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

المرتجعات
`Set<Long>`	قائمة الشاشات تعرض القيمة التلقائية دائمًا القيمة التلقائية 0.

عمليات الطرح
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

المرتجعات
`Set<Integer>`

عمليات الطرح
`DeviceNotAvailableException`

listUsers

public ArrayList<Integer> listUsers ()

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

المرتجعات
`ArrayList<Integer>`	قائمة أرقام تعريف المستخدمين

عمليات الطرح
`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 root وقبل أن يعود الجهاز إلى الاتصال بالإنترنت. لا يتضمّن التنفيذ التلقائي أي إجراءات إضافية، ولا يُضمن تفعيل 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`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId, 
                long timeout)

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

pullFile

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

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

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

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

pullFile

public File pullFile (String remoteFilePath)

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

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

المرتجعات
`File`	قيمة `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)

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

pushDir

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                Set<String> excludedDirectories)

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

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

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

المرتجعات
`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 String reboot (String command, 
                String reason)

يعيد تشغيل الجهاز باستخدام command المحدّد.

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

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

المعلَمات
`command`	‫`String`: الأمر الذي تم تمريره إلى `adb`. لاحظ أنّه يتم تمريره "كما هو"، لذا يعود إلى المتصل توفير علامات الاقتباس المناسبة إذا لزم الأمر (خاصةً إذا كان يحتوي على أجزاء متعددة مفصولة بمسافة).
`reason`	‫`String`: سبب إعادة التشغيل هذه، أو `null` إذا لم يتم تحديد أي سبب.

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

عمليات الطرح
`DeviceNotAvailableException`

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

public void reboot ()

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

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

عمليات الطرح
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

عمليات الطرح
`DeviceNotAvailableException`
`UnsupportedOperationException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

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

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

عمليات الطرح
`DeviceNotAvailableException`
`UnsupportedOperationException`

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, 
                Collection<ITestLifeCycleReceiver> listeners)

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

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

runInstrumentationTests

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

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

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

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

عمليات الطرح
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                Collection<ITestLifeCycleReceiver> listeners)

هي نفسها ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection) ولكنها تجري الاختبار للمستخدم المحدّد.

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

القيم المُعادة
`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)

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

يجب أن يشير معرّف الجهاز الجديد إلى الجهاز الفعلي نفسه الذي تشير إليه المَراجع الحالية. سيتم استدعاء هذه الطريقة إذا خصّصت خدمة 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`
`UnsupportedOperationException`

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 sideload"

المعلَمات
`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, 
                boolean oldShellCommand)

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

المعلَمات
`command`	`String`
`forceExitStatusDetection`	`boolean`
`oldShellCommand`	`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`
`UnsupportedOperationException`

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`

pullFileWithAdbCommand

protected boolean pullFileWithAdbCommand (String remoteFilePath, 
                File localFile, 
                long timeout)

المعلَمات
`remoteFilePath`	`String`
`localFile`	`File`
`timeout`	`long`

القيم المُعادة
`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 (Map<String, String> deviceOptions)

المعلَمات
`deviceOptions`	`Map`

simpleFastbootCommand

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

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

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

القيم المُعادة
`CommandResult`

عمليات الطرح
`UnsupportedOperationException`

simpleFastbootCommand

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

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

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

القيم المُعادة
`CommandResult`

عمليات الطرح
`UnsupportedOperationException`

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

الإجراءات العامة

adbInstallPackage

adbInstallPackage

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkIfNeededWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

connectToWifiNetworkWithResult

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

executeAdbV2Command

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootOemRamdumpNow