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

جهاز NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

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

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

جهاز الاختبار تنفيذ ITestDevice لجهاز Android المكدّس بالحزمة الكاملة

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

LocalAndroidVirtualDevice وManagedRemoteDevice وNestedRemoteDevice وRemoteAndroidDevice وRemoteAndroidVirtualDevice

LocalAndroidVirtualDevice	فئة الأجهزة الافتراضية المحلية التي تعمل على مضيف TradeFed.
managedRemoteDevice	يشير هذا المصطلح إلى جهاز يعمل داخل آلة افتراضية نديرها عن بُعد من خلال مثيل مقابس داخلها على جهاز افتراضي.
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" الحصول على لكل منها.
`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)` طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكلٍ مبدئي منذ التوقيت العالمي المنسَّق منذ بدء حساب الفترة الجهاز و`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 في حال حدوث خطأ داخلي
`String`	`getTrackingSerial()` لأغراض إدارة الجهاز، احصل على الرقم التسلسلي المستخدَم لتتبُّع الجهاز.
	`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()` يمكنك تجاوز ما إذا كان الجهاز يحتاج إلى اتخاذ بعض الإجراءات المحددة بعد adb unroot وقبل اتصال الجهاز بالإنترنت مرة أخرى.
`void`	`postBootSetup()` نفِّذ التعليمات لإعداد الجهاز لاختبار ذلك بعد كل تمهيد.
`void`	`postInvocationTearDown(Throwable exception)` خطوات إضافية سيتم تنفيذها بعد الاستدعاء والتنظيف المطلوب المتعلق بالجهاز .
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` خطوات إضافية للإعداد المطلوب المحدد للجهاز والذي سيتم تنفيذه على الجهاز قبل تدفق الاستدعاء.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` سحب محتوى الدليل من الجهاز بشكل متكرر
`boolean`	`pullDir(String deviceFilePath, File localDir)` سحب محتوى الدليل من الجهاز بشكل متكرر
`boolean`	`pullFile(String remoteFilePath, File localFile)` لاسترداد ملف من الجهاز.
`File`	`pullFile(String remoteFilePath, int userId)` استرداد ملف من الجهاز وتخزينه في `ERROR(/File)` مؤقت محلي، وإرجاعه `File`
`File`	`pullFile(String remoteFilePath)` استرداد ملف من الجهاز وتخزينه في `ERROR(/File)` مؤقت محلي، وإرجاعه `File`
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` لاسترداد ملف من الجهاز.
`String`	`pullFileContents(String remoteFilePath)` يسترد الملف من الجهاز ويعرض المحتوى.
`File`	`pullFileFromExternal(String remoteFilePath)` طريقة ملائمة لاسترداد ملف من وحدة التخزين الخارجية للجهاز وتخزينها في `ERROR(/File)` المحلية المؤقتة، وعرض إشارة إلى `File` تلك.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` دفع محتويات الدليل إلى الجهاز بشكل متكرر مع استبعاد بعض الأدلة تمت تصفيته.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` دفع محتوى الدليل إلى الجهاز بشكل متكرر.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` دفع محتوى الدليل إلى الجهاز بشكل متكرر.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` صيغة `pushFile(File, String)` التي يمكنها اختياريًا تقييم الحاجة لمقدم المحتوى.
`boolean`	`pushFile(File localFile, String remoteFilePath)` إرسال ملف إلى الجهاز
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` إرسال ملف إلى الجهاز
`boolean`	`pushString(String contents, String remoteFilePath)` ملف دفع تم إنشاؤه من سلسلة إلى جهاز
`void`	`reboot(String reason)` يؤدي إلى إعادة تشغيل الجهاز في وضع adb باستخدام `reason` المحدَّد للاستمرار خلال إعادة التشغيل.
`void`	`reboot()` يعيد تشغيل الجهاز في وضع adb.
`void`	`rebootIntoBootloader()` يؤدي هذا الإجراء إلى إعادة تشغيل الجهاز باستخدام وضع برنامج الإقلاع.
`void`	`rebootIntoFastbootd()` يعيد تشغيل الجهاز في وضع Fastbootd.
`void`	`rebootIntoRecovery()` يعيد تشغيل الجهاز في وضع الاسترداد (Recovery mode) باستخدام adb.
`void`	`rebootIntoSideload()` إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف في adb (يُرجى ملاحظة أنّ هذا وضع خاص ضمن عملية الاسترداد) يحظر هذا الإجراء إلى أن يدخل الجهاز في وضع التثبيت من مصدر غير معروف.
`void`	`rebootIntoSideload(boolean autoReboot)` إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف في adb (يُرجى ملاحظة أنّ هذا وضع خاص ضمن عملية الاسترداد) يحظر هذا الإجراء إلى أن يدخل الجهاز في وضع التثبيت من مصدر غير معروف.
`void`	`rebootUntilOnline()` بديل `reboot()` الذي لا يحظر إلا إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئي لـ adb.
`void`	`rebootUntilOnline(String reason)` بديل `reboot()` الذي لا يحظر إلا إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئي لـ adb.
`void`	`rebootUserspace()` يؤدي إلى إعادة تشغيل جزء "مساحة المستخدم" فقط من الجهاز.
`void`	`rebootUserspaceUntilOnline()` بديل `rebootUserspace()` ()} الذي لا يحظر إلا إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئية لـ Adb.
`boolean`	`recoverDevice()` محاولات استعادة الاتصال بالجهاز
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` يتم تسجيل `IDeviceActionReceiver` لهذا الجهاز.
`void`	`remountSystemReadOnly()` ضبط جزء النظام على الجهاز للقراءة فقط
`void`	`remountSystemWritable()` جعل تقسيم النظام على الجهاز قابلاً للكتابة
`void`	`remountVendorReadOnly()` اضبط قسم المورِّد على الجهاز للقراءة فقط.
`void`	`remountVendorWritable()` جعل قسم البائع على الجهاز قابلاً للكتابة
`boolean`	`removeAdmin(String componentName, int userId)` عليك إزالة مشرف الجهاز المحدّد من مستخدم معيّن وعرض `true` إذا تم ذلك بنجاح، أو عرض `false` بخلاف ذلك.
`void`	`removeOwners()` يمكنك إزالة جميع مالكي الملفات الشخصية الحالية للأجهزة مع بذل قصارى جهدك.
`boolean`	`removeUser(int userId)` إزالة مستخدم معيّن من الجهاز
`void`	`resetContentProviderSetup()` يُرجى إعادة ضبط العلامة لإعداد موفّر المحتوى لتفعيلها مرة أخرى.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` طريقة ملائمة لإجراء `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` باستخدام مستمع واحد أو أكثر يتم تمريره كمعلَمات.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` إجراء اختبارات قياس حالة الجهاز وتوفير إمكانية استرداد الأجهزة
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` الأسعار نفسها في فندق `ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))` ولكن إجراء الاختبار لمستخدم معين.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` مثل `ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`، ولكن يتم إجراء الاختبار لمستخدم معيَّن.
`void`	`setConfiguration(IConfiguration configuration)` إدخال `IConfiguration` قيد الاستخدام.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` لضبط التاريخ على الجهاز ملاحظة: يجب توفّر الجذر لضبط التاريخ على الجهاز.
`boolean`	`setDeviceOwner(String componentName, int userId)` ضبط مكوِّن مشرف الجهاز كمالك للجهاز في مستخدم معيَّن.
`void`	`setDeviceState(TestDeviceState deviceState)` تغيير حالة الجهاز
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` بالنسبة إلى المحاكي، تم ضبط `SizeLimitedOutputStream` على تسجيل الناتج.
`void`	`setEmulatorProcess(Process p)` تضبط هذه السياسة سياسة `Process` عندما يكون هذا الجهاز محاكيًا.
`void`	`setFastbootEnabled(boolean fastbootEnabled)` يمكنك ضبط خيار Fastboot للجهاز.
`void`	`setFastbootPath(String fastbootPath)` لضبط المسار إلى البرنامج الثنائي Fastboot الذي يجب استخدامه.
`void`	`setIDevice(IDevice newDevice)` يُرجى تحديث IDevice المرتبط بـ ITestDevice هذا.
`void`	`setLogStartDelay(int delay)` تحدِّد هذه السياسة الوقت بالملّي ثانية للانتظار قبل بدء التقاط سجلّ Logcat لجهاز على الإنترنت.
`void`	`setOptions(TestDeviceOptions options)` ضبط `TestDeviceOptions` للجهاز
`boolean`	`setProperty(String propKey, String propValue)` لضبط قيمة السمة المحدّدة على الجهاز
`void`	`setRecovery(IDeviceRecovery recovery)` يمكنك ضبط `IDeviceRecovery` حتى يتم استخدامها لهذا الجهاز.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` يمكنك ضبط وضع الاسترداد الحالي لاستخدامه على الجهاز.
`void`	`setSetting(String namespace, String key, String value)` يمكنك الاطّلاع على `setSetting(int, String, String, String)` وتنفيذها على مستخدم النظام.
`void`	`setSetting(int userId, String namespace, String key, String value)` أضِف قيمة إعداد إلى مساحة الاسم لمستخدم معيّن.
`void`	`setTestLogger(ITestLogger testLogger)` إدخال مثيل `ITestLogger`
`void`	`setTrackingSerial(String trackingSerial)` لأغراض إدارة الجهاز، يمكنك تتبُّع الرقم التسلسلي الذي نستخدمه للإشارة إلى الجهاز.
`void`	`setUseFastbootErase(boolean useFastbootErase)` يمكنك ضبط ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق 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)` يحظر وصول الجهاز إلى الحقل "adb sideload" (التحميل الجانبي من adb) ولاية
`boolean`	`waitForDeviceNotAvailable(long waitTime)` قوالب عدم توفُّر الجهاز، أي أنّه غير متوفّر في adb
`void`	`waitForDeviceOnline()` يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb.
`void`	`waitForDeviceOnline(long waitTime)` يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb.
`boolean`	`waitForDeviceShell(long waitTime)` في انتظار استجابة الجهاز لأمر adb Shell الأساسي.

