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

جهاز NativeDevice

public class NativeDevice
extends Object implements IManagedTestDevice, IConfigurationReceiver, ITestLoggerReceiver

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

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

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

جهاز الاختبار تنفيذ ITestDevice على جهاز Android حزمة كاملة

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

LocalAndroidVirtualDevice وManagedRemoteDevice وNestedRemoteDevice وRemoteAndroidDevice وRemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	فئة الأجهزة الافتراضية المحلية التي تعمل على مضيف TradeFed.
managedRemoteDevice	هو جهاز يعمل داخل آلة افتراضية نديرها عن بُعد من خلال مثيل مقاصد داخل الجهاز الافتراضي (VM).
NestedRemoteDevice	تمثيل للجهاز الذي يعمل داخل جهاز افتراضي لسمكة حبَّار عن بُعد
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 getPro" لكل عنصر.
`boolean`	`canSwitchToHeadlessSystemUser()` تعرض ما إذا كان مسموحًا بالتبديل إلى مستخدم SYSTEM بلا واجهة مستخدم رسومية.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` تحقَّق مما إذا كانت إحدى الميزات متوفّرة حاليًا بالمستوى الأدنى المتاح بها.
`boolean`	`checkConnectivity()` تأكَّد من اتصال الجهاز بالشبكة.
`boolean`	`clearErrorDialogs()` حاول إغلاق أي مربعات حوار تعرض أخطاءً معروضة حاليًا في واجهة مستخدم الجهاز.
`void`	`clearLastConnectedWifiNetwork()` يؤدي هذا الإجراء إلى محو آخر شبكة Wi-Fi متصلة.
`void`	`clearLogcat()` يؤدي هذا الإجراء إلى حذف أي بيانات متراكمة لبيانات Logcat.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` يتصل بشبكة Wi-Fi.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` يتصل بشبكة Wi-Fi.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` الاتصال بشبكة wifi network.f
`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)` طريقة مساعِدة لمعرفة ما إذا كان قد تمت إعادة تشغيل الجهاز بشكل مبدئي من خلال مقارنة System_server الحالي مع System_server `ProcessInfo` السابق
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكل مبدئي منذ التوقيت العالمي المنسَّق (UTC) منذ بدء الجهاز من الجهاز و`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()` يفعِّل جذر الإعلان.
`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 طويل المدى كأمر نظام باستخدام متغيرات بيئة النظام.
`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()` استرجاع المعلومات حول ملفات APK التي تم تفعيلها على الجهاز
	`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()` احصل على مجموعات بث الألعاب الأساسية والمحاكية
`Process`	`getEmulatorProcess()` اعرض `Process` المقابلة لهذا المحاكي.
`final File`	`getExecuteShellCommandLog()` السجلّ الذي يحتوي على جميع سجلّات `executeShellCommand(String)`
`long`	`getExternalStoreFreeSpace()` طريقة مساعد لتحديد مقدار المساحة الخالية على وحدة التخزين الخارجية للجهاز.
`String`	`getFastbootPath()` لعرض مسار البرنامج الثنائي Fastboot المستخدَم.
`String`	`getFastbootProductType()` طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
`String`	`getFastbootProductVariant()` طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
`String`	`getFastbootSerialNumber()` لعرض الرقم التسلسلي لوضع Fastboot (Fastboot mode).
`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()` الحصول على الحد الأقصى لعدد الأجهزة المتوافقة التي تعمل بنظام التشغيل Android في آنٍ واحد
`int`	`getMaxNumberOfUsersSupported()` الحصول على أقصى عدد من المستخدمين المعتمَدين
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` إرجاع `IDeviceStateMonitor` المرتبطة بالجهاز
`String`	`getMountPoint(String mountName)` تعرض نقطة تثبيت.
`ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` لعرض `MountPointInfo` متوافق مع مسار نقطة التثبيت المحدد، أو `null` إذا لم يتم تثبيت أي مسار على هذا المسار أو إذا كان لا يظهر في /proc/أفكارك كنقطة تثبيت.
	`getMountPointInfo()` عرض نسخة محللة من المعلومات في الملف /proc/خاصية التثبيت على الجهاز
`TestDeviceOptions`	`getOptions()` جلب خيارات الاختبار للجهاز
`long`	`getPartitionFreeSpace(String partition)` طريقة مساعِدة لتحديد مقدار المساحة الخالية في قسم الجهاز
`Integer`	`getPrimaryUserId()` تعرض معرّف المستخدم الأساسي.
`ProcessInfo`	`getProcessByName(String processName)` تشغِّل الطريقة المساعدة الأمرَين "pidof" و "stat" وتعرض الكائن `ProcessInfo` باستخدام معرّف PID ووقت بدء العملية المحدّدة.
`String`	`getProcessPid(String process)` تعرض pid للخدمة أو صفرًا إذا حدث خطأ ما.
`String`	`getProductType()` طريقة سهلة للحصول على نوع المنتج لهذا الجهاز
`String`	`getProductVariant()` طريقة سهلة للحصول على نوع المنتج من هذا الجهاز
`String`	`getProperty(String name)` استرِد قيمة السمة المحدّدة من الجهاز.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` يمكنك تفعيل وضع الاسترداد الحالي المستخدَم على الجهاز.
`InputStreamSource`	`getScreenshot(String format)` يحصل على لقطة شاشة من الجهاز.
`InputStreamSource`	`getScreenshot(long displayId)` يحصل على لقطة شاشة من الجهاز الذي تم تقديم رقم تعريف الشاشة فيه.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` يحصل على لقطة شاشة من الجهاز.
`InputStreamSource`	`getScreenshot()` يحصل على لقطة شاشة من الجهاز.
`String`	`getSerialNumber()` طريقة سهلة للحصول على الرقم التسلسلي لهذا الجهاز.
`String`	`getSetting(int userId, String namespace, String key)` عرض قيمة الإعداد المطلوب.
`String`	`getSetting(String namespace, String key)` يمكنك الاطّلاع على `getSetting(int, String, String)` وتنفيذها على مستخدم النظام.
`String`	`getSimOperator()` يمكنك إرجاع مشغل شريحة SIM أو القيمة "فارغة" إذا لم يكن متاحًا أو إذا كان الجهاز غير متاح.
`String`	`getSimState()` يمكنك إرجاع حالة شريحة SIM أو القيمة "فارغة" إذا لم يكن متاحًا أو إذا كان الجهاز غير متاح.
	`getTombstones()` يمكنك استرجاع قائمة ملفات Tombstones وإرجاعها من الأجهزة.
`long`	`getTotalMemory()` عرض إجمالي حجم الذاكرة الفعلية بالبايت أو -1 في حال حدوث خطأ داخلي
	`getUninstallablePackageNames()` جلب أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها.
