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

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	هو جهاز يعمل داخل آلة افتراضية نديرها عن بُعد من خلال مثيل مقاصد داخل الجهاز الافتراضي (VM).
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)` لإعادة تشغيل الجهاز.

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

الحقول
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

وظائف الإنشاء العامة
`NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` لإنشاء `TestDevice`.

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

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

الثوابت

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)

عدد المحاولات: الحد الأقصى

protected static final int MAX_RETRY_ATTEMPTS

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

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

الحقول

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

مراقبة الأجهزة الجوّالة

protected final IDeviceStateMonitor mStateMonitor

وظائف الإنشاء العامة

NativeDevice

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

لإنشاء TestDevice.

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

الطرق العامة

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

التحسين الجزئي (حوالي 400 ملي ثانية) من خلال التحميل المُسبَق لجميع السمات التي نحتاج إليها بدلاً من طلب "adb getprop" لكل منها، أي أنّه يتم جلب جميع السمات بسرعة مماثلة لسرعة جلب سمة واحدة. وتستدعي الميزات مثل device.getApiLevel() وcheckApiLevelAbutstNextRelease وgetBuildAlias أنّ الأمور الأساسية تُسمى "adb getPro" بأساليبها المختلفة. نحصل عليها في مكالمة واحدة ونُجري NativeDevice.setProperty. وحتى إذا لم نفعل ذلك، سيستدعي NativeDevice نفسه setProperty وتخزّن النتيجة مؤقتًا في الطلبات المستقبلية. نحن نفعل ذلك مبكرًا قليلاً. إذا كان الجهاز في وضع الاسترداد أو كانت هناك أخطاء أخرى في جلب الدعائم، سنتجاهلها.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

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

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

تحقق منApiLevelAمقابلstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

المعلمات
`strictMinLevel`	`int`: الحد الأدنى المتشدد المُحتمل الذي يتيح استخدام الميزة.

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

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

checkConnectivity

public boolean checkConnectivity ()

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

المرتجعات
`boolean`	`true` إذا كان الجهاز متصلاً بالشبكة، `false` بخلاف ذلك

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

clearErrorDialogs

public boolean clearErrorDialogs ()

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

المرتجعات
`boolean`	`true` إذا لم تكن هناك مربّعات حوار أو تم محو مربّعات الحوار بنجاح. `false` بخلاف ذلك.

الرميات
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

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

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

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

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

المرتجعات
`boolean`	`true` إذا تم الاتصال بشبكة Wi-Fi بنجاح `false` وإلا

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

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

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

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

المعلمات
`wifiSsid`	`String`: رقم تعريف شبكة Wi-Fi المطلوب الاتصال بها
`wifiPsk`	`String`: عبارة مرور مفتاح PSK أو قيمة فارغة في حال عدم التشفير

المرتجعات
`boolean`	`true` إذا تم الاتصال بشبكة Wi-Fi بنجاح `false` وإلا

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

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

public boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

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

المرتجعات
`boolean`	`true` إذا تم الاتصال بشبكة Wi-Fi بنجاح `false` وإلا

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

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

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

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

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

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

المرتجعات
`boolean`	`true` إذا تم الاتصال بشبكة Wi-Fi بنجاح `false` وإلا

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

connectToWifiNetworkIfNeeded

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

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

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

المرتجعات
`boolean`	`true` إذا تم الاتصال بشبكة Wi-Fi بنجاح `false` وإلا

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

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

المرتجعات
`boolean`	`true` إذا تم الاتصال بشبكة Wi-Fi بنجاح `false` وإلا

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

createUser

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

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

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

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

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

createUser

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

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

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

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

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

إنشاء مستخدم

public int createUser (String name)

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

المعلمات
`name`	`String`: للمستخدم الذي يريد إنشاء حساب على الجهاز

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

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

createUserNoThrow

public int createUserNoThrow (String name)

أنشئ مستخدمًا باسم معيّن وعلامات تلقائية 0.

المعلمات
`name`	`String`: للمستخدم الذي يريد إنشاء حساب على الجهاز

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

الرميات
`DeviceNotAvailableException`

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)

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

المعلمات
`prevSystemServerProcess`	`ProcessInfo`: عملية system_server السابقة `ProcessInfo`.

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

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

تم إعادة تشغيل جهاز DeviceSoftاعتبارًا من

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

الرميات
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

إيقاف إذن الوصول إلى الجذر من خلال adb

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

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

الرميات
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

محاولات لإيقاف حارس المفاتيح.

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

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

disableNetworkMonitor

public boolean disableNetworkMonitor ()

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

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

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

disconnectFromWifi

public boolean disconnectFromWifi ()

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

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

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

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

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

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

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

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

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

enableAdbRoot

public boolean enableAdbRoot ()

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

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

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

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

enableNetworkMonitor

public boolean enableNetworkMonitor ()

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

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

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

تنفيذ AdbCommand

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

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

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

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

المرتجعات
`String`	stdout من الأمر `null` إذا تعذّر تنفيذ الأمر.

الرميات
`DeviceNotAvailableException`

تنفيذ AdbCommand

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

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

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

المرتجعات
`String`	stdout من الأمر `null` إذا تعذّر تنفيذ الأمر.

الرميات
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

المرتجعات
`String`	stdout من الأمر `null` إذا تعذّر تنفيذ الأمر.

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

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

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

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

تنفيذ FastbootCommand

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

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

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

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

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

الرميات
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

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

الرميات
`DeviceNotAvailableException`

executeLongFastbootCommand

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

الطريقة المساعِدة التي تنفّذ أمر Fastboot طويل التشغيل كأمر نظام باستخدام متغيرات بيئة النظام

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

المعلمات
`envVarMap`	: متغيرات بيئة النظام التي يتم استخدامها في أمر Fastboot (Fastboot)
`cmdArgs`	`String`: أمر fastboot والوسيطات المطلوب تنفيذها

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

الرميات
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

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

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

المرتجعات
`String`	إخراج واجهة المستخدم

الرميات
`DeviceNotAvailableException`

executeShellCommand

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

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

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

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

تنفيذ ShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

تنفيذ أمر shell adb المحدَّد، مع إعادة المحاولة عدة مرات في حال تعذّر تنفيذ الأمر

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

المعلمات
`command`	`String`: أمر adb Shell المطلوب تشغيله
`receiver`	‫`IShellOutputReceiver`: `IShellOutputReceiver` لتوجيه إخراج shell إليه.

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

المعلمات
`cmd`	`String`: الأمر الذي يجب تنفيذه.

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

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

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

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

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

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

executeShellV2Command

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

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

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

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

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

executeShellV2Command

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

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

المعلمات
`cmd`	`String`: أمر adb shell المطلوب تنفيذه
`maxTimeoutForCommand`	`long`: الحد الأقصى للمهلة المحددة لإكمال الأمر، الوحدة كما هو محدد في `timeUnit`
`timeUnit`	`TimeUnit`: وحدة لـ `maxTimeToOutputShellResponse`

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

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

executeShellV2Command

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

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

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

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

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

executeShellV2Command

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

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

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

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

الرميات
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

المعلمات
`partition`	`String`: قسم القرص المطلوب محو بياناته

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

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

getActiveApexes

public  getActiveApexes ()

جلب المعلومات عن حسابات APEX التي تم تفعيلها على الجهاز

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

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

getAllSettings

public  getAllSettings (String namespace)

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

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

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

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

getAllocationState

public DeviceAllocationState getAllocationState ()

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

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

getAndroidId

public String getAndroidId (int userId)

العثور على معرّف android المرتبط بمعرّف مستخدم وعرضه، أو عرض قيمة فارغة في حال عدم العثور عليه

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

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

الرميات
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

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

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

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

getApiLevel

public int getApiLevel ()

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

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

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

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

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

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

getAppPackageInfos

public  getAppPackageInfos ()

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

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

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

الحصول على الإصدار الأساسي للنطاق

public String getBasebandVersion ()

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

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

الرميات
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

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

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

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

لعرض القيمة المنطقية للسمة المحدّدة.

المعلمات
`name`	`String`: اسم الموقع
`defaultValue`	‫`boolean`: القيمة التلقائية التي يتم عرضها إذا كانت السمة فارغة أو غير متوفّرة

المرتجعات
`boolean`	`true` إذا كانت قيمة السمة `"1"` أو `"y"` أو `"yes"` أو `"on"` أو `"true"` أو `false` إذا كانت قيمتها `"0"` أو `"n"` أو `"no"` أو `"off"` أو `"false"` أو `defaultValue` بخلاف ذلك.

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

getBootHistory

public  getBootHistory ()

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

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

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

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

getBootloaderVersion

public String getBootloaderVersion ()

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

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

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

الرميات
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

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

يضمن تنفيذ هذا الإجراء استمرار العمل على جهاز بدون بطاقة SD (أو لم يتم تثبيت بطاقة sdcard بعد).

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

getBugreportz

public InputStreamSource getBugreportz ()

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

لا تتوفّر هذه الميزة إلا لإصدار "adb" الأحدث من 1.0.36.

المرتجعات
`InputStreamSource`	`InputStreamSource` من ملف ZIP الذي يحتوي على Bugreportz، لعرض قيمة فارغة في حال تعذّر تشغيله.

getBuildAlias

public String getBuildAlias ()

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

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

المرتجعات
`String`	الاسم المستعار للإصدار أو الرجوع إلى معرّف الإصدار إذا تعذر استرداده

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

getBuildFlavor

public String getBuildFlavor ()

استرداد نوع الإصدار للجهاز

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

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

getBuildId

public String getBuildId ()

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

المرتجعات
`String`	رقم تعريف الإصدار أو `IBuildInfo#UNKNOWN_BUILD_ID` إذا تعذّر استرجاعه