الطرق المحمية
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` إنشاء أمر نظام التشغيل لجلسة أمر adb shell المحدد والوسيطات
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` إنشاء "`RebootDeviceAction`" لاستخدامه عند تنفيذ إجراء إعادة التشغيل
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` أعِد تشغيل أداة Adb.
`void`	`ensureRuntimePermissionSupported()` طريقة مساعدة لطرح استثناء إذا لم يكن إذن التشغيل متاحًا
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` احصل على المثيل `RunUtil` لاستخدامه.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` استرجاع خاصية الجهاز من ذاكرة التخزين المؤقت ddmlib بشكل تلقائي، والانتقال إلى "adb" Shell getrep` أو `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

القيمة الثابتة: -10,000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

القيمة الثابتة: 5,000 (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" الحصول على لكل منها. بمعنى أنه يمكن استرجاع جميع المواقع بنفس السرعة التي يتم بها استرجاع إحدى السمات. أشياء مثل device.getApiLevel() وcheckApiLevelAsuchstNextRelease وgetBuildAlias كل المكالمات الميزات المتقدّمة في "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 الشبكات المقدمة في خريطة wifiSidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل حتى 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 الشبكات المقدمة في خريطة wifiSidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل حتى 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)

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

طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكلٍ مبدئي منذ التوقيت العالمي المنسَّق منذ بدء حساب الفترة الجهاز و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 كأمر نظام مع انتهاء مهلة محددة.

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

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

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

الرميات
`DeviceNotAvailableException`

تنفيذ AdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

المعلمات
`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`: الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب . سيتم طرح DeviceNotResponseException إذا كانت `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`: الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب . سيتم طرح DeviceNotAnswerException إذا كانت `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`: الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب . سيتم طرح DeviceNotAnswerException إذا كانت `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`: الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب . سيتم طرح DeviceNotAnswerException إذا كانت `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`: الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب . سيتم طرح DeviceNotAnswerException إذا كانت `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 مرتبط بهذه الدالة، لذا قد تتطابق بعض معرّفات المستخدمين مع قيمة null.