`boolean`	`getUseFastbootErase()` تعرَّف على ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
`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()` تأكَّد من تثبيت برامج تصحيح الأخطاء.
`boolean`	`isDeviceEncrypted()` يعرض هذا الخيار ما إذا كان الجهاز مشفرًا.
`boolean`	`isDirectory(String path)` يمكنك عرض "صحيح" إذا كان المسار على الجهاز دليلاً وخطأ في الحالات الأخرى.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` يعرض هذا الخيار ما إذا كان التشفير متاحًا على الجهاز.
`boolean`	`isExecutable(String fullPath)` يعرض True إذا كان مسار الملف على الجهاز ملفًا تنفيذيًا، وخطأ في الحالات الأخرى.
`boolean`	`isFastbootEnabled()` يمكنك الرجوع في حال توفّر Fastboot للجهاز.
`boolean`	`isHeadless()` يتم عرض القيمة "صحيح" إذا كان الجهاز بلا واجهة مستخدم رسومية (بدون شاشة)، أو على "خطأ" في الحالات الأخرى.
`boolean`	`isHeadlessSystemUserMode()` يعرض ما إذا كان الجهاز يستخدم وضع مستخدم نظام التشغيل بلا واجهة مستخدم رسومية.
`boolean`	`isMainUserPermanentAdmin()` يعرض ما إذا كان المستخدم الرئيسي مشرفًا دائمًا ولا يمكن حذفه أو الرجوع إلى إصدار سابق من حالة غير مشرف.
`boolean`	`isMultiUserSupported()` يُحدِّد هذا الإعداد ما إذا كانت الميزة متاحة لمستخدمين متعددين.
`boolean`	`isPackageInstalled(String packageName, String userId)` يمكنك إرسال طلب بحث إلى الجهاز عن اسم حزمة معيّن ورقم تعريف مستخدم معيّن لمعرفة ما إذا كان مثبّتًا حاليًا أم لا لهذا المستخدم.
`boolean`	`isPackageInstalled(String packageName)` يمكنك إرسال طلب بحث إلى الجهاز عن اسم حزمة معيّن لمعرفة ما إذا كان مثبّتًا حاليًا أم لا.
`boolean`	`isRuntimePermissionSupported()` التحقّق مما إذا كان النظام الأساسي على الجهاز يتيح منح إذن التشغيل
`boolean`	`isStateBootloaderOrFastbootd()` تعرض القيمة "صحيح" إذا كان الجهاز في `TestDeviceState#FASTBOOT` أو `TestDeviceState.FASTBOOTD`.
`boolean`	`isUserRunning(int userId)` تحقق مما إذا كان مستخدم معين قيد التشغيل.
`boolean`	`isUserSecondary(int userId)` يعرض ما إذا كان المستخدم المحدّد مستخدمًا ثانويًا وفقًا لعلاماته.
`boolean`	`isUserVisible(int userId)` للتحقّق مما إذا كان المستخدم المحدّد مرئيًا
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` يتحقّق مما إذا كان المستخدم المحدّد مرئيًا على الشاشة المحدّدة.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` تعرض ما إذا كان الجهاز يسمح للمستخدمين بالبدء مرئيًا في الخلفية في `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)`.
`boolean`	`isVisibleBackgroundUsersSupported()` يعرض ما إذا كان الجهاز يسمح للمستخدمين بالبدء مرئيًا في الخلفية.
`boolean`	`isWifiEnabled()` اختبِر ما إذا تم تفعيل شبكة Wi-Fi.
	`listDisplayIds()` اجمع قائمة أرقام تعريف الشاشات المتاحة على الجهاز كما تم الإبلاغ عنه من خلال "dumpsys SurfaceFlinger".
	`listDisplayIdsForStartingVisibleBackgroundUsers()` الحصول على قائمة الشاشات التي يمكن استخدامها من أجل `start a user visible in the background`.
	`listUsers()` الحصول على قائمة المستخدمين على الجهاز
