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

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

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

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

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

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

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

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

ملخّص

الثوابت
`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)` طريقة مساعدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكل غير كامل من خلال مقارنة system_server الحالي بـ system_server السابق `ProcessInfo`.
`abstract boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` طريقة مساعدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكل غير كامل منذ وقت التوقيت العالمي المنسق (UTC) المنقضي منذ بداية حقبة يونكس من الجهاز و`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, Map<String, String> envMap, String... commandArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`abstract CommandResult`	`executeAdbV2Command(String... commandArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام.
`abstract CommandResult`	`executeAdbV2Command(long timeout, String... commandArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`abstract CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> envMap, int retryAttempts, String... commandArgs)` طريقة مساعدة تنفّذ أمر adb كأمر نظام بمهلة زمنية محدّدة.
`abstract CommandResult`	`executeAdbV2Command(long timeout, Map<String, String> 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(Map<String, String> envVarMap, String... commandArgs)` طريقة مساعدة تنفّذ أمر fastboot طويل الأمد كأمر نظام مع متغيرات بيئة النظام.
`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)` ينفّذ هذا الأمر أمر adb shell المحدّد، ويعيد المحاولة عدة مرات إذا تعذّر تنفيذ الأمر.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.
`abstract CommandResult`	`executeShellV2Command(String command)` طريقة مساعدة تنفّذ أمر adb shell وتعرض النتائج على شكل `CommandResult` مملوء بشكل صحيح بناتج حالة الأمر وstdout وstderr.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, 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)` طريقة مساعدة تنفّذ أمر adb shell وتعرض النتائج كـ `CommandResult` مملوءة بشكل صحيح بناتج حالة الأمر وstdout وstderr.
`abstract CommandResult`	`executeShellV2Command(String command, OutputStream pipeToOutput)` طريقة مساعدة تنفّذ أمر adb shell وتعرض النتائج كـ `CommandResult` مملوء بشكل صحيح بناتج حالة الأمر وstderr.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` ينفّذ أمر adb shell، مع المزيد من المَعلمات للتحكّم في سلوك الأمر.
`abstract CommandResult`	`executeShellV2Command(String command, IShellOutputReceiver receiver)` طريقة مساعدة تنفّذ أمر adb shell وتعرض النتائج على شكل `CommandResult` مملوء بشكل صحيح بناتج حالة الأمر وstdout وstderr.
`abstract CommandResult`	`fastbootOemRamdumpNow()` طريقة مساعدة تؤدي إلى تشغيل ramdump من وضع fastboot.
`abstract CommandResult`	`fastbootWipePartition(String partition)` طريقة مساعدة تمحو قسمًا من الجهاز.
`abstract int`	`getApiLevel()` الحصول على مستوى واجهة برمجة التطبيقات للجهاز
`abstract int`	`getApiLevelFull()` تشبه `getApiLevel()`، ولكنها تعرض الإصدار الكامل.
`abstract String`	`getBasebandVersion()` طريقة سهلة للحصول على إصدار النطاق الأساسي (الراديو) لهذا الجهاز.
`abstract Integer`	`getBattery()` تعرض هذه السمة مستوى البطارية الحالي للجهاز أو القيمة Null إذا كان مستوى البطارية غير متوفّر.
`abstract boolean`	`getBooleanProperty(String name, boolean defaultValue)` تعرض هذه الدالة القيمة المنطقية للسمة المحدّدة.
`abstract Map<Long, String>`	`getBootHistory()` تجمع طريقة المساعدة خريطة سجلّ بدء التشغيل مع وقت بدء التشغيل وسببه.
`abstract Map<Long, String>`	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` تجمع طريقة المساعدة خريطة سجلّ بدء التشغيل مع وقت بدء التشغيل وسبب بدء التشغيل منذ الوقت المحدّد منذ بداية الحقبة من الجهاز ووحدة الوقت المحدّدة.
`abstract String`	`getBootloaderVersion()` طريقة سهلة للحصول على إصدار برنامج الإقلاع على هذا الجهاز.
`abstract String`	`getBuildAlias()` استرداد الاسم المستعار للإصدار الذي يعمل عليه الجهاز حاليًا
`abstract String`	`getBuildFlavor()` استرداد نوع الإصدار للجهاز
`abstract String`	`getBuildId()` استرداد الإصدار الذي يعمل به الجهاز حاليًا
`abstract String`	`getBuildSigningKeys()` تعرِض هذه السمة نوع المفتاح المستخدَم لتوقيع صورة الجهاز. عادةً ما يتم توقيع أجهزة Android باستخدام مفاتيح اختبار (كما هو الحال في مشروع Android المفتوح المصدر) أو مفاتيح إصدار (يتحكّم فيها مصنّعو الأجهزة الفردية).
`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)` دالة مساعدة للحصول على فرق الوقت بين الجهاز وقيمة `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 إلى إعادة التشغيل بالمللي ثانية منذ بداية الحقبة كما تم عرضها بواسطة `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 List<ITestDevice.MountPointInfo>`	`getMountPointInfo()` لعرض نسخة محلّلة من المعلومات الواردة في /proc/mounts على الجهاز
`abstract long`	`getPartitionFreeSpace(String partition)` طريقة مساعدة لتحديد مقدار المساحة الحرة على قسم الجهاز.
`abstract ProcessInfo`	`getProcessByName(String processName)` يشغّل الإجراء المساعد الأمرَين "pidof" و "stat" ويعرض عنصر `ProcessInfo` يتضمّن معرّف العملية ووقت بدء العملية المحدّدة.
`abstract String`	`getProcessPid(String process)` تعرِض هذه السمة رقم تعريف العملية للخدمة أو قيمة فارغة في حال حدوث خطأ.
`abstract String`	`getProductType()` طريقة سهلة للحصول على نوع منتج هذا الجهاز.
`abstract String`	`getProductVariant()` طريقة سهلة للحصول على خيار المنتج لهذا الجهاز.
`abstract String`	`getProperty(String name)` استرداد قيمة السمة المحدّدة من الجهاز
`abstract ITestDevice.RecoveryMode`	`getRecoveryMode()` الحصول على وضع الاسترداد الحالي المستخدَم للجهاز
`abstract String`	`getSerialNumber()` طريقة سهلة للحصول على الرقم التسلسلي لهذا الجهاز.
`abstract List<File>`	`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)` تعرض هذه السمة القيمة "صحيح" إذا كان مسار الملف على الجهاز ملفًا قابلاً للتنفيذ، وتعرض القيمة "خطأ" في الحالات الأخرى.
`abstract boolean`	`isHeadless()` عرض "صحيح" إذا كان الجهاز بدون شاشة، و"خطأ" في الحالات الأخرى
`abstract boolean`	`isRuntimePermissionSupported()` التحقّق ممّا إذا كانت المنصة على الجهاز تتيح منح أذونات وقت التشغيل
`abstract boolean`	`isStateBootloaderOrFastbootd()` تعرِض هذه السمة القيمة "صحيح" إذا كان الجهاز في `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()` يُصدر هذا الأمر لإعادة تشغيل الجهاز، ويعود عند اكتمال الأمر وعندما لا يعود الجهاز مرئيًا لأداة تصحيح الأخطاء من Android.
`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, long timeout)` سحب محتوى الدليل بشكل متكرّر من الجهاز
`abstract boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` سحب محتوى الدليل بشكل متكرّر من الجهاز
`abstract File`	`pullFile(String remoteFilePath, int userId)` يسترد هذا الإجراء ملفًا من الجهاز ويخزّنه في `File` مؤقتة محلية، ثم يعرض `File`.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile, int userId, long timeout)` يستردّ ملفًا من الجهاز.
`abstract File`	`pullFile(String remoteFilePath)` يسترد هذا الإجراء ملفًا من الجهاز ويخزّنه في `File` مؤقتة محلية، ثم يعرض `File`.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` يستردّ ملفًا من الجهاز.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile)` يستردّ ملفًا من الجهاز.
`abstract String`	`pullFileContents(String remoteFilePath)` يسترد هذا الإجراء ملفًا من الجهاز ويعرض محتواه.
`abstract File`	`pullFileFromExternal(String remoteFilePath)` طريقة سهلة لاسترداد ملف من وحدة التخزين الخارجية للجهاز وتخزينه في `File` مؤقت محلي، ثم إرجاع مرجع إلى هذا `File`.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, int userId)` إرسال محتوى الدليل بشكل متكرر إلى الجهاز
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, Set<String> excludedDirectories)` دفع محتويات الدليل بشكل متكرر إلى الجهاز مع استبعاد بعض الأدلة التي تم فلترتها
`abstract boolean`	`pushDir(File localDir, String deviceFilePath)` إرسال محتوى الدليل بشكل متكرر إلى الجهاز
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, int userId)` إرسال ملف إلى الجهاز
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)` صيغة `pushFile(File,String)` يمكنها اختياريًا مراعاة تقييم الحاجة إلى مقدّم المحتوى.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath)` إرسال ملف إلى الجهاز
`abstract boolean`	`pushString(String contents, String deviceFilePath)` إرسال ملف تم إنشاؤه من سلسلة إلى الجهاز
`abstract void`	`reboot()` تعيد هذه السمة تشغيل الجهاز في وضع تصحيح أخطاء adb.
`abstract void`	`reboot(String reason)` تعيد هذه السمة تشغيل الجهاز في وضع تصحيح الأخطاء عبر adb مع الاحتفاظ بالقيمة `reason` المحدّدة عند إعادة التشغيل.
`default String`	`reboot(String command, String reason)` يعيد تشغيل الجهاز باستخدام `command` المحدّد.
`abstract void`	`rebootIntoBootloader()` تعيد هذه السمة تشغيل الجهاز في وضع برنامج الإقلاع.
`abstract void`	`rebootIntoFastbootd()` تعيد هذه السمة تشغيل الجهاز في وضع fastbootd.
`abstract void`	`rebootIntoRecovery()` تعيد هذه السمة تشغيل الجهاز في وضع الاسترداد adb.
`abstract void`	`rebootIntoSideload(boolean autoReboot)` إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف من خلال Android Debug Bridge (يُرجى العِلم أنّ هذا وضع خاص ضمن وضع الاسترداد) يتم الحظر إلى أن يدخل الجهاز في وضع التحميل الجانبي
`abstract void`	`rebootIntoSideload()` إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف من خلال Android Debug Bridge (يُرجى العِلم أنّ هذا وضع خاص ضمن وضع الاسترداد) يتم الحظر إلى أن يدخل الجهاز في وضع التحميل الجانبي
`abstract void`	`rebootUntilOnline()` بديل عن `reboot()` يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android.
`abstract void`	`rebootUntilOnline(String reason)` بديل عن `reboot()` يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android.
`abstract void`	`rebootUserspace()` يعيد تشغيل جزء مساحة المستخدم في الجهاز فقط.
`abstract void`	`rebootUserspaceUntilOnline()` بديل عن `rebootUserspace()` ()} الذي يحظر فقط إلى أن يكون الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android.
`abstract void`	`remountSystemReadOnly()` اجعل قسم النظام على الجهاز للقراءة فقط.
`abstract void`	`remountSystemWritable()` اجعل قسم النظام على الجهاز قابلاً للكتابة.
`abstract void`	`remountVendorReadOnly()` اجعل قسم البائع على الجهاز للقراءة فقط.
`abstract void`	`remountVendorWritable()` اجعل قسم البائع على الجهاز قابلاً للكتابة.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, Collection<ITestLifeCycleReceiver> listeners)` تنفيذ اختبارات الأجهزة وتوفير إمكانية استرداد البيانات من الجهاز
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` طريقة سهلة لتنفيذ `runInstrumentationTests(IRemoteAndroidTestRunner,Collection)` باستخدام مستمع واحد أو أكثر يتم تمريرهم كمعلَمات.
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)` هي نفسها `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 sideload"
`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)

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

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

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

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

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

