جهاز 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 هو جهاز يعمل داخل آلة افتراضية نديرها عن بُعد من خلال مثيل مقاصد داخل الجهاز الافتراضي (VM).  NativeDevice التنفيذ التلقائي لأجهزة ITestDevice التي تعمل بنظام التشغيل Android غير المكدّسة بالكامل  NestedRemoteDevice تمثيل للجهاز الذي يعمل داخل جهاز افتراضي لسمكة حبَّار عن بُعد  RemoteAndroidDevice تنفيذ ITestDevice لجهاز Android حزمة كاملة متصل من خلال adb Connect.  RemoteAndroidVirtualDevice تعمل هذه السياسة على إطالة سلوك RemoteAndroidDevice لأجهزة Android ذات الحزمة الكاملة التي تعمل في Google Compute Engine (Gce).  جهاز الاختبار تنفيذ 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() يؤدي هذا الإجراء إلى إيقاف جذر الإعلان.
abstract boolean	doesFileExist(String deviceFilePath) طريقة مساعِدة لتحديد ما إذا كان الملف على الجهاز أم لا
abstract boolean	enableAdbRoot() يفعِّل جذر الإعلان.
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 طويل المدى كأمر نظام باستخدام متغيرات بيئة النظام.
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() احصل على مجموعات بث الألعاب الأساسية والمحاكية
abstract long	getExternalStoreFreeSpace() طريقة مساعد لتحديد مقدار المساحة الخالية على وحدة التخزين الخارجية للجهاز.
abstract String	getFastbootProductType() طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
abstract String	getFastbootProductVariant() طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
abstract String	getFastbootSerialNumber() لعرض الرقم التسلسلي لوضع Fastboot (Fastboot mode).
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/أفكارك كنقطة تثبيت.
abstract	getMountPointInfo() عرض نسخة محللة من المعلومات في الملف /proc/خاصية التثبيت على الجهاز
abstract long	getPartitionFreeSpace(String partition) طريقة مساعِدة لتحديد مقدار المساحة الخالية في قسم الجهاز
abstract ProcessInfo	getProcessByName(String processName) تشغِّل الطريقة المساعدة الأمرَين "pidof" و "stat" وتعرض الكائن ProcessInfo باستخدام معرّف PID ووقت بدء العملية المحدّدة.
abstract String	getProcessPid(String process) تعرض pid للخدمة أو صفرًا إذا حدث خطأ ما.
abstract String	getProductType() طريقة سهلة للحصول على نوع المنتج لهذا الجهاز
abstract String	getProductVariant() طريقة سهلة للحصول على نوع المنتج من هذا الجهاز
abstract String	getProperty(String name) استرِد قيمة السمة المحدّدة من الجهاز.
abstract ITestDevice.RecoveryMode	getRecoveryMode() يمكنك تفعيل وضع الاسترداد الحالي المستخدَم على الجهاز.
abstract String	getSerialNumber() طريقة سهلة للحصول على الرقم التسلسلي لهذا الجهاز.
abstract	getTombstones() يمكنك استرجاع قائمة ملفات Tombstones وإرجاعها من الأجهزة.
abstract long	getTotalMemory() عرض إجمالي حجم الذاكرة الفعلية بالبايت أو -1 في حال حدوث خطأ داخلي
abstract boolean	getUseFastbootErase() تعرَّف على ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
abstract boolean	isAdbRoot()
abstract boolean	isAdbTcp()
abstract boolean	isAppEnumerationSupported() التحقّق مما إذا كان النظام الأساسي على الجهاز يتيح تعداد التطبيقات
abstract boolean	isBypassLowTargetSdkBlockSupported() التحقّق مما إذا كان النظام الأساسي على الجهاز يتيح تجاوز مجموعة حزم تطوير البرامج (SDK) المستهدَفة المنخفضة في عمليات تثبيت التطبيقات
abstract boolean	isDebugfsMounted() تأكَّد من تثبيت برامج تصحيح الأخطاء.
abstract boolean	isDeviceEncrypted() يعرض هذا الخيار ما إذا كان الجهاز مشفرًا.
abstract boolean	isDirectory(String deviceFilePath) يمكنك عرض "صحيح" إذا كان المسار على الجهاز دليلاً وخطأ في الحالات الأخرى.
abstract boolean	isEncryptionSupported() يعرض هذا الخيار ما إذا كان التشفير متاحًا على الجهاز.
abstract boolean	isExecutable(String fullPath) يعرض True إذا كان مسار الملف على الجهاز ملفًا تنفيذيًا، وخطأ في الحالات الأخرى.
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) سجِّل رسالة في سجلّ الجهاز.
abstract void	mountDebugfs() حمّل برامج تصحيح الأخطاء.
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() يعيد تشغيل الجهاز في وضع الاسترداد (Recovery mode) باستخدام 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	setUseFastbootErase(boolean useFastbootErase) يمكنك ضبط ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
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() إلغاء تحميل برامج تصحيح الأخطاء
abstract boolean	waitForBootComplete(long timeOut) يحظر هذا الخيار إلى أن يتم ضبط علامة اكتمال تشغيل الجهاز.
abstract boolean	waitForDeviceAvailable() في انتظار أن يصبح الجهاز مستجيبًا ومتاحًا للاختبار.
abstract boolean	waitForDeviceAvailable(long waitTime) في انتظار أن يصبح الجهاز مستجيبًا ومتاحًا للاختبار.
abstract boolean	waitForDeviceAvailableInRecoverPath(long waitTime) بانتظار أن يصبح الجهاز مستجيبًا ومتاحًا بدون وضع مسار الاسترداد في الاعتبار.
abstract void	waitForDeviceBootloader() يحظر هذا الإعداد ظهور الجهاز عبر Fastboot (Fastboot).
abstract boolean	waitForDeviceInRecovery(long waitTime) يحظر وصول الجهاز إلى حالة "استرداد adb" (يُرجى العلم أنّ هذه الحالة تختلف عن IDeviceRecovery).
abstract boolean	waitForDeviceInSideload(long waitTime) حظر الجهاز
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)