`boolean`	`logAnrs(ITestLogger logger)` جمع أخطاء ANR وتسجيلها من الجهاز
`boolean`	`logBugreport(String dataName, ITestLogger listener)` طريقة مساعِدة لتدوين تقرير خطأ وتسجيله للمراسلين الصحفيين
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` سجِّل رسالة في سجلّ الجهاز.
`void`	`mountDebugfs()` حمّل برامج تصحيح الأخطاء.
`void`	`nonBlockingReboot()` تصدر أمرًا بإعادة تشغيل الجهاز وتظهر عند اكتمال الأمر وعندما لا يعود الجهاز مرئيًا لأداة adb.
`void`	`postAdbRootAction()` يمكنك تجاوز هذا الخيار إذا كان الجهاز يحتاج إلى اتخاذ بعض الإجراءات المحدّدة بعد جذر adb وقبل إعادة اتصال الجهاز بالإنترنت.
`void`	`postAdbUnrootAction()` يمكنك تجاوز هذا الإعداد ما إذا كان الجهاز بحاجة إلى اتخاذ بعض الإجراءات المحدّدة بعد إلغاء إذن الوصول إلى الجذر وقبل اتصال الجهاز بالإنترنت مجددًا.
`void`	`postBootSetup()` نفِّذ التعليمات لإعداد الجهاز لاختبار ذلك بعد كل تمهيد.
`void`	`postInvocationTearDown(Throwable exception)` خطوات إضافية للتنظيف المطلوب المتعلق بالجهاز والتي سيتم تنفيذها بعد انتهاء الاستدعاء.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` خطوات إضافية لعملية الإعداد المطلوبة الخاصة بالجهاز والتي سيتم تنفيذها على الجهاز قبل مسار الاستدعاء.
`boolean`	`pullDir(String deviceFilePath, File localDir, 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`	`setUseFastbootErase(boolean useFastbootErase)` يمكنك ضبط ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
`void`	`startLogcat()` ابدأ التقاط مخرجات Logcat من الجهاز في الخلفية.
`boolean`	`startUser(int userId)` لبدء تشغيل مستخدم معيّن في الخلفية إذا كان متوقفًا في الوقت الحالي.
`boolean`	`startUser(int userId, boolean waitFlag)` لبدء تشغيل مستخدم معيّن في الخلفية إذا كان متوقفًا في الوقت الحالي.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` تعمل على بدء تشغيل مستخدِم معيّن في الخلفية، ويكون مرئيًا في الشاشة المعنيّة (أي السماح للمستخدم ببدء الأنشطة في تلك الشاشة).
`void`	`stopEmulatorOutput()` أغلِق نتائج المحاكي واحذفها.
`void`	`stopLogcat()` أوقِف تسجيل مخرجات Logcat من الجهاز، وتجاهَل بيانات Logcat المحفوظة حاليًا.
`boolean`	`stopUser(int userId)` تؤدي هذه السياسة إلى إيقاف مستخدم معيّن.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` إيقاف مستخدم معيّن.
`String`	`switchToAdbTcp()` تبديل الجهاز إلى وضع adb-over-tcp
`boolean`	`switchToAdbUsb()` تبديل الجهاز إلى وضع adb عبر وضع USB.
`boolean`	`switchUser(int userId)` بدِّل إلى userId آخر له مهلة تلقائية.
`boolean`	`switchUser(int userId, long timeout)` يُرجى التبديل إلى userId آخر ضمن المهلة المحدّدة كموعد نهائي.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` يزامن هذا الإعداد محتوى دليل ملفات محلي مع الجهاز بشكل متزايد.
`Bugreport`	`takeBugreport()` يمكنك تسجيل تقرير خطأ وإرجاعه إلى عنصر `Bugreport` لمعالجته.
`String`	`uninstallPackage(String packageName)` إلغاء تثبيت حزمة Android من الجهاز
`String`	`uninstallPackageForUser(String packageName, int userId)` إلغاء تثبيت حزمة Android من الجهاز لمستخدم معيّن.
`boolean`	`unlockDevice()` يؤدي هذا الإجراء إلى فتح قفل الجهاز إذا كان في حالة مشفّرة.
`void`	`unmountDebugfs()` إلغاء تحميل برامج تصحيح الأخطاء
`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)` حظر الجهاز
`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 getbro" أو "Fastboot getvar" استنادًا إلى ما إذا كان الجهاز في Fastboot أم لا.
`boolean`	`isInRebootCallback()` يعرض ما إذا كان يتم حاليًا تنفيذ استدعاءات إعادة التشغيل أم لا.
`boolean`	`isNewer(File localFile, IFileEntry entry)` يمكنك عرض `true` إذا كان الملف المحلي أحدث من الملف البعيد.
`void`	`notifyRebootEnded()` يتم إرسال إشعار إلى جميع `IDeviceActionReceiver` بشأن حدث إنهاء إعادة التشغيل.
`void`	`notifyRebootStarted()` إرسال إشعار إلى كل `IDeviceActionReceiver` بشأن حدث بدء إعادة التشغيل.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` ينفذ إجراءً على هذا الجهاز.
`void`	`postAdbReboot()` الإجراءات الإضافية المحتملة التي يمكن اتخاذها بعد إعادة التشغيل.
`void`	`prePostBootSetup()` تسمح هذه السياسة لكل نوع جهاز (AndroidNativeDevice وTestDevice) بإلغاء هذه الطريقة لعملية إعداد محدّدة بعد التشغيل.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` اضبط مثيل "الساعة" لاستخدامه.
`void`	`setMicrodroidProcess(Process process)` تضع علامة على TestDevice على أنّه ميكروdroid وتضبط الرقم التعريفي للعميل الخاص به.
`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).

الثوابت

معرِّف المستخدم غير الصالح

public static final int INVALID_USER_ID

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

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

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

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

عدد المحاولات: MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

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

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

الحقول

DEBUGFS_PATH

public static final String DEBUGFS_PATH

بطاقة SD_CARD

protected static final String SD_CARD

سعة التخزين_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` للإبلاغ عن تغييرات حالة التخصيص. يمكن تركه فارغًا

الطرق العامة

paymentsPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

مستخدم canSwitchToHeadlessSystem

public boolean canSwitchToHeadlessSystemUser ()

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

الركلات المردودة
`boolean`

الرميات
`DeviceNotAvailableException`

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

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

الرميات
`DeviceNotAvailableException`

التحقق من الاتصال

public boolean checkConnectivity ()

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

الركلات المردودة
`boolean`	`true` إذا كان الجهاز متصلاً بشبكة سليمة، `false` بشكل زائد.

الرميات
`DeviceNotAvailableException`

مربعات حوار clearErrors

public boolean clearErrorDialogs ()

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

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

الرميات
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

يؤدي هذا الإجراء إلى حذف أي بيانات متراكمة لبيانات Logcat.

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

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

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.

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

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

الرميات
`DeviceNotAvailableException`

الاتصال بشبكة Wi-FiNetworkIfبحاج

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

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

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

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

الرميات
`DeviceNotAvailableException`

الاتصال بشبكة Wi-FiNetworkIfبحاج

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

الرميات
`DeviceNotAvailableException`

إنشاء مستخدم

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

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

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

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

الرميات
`DeviceNotAvailableException`

إنشاء مستخدم

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

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

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

حذف الملف

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

الرميات
`DeviceNotAvailableException`

حذف الملف

public void deleteFile (String deviceFilePath)

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

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

الرميات
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

يؤدي هذا الإجراء إلى إزالة IDeviceActionReceiver المسجَّل.

المعلّمات
`deviceActionReceiver`	`IDeviceActionReceiver`: عنصر `IDeviceActionReceiver` ستتم إزالته.

تمت إعادة تشغيل جهاز DeviceSoftLinux.

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

الرميات
`DeviceNotAvailableException`

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

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

الرميات
`DeviceNotAvailableException`

إيقاف AdbRoot

public boolean disableAdbRoot ()

يؤدي هذا الإجراء إلى إيقاف جذر الإعلان.

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

الركلات المردودة
`boolean`	`true` إذا كانت ناجحة.

الرميات
`DeviceNotAvailableException`

إيقاف قفل المفاتيح

public void disableKeyguard ()

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

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

الرميات
`DeviceNotAvailableException`

إيقاف NetworkMonitor

public boolean disableNetworkMonitor ()

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

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

الرميات
`DeviceNotAvailableException`

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

public boolean disconnectFromWifi ()

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

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

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

الرميات
`DeviceNotAvailableException`

ويفعل الملف

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

الركلات المردودة
`boolean`	`true` في حال توفّر الملف، و`false` في الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

ويفعل الملف

public boolean doesFileExist (String deviceFilePath)

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

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

الركلات المردودة
`boolean`	`true` في حال توفّر الملف، و`false` في الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

ملف dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

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

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

الرميات
`DeviceNotAvailableException`

EnableAdbRoot

public boolean enableAdbRoot ()

يفعِّل جذر الإعلان. في حال ضبط الإعداد "enable-root" على "خطأ"، سيتم تسجيل الرسالة وعرضها بدون تفعيل الجذر.

قد يؤدي تفعيل جذر 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 from. `null` في حال تعذُّر تنفيذ الأمر.

الرميات
`DeviceNotAvailableException`

تنفيذ AdbCommand

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

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

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