disableAdbRoot

public abstract boolean disableAdbRoot ()

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

قد يؤدي إيقاف adb root إلى قطع اتصال الجهاز بـ 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`	تمثّل هذه السمة الإخراج القياسي من الأمر. ‫`null` إذا تعذّر تنفيذ الأمر

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

executeAdbCommand

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

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

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

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

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

executeAdbV2Command

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

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

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

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

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

executeAdbV2Command

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

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

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

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

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

executeAdbV2Command

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

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

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

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

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

executeFastbootCommand

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

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

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

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

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

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

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

executeLongFastbootCommand

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

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

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

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

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

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

المرتجعات
`String`	ناتج الصدفة

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

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

يُرجى الاطّلاع أيضًا على:

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

عمليات الطرح
`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, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

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

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

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

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

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

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

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

يُرجى الاطّلاع أيضًا على:

executeShellV2Command

public 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, 
                IShellOutputReceiver receiver)

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

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

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

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

fastbootOemRamdumpNow

public abstract CommandResult fastbootOemRamdumpNow ()

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

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

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

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

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

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

getApiLevel

public abstract int getApiLevel ()

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

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

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

getApiLevelFull

public abstract int getApiLevelFull ()

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

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

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

يُرجى الاطّلاع أيضًا على:

ERROR(/frameworks/base/core/java/android/os/Build.java#parseFullVersion(String, String))

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 Map<Long, String> getBootHistory ()

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

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

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

getBootHistorySince

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

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

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

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

عمليات الطرح
`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`	نوع الإصدار أو قيمة فارغة إذا تعذّر استرداده

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

المعلَمات
`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`	تاريخ الجهاز بتنسيق epoch

عمليات الطرح
	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)

