جهاز INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

يوفّر واجهة برمجة تطبيقات موثوقة وعالية المستوى بعض الشيء لملف 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)

طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكلٍ مبدئي منذ التوقيت العالمي المنسَّق منذ بدء حساب الفترة الجهاز و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 في حال حدوث خطأ داخلي

default String getTrackingSerial()

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

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 setTrackingSerial(String trackingSerial)

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

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)

يحظر وصول الجهاز إلى الحقل "adb sideload" (التحميل الجانبي من 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 (0xfiff)

الطرق العامة

تحقق من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

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

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)

طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكلٍ مبدئي منذ التوقيت العالمي المنسَّق منذ بدء حساب الفترة الجهاز و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: الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب . سيتم طرح DeviceNotResponseException إذا كانت retryAttempts. يتم تنفيذها دون نجاح.
الرميات
DeviceNotAvailableException في حال فقد الاتصال بالجهاز وتعذر تم استرداده.

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

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

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

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

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

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

أمر executeShellV2Command

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

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

المعلمات
command String: أمر adb Shell الذي سيتم تشغيله
maxTimeoutForCommand long: الحد الأقصى لمهلة اكتمال الأمر، وحدة كـ محدد في timeUnit
timeUnit TimeUnit: وحدة لـ maxTimeToOutputShellResponse
المرتجعات
CommandResult

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

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

أمر executeShellV2Command

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

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

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

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

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

أمر executeShellV2Command

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

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

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

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

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

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. نصّ مختصر (TL;DR) لا تُبلغ هذه الطريقة عن الإصدار الدقيق إلا إذا كانت الخاصية 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).

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

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

public abstract String getBuildAlias ()

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

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

المرتجعات
String الاسم المستعار للإصدار أو الرجوع إلى معرّف الإصدار إذا تعذر استرداده
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

cannot translate

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) معيّن استخدام وقت الحقبة داخليًا.

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

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

الطريقة getFastbootProductVariant

public abstract String getFastbootProductVariant ()

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

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

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

getLastExpectedupgradeTimeMillis

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

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

    getMountPointInfo

    public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    المعلمات
    mountpoint String

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

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

    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

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

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

    public abstract long getTotalMemory ()

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

    المرتجعات
    long

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

    public String getTrackingSerial ()

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

    المرتجعات
    String

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

    public abstract boolean getUseFastbootErase ()

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

    المرتجعات
    boolean true في حال استخدام ميزة "محو بيانات Fastboot" أو false في حال تفعيل تنسيق Fastboot تنبؤي.

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

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

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

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

    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 وfalse" سيتم إرجاعه. الأمر التجريبي لن تتم إعادة تشغيله. ويتم تركه للمتصلين لإعادة المحاولة إذا لزم الأمر.

    في حال فقدان الاتصال بالجهاز قبل اكتمال إجراء الاختبار وتعذُّر عملية الاسترداد، سيتم إبلاغ المستمعين بـ 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

    runElementationTestsAUser

    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: ما إذا كان "الاسترداد حتى الإنترنت فقط" تمكين الوضع أم لا.

    تعيين الرقم التسلسلي

    public abstract void setTrackingSerial (String trackingSerial)

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

    المعلمات
    trackingSerial String

    setUseFastboot تبيّن

    public abstract void setUseFastbootErase (boolean useFastbootErase)

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

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

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

    startLogcat

    public abstract void startLogcat ()

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

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

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

    لا يلزم عادةً الاتصال بـ startLogcat() وstopLogcat() عند في سياق استدعاء TF، حيث يبدأ إطار عمل TF (TF) ويوقفه في سجلّ Logcat.

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

    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") /sdcard/files في حال غير موجودة أصلاً، وتدفع بشكل متكرر محتوى /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 في حال فقد الاتصال بالجهاز وتعذر تم استرداده.

    برنامج payForDeviceBootloader

    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)

    يحظر وصول الجهاز إلى الحقل "adb sideload" (التحميل الجانبي من adb) ولاية

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