الرميات
`DeviceNotAvailableException`

الحصول على عناصر توقيع المفاتيح

public String getBuildSigningKeys ()

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

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

المرتجعات
`String`	مفتاح التوقيع إذا تم العثور عليه، وقيمة فارغة بخلاف ذلك

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

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

تعرِض هذه السمة قيمة DeviceDescriptor المخزّنة مؤقتًا في حال تم تخصيص الجهاز، وتعرِض DeviceDescriptor الحالية في حال عدم تخصيص الجهاز.

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

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

الحصول على أطفال

public String[] getChildren (String path)

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

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

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

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

الحصول على الاتصال

public AbstractConnection getConnection ()

عملية الربط الحالية المرتبطة بالجهاز

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

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

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

المعلمات
`userId`	`int`: رقم تعريف المستخدم المطلوب إعداد موفّر المحتوى له

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

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

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

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

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

الحصول على المستخدم الحالي

public int getCurrentUser ()

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

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

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

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

public String getDeviceClass ()

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

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

getDeviceDate

public long getDeviceDate ()

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

المرتجعات
`long`	تاريخ الجهاز بتنسيق بدء الفترة

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

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

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

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

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

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

public TestDeviceState getDeviceState ()

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

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

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

المساعدة في معرفة الفارق الزمني بين الجهاز وجهاز ERROR(/Date) معيّن استخدِم التنسيق Epoch time داخليًا.

