INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

الفئات الفرعية غير المباشرة المعروفة ‫IManagedTestDevice وITestDevice وLocalAndroidVirtualDevice وManagedRemoteDevice وNativeDevice وNestedRemoteDevice وRemoteAndroidDevice وRemoteAndroidVirtualDevice وTestDevice IManagedTestDevice واجهة برمجة تطبيقات ITestDevice التي تتم إدارة دورة حياتها  ITestDevice يوفّر واجهة برمجة تطبيقات موثوقة وذات مستوى أعلى قليلاً من واجهة برمجة التطبيقات 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 مزوّد بمجموعة كاملة من الأدوات

---

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

الثوابت

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

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

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

الطرق العامة

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

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

clearLogcat

public abstract void clearLogcat ()

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath)

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

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

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

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

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

المرتجعات
boolean	true في حال إعادة تشغيل الجهاز من خلال إعادة التشغيل الناعم

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

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

المرتجعات
boolean	true في حال إعادة تشغيل الجهاز من خلال إعادة التشغيل الناعم

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

disableAdbRoot

public abstract boolean disableAdbRoot ()

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

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

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

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

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

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

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

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

enableAdbRoot

public abstract boolean enableAdbRoot ()

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

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

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

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

executeAdbCommand

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

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

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

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

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

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

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

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

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

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

executeAdbCommand

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

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

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

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

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

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

executeFastbootCommand

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

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

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

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

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

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

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

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

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

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

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

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

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

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

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

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

executeLongFastbootCommand

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

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

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

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

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

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

executeShellCommand

public abstract String executeShellCommand (String command)

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

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

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

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

executeShellCommand

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

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

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

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

راجِع أيضًا:

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

executeShellCommand

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

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

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

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

راجِع أيضًا:

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

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

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

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

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

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

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

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

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

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

executeShellV2Command

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

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

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

المرتجعات
CommandResult

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

راجِع أيضًا:

• executeShellV2Command(String)
• TimeUtil

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(String)
• TimeUtil

executeShellV2Command

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

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

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

المرتجعات
CommandResult

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

راجِع أيضًا:

• executeShellV2Command(String)
• TimeUtil

executeShellV2Command

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

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

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

المرتجعات
CommandResult

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

راجِع أيضًا:

• executeShellV2Command(String)
• TimeUtil

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

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

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

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

getApiLevel

public abstract int getApiLevel ()

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

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

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

getBasebandVersion

public abstract String getBasebandVersion ()

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

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

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

getBattery

public abstract Integer getBattery ()

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

المرتجعات
Integer

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

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

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

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

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

getBootHistory

public abstract  getBootHistory ()

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

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

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

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

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

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

getBuildAlias

public abstract String getBuildAlias ()

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

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

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

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

getBuildFlavor

public abstract String getBuildFlavor ()

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

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

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

getBuildId

public abstract String getBuildId ()

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

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

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

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

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

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

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

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

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

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

المرتجعات
DeviceDescriptor

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

تعرِض هذه السمة قيمة 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	تاريخ الجهاز بتنسيق بدء الفترة

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

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

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

المرتجعات
DeviceDescriptor

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

المرتجعات
DeviceDescriptor

getDeviceState

public abstract TestDeviceState getDeviceState ()

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

المرتجعات
TestDeviceState

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

المعلمات
date	Date

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

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

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

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

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

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

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

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

getFastbootProductType

public abstract String getFastbootProductType ()

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

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

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

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

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

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

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

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

المرتجعات
String

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

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

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

getFileEntry

public abstract IFileEntry getFileEntry (String path)

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

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

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

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

getIDevice

public abstract IDevice getIDevice ()

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

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

المرتجعات
IDevice	IDevice

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

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

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

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

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

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

المرتجعات
long

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

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

getLogcat

public abstract InputStreamSource getLogcat ()

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

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

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

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

المرتجعات
InputStreamSource

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

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

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

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

المرتجعات
InputStreamSource

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

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

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

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

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

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

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

المرتجعات
InputStreamSource

getMountPoint

public abstract String getMountPoint (String mountName)

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

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

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

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

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

راجِع أيضًا:

• IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

المعلمات
mountpoint	String

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

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

راجِع أيضًا:

• getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

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

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

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

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

المعلمات
partition	String

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

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

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

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

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

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

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

getProcessPid

public abstract String getProcessPid (String process)

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

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

المرتجعات
String

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

getProductType

public abstract String getProductType ()

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

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

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

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

getProductVariant

public abstract String getProductVariant ()

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

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

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

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

getProperty

public abstract String getProperty (String name)

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

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

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

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

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getSerialNumber

public abstract String getSerialNumber ()

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

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

getTombstones

public abstract  getTombstones ()

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

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

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

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

راجِع أيضًا:

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

getTotalMemory

public abstract long getTotalMemory ()

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

المرتجعات
long

getTrackingSerial

public String getTrackingSerial ()

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

المرتجعات
String

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

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

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

راجِع أيضًا:

• fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

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

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

isAdbTcp

public abstract boolean isAdbTcp ()

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

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

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

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

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

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

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

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

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

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

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

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

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

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

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

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

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

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

المعلمات
deviceFilePath	String

المرتجعات
boolean

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

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

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

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

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

isExecutable

public abstract boolean isExecutable (String fullPath)

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

المعلمات
fullPath	String

المرتجعات
boolean

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

isHeadless

public abstract boolean isHeadless ()

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

المرتجعات
boolean

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

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

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

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

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

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

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

المرتجعات
boolean

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

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

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

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

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

logOnDevice

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

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

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

mountDebugfs

public abstract void mountDebugfs ()

شغِّل debugfs.

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

nonBlockingReboot

public abstract void nonBlockingReboot ()

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

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

postBootSetup

public abstract void postBootSetup ()

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

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

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

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

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

postInvocationTearDown

public void postInvocationTearDown ()

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

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

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

preInvocationSetup

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

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

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

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

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

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

pullDir

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

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

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

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

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

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

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

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

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

pullFile

public abstract File pullFile (String remoteFilePath)

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

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

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

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

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

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

pullFile

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

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

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

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

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

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

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

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

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

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

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

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

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

pushDir

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

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

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

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

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

pushDir

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

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

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

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

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

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

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

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

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

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

pushFile

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

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

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

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

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

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

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

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

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

pushFile

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

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

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

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

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

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

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

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

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

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

إعادة تشغيل

public abstract void reboot ()

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

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

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

إعادة تشغيل

public abstract void reboot (String reason)

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

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

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

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

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

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

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

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

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

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

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

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

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

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

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

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

rebootIntoSideload

public abstract void rebootIntoSideload ()

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

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

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

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

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

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

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

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

راجِع أيضًا:

• reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

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

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

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

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

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

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

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

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

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

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

remountSystemWritable

public abstract void remountSystemWritable ()

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

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

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

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

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

remountVendorWritable

public abstract void remountVendorWritable ()

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

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

runInstrumentationTests

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

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

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

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

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

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

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

runInstrumentationTestsAsUser

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

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

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

المرتجعات
boolean

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

runInstrumentationTestsAsUser

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

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

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

المرتجعات
boolean

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

setDate

public abstract void setDate (Date date)

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

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

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

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

setOptions

public abstract void setOptions (TestDeviceOptions options)

ضبط TestDeviceOptions للجهاز

المعلمات
options	TestDeviceOptions

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

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

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

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

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

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

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

المعلمات
trackingSerial	String

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

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

راجِع أيضًا:

• fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

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

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

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

stopLogcat

public abstract void stopLogcat ()

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

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

switchToAdbTcp

public abstract String switchToAdbTcp ()

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

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

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

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

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

المرتجعات
boolean	‫true إذا تم التبديل بنجاح، false في حال عدم نجاحه

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

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

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

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

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

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

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

unlockDevice

public abstract boolean unlockDevice ()

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

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

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

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

unmountDebugfs

public abstract void unmountDebugfs ()

ألغِ تثبيت debugfs.

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

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

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

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

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

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

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

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

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

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

المعلمات
waitTime	long

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

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

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

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

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

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

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

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

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

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

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

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

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

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

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

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

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

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

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

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

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

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

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

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