الطرق العامة

تحقق منApiLevelAمقابلstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

المعلّمات
strictMinLevel	int: الحد الأدنى المتشدد المُحتمل الذي يتيح استخدام الميزة.

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

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

clearLogcat

public abstract void clearLogcat ()

يؤدي هذا الإجراء إلى حذف أي بيانات متراكمة لبيانات Logcat.

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

حذف الملف

public abstract void deleteFile (String deviceFilePath)

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

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

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

حذف الملف

public abstract void deleteFile (String deviceFilePath, 
                int userId)

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

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

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

تمت إعادة تشغيل جهاز DeviceSoftLinux.

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

تم إعادة تشغيل جهاز DeviceSoftاعتبارًا من

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

الركلات المردودة
boolean	true في حال إعادة تشغيل الجهاز بشكل مبدئي

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

إيقاف AdbRoot

public abstract boolean disableAdbRoot ()

يؤدي هذا الإجراء إلى إيقاف جذر الإعلان.

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

الركلات المردودة
boolean	true إذا كانت ناجحة.

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

ويفعل الملف

public abstract boolean doesFileExist (String deviceFilePath)

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

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

الركلات المردودة
boolean	true في حال توفّر الملف، وfalse في الحالات الأخرى.

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

EnableAdbRoot

public abstract boolean enableAdbRoot ()

يفعِّل جذر الإعلان. في حال ضبط الإعداد "enable-root" على "خطأ"، سيتم تسجيل الرسالة وعرضها بدون تفعيل الجذر.

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

الركلات المردودة
boolean	true إذا كانت ناجحة.

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

تنفيذ AdbCommand

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

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

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

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

الركلات المردودة
String	الأمر stdout from. null في حال تعذُّر تنفيذ الأمر.

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

تنفيذ AdbCommand

public abstract String executeAdbCommand (String... commandArgs)

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

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

