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

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

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

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

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

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

الثوابت

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

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

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

الطُرق العامة

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

المعلمات
`strictMinLevel`	‫`int`: الحد الأدنى الصارم للمستوى الذي تتوفّر فيه الميزة.

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

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

clearLogcat

public abstract void clearLogcat ()

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

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

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

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

disableAdbRoot

public abstract boolean disableAdbRoot ()

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

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

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

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

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

executeAdbCommand

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

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

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

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

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

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

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

executeAdbCommand

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

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

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

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

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

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

executeAdbV2Command

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

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

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

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

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

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

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

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

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

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

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

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

executeAdbV2Command

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

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

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

المعلمات
`timeout`	‫`long`: الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، 0L لعدم تحديد مهلة
`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 ( envVarMap, 
                String... commandArgs)

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

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

المعلمات
`envVarMap`	: متغيرات بيئة النظام التي يتم تشغيل أمر 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, 
                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`	في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

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

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

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

executeShellV2Command

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

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

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

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

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

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

executeShellV2Command

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

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

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

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

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

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

executeShellV2Command

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

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

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

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

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

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

executeShellV2Command

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

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

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

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

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBattery

public abstract Integer getBattery ()

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

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

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

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

الرميات
`DeviceNotAvailableException`

getBootHistory

public abstract  getBootHistory ()

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

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

الرميات
`DeviceNotAvailableException`

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

الرميات
`DeviceNotAvailableException`

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

تعرِض هذه السمة قيمة 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)

دالة مساعدة للحصول على فرق الوقت بين الجهاز وقيمة ERROR(/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`

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 في الخلفية

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

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

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

يحصل على لقطة من آخر maxBytes من بيانات logcat التي تم التقاطها.

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

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

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

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

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

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

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

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

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

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

getMountPoint

public abstract String getMountPoint (String mountName)

تعرِض هذه السمة نقطة تثبيت.

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

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

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

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

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

IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

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

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

الرميات
`DeviceNotAvailableException`

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

getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

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

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

الرميات
`DeviceNotAvailableException`

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

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

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

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

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

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

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

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

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

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

الرميات
`DeviceNotAvailableException`

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

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

getTotalMemory

public abstract long getTotalMemory ()

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

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

getTrackingSerial

public String getTrackingSerial ()

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

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

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

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

المرتجعات
`boolean`	`true` إذا كان سيتم استخدام fastboot 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.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

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

pullDir

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

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

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

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

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

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

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

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

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

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

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

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

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

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

pullFile

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

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

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

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

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

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

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

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

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

الرميات
`DeviceNotAvailableException`

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

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

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

pushDir

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

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

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

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

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

pushDir

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

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

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

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

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

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

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

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

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

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

pushFile

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

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

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

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

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

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

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

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

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

pushFile

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

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

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

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

تعيد هذه السياسة تشغيل الجهاز في وضع تصحيح أخطاء Android.

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

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

إعادة تشغيل

public abstract void reboot (String reason)

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

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

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

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

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

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

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

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

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

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

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

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

يعيد تشغيل الجهاز في وضع الاسترداد adb.

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

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

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف باستخدام 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, 
                ITestLifeCycleReceiver... listeners)

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

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

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

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

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

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

runInstrumentationTestsAsUser

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

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

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

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

الرميات
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

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

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

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

الرميات
`DeviceNotAvailableException`

setDate

public abstract void setDate (Date date)

تضبط هذه السمة التاريخ على الجهاز

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

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

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

setOptions

public abstract void setOptions (TestDeviceOptions options)

ضبط TestDeviceOptions للجهاز

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

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

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

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

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

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

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

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

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

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

المعلمات
`useFastbootErase`	`boolean`: `true` إذا كان يجب استخدام fastboot 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"

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