الركلات المردودة
`String`	الأمر stdout from. `null` في حال تعذُّر تنفيذ الأمر.

الرميات
`DeviceNotAvailableException`

تنفيذ AdbCommand

public String executeAdbCommand (String... cmdArgs)

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

المعلّمات
`cmdArgs`	`String`: أمر adb ووسيطاته المطلوب تشغيلهما

الركلات المردودة
`String`	الأمر stdout from. `null` في حال تعذُّر تنفيذ الأمر.

الرميات
`DeviceNotAvailableException`

تنفيذ FastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

المعلّمات
`cmdArgs`	`String`: أمر Fastboot ووسيطاته المطلوب تشغيلها

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

الرميات
`DeviceNotAvailableException`

تنفيذ FastbootCommand

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

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

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

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

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

الرميات
`DeviceNotAvailableException`

التنفيذ الطويلالسريع التمهيد للأمر

public CommandResult executeLongFastbootCommand (String... cmdArgs)

الطريقة المساعِدة التي تنفّذ أمر Fastboot طويل المدى كأمر نظام

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

المعلّمات
`cmdArgs`	`String`: أمر Fastboot ووسيطاته المطلوب تشغيلها

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

الرميات
`DeviceNotAvailableException`

التنفيذ الطويلالسريع التمهيد للأمر

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

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

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

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

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

الرميات
`DeviceNotAvailableException`

تنفيذ ShellCommand

public String executeShellCommand (String command)

الطريقة المساعدة التي تنفّذ أمر adb Shell وتعرض المخرجات في صورة String

المعلّمات
`command`	`String`: أمر adb Shell الذي سيتم تشغيله

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

الرميات
`DeviceNotAvailableException`

تنفيذ ShellCommand

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

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

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

الرميات
`DeviceNotAvailableException`

تنفيذ ShellCommand

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

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

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

الرميات
`DeviceNotAvailableException`

تنفيذ ShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

تمثّل هذه السمة نموذجًا أبسط من executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) مع القيم التلقائية.

المعلّمات
`command`	`String`: أمر adb Shell الذي سيتم تشغيله
`receiver`	`IShellOutputReceiver`: السمة `IShellOutputReceiver` المطلوب توجيه ناتج واجهة المستخدم إليها.

الرميات
`DeviceNotAvailableException`

أمر executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

المعلّمات
`cmd`	`String`: الأمر الذي يجب تشغيله

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

الرميات
`DeviceNotAvailableException`

أمر executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

المعلّمات
`cmd`	`String`: الأمر الذي يجب تشغيله
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)` حيث ستتم إعادة توجيه إخراج 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`: الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ `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`: الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ `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)` حيث ستتم إعادة توجيه إخراج std، أو حقل فارغ.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)` حيث ستتم إعادة توجيه خطأ ثابت، أو يكون فارغًا.
`maxTimeoutForCommand`	`long`: الحد الأقصى للمهلة المحددة لإكمال الأمر، الوحدة كما هو محدد في `timeUnit`
`timeUnit`	`TimeUnit`: وحدة لـ `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ `retryAttempts` بدون نجاح.

الركلات المردودة
`CommandResult`

الرميات
`DeviceNotAvailableException`

FastbootRemove Partition

public CommandResult fastbootWipePartition (String partition)

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

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

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

المعلّمات
`partition`	`String`: القسم المطلوب حجبه

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

الرميات
`DeviceNotAvailableException`

الحصول على ActiveApexes

public  getActiveApexes ()

استرجاع المعلومات حول ملفات APK التي تم تفعيلها على الجهاز

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

الرميات
`DeviceNotAvailableException`

الحصول على جميع الإعدادات

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`

getAndroidId

public  getAndroidIds ()

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

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

الرميات
`DeviceNotAvailableException`

الحصول على مستوى أعلى

public int getApiLevel ()

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

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

الرميات
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

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

الركلات المردودة
`PackageInfo`	`PackageInfo` أو `null` إذا تعذّر استرداد المعلومات

الرميات
`DeviceNotAvailableException`

getAppPackageInfos (الحصول على AppPackageInfos)

public  getAppPackageInfos ()

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

الركلات المردودة
	تم تثبيت `ERROR(/List)` من أصل `PackageInfo` على الجهاز.

الرميات
`DeviceNotAvailableException`

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

public String getBasebandVersion ()

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

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

الرميات
`DeviceNotAvailableException`

الحصول على البطارية

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

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

الركلات المردودة
	خريطة وقت التشغيل (التوقيت العالمي المنسق (UTC) بالثانية منذ البداية) وسبب التشغيل

الرميات
`DeviceNotAvailableException`

cannot translate

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

الركلات المردودة
	خريطة وقت التشغيل (التوقيت العالمي المنسق (UTC) بالثانية منذ البداية) وسبب التشغيل

الرميات
`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، لعرض قيمة فارغة في حال تعذّر تشغيله.

الحصول على عنوان البريد الإلكتروني البديل

public String getBuildAlias ()

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

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

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

الرميات
`DeviceNotAvailableException`

الحصول على BuildFLAor

public String getBuildFlavor ()

استرداد سمة التصميم للجهاز

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

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

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

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

الحصول على بيانات الجهاز

public long getDeviceDate ()

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

الركلات المردودة
`long`	تاريخ الجهاز بتنسيق الحقبة.

الرميات
`DeviceNotAvailableException`

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

public DeviceDescriptor getDeviceDescriptor ()

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

الركلات المردودة
`DeviceDescriptor`

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

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

الركلات المردودة
`DeviceDescriptor`

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

public TestDeviceState getDeviceState ()

تعرَّف على حالة الجهاز.

الركلات المردودة
`TestDeviceState`

الحصول على DeviceTimeOffset

public long getDeviceTimeOffset (Date date)

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

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

الركلات المردودة
`long`	الفرق بالملي ثانية

الرميات
`DeviceNotAvailableException`

إخراج GetEmulator

public InputStreamSource getEmulatorOutput ()

احصل على مجموعات بث الألعاب الأساسية والمحاكية

الركلات المردودة
`InputStreamSource`	ناتج المحاكي

عملية getEmulatorProcess

public Process getEmulatorProcess ()

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

الركلات المردودة
`Process`	`Process` أو `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

الركلات المردودة
`File`

الحصول على مساحة تخزين خارجية مجانية

public long getExternalStoreFreeSpace ()

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

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

الرميات
`DeviceNotAvailableException`

الطريقة getFastbootPath

public String getFastbootPath ()

لعرض مسار البرنامج الثنائي Fastboot المستخدَم. لا يزال يشترط ضبط السمة isFastbootEnabled() على "صحيح" لتفعيل دوال Fastboot (Fastboot).

الركلات المردودة
`String`

getFastbootProductType

public String getFastbootProductType ()

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

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

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

الرميات
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

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

الركلات المردودة
`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" و "النظام" متوافقة)

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