المعلمات
`date`	`Date`

المرتجعات
`long`	الفرق بالملي ثانية

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

إخراج getEmulator

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

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

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

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

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

getFastbootSerialNumber

public String getFastbootSerialNumber ()

لعرض الرقم التسلسلي لوضع Fastboot (Fastboot mode).

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

getFastbootVariable

public String getFastbootVariable (String variableName)

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

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

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

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

getFastbootVersion

public String getFastbootVersion ()

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

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

إدخال ملف

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`	عنصر FileEntryWrapper يمثّل FileEntry

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

getFoldableStates

public  getFoldableStates ()

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

المرتجعات

الرميات
`DeviceNotAvailableException`

الحصول على IDevice

public IDevice getIDevice ()

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

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

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

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

الرميات
`DeviceNotAvailableException`

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

لعرض القيمة الصحيحة للسمة المحدّدة من الجهاز.

المعلمات
`name`	`String`: اسم السمة
`defaultValue`	‫`long`: القيمة التلقائية التي يتم عرضها إذا كانت السمة فارغة أو غير متوفّرة

المرتجعات
`long`	قيمة السمة أو `defaultValue` إذا كانت السمة فارغة أو غير متوفّرة أو لا تحتوي على قيمة عددية

الرميات
`DeviceNotAvailableException`

getIpAddress

public String getIpAddress ()

الحصول على عنوان IP للجهاز

المرتجعات
`String`	عنوان IP للجهاز، أو `null` إذا لم يكن للجهاز عنوان IP.

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

getKeyguardState

public KeyguardControllerState getKeyguardState ()

عرض عنصر للحصول على الحالة الحالية لقفل الشاشة أو عرض قيمة فارغة إذا لم يكن متاحًا

المرتجعات
`KeyguardControllerState`	`KeyguardControllerState` يحتوي على لقطة شاشة لحالة شاشة القفل ويعرض القيمة Null إذا لم يكن طلب البحث عن شاشة القفل متوافقًا.

الرميات
`DeviceNotAvailableException`

getLastExpectedupgradeTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

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

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

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

getLogcat

public InputStreamSource getLogcat ()

تلتقط هذه الأداة لقطة سريعة لبيانات logcat.

يعمل هذا الإجراء بطريقتَين:

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

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

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

getLogcat

public InputStreamSource getLogcat (int maxBytes)

تلتقط هذه الأداة لقطة من آخر maxBytes من بيانات logcat التي تم تسجيلها.

ويتوفّر هذا الخيار في الحالات التي تريد فيها الحصول على لقطات متكرّرة من بيانات Logcat التي تم الحصول عليها، وذلك بدون تحمُّل عقوبة قد تترتّب على الحصول على لقطة getLogcat() كاملةً في مساحة القرص الكبيرة.

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

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

getLogcatDump

public InputStreamSource getLogcatDump ()

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

يتمثل عُدم التوافق في أنّه لن يتم عرض أي معلومات إذا لم يكن بالإمكان الوصول إلى الجهاز.

المرتجعات
`InputStreamSource`	`InputStreamSource` من بيانات logcat يتم عرض مصدر بيانات فارغ في حال تعذّر تسجيل بيانات logcat.

getLogcatSince

public InputStreamSource getLogcatSince (long date)

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

المعلمات
`date`	‫`long`: بالملي ثانية منذ تاريخ بدء حساب الفترة، وهو وقت بدء اللقطة حتى الوقت الحالي (يمكن الحصول عليه باستخدام "date +%s")

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

getMacAddress

public String getMacAddress ()

تعرِض هذه السمة عنوان MAC للجهاز، وتكون قيمة هذه السمة فارغة إذا تعذّر إجراء طلب بحث من الجهاز.

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

getMainUserId

public Integer getMainUserId ()

تعرِض هذه السمة رقم تعريف المستخدم الرئيسي.

المرتجعات
`Integer`	userId للمستخدم الرئيسي إن وجد، وقيمة فارغة إذا لم يكن هناك مستخدم رئيسي.

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

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

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

الحصول على الحد الأقصى لعدد مستخدمي التطبيق المتوافق

public int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

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

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

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

getMicrodroidProcess

public Process getMicrodroidProcess ()

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

getMonitor

public IDeviceStateMonitor getMonitor ()

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

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

getMountPoint

public String getMountPoint (String mountName)

لعرض نقطة تثبيت.

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

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

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

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

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

getMountPointInfo

public  getMountPointInfo ()

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

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

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

getOptions

public TestDeviceOptions getOptions ()

استرجاع خيارات الاختبار للجهاز

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

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

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

المعلمات
`partition`	`String`

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

الرميات
`DeviceNotAvailableException`

getPrimaryUserId

public Integer getPrimaryUserId ()

تعرض معرّف المستخدم الأساسي.

المرتجعات
`Integer`	userId للمستخدم الأساسي إذا كان هناك مستخدم أساسي، وقيمة فارغة إذا لم يكن هناك مستخدم أساسي

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

GetProcessByName

public ProcessInfo getProcessByName (String processName)

تشغِّل الطريقة المساعدة الأمرَين "pidof" و"stat" وتعرض الكائن ProcessInfo باستخدام معرّف PID ووقت بدء العملية المحدّدة.

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

المرتجعات
`ProcessInfo`	ProcessInfo من processName المحدّد

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

getProcessPid

public String getProcessPid (String process)

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

المعلمات
`process`	`String`: سلسلة اسم العملية

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

الرميات
`DeviceNotAvailableException`

الحصول على نوع المنتج

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

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

public InputStreamSource getScreenshot (long displayId)

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

قائمة المهام: توسيع عمليات التنفيذ أعلاه لدعم 'format' و'rescale'

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

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

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

getScreenshot

public InputStreamSource getScreenshot (String format)

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

المعلمات
`format`	`String`: تنسيقات PNG وJPEG المتوافقة

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

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

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

المرتجعات
`InputStreamSource`	`InputStreamSource` من لقطة الشاشة بتنسيق png أو `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`	القيمة المرتبطة بـ namespace:key الخاصة بمستخدم قيمة فارغة إذا لم يتم العثور على القيمة

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

getSetting

public String getSetting (String namespace, 
                String key)

راجِع getSetting(int, String, String) ونفِّذ الإجراء على مستخدم النظام.

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

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

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

getSimOperator

public String getSimOperator ()

أدخِل مشغّل شريحة SIM أو 0 إذا لم يكن متاحًا أو إذا لم يكن الجهاز متاحًا.

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

getSimState

public String getSimState ()

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

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

getTombstones

public  getTombstones ()

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

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

المرتجعات
	قائمة بملفات Tombstone فارغة إذا لم يتم العثور على علامة ضريح.

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

getTotalMemory

public long getTotalMemory ()

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

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

الحصول علىتتبُّع الرقم التسلسلي

public String getTrackingSerial ()

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

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

getUninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

الرميات
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

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

المرتجعات
`boolean`	`true` إذا كان سيتم استخدام ميزة "محو البيانات" من خلال Fastboot أو `false` إذا كان سيتم استخدام ميزة "تنسيق الجهاز" من خلال Fastboot

الحصول على علامات المستخدم

public int getUserFlags (int userId)

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

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

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

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

الحصول على معلومات المستخدم

public  getUserInfos ()

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

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

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

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

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

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

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

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

عالج حدث DeviceEvent الذي قد يؤدي إلى نقل هذا الجهاز إلى حالة تخصيص جديدة أو لا يؤدي إلى ذلك.

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

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

hasFeature

public boolean hasFeature (String feature)

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

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

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

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

installPackage

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

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

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

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

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

installPackage

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

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

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

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

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

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

installPackageForUser

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

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

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

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

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

installPackageForUser

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

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

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

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

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

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

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

الرميات
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

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

متوافق مع عبارة isAppEnumeration

public boolean isAppEnumerationSupported ()

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

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

الرميات
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public boolean isBypassLowTargetSdkBlockSupported ()

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

المرتجعات
`boolean`	صحيح إذا كان من الممكن تجاوز حظر حزمة تطوير البرامج المخصّصة للأجهزة ذات الإصدارات القديمة، خطأ بخلاف ذلك

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

isDebugfsMounted

public boolean isDebugfsMounted ()

تحقَّق مما إذا كان قد تم تركيب debugfs.

المرتجعات
`boolean`	`true` في حال تركيب debugfs

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

isDeviceEncrypted

public boolean isDeviceEncrypted ()

يعرض هذا الخيار ما إذا كان الجهاز مشفرًا.

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

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

isDirectory

public boolean isDirectory (String path)

عرض True إذا كان المسار على الجهاز دليلاً، وعرض False في غير ذلك

المعلمات
`path`	`String`

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

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

isEnableAdbRoot

public boolean isEnableAdbRoot ()

المرتجعات
`boolean`	`true` إذا كان يجب تفعيل إذن الوصول إلى الجذر من adb على الجهاز

isEncryptionSupported

public boolean isEncryptionSupported ()

يعرض ما إذا كان التشفير متاحًا على الجهاز.

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

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

قابل للتنفيذ

public boolean isExecutable (String fullPath)

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

المعلمات
`fullPath`	`String`

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

الرميات
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

يُرجى الرجوع إذا كان وضع Fastboot متاحًا للجهاز.

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

isHeadless

public boolean isHeadless ()

عرض true إذا كان الجهاز غير مزوّد بشاشة (بدون شاشة)، وعرض false في الحالات الأخرى

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

الرميات
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

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

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

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

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

الرميات
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

لتحديد ما إذا كان استخدام حسابات متعدّدة مسموحًا به

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

الرميات
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

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

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

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

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

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

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

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

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

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

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

تعرِض هذه الدالة القيمة true إذا كان الجهاز في وضع TestDeviceState#FASTBOOT أو TestDeviceState.FASTBOOTD.

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

isUserRunning

public boolean isUserRunning (int userId)

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

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

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

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

مستخدم ثانوي

public boolean isUserSecondary (int userId)

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

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

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

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

isUserVisible

public boolean isUserVisible (int userId)

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

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

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

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

الرميات
`DeviceNotAvailableException`

isUserمرئيOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

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

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

متاح

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

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

الرميات
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

في هذه الحالة، يمكنك الاتصال بـ startVisibleBackgroundUser(int, int, boolean) لتمرير شاشة يتم عرضها بواسطة listDisplayIdsForStartingVisibleBackgroundUsers().

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

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

isWifiEnabled

public boolean isWifiEnabled ()

اختبِر ما إذا تم تفعيل شبكة Wi-Fi.

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

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

الرميات
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

جمع قائمة أرقام تعريف الشاشات المتاحة على الجهاز كما هو موضّح في "dumpsys SurfaceFlinger"

المرتجعات
	قائمة الشاشات يُرجع الإعداد التلقائي دائمًا قيمة العرض التلقائي 0.

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

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

المرتجعات

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

listUsers

public  listUsers ()

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

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

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

logAnrs

public boolean logAnrs (ITestLogger logger)

يتم جمع أخطاء ANR وتسجيلها من الجهاز.

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

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

الرميات
`DeviceNotAvailableException`

LogBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

طريقة مساعدة لإنشاء تقرير خطأ وتسجيله لدى المُبلِغين

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

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

تسجيل على الجهاز

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

سجِّل رسالة في سجلّ الجهاز. هذه مكالمة آمنة لن يتم طرحها حتى في حال تعطُّل التسجيل.

المعلمات
`tag`	‫`String`: العلامة التي نُسجِّل رسالتنا ضِمنها في logcat
`level`	`Log.LogLevel`: مستوى تصحيح الأخطاء للرسالة في logcat
`format`	`String`: تنسيق الرسالة
`args`	`Object`: الوسيطات المراد استبدالها من خلال String.format().

إصلاح الأخطاء

public void mountDebugfs ()

حمّل برامج تصحيح الأخطاء.

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

nonBlockingReboot

public void nonBlockingReboot ()

يُصدر الأمر لإعادة تشغيل الجهاز ويعود عند اكتمال الأمر وعندما لا يعود الجهاز مرئيًا لـ adb.

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

postAdbRootAction

public void postAdbRootAction ()

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

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

postAdbUnrootAction

public void postAdbUnrootAction ()

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

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

postBootSetup

public void postBootSetup ()

اتّبِع التعليمات لضبط الجهاز للاختبار بعد كل عملية تشغيل.

يجب استدعاء هذه الوظيفة بعد تشغيل الجهاز بالكامل أو بعد أن يصبح متاحًا.

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

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

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

سلسلة إجراءات ما بعد الاستدعاء

public void postInvocationTearDown (Throwable exception)

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

المعلمات
`exception`	`Throwable`: الاستثناء النهائي الذي تمّ طرحه بسبب تعذُّر الاستدعاء، إن توفّر.

preInvocationSetup

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

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

المعلمات
`info`	`IBuildInfo`: `IBuildInfo` الجهاز
`attributes`	`MultiMap`: السمات المخزّنة في سياق الاستدعاء

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

pullDir

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

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

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

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

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

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

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

pullFile

public boolean pullFile (String remoteFilePath, 
                File localFile)

استرداد ملف من الجهاز

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

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

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

pullFile

public File pullFile (String remoteFilePath, 
                int userId)

استرداد ملف من الجهاز وتخزينه في ERROR(/File) مؤقت على الجهاز، ثم عرضFile

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

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

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

pullFile

public File pullFile (String remoteFilePath)

استرداد ملف من الجهاز وتخزينه في ERROR(/File) مؤقت على الجهاز، ثم عرضFile

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

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

الرميات
`DeviceNotAvailableException`

pullFile

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

استرداد ملف من الجهاز

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

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

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

pullFileContents

public String pullFileContents (String remoteFilePath)

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

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

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

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

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

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

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

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

الرميات
`DeviceNotAvailableException`

مفتاح الدفع

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

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

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

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

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

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

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

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

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

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

pushDir

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

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

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

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

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

pushFile

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

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

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

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

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

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

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

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

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

pushFile

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

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

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

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

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

PushString

public boolean pushString (String contents, 
                String remoteFilePath)

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

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

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

الرميات
`DeviceNotAvailableException`

إعادة تشغيل

public void reboot (String reason)

تعيد تشغيل الجهاز في وضع adb باستخدام reason المحدَّد ليتم الاحتفاظ به أثناء إعادة التشغيل.

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

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

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

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

إعادة تشغيل

public void reboot ()

تؤدي هذه العملية إلى إعادة تشغيل الجهاز في وضع adb.

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

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

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

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

rebootIntoFastbootd

public void rebootIntoFastbootd ()

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

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

الرميات
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

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

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

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

rebootIntoSideload

public void rebootIntoSideload ()

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

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

الرميات
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

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

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

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

rebootUntilOnline

public void rebootUntilOnline ()

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

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

إعادة التشغيل حتى الإنترنت

public void rebootUntilOnline (String reason)

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

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

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

rebootUserspace

public void rebootUserspace ()

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

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

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

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

إعادة تشغيلUserspace حتى الإنترنت

public void rebootUserspaceUntilOnline ()

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

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

إعادة تركيب البائع

public void remountVendorWritable ()

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

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

إزالة مسؤول

public boolean removeAdmin (String componentName, 
                int userId)

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

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

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

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

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

public void removeOwners ()

يُرجى إزالة جميع مالكي الملفات الشخصية الحالية للأجهزة بأفضل ما يمكن.

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

removeUser

public boolean removeUser (int userId)

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

المعلمات
`userId`	`int`: للمستخدِم المطلوب إزالته

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

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

resetContentProviderSetup

public void resetContentProviderSetup ()

عليك إعادة ضبط علامة إعداد مقدّم المحتوى لتفعيلها مرة أخرى.

runInstrumentationTests

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

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

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

المرتجعات
`boolean`	`true` في حال اكتمال الأمر التجريبي. `false` في حال تعذّر اكتمالها، ولكن تم استردادها بنجاح

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

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

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

runInstrumentationTestsAsUser

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

يُعدّ هذا الإجراء مماثلاً للإجراء ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))، ولكن يُجري الاختبار للمستخدم المحدّد.

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

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

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

runInstrumentationTestsAsUser

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

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

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

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

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

ضبط الإعدادات

public void setConfiguration (IConfiguration configuration)

تحقِّق من استخدام IConfiguration.

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

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

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

تاريخ الضبط

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)

اضبط خيار "التشغيل السريع" للجهاز. يجب ضبطه عند تخصيص الجهاز لأول مرة.

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

setFastbootPath

public void setFastbootPath (String fastbootPath)

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

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

setIDevice

public void setIDevice (IDevice newDevice)

يُرجى تحديث IDevice المرتبط بـ ITestDevice هذا.

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

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

ضبط مسجِّل الاختبار

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 أو `false` إذا كان يجب استخدام تنسيق Fastboot.

startLogcat

public void startLogcat ()

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

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

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

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

مستخدم البدء

public boolean startUser (int userId)

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

المعلمات
`userId`	`int`: للمستخدم للبدء في الخلفية

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

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

مستخدم البدء

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

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

startVisibleBackgroundUser

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

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

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

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

المرتجعات
`boolean`	`true` في حال بدء تشغيل حساب المستخدم بنجاح في الخلفية.

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

جهاز إيقاف المحاكي

public void stopEmulatorOutput ()

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

إيقاف Logcat

public void stopLogcat ()

توقِف تسجيل بيانات logcat من الجهاز، وبذِل بيانات logcat المحفوظة حاليًا.

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

إيقاف المستخدم

public boolean stopUser (int userId)

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

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

مبدِّل المستخدِم

public boolean switchUser (int userId)

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

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

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

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

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

المعلمات
`userId`	`int`
`timeout`	`long`: يجب الانتظار قبل عرض الخطأ "خطأ" لتعذُّر تغيير المستخدم.

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

إلغاء تثبيت PackageForUser

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`