دالة مساعدة للحصول على فرق الوقت بين الجهاز وقيمة Date معيّنة. استخدِم الوقت بوحدات المايكروثانية داخليًا.

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

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

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 المرتبط.

قد يتم تخصيص IDevice جديد من خلال DDMS في كل مرة يتم فيها قطع اتصال الجهاز وإعادة توصيله من خلال 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 إلى إعادة التشغيل بالمللي ثانية منذ بداية الحقبة كما تم عرضها بواسطة 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 إذا كان الجهاز يستجيب حاليًا.

المرتجعات
`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: نقل هذا السلوك إلى 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`	`List` من `MountPointInfo` يحتوي على المعلومات الواردة في "/proc/mounts"

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

يُرجى الاطّلاع أيضًا على:

getMountPointInfo()

getMountPointInfo

public abstract List<ITestDevice.MountPointInfo> getMountPointInfo ()

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

المرتجعات
`List<ITestDevice.MountPointInfo>`	`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 of given processName

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

getProcessPid

public abstract String getProcessPid (String process)

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

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

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

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

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

عمليات الطرح
`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 erase أو `false` إذا كان سيتم استخدام fastboot format.

يُرجى الاطّلاع أيضًا على:

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`	قيمة "صحيح" إذا كان من الممكن تجاوز حظر استهداف الإصدارات المنخفضة من حزمة تطوير البرامج (SDK)، وقيمة "خطأ" في الحالات الأخرى

عمليات الطرح
	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)

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

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

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

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

isHeadless

public abstract boolean isHeadless ()

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

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

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

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

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

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

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

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

تعرِض هذه السمة القيمة "صحيح" إذا كان الجهاز في 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 ()

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

عمليات الطرح
	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.device.DeviceNotAvailableException
	com.android.tradefed.targetprep.TargetSetupError
`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, 
                long timeout)

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

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

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

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

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

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

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