الرميات
`DeviceNotAvailableException`

إدخال ملف

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

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

الركلات المردودة
`IFileEntry`	ملف FileEntryWrapper الذي يمثل إدخال الملف.

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

الحالات القابلة للطي

public  getFoldableStates ()

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

الركلات المردودة

الرميات
`DeviceNotAvailableException`

الحصول على IDevice

public IDevice getIDevice ()

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

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

الركلات المردودة
`IDevice`	`IDevice`

أسماء الحِزم المُثبّتة

public  getInstalledPackageNames ()

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

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

الرميات
`DeviceNotAvailableException`

موقع getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

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

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

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

الرميات
`DeviceNotAvailableException`

الحصول على عنوان IP

public String getIpAddress ()

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

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

الرميات
`DeviceNotAvailableException`

الحصول على KeyguardState

public KeyguardControllerState getKeyguardState ()

يمكنك إرجاع كائن للحصول على الحالة الحالية لقفل المفاتيح أو القيمة "فارغ" إذا لم يكن الأمر كذلك.

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

الرميات
`DeviceNotAvailableException`

getLastExpectedResetTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

الركلات المردودة
`long`

الحصول على واجهة برمجة التطبيقات getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

الرميات
`DeviceNotAvailableException`

الحصول على

public InputStreamSource getLogcat ()

الحصول على بث موجز لبيانات Logcat

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

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

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

الركلات المردودة
`InputStreamSource`

الحصول على

public InputStreamSource getLogcat (int maxBytes)

يتيح هذا الإعداد الحصول على لقطة شاشة من آخر maxBytes من بيانات Logcat التي تم التقاطها.

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

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

الركلات المردودة
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

لديه عيب أنّه لن يتم إرجاع أي شيء إذا تعذّر الوصول إلى الجهاز.

الركلات المردودة
`InputStreamSource`	`InputStreamSource` لبيانات Logcat. يتم عرض مصدر بيانات فارغ في حال تعذّر التقاط بيانات Logcat.

الحصول على خلفية

public InputStreamSource getLogcatSince (long date)

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

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

الركلات المردودة
`InputStreamSource`

الحصول على MacAddress

public String getMacAddress ()

يعرض عنوان MAC للجهاز، فارغًا في حال تعذّر طلب البحث من الجهاز.

الركلات المردودة
`String`

الحصول على معرّف المستخدم الرئيسي

public Integer getMainUserId ()

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

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

الرميات
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

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

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

الرميات
`DeviceNotAvailableException`

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

public int getMaxNumberOfRunningUsersSupported ()

الحصول على الحد الأقصى لعدد الأجهزة المتوافقة التي تعمل بنظام التشغيل Android في آنٍ واحد وتكون القيم التلقائية 0.

الركلات المردودة
`int`	عدد صحيح يشير إلى عدد حسابات المستخدمين قيد التشغيل في آنٍ واحد

الرميات
`DeviceNotAvailableException`

الحصول على MaxNumberOfUsers مجددًا

public int getMaxNumberOfUsersSupported ()

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

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

الرميات
`DeviceNotAvailableException`

الحصول على ماكروdroidProcess

public Process getMicrodroidProcess ()

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

getMonitor

public IDeviceStateMonitor getMonitor ()

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

الركلات المردودة
`IDeviceStateMonitor`

الحصول على ماونت بوينت

public String getMountPoint (String mountName)

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

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

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

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

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

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

الرميات
`DeviceNotAvailableException`

getMountPointInfo

public  getMountPointInfo ()

عرض نسخة محللة من المعلومات في الملف /proc/خاصية التثبيت على الجهاز

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

الرميات
`DeviceNotAvailableException`

الحصول على خيارات

public TestDeviceOptions getOptions ()

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

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

الحصول على تجزئة FreeSpace

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 (معلومات العملية) المحددة

الرميات
`DeviceNotAvailableException`

أمر getProcessPid

public String getProcessPid (String process)

تعرض pid للخدمة أو صفرًا إذا حدث خطأ ما.

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

الركلات المردودة
`String`

الرميات
`DeviceNotAvailableException`

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

public String getProductType ()

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

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

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

الرميات
`DeviceNotAvailableException`

الحصول على منتج بديل

public String getProductVariant ()

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

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

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

الرميات
`DeviceNotAvailableException`

الحصول على الخاصية

public String getProperty (String name)

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

المعلّمات
`name`	`String`: اسم الموقع

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

الرميات
`DeviceNotAvailableException`

الحصول على وضع الاسترداد

public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

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

public InputStreamSource getScreenshot (String format)

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

المعلّمات
`format`	`String`: يمكن استخدام تنسيقات PNG وJPEG

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

الرميات
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot (long displayId)

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

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

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

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

الرميات
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

الرميات
`DeviceNotAvailableException`

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

public InputStreamSource getScreenshot ()

يحصل على لقطة شاشة من الجهاز.

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

الرميات
`DeviceNotAvailableException`

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

public String getSerialNumber ()

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

الركلات المردودة
`String`	الرقم التسلسلي `String`

الإعداد

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

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

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

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

الرميات
`DeviceNotAvailableException`

الإعداد

public String getSetting (String namespace, 
                String key)

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

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

الركلات المردودة
`String`

الرميات
`DeviceNotAvailableException`

GetSimOperator

public String getSimOperator ()

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

الركلات المردودة
`String`

GetSimState

public String getSimState ()

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

الركلات المردودة
`String`

الحصول على تومبستون

public  getTombstones ()

يمكنك استرجاع قائمة ملفات Tombstones وإرجاعها من الأجهزة. يجب توفّر الجذر.

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

الركلات المردودة
	قائمة بملفات Tombstone، فارغة في حال عدم وجود ملف Tombstone.

الرميات
`DeviceNotAvailableException`

الحصول على إجمالي الذاكرة

public long getTotalMemory ()

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

الركلات المردودة
`long`

الحصول على UninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

الرميات
`DeviceNotAvailableException`

الطريقة getUseFastboot تبيّن

public boolean getUseFastbootErase ()

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

الركلات المردودة
`boolean`	`true` في حال استخدام محو البيانات بشكل سريع أو `false` في حال استخدام تنسيق Fastboot (Fastboot).

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

public int getUserFlags (int userId)

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

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

الركلات المردودة
`int`	العلامات المرتبطة بـ userId المقدم في حال العثور عليه، -10000 في أي حالات أخرى.