إلغاء تصحيح الأخطاء

public void unmountDebugfs ()

إلغاء تحميل برامج تصحيح الأخطاء

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

انتظار ForBootComplete

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`

انتظار_الجهاز متاح_ضمن_مسار_استرداد الحساب

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

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

الرميات
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

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

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

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

المعلمات
`waitTime`	‫`long`: المدة بالملي ثانية للانتظار

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

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

حظر الجهاز

المعلمات
`waitTime`	‫`long`: المدة بالملي ثانية للانتظار

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

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

قوالب عدم توفُّر الجهاز، أي أنّه غير متوفّر في adb

المعلمات
`waitTime`	‫`long`: المدة بالملي ثانية للانتظار

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

waitForDeviceOnline

public void waitForDeviceOnline ()

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

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

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

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb.

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

المعلمات
`waitTime`	‫`long`: المدة بالملي ثانية للانتظار

الرميات
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

ينتظر حتى يستجيب الجهاز لأمر أساسي في واجهة برمجة التطبيقات adb shell.

المعلمات
`waitTime`	‫`long`: المدة بالملي ثانية للانتظار

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

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

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

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

buildAdbShellCommand

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

إنشاء أمر نظام التشغيل لجلسة ووسائط أمر adb shell المحدّدة

المعلمات
`command`	`String`
`forceExitStatusDetection`	`boolean`

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

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

المعلمات
`feature`	`String`
`strictMinLevel`	`int`

createRebootDeviceAction

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

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

المعلمات
`rebootMode`	`NativeDevice.RebootMode`: أحد أوضاع إعادة التشغيل هذه.
`reason`	`String`: لإجراء عملية إعادة التشغيل هذه.

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

createRunUtil

protected IRunUtil createRunUtil ()

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

doAdbReboot

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

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

المعلمات
`rebootMode`	`NativeDevice.RebootMode`: أحد أوضاع إعادة التشغيل هذه.
`reason`	`String`: لإجراء عملية إعادة التشغيل هذه.

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

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

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

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

الحصول على ApiLevelSafe

protected int getApiLevelSafe ()

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

getLogger

protected ITestLogger getLogger ()

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

getRunUtil

protected IRunUtil getRunUtil ()

احصل على نسخة RunUtil لاستخدامها.

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

initializeConnection

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

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

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

internalGetProperty

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

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

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

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

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

عبارة إعادة تشغيل الاتصال

protected boolean isInRebootCallback ()

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

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

أحدث

protected boolean isNewer (File localFile, 
                IFileEntry entry)

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

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

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

ارسال الارسال

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

postAdbReboot

protected void postAdbReboot ()

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

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

prePostBootSetup

protected void prePostBootSetup ()

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

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

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

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

الرميات
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

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

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

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

يضع علامة على TestDevice باعتباره microdroid ويضبط رقم تعريفه.

المعلمات
`process`	`Process`: عملية تشغيل آلة Microdroid الافتراضية

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

المعلمات
`deviceOptions`

أمر SimpleFastbootCommand

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

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

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

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

simpleFastbootCommand

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

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

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

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

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

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

المعلمات
`operationDesc`	`String`: اسم العملية التي في انتظار اكتمالها غير متاح.
`time`	`long`: مدة الانتظار إلى أن يحدث الحدث "غير متوفّر"

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

NativeDevice

ملخّص

الفئات المُدمجة

الثوابت

الحقول

وظائف الإنشاء العامة

الطرق العامة

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

الثوابت

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

عدد المحاولات: الحد الأقصى

الحقول

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

mOptions

مراقبة الأجهزة الجوّالة

وظائف الإنشاء العامة

NativeDevice

الطرق العامة

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

تحقق منApiLevelAمقابلstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

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

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

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

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

إنشاء مستخدم

createUserNoThrow

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

تم إعادة تشغيل جهاز DeviceSoftاعتبارًا من

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

تنفيذ AdbCommand

تنفيذ AdbCommand

executeAdbCommand

executeFastbootCommand

تنفيذ FastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

تنفيذ ShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos

الحصول على الإصدار الأساسي للنطاق