المعلّمات
commandArgs	String: أمر adb ووسيطاته المطلوب تشغيلهما

الركلات المردودة
String	الأمر stdout from. null في حال تعذُّر تنفيذ الأمر.

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

تنفيذ AdbCommand

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

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

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

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

الركلات المردودة
String	الأمر stdout from. null في حال تعذُّر تنفيذ الأمر.

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

تنفيذ FastbootCommand

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

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

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

المعلّمات
timeout	long: الوقت بالمللي ثانية قبل انتهاء صلاحية الأمر
commandArgs	String: أمر Fastboot ووسيطاته المطلوب تشغيلها

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

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

تنفيذ FastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

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

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

المعلّمات
commandArgs	String: أمر Fastboot ووسيطاته المطلوب تشغيلها

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

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

التنفيذ الطويلالسريع التمهيد للأمر

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

الطريقة المساعِدة التي تنفّذ أمر Fastboot طويل المدى كأمر نظام

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

المعلّمات
commandArgs	String: أمر Fastboot ووسيطاته المطلوب تشغيلها

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

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

التنفيذ الطويلالسريع التمهيد للأمر

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

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

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

المعلّمات
envVarMap	: متغيرات بيئة النظام التي يتم استخدامها في أمر Fastboot (Fastboot)
commandArgs	String: أمر Fastboot ووسيطاته المطلوب تشغيلها

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

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

تنفيذ ShellCommand

public abstract String executeShellCommand (String command)

الطريقة المساعدة التي تنفّذ أمر adb Shell وتعرض المخرجات في صورة String

المعلّمات
command	String: أمر adb Shell الذي سيتم تشغيله

الركلات المردودة
String	إخراج واجهة المستخدم

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

تنفيذ ShellCommand

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: الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب استثناء. سيتم طرح DeviceNotAnswerException في حال تنفيذ retryAttempts بدون نجاح.

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

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

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

تنفيذ ShellCommand

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: الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ retryAttempts بدون نجاح.

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

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

• executeShellCommand(String, IShellOutputReceiver)
• TimeUtil

تنفيذ ShellCommand

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) حيث ستتم إعادة توجيه إخراج std، أو حقل فارغ.

الركلات المردودة
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: الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ 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) حيث ستتم إعادة توجيه إخراج std، أو حقل فارغ.
maxTimeoutForCommand	long: الحد الأقصى للمهلة المحددة لإكمال الأمر، الوحدة كما هو محدد في timeUnit
timeUnit	TimeUnit: وحدة لـ maxTimeToOutputShellResponse
retryAttempts	int: الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ 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) حيث ستتم إعادة توجيه إخراج std، أو حقل فارغ.
pipeToError	OutputStream: ERROR(/OutputStream) حيث ستتم إعادة توجيه خطأ ثابت، أو يكون فارغًا.
maxTimeoutForCommand	long: الحد الأقصى للمهلة المحددة لإكمال الأمر، الوحدة كما هو محدد في timeUnit
timeUnit	TimeUnit: وحدة لـ maxTimeToOutputShellResponse
retryAttempts	int: الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ retryAttempts بدون نجاح.

الركلات المردودة
CommandResult

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

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

• executeShellV2Command(String)
• TimeUtil

FastbootRemove Partition

public abstract CommandResult fastbootWipePartition (String partition)

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

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

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

المعلّمات
partition	String: القسم المطلوب حجبه

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

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

الحصول على مستوى أعلى

public abstract int getApiLevel ()

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

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

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

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

public abstract String getBasebandVersion ()

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

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

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

الحصول على البطارية

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 ()

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

الركلات المردودة
	خريطة وقت التشغيل (التوقيت العالمي المنسق (UTC) بالثانية منذ البداية) وسبب التشغيل

الرميات
DeviceNotAvailableException

cannot translate

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

الركلات المردودة
	خريطة وقت التشغيل (التوقيت العالمي المنسق (UTC) بالثانية منذ البداية) وسبب التشغيل