الرميات
`DeviceNotAvailableException`

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

public  getUserInfos ()

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

الركلات المردودة
	قائمة كائنات UserInfo.

الرميات
`DeviceNotAvailableException`

الحصول على UserSerialNumber

public int getUserSerialNumber (int userId)

اعرض الرقم التسلسلي المرتبط برقم تعريف المستخدم (userId) إن تم العثور عليه، والذي يبلغ -10000 في أي حالات أخرى.

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

الركلات المردودة
`int`

الرميات
`DeviceNotAvailableException`

HandAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

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

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

الركلات المردودة
`IManagedTestDevice.DeviceEventResponse`

تحتوي على ميزة

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`

غير صالح خاصية ذاكرة التخزين المؤقت

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

الركلات المردودة
`boolean`

الرميات
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

الركلات المردودة
`boolean`

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

public boolean isAppEnumerationSupported ()

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

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

الرميات
`DeviceNotAvailableException`

isBypassLowTargetSdkBlock متوافق

public boolean isBypassLowTargetSdkBlockSupported ()

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

الركلات المردودة
`boolean`	صحيح في حال توفُّر كتلة حزمة SDK منخفضة الهدف، وخطأ في الحالات الأخرى

الرميات
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

تأكَّد من تثبيت برامج تصحيح الأخطاء.

الركلات المردودة
`boolean`	`true` في حال تثبيت برامج تصحيح الأخطاء

الرميات
`DeviceNotAvailableException`

يكون الجهاز مشفّرًا

public boolean isDeviceEncrypted ()

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

الركلات المردودة
`boolean`	`true` إذا كان الجهاز مشفرًا.

الرميات
`DeviceNotAvailableException`

الدليل

public boolean isDirectory (String path)

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

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

الركلات المردودة
`boolean`

الرميات
`DeviceNotAvailableException`

قيمة isEnableAdbRoot

public boolean isEnableAdbRoot ()

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

متوافق مع isEncryption

public boolean isEncryptionSupported ()

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

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

الرميات
`DeviceNotAvailableException`

قابل للتنفيذ

public boolean isExecutable (String fullPath)

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

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

الركلات المردودة
`boolean`

الرميات
`DeviceNotAvailableException`

سياسة isFastbootEnabled

public boolean isFastbootEnabled ()

يمكنك الرجوع في حال توفّر Fastboot للجهاز.

الركلات المردودة
`boolean`

بلا واجهة مستخدم رسومية

public boolean isHeadless ()

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

الركلات المردودة
`boolean`

الرميات
`DeviceNotAvailableException`

isheadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

الركلات المردودة
`boolean`

الرميات
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

الركلات المردودة
`boolean`

الرميات
`DeviceNotAvailableException`

متوافق مع متعدد المستخدمين

public boolean isMultiUserSupported ()

يُحدِّد هذا الإعداد ما إذا كانت الميزة متاحة لمستخدمين متعددين.

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

الرميات
`DeviceNotAvailableException`

تم تثبيت الحزمة

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

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

الرميات
`DeviceNotAvailableException`

تم تثبيت الحزمة

public boolean isPackageInstalled (String packageName)

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

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

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

الرميات
`DeviceNotAvailableException`

isRuntimePermission متوافق

public boolean isRuntimePermissionSupported ()

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

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

الرميات
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

الركلات المردودة
`boolean`

قيد التشغيل

public boolean isUserRunning (int userId)

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

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

الركلات المردودة
`boolean`	True إذا كان المستخدم قيد التشغيل، وfalse في كل الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

مستخدم ثانوي

public boolean isUserSecondary (int userId)

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

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

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

الرميات
`DeviceNotAvailableException`

يكون Userمرئي

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`

متاح

public boolean isVisibleBackgroundUsersSupported ()

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

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

الركلات المردودة
`boolean`

الرميات
`DeviceNotAvailableException`

مع تفعيل Wi-Fi

public boolean isWifiEnabled ()

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

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

الركلات المردودة
`boolean`	`true` إذا تم تفعيل Wi-Fi. `false` إذا تم إيقافها

الرميات
`DeviceNotAvailableException`

أرقام تعريف قائمة العرض

public  listDisplayIds ()

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

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

الرميات
`DeviceNotAvailableException`

listDisplayIdsForOpenVisualUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

الركلات المردودة

الرميات
`DeviceNotAvailableException`

قائمة المستخدمين

public  listUsers ()

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

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

الرميات
`DeviceNotAvailableException`

لوغاريتمات

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`

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

public void nonBlockingReboot ()

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

الرميات
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

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

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

ما بعد AdbUnrootAction

public void postAdbUnrootAction ()

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

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

إعداد postBootSetup

public void postBootSetup ()

نفِّذ التعليمات لإعداد الجهاز لاختبار ذلك بعد كل تمهيد.

يجب طلب البيانات بعد تشغيل الجهاز بالكامل أو توفّره.

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

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

الرميات
`DeviceNotAvailableException`

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

public void postInvocationTearDown (Throwable exception)

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

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

إعداد ما قبل الاستدعاء

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

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

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

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

سحب

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

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

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

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

الرميات
`DeviceNotAvailableException`

سحب

public boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

الرميات
`DeviceNotAvailableException`

ملف سحب

public boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

الرميات
`DeviceNotAvailableException`

ملف سحب

public File pullFile (String remoteFilePath, 
                int userId)

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

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

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

الرميات
`DeviceNotAvailableException`

ملف سحب

public File pullFile (String remoteFilePath)

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

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

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

الرميات
`DeviceNotAvailableException`

ملف سحب

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

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

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

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

الرميات
`DeviceNotAvailableException`

سحب ملف المحتوى

public String pullFileContents (String remoteFilePath)

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

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

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

الرميات
`DeviceNotAvailableException`

سحب ملف من الخارج

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`

مفتاح الدفع

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

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

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

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

الرميات
`DeviceNotAvailableException`

مفتاح الدفع

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

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

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

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

الرميات
`DeviceNotAvailableException`

ملف الدفع

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

خيار pushFile(File, String) الذي يمكن أن يأخذ في الاعتبار تقييم الحاجة إلى موفّر المحتوى.

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

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

الرميات
`DeviceNotAvailableException`

ملف الدفع

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

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

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

الرميات
`DeviceNotAvailableException`

