اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

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

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

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

‫IManagedTestDevice وITestDevice وLocalAndroidVirtualDevice وManagedRemoteDevice وNativeDevice وNestedRemoteDevice وRemoteAndroidDevice وRemoteAndroidVirtualDevice وTestDevice

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

يوفّر واجهة برمجة تطبيقات موثوقة وذات مستوى أعلى قليلاً من واجهة برمجة التطبيقات IDevice في ddmlib.

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

ملخّص

الثوابت
`int`	`UNKNOWN_API_LEVEL` القيمة التلقائية عند تعذُّر رصد مستوى واجهة برمجة التطبيقات

الطرق العامة
`abstract boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` التحقّق مما إذا كانت الميزة متاحة حاليًا استنادًا إلى الحد الأدنى من المستوى المتوافق
`abstract void`	`clearLogcat()` لحذف أي بيانات متراكمة في logcat
`abstract void`	`deleteFile(String deviceFilePath)` طريقة مساعدة لحذف ملف أو دليل على الجهاز
`abstract void`	`deleteFile(String deviceFilePath, int userId)` طريقة مساعدة لحذف ملف أو دليل على الجهاز
`abstract boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` طريقة مساعدة للتحقّق مما إذا تم إعادة تشغيل الجهاز من خلال مقارنة نظام_الخادم الحالي بنظام_الخادم السابق `ProcessInfo`.
`abstract boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` طريقة مساعدة للتحقّق مما إذا تم إعادة تشغيل الجهاز من خلال إعادة التشغيل الخفيف منذ التوقيت العالمي المنسق منذ بدء حساب الوقت من الجهاز و`ERROR(/TimeUnit)`.
`abstract boolean`	`disableAdbRoot()` إيقاف إذن الوصول إلى الجذر من خلال adb
`abstract boolean`	`doesFileExist(String deviceFilePath)` طريقة مساعدة لتحديد ما إذا كان الملف متوفّرًا على الجهاز
`abstract boolean`	`enableAdbRoot()` تفعيل إذن الوصول إلى الجذر من خلال adb
`abstract String`	`executeAdbCommand(long timeout, String... commandArgs)` طريقة مساعدة تنفِّذ أمر adb كأمر نظام مع مهلة محدّدة.
`abstract String`	`executeAdbCommand(String... commandArgs)` طريقة مساعدة تنفِّذ أمر adb كأمر نظام.
`abstract String`	`executeAdbCommand(long timeout, envMap, String... commandArgs)` طريقة مساعدة تنفِّذ أمر adb كأمر نظام مع مهلة محدّدة.
`abstract CommandResult`	`executeFastbootCommand(long timeout, String... commandArgs)` طريقة مساعدة تنفِّذ أمر fastboot كأمر نظام.
`abstract CommandResult`	`executeFastbootCommand(String... commandArgs)` طريقة مساعدة تنفِّذ أمر fastboot كأمر نظام مع مهلة تلقائية تبلغ دقيقتين.
`abstract CommandResult`	`executeLongFastbootCommand(String... commandArgs)` طريقة مساعدة تنفِّذ أمر fastboot الذي يستغرق وقتًا طويلاً كأمر نظام.
`abstract CommandResult`	`executeLongFastbootCommand( envVarMap, String... commandArgs)` طريقة مساعدة تنفِّذ أمر fastboot الذي يستغرق وقتًا طويلاً كأمر نظام مع متغيّرات بيئة system.
`abstract String`	`executeShellCommand(String command)` طريقة مساعدة تنفِّذ أمر adb shell وتُعرِض الإخراج ك`String`.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` تنفيذ أمر adb shell مع المزيد من المَعلمات للتحكّم في سلوك الأمر
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` تنفيذ أمر adb shell مع المزيد من المَعلمات للتحكّم في سلوك الأمر
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` تنفيذ أمر shell adb المحدَّد، مع إعادة المحاولة عدة مرات في حال تعذّر تنفيذ الأمر
`abstract CommandResult`	`executeShellV2Command(String command)` طريقة مساعدة تنفِّذ أمر adb shell وتُرجِع النتائج كقائمة `CommandResult` مملوءة بشكل صحيح بمخرجات حالة الأمر وstdout وstderr.
`abstract CommandResult`	`executeShellV2Command(String command, OutputStream pipeToOutput)` طريقة مساعدة تنفِّذ أمر adb shell وتُعيد النتائج كقائمة `CommandResult` تم تعبئتها بشكل صحيح بمخرجات حالة الأمر وstderr.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput)` طريقة مساعدة تنفِّذ أمر adb shell وتُعيد النتائج كقائمة `CommandResult` مملوءة بشكل صحيح بمخرجات حالة الأمر وstdout وstderr.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` تنفيذ أمر adb shell مع المزيد من المَعلمات للتحكّم في سلوك الأمر
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)` تنفيذ أمر adb shell مع المزيد من المَعلمات للتحكّم في سلوك الأمر
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` تنفيذ أمر adb shell مع المزيد من المَعلمات للتحكّم في سلوك الأمر
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` تنفيذ أمر adb shell مع المزيد من المَعلمات للتحكّم في سلوك الأمر
`abstract CommandResult`	`fastbootWipePartition(String partition)` طريقة مساعدة تمحو قسمًا للجهاز.
`abstract int`	`getApiLevel()` الحصول على مستوى واجهة برمجة تطبيقات الجهاز
`abstract String`	`getBasebandVersion()` طريقة سهلة للحصول على إصدار النطاق الأساسي (الراديو) لهذا الجهاز
`abstract Integer`	`getBattery()` تعرِض هذه السمة مستوى شحن البطارية الحالي لجهاز معيّن أو القيمة Null إذا لم يكن مستوى شحن البطارية متاحًا.
`abstract boolean`	`getBooleanProperty(String name, boolean defaultValue)` لعرض القيمة المنطقية للسمة المحدّدة.
`abstract`	`getBootHistory()` تجمع طريقة المساعدة خريطة سجلّ التشغيل مع وقت التشغيل وسببه.
`abstract`	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` تجمع طريقة المساعدة خريطة سجلّ التشغيل مع وقت التشغيل وسبب التشغيل منذ وقت البدء المُعطى منذ بدء حساب الوقت من الجهاز ووحدة الوقت المحدّدة.
`abstract String`	`getBootloaderVersion()` طريقة سهلة للحصول على إصدار برنامج الإقلاع لهذا الجهاز
`abstract String`	`getBuildAlias()` استرداد الاسم المعرِّف للإصدار الذي يعمل عليه الجهاز حاليًا
`abstract String`	`getBuildFlavor()` استرداد نوع الإصدار للجهاز
`abstract String`	`getBuildId()` استرداد الإصدار الذي يعمل عليه الجهاز حاليًا
`abstract String`	`getBuildSigningKeys()` عرض نوع المفتاح المستخدَم لتوقيع صورة الجهاز قد يتم عادةً توقيع أجهزة Android باستخدام مفاتيح الاختبار (مثل AOSP) أو مفاتيح الإصدار (التي يتحكّم فيها مصنعو الأجهزة الفرديون).
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor()` تعرِض هذه السمة قيمة `DeviceDescriptor` محفوظة في ذاكرة التخزين المؤقت إذا تم تخصيص الجهاز، وتعرِض `DeviceDescriptor` الحالية في حال عدم تخصيص الجهاز.
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` تعرِض هذه السمة قيمة `DeviceDescriptor` محفوظة في ذاكرة التخزين المؤقت إذا تم تخصيص الجهاز، وتعرِض `DeviceDescriptor` الحالية في حال عدم تخصيص الجهاز.
`abstract String[]`	`getChildren(String deviceFilePath)` بديل لاستخدام `IFileEntry` الذي قد لا يعمل في بعض الأحيان بسبب الأذونات
`abstract AbstractConnection`	`getConnection()` عرض الاتصال المرتبط بالجهاز
`abstract String`	`getDeviceClass()` الحصول على فئة الجهاز
`abstract long`	`getDeviceDate()` عرض تاريخ الجهاز بالمللي ثانية منذ تاريخ بدء حساب الفترة
`abstract DeviceDescriptor`	`getDeviceDescriptor()` عرض `DeviceDescriptor` من معلومات الجهاز للحصول على معلومات عنه بدون تمرير عنصر الجهاز الفعلي
`abstract DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` عرض `DeviceDescriptor` من معلومات الجهاز للحصول على معلومات عنه بدون تمرير عنصر الجهاز الفعلي
`abstract TestDeviceState`	`getDeviceState()` الحصول على حالة الجهاز
`abstract long`	`getDeviceTimeOffset(Date date)` مساعد للحصول على فرق التوقيت بين الجهاز و`ERROR(/Date)` معيّن
`abstract InputStreamSource`	`getEmulatorOutput()` الحصول على بث stdout وstderr للمحاكي
`abstract long`	`getExternalStoreFreeSpace()` طريقة مساعدة لتحديد مقدار المساحة الفارغة في مساحة التخزين الخارجية للجهاز
`abstract String`	`getFastbootProductType()` طريقة سهلة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع Fastboot
`abstract String`	`getFastbootProductVariant()` طريقة سهلة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع Fastboot
`abstract String`	`getFastbootSerialNumber()` لعرض الرقم التسلسلي لوضع Fastboot
`abstract String`	`getFastbootVariable(String variableName)` استرداد قيمة متغيّر fastboot المحدَّدة من الجهاز
`abstract IFileEntry`	`getFileEntry(String path)` استرداد مرجع لملف عن بُعد على الجهاز
`abstract IDevice`	`getIDevice()` لعرض مرجع إلى ddmlib `IDevice` المرتبط.
`abstract long`	`getIntProperty(String name, long defaultValue)` لعرض القيمة الصحيحة للسمة المحدّدة من الجهاز.
`abstract long`	`getLastExpectedRebootTimeMillis()` تعرِض هذه السمة آخر مرة تسبّبت فيها واجهات برمجة تطبيقات Tradefed في إعادة التشغيل بالمللي ثانية منذ EPOCH كما هو موضّح في القيمة التي يعرضها `System.currentTimeMillis()`.
`abstract int`	`getLaunchApiLevel()` الحصول على مستوى واجهة برمجة التطبيقات الذي تم إطلاقه لأول مرة على الجهاز
`abstract InputStreamSource`	`getLogcat()` تلتقط هذه الأداة لقطة سريعة لبيانات logcat.
`abstract InputStreamSource`	`getLogcat(int maxBytes)` تلتقط هذه الأداة لقطات من آخر `maxBytes` من بيانات logcat التي تم تسجيلها.
`abstract InputStreamSource`	`getLogcatDump()` الحصول على نسخة من logcat الحالي للجهاز
`abstract InputStreamSource`	`getLogcatSince(long date)` تلتقط هذه الأداة لقطات من بيانات logcat التي تم تسجيلها بدءًا من التاريخ المقدَّم.
`abstract String`	`getMountPoint(String mountName)` لعرض نقطة تثبيت.
`abstract ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` عرض `MountPointInfo` مقابل مسار نقطة التثبيت المحدّد، أو `null` إذا لم يتم تثبيت أي ملف في هذا المسار أو إذا لم يظهر في ‎/proc/mounts كنقطة تثبيت
`abstract`	`getMountPointInfo()` لعرض نسخة مفسَّرة من المعلومات في ‎ /proc/mounts على الجهاز
`abstract long`	`getPartitionFreeSpace(String partition)` طريقة مساعدة لتحديد مقدار المساحة الفارغة في قسم الجهاز
`abstract ProcessInfo`	`getProcessByName(String processName)` تعمل الطريقة المساعِدة على تنفيذ الأمرَين "pidof" و "stat" وتعرض عنصر `ProcessInfo` يحتوي على رقم تعريف العملية ووقت بدء العملية المحدّدة.
`abstract String`	`getProcessPid(String process)` تعرِض هذه الدالة رقم تعريف العملية للخدمة أو القيمة null إذا حدث خطأ.
`abstract String`	`getProductType()` طريقة سهلة للحصول على نوع المنتج لهذا الجهاز
`abstract String`	`getProductVariant()` طريقة سهلة للحصول على خيار المنتج لهذا الجهاز
`abstract String`	`getProperty(String name)` استرداد قيمة السمة المحدّدة من الجهاز
`abstract ITestDevice.RecoveryMode`	`getRecoveryMode()` الحصول على وضع الاسترداد الحالي المستخدَم للجهاز
`abstract String`	`getSerialNumber()` طريقة سهلة للحصول على الرقم التسلسلي لهذا الجهاز
`abstract`	`getTombstones()` جلب قائمة العناصر التي تم حذفها نهائيًا من الأجهزة وإعادتها
`abstract long`	`getTotalMemory()` عرض إجمالي حجم الذاكرة الفعلية بالبايت أو -1 في حال حدوث خطأ داخلي
`default String`	`getTrackingSerial()` لأغراض إدارة الجهاز، يمكنك الحصول على الرقم التسلسلي المستخدَم لتتبُّع الجهاز.
`abstract boolean`	`getUseFastbootErase()` معرفة ما إذا كان يجب استخدام fastboot erase أو fastboot format لمحو قسم على الجهاز
`abstract boolean`	`isAdbRoot()`
`abstract boolean`	`isAdbTcp()`
`abstract boolean`	`isAppEnumerationSupported()` التحقّق مما إذا كانت المنصة على الجهاز تتيح إدراج التطبيقات
`abstract boolean`	`isBypassLowTargetSdkBlockSupported()` التحقّق مما إذا كانت المنصة على الجهاز تتيح تجاوز حظر حزمة تطوير البرامج (SDK) المستهدفة ذات الإصدار المنخفض على عمليات تثبيت التطبيقات
`abstract boolean`	`isDebugfsMounted()` تحقَّق مما إذا كان قد تم تركيب debugfs.
`abstract boolean`	`isDeviceEncrypted()` يعرض ما إذا كان الجهاز مشفَّرًا.
`abstract boolean`	`isDirectory(String deviceFilePath)` عرض True إذا كان المسار على الجهاز دليلاً، وعرض False في غير ذلك
`abstract boolean`	`isEncryptionSupported()` يعرض ما إذا كان التشفير متاحًا على الجهاز.
`abstract boolean`	`isExecutable(String fullPath)` تعرِض هذه الدالة القيمة True إذا كان مسار الملف على الجهاز ملفًا قابلاً للتنفيذ، وتعرض القيمة False في الحالات الأخرى.
`abstract boolean`	`isHeadless()` عرض true إذا كان الجهاز غير مزوّد بشاشة (بدون شاشة)، وعرض false في الحالات الأخرى
`abstract boolean`	`isRuntimePermissionSupported()` التحقّق مما إذا كانت المنصة على الجهاز تتيح منح أذونات التشغيل
`abstract boolean`	`isStateBootloaderOrFastbootd()` تعرِض هذه الدالة القيمة true إذا كان الجهاز في وضع `TestDeviceState.FASTBOOT` أو `TestDeviceState.FASTBOOTD`.
`abstract boolean`	`logAnrs(ITestLogger logger)` يتم جمع أخطاء ANR وتسجيلها من الجهاز.
`abstract void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` سجِّل رسالة في logcat للجهاز.
`abstract void`	`mountDebugfs()` شغِّل debugfs.
`abstract void`	`nonBlockingReboot()` يُصدر الأمر لإعادة تشغيل الجهاز ويعود عند اكتمال الأمر وعندما لا يعود الجهاز مرئيًا لـ adb.
`abstract void`	`postBootSetup()` اتّبِع التعليمات لضبط الجهاز للاختبار بعد كل عملية تشغيل.
`default void`	`postInvocationTearDown()` تم إيقاف هذه الطريقة نهائيًا. استخدِم `postInvocationTearDown(Throwable)` بدلاً منه.
`abstract void`	`postInvocationTearDown(Throwable invocationException)` خطوات إضافية لعمليات التنظيف المطلوبة الخاصة بالجهاز والتي سيتم تنفيذها بعد اكتمال عملية التنشيط
`default void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` خطوات إضافية للإعداد المطلوب الخاص بالجهاز والتي سيتم تنفيذها على الجهاز قبل عملية الاستدعاء
`abstract boolean`	`pullDir(String deviceFilePath, File localDir)` سحب محتويات الدليل بشكل متكرر من الجهاز
`abstract boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` سحب محتويات الدليل بشكل متكرر من الجهاز
`abstract File`	`pullFile(String remoteFilePath, int userId)` استرداد ملف من الجهاز وتخزينه في `ERROR(/File)` مؤقت على الجهاز، ثم عرض`File`
`abstract File`	`pullFile(String remoteFilePath)` استرداد ملف من الجهاز وتخزينه في `ERROR(/File)` مؤقت على الجهاز، ثم عرض`File`
`abstract boolean`	`pullFile(String remoteFilePath, File localFile)` استرداد ملف من الجهاز
`abstract boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` استرداد ملف من الجهاز
`abstract String`	`pullFileContents(String remoteFilePath)` استرداد ملف من الجهاز وعرض محتواه
`abstract File`	`pullFileFromExternal(String remoteFilePath)` طريقة سهلة لاسترداد ملف من وحدة التخزين الخارجية للجهاز وتخزينه في `ERROR(/File)` مؤقت محلي، وعرض مرجع إلى هذا `File`
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, int userId)` دفع محتوى الدليل بشكل متكرر إلى الجهاز
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, excludedDirectories)` دفع محتوى الدليل بشكل متكرر إلى الجهاز مع استبعاد بعض الدلائل التي يتم فلترتها
`abstract boolean`	`pushDir(File localDir, String deviceFilePath)` دفع محتوى الدليل بشكل متكرر إلى الجهاز
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)` نوع من `pushFile(File, String)` يمكنه اختياريًا تقييم الحاجة لمقدّم المحتوى.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath)` أرسِل ملفًا إلى الجهاز.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, int userId)` أرسِل ملفًا إلى الجهاز.
`abstract boolean`	`pushString(String contents, String deviceFilePath)` دفع ملف تم إنشاؤه من سلسلة إلى الجهاز
`abstract void`	`reboot()` تؤدي هذه العملية إلى إعادة تشغيل الجهاز في وضع adb.
`abstract void`	`reboot(String reason)` تعيد تشغيل الجهاز في وضع adb باستخدام `reason` المحدَّد ليتم الاحتفاظ به بعد إعادة التشغيل.
`abstract void`	`rebootIntoBootloader()` إعادة تشغيل الجهاز في وضع برنامج الإقلاع
`abstract void`	`rebootIntoFastbootd()` تؤدي هذه العملية إلى إعادة تشغيل الجهاز في وضع fastbootd.
`abstract void`	`rebootIntoRecovery()` تؤدي هذه العملية إلى إعادة تشغيل الجهاز في وضع الاسترداد adb.
`abstract void`	`rebootIntoSideload(boolean autoReboot)` إعادة تشغيل الجهاز في وضع "التثبيت من مصدر غير معروف" من خلال أداة adb (يُرجى العِلم أنّ هذا وضع خاص ضمن وضع الاسترداد) يتم الحظر إلى أن يدخل الجهاز في وضع "التثبيت من مصدر غير معروف".
`abstract void`	`rebootIntoSideload()` إعادة تشغيل الجهاز في وضع "التثبيت من مصدر غير معروف" من خلال أداة adb (يُرجى العِلم أنّ هذا وضع خاص ضمن وضع الاسترداد) يتم الحظر إلى أن يدخل الجهاز في وضع "التثبيت من مصدر غير معروف".
`abstract void`	`rebootUntilOnline()` بديل `reboot()` الذي يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لـ adb
`abstract void`	`rebootUntilOnline(String reason)` بديل `reboot()` الذي يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لـ adb
`abstract void`	`rebootUserspace()` تؤدي هذه العملية إلى إعادة تشغيل جزء مساحة المستخدم فقط من الجهاز.
`abstract void`	`rebootUserspaceUntilOnline()` بديل `rebootUserspace()` ()} الذي يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لـ adb
`abstract void`	`remountSystemReadOnly()` اجعل قسم النظام على الجهاز للقراءة فقط.
`abstract void`	`remountSystemWritable()` اجعل قسم النظام على الجهاز قابلاً للكتابة.
`abstract void`	`remountVendorReadOnly()` اضبط قسم المورّد على الجهاز على "للقراءة فقط".
`abstract void`	`remountVendorWritable()` اجعل قسم المورّد على الجهاز قابلاً للكتابة.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` طريقة مناسبة لتنفيذ `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` مع مستمع واحد أو أكثر تم تمريره كمَعلمات.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` يُجري اختبارات الأدوات ويوفّر إمكانية استرداد الجهاز.
`abstract 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))` ولكن يُجري الاختبار للمستخدم المحدّد.
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` يشبه `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)` ولكنّه يُجري الاختبار لمستخدم معيّن.
`abstract void`	`setDate(Date date)` ضبط التاريخ على الجهاز ملاحظة: ضبط التاريخ على الجهاز يتطلب إذن الوصول إلى الجذر
`abstract void`	`setOptions(TestDeviceOptions options)` ضبط `TestDeviceOptions` للجهاز
`abstract boolean`	`setProperty(String propKey, String propValue)` تُستخدَم لضبط قيمة السمة المحدّدة على الجهاز.
`abstract void`	`setRecovery(IDeviceRecovery recovery)` اضبط `IDeviceRecovery` لاستخدامه مع هذا الجهاز.
`abstract void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` اضبط وضع الاسترداد الحالي لاستخدامه مع الجهاز.
`abstract void`	`setTrackingSerial(String trackingSerial)` لأغراض إدارة الجهاز، يمكنك تتبُّع الرقم التسلسلي الذي نستخدمه للإشارة إلى الجهاز.
`abstract void`	`setUseFastbootErase(boolean useFastbootErase)` حدِّد ما إذا كنت تريد استخدام fastboot erase أو fastboot format لمحو قسم على الجهاز.
`abstract void`	`startLogcat()` ابدأ بتسجيل إخراج logcat من الجهاز في الخلفية.
`abstract boolean`	`startTradeInModeTesting(int timeoutMs)` فعِّل وضع اختبار الاستبدال.
`abstract void`	`stopEmulatorOutput()` أغلِق مخرج المحاكي واحذِفه.
`abstract void`	`stopLogcat()` توقِف تسجيل بيانات logcat من الجهاز، وبذِل بيانات logcat المحفوظة حاليًا.
`abstract void`	`stopTradeInModeTesting()` توقّف عن اختبار وضع إعادة البيع.
`abstract String`	`switchToAdbTcp()` عليك تبديل الجهاز إلى وضع adb-over-tcp.
`abstract boolean`	`switchToAdbUsb()` عليك تبديل الجهاز إلى وضع adb عبر usb.
`abstract boolean`	`syncFiles(File localFileDir, String deviceFilePath)` مزامنة محتويات دليل ملفات على الجهاز بشكل تدريجي
`abstract boolean`	`unlockDevice()` فتح قفل الجهاز إذا كان الجهاز مشفَّرًا
`abstract void`	`unmountDebugfs()` ألغِ تثبيت debugfs.
`abstract boolean`	`waitForBootComplete(long timeOut)` يتم حظر الإجراء إلى أن يتم ضبط علامة اكتمال عملية تشغيل الجهاز.
`abstract boolean`	`waitForDeviceAvailable()` ينتظر الجهاز حتى يصبح متجاوبًا ومتاحًا للاختبار.
`abstract boolean`	`waitForDeviceAvailable(long waitTime)` ينتظر الجهاز حتى يصبح متجاوبًا ومتاحًا للاختبار.
`abstract boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` ينتظر هذا الإجراء تفاعل الجهاز ومدى توفّره بدون النظر إلى مسار الاسترداد.
`abstract void`	`waitForDeviceBootloader()` يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال Fastboot.
`abstract boolean`	`waitForDeviceInRecovery(long waitTime)` يحظر هذا الإعداد أن يكون الجهاز في حالة "استرداد adb" (يُرجى العلم أنّ هذا الإعداد يختلف عن `IDeviceRecovery`).
`abstract boolean`	`waitForDeviceInSideload(long waitTime)` حظر الجهاز في حالة "تحميل جانبي باستخدام adb"
`abstract boolean`	`waitForDeviceNotAvailable(long waitTime)` الحظر لعدم توفّر الجهاز، أي عدم توفّره في adb
`abstract void`	`waitForDeviceOnline()` يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال adb.
`abstract void`	`waitForDeviceOnline(long waitTime)` يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال adb.
`abstract boolean`	`waitForDeviceShell(long waitTime)` ينتظر حتى يستجيب الجهاز لأمر أساسي في واجهة برمجة التطبيقات adb shell.

الثوابت

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

القيمة التلقائية عند تعذُّر رصد مستوى واجهة برمجة التطبيقات

القيمة الثابتة: -1 (0xffffffff)

الطرق العامة

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

المعلمات
`strictMinLevel`	`int`: أدنى مستوى ممكن صارم يتيح استخدام الميزة

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

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

clearLogcat

public abstract void clearLogcat ()

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

عمليات الرمي
`RuntimeException`	إذا كان الجهاز يتضمّن سببًا غير طبيعي لبدء التشغيل
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

عمليات الرمي
`RuntimeException`	إذا كان الجهاز يتضمّن سببًا غير طبيعي لبدء التشغيل
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableAdbRoot

public abstract boolean disableAdbRoot ()

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

executeShellCommand

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	في حال فقدان الاتصال بالجهاز وعدم التمكّن من استعادته

راجِع أيضًا:

executeShellCommand

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

راجِع أيضًا:

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

executeShellV2Command

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

راجِع أيضًا:

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

راجِع أيضًا:

executeShellV2Command

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

راجِع أيضًا:

executeShellV2Command

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

راجِع أيضًا:

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

getApiLevel

public abstract int getApiLevel ()

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

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

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

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

getBattery

public abstract Integer getBattery ()

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

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

getBooleanProperty

public abstract 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 abstract  getBootHistory ()

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

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

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

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

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

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

getConnection

public abstract AbstractConnection getConnection ()

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

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

getDeviceClass

public abstract String getDeviceClass ()

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

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

getDeviceDate

public abstract long getDeviceDate ()

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

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

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

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

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

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

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

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

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

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

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

الحصول على بث stdout وstderr للمحاكي

المرتجعات
`InputStreamSource`	ناتج المحاكي

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

لعرض الرقم التسلسلي لوضع Fastboot

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

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

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

getFileEntry

public abstract IFileEntry getFileEntry (String path)

استرداد مرجع لملف عن بُعد على الجهاز

المعلمات
`path`	`String`: مسار الملف المطلوب استرجاعه يمكن أن يكون مسارًا مطلقًا أو مسارًا نسبيًا إلى "/". (أي يمكن استخدام البنية "‎/system" و "system")

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

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

getIDevice

public abstract IDevice getIDevice ()

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

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

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

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

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

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

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

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

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

getLogcat

public abstract InputStreamSource getLogcat ()

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

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

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

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

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

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

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

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

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

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

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

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

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

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

getMountPoint

public abstract String getMountPoint (String mountName)

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

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

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

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

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

راجِع أيضًا:

IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

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

راجِع أيضًا:

getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

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

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

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

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

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

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

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

getProcessPid

public abstract String getProcessPid (String process)

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

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

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

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

getProductType

public abstract String getProductType ()

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده، أو إذا تعذّر تحديد نوع المنتج

getProductVariant

public abstract String getProductVariant ()

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

getProperty

public abstract String getProperty (String name)

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

المعلمات
`name`	`String`: اسم السمة

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

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

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

الحصول على وضع الاسترداد الحالي المستخدَم للجهاز

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

getSerialNumber

public abstract String getSerialNumber ()

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

المرتجعات
`String`	الرقم التسلسلي `String`

getTombstones

public abstract  getTombstones ()

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

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

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

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

راجِع أيضًا:

مستندات ملفات Tombstone

getTotalMemory

public abstract long getTotalMemory ()

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

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

getTrackingSerial

public String getTrackingSerial ()

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

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

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

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

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

راجِع أيضًا:

fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

isAdbTcp

public abstract boolean isAdbTcp ()

المرتجعات
`boolean`	`true` إذا كان الجهاز متصلاً بـ adb-over-tcp، `false` في الحالات الأخرى

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

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

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

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

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

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

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

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

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

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

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

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

المعلمات
`deviceFilePath`	`String`

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

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

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

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

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

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

isExecutable

public abstract boolean isExecutable (String fullPath)

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

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

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

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

isHeadless

public abstract boolean isHeadless ()

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

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

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

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

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

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

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

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

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

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

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

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

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

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

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

logOnDevice

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

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

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

mountDebugfs

public abstract void mountDebugfs ()

شغِّل debugfs.

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

nonBlockingReboot

public abstract void nonBlockingReboot ()

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

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

postBootSetup

public abstract void postBootSetup ()

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

postInvocationTearDown

public void postInvocationTearDown ()

تم إيقاف هذه الطريقة نهائيًا.
استخدِم postInvocationTearDown(Throwable) بدلاً من ذلك.

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

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

preInvocationSetup

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

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

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

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

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

pullDir

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pullFile

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

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

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

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

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

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

إعادة تشغيل

public abstract void reboot ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا لم يكن الجهاز متاحًا بعد إعادة التشغيل

إعادة تشغيل

public abstract void reboot (String reason)

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا لم يكن الجهاز متاحًا بعد إعادة التشغيل

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا لم يكن الجهاز متاحًا بعد إعادة التشغيل

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

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

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload ()

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

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

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

عمليات الرمي
`DeviceNotAvailableException`	إذا لم يكن الجهاز متاحًا بعد إعادة التشغيل

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا لم يكن الجهاز متاحًا بعد إعادة التشغيل

راجِع أيضًا:

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا لم يكن الجهاز متاحًا بعد إعادة التشغيل

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

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

عمليات الرمي
`DeviceNotAvailableException`	إذا لم يكن الجهاز متاحًا بعد إعادة التشغيل

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

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

remountSystemWritable

public abstract void remountSystemWritable ()

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

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

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

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

remountVendorWritable

public abstract void remountVendorWritable ()

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

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

runInstrumentationTests

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده، أي تعذّر إكمال أمر الاختبار وتعذّر الاسترداد.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده، أي تعذّر إكمال أمر الاختبار وتعذّر الاسترداد.

runInstrumentationTestsAsUser

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

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

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

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

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

runInstrumentationTestsAsUser

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

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

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

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

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

setDate

public abstract void setDate (Date date)

ضبط التاريخ على الجهاز

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

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

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

setOptions

public abstract void setOptions (TestDeviceOptions options)

ضبط TestDeviceOptions للجهاز

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

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

تُستخدَم لضبط قيمة السمة المحدّدة على الجهاز. يتطلب أن يكون adb root صحيحًا.

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

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

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

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

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

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

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

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

راجِع أيضًا:

fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

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

startTradeInModeTesting

public abstract boolean startTradeInModeTesting (int timeoutMs)

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

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

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

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

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

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

stopLogcat

public abstract void stopLogcat ()

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

لن يكون له أي تأثير في حال عدم تسجيل ناتج logcat.

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

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

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

switchToAdbTcp

public abstract String switchToAdbTcp ()

عليك تبديل الجهاز إلى وضع adb-over-tcp.

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

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

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

عليك تبديل الجهاز إلى وضع adb عبر usb.

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

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

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

سيتم تجاهل الملفات المخفية (التي تبدأ أسماؤها بنقطة).

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

unlockDevice

public abstract boolean unlockDevice ()

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته
`UnsupportedOperationException`	إذا لم يكن التشفير متاحًا على الجهاز

unmountDebugfs

public abstract void unmountDebugfs ()

ألغِ تثبيت debugfs.

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

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

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

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

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا ظل الجهاز لا يستجيب بعد انتهاء مهلة الانتظار

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

ينتظر هذا الإجراء تفاعل الجهاز ومدى توفّره بدون النظر إلى مسار الاسترداد.

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

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

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

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

حظر الجهاز في حالة "تحميل جانبي باستخدام adb"

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

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

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

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

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

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

عمليات الرمي
`DeviceNotAvailableException`	إذا انقطع الاتصال بالجهاز ولا يمكن استعادته

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

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

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