الرميات
DeviceNotAvailableException

getBootloaderVersion

public abstract String getBootloaderVersion ()

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

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

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

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

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

public abstract String getBuildAlias ()

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

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

الركلات المردودة
String	الاسم المستعار للإصدار أو الرجوع إلى معرّف الإصدار إذا تعذر استرداده

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

الحصول على BuildFLAor

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

الحصول على عناصر توقيع المفاتيح

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

الحصول على أطفال

public abstract String[] getChildren (String deviceFilePath)

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

المعلّمات
deviceFilePath	String: هو المسار الموجود على الجهاز حيث يتم البحث

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

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

الحصول على الاتصال

public abstract AbstractConnection getConnection ()

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

الركلات المردودة
AbstractConnection

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

public abstract String getDeviceClass ()

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

الركلات المردودة
String	فئة الجهاز String.

الحصول على بيانات الجهاز

public abstract long getDeviceDate ()

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

الركلات المردودة
long	تاريخ الجهاز بتنسيق الحقبة.

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

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

public abstract DeviceDescriptor getDeviceDescriptor ()

يمكنك إرجاع DeviceDescriptor من معلومات الجهاز للحصول على معلومات عنه بدون تمرير كائن الجهاز الفعلي.

الركلات المردودة
DeviceDescriptor

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

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

يمكنك إرجاع DeviceDescriptor من معلومات الجهاز للحصول على معلومات عنه بدون تمرير كائن الجهاز الفعلي.

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

الركلات المردودة
DeviceDescriptor

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

public abstract TestDeviceState getDeviceState ()

تعرَّف على حالة الجهاز.

الركلات المردودة
TestDeviceState

الحصول على DeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

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

المعلّمات
date	Date

الركلات المردودة
long	الفرق بالملي ثانية

الرميات
DeviceNotAvailableException

إخراج GetEmulator

public abstract InputStreamSource getEmulatorOutput ()

احصل على مجموعات بث الألعاب الأساسية والمحاكية

الركلات المردودة
InputStreamSource	ناتج المحاكي

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

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 (Fastboot mode).

الركلات المردودة
String

الطريقة getFastbootVariable

public abstract String getFastbootVariable (String variableName)

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

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

الركلات المردودة
String	قيمة الخاصية أو null إذا لم تكن موجودة

الرميات
	supportedOperationException
DeviceNotAvailableException

إدخال ملف

public abstract IFileEntry getFileEntry (String path)

استرداد مرجع إلى ملف بعيد على الجهاز.

المعلّمات
path	String: مسار الملف المطلوب استرداده يمكن أن يكون مسارًا أو مسارًا مطلقًا مرتبطًا بـ "/". (أي أنّ بنية "/system" و "النظام" متوافقة)

الركلات المردودة
IFileEntry	IFileEntry أو null إذا تعذّر العثور على الملف في path.

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

الحصول على IDevice

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

getLastExpectedResetTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

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

الركلات المردودة
long

الحصول على واجهة برمجة التطبيقات getLaunchApiLevel

public abstract int getLaunchApiLevel ()

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

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

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

الحصول على

public abstract InputStreamSource getLogcat ()

الحصول على بث موجز لبيانات Logcat

تعمل هذه الميزة في وضعَين:

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

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

الركلات المردودة
InputStreamSource

الحصول على

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.

الحصول على خلفية

public abstract InputStreamSource getLogcatSince (long date)

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

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

الركلات المردودة
InputStreamSource

الحصول على ماونت بوينت

public abstract String getMountPoint (String mountName)

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

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

قائمة المهام: نقل هذا السلوك إلى IDevice#getMountPoint(String)

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

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

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

• IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

المعلّمات
mountpoint	String

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

الرميات
DeviceNotAvailableException

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

• getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

عرض نسخة محللة من المعلومات في الملف /proc/خاصية التثبيت على الجهاز

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

الرميات
DeviceNotAvailableException

الحصول على تجزئة FreeSpace