ملف الدفع

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`

إعادة تشغيلفي برنامج التحميل

public void rebootIntoBootloader ()

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

يؤدي هذا الخيار إلى حظر الجهاز إلى أن يكون الجهاز في وضع برنامج الإقلاع.

الرميات
`DeviceNotAvailableException`

إعادة تشغيل IntoFastbootd

public void rebootIntoFastbootd ()

يعيد تشغيل الجهاز في وضع Fastbootd.

يحظر هذا الإعداد وضع الجهاز في وضع Fastbootd.

الرميات
`DeviceNotAvailableException`

إعادة التشغيل في عملية الاسترداد

public void rebootIntoRecovery ()

يعيد تشغيل الجهاز في وضع الاسترداد (Recovery mode) باستخدام adb.

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

الرميات
`DeviceNotAvailableException`

إعادة التشغيل في التحميل الجانبي

public void rebootIntoSideload ()

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

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

الرميات
`DeviceNotAvailableException`

إعادة التشغيل في التحميل الجانبي

public void rebootIntoSideload (boolean autoReboot)

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

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

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

الرميات
`DeviceNotAvailableException`

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

public void rebootUntilOnline ()

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

الرميات
`DeviceNotAvailableException`

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

public void rebootUntilOnline (String reason)

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

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

الرميات
`DeviceNotAvailableException`

إعادة تشغيل مساحة المستخدم

public void rebootUserspace ()

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

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

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

الرميات
`DeviceNotAvailableException`

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

public void rebootUserspaceUntilOnline ()

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

الرميات
`DeviceNotAvailableException`

استرداد الجهاز

public boolean recoverDevice ()

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

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

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

جهاز استقبال عنصر التسجيل

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

إعادة تحميل النظام للقراءة فقط

public void remountSystemReadOnly ()

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

الرميات
`DeviceNotAvailableException`

إعادة تثبيت النظام القابل للكتابة

public void remountSystemWritable ()

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

الرميات
`DeviceNotAvailableException`

إعادة تثبيت المورّدقراءة فقط

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`

إزالة مستخدم

public boolean removeUser (int userId)

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

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

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

الرميات
`DeviceNotAvailableException`

إعادة ضبطContentProviderSetup

public void resetContentProviderSetup ()

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

اختبارات Runالفيديو

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

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

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

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

الرميات
`DeviceNotAvailableException`

اختبارات Runالفيديو

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

الرميات
`DeviceNotAvailableException`

runinstrumentationTestsAUser

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`

runinstrumentationTestsAUser

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`

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

public void setDeviceState (TestDeviceState deviceState)

تغيير حالة الجهاز

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

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

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

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

عملية setEmulatorProcess

public void setEmulatorProcess (Process p)

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

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

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

يمكنك ضبط خيار Fastboot للجهاز. يجب ضبطها عند تخصيص الجهاز لأول مرة.

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

setFastbootPath

public void setFastbootPath (String fastbootPath)

