جهاز 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 السابق هو |
abstract
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit 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,
طريقة مساعد تنفِّذ أمر adb كأمر نظام مع انتهاء مهلة محددة. |
abstract
CommandResult
|
executeFastbootCommand(long timeout, String... commandArgs)
الطريقة المساعِدة التي تنفِّذ أمر Fastboot كأمر نظام |
abstract
CommandResult
|
executeFastbootCommand(String... commandArgs)
الطريقة المساعِدة التي تنفّذ أمر Fastboot كأمر نظام مع انتهاء مهلة افتراضية دقيقتان. |
abstract
CommandResult
|
executeLongFastbootCommand(String... commandArgs)
الطريقة المساعِدة التي تنفّذ أمر Fastboot طويل المدى كأمر نظام |
abstract
CommandResult
|
executeLongFastbootCommand(
الطريقة المساعِدة التي تنفّذ أمر Fastboot طويل المدى كأمر نظام باستخدام النظام والمتغيرات البيئية. |
abstract
String
|
executeShellCommand(String command)
الطريقة المساعدة التي تنفّذ أمر adb Shell وتعرض المخرجات في صورة |
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 وتعرض النتائج كـ |
abstract
CommandResult
|
executeShellV2Command(String command, OutputStream pipeToOutput)
الطريقة المساعدة التي تنفِّذ أمر adb Shell وتعرض النتائج على هيئة |
abstract
CommandResult
|
executeShellV2Command(String command, File pipeAsInput)
الطريقة المساعدة التي تنفّذ أمر adb shell وتعرض النتائج كـ |
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()
عرض |
abstract
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
عرض |
abstract
String[]
|
getChildren(String deviceFilePath)
بديل لاستخدام |
abstract
AbstractConnection
|
getConnection()
يعرض الاتصال المرتبط بالجهاز. |
abstract
String
|
getDeviceClass()
الحصول على فئة الجهاز. |
abstract
long
|
getDeviceDate()
عرض تاريخ الجهاز بالمللي ثانية منذ تاريخ بدء حساب الفترة |
abstract
DeviceDescriptor
|
getDeviceDescriptor()
إرجاع |
abstract
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
إرجاع |
abstract
TestDeviceState
|
getDeviceState()
تعرَّف على حالة الجهاز. |
abstract
long
|
getDeviceTimeOffset(Date 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 |
abstract
long
|
getIntProperty(String name, long defaultValue)
تعرض قيمة العدد الصحيح للسمة المحددة من الجهاز. |
abstract
long
|
getLastExpectedRebootTimeMillis()
عرض آخر مرة شغّلت فيها واجهات برمجة التطبيقات Tradefed إعادة التشغيل بالمللي ثانية منذ EPOCH بالشكل
تم إرجاعه بواسطة |
abstract
int
|
getLaunchApiLevel()
يمكنك الحصول على مستوى واجهة برمجة التطبيقات الذي تم إطلاقه في الجهاز للمرة الأولى. |
abstract
InputStreamSource
|
getLogcat()
الحصول على بث موجز لبيانات Logcat |
abstract
InputStreamSource
|
getLogcat(int maxBytes)
يتيح هذا الإعداد الحصول على لقطة شاشة من آخر |
abstract
InputStreamSource
|
getLogcatDump()
يمكنك الحصول على ملف تفريغ لسجلّ Logcat الحالي الخاص بالجهاز. |
abstract
InputStreamSource
|
getLogcatSince(long date)
يتيح هذا الإجراء الحصول على لقطة من بيانات Logcat التي تم التقاطها اعتبارًا من التاريخ المحدَّد. |
abstract
String
|
getMountPoint(String mountName)
تعرض نقطة تثبيت. |
abstract
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
عرض |
abstract
|
getMountPointInfo()
عرض نسخة محللة من المعلومات في الملف /proc/خاصية التثبيت على الجهاز |
abstract
long
|
getPartitionFreeSpace(String partition)
طريقة مساعِدة لتحديد مقدار المساحة الخالية في قسم الجهاز |
abstract
ProcessInfo
|
getProcessByName(String processName)
تشغِّل الطريقة المساعدة "pidof". و"stat" وتُرجع الكائن |
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()
تعرض القيمة "صحيح" إذا كان الجهاز في |
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()
تم إيقاف هذه الطريقة نهائيًا.
يمكنك استخدام |
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)
استرداد ملف من الجهاز وتخزينه في |
abstract
File
|
pullFile(String remoteFilePath)
استرداد ملف من الجهاز وتخزينه في |
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)
طريقة ملائمة لاسترداد ملف من وحدة التخزين الخارجية للجهاز وتخزينها في
|
abstract
boolean
|
pushDir(File localDir, String deviceFilePath, int userId)
دفع محتوى الدليل إلى الجهاز بشكل متكرر. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath,
دفع محتويات الدليل إلى الجهاز بشكل متكرر مع استبعاد بعض الأدلة تمت تصفيته. |
abstract
boolean
|
pushDir(File localDir, String deviceFilePath)
دفع محتوى الدليل إلى الجهاز بشكل متكرر. |
abstract
boolean
|
pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)
صيغة |
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 باستخدام |
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()
بديل |
abstract
void
|
rebootUntilOnline(String reason)
بديل |
abstract
void
|
rebootUserspace()
يؤدي إلى إعادة تشغيل جزء "مساحة المستخدم" فقط من الجهاز. |
abstract
void
|
rebootUserspaceUntilOnline()
بديل |
abstract
void
|
remountSystemReadOnly()
ضبط جزء النظام على الجهاز للقراءة فقط |
abstract
void
|
remountSystemWritable()
جعل تقسيم النظام على الجهاز قابلاً للكتابة |
abstract
void
|
remountVendorReadOnly()
اضبط قسم المورِّد على الجهاز للقراءة فقط. |
abstract
void
|
remountVendorWritable()
جعل قسم البائع على الجهاز قابلاً للكتابة |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
طريقة ملائمة لإجراء |
abstract
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
إجراء اختبارات قياس حالة الجهاز وتوفير إمكانية استرداد الأجهزة |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
الأسعار نفسها في فندق |
abstract
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
مثل |
abstract
void
|
setDate(Date date)
لضبط التاريخ على الجهاز ملاحظة: يجب توفّر الجذر لضبط التاريخ على الجهاز. |
abstract
void
|
setOptions(TestDeviceOptions options)
ضبط |
abstract
boolean
|
setProperty(String propKey, String propValue)
لضبط قيمة السمة المحدّدة على الجهاز |
abstract
void
|
setRecovery(IDeviceRecovery recovery)
يمكنك ضبط |
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" (لاحظ أن هذا يختلف عن
|
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 |
تمت إعادة تشغيل جهاز 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)
طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكلٍ مبدئي منذ التوقيت العالمي المنسَّق منذ بدء حساب الفترة
الجهاز و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 abstractgetBootHistory ()
تجمع الطريقة المساعِدة خريطة سجلّ التشغيل مع وقت التشغيل وسببه.
المرتجعات | |
---|---|
|
خريطة وقت التشغيل (التوقيت العالمي المنسق (UTC) بالثانية منذ البداية) وسبب التشغيل |
الرميات | |
---|---|
DeviceNotAvailableException |
cannot translate
public abstractgetBootHistorySince (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 |
الحصول على 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)
معيّن استخدام وقت الحقبة
داخليًا.
المعلمات | |
---|---|
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 |
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
تعمل هذه الميزة في وضعَين:
TestDeviceOptions.getMaxLogcatDataSize()
بايت من المحتوى الحالي للخلفية.
تسجيل أداة 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 abstractgetMountPointInfo ()
عرض نسخة محللة من المعلومات في الملف /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 abstractgetTombstones ()
يمكنك استرجاع قائمة ملفات 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 |
في حال فقد الاتصال بالجهاز وتعذر تم استرداده. بمعنى أنه تعذّر إكمال الأمر التجريبي وفشل الاسترداد. |
runElementationTestsAUser
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") بناءً على لم تكن موجودة مسبقًا، وتدفع بشكل متكرر محتوى /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)
يحظر وصول الجهاز إلى الحقل "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. |