public abstract long getPartitionFreeSpace (String partition)

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

المعلّمات
partition	String

الركلات المردودة
long	مقدار المساحة الخالية بالكيلوبايت

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

GetProcessByName

public abstract ProcessInfo getProcessByName (String processName)

تشغِّل الطريقة المساعدة الأمرَين "pidof" و "stat" وتعرض الكائن ProcessInfo باستخدام معرّف PID ووقت بدء العملية المحدّدة.

المعلّمات
processName	String: اسم العملية "سلسلة".

الركلات المردودة
ProcessInfo	ProcessInfo (معلومات العملية) المحددة

الرميات
DeviceNotAvailableException

أمر getProcessPid

public abstract String getProcessPid (String process)

تعرض pid للخدمة أو صفرًا إذا حدث خطأ ما.

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

الركلات المردودة
String

الرميات
DeviceNotAvailableException

الحصول على نوع المنتج

public abstract String getProductType ()

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

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

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

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

الحصول على منتج بديل

public abstract String getProductVariant ()

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

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

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

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

الحصول على الخاصية

public abstract String getProperty (String name)

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

المعلّمات
name	String: اسم الموقع

الركلات المردودة
String	قيمة الخاصية أو null إذا لم تكن موجودة

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

الحصول على وضع الاسترداد

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

يمكنك تفعيل وضع الاسترداد الحالي المستخدَم على الجهاز.

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

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

public abstract String getSerialNumber ()

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

الركلات المردودة
String	الرقم التسلسلي String

الحصول على تومبستون

public abstract  getTombstones ()

يمكنك استرجاع قائمة ملفات Tombstones وإرجاعها من الأجهزة. يجب توفّر الجذر.

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

الركلات المردودة
	قائمة بملفات Tombstone، فارغة في حال عدم وجود ملف Tombstone.

الرميات
DeviceNotAvailableException

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

• مستندات Tombstone

الحصول على إجمالي الذاكرة

public abstract long getTotalMemory ()

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

الركلات المردودة
long

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

public abstract boolean getUseFastbootErase ()

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

الركلات المردودة
boolean	true في حال استخدام محو البيانات بشكل سريع أو false في حال استخدام تنسيق Fastboot (Fastboot).

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

• fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

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

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

isAdbTcp

public abstract boolean isAdbTcp ()

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

متوافق مع عبارة isAppEnumeration

public abstract boolean isAppEnumerationSupported ()

التحقّق مما إذا كان النظام الأساسي على الجهاز يتيح تعداد التطبيقات

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

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

isBypassLowTargetSdkBlock متوافق

public abstract boolean isBypassLowTargetSdkBlockSupported ()

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

الركلات المردودة
boolean	صحيح في حال توفُّر كتلة حزمة SDK منخفضة الهدف، وخطأ في الحالات الأخرى

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

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

تأكَّد من تثبيت برامج تصحيح الأخطاء.

الركلات المردودة
boolean	true في حال تثبيت برامج تصحيح الأخطاء

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

يكون الجهاز مشفّرًا

public abstract boolean isDeviceEncrypted ()

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

الركلات المردودة
boolean	true إذا كان الجهاز مشفرًا.

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

الدليل

public abstract boolean isDirectory (String deviceFilePath)

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

المعلّمات
deviceFilePath	String

الركلات المردودة
boolean

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

متوافق مع isEncryption

public abstract boolean isEncryptionSupported ()

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

الركلات المردودة
boolean	true إذا كان الجهاز يتيح التشفير.

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

قابل للتنفيذ

public abstract boolean isExecutable (String fullPath)

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

المعلّمات
fullPath	String

الركلات المردودة
boolean

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

بلا واجهة مستخدم رسومية

public abstract boolean isHeadless ()

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

الركلات المردودة
boolean

الرميات
DeviceNotAvailableException

isRuntimePermission متوافق

public abstract boolean isRuntimePermissionSupported ()

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

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

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

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

