جهاز 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)
طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكل مبدئي منذ التوقيت العالمي المنسَّق (UTC) منذ بدء الجهاز من الجهاز و |
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 في حال حدوث خطأ داخلي |
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
|
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)
حظر الجهاز |
abstract
boolean
|
waitForDeviceNotAvailable(long waitTime)
قوالب عدم توفُّر الجهاز، أي أنّه غير متوفّر في adb |
abstract
void
|
waitForDeviceOnline()
يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb. |
abstract
void
|
waitForDeviceOnline(long waitTime)
يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb. |
abstract
boolean
|
waitForDeviceShell(long waitTime)
في انتظار استجابة الجهاز لأمر adb Shell الأساسي. |
الثوابت
UNKNOWN_API_LEVEL
public static final int UNKNOWN_API_LEVEL
القيمة التلقائية عندما يتعذّر رصد مستوى واجهة برمجة التطبيقات
قيمة ثابتة: -1 (0xffffffff)
الطرق العامة
تحقق منApiLevelAمقابلstNextRelease
public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
تحقَّق مما إذا كانت إحدى الميزات متوفّرة حاليًا بالمستوى الأدنى المتاح بها. تأخذ هذه الطريقة في الاعتبار الميزات التي لم يتم طرحها بعد، وذلك قبل رفع مستوى واجهة برمجة التطبيقات.
المعلّمات | |
---|---|
strictMinLevel |
int : الحد الأدنى المتشدد المُحتمل الذي يتيح استخدام الميزة. |
الركلات المردودة | |
---|---|
boolean |
صحيح إذا كان المستوى متوافقًا. خطأ في الحالات الأخرى. |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
clearLogcat
public abstract void clearLogcat ()
يؤدي هذا الإجراء إلى حذف أي بيانات متراكمة لبيانات Logcat.
ويُعدّ هذا الإجراء مفيدًا في الحالات التي تريد فيها التأكّد من أنّ ITestDevice#getLogcat()
لا يعرض سوى بيانات السجلّ التي تم إنشاؤها بعد نقطة معيّنة (على سبيل المثال، بعد تثبيت إصدار جديد من الجهاز، وما إلى ذلك).
حذف الملف
public abstract void deleteFile (String deviceFilePath)
طريقة مساعِدة لحذف ملف أو دليل على الجهاز
المعلّمات | |
---|---|
deviceFilePath |
String : المسار المطلق للملف على الجهاز |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
حذف الملف
public abstract void deleteFile (String deviceFilePath, int userId)
طريقة مساعِدة لحذف ملف أو دليل على الجهاز
المعلّمات | |
---|---|
deviceFilePath |
String : المسار المطلق للملف على الجهاز |
userId |
int : رقم تعريف المستخدم المطلوب الحذف منه |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
تمت إعادة تشغيل جهاز DeviceSoftLinux.
public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
طريقة مساعِدة لمعرفة ما إذا كان قد تمت إعادة تشغيل الجهاز بشكل مبدئي من خلال مقارنة System_server الحالي مع
System_server ProcessInfo
السابق استخدِم getProcessByName(String)
للحصول على ProcessInfo
.
المعلّمات | |
---|---|
prevSystemServerProcess |
ProcessInfo : عملية System_server السابقة ProcessInfo . |
الركلات المردودة | |
---|---|
boolean |
true في حال إعادة تشغيل الجهاز بشكل مبدئي |
الرميات | |
---|---|
RuntimeException |
إذا كان الجهاز به سبب تشغيل غير طبيعي |
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
تم إعادة تشغيل جهاز DeviceSoftاعتبارًا من
public abstract boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكل مبدئي منذ التوقيت العالمي المنسَّق (UTC) منذ بدء الجهاز من الجهاز وERROR(/TimeUnit)
. تشير "إعادة التشغيل الخفيف" إلى إعادة تشغيل system_server خارج
عملية إعادة التشغيل الثابتة للجهاز (على سبيل المثال: طلب إعادة التشغيل). يمكن الحصول على القيمة الحالية للرمز utcEpochTime في
Milliseccond من خلال الطريقة getDeviceDate()
.
المعلّمات | |
---|---|
utcEpochTime |
long : وقت الجهاز بالثواني منذ تاريخ بدء حساب الفترة |
timeUnit |
TimeUnit : الوحدة الزمنية TimeUnit لوقت utcEpochTime المحدّد |
الركلات المردودة | |
---|---|
boolean |
true في حال إعادة تشغيل الجهاز بشكل مبدئي |
الرميات | |
---|---|
RuntimeException |
إذا كان الجهاز به سبب تشغيل غير طبيعي |
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
إيقاف AdbRoot
public abstract boolean disableAdbRoot ()
يؤدي هذا الإجراء إلى إيقاف جذر الإعلان.
قد يؤدي إيقاف جذر adb إلى إلغاء ربط الجهاز بـ adb. سيتم حظر هذه الطريقة إلى أن يتوفّر الجهاز.
الركلات المردودة | |
---|---|
boolean |
true إذا كانت ناجحة. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
ويفعل الملف
public abstract boolean doesFileExist (String deviceFilePath)
طريقة مساعِدة لتحديد ما إذا كان الملف على الجهاز أم لا
المعلّمات | |
---|---|
deviceFilePath |
String : المسار المطلق للملف على الجهاز المطلوب التحقّق منه |
الركلات المردودة | |
---|---|
boolean |
true في حال توفّر الملف، وfalse في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
EnableAdbRoot
public abstract boolean enableAdbRoot ()
يفعِّل جذر الإعلان. في حال ضبط الإعداد "enable-root" على "خطأ"، سيتم تسجيل الرسالة وعرضها بدون تفعيل الجذر.
قد يؤدي تفعيل جذر adb إلى فصل الجهاز عن Adb. سيتم حظر هذه الطريقة إلى أن يتوفّر الجهاز.
الركلات المردودة | |
---|---|
boolean |
true إذا كانت ناجحة. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
تنفيذ AdbCommand
public abstract String executeAdbCommand (long timeout, String... commandArgs)
طريقة مساعد تنفِّذ أمر adb كأمر نظام مع انتهاء مهلة محددة.
يجب استخدام executeShellCommand(String)
بدلاً من ذلك كلّما أمكن، لأنّ هذه
الطريقة توفّر أداءً أفضل لرصد العطل ورصده بشكل أفضل.
المعلّمات | |
---|---|
timeout |
long : الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، و0 لتر بدون أي مهلة |
commandArgs |
String : أمر adb ووسيطاته المطلوب تشغيلهما |
الركلات المردودة | |
---|---|
String |
الأمر stdout from. null في حال تعذُّر تنفيذ الأمر. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
تنفيذ AdbCommand
public abstract String executeAdbCommand (String... commandArgs)
طريقة مساعِد تنفِّذ أمر adb كأمر نظام
يجب استخدام executeShellCommand(String)
بدلاً من ذلك كلّما أمكن، لأنّ هذه
الطريقة توفّر أداءً أفضل لرصد العطل ورصده بشكل أفضل.
المعلّمات | |
---|---|
commandArgs |
String : أمر adb ووسيطاته المطلوب تشغيلهما |
الركلات المردودة | |
---|---|
String |
الأمر stdout from. null في حال تعذُّر تنفيذ الأمر. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
تنفيذ AdbCommand
public abstract String executeAdbCommand (long timeout,envMap, String... commandArgs)
طريقة مساعد تنفِّذ أمر adb كأمر نظام مع انتهاء مهلة محددة.
يجب استخدام executeShellCommand(String)
بدلاً من ذلك كلّما أمكن، لأنّ هذه
الطريقة توفّر أداءً أفضل لرصد العطل ورصده بشكل أفضل.
المعلّمات | |
---|---|
timeout |
long : الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، و0 لتر بدون أي مهلة |
envMap |
: البيئة المطلوب إعدادها للأمر |
commandArgs |
String : أمر adb ووسيطاته المطلوب تشغيلهما |
الركلات المردودة | |
---|---|
String |
الأمر stdout from. null في حال تعذُّر تنفيذ الأمر. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
تنفيذ FastbootCommand
public abstract CommandResult executeFastbootCommand (long timeout, String... commandArgs)
الطريقة المساعِدة التي تنفِّذ أمر Fastboot كأمر نظام
من المتوقَّع أن يتم استخدامه عندما يكون الجهاز في وضع Fastboot (Fastboot mode).
المعلّمات | |
---|---|
timeout |
long : الوقت بالمللي ثانية قبل انتهاء صلاحية الأمر |
commandArgs |
String : أمر Fastboot ووسيطاته المطلوب تشغيلها |
الركلات المردودة | |
---|---|
CommandResult |
نتيجة CommandResult التي تحتوي على ناتج الأمر |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
تنفيذ FastbootCommand
public abstract CommandResult executeFastbootCommand (String... commandArgs)
طريقة مساعِد تنفّذ أمر Fastboot كأمر نظام مع انتهاء مهلة تلقائية تبلغ دقيقتين
من المتوقَّع أن يتم استخدامه عندما يكون الجهاز في وضع Fastboot (Fastboot mode).
المعلّمات | |
---|---|
commandArgs |
String : أمر Fastboot ووسيطاته المطلوب تشغيلها |
الركلات المردودة | |
---|---|
CommandResult |
نتيجة CommandResult التي تحتوي على ناتج الأمر |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
التنفيذ الطويلالسريع التمهيد للأمر
public abstract CommandResult executeLongFastbootCommand (String... commandArgs)
الطريقة المساعِدة التي تنفّذ أمر Fastboot طويل المدى كأمر نظام
مماثلة لـ executeFastbootCommand(String)
باستثناء استخدام مهلة أطول.
المعلّمات | |
---|---|
commandArgs |
String : أمر Fastboot ووسيطاته المطلوب تشغيلها |
الركلات المردودة | |
---|---|
CommandResult |
نتيجة CommandResult التي تحتوي على ناتج الأمر |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
التنفيذ الطويلالسريع التمهيد للأمر
public abstract CommandResult executeLongFastbootCommand (envVarMap, String... commandArgs)
الطريقة المساعدة التي تنفّذ أمر Fastboot طويل المدى كأمر نظام باستخدام متغيرات بيئة النظام.
مماثلة لـ executeFastbootCommand(String)
باستثناء استخدام مهلة أطول.
المعلّمات | |
---|---|
envVarMap |
: متغيرات بيئة النظام التي يتم استخدامها في أمر Fastboot (Fastboot) |
commandArgs |
String : أمر Fastboot ووسيطاته المطلوب تشغيلها |
الركلات المردودة | |
---|---|
CommandResult |
نتيجة CommandResult التي تحتوي على ناتج الأمر |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
تنفيذ ShellCommand
public abstract String executeShellCommand (String command)
الطريقة المساعدة التي تنفّذ أمر adb Shell وتعرض المخرجات في صورة String
المعلّمات | |
---|---|
command |
String : أمر adb Shell الذي سيتم تشغيله |
الركلات المردودة | |
---|---|
String |
إخراج واجهة المستخدم |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
تنفيذ ShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
ينفِّذ أمر adb Shell مع مزيد من المعلمات للتحكم في سلوك الأوامر.
المعلّمات | |
---|---|
command |
String : أمر adb Shell الذي سيتم تشغيله |
receiver |
IShellOutputReceiver : السمة IShellOutputReceiver المطلوب توجيه ناتج واجهة المستخدم إليها. |
maxTimeToOutputShellResponse |
long : الحد الأقصى للوقت الذي يتم خلاله السماح للأمر بعدم عرض أي استجابة، كما هو محدّد في timeUnit |
timeUnit |
TimeUnit : وحدة لـ maxTimeToOutputShellResponse |
retryAttempts |
int : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotAnswerException في حال تنفيذ retryAttempts بدون نجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
يُرجى الاطّلاع أيضًا على:
تنفيذ ShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
ينفِّذ أمر adb Shell مع مزيد من المعلمات للتحكم في سلوك الأوامر.
المعلّمات | |
---|---|
command |
String : أمر adb Shell الذي سيتم تشغيله |
receiver |
IShellOutputReceiver : السمة IShellOutputReceiver المطلوب توجيه ناتج واجهة المستخدم إليها. |
maxTimeoutForCommand |
long : الحد الأقصى للمهلة المحددة لإكمال الأمر، الوحدة كما هو محدد في timeUnit |
maxTimeToOutputShellResponse |
long : الحد الأقصى للوقت الذي يتم خلاله السماح للأمر بعدم عرض أي استجابة، كما هو محدّد في timeUnit |
timeUnit |
TimeUnit : وحدة لـ maxTimeToOutputShellResponse |
retryAttempts |
int : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ retryAttempts بدون نجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
يُرجى الاطّلاع أيضًا على:
تنفيذ ShellCommand
public abstract void executeShellCommand (String command, IShellOutputReceiver receiver)
لتنفيذ الأمر adb Shell، إعادة المحاولة عدة مرات إذا تعذّر الأمر.
تمثّل هذه السمة نموذجًا أبسط من executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
مع القيم التلقائية.
المعلّمات | |
---|---|
command |
String : أمر adb Shell الذي سيتم تشغيله |
receiver |
IShellOutputReceiver : السمة IShellOutputReceiver المطلوب توجيه ناتج واجهة المستخدم إليها. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
أمر executeShellV2Command
public abstract CommandResult executeShellV2Command (String command)
الطريقة المساعِدة التي تنفّذ أمر adb shell وتعرض النتائج كـ CommandResult
مع تعبئة مخرجات حالة الأمر وstdout وstderr
المعلّمات | |
---|---|
command |
String : الأمر الذي يجب تشغيله |
الركلات المردودة | |
---|---|
CommandResult |
هذه النتيجة باللغة CommandResult . |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
أمر executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, OutputStream pipeToOutput)
الطريقة المساعدة التي تنفّذ أمر adb Shell وتعرض النتائج على هيئة CommandResult
مع تعبئة الحقل بشكل صحيح بإخراج حالة الأمر، ويتم توجيه stderr. stdout إلى مصدر البيانات المحدّد.
المعلّمات | |
---|---|
command |
String : الأمر الذي يجب تشغيله |
pipeToOutput |
OutputStream : ERROR(/OutputStream) حيث ستتم إعادة توجيه إخراج std، أو حقل فارغ. |
الركلات المردودة | |
---|---|
CommandResult |
هذه النتيجة باللغة CommandResult . |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
أمر executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, File pipeAsInput)
الطريقة المساعدة التي تنفّذ أمر adb shell وتعرض النتائج كـ CommandResult
مع تعبئة مخرجات حالة الأمر وstdout وstderr
المعلّمات | |
---|---|
command |
String : الأمر الذي يجب تشغيله |
pipeAsInput |
File : عنصر ERROR(/File) الذي سيتم توجيهه كإدخال في الأمر أو فارغًا |
الركلات المردودة | |
---|---|
CommandResult |
هذه النتيجة باللغة CommandResult . |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
أمر executeShellV2Command
public abstract CommandResult executeShellV2Command (String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
ينفِّذ أمر adb Shell مع مزيد من المعلمات للتحكم في سلوك الأوامر.
المعلّمات | |
---|---|
command |
String : أمر adb Shell الذي سيتم تشغيله |
maxTimeoutForCommand |
long : الحد الأقصى للمهلة المحددة لإكمال الأمر، الوحدة كما هو محدد في timeUnit |
timeUnit |
TimeUnit : وحدة لـ maxTimeToOutputShellResponse |
retryAttempts |
int : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ retryAttempts بدون نجاح. |
الركلات المردودة | |
---|---|
CommandResult |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
يُرجى الاطّلاع أيضًا على:
أمر executeShellV2Command
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 : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ 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 : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ 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.
تُبلغ هذه الطريقة عن الإصدار الدقيق فقط إذا كانت السمة 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 (Fastboot).
الركلات المردودة | |
---|---|
String |
إصدار برنامج إقلاع String أو null إذا تعذّر العثور عليه |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
الحصول على عنوان البريد الإلكتروني البديل
public abstract String getBuildAlias ()
استرداد الاسم المستعار للإصدار الذي يعمل عليه الجهاز حاليًا.
يكون عادةً اسم الإصدار البديل سلسلة قابلة للقراءة أكثر من رقم تعريف الإصدار (يكون عادةً رقمًا لإصدارات Nexus). على سبيل المثال، يتضمن الإصدار الأخير من Android 4.2 اسمًا مستعارًا JDQ39 ومعرّف الإصدار 573038
الركلات المردودة | |
---|---|
String |
الاسم المستعار للإصدار أو الرجوع إلى معرّف الإصدار إذا تعذر استرداده |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
الحصول على BuildFLAor
public abstract String getBuildFlavor ()
استرداد سمة التصميم للجهاز
الركلات المردودة | |
---|---|
String |
نكهة التصميم أو قيمة خالية إذا تعذر استردادها |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
معرّف getBuildId
public abstract String getBuildId ()
يمكنك استرداد الإصدار الذي يعمل به الجهاز حاليًا.
الركلات المردودة | |
---|---|
String |
رقم تعريف الإصدار أو IBuildInfo#UNKNOWN_BUILD_ID إذا تعذّر استرداده |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
الحصول على عناصر توقيع المفاتيح
public abstract String getBuildSigningKeys ()
عرض نوع المفتاح المستخدَم لتوقيع صورة الجهاز
قد يتم عادةً توقيع أجهزة Android باستخدام مفاتيح اختبار (مثل AOSP) أو مفاتيح إصدار (تتحكّم فيها شركات مصنّعة فردية للأجهزة).
الركلات المردودة | |
---|---|
String |
مفتاح التوقيع في حال العثور عليه، فارغ. |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
GetcachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor ()
عرض DeviceDescriptor
مخزنة مؤقتًا إذا كان الجهاز مخصصًا، وبخلاف ذلك، يتم عرض
DeviceDescriptor
الحالي.
الركلات المردودة | |
---|---|
DeviceDescriptor |
GetcachedDeviceDescriptor
public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
عرض DeviceDescriptor
مخزنة مؤقتًا إذا كان الجهاز مخصصًا، وبخلاف ذلك، يتم عرض
DeviceDescriptor
الحالي.
المعلّمات | |
---|---|
shortDescriptor |
boolean : تحديد ما إذا كان الواصف يقتصر على الحد الأدنى من المعلومات أم لا |
الركلات المردودة | |
---|---|
DeviceDescriptor |
الحصول على أطفال
public abstract String[] getChildren (String deviceFilePath)
بديل لاستخدام IFileEntry
قد لا يعمل أحيانًا بسبب الأذونات.
المعلّمات | |
---|---|
deviceFilePath |
String : هو المسار الموجود على الجهاز حيث يتم البحث |
الركلات المردودة | |
---|---|
String[] |
مصفوفة من السلسلة تحتوي على كل الملف في مسار على الجهاز. |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
الحصول على الاتصال
public abstract AbstractConnection getConnection ()
يعرض الاتصال المرتبط بالجهاز.
الركلات المردودة | |
---|---|
AbstractConnection |
الحصول على فئة الجهاز
public abstract String getDeviceClass ()
الحصول على فئة الجهاز.
الركلات المردودة | |
---|---|
String |
فئة الجهاز String . |
الحصول على بيانات الجهاز
public abstract long getDeviceDate ()
عرض تاريخ الجهاز بالمللي ثانية منذ تاريخ بدء حساب الفترة
الركلات المردودة | |
---|---|
long |
تاريخ الجهاز بتنسيق الحقبة. |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
الحصول على أداة وصف الجهاز
public abstract DeviceDescriptor getDeviceDescriptor ()
يمكنك إرجاع DeviceDescriptor
من معلومات الجهاز للحصول على معلومات عنه بدون
تمرير كائن الجهاز الفعلي.
الركلات المردودة | |
---|---|
DeviceDescriptor |
الحصول على أداة وصف الجهاز
public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
يمكنك إرجاع DeviceDescriptor
من معلومات الجهاز للحصول على معلومات عنه بدون
تمرير كائن الجهاز الفعلي.
المعلّمات | |
---|---|
shortDescriptor |
boolean : تحديد ما إذا كان الواصف يقتصر على الحد الأدنى من المعلومات أم لا |
الركلات المردودة | |
---|---|
DeviceDescriptor |
الحصول على حالة الجهاز
public abstract TestDeviceState getDeviceState ()
تعرَّف على حالة الجهاز.
الركلات المردودة | |
---|---|
TestDeviceState |
الحصول على DeviceTimeOffset
public abstract long getDeviceTimeOffset (Date date)
المساعدة في معرفة فرق الوقت بين الجهاز وجهاز ERROR(/Date)
معيّن استخدِم وقت Epoch داخليًا.
المعلّمات | |
---|---|
date |
Date |
الركلات المردودة | |
---|---|
long |
الفرق بالملي ثانية |
الرميات | |
---|---|
DeviceNotAvailableException |
إخراج GetEmulator
public abstract InputStreamSource getEmulatorOutput ()
احصل على مجموعات بث الألعاب الأساسية والمحاكية
الركلات المردودة | |
---|---|
InputStreamSource |
ناتج المحاكي |
الحصول على مساحة تخزين خارجية مجانية
public abstract long getExternalStoreFreeSpace ()
طريقة مساعد لتحديد مقدار المساحة الخالية على وحدة التخزين الخارجية للجهاز.
الركلات المردودة | |
---|---|
long |
مقدار المساحة الخالية بالكيلوبايت |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
getFastbootProductType
public abstract String getFastbootProductType ()
طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
يجب عدم استخدام هذه الطريقة إلا إذا كان الجهاز في وضع Fastboot (Fastboot). وفي هذه الحالة، يُعدّ هذا الخيار أكثر أمانًا من طريقة getProductType()
العامة، لأنّ ITestDevice سيعرف إمكانية استرداد الجهاز في وضع التشغيل السريع إذا كان الجهاز في حالة غير صحيحة أو غير مستجيب.
الركلات المردودة | |
---|---|
String |
اسم نوع المنتج String أو null إذا تعذّر تحديده |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
getFastbootProductVariant
public abstract String getFastbootProductVariant ()
طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
يجب عدم استخدام هذه الطريقة إلا إذا كان الجهاز في وضع Fastboot (Fastboot). وفي هذه الحالة، يُعدّ هذا الخيار أكثر أمانًا من طريقة getProductType()
العامة، لأنّ ITestDevice سيعرف إمكانية استرداد الجهاز في وضع التشغيل السريع إذا كان الجهاز في حالة غير صحيحة أو غير مستجيب.
الركلات المردودة | |
---|---|
String |
اسم نوع المنتج String أو null إذا تعذّر تحديده |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
getFastbootSerialNumber
public abstract String getFastbootSerialNumber ()
لعرض الرقم التسلسلي لوضع Fastboot (Fastboot mode).
الركلات المردودة | |
---|---|
String |
الطريقة getFastbootVariable
public abstract String getFastbootVariable (String variableName)
يمكنك استرداد قيمة متغيّر Fastboot المحدّدة من الجهاز.
المعلّمات | |
---|---|
variableName |
String : اسم المتغيّر |
الركلات المردودة | |
---|---|
String |
قيمة الخاصية أو null إذا لم تكن موجودة |
الرميات | |
---|---|
|
supportedOperationException |
DeviceNotAvailableException |
إدخال ملف
public abstract IFileEntry getFileEntry (String path)
استرداد مرجع إلى ملف بعيد على الجهاز.
المعلّمات | |
---|---|
path |
String : مسار الملف المطلوب استرداده يمكن أن يكون مسارًا أو مسارًا مطلقًا مرتبطًا بـ "/". (أي أنّ بنية "/system" و "النظام" متوافقة) |
الركلات المردودة | |
---|---|
IFileEntry |
IFileEntry أو null إذا تعذّر العثور على الملف في path. |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
الحصول على IDevice
public abstract IDevice getIDevice ()
تعرض مرجعًا إلى ملف ddmlib IDevice
المرتبط.
قد يتم تخصيص IDevice
جديد من قِبل DDMS في كل مرة ينقطع فيها الجهاز
ويعيد ربطه بأداة adb. وبالتالي، يجب ألا يحتفظ المتصلون بمرجع IDevice
،
لأنّ هذا المرجع قد يصبح قديمًا.
الركلات المردودة | |
---|---|
IDevice |
IDevice |
موقع getIntProperty
public abstract long getIntProperty (String name, long defaultValue)
تعرض قيمة العدد الصحيح للسمة المحددة من الجهاز.
المعلّمات | |
---|---|
name |
String : اسم الموقع |
defaultValue |
long : القيمة التلقائية التي يتم عرضها إذا كانت السمة فارغة أو غير موجودة. |
الركلات المردودة | |
---|---|
long |
تكون قيمة السمة أو defaultValue إذا كانت فارغة أو غير متوفّرة أو لا تحتوي على عدد صحيح. |
الرميات | |
---|---|
DeviceNotAvailableException |
getLastExpectedResetTimeMillis
public abstract long getLastExpectedRebootTimeMillis ()
تعرض آخر مرة شغّلت فيها واجهات برمجة التطبيقات Tradefed إعادة التشغيل بالمللي ثانية منذ EPOCH كما تم عرضها بواسطة System.currentTimeMillis()
.
الركلات المردودة | |
---|---|
long |
الحصول على واجهة برمجة التطبيقات getLaunchApiLevel
public abstract int getLaunchApiLevel ()
يمكنك الحصول على مستوى واجهة برمجة التطبيقات الذي تم إطلاقه في الجهاز للمرة الأولى. وتكون القيمة التلقائية هي UNKNOWN_API_LEVEL
.
الركلات المردودة | |
---|---|
int |
عدد صحيح يشير إلى أول مستوى واجهة برمجة تطبيقات تم إطلاقه في الجهاز |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
الحصول على
public abstract InputStreamSource getLogcat ()
الحصول على بث موجز لبيانات Logcat
تعمل هذه الميزة في وضعَين:
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 |
الطريقة getUseFastboot تبيّن
public abstract boolean getUseFastbootErase ()
تعرَّف على ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
الركلات المردودة | |
---|---|
boolean |
true في حال استخدام محو البيانات بشكل سريع أو false في حال استخدام تنسيق Fastboot (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 وسيتم عرض DeviceNotavailableException.
المعلّمات | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner الذي يجري الاختبارات |
listeners |
: أدوات معالجة نتائج الاختبار |
الركلات المردودة | |
---|---|
boolean |
true في حال اكتمال الأمر التجريبي. false إذا تعذّر إكمال العملية بسبب استثناء في الاتصال بالجهاز، ولكن نجحت عملية الاسترداد |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استعادته، مثلاً تعذّر إكمال الأمر التجريبي وتعذُّر الاسترداد. |
runinstrumentationTestsAUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
هذه السمة مثل ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
ولكن
يتم إجراء الاختبار للمستخدم المحدّد.
المعلّمات | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
الركلات المردودة | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
runinstrumentationTestsAUser
public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
مثل ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
، ولكن يتم إجراء الاختبار لمستخدم معيَّن.
المعلّمات | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
الركلات المردودة | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
تاريخ الضبط
public abstract void setDate (Date date)
لضبط التاريخ على الجهاز
ملاحظة: يجب توفّر الجذر لضبط التاريخ على الجهاز.
المعلّمات | |
---|---|
date |
Date : حدِّد تاريخًا معيّنًا وسيتم استخدام تاريخ المضيف إذا كانت القيمة null |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
تعيين خيارات
public abstract void setOptions (TestDeviceOptions options)
ضبط TestDeviceOptions
للجهاز
المعلّمات | |
---|---|
options |
TestDeviceOptions |
خاصية set
public abstract boolean setProperty (String propKey, String propValue)
لضبط قيمة السمة المحدّدة على الجهاز يجب ضبط جذر adb على "صحيح".
المعلّمات | |
---|---|
propKey |
String : المفتاح الذي سيتم إعداده. |
propValue |
String : قيمة السمة التي سيتمّ ضبطها |
الركلات المردودة | |
---|---|
boolean |
تعرض الدالة True إذا كان الأمر setpr ناجحًا، ويكون False في الحالات الأخرى. |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
استعادة البيانات
public abstract void setRecovery (IDeviceRecovery recovery)
يمكنك ضبط IDeviceRecovery
حتى يتم استخدامها لهذا الجهاز. يجب ضبطها عند تخصيص الجهاز لأول مرة.
المعلّمات | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)
يمكنك ضبط وضع الاسترداد الحالي لاستخدامه على الجهاز.
يُستخدم للتحكم في طريقة الاسترداد التي سيتم استخدامها عند حدوث مشكلة في الاتصال بالجهاز. ويُنصَح باستخدام هذه الطريقة باعتدال عند الحاجة فقط (على سبيل المثال، عند تعطل إطار العمل، وما إلى ذلك.
المعلّمات | |
---|---|
mode |
ITestDevice.RecoveryMode : يجب تفعيل وضع "الاسترداد حتى الإنترنت فقط" أو عدم تفعيله. |
setUseFastboot تبيّن
public abstract void setUseFastbootErase (boolean useFastbootErase)
يمكنك ضبط ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
المعلّمات | |
---|---|
useFastbootErase |
boolean : true إذا كان يجب استخدام محو بيانات Fastboot أو false إذا كان يجب استخدام تنسيق Fastboot. |
يُرجى الاطّلاع أيضًا على:
startLogcat
public abstract void startLogcat ()
ابدأ التقاط مخرجات Logcat من الجهاز في الخلفية.
لن يكون لذلك أي تأثير إذا كان قد سبق تسجيل مخرجات Logcat. يمكن استرداد البيانات لاحقًا من خلال الطريقة getLogcat.
يجب الاتصال بـ "stopLogcat()
" إذا لم يعُد الجهاز قيد الاستخدام.
ليس من الضروري عادةً استدعاء startLogcat()
وstopLogcat()
عندما
يكون ضمن سياق استدعاء TF، حيث يبدأ إطار عمل TF ويوقفه.
جهاز إيقاف المحاكي
public abstract void stopEmulatorOutput ()
أغلِق نتائج المحاكي واحذفها.
إيقاف Logcat
public abstract void stopLogcat ()
أوقِف تسجيل مخرجات Logcat من الجهاز، وتجاهَل بيانات Logcat المحفوظة حاليًا.
ولن يكون لذلك أي تأثير إذا لم يتم تسجيل مخرجات Logcat.
SwitchToAdbTcp
public abstract String switchToAdbTcp ()
تبديل الجهاز إلى وضع adb-over-tcp
الركلات المردودة | |
---|---|
String |
الرقم التسلسلي لأداة tcp أو null في حال تعذّر تبديل الجهاز |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
SwitchToAdbUsb
public abstract boolean switchToAdbUsb ()
تبديل الجهاز إلى وضع adb عبر وضع USB.
الركلات المردودة | |
---|---|
boolean |
true إذا تمت عملية التبديل بنجاح، وfalse بخلاف ذلك. |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
مزامنة الملفات
public abstract boolean syncFiles (File localFileDir, String deviceFilePath)
يزامن هذا الإعداد محتوى دليل ملفات محلي مع الجهاز بشكل متزايد.
تحدد الملفات التي يتم إرسالها من خلال مقارنة الطوابع الزمنية للملفات المحلية مع الملفات المكافئة لها عن بُعد. سيتم إرسال الملفات "الأحدث" أو غير الموجودة فقط إلى الجهاز. وبالتالي، من المفترض أن تكون النفقات العامة صغيرة نسبيًا إذا كانت الملفات التي تم ضبطها على الجهاز مُحدّثة.
سيتم تجاهل الملفات المخفية (التي تبدأ أسماؤها بـ ".").
مثال على الاستخدام: سيتم إنشاء دليل SyncFiles("/tmp/files", "/sdcard") إذا لم يكن متوفرًا مسبقًا، وإرسال محتوى /tmp/files بشكل متكرّر إلى /sdcard/files.
المعلّمات | |
---|---|
localFileDir |
File : دليل الملفات المحلي الذي يحتوي على الملفات المطلوب فرضها بشكل متكرر. |
deviceFilePath |
String : جذر المسار المطلق للملف الوجهة البعيدة. يجب أن تكون جميع الأدلة في مسار الملف هذه قابلة للقراءة، أي أنّ الضغط على /data/local/tmp عندما لا يكون adb هو جذر |
الركلات المردودة | |
---|---|
boolean |
true إذا تمت مزامنة الملفات بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
فتح قفل الجهاز
public abstract boolean unlockDevice ()
يؤدي هذا الإجراء إلى فتح قفل الجهاز إذا كان في حالة مشفّرة.
قد تتم إعادة تشغيل إطار العمل باستخدام هذه الطريقة ولكنها لن تستدعيpostBootSetup()
. بالتالي،
قد لا يكون الجهاز جاهزًا بالكامل للاختبار عند إرجاع هذه الطريقة.
الركلات المردودة | |
---|---|
boolean |
true إذا نجحت العملية أو كان الجهاز غير مشفَّر. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
UnsupportedOperationException |
إذا لم يكن التشفير متاحًا على الجهاز. |
إلغاء تصحيح الأخطاء
public abstract void unmountDebugfs ()
إلغاء تحميل برامج تصحيح الأخطاء
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
انتظار ForBootComplete
public abstract boolean waitForBootComplete (long timeOut)
يحظر هذا الخيار إلى أن يتم ضبط علامة اكتمال تشغيل الجهاز.
المعلّمات | |
---|---|
timeOut |
long : الوقت بالميلي ثانية لانتظار ضبط العلامة |
الركلات المردودة | |
---|---|
boolean |
صحيح إذا تم ضبط علامة اكتمال تشغيل الجهاز خلال المهلة |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
انتظار_الجهاز متاح
public abstract boolean waitForDeviceAvailable ()
في انتظار أن يصبح الجهاز مستجيبًا ومتاحًا للاختبار. يتم استخدام المهلة التلقائية.
الركلات المردودة | |
---|---|
boolean |
صحيح إذا كان الجهاز متاحًا، وخطأ في حال إيقاف الاسترداد ولم يكن متاحًا. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
انتظار_الجهاز متاح
public abstract boolean waitForDeviceAvailable (long waitTime)
في انتظار أن يصبح الجهاز مستجيبًا ومتاحًا للاختبار.
المعلّمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
الركلات المردودة | |
---|---|
boolean |
صحيح إذا كان الجهاز متاحًا، وخطأ في حال إيقاف الاسترداد ولم يكن متاحًا. |
الرميات | |
---|---|
DeviceNotAvailableException |
إذا كان الجهاز لا يزال لا يستجيب بعد انتهاء وقت الانتظار. |
انتظار_الجهاز متاح_في_مسار الاسترداد
public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)
بانتظار أن يصبح الجهاز مستجيبًا ومتاحًا بدون وضع مسار الاسترداد في الاعتبار.
المعلّمات | |
---|---|
waitTime |
long |
الركلات المردودة | |
---|---|
boolean |
صحيح في حال توفُّر الجهاز، وخطأ في حال عدم توفّره. |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
برنامج setForDeviceBootloader
public abstract void waitForDeviceBootloader ()
يحظر هذا الإعداد ظهور الجهاز عبر Fastboot (Fastboot). استخدام المهلة التلقائية.
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
فترة الانتظارForDeviceInRecovery
public abstract boolean waitForDeviceInRecovery (long waitTime)
يحظر وصول الجهاز إلى حالة "استرداد adb" (يُرجى العلم أنّ هذه الحالة تختلف عن IDeviceRecovery
).
المعلّمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
الركلات المردودة | |
---|---|
boolean |
true في حال تم تشغيل الجهاز لعملية الاسترداد قبل انتهاء الوقت.
false في الحالات الأخرى |
فترة الانتظارForDeviceInSideload
public abstract boolean waitForDeviceInSideload (long waitTime)
حظر الجهاز
المعلّمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
الركلات المردودة | |
---|---|
boolean |
true في حال تم تشغيل الجهاز في التحميل الجانبي قبل انتهاء الوقت. false
في الحالات الأخرى |
فترة الانتظار للجهاز غير متاحة
public abstract boolean waitForDeviceNotAvailable (long waitTime)
قوالب عدم توفُّر الجهاز، أي أنّه غير متوفّر في adb
المعلّمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
الركلات المردودة | |
---|---|
boolean |
true إذا لم يصبح الجهاز متاحًا قبل انتهاء الوقت.
false في الحالات الأخرى |
انتظار الجهاز على الإنترنت
public abstract void waitForDeviceOnline ()
يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb. يتم استخدام المهلة التلقائية.
يُرجى العِلم أنّ الجهاز قد لا يستجيب بالضرورة للأوامر عند اكتمالها. استخدِم
waitForDeviceAvailable()
بدلاً من ذلك.
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
انتظار الجهاز على الإنترنت
public abstract void waitForDeviceOnline (long waitTime)
يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb.
يُرجى العِلم أنّ الجهاز قد لا يستجيب بالضرورة للأوامر عند اكتمالها. استخدِم
waitForDeviceAvailable()
بدلاً من ذلك.
المعلّمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
الرميات | |
---|---|
DeviceNotAvailableException |
في حال فقد الاتصال بالجهاز وتعذّر استرداده. |
انتظار ForDeviceShell
public abstract boolean waitForDeviceShell (long waitTime)
في انتظار استجابة الجهاز لأمر adb Shell الأساسي.
المعلّمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
الركلات المردودة | |
---|---|
boolean |
true إذا أصبح الجهاز متجاوبًا قبل انقضاء waitTime. |