لضبط المسار إلى البرنامج الثنائي Fastboot الذي يجب استخدامه. لا يزال يشترط ضبط السمة isFastbootEnabled() على "صحيح" لتفعيل دوال Fastboot (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`: التأخير بالمللي ثانية

تعيين خيارات

public void setOptions (TestDeviceOptions options)

ضبط TestDeviceOptions للجهاز

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

خاصية set

public boolean setProperty (String propKey, 
                String propValue)

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

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

الركلات المردودة
`boolean`	تعرض الدالة `True` إذا كان الأمر setpr ناجحًا، ويكون False في الحالات الأخرى.

الرميات
`DeviceNotAvailableException`

استعادة البيانات

public void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

ضبط الإعداد

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

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

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

الرميات
`DeviceNotAvailableException`

ضبط الإعداد

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`

setUseFastboot تبيّن

public void setUseFastbootErase (boolean useFastbootErase)

يمكنك ضبط ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.

المعلّمات
`useFastbootErase`	`boolean`: `true` إذا كان يجب استخدام محو بيانات Fastboot أو `false` إذا كان يجب استخدام تنسيق Fastboot.

startLogcat

public void startLogcat ()

ابدأ التقاط مخرجات Logcat من الجهاز في الخلفية.

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

يجب الاتصال بـ "stopLogcat()" إذا لم يعُد الجهاز قيد الاستخدام.

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

مستخدم البدء

public boolean startUser (int userId)

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

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

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

الرميات
`DeviceNotAvailableException`

مستخدم البدء

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

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

الرميات
`DeviceNotAvailableException`

مستخدم خلفية مرئي

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`	true إذا تم إيقاف المستخدم بنجاح.

الرميات
`DeviceNotAvailableException`

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

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

إيقاف مستخدم معيّن. يمكن تقديم علامات إضافية لانتظار تنفيذ العملية، وفرض إغلاق المستخدم. لا يمكن إيقاف المستخدم الحالي والمستخدم الحالي.

المعلّمات
`userId`	`int`: للمستخدم المطلوب إيقافه.
`waitFlag`	`boolean`: سيجعل الأمر ينتظر حتى يتم إيقاف المستخدم.
`forceFlag`	`boolean`: سيتم فرض إيقاف المستخدم.

الركلات المردودة
`boolean`	true إذا تم إيقاف المستخدم بنجاح.

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

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

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

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

الرميات
`DeviceNotAvailableException`

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

public boolean switchUser (int userId, 
                long timeout)

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

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

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

الرميات
`DeviceNotAvailableException`

مزامنة الملفات

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

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

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

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

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

الرميات
`DeviceNotAvailableException`

TakeBugreport

public Bugreport takeBugreport ()

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

الركلات المردودة
`Bugreport`

إلغاء تثبيت الحزمة

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`

فتح قفل الجهاز

public boolean unlockDevice ()

يؤدي هذا الإجراء إلى فتح قفل الجهاز إذا كان في حالة مشفّرة.

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

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

الرميات
`DeviceNotAvailableException`

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

public void unmountDebugfs ()

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

الرميات
`DeviceNotAvailableException`

انتظار ForBootComplete

public boolean waitForBootComplete (long timeOut)

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

المعلّمات
`timeOut`	`long`: الوقت بالميلي ثانية لانتظار ضبط العلامة

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

الرميات
`DeviceNotAvailableException`

انتظار_الجهاز متاح

public boolean waitForDeviceAvailable ()

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

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

الرميات
`DeviceNotAvailableException`

انتظار_الجهاز متاح

public boolean waitForDeviceAvailable (long waitTime)

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

المعلّمات
`waitTime`	`long`: وقت الانتظار بالمللي ثانية

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

الرميات
`DeviceNotAvailableException`

انتظار_الجهاز متاح_في_مسار الاسترداد

public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

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

الركلات المردودة
`boolean`	صحيح في حال توفُّر الجهاز، وخطأ في حال عدم توفّره.

الرميات
`DeviceNotAvailableException`

برنامج setForDeviceBootloader

public void waitForDeviceBootloader ()

يحظر هذا الإعداد ظهور الجهاز عبر Fastboot (Fastboot). استخدام المهلة التلقائية.

الرميات
`DeviceNotAvailableException`

فترة الانتظارForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

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

المعلّمات
`waitTime`	`long`: وقت الانتظار بالمللي ثانية

الركلات المردودة
`boolean`	`true` في حال تم تشغيل الجهاز لعملية الاسترداد قبل انتهاء الوقت. `false` في الحالات الأخرى

فترة الانتظارForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

حظر الجهاز

المعلّمات
`waitTime`	`long`: وقت الانتظار بالمللي ثانية

الركلات المردودة
`boolean`	`true` في حال تم تشغيل الجهاز في التحميل الجانبي قبل انتهاء الوقت. `false` في الحالات الأخرى

فترة الانتظار للجهاز غير متاحة

public boolean waitForDeviceNotAvailable (long waitTime)

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

المعلّمات
`waitTime`	`long`: وقت الانتظار بالمللي ثانية

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

انتظار الجهاز على الإنترنت

public void waitForDeviceOnline ()

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

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

الرميات
`DeviceNotAvailableException`

انتظار الجهاز على الإنترنت

public void waitForDeviceOnline (long waitTime)

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

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

المعلّمات
`waitTime`	`long`: وقت الانتظار بالمللي ثانية

الرميات
`DeviceNotAvailableException`

انتظار ForDeviceShell

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[]`

التحقق من مستوى ApiLevelAst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

المعلّمات
`feature`	`String`
`strictMinLevel`	`int`

إنشاء إعادة تشغيل الجهاز

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

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

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

الركلات المردودة
`NativeDevice.RebootDeviceAction`	`RebootDeviceAction` التي تم إنشاؤها.

createRunUtil.

protected IRunUtil createRunUtil ()

الركلات المردودة
`IRunUtil`

إعادة تشغيل

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

أعِد تشغيل أداة Adb.

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

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

ضمان وقت التشغيل المتاح

protected void ensureRuntimePermissionSupported ()

طريقة مساعدة لطرح استثناء إذا لم يكن إذن التشغيل متاحًا

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

الحصول على ApiLevelSafe

protected int getApiLevelSafe ()

الركلات المردودة
`int`

getLogger

protected ITestLogger getLogger ()

الركلات المردودة
`ITestLogger`

الحصول على RunUtil

protected IRunUtil getRunUtil ()

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

الركلات المردودة
`IRunUtil`

تهيئة الاتصال

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

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

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

الموقع الداخلي

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

استرجاع خاصية الجهاز من ذاكرة التخزين المؤقت ddmlib بشكل تلقائي، ثم الرجوع إلى "adb shell getbro" أو "Fastboot getvar" استنادًا إلى ما إذا كان الجهاز في Fastboot أم لا.

المعلّمات
`propName`	`String`: اسم خاصية الجهاز كما يعرضه `adb shell getrep`
`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`

إخطار إعادة التشغيل

protected void notifyRebootStarted ()

إرسال إشعار إلى كل IDeviceActionReceiver بشأن حدث بدء إعادة التشغيل.

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

تنفيذ الإجراء على الجهاز

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

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

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

الركلات المردودة
`boolean`	`true` إذا تم تنفيذ الإجراء بنجاح

الرميات
`DeviceNotAvailableException`	إذا لم تنجح محاولة الاسترداد أو تم تنفيذ الحد الأقصى لعدد المحاولات بدون النجاح

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

protected void postAdbReboot ()

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

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

إعداد prePostBootSetup

protected void prePostBootSetup ()

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

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

سحب الملف الداخلي

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

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

الركلات المردودة
`boolean`

الرميات
`DeviceNotAvailableException`

ضبط الساعة

protected void setClock (Clock clock)

اضبط مثيل "الساعة" لاستخدامه.

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

عملية ضبط البيانات المجهرية

protected void setMicrodroidProcess (Process process)

تضع علامة على TestDevice على أنّه ميكروdroid وتضبط الرقم التعريفي للعميل الخاص به.

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

فترة الانتظار للجهاز غير متاحة

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

يُرجى الانتظار إلى أن يكون الجهاز غير متاح (يمكنك إيقاف التقارير إلى adb).

المعلّمات
`operationDesc`	`String`: اسم العملية التي تنتظر عدم توفُّرها
`time`	`long`: وقت الانتظار حتى حدوث غير متاح

الركلات المردودة
`boolean`	صحيح إذا أصبح الجهاز غير متاح.

جهاز NativeDevice

الملخّص

الصفوف المتداخلة

الثوابت

الحقول

شركة إنشاءات عامة

الطرق العامة

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

الثوابت

معرِّف المستخدم غير الصالح

MAX_HOST_DEVICE_TIME_OFFSET

عدد المحاولات: MAX_RETRY_ATTEMPTS

الحقول

DEBUGFS_PATH

بطاقة SD_CARD

سعة التخزين_EMULATED

خيارات mOptions

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

شركة إنشاءات عامة

جهاز NativeDevice

الطرق العامة

paymentsPrefetchStartupBuildProps

مستخدم canSwitchToHeadlessSystem

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

التحقق من الاتصال

مربعات حوار clearErrors

clearLastConnectedWifiNetwork

clearLogcat

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

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

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

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

الاتصال بشبكة Wi-FiNetworkIfبحاج

الاتصال بشبكة Wi-FiNetworkIfبحاج

إنشاء مستخدم

إنشاء مستخدم

إنشاء مستخدم

createUserNoThrow

حذف الملف

حذف الملف

deregisterDeviceActionReceiver

تمت إعادة تشغيل جهاز DeviceSoftLinux.

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

إيقاف AdbRoot

إيقاف قفل المفاتيح

إيقاف NetworkMonitor

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

ويفعل الملف

ويفعل الملف

ملف dumpHeap

EnableAdbRoot

EnableNetworkMonitor

تنفيذ AdbCommand

تنفيذ AdbCommand

تنفيذ AdbCommand

تنفيذ FastbootCommand

تنفيذ FastbootCommand

التنفيذ الطويلالسريع التمهيد للأمر

التنفيذ الطويلالسريع التمهيد للأمر

تنفيذ ShellCommand

تنفيذ ShellCommand

تنفيذ ShellCommand

تنفيذ ShellCommand

أمر executeShellV2Command

أمر executeShellV2Command

أمر executeShellV2Command

أمر executeShellV2Command

أمر executeShellV2Command

أمر executeShellV2Command

أمر executeShellV2Command

FastbootRemove Partition

الحصول على ActiveApexes

الحصول على جميع الإعدادات

GetAllocationState

getAndroidId

getAndroidId

الحصول على مستوى أعلى

getAppPackageInfo

getAppPackageInfos (الحصول على AppPackageInfos)

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