تعرض القيمة "صحيح" إذا كان الجهاز في TestDeviceState#FASTBOOT أو TestDeviceState.FASTBOOTD.

الركلات المردودة
boolean

لوغاريتمات

public abstract boolean logAnrs (ITestLogger logger)

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

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

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

الرميات
DeviceNotAvailableException

تسجيل على الجهاز

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

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

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

إصلاح الأخطاء

public abstract void mountDebugfs ()

حمّل برامج تصحيح الأخطاء.

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

غير الحظر إعادة التشغيل

public abstract void nonBlockingReboot ()

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

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

إعداد postBootSetup

public abstract void postBootSetup ()

نفِّذ التعليمات لإعداد الجهاز لاختبار ذلك بعد كل تمهيد.

يجب طلب البيانات بعد تشغيل الجهاز بالكامل أو توفّره.

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

وقد تحتاج إلى استدعائها عند إعادة تشغيل الجهاز بسبب أحداث أخرى (مثلاً عند اكتمال أمر تحديث Fastboot)

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

سلسلة إجراءات ما بعد الاستدعاء

public void postInvocationTearDown ()

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

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

سلسلة إجراءات ما بعد الاستدعاء

public abstract void postInvocationTearDown (Throwable invocationException)

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

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

إعداد ما قبل الاستدعاء

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

سحب

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

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

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

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

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

سحب

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

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

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

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

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

ملف سحب

public abstract File pullFile (String remoteFilePath, 
                int userId)

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

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

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

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

ملف سحب

public abstract File pullFile (String remoteFilePath)

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

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

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

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

ملف سحب

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

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

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

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

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

ملف سحب

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

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

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

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

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

سحب ملف المحتويات

public abstract String pullFileContents (String remoteFilePath)

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

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

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

الرميات
DeviceNotAvailableException

سحب ملف من الخارج

public abstract File pullFileFromExternal (String remoteFilePath)

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

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

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

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

مفتاح الدفع

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

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

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

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

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

مفتاح الدفع

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

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

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

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

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

مفتاح الدفع

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

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

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

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

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

ملف الدفع

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

خيار pushFile(File, String) الذي يمكن أن يأخذ في الاعتبار تقييم الحاجة إلى موفّر المحتوى.

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

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

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

ملف الدفع

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

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

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

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

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

ملف الدفع

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

إعادة تشغيلفي برنامج التحميل

public abstract void rebootIntoBootloader ()

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

يؤدي هذا الخيار إلى حظر الجهاز إلى أن يكون الجهاز في وضع برنامج الإقلاع.

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

إعادة تشغيل IntoFastbootd

public abstract void rebootIntoFastbootd ()

يعيد تشغيل الجهاز في وضع Fastbootd.

يحظر هذا الإعداد وضع الجهاز في وضع Fastbootd.

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

إعادة التشغيل في عملية الاسترداد

public abstract void rebootIntoRecovery ()

يعيد تشغيل الجهاز في وضع الاسترداد (Recovery mode) باستخدام adb.

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

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

إعادة التشغيل في التحميل الجانبي

public abstract void rebootIntoSideload (boolean autoReboot)

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

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

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

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

إعادة التشغيل في التحميل الجانبي

public abstract void rebootIntoSideload ()

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

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

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

إعادة التشغيل حتى الإنترنت

public abstract void rebootUntilOnline ()

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

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

إعادة التشغيل حتى الإنترنت

public abstract void rebootUntilOnline (String reason)

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

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

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

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

• reboot(String)

إعادة تشغيل مساحة المستخدم

public abstract void rebootUserspace ()

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

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

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

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

إعادة تشغيلUserspace حتى الإنترنت

public abstract void rebootUserspaceUntilOnline ()

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

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

إعادة تحميل النظام للقراءة فقط

public abstract void remountSystemReadOnly ()

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

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

إعادة تثبيت النظام القابل للكتابة

public abstract void remountSystemWritable ()

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

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

إعادة تثبيت المورّدقراءة فقط

public abstract void remountVendorReadOnly ()

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

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

إعادة تركيب البائع

public abstract void remountVendorWritable ()

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

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

اختبارات Runالفيديو

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	في حال فقد الاتصال بالجهاز وتعذّر استعادته، مثلاً تعذّر إكمال الأمر التجريبي وتعذُّر الاسترداد.

اختبارات Runالفيديو

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

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

runinstrumentationTestsAUser

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

runinstrumentationTestsAUser

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

مثل ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)، ولكن يتم إجراء الاختبار لمستخدم معيَّن.

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

الركلات المردودة
boolean

الرميات
DeviceNotAvailableException

تاريخ الضبط

public abstract void setDate (Date date)

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

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

المعلّمات
date	Date: حدِّد تاريخًا معيّنًا وسيتم استخدام تاريخ المضيف إذا كانت القيمة null

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

تعيين خيارات

public abstract void setOptions (TestDeviceOptions options)

ضبط TestDeviceOptions للجهاز

المعلّمات
options	TestDeviceOptions

خاصية set

public abstract boolean setProperty (String propKey, 
                String propValue)

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

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

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

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

استعادة البيانات

public abstract void setRecovery (IDeviceRecovery recovery)

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

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

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

setUseFastboot تبيّن

public abstract void setUseFastbootErase (boolean useFastbootErase)

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

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

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

• fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

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

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

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

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

جهاز إيقاف المحاكي

public abstract void stopEmulatorOutput ()

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

إيقاف Logcat

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

مزامنة الملفات

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

سيتم تجاهل الملفات المخفية (التي تبدأ أسماؤها بـ ".").

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

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

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

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

فتح قفل الجهاز

public abstract boolean unlockDevice ()

يؤدي هذا الإجراء إلى فتح قفل الجهاز إذا كان في حالة مشفّرة.

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

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

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

إلغاء تصحيح الأخطاء

public abstract void unmountDebugfs ()

إلغاء تحميل برامج تصحيح الأخطاء

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

انتظار ForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

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

المعلّمات
timeOut	long: الوقت بالميلي ثانية لانتظار ضبط العلامة

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

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

انتظار_الجهاز متاح

public abstract boolean waitForDeviceAvailable ()

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

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

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

انتظار_الجهاز متاح

public abstract boolean waitForDeviceAvailable (long waitTime)

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

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

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

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

انتظار_الجهاز متاح_في_مسار الاسترداد

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

بانتظار أن يصبح الجهاز مستجيبًا ومتاحًا بدون وضع مسار الاسترداد في الاعتبار.

المعلّمات
waitTime	long

الركلات المردودة
boolean	صحيح في حال توفُّر الجهاز، وخطأ في حال عدم توفّره.

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

برنامج setForDeviceBootloader

public abstract void waitForDeviceBootloader ()

يحظر هذا الإعداد ظهور الجهاز عبر Fastboot (Fastboot). استخدام المهلة التلقائية.

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

فترة الانتظارForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

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

الركلات المردودة
boolean	true في حال تم تشغيل الجهاز لعملية الاسترداد قبل انتهاء الوقت. false في الحالات الأخرى

فترة الانتظارForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

حظر الجهاز

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

الركلات المردودة
boolean	true في حال تم تشغيل الجهاز في التحميل الجانبي قبل انتهاء الوقت. false في الحالات الأخرى

فترة الانتظار للجهاز غير متاحة

public abstract boolean waitForDeviceNotAvailable (long waitTime)

قوالب عدم توفُّر الجهاز، أي أنّه غير متوفّر في adb

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

الركلات المردودة
boolean	true إذا لم يصبح الجهاز متاحًا قبل انتهاء الوقت. false في الحالات الأخرى

انتظار الجهاز على الإنترنت

public abstract void waitForDeviceOnline ()

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

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

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

انتظار الجهاز على الإنترنت

public abstract void waitForDeviceOnline (long waitTime)

يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb.

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

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

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

انتظار ForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

في انتظار استجابة الجهاز لأمر adb Shell الأساسي.

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

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