المرتجعات
	تم العثور على خريطة لأرقام تعريف 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. نصّ مختصر (TL;DR) لا تُبلغ هذه الطريقة عن الإصدار الدقيق إلا إذا كانت الخاصية 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).

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

الرميات
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

غير متوافق إلا مع "إصدار adb" > 1.0.36

المرتجعات
`InputStreamSource`	`InputStreamSource` من ملف ZIP الذي يحتوي على Bugreportz، عليك إرجاع القيمة null (فارغ) في حالة الفشل.

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

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) معيّن استخدام وقت الحقبة داخليًا.

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

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

قائمة المهام: توسيع عمليات التنفيذ أعلاه لدعم "التنسيق" و"إعادة القياس"

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

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

public String getTrackingSerial ()

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

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

الحصول على UninstallablePackageNames

public  getUninstallablePackageNames ()

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

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

الرميات
`DeviceNotAvailableException`

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

public boolean getUseFastbootErase ()

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

المرتجعات
`boolean`	`true` في حال استخدام ميزة "محو بيانات Fastboot" أو `false` في حال تفعيل تنسيق 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 ()

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

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

الرميات
`DeviceNotAvailableException`

مع تفعيل Wi-Fi

public boolean isWifiEnabled ()

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

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

المرتجعات
`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 unroot وقبل اتصال الجهاز بالإنترنت مرة أخرى. لا تتضمّن عملية التنفيذ التلقائية أيّ إجراءات إضافية. لا نضمن إيقاف جذر 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 وfalse" سيتم إرجاعه. الأمر التجريبي لن تتم إعادة تشغيله. ويتم تركه للمتصلين لإعادة المحاولة إذا لزم الأمر.

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

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

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

الرميات
`DeviceNotAvailableException`

runElementationTestsAUser

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`

runElementationTestsAUser

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`

تعيين الرقم التسلسلي

public void setTrackingSerial (String trackingSerial)

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

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

setUseFastbootمحو

public void setUseFastbootErase (boolean useFastbootErase)

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

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

startLogcat

public void startLogcat ()

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

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

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

لا يلزم عادةً الاتصال بـ startLogcat() وstopLogcat() عند في سياق استدعاء TF، حيث يبدأ إطار عمل TF (TF) ويوقفه في سجلّ Logcat.

مستخدم البدء

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)

يحظر وصول الجهاز إلى الحقل "adb sideload" (التحميل الجانبي من adb) ولاية

المعلمات
`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 getrep` أو `Fastboot getvar` استنادًا إلى ما إذا كان الجهاز في Fastboot أم لا.

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

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

الرميات
`DeviceNotAvailableException`

عبارة إعادة تشغيل الاتصال

protected boolean isInRebootCallback ()

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

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

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