pullFile

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

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

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

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

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

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

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

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

pullFile

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

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

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

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

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

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

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

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

يسترد هذا الإجراء ملفًا من الجهاز ويعرض محتواه.

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

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

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

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

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

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

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

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

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

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

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

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`	إذا لم يكن الجهاز متاحًا بعد إعادة التشغيل

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

public String reboot (String command, 
                String reason)

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

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

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

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

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

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

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

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload ()

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

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

rebootUntilOnline

public abstract void rebootUntilOnline ()

بديل عن reboot() يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android.

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

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

بديل عن reboot() يحظر فقط إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android.

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

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

يُرجى الاطّلاع أيضًا على:

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

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

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

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

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

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

بديل عن rebootUserspace() ()} الذي يحظر فقط إلى أن يكون الجهاز متصلاً بالإنترنت، أي مرئيًا لأداة تصحيح أخطاء Android.

عمليات الطرح
`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, 
                Collection<ITestLifeCycleReceiver> listeners)

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

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

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

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

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

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

runInstrumentationTests

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

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

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

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

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

runInstrumentationTestsAsUser

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

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

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

القيم المُعادة
`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 erase أو `false` إذا كان يجب استخدام fastboot format.

يُرجى الاطّلاع أيضًا على:

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`	إذا ظل الجهاز لا يستجيب بعد انتهاء فترة waitTime

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

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