NativeDevice

public class NativeDevice
extends Object implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver

java.lang.Object
com.android.tradefed.device.NativeDevice


التنفيذ الافتراضي لأجهزة Android غير الكاملة من ITestDevice .

ملخص

فصول متداخلة

class NativeDevice.AdbAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) أثناء تشغيل أمر "adb ...." الخاص بنظام التشغيل.

class NativeDevice.AdbShellAction

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) لإعادة تشغيل الجهاز.

الثوابت

int INVALID_USER_ID

القيمة التي تم إرجاعها لأي معرف مستخدم غير صالح/لم يتم العثور عليه: حدد UserHandle القيمة -10000

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

العدد الافتراضي لمحاولات إعادة محاولة تنفيذ الأمر

مجالات

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

المقاولين العامة

NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

يقوم بإنشاء TestDevice .

الأساليب العامة

void batchPrefetchStartupBuildProps ()

التحسين الجزئي (حوالي 400 ملي) عن طريق الجلب المسبق لجميع العناصر التي نحتاجها بدلاً من استدعاء "adb getprop" لكل واحدة.

boolean canSwitchToHeadlessSystemUser ()

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

boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

تحقق مما إذا كانت الميزة مدعومة حاليًا أم لا في ظل الحد الأدنى من مستوى الدعم.

boolean checkConnectivity ()

تأكد من أن الجهاز لديه اتصال بالشبكة.

boolean clearErrorDialogs ()

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

void clearLastConnectedWifiNetwork ()

مسح آخر شبكة wifi متصلة.

void clearLogcat ()

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

boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

يتصل بشبكة واي فاي.

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

يتصل بشبكة واي فاي.

boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

يتصل بشبكة wifi.f

boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

يتصل بشبكة واي فاي.

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

متغير من connectToWifiNetwork(String, String) الذي يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.

boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

متغير من connectToWifiNetwork(String, String) الذي يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.

int createUser (String name, boolean guest, boolean ephemeral)

قم بإنشاء مستخدم باسم معين والأعلام المقدمة

int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)

قم بإنشاء مستخدم باسم معين والأعلام المقدمة

int createUser (String name)

أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.

int createUserNoThrow (String name)

أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.

void deleteFile (String deviceFilePath)

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

void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

يزيل IDeviceActionReceiver المسجل .

boolean deviceSoftRestarted ( ProcessInfo prevSystemServerProcess)

طريقة مساعدة للتحقق مما إذا كان الجهاز قد تمت إعادة تشغيله من خلال مقارنة خادم النظام الحالي مع خادم System_server السابق ProcessInfo .

boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)

طريقة مساعدة للتحقق مما إذا كان الجهاز قد تمت إعادة تشغيله بشكل بسيط منذ وقت UTC منذ فترة من الجهاز ERROR(/TimeUnit) .

boolean disableAdbRoot ()

يقوم بإيقاف تشغيل جذر adb.

void disableKeyguard ()

محاولات لتعطيل حارس المفاتيح.

boolean disableNetworkMonitor ()

تعطيل مراقبة الشبكة على الجهاز.

boolean disconnectFromWifi ()

قطع الاتصال بشبكة wifi.

boolean doesFileExist (String deviceFilePath, int userId)

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

boolean doesFileExist (String deviceFilePath)

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

File dumpHeap (String process, String devicePath)

محاولة تفريغ الكومة من system_server.

boolean enableAdbRoot ()

يقوم بتشغيل بنك التنمية الآسيوي الجذر.

boolean enableNetworkMonitor ()

تمكين مراقبة الشبكة على الجهاز.

String executeAdbCommand (long timeout, String... cmdArgs)

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

String executeAdbCommand (long timeout, envMap, String... cmdArgs) executeAdbCommand (long timeout, envMap, String... cmdArgs)

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

String executeAdbCommand (String... cmdArgs)

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

CommandResult executeFastbootCommand (String... cmdArgs)

أسلوب مساعد يقوم بتنفيذ أمر fastboot كأمر نظام مع مهلة افتراضية مدتها دقيقتين.

CommandResult executeFastbootCommand (long timeout, String... cmdArgs)

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

CommandResult executeLongFastbootCommand (String... cmdArgs)

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

CommandResult executeLongFastbootCommand ( envVarMap, String... cmdArgs) executeLongFastbootCommand ( envVarMap, String... cmdArgs)

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

String executeShellCommand (String command)

الأسلوب المساعد الذي ينفذ أمر adb Shell ويعيد الإخراج String .

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

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

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

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

void executeShellCommand (String command, IShellOutputReceiver receiver)

ينفذ أمر adb Shell المحدد، ويعيد المحاولة عدة مرات في حالة فشل الأمر.

CommandResult executeShellV2Command (String cmd)

أسلوب مساعد ينفذ أمر adb Shell ويعيد النتائج على هيئة CommandResult التي يتم ملؤها بشكل صحيح بمخرجات حالة الأمر وstdout وstderr.

CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)

الأسلوب المساعد الذي ينفذ أمر adb Shell ويعيد النتائج على شكل CommandResult التي يتم ملؤها بشكل صحيح بمخرجات حالة الأمر وstderr.

CommandResult executeShellV2Command (String cmd, File pipeAsInput)

أسلوب مساعد ينفذ أمر adb Shell ويعيد النتائج على شكل CommandResult التي يتم ملؤها بشكل صحيح بمخرجات حالة الأمر وstdout وstderr.

CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)

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

CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)

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

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

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

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

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

CommandResult fastbootWipePartition (String partition)

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

getActiveApexes ()

جلب المعلومات حول APEXes المنشط على الجهاز.

getAllSettings (String namespace)

إرجاع أزواج القيمة الرئيسية لمساحة الاسم المطلوبة.

DeviceAllocationState getAllocationState ()

إرجاع حالة التخصيص الحالية للجهاز

String getAndroidId (int userId)

ابحث عن معرف android المرتبط بمعرف المستخدم وأعده، ويكون فارغًا إذا لم يتم العثور عليه.

getAndroidIds ()

قم بإنشاء خريطة لمعرفات android التي تم العثور عليها مطابقة لمعرفات المستخدمين.

int getApiLevel ()

احصل على مستوى API للجهاز.

PackageInfo getAppPackageInfo (String packageName)

جلب معلومات حول الحزمة المثبتة على الجهاز.

getAppPackageInfos ()

جلب معلومات الحزم المثبتة على الجهاز.

String getBasebandVersion ()

الطريقة الملائمة للحصول على إصدار النطاق الأساسي (الراديو) لهذا الجهاز.

Integer getBattery ()

يُرجع مستوى البطارية الحالي لجهاز ما أو يُرجع Null إذا كان مستوى البطارية غير متاح.

boolean getBooleanProperty (String name, boolean defaultValue)

إرجاع قيمة منطقية للخاصية المحددة.

getBootHistory ()

تقوم الطريقة المساعدة بجمع خريطة محفوظات التمهيد مع وقت التمهيد وسبب التمهيد.

getBootHistorySince (long utcEpochTime, TimeUnit timeUnit)

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

String getBootloaderVersion ()

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

InputStreamSource getBugreport ()

استرداد تقرير الأخطاء من الجهاز.

InputStreamSource getBugreportz ()

يسترد تقرير الأخطاء من الجهاز.

String getBuildAlias ()

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

String getBuildFlavor ()

استرجاع نكهة البناء للجهاز.

String getBuildId ()

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

String getBuildSigningKeys ()

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

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

DeviceDescriptor getCachedDeviceDescriptor ()

يتم إرجاع DeviceDescriptor المخزن مؤقتًا إذا تم تخصيص الجهاز، وإلا فإنه يتم إرجاع DeviceDescriptor الحالي.

DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

يتم إرجاع DeviceDescriptor المخزن مؤقتًا إذا تم تخصيص الجهاز، وإلا فإنه يتم إرجاع DeviceDescriptor الحالي.

String[] getChildren (String path)

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

AbstractConnection getConnection ()

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

DeviceFoldableState getCurrentFoldableState ()

يُرجع الحالة الحالية القابلة للطي للجهاز أو فارغة في حالة حدوث بعض المشكلات.

int getCurrentUser ()

قم بإرجاع معرف المستخدم الحالي قيد التشغيل.

String getDeviceClass ()

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

long getDeviceDate ()

إرجاع تاريخ الجهاز بالمللي ثانية منذ العصر.

DeviceDescriptor getDeviceDescriptor ()

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

DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

TestDeviceState getDeviceState ()

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

long getDeviceTimeOffset (Date date)

مساعد للحصول على الفارق الزمني بين الجهاز ERROR(/Date) .

InputStreamSource getEmulatorOutput ()

احصل على دفق المحاكي stdout وstderr

Process getEmulatorProcess ()

قم بإرجاع Process المقابلة لهذا المحاكي.

final File getExecuteShellCommandLog ()

السجل الذي يحتوي على كافة سجلات executeShellCommand(String) .

long getExternalStoreFreeSpace ()

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

String getFastbootPath ()

يُرجع مسار ملف fastboot الثنائي المُستخدم.

String getFastbootProductType ()

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

String getFastbootProductVariant ()

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

String getFastbootSerialNumber ()

إرجاع الرقم التسلسلي لوضع التشغيل السريع.

String getFastbootVariable (String variableName)

قم باسترجاع قيمة متغير fastboot المعطاة من الجهاز.

String getFastbootVersion ()

إرجاع سلسلة إصدار ثنائي fastboot المستخدم.

IFileEntry getFileEntry (String path)

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

IFileEntry getFileEntry (FileListingService.FileEntry entry)

مساعد غير رسمي للحصول على FileEntry من مسار غير جذر.

getFoldableStates ()

إرجاع قائمة الحالات القابلة للطي على الجهاز.

IDevice getIDevice ()

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

getInstalledPackageNames ()

جلب أسماء حزم التطبيقات الموجودة على الجهاز.

long getIntProperty (String name, long defaultValue)

إرجاع قيمة عددية للخاصية المحددة من الجهاز.

String getIpAddress ()

يحصل على عنوان IP الخاص بالجهاز.

KeyguardControllerState getKeyguardState ()

قم بإرجاع كائن للحصول على الحالة الحالية للوحة المفاتيح أو فارغة إذا لم تكن مدعومة.

long getLastExpectedRebootTimeMillis ()

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

int getLaunchApiLevel ()

احصل على أول مستوى API تم إطلاقه بالجهاز.

InputStreamSource getLogcat ()

الاستيلاء على دفق لقطة من بيانات logcat.

InputStreamSource getLogcat (int maxBytes)

احصل على دفق لقطة لآخر maxBytes من بيانات logcat الملتقطة.

InputStreamSource getLogcatDump ()

احصل على تفريغ السجل الحالي للجهاز.

InputStreamSource getLogcatSince (long date)

احصل على دفق لقطة من بيانات logcat التي تم التقاطها بدءًا من التاريخ المقدم.

String getMacAddress ()

يُرجع عنوان MAC الخاص بالجهاز، ويكون فارغًا إذا فشل في الاستعلام من الجهاز.

Integer getMainUserId ()

إرجاع معرف المستخدم الرئيسي.

getMainlineModuleInfo ()

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

int getMaxNumberOfRunningUsersSupported ()

احصل على الحد الأقصى لعدد المستخدمين المدعومين الذين يعملون في نفس الوقت.

int getMaxNumberOfUsersSupported ()

احصل على الحد الأقصى لعدد المستخدمين المدعومين.

Process getMicrodroidProcess ()
IDeviceStateMonitor getMonitor ()

قم بإرجاع IDeviceStateMonitor المرتبط بالجهاز.

String getMountPoint (String mountName)

إرجاع نقطة التحميل.

ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

getMountPointInfo ()

يُرجع نسخة مُحللة من المعلومات الموجودة في /proc/mounts على الجهاز

TestDeviceOptions getOptions ()

جلب خيارات الاختبار للجهاز.

long getPartitionFreeSpace (String partition)

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

Integer getPrimaryUserId ()

إرجاع معرف المستخدم الأساسي.

ProcessInfo getProcessByName (String processName)

يقوم الأسلوب المساعد بتشغيل الأمر "pidof" و"stat" وإرجاع كائن ProcessInfo بمعرف PID ووقت بدء العملية للعملية المحددة.

String getProcessPid (String process)

يُرجع معرف الخدمة أو يكون فارغًا إذا حدث خطأ ما.

String getProductType ()

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

String getProductVariant ()

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

String getProperty (String name)

استرداد قيمة الخاصية المعطاة من الجهاز.

ITestDevice.RecoveryMode getRecoveryMode ()

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

InputStreamSource getScreenshot (String format)

يلتقط لقطة شاشة من الجهاز.

InputStreamSource getScreenshot (long displayId)

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

InputStreamSource getScreenshot (String format, boolean rescale)

يلتقط لقطة شاشة من الجهاز.

InputStreamSource getScreenshot ()

يلتقط لقطة شاشة من الجهاز.

String getSerialNumber ()

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

String getSetting (int userId, String namespace, String key)

قم بإرجاع قيمة الإعداد المطلوب.

String getSetting (String namespace, String key)

راجع getSetting(int, String, String) ويتم إجراؤه على مستخدم النظام.

String getSimOperator ()

قم بإرجاع مشغل بطاقة SIM أو فارغًا إذا لم يكن متاحًا أو إذا كان الجهاز غير متاح.

String getSimState ()

قم بإرجاع حالة بطاقة SIM أو فارغة إذا لم تكن متوفرة أو كان الجهاز غير متوفر.

getTombstones ()

جلب وإرجاع قائمة شواهد القبور من الأجهزة.

long getTotalMemory ()

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

getUninstallablePackageNames ()

قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها.

boolean getUseFastbootErase ()

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

int getUserFlags (int userId)

البحث عن إشارات مستخدم معين وإعادتها.

getUserInfos ()

يحصل على خريطة useId لمعلومات UserInfo على الجهاز.

int getUserSerialNumber (int userId)

إعادة الرقم التسلسلي المرتبط بمعرف المستخدم إذا وجد، -10000 في أي حالات أخرى.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

معالجة حدث الجهاز المحدد.

قم بمعالجة DeviceEvent، الذي قد ينقل أو لا ينقل هذا الجهاز إلى حالة تخصيص جديدة.

boolean hasFeature (String feature)

تحقق مما إذا كانت الميزة متوفرة على الجهاز.

String installPackage (File packageFile, boolean reinstall, String... extraArgs)

تثبيت حزمة Android على الجهاز.

String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

تثبيت حزمة Android على الجهاز.

String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)

تثبيت حزمة Android على الجهاز لمستخدم معين.

String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

تثبيت حزمة Android على الجهاز لمستخدم معين.

void invalidatePropertyCache ()
boolean isAdbRoot ()

boolean isAdbTcp ()
boolean isAppEnumerationSupported ()

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

boolean isBypassLowTargetSdkBlockSupported ()

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

boolean isDebugfsMounted ()

تحقق مما إذا تم تثبيت debugfs.

boolean isDeviceEncrypted ()

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

boolean isDirectory (String path)

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

boolean isEnableAdbRoot ()
boolean isEncryptionSupported ()

يُرجع إذا كان التشفير مدعومًا على الجهاز.

boolean isExecutable (String fullPath)

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

boolean isFastbootEnabled ()

ارجع إذا كان fastboot متاحًا للجهاز.

boolean isHeadless ()

يُرجع صحيحًا إذا كان الجهاز بدون رأس (بدون شاشة)، ويُرجع صحيحًا إذا كان خلاف ذلك.

boolean isHeadlessSystemUserMode ()

إرجاع ما إذا كان الجهاز يستخدم وضع مستخدم النظام بدون رأس.

boolean isMainUserPermanentAdmin ()

لعرض ما إذا كان المستخدم الرئيسي هو مسؤول دائم ولا يمكن حذفه أو خفض رتبته إلى حالة غير مسؤول.

boolean isMultiUserSupported ()

يحدد ما إذا كان يتم دعم المستخدمين المتعددين.

boolean isPackageInstalled (String packageName, String userId)

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

boolean isPackageInstalled (String packageName)

استعلم عن الجهاز للحصول على اسم حزمة معين للتحقق مما إذا كان مثبتًا حاليًا أم لا.

boolean isRuntimePermissionSupported ()

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

boolean isStateBootloaderOrFastbootd ()

يُرجع صحيحًا إذا كان الجهاز في TestDeviceState#FASTBOOT أو TestDeviceState.FASTBOOTD .

boolean isUserRunning (int userId)

تحقق مما إذا كان مستخدم معين قيد التشغيل.

boolean isUserSecondary (int userId)

قم بإرجاع ما إذا كان المستخدم المحدد مستخدمًا ثانويًا وفقًا لعلاماته.

boolean isUserVisible (int userId)

يتحقق مما إذا كان المستخدم المحدد مرئيًا.

boolean isUserVisibleOnDisplay (int userId, int displayId)

يتحقق مما إذا كان المستخدم المحدد مرئيًا في الشاشة المحددة.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

يُرجع ما إذا كان الجهاز يسمح للمستخدمين ببدء الظهور في الخلفية في ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

boolean isVisibleBackgroundUsersSupported ()

إرجاع ما إذا كان الجهاز يسمح للمستخدمين ببدء الظهور في الخلفية.

boolean isWifiEnabled ()

اختبار ما إذا تم تمكين واي فاي.

listDisplayIds ()

قم بتجميع قائمة معرفات شاشات العرض المتوفرة على الجهاز كما ورد في "dumpsys SurfaceFlinger".

listDisplayIdsForStartingVisibleBackgroundUsers ()

يحصل على قائمة العروض التي يمكن استخدامها start a user visible in the background .

listUsers ()

يحصل على قائمة المستخدمين على الجهاز.

boolean logAnrs ( ITestLogger logger)

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

boolean logBugreport (String dataName, ITestLogger listener)

طريقة مساعدة لأخذ تقرير الأخطاء وتسجيله للصحفيين.

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

قم بتسجيل رسالة في سجل الجهاز.

void mountDebugfs ()

جبل التصحيحات.

void nonBlockingReboot ()

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

void postAdbRootAction ()

قم بالتجاوز إذا كان الجهاز يحتاج إلى اتخاذ بعض الإجراءات المحددة بعد جذر adb وقبل إعادة اتصال الجهاز بالإنترنت.

void postAdbUnrootAction ()

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

void postBootSetup ()

قم بتنفيذ التعليمات لتكوين الجهاز لاختبار ذلك بعد كل عملية تمهيد.

void postInvocationTearDown (Throwable exception)

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

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

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

boolean pullDir (String deviceFilePath, File localDir)

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

boolean pullFile (String remoteFilePath, File localFile)

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

File pullFile (String remoteFilePath, int userId)

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

File pullFile (String remoteFilePath)

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

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

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

String pullFileContents (String remoteFilePath)

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

File pullFileFromExternal (String remoteFilePath)

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

boolean pushDir (File localFileDir, String deviceFilePath, excludedDirectories) pushDir (File localFileDir, String deviceFilePath, excludedDirectories)

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

boolean pushDir (File localFileDir, String deviceFilePath)

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

boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)

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

boolean pushFile (File localFile, String remoteFilePath)

ادفع ملفًا إلى الجهاز.

boolean pushString (String contents, String remoteFilePath)

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

void reboot (String reason)

يعيد تشغيل الجهاز في وضع adb مع وجود reason للاستمرار أثناء إعادة التشغيل.

void reboot ()

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

void rebootIntoBootloader ()

يعيد تشغيل الجهاز في وضع أداة تحميل التشغيل.

void rebootIntoFastbootd ()

يعيد تشغيل الجهاز إلى وضع fastbootd.

void rebootIntoRecovery ()

يعيد تشغيل الجهاز في وضع الاسترداد adb.

void rebootIntoSideload ()

يعيد تشغيل الجهاز في وضع التحميل الجانبي لـ adb (لاحظ أن هذا وضع خاص قيد الاسترداد)

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

void rebootIntoSideload (boolean autoReboot)

يعيد تشغيل الجهاز في وضع التحميل الجانبي لـ adb (لاحظ أن هذا وضع خاص قيد الاسترداد)

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

void rebootUntilOnline ()

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

void rebootUntilOnline (String reason)

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

void rebootUserspace ()

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

void rebootUserspaceUntilOnline ()

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

boolean recoverDevice ()

محاولات لاستعادة اتصالات الجهاز.

void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

يقوم بتسجيل IDeviceActionReceiver لهذا الجهاز.

void remountSystemReadOnly ()

جعل قسم النظام على الجهاز للقراءة فقط.

void remountSystemWritable ()

جعل قسم النظام على الجهاز قابلاً للكتابة.

void remountVendorReadOnly ()

اجعل قسم البائع على الجهاز للقراءة فقط.

void remountVendorWritable ()

جعل قسم البائع على الجهاز قابلاً للكتابة.

boolean removeAdmin (String componentName, int userId)

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

void removeOwners ()

قم بإزالة جميع مالكي ملفات تعريف الجهاز الحاليين بأقصى جهد.

boolean removeUser (int userId)

إزالة مستخدم معين من الجهاز.

void resetContentProviderSetup ()

قم بإعادة تعيين العلامة لإعداد موفر المحتوى لتشغيلها مرة أخرى.

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

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

boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners)

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

boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) 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)) ولكنه يقوم بإجراء الاختبار للمستخدم المحدد.

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

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

void setConfiguration ( IConfiguration configuration)

يقوم بإدخال IConfiguration قيد الاستخدام.

final void setConnectionAvdInfo ( GceAvdInfo avdInfo)
void setDate (Date date)

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

ملاحظة: تحديد التاريخ على الجهاز يتطلب الجذر

boolean setDeviceOwner (String componentName, int userId)

قم بتعيين مكون مسؤول الجهاز كمالك للجهاز في مستخدم معين.

void setDeviceState ( TestDeviceState deviceState)

تحديث حالة الجهاز.

void setEmulatorOutputStream ( SizeLimitedOutputStream output)

بالنسبة للمحاكي، قم بتعيين SizeLimitedOutputStream لتسجيل الإخراج

void setEmulatorProcess (Process p)

يضبط Process ، عندما يكون هذا الجهاز محاكيًا.

void setFastbootEnabled (boolean fastbootEnabled)

اضبط خيار التشغيل السريع للجهاز.

void setFastbootPath (String fastbootPath)

يضبط المسار إلى ملف fastboot الثنائي الذي يجب استخدامه.

void setIDevice (IDevice newDevice)

قم بتحديث IDevice المرتبط بـ ITestDevice هذا.

void setLogStartDelay (int delay)

يضبط الوقت بالمللي ثانية للانتظار قبل بدء التقاط logcat لجهاز متصل بالإنترنت.

void setOptions ( TestDeviceOptions options)

قم بتعيين TestDeviceOptions للجهاز

boolean setProperty (String propKey, String propValue)

يضبط قيمة الخاصية المحددة على الجهاز.

void setRecovery ( IDeviceRecovery recovery)

قم بتعيين IDeviceRecovery لاستخدامه لهذا الجهاز.

void setRecoveryMode ( ITestDevice.RecoveryMode mode)

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

void setSetting (String namespace, String key, String value)

راجع setSetting(int, String, String, String) ويتم تنفيذها على مستخدم النظام.

void setSetting (int userId, String namespace, String key, String value)

أضف قيمة إعداد إلى مساحة الاسم لمستخدم معين.

void setTestLogger ( ITestLogger testLogger)

يقوم بإدخال مثيل ITestLogger

void setUseFastbootErase (boolean useFastbootErase)

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

void startLogcat ()

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

boolean startUser (int userId)

يبدأ تشغيل مستخدم معين في الخلفية إذا كان متوقفًا حاليًا.

boolean startUser (int userId, boolean waitFlag)

يبدأ تشغيل مستخدم معين في الخلفية إذا كان متوقفًا حاليًا.

boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)

يبدأ مستخدمًا معينًا في الخلفية، ويكون مرئيًا في شاشة العرض المحددة (أي السماح للمستخدم ببدء الأنشطة في تلك الشاشة).

void stopEmulatorOutput ()

أغلق وحذف إخراج المحاكي.

void stopLogcat ()

توقف عن التقاط مخرجات logcat من الجهاز، وتجاهل بيانات logcat المحفوظة حاليًا.

boolean stopUser (int userId)

توقف مستخدم معين.

boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)

إيقاف مستخدم معين.

String switchToAdbTcp ()

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

boolean switchToAdbUsb ()

قم بتبديل الجهاز إلى adb عبر وضع USB.

boolean switchUser (int userId)

قم بالتبديل إلى معرف مستخدم آخر بمهلة افتراضية.

boolean switchUser (int userId, long timeout)

قم بالتبديل إلى معرف مستخدم آخر مع تحديد المهلة المحددة كموعد نهائي.

boolean syncFiles (File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport ()

خذ تقرير الأخطاء وأعده داخل كائن Bugreport للتعامل معه.

String uninstallPackage (String packageName)

قم بإلغاء تثبيت حزمة Android من الجهاز.

String uninstallPackageForUser (String packageName, int userId)

قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين.

boolean unlockDevice ()

يفتح قفل الجهاز إذا كان الجهاز في حالة مشفرة.

void unmountDebugfs ()

إلغاء تحميل التصحيحات.

boolean waitForBootComplete (long timeOut)

يتم الحظر حتى يتم تعيين علامة اكتمال تشغيل الجهاز.

boolean waitForDeviceAvailable ()

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

boolean waitForDeviceAvailable (long waitTime)

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

boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

void waitForDeviceBootloader ()

يتم الحظر حتى يصبح الجهاز مرئيًا عبر fastboot.

boolean waitForDeviceInRecovery (long waitTime)

كتل الجهاز ليكون في حالة "adb Recovery" (لاحظ أن هذا يختلف عن IDeviceRecovery ).

boolean waitForDeviceInSideload (long waitTime)

كتل للجهاز ليكون في حالة "adb Sideload".

boolean waitForDeviceNotAvailable (long waitTime)

الكتل الخاصة بالجهاز غير متوفرة، أي أنها مفقودة من بنك التنمية الآسيوي

void waitForDeviceOnline ()

يتم الحظر حتى يصبح الجهاز مرئيًا عبر adb.

void waitForDeviceOnline (long waitTime)

يتم الحظر حتى يصبح الجهاز مرئيًا عبر adb.

boolean waitForDeviceShell (long waitTime)

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

الأساليب المحمية

void addExtraConnectionBuilderArgs ( DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)

ينشئ أمر نظام التشغيل لجلسة أوامر adb shell المعينة والوسائط

void checkApiLevelAgainst (String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction ( NativeDevice.RebootMode rebootMode, String reason)

قم بإنشاء RebootDeviceAction لاستخدامه عند تنفيذ إجراء إعادة التشغيل.

IRunUtil createRunUtil ()
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

إجراء إعادة تشغيل بنك التنمية الآسيوي.

void ensureRuntimePermissionSupported ()

أسلوب مساعد لطرح الاستثناء إذا كان إذن وقت التشغيل غير مدعوم

int getApiLevelSafe ()
ITestLogger getLogger ()
IRunUtil getRunUtil ()

احصل على مثيل RunUtil لاستخدامه.

void initializeConnection ( IBuildInfo info, MultiMap <String, String> attributes)
String internalGetProperty (String propName, String fastbootVar, String description)

قم بإحضار خاصية الجهاز، من ذاكرة التخزين المؤقت ddmlib افتراضيًا، ثم ارجع إلى إما `adb shell getprop` أو `fastboot getvar` اعتمادًا على ما إذا كان الجهاز في Fastboot أم لا.

boolean isInRebootCallback ()

إرجاع ما إذا كانت عمليات رد الاتصال الخاصة بإعادة التشغيل قيد التنفيذ حاليًا أم لا.

boolean isNewer (File localFile, IFileEntry entry)

يُرجع true إذا كان الملف المحلي أحدث من الملف البعيد.

void notifyRebootEnded ()

يقوم بإعلام كافة IDeviceActionReceiver حول حدث نهاية إعادة التشغيل.

void notifyRebootStarted ()

يخطر كافة IDeviceActionReceiver حول حدث بدء إعادة التشغيل.

boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)

ينفذ إجراءً على هذا الجهاز.

void postAdbReboot ()

الإجراءات الإضافية المحتملة التي يمكن اتخاذها بعد إعادة التشغيل.

void prePostBootSetup ()

يسمح لكل نوع جهاز (AndroidNativeDevice، TestDevice) بتجاوز هذه الطريقة لإعداد محدد بعد التمهيد.

boolean pullFileInternal (String remoteFilePath, File localFile)
void setClock (Clock clock)

قم بتعيين مثيل الساعة للاستخدام.

void setMicrodroidProcess (Process process)

وضع علامة على جهاز الاختبار على أنه microdroid وتعيين CID الخاص به.

void setTestDeviceOptions ( deviceOptions) setTestDeviceOptions ( deviceOptions)
CommandResult simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd) simpleFastbootCommand (long timeout, envVarMap, String[] fullCmd)

ينفذ أمر fastboot بسيطًا باستخدام متغيرات البيئة ويبلغ عن حالة الأمر.

CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)

ينفذ أمر fastboot بسيطًا ويبلغ عن حالة الأمر.

boolean waitForDeviceNotAvailable (String operationDesc, long time)

انتظر حتى يصبح الجهاز غير متاح (أوقف إرسال التقارير إلى بنك التنمية الآسيوي).

الثوابت

هوية مستخدم غير صالحه

public static final int INVALID_USER_ID

القيمة التي تم إرجاعها لأي معرف مستخدم غير صالح/لم يتم العثور عليه: حدد UserHandle القيمة -10000

القيمة الثابتة: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

القيمة الثابتة: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

العدد الافتراضي لمحاولات إعادة محاولة تنفيذ الأمر

القيمة الثابتة: 2 (0x00000002)

مجالات

DEBUGFS_PATH

public static final String DEBUGFS_PATH

بطاقة الذاكرة

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

مخيارات

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

المقاولين العامة

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

يقوم بإنشاء TestDevice .

حدود
device IDevice : IDevice المرتبط

stateMonitor IDeviceStateMonitor : آلية IDeviceStateMonitor المراد استخدامها

allocationMonitor IDeviceMonitor : IDeviceMonitor للإبلاغ عن تغييرات حالة التخصيص. يمكن أن تكون فارغة

الأساليب العامة

BatchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

التحسين الجزئي (حوالي 400 ملي) عن طريق الجلب المسبق لجميع العناصر التي نحتاجها بدلاً من استدعاء "adb getprop" لكل واحدة. أي أن جلب كافة الخصائص هو بنفس السرعة التي يتم بها جلب واحدة. أشياء مثل devices.getApiLevel() وcheckApiLevelAgainstNextRelease وgetBuildAlias ​​كلها تستدعي `adb getprop` تحت الغطاء. نقوم بإحضارها في مكالمة واحدة ونتصل بـ NativeDevice.setProperty. حتى إذا لم نفعل ذلك، فسوف يقوم NativeDevice بنفسه باستدعاء setProperty وتخزين النتيجة مؤقتًا للمكالمات المستقبلية. نحن نفعل ذلك في وقت سابق قليلا. إذا كان الجهاز في مرحلة الاسترداد أو كانت هناك أخطاء أخرى في جلب الدعائم، فإننا نتجاهلها فقط.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

عائدات
boolean

رميات
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

عائدات
boolean صحيح إذا كان المستوى مدعومًا. باطل غير ذلك.

رميات
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

تأكد من أن الجهاز لديه اتصال بالشبكة.

عائدات
boolean true إذا كان الجهاز لديه اتصال شبكة فعال، false أيضًا.

رميات
DeviceNotAvailableException

ClearErrorDialogs

public boolean clearErrorDialogs ()

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

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

رميات
DeviceNotAvailableException

ClearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

مسح آخر شبكة wifi متصلة. يجب استدعاء هذا عند بدء استدعاء جديد لتجنب الاتصال بشبكة wifi المستخدمة في الاختبار السابق بعد إعادة تشغيل الجهاز.

com.clearLogcat

public void clearLogcat ()

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

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

ConnectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

يتصل بشبكة واي فاي.

يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بإحدى شبكات wifi الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi() أو ITestDevice#clearLastConnectedWifiNetwork() .

حدود
wifiSsidToPsk : خريطة معرفات SSID واي فاي لكلمات المرور.

scanSsid boolean : ما إذا كان سيتم البحث عن معرفات SSID المخفية لهذه الشبكة.

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException

ConnectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

يتصل بشبكة واي فاي.

يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بشبكة wifi المحددة. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi() أو ITestDevice#clearLastConnectedWifiNetwork() .

حدود
wifiSsid String : wifi ssid للاتصال به

wifiPsk String : عبارة مرور PSK أو فارغة إذا كانت غير مشفرة

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException

ConnectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

يتصل بشبكة واي فاي.

يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بإحدى شبكات wifi الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi() أو ITestDevice#clearLastConnectedWifiNetwork()

حدود
wifiSsidToPsk : خريطة معرفات SSID واي فاي لكلمات المرور.

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException

ConnectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

يتصل بشبكة واي فاي.

يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بشبكة wifi المحددة. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi() أو ITestDevice#clearLastConnectedWifiNetwork() .

حدود
wifiSsid String : wifi ssid للاتصال به

wifiPsk String : عبارة مرور PSK أو فارغة إذا كانت غير مشفرة

scanSsid boolean : ما إذا كان سيتم البحث عن SSID المخفي لهذه الشبكة.

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

متغير من connectToWifiNetwork(String, String) الذي يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.

حدود
scanSsid boolean : ما إذا كان سيتم البحث عن SSID المخفي لهذه الشبكة

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

متغير من connectToWifiNetwork(String, String) الذي يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.

عائدات
boolean true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك

رميات
DeviceNotAvailableException

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

قم بإنشاء مستخدم باسم معين والأعلام المقدمة

حدود
name String : من المستخدم لإنشائها على الجهاز

guest boolean : قم بتمكين علامة المستخدم --ضيف أثناء الإنشاء

ephemeral boolean : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء

عائدات
int معرف المستخدم الذي تم إنشاؤه

رميات
DeviceNotAvailableException

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

قم بإنشاء مستخدم باسم معين والأعلام المقدمة

حدود
name String : من المستخدم لإنشائها على الجهاز

guest boolean : قم بتمكين علامة المستخدم --ضيف أثناء الإنشاء

ephemeral boolean : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء

forTesting boolean : قم بتمكين علامة الاختبار --for-testing أثناء الإنشاء

عائدات
int معرف المستخدم الذي تم إنشاؤه

رميات
DeviceNotAvailableException

createUser

public int createUser (String name)

أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.

حدود
name String : من المستخدم لإنشائها على الجهاز

عائدات
int العدد الصحيح لمعرف المستخدم الذي تم إنشاؤه

رميات
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.

حدود
name String : من المستخدم لإنشائها على الجهاز

عائدات
int العدد الصحيح لمعرف المستخدم الذي تم إنشاؤه أو -1 للخطأ.

رميات
DeviceNotAvailableException

حذف ملف

public void deleteFile (String deviceFilePath)

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

حدود
deviceFilePath String : المسار المطلق للملف الموجود على الجهاز.

رميات
DeviceNotAvailableException

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

يزيل IDeviceActionReceiver المسجل .

حدود
deviceActionReceiver IDeviceActionReceiver : IDeviceActionReceiver الذي ستتم إزالته.

DeviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

حدود
prevSystemServerProcess ProcessInfo : العملية السابقة لخادم النظام ProcessInfo .

عائدات
boolean true إذا تم إعادة تشغيل الجهاز

رميات
DeviceNotAvailableException

DeviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

حدود
utcEpochTime long : وقت الجهاز بالثانية منذ العصر.

timeUnit TimeUnit : وحدة الوقت TimeUnit لـ utcEpochTime المحدد.

عائدات
boolean true إذا تم إعادة تشغيل الجهاز

رميات
DeviceNotAvailableException

this.disableAdbRoot

public boolean disableAdbRoot ()

يقوم بإيقاف تشغيل جذر adb.

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

عائدات
boolean true إذا نجحت.

رميات
DeviceNotAvailableException

dableKeyguard

public void disableKeyguard ()

محاولات لتعطيل حارس المفاتيح.

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

رميات
DeviceNotAvailableException

DisableNetworkMonitor

public boolean disableNetworkMonitor ()

تعطيل مراقبة الشبكة على الجهاز.

عائدات
boolean true إذا تم تعطيل المراقبة بنجاح. false إذا فشلت.

رميات
DeviceNotAvailableException

قطع الاتصالمنWifi

public boolean disconnectFromWifi ()

قطع الاتصال بشبكة wifi.

إزالة جميع الشبكات من قائمة الشبكات المعروفة وتعطيل wifi.

عائدات
boolean true إذا تم قطع الاتصال بشبكة wifi بنجاح. false إذا فشل قطع الاتصال.

رميات
DeviceNotAvailableException

doFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

حدود
deviceFilePath String : المسار المطلق للملف الموجود على الجهاز المراد فحصه

userId int : معرف المستخدم الذي يتم من خلاله التحقق من وجود الملف

عائدات
boolean true في حالة وجود الملف، false في غير ذلك.

رميات
DeviceNotAvailableException

doFileExist

public boolean doesFileExist (String deviceFilePath)

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

حدود
deviceFilePath String : المسار المطلق للملف الموجود على الجهاز المراد فحصه

عائدات
boolean true في حالة وجود الملف، false في غير ذلك.

رميات
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

محاولة تفريغ الكومة من system_server. تقع على عاتق المتصل مسؤولية تنظيف الملف الذي تم تفريغه.

حدود
process String : اسم عملية الجهاز المطلوب تفريغها.

devicePath String : المسار الموجود على الجهاز حيث سيتم وضع التفريغ. يجب أن يكون هذا موقعًا تسمح به الأذونات.

عائدات
File ERROR(/File) الذي يحتوي على التقرير. فارغة إذا فشل شيء ما.

رميات
DeviceNotAvailableException

تمكينAdbRoot

public boolean enableAdbRoot ()

يقوم بتشغيل بنك التنمية الآسيوي الجذر. إذا كان إعداد "تمكين الجذر" "خطأ"، فسيتم تسجيل رسالة والعودة دون تمكين الجذر.

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

عائدات
boolean true إذا نجحت.

رميات
DeviceNotAvailableException

تمكينNetworkMonitor

public boolean enableNetworkMonitor ()

تمكين مراقبة الشبكة على الجهاز.

عائدات
boolean true إذا تم تمكين المراقبة بنجاح. false إذا فشلت.

رميات
DeviceNotAvailableException

تنفيذAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

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

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

حدود
timeout long : الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، 0L لعدم وجود مهلة

cmdArgs String : أمر adb والوسائط المراد تشغيلها

عائدات
String stdout من الأمر. null إذا فشل الأمر في التنفيذ.

رميات
DeviceNotAvailableException

تنفيذAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

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

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

حدود
timeout long : الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، 0L لعدم وجود مهلة

envMap : بيئة لتعيين الأمر

cmdArgs String : أمر adb والوسائط المطلوب تشغيلها

عائدات
String stdout من الأمر. null إذا فشل الأمر في التنفيذ.

رميات
DeviceNotAvailableException

تنفيذAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

حدود
cmdArgs String : أمر adb والوسائط المراد تشغيلها

عائدات
String stdout من الأمر. null إذا فشل الأمر في التنفيذ.

رميات
DeviceNotAvailableException

تنفيذ FastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

أسلوب مساعد يقوم بتنفيذ أمر fastboot كأمر نظام مع مهلة افتراضية مدتها دقيقتين.

من المتوقع استخدامه عندما يكون الجهاز في وضع التشغيل السريع بالفعل.

حدود
cmdArgs String : أمر fastboot والوسائط المطلوب تشغيلها

عائدات
CommandResult CommandResult الذي يحتوي على إخراج الأمر

رميات
DeviceNotAvailableException

تنفيذ FastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

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

من المتوقع استخدامه عندما يكون الجهاز في وضع التشغيل السريع بالفعل.

حدود
timeout long : الوقت بالمللي ثانية قبل انتهاء صلاحية الأمر

cmdArgs String : أمر fastboot والوسائط المطلوب تشغيلها

عائدات
CommandResult CommandResult الذي يحتوي على إخراج الأمر

رميات
DeviceNotAvailableException

تنفيذ LongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

حدود
cmdArgs String : أمر fastboot والوسائط للتشغيل

عائدات
CommandResult CommandResult التي تحتوي على إخراج الأوامر

رميات
DeviceNotAvailableException

ExecutElongfastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

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

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

حدود
envVarMap : متغيرات بيئة النظام التي يعمل عليها أمر fastboot

cmdArgs String : أمر fastboot والوسائط للتشغيل

عائدات
CommandResult CommandResult التي تحتوي على إخراج الأوامر

رميات
DeviceNotAvailableException

التنفيذيين

public String executeShellCommand (String command)

طريقة المساعد التي تنفذ الأمر ADB Shell ويعيد الإخراج String .

حدود
command String : أمر ADB Shell لتشغيله

عائدات
String إخراج الصدفة

رميات
DeviceNotAvailableException

التنفيذيين

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

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
command String : أمر ADB Shell لتشغيله

receiver IShellOutputReceiver : IShellOutputReceiver لتوجيه الإخراج shell إلى.

maxTimeToOutputShellResponse long : الحد الأقصى لمقدار الوقت الذي يُسمح خلاله للأمر بعدم إخراج أي استجابة ؛ الوحدة كما هو محدد في timeUnit

timeUnit TimeUnit : وحدة maxTimeToOutputShellResponse

retryAttempts int : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ retryAttempts دون نجاح.

رميات
DeviceNotAvailableException

التنفيذيين

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

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
command String : أمر ADB Shell لتشغيله

receiver IShellOutputReceiver : IShellOutputReceiver لتوجيه الإخراج shell إلى.

maxTimeoutForCommand long : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في timeUnit

maxTimeToOutputShellResponse long : الحد الأقصى لمقدار الوقت الذي يُسمح خلاله للأمر بعدم إخراج أي استجابة ؛ الوحدة كما هو محدد في timeUnit

timeUnit TimeUnit : وحدة maxTimeToOutputShellResponse

retryAttempts int : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ retryAttempts دون نجاح.

رميات
DeviceNotAvailableException

التنفيذيين

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

ينفذ الأمر ADB SHELL المعطى ، إعادة المحاولة عدة مرات في حالة فشل الأمر.

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

حدود
command String : أمر ADB Shell لتشغيله

receiver IShellOutputReceiver : IShellOutputReceiver لتوجيه الإخراج shell إلى.

رميات
DeviceNotAvailableException

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd)

طريقة المساعد التي تنفذ أمر ADB Shell ويعيد النتائج كأوامر CommandResult بشكل صحيح مع إخراج حالة الأمر ، STDOUT و STDERR.

حدود
cmd String : الأمر الذي يجب تشغيله.

عائدات
CommandResult النتيجة في CommandResult .

رميات
DeviceNotAvailableException

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

طريقة المساعد التي تنفذ الأمر ADB Shell وإرجاع النتائج كأمرات CommandResult التي يتم ملؤها بشكل صحيح مع إخراج حالة الأمر و STDERR. يتم توجيه stdout إلى الدفق المحدد.

حدود
cmd String : الأمر الذي يجب تشغيله.

pipeToOutput OutputStream : ERROR(/OutputStream) حيث سيتم إعادة توجيه إخراج STD أو NULL.

عائدات
CommandResult النتيجة في CommandResult .

رميات
DeviceNotAvailableException

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

طريقة HELPER التي تنفذ أمر ADB Shell ويعيد النتائج كأحد CommandResult بشكل صحيح مع إخراج حالة الأمر ، STDOUT و STDERR.

حدود
cmd String : الأمر الذي يجب تشغيله.

pipeAsInput File : ERROR(/File) سيتم أن يتم إدخاله كإدخال إلى الأمر ، أو NULL.

عائدات
CommandResult النتيجة في CommandResult .

رميات
DeviceNotAvailableException

ExecuteShellV2Command

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

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
cmd String : أمر ADB Shell لتشغيله

maxTimeoutForCommand long : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في timeUnit

timeUnit TimeUnit : وحدة maxTimeToOutputShellResponse

retryAttempts int : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ retryAttempts دون نجاح.

عائدات
CommandResult

رميات
DeviceNotAvailableException

ExecuteShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
cmd String : أمر ADB Shell لتشغيله

maxTimeoutForCommand long : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في timeUnit

timeUnit TimeUnit : وحدة maxTimeToOutputShellResponse

عائدات
CommandResult

رميات
DeviceNotAvailableException

ExecuteShellV2Command

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

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
cmd String : أمر ADB Shell لتشغيله

pipeAsInput File : ERROR(/File) سيتم أن يتم إدخاله كإدخال إلى الأمر ، أو NULL.

pipeToOutput OutputStream : ERROR(/OutputStream) حيث سيتم إعادة توجيه إخراج STD أو NULL.

maxTimeoutForCommand long : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في timeUnit

timeUnit TimeUnit : وحدة maxTimeToOutputShellResponse

retryAttempts int : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ retryAttempts دون نجاح.

عائدات
CommandResult

رميات
DeviceNotAvailableException

ExecuteShellV2Command

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

ينفذ الأمر ADB Shell ، مع المزيد من المعلمات للتحكم في سلوك الأمر.

حدود
cmd String : أمر ADB Shell لتشغيله

pipeAsInput File : ERROR(/File) سيتم أن يتم إدخاله كإدخال إلى الأمر ، أو NULL.

pipeToOutput OutputStream : ERROR(/OutputStream) حيث سيتم إعادة توجيه إخراج STD أو NULL.

pipeToError OutputStream : ERROR(/OutputStream) حيث سيتم إعادة توجيه خطأ STD أو NULL.

maxTimeoutForCommand long : الحد الأقصى لإنهاء المهلة لإكمال الأمر ؛ الوحدة كما هو محدد في timeUnit

timeUnit TimeUnit : وحدة maxTimeToOutputShellResponse

retryAttempts int : الحد الأقصى لعدد المرات إلى أمر إعادة المحاولة إذا فشل بسبب استثناء. سيتم إلقاء DevicenOtResponsiveException إذا تم تنفيذ retryAttempts دون نجاح.

عائدات
CommandResult

رميات
DeviceNotAvailableException

FastBootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

حدود
partition String : القسم للمسح

عائدات
CommandResult CommandResult التي تحتوي على إخراج الأوامر

رميات
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

قم بإحضار معلومات حول القمة التي تم تنشيطها على الجهاز.

عائدات
ERROR(/Set) من ApexInfo تم تنشيطه حاليًا على الجهاز

رميات
DeviceNotAvailableException

getAllsettings

public  getAllSettings (String namespace)

إرجاع أزواج القيمة الرئيسية من مساحة الاسم المطلوبة.

حدود
namespace String : يجب أن تكون واحدة من {"System" ، "Secure" ، "Global"}

عائدات
خريطة أزواج القيمة الرئيسية. NULL إذا لم يتم دعم مساحة الاسم.

رميات
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

إرجاع حالة التخصيص الحالية للجهاز

عائدات
DeviceAllocationState

getandroidid

public String getAndroidId (int userId)

ابحث وإرجاع معرف Android المرتبط بـ UserD ، NULL إذا لم يتم العثور عليه.

حدود
userId int

عائدات
String

رميات
DeviceNotAvailableException

getandroidids

public  getAndroidIds ()

إنشاء خريطة معرفات Android وجدت معرفات المستخدم مطابقة. لا يوجد أي تأمين على أن كل معرف مستخدم سيجد معرف Android مرتبطًا في هذه الوظيفة حتى يتطابق بعض معرفات المستخدم

عائدات
وجدت Map of Android IDS معرفات المستخدم مطابقة.

رميات
DeviceNotAvailableException

getApilevel

public int getApiLevel ()

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

عائدات
int عدد صحيح يشير إلى مستوى API للجهاز

رميات
DeviceNotAvailableException

getAppackageInfo

public PackageInfo getAppPackageInfo (String packageName)

جلب معلومات حول حزمة مثبتة على الجهاز.

حدود
packageName String

عائدات
PackageInfo PackageInfo أو null إذا تعذر استرداد المعلومات

رميات
DeviceNotAvailableException

getAppackageInfos

public  getAppPackageInfos ()

جلب معلومات الحزم المثبتة على الجهاز.

عائدات
ERROR(/List) من PackageInfo S المثبتة على الجهاز.

رميات
DeviceNotAvailableException

getBaseBandversion

public String getBasebandVersion ()

طريقة الراحة للحصول على إصدار Baseband (راديو) من هذا الجهاز. إن الحصول على إصدار الراديو محدد للجهاز ، لذلك قد لا يعيد المعلومات الصحيحة لجميع الأجهزة. تعتمد هذه الطريقة على GSM.Version.BaseBand Propery لإرجاع معلومات الإصدار الصحيحة. هذا ليس دقيقًا لبعض أجهزة CDMA وقد لا يتطابق الإصدار الذي يتم إرجاعه إلى الإصدار الذي تم الإبلاغ عنه من Fastboot وقد لا يعيد الإصدار لراديو CDMA. TL ؛ DR هذه الطريقة تقارير فقط إصدار دقيق إذا كانت خاصية GSM.Version.BaseBand هي نفسها التي يتم إرجاعها بواسطة fastboot getvar version-baseband .

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

رميات
DeviceNotAvailableException

getBattery

public Integer getBattery ()

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

عائدات
Integer

getBooleAnproperty

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

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

عائدات
خريطة وقت التمهيد (وقت UTC في الثانية منذ عصر) وعقل التمهيد

رميات
DeviceNotAvailableException

getBoothistorysince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

تقوم طريقة Helper بجمع خريطة تاريخ التمهيد مع سبب التمهيد وسبب التمهيد منذ الوقت المحدد منذ فترة من الجهاز والوحدة الزمنية المحددة. يمكن الحصول على الجهاز الحالي UtcepochTime بالمللي ثانية عن طريق Method getDeviceDate() .

حدود
utcEpochTime long : وقت الجهاز منذ فترة.

timeUnit TimeUnit : وحدة الوقت TimeUnit .

عائدات
خريطة وقت التمهيد (وقت UTC في الثانية منذ عصر) وعقل التمهيد

رميات
DeviceNotAvailableException

getBootloaderversion

public String getBootloaderVersion ()

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

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

عائدات
String إصدار String bootloader أو null إذا كان لا يمكن العثور عليه

رميات
DeviceNotAvailableException

getBugReport

public InputStreamSource getBugreport ()

يسترجع bugreport من الجهاز.

يضمن تنفيذ هذا الاستمرار في العمل على جهاز بدون بطاقة SDCARD (أو حيث لم يتم تركيب SDCARD بعد).

عائدات
InputStreamSource InputStreamSource الذي ينتج محتويات bugreport عند الطلب. في حالة الفشل ، ستنتج InputStreamSource ERROR(/InputStream) .

getBugreportz

public InputStreamSource getBugreportz ()

يسترجع bugreportz من الجهاز. يحتوي تنسيق zip على bugreport على pugreport الرئيسية وملفات السجل الأخرى المفيدة لتصحيح الأخطاء.

مدعوم فقط لـ "إصدار ADB"> 1.0.36

عائدات
InputStreamSource A InputStreamSource من ملف zip الذي يحتوي على bugreportz ، إرجاع فارغ في حالة الفشل.

getBuildalias

public String getBuildAlias ()

استرجع الاسم المستعار للبناء الذي يعمل عليه الجهاز حاليًا.

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

عائدات
String الاسم المستعار أو التراجع إلى معرف البناء إذا لم يتم استرداده

رميات
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

استرداد نكهة البناء للجهاز.

عائدات
String نكهة البناء أو الفارغ إذا لم يتم استردادها

رميات
DeviceNotAvailableException

getBuildid

public String getBuildId ()

استرداد البناء يعمل الجهاز حاليًا.

عائدات
String معرف الإنشاء أو IBuildInfo#UNKNOWN_BUILD_ID إذا لم يتم استرداده

رميات
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

عائدات
String مفتاح التوقيع إذا وجدت ، لاغية خلاف ذلك.

رميات
DeviceNotAvailableException

getCacheddevicedescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

إرجاع DeviceDescriptor المخزنة مؤقتًا إذا تم تخصيص الجهاز ، وإلا بإرجاع DeviceDescriptor الحالي.

عائدات
DeviceDescriptor

getCacheddevicedescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

إرجاع DeviceDescriptor المخزنة مؤقتًا إذا تم تخصيص الجهاز ، وإلا بإرجاع DeviceDescriptor الحالي.

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

عائدات
DeviceDescriptor

جادش

public String[] getChildren (String path)

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

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

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

رميات
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

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

عائدات
AbstractConnection

getCurrentFoldablestate

public DeviceFoldableState getCurrentFoldableState ()

إرجاع الحالة الحالية القابلة للطي للجهاز أو فارغة في حالة حدوث بعض المشكلات.

عائدات
DeviceFoldableState

رميات
DeviceNotAvailableException

getCurrentuser

public int getCurrentUser ()

إرجاع معرف المستخدم الحالي قيد التشغيل. في حالة الخطأ ، إرجاع -10000.

عائدات
int

رميات
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

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

عائدات
String فئة جهاز String .

getDevicedate

public long getDeviceDate ()

إرجاع تاريخ الجهاز بالميلي ثانية منذ فترة.

عائدات
long تاريخ الجهاز بتنسيق العصر.

رميات
DeviceNotAvailableException

getDevicedescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

عائدات
DeviceDescriptor

getDevicedescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

عائدات
DeviceDescriptor

getDevicestate

public TestDeviceState getDeviceState ()

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

عائدات
TestDeviceState

getDevicetimeOffset

public long getDeviceTimeOffset (Date date)

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

حدود
date Date

عائدات
long الفرق في ميلي ثانية

رميات
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

احصل على تيار المحاكي stdout و stderr

عائدات
InputStreamSource إخراج المحاكي

GetEmulatorProcess

public Process getEmulatorProcess ()

إرجاع Process المقابلة لهذا المحاكي.

عائدات
Process Process أو null

getExecuteshellCommandLog

public final File getExecuteShellCommandLog ()

السجل الذي يحتوي على جميع سجلات executeShellCommand(String) .

عائدات
File

getExternalStorefreespace

public long getExternalStoreFreeSpace ()

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

عائدات
long مقدار المساحة الحرة بالكيبل

رميات
DeviceNotAvailableException

GetFastBootpath

public String getFastbootPath ()

إرجاع مسار الثنائي fastboot المستخدمة. لا يزال يتطلب isFastbootEnabled() أن تكون صحيحة ، لتمكين وظائف Fastboot.

عائدات
String

GetFastBootProductType

public String getFastbootProductType ()

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

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

عائدات
String اسم نوع منتج String أو null إذا كان لا يمكن تحديده

رميات
DeviceNotAvailableException

GetFastBootProductVariant

public String getFastbootProductVariant ()

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

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

عائدات
String اسم نوع منتج String أو null إذا كان لا يمكن تحديده

رميات
DeviceNotAvailableException

GetFastBootSerialNumber

public String getFastbootSerialNumber ()

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

عائدات
String

GetFastBootvariable

public String getFastbootVariable (String variableName)

استرداد قيمة متغير Fastboot المعطى من الجهاز.

حدود
variableName String : الاسم المتغير

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

رميات
DeviceNotAvailableException

GetFastbootversion

public String getFastbootVersion ()

إرجاع سلسلة الإصدار من Fastboot الثنائي المستخدمة. أو لاغية إذا حدث خطأ ما.

عائدات
String

getFileentry

public IFileEntry getFileEntry (String path)

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

حدود
path String : مسار الملف للاسترداد. يمكن أن يكون مسارًا أو مسارًا مطلقًا بالنسبة إلى "/". (أي كلا من "/النظام" و "System" Syntax مدعوم)

عائدات
IFileEntry IFileEntry أو null إذا كان لا يمكن العثور على ملف في path المعطى

رميات
DeviceNotAvailableException

getFileentry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

المساعد غير الرسمي للحصول على FileEntry من مسار غير الجذر. FixMe: Refactor نظام fileentry لتوفيره من أي مسار. (حتى غير الجذر).

حدود
entry FileListingService.FileEntry : FileEntry لا بالضرورة الجذر كما يتطلب ddmlib.

عائدات
IFileEntry fileEntryWrapper تمثل fileentry.

رميات
com.android.tradefed.device.devicenotavailableableexception
DeviceNotAvailableException

getFoldablestates

public  getFoldableStates ()

إرجاع قائمة الحالات القابلة للطي على الجهاز. يمكن الحصول عليها باستخدام "CMD Device_State Print-States".

عائدات

رميات
DeviceNotAvailableException

getidevice

public IDevice getIDevice ()

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

قد يتم تخصيص IDevice الجديد بواسطة DDMS في كل مرة يقوم فيها الجهاز بفصل وإعادة الاتصال من ADB. وبالتالي ، يجب ألا يحتفظ المتصلين بالإشارة إلى IDevice ، لأن هذه المرجع قد تصبح قديمة.

عائدات
IDevice IDevice

getInstalledPackagenames

public  getInstalledPackageNames ()

جلب أسماء حزمة التطبيق الموجودة على الجهاز.

عائدات
ERROR(/Set) من أسماء حزم String المثبتة حاليًا على الجهاز.

رميات
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

إرجاع قيمة عدد صحيح للخاصية المحددة من الجهاز.

حدود
name String : اسم الخاصية

defaultValue long : القيمة الافتراضية للعودة إذا كانت الخاصية فارغة أو غير موجودة.

عائدات
long قيمة الخاصية أو defaultValue إذا كانت الخاصية فارغة ، أو غير موجودة ، أو ليس لها قيمة عدد صحيح.

رميات
DeviceNotAvailableException

getipaddress

public String getIpAddress ()

يحصل على عنوان IP الخاص بالجهاز.

عائدات
String عنوان IP الخاص بالجهاز ، أو null إذا لم يكن للجهاز عنوان IP

رميات
DeviceNotAvailableException

getKeyGuardState

public KeyguardControllerState getKeyguardState ()

أعد كائن للحصول على الوضع الحالي للحارس الرئيسي أو الفارغ إذا لم يكن مدعومًا.

عائدات
KeyguardControllerState KeyguardControllerState يحتوي على لقطة من حالة الحارس الرئيسي وإرجاع NULL إذا لم يتم دعم الاستعلام keyguard.

رميات
DeviceNotAvailableException

getLastExpectedRebOottimemillis

public long getLastExpectedRebootTimeMillis ()

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

عائدات
long

getLaunchapilevel

public int getLaunchApiLevel ()

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

عائدات
int عدد صحيح يشير إلى أول مستوى API الذي تم إطلاقه من الجهاز

رميات
DeviceNotAvailableException

getlogcat

public InputStreamSource getLogcat ()

الاستيلاء على دفق لقطة لبيانات logcat.

يعمل في وضعين:

  • إذا تم التقاط logcat حاليًا في الخلفية ، فسيعود إلى TestDeviceOptions.getMaxLogcatDataSize() بايت للمحتويات الحالية لالتقاط الخلفية لوجات
  • خلاف ذلك ، سيقوم بإرجاع تفريغ ثابت لبيانات logcat إذا كان الجهاز يستجيب حاليًا

    عائدات
    InputStreamSource

  • getlogcat

    public InputStreamSource getLogcat (int maxBytes)

    يمسك بدد لقطة لآخر maxBytes من بيانات logcat الملتقطة.

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

    حدود
    maxBytes int : الحد الأقصى لمقدار البيانات للعودة. يجب أن يكون كمية يمكن أن تتناسب بشكل مريح في الذاكرة

    عائدات
    InputStreamSource

    getLogCatdump

    public InputStreamSource getLogcatDump ()

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

    لديه عيب مفاده أنه لن يتم إرجاع أي شيء إذا كان الجهاز غير قابل للوصول.

    عائدات
    InputStreamSource A InputStreamSource من بيانات logcat. يتم إرجاع دفق فارغ إذا فشل في التقاط بيانات logcat.

    getLogcatsince

    public InputStreamSource getLogcatSince (long date)

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

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

    عائدات
    InputStreamSource

    getMacaddress

    public String getMacAddress ()

    إرجاع عنوان MAC للجهاز ، NULL إذا فشل في الاستعلام من الجهاز.

    عائدات
    String

    getMainuserId

    public Integer getMainUserId ()

    إرجاع معرف المستخدم الرئيسي.

    عائدات
    Integer معرف المستخدم للمستخدم الرئيسي إذا كان هناك واحد ، و NULL إذا لم يكن هناك مستخدم رئيسي.

    رميات
    DeviceNotAvailableException

    getMainlinemoduleInfo

    public  getMainlineModuleInfo ()

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

    عائدات
    ERROR(/Set) من وحدات String الرئيسية المثبتة حاليًا على الجهاز.

    رميات
    DeviceNotAvailableException

    getMaxNumberOfRunningussSupported

    public int getMaxNumberOfRunningUsersSupported ()

    احصل على الحد الأقصى لعدد المدعوم من المستخدمين في وقت واحد. الافتراضات إلى 0.

    عائدات
    int عدد صحيح يشير إلى عدد المستخدمين الذين يعملون في وقت واحد

    رميات
    DeviceNotAvailableException

    getMaxNumberOfSssupported

    public int getMaxNumberOfUsersSupported ()

    احصل على الحد الأقصى لعدد المستخدمين المدعمين. الافتراضات إلى 0.

    عائدات
    int عدد صحيح يشير إلى عدد المستخدمين المدعوين

    رميات
    DeviceNotAvailableException

    GetMicrodrocess

    public Process getMicrodroidProcess ()

    عائدات
    Process إرجاع عملية Microdroid VM. إذا لم يكن TestDevice عبارة عن microdroid ، فإن إرجاع Null.

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    إرجاع IDeviceStateMonitor المرتبطة بالجهاز.

    عائدات
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    إرجاع نقطة جبل.

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

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

    حدود
    mountName String : اسم جبل بوينت

    عائدات
    String جبل بوينت أو null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    إرجاع جهاز MountPointInfo المقابل لمسار Mountpoint المحدد ، أو null إذا لم يكن هذا المسار مثبتًا أو لا يظهر في /PROC /Mounts كنقطة تركيب.

    حدود
    mountpoint String

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

    رميات
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

    إرجاع نسخة محسورة من المعلومات في /proc /mounts على الجهاز

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

    رميات
    DeviceNotAvailableException

    etcoptions

    public TestDeviceOptions getOptions ()

    جلب خيارات الاختبار للجهاز.

    عائدات
    TestDeviceOptions TestDeviceOptions المتعلقة بالجهاز قيد الاختبار.

    getPartitionFreespace

    public long getPartitionFreeSpace (String partition)

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

    حدود
    partition String

    عائدات
    long مقدار المساحة الحرة بالكيبل

    رميات
    DeviceNotAvailableException

    getPrimaryuserId

    public Integer getPrimaryUserId ()

    إرجاع معرف المستخدم الأساسي.

    عائدات
    Integer معرف المستخدم للمستخدم الأساسي إذا كان هناك واحد ، و NULL إذا لم يكن هناك مستخدم أساسي.

    رميات
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

    تقوم طريقة Helper بتشغيل أمر "pidof" و "STAT" وإرجاع كائن ProcessInfo مع PID ووقت بدء العملية للعملية المحددة.

    حدود
    processName String : سلسلة الأسماء.

    عائدات
    ProcessInfo ProcessInfo من اسم المعالجة المعطى

    رميات
    DeviceNotAvailableException

    getProcesspid

    public String getProcessPid (String process)

    إرجاع PID من الخدمة أو لاغية إذا حدث خطأ ما.

    حدود
    process String : سلسلة الأسماء.

    عائدات
    String

    رميات
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

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

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

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

    رميات
    DeviceNotAvailableException

    GetProductVariant

    public String getProductVariant ()

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

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

    عائدات
    String اسم المنتج String أو null إذا كان لا يمكن تحديده

    رميات
    DeviceNotAvailableException

    GetProperty

    public String getProperty (String name)

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

    حدود
    name String : اسم الخاصية

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

    رميات
    DeviceNotAvailableException

    GetRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getScreenshot

    public InputStreamSource getScreenshot (String format)

    يمسك لقطة شاشة من الجهاز. موصى به لاستخدام GetScreenshot (التنسيق) بدلاً من ذلك مع ترميز JPEG لحجم أصغر

    حدود
    format String : مدعوم PNG ، JPEG

    عائدات
    InputStreamSource InputStreamSource من لقطة الشاشة بالتنسيق ، أو null إذا لم تنجح لقطة الشاشة.

    رميات
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

    الاستيلاء على لقطة شاشة من الجهاز المعرف معرف العرض. التنسيق هو PNG.

    TODO: تمديد التطبيقات أعلاه لدعم "التنسيق" و "Rescale"

    حدود
    displayId long : معرف عرض الشاشة للحصول على لقطة شاشة من.

    عائدات
    InputStreamSource InputStreamSource من لقطة الشاشة بالتنسيق ، أو null إذا لم تنجح لقطة الشاشة.

    رميات
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    يمسك لقطة شاشة من الجهاز. الموصى به لاستخدام getScreenshot(String) بدلاً من ذلك مع ترميز JPEG لحجم أصغر.

    حدود
    format String : مدعوم PNG ، JPEG

    rescale boolean : إذا كان ينبغي إعادة قياس لقطة الشاشة لتقليل حجم الصورة الناتجة

    عائدات
    InputStreamSource InputStreamSource من لقطة الشاشة بالتنسيق ، أو null إذا لم تنجح لقطة الشاشة.

    رميات
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot ()

    يمسك لقطة شاشة من الجهاز.

    عائدات
    InputStreamSource InputStreamSource من لقطة الشاشة بتنسيق PNG ، أو null إذا لم تكن لقطة الشاشة غير ناجحة.

    رميات
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

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

    عائدات
    String الرقم التسلسلي String

    getSetting

    public String getSetting (int userId, 
                    String namespace, 
                    String key)

    إرجاع قيمة الإعداد المطلوب. يجب أن تكون مساحة الاسم واحدة من: {"System" ، "Secure" ، "Global"}

    حدود
    userId int

    namespace String

    key String

    عائدات
    String القيمة المرتبطة بمساحة الاسم: مفتاح المستخدم. فارغة إذا لم يتم العثور عليها.

    رميات
    DeviceNotAvailableException

    getSetting

    public String getSetting (String namespace, 
                    String key)

    انظر getSetting(int, String, String) ويتم تنفيذها على مستخدم النظام.

    حدود
    namespace String

    key String

    عائدات
    String

    رميات
    DeviceNotAvailableException

    getSimoperator

    public String getSimOperator ()

    إرجاع مشغل بطاقة SIM أو NULL إذا لم يكن متاحًا أو إذا لم يكن الجهاز متاحًا.

    عائدات
    String

    getSimstate

    public String getSimState ()

    إرجاع حالة بطاقة SIM أو NULL إذا لم يكن متاحًا أو غير متوفر.

    عائدات
    String

    getTombstones

    public  getTombstones ()

    جلب وإعادة قائمة شواهد القبور من الأجهزة. يتطلب الجذر.

    الطريقة هي أفضل آثار ، لذا إذا فشل أحد شاهد القبور في سحبه لأي سبب من الأسباب ، فستكون مفقودًا من القائمة. فقط DeviceNotAvailableException سوف ينهي الطريقة في وقت مبكر.

    عائدات
    قائمة ملفات Tombstone ، فارغة إذا لم يكن هناك قبر.

    رميات
    DeviceNotAvailableException

    getTotalmemory

    public long getTotalMemory ()

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

    عائدات
    long

    getuninstallablePackagenames

    public  getUninstallablePackageNames ()

    جلب أسماء حزمة التطبيق التي يمكن إلغاء تثبيتها. يتم تعريف هذا في الوقت الحالي على أنه حزم غير نظام ، وحزم النظام المحدثة.

    عائدات
    ERROR(/Set) من أسماء حزم String غير القابلة للتثبيت المثبتة حاليًا على الجهاز.

    رميات
    DeviceNotAvailableException

    getusefastbooterase

    public boolean getUseFastbootErase ()

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

    عائدات
    boolean true إذا تم استخدام محو Fastboot أو false إذا تم استخدام تنسيق Fastboot.

    getUserFlags

    public int getUserFlags (int userId)

    ابحث وإرجاع أعلام مستخدم معين. يتم تعريف الأعلام في "Android.content.pm.userinfo" في مشروع Android Open Source.

    حدود
    userId int

    عائدات
    int الأعلام المرتبطة مع معرف المستخدم المقدم إذا وجدت ، -10000 في أي حالات أخرى.

    رميات
    DeviceNotAvailableException

    getuserinfos

    public  getUserInfos ()

    يحصل على خريطة useId إلى UserInfo على الجهاز. سوف يرمي DeviceRuntimeException إذا لم يكن الإخراج من الجهاز كما هو متوقع.

    عائدات
    قائمة كائنات userInfo.

    رميات
    DeviceNotAvailableException

    getUserialNumber

    public int getUserSerialNumber (int userId)

    إرجاع الرقم التسلسلي المرتبط بـ UserD إذا وجدت ، -10000 في أي حالات أخرى.

    حدود
    userId int

    عائدات
    int

    رميات
    DeviceNotAvailableException

    handleallocationevent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    معالجة الجهاز المعطى. قد ينتقل إلى الجهاز إلى حالة جديدة. سوف إبلاغ IDeviceMonitor بأي تحولات دولة.

    قم بمعالجة الجهاز ، الذي قد ينتقل أو لا ينتقل هذا الجهاز إلى حالة تخصيص جديدة.

    حدود
    event DeviceEvent

    عائدات
    IManagedTestDevice.DeviceEventResponse

    hasfeature

    public boolean hasFeature (String feature)

    تحقق مما إذا كانت ميزة متوفرة على جهاز.

    حدود
    feature String : أي تنسيق يجب أن يكون "ميزة: " أو " " مباشرة.

    عائدات
    boolean صحيح إذا تم العثور على ميزة ، خطأ خلاف ذلك.

    رميات
    DeviceNotAvailableException

    ثبت المجموعة

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    String... extraArgs)

    تثبيت حزمة Android على الجهاز.

    حدود
    packageFile File : ملف APK للتثبيت

    reinstall boolean : true إذا كان ينبغي إجراء إعادة التثبيت

    extraArgs String : وسيطات إضافية اختيارية لتمريرها. انظر "ADB Shell PM -H" للحصول على الخيارات المتاحة.

    عائدات
    String String مع رمز خطأ ، أو null إذا نجح.

    رميات
    DeviceNotAvailableException

    ثبت المجموعة

    public String installPackage (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    String... extraArgs)

    تثبيت حزمة Android على الجهاز.

    ملاحظة: يجب فقط استخدام الحالات التي تتطلب تحكمًا صريحًا في منح إذن وقت التشغيل في وقت التثبيت ، يجب استدعاء هذه الوظيفة.

    حدود
    packageFile File : ملف APK للتثبيت

    reinstall boolean : true إذا كان ينبغي إجراء إعادة التثبيت

    grantPermissions boolean : إذا كان ينبغي منح جميع أذونات وقت التشغيل في وقت التثبيت

    extraArgs String : وسيطات إضافية اختيارية لتمريرها. انظر "ADB Shell PM -H" للحصول على الخيارات المتاحة.

    عائدات
    String String مع رمز خطأ ، أو null إذا نجح.

    رميات
    DeviceNotAvailableException

    InstallPackageForuser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    int userId, 
                    String... extraArgs)

    قم بتثبيت حزمة Android على الجهاز لمستخدم معين.

    حدود
    packageFile File : ملف APK للتثبيت

    reinstall boolean : true إذا كان ينبغي إجراء إعادة التثبيت

    userId int : معرف مستخدم INTEGER للتثبيت ل.

    extraArgs String : وسيطات إضافية اختيارية لتمريرها. انظر "ADB Shell PM -H" للحصول على الخيارات المتاحة.

    عائدات
    String String مع رمز خطأ ، أو null إذا نجح.

    رميات
    DeviceNotAvailableException

    InstallPackageForuser

    public String installPackageForUser (File packageFile, 
                    boolean reinstall, 
                    boolean grantPermissions, 
                    int userId, 
                    String... extraArgs)

    قم بتثبيت حزمة Android على الجهاز لمستخدم معين.

    ملاحظة: يجب فقط استخدام الحالات التي تتطلب تحكمًا صريحًا في منح إذن وقت التشغيل في وقت التثبيت ، يجب استدعاء هذه الوظيفة.

    حدود
    packageFile File : ملف APK للتثبيت

    reinstall boolean : true إذا كان ينبغي إجراء إعادة التثبيت

    grantPermissions boolean : إذا كان ينبغي منح جميع أذونات وقت التشغيل في وقت التثبيت

    userId int : معرف مستخدم INTEGER للتثبيت ل.

    extraArgs String : وسيطات إضافية اختيارية لتمريرها. انظر "ADB Shell PM -H" للحصول على الخيارات المتاحة.

    عائدات
    String String مع رمز خطأ ، أو null إذا نجح.

    رميات
    DeviceNotAvailableException

    PerforaidePropertyCache

    public void invalidatePropertyCache ()

    isadbroot

    public boolean isAdbRoot ()

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    ISADBTCP

    public boolean isAdbTcp ()

    عائدات
    boolean

    isAppenumerationsuported

    public boolean isAppEnumerationSupported ()

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

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

    رميات
    DeviceNotAvailableException

    IsbypasslowtargetSdkblocksupported

    public boolean isBypassLowTargetSdkBlockSupported ()

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

    عائدات
    boolean صحيح إذا تم دعم كتلة SDK LOW الهدف المنخفضة ، فكل خلاف ذلك

    رميات
    DeviceNotAvailableException

    isDebugfsmounted

    public boolean isDebugfsMounted ()

    تحقق مما إذا كان DebuGFs مثبتة.

    عائدات
    boolean true إذا تم تثبيت DebuGFs

    رميات
    DeviceNotAvailableException

    isdeviceencrypted

    public boolean isDeviceEncrypted ()

    إرجاع إذا تم تشفير الجهاز.

    عائدات
    boolean true إذا تم تشفير الجهاز.

    رميات
    DeviceNotAvailableException

    isdirectory

    public boolean isDirectory (String path)

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

    حدود
    path String

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    ISENABLEADBROOT

    public boolean isEnableAdbRoot ()

    عائدات
    boolean true إذا كان يجب تمكين جذر ADB على الجهاز

    isencryptionsupported

    public boolean isEncryptionSupported ()

    إرجاع إذا تم دعم التشفير على الجهاز.

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

    رميات
    DeviceNotAvailableException

    isexecutable

    public boolean isExecutable (String fullPath)

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

    حدود
    fullPath String

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    istfastbootenabled

    public boolean isFastbootEnabled ()

    العودة إذا كان Fastboot متاح للجهاز.

    عائدات
    boolean

    غيره

    public boolean isHeadless ()

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

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    isheadlesssystemusermode

    public boolean isHeadlessSystemUserMode ()

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

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    IsmainuserPermanentadmin

    public boolean isMainUserPermanentAdmin ()

    إرجاع ما إذا كان المستخدم الرئيسي هو مسؤول دائم ولا يمكن حذفه أو تخفيضه إلى حالة عدم إدارة.

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    ismultiusersuported

    public boolean isMultiUserSupported ()

    يحدد ما إذا كان المستخدم متعدد المستخدمين مدعومًا.

    عائدات
    boolean صحيح إذا تم دعم المستخدم المتعدد ، خطأ خلاف ذلك

    رميات
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

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

    حدود
    packageName String : الحزمة التي نتحقق منها إذا تم تثبيتها.

    userId String : معرف المستخدم الذي نتحقق منه تم تثبيت الحزمة. إذا كان لاغية ، سيتم استخدام المستخدم الأساسي صفر.

    عائدات
    boolean صحيح إذا تم الإبلاغ عن الحزمة كما مثبت. خطأ خلاف ذلك.

    رميات
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName)

    استعد الجهاز للحصول على اسم حزمة معين للتحقق مما إذا كان مثبتًا حاليًا أم لا.

    حدود
    packageName String

    عائدات
    boolean صحيح إذا تم الإبلاغ عن الحزمة كما مثبت. خطأ خلاف ذلك.

    رميات
    DeviceNotAvailableException

    isruntimepermissionsuported

    public boolean isRuntimePermissionSupported ()

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

    عائدات
    boolean صحيح إذا تم دعم إذن وقت التشغيل ، خطأ خلاف ذلك.

    رميات
    DeviceNotAvailableException

    isStateBootloaderOrfastbootd

    public boolean isStateBootloaderOrFastbootd ()

    إرجاع صحيح إذا كان الجهاز في TestDeviceState#FASTBOOT أو TestDeviceState.FASTBOOTD .

    عائدات
    boolean

    isuserrunning

    public boolean isUserRunning (int userId)

    تحقق مما إذا كان مستخدم معين يعمل.

    حدود
    userId int

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

    رميات
    DeviceNotAvailableException

    isuSeSecondary

    public boolean isUserSecondary (int userId)

    إرجاع ما إذا كان المستخدم المحدد مستخدمًا ثانويًا وفقًا لأعلامه.

    حدود
    userId int

    عائدات
    boolean صحيح إذا كان المستخدم ثانويًا ، خطأ خلاف ذلك.

    رميات
    DeviceNotAvailableException

    isUsuservisible

    public boolean isUserVisible (int userId)

    يتحقق مما إذا كان المستخدم المحدد مرئيًا.

    المستخدم "المرئي" هو مستخدم يتفاعل مع المستخدم "البشري" وبالتالي يمكنه تشغيل أنشطة الإطلاق (عادة في الشاشة الافتراضية).

    حدود
    userId int

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    isUSERVISIBLEONDISPLAY

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

    يتحقق مما إذا كان المستخدم المحدد مرئيًا في الشاشة المحددة.

    المستخدم "المرئي" هو مستخدم يتفاعل مع المستخدم "البشري" وبالتالي يمكنه تشغيل أنشطة الإطلاق في تلك الشاشة.

    حدود
    userId int

    displayId int

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    isVisibleBackgroundUsersondefaultDisplaySuported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

    إرجاع ما إذا كان الجهاز يسمح لبدء المستخدمين في الخلفية في ERROR(/java.android.view.Display#DEFAULT_DISPLAY) .

    إذا كان الأمر كذلك ، فيمكنك استدعاء startVisibleBackgroundUser(int, int, boolean) ، تمرير شاشة تم إرجاعها بواسطة listDisplayIdsForStartingVisibleBackgroundUsers() (والتي يجب أن تشمل ERROR(/java.android.view.Display#DEFAULT_DISPLAY) ).

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    isvisiblebackgrounduserssuported

    public boolean isVisibleBackgroundUsersSupported ()

    إرجاع ما إذا كان الجهاز يسمح لبدء المستخدمين مرئيين في الخلفية.

    إذا كان الأمر كذلك ، فيمكنك استدعاء startVisibleBackgroundUser(int, int, boolean) ، تمرير شاشة تم إرجاعها بواسطة listDisplayIdsForStartingVisibleBackgroundUsers() .

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    Iswifienabled

    public boolean isWifiEnabled ()

    اختبار إذا تم تمكين wifi.

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

    عائدات
    boolean true إذا تم تمكين wifi. false إذا تم تعطيله

    رميات
    DeviceNotAvailableException

    listdisplayids

    public  listDisplayIds ()

    جمع قائمة معرف العرض المتاح على الجهاز كما ذكرت "Dumpsys SurfaceFlinger".

    عائدات
    قائمة العروض. الافتراضي يعيد دائمًا العرض الافتراضي 0.

    رميات
    DeviceNotAvailableException

    ListDisplayIDSForStartingVisiblebackers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

    الحصول على قائمة العروض التي يمكن استخدامها start a user visible in the background .

    عائدات

    رميات
    DeviceNotAvailableException

    قائمة

    public  listUsers ()

    يحصل على قائمة المستخدمين على الجهاز. سوف يرمي DeviceRuntimeException إذا لم يكن الإخراج من الجهاز كما هو متوقع.

    عائدات
    قائمة معرفات المستخدم.

    رميات
    DeviceNotAvailableException

    لوجان

    public boolean logAnrs (ITestLogger logger)

    يجمع وتسجيل ANRs من الجهاز.

    حدود
    logger ITestLogger : ITestLogger لتسجيل ANRS.

    عائدات
    boolean صحيح إذا كان التسجيل ناجحًا ، خطأ خلاف ذلك.

    رميات
    DeviceNotAvailableException

    logbugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    طريقة المساعد لأخذ bugreport وتسجيله على المراسلين.

    حدود
    dataName String : الاسم الذي سيتم بموجبه الإبلاغ عن bugreport.

    listener ITestLogger : ITestLogger لتسجيل bugreport.

    عائدات
    boolean صحيح إذا كان التسجيل ناجحًا ، خطأ خلاف ذلك.

    logondevice

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

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

    حدود
    tag String : العلامة التي ندرسها رسالتنا في logcat.

    level Log.LogLevel : مستوى التصحيح للرسالة في logcat.

    format String : تنسيق الرسالة.

    args Object : يتم استبدال args عبر string.format ().

    Mountdebugfs

    public void mountDebugfs ()

    جبل debugfs.

    رميات
    DeviceNotAvailableException

    NonblockingReboot

    public void nonBlockingReboot ()

    يصدر أمرًا لإعادة تشغيل الجهاز والإرجاع على الأمر ، وعندما لم يعد الجهاز مرئيًا لـ ADB.

    رميات
    DeviceNotAvailableException

    postadbrootaction

    public void postAdbRootAction ()

    تجاوز إذا كان الجهاز يحتاج إلى بعض الإجراءات المحددة التي يتعين اتخاذها بعد جذر ADB وقبل العودة عبر الإنترنت. لا يتضمن التنفيذ الافتراضي أي إجراءات إضافة. الجذر ADB غير مضمون لتمكينه في هذه المرحلة.

    رميات
    com.android.tradefed.device.devicenotavailableableexception
    DeviceNotAvailableException

    postadbunrotaction

    public void postAdbUnrootAction ()

    تجاوز إذا كان الجهاز يحتاج إلى بعض الإجراءات المحددة التي يتعين اتخاذها بعد ADB Unroot وقبل العودة إلى الجهاز عبر الإنترنت. لا يتضمن التنفيذ الافتراضي أي إجراءات إضافية. لا يضمن جذر ADB تعطيله في هذه المرحلة.

    رميات
    com.android.tradefed.device.devicenotavailableableexception
    DeviceNotAvailableException

    postbootsetup

    public void postBootSetup ()

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

    يجب أن يتم استدعاؤه بعد أن يتم تشغيل الجهاز بالكامل/متاح

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

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

    رميات
    DeviceNotAvailableException

    postinvocationTeardown

    public void postInvocationTearDown (Throwable exception)

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

    حدود
    exception Throwable : إن وجد ، الاستثناء الأخير الذي أثاره فشل الاحتجاج.

    preInvocationSetup

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

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

    حدود
    info IBuildInfo : IBuildInfo من الجهاز.

    attributes MultiMap : السمات المخزنة في سياق الاحتجاج

    رميات
    DeviceNotAvailableException
    TargetSetupError

    Pulldir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Recursively pull directory contents from device.

    حدود
    deviceFilePath String : the absolute file path of the remote source

    localDir File : the local directory to pull files into

    عائدات
    boolean true if file was pulled successfully. false خلاف ذلك.

    رميات
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Retrieves a file off device.

    حدود
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    عائدات
    boolean true if file was retrieved successfully. false خلاف ذلك.

    رميات
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    حدود
    remoteFilePath String : the absolute path to file on device.

    userId int : The user id to pull from

    عائدات
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    رميات
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

    Retrieves a file off device, stores it in a local temporary ERROR(/File) , and returns that File .

    حدود
    remoteFilePath String : the absolute path to file on device.

    عائدات
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    رميات
    DeviceNotAvailableException

    pullFile

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

    Retrieves a file off device.

    حدود
    remoteFilePath String : the absolute path to file on device.

    localFile File : the local file to store contents in. If non-empty, contents will be replaced.

    userId int : The user id to pull from

    عائدات
    boolean true if file was retrieved successfully. false خلاف ذلك.

    رميات
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    Retrieves a file off device, and returns the contents.

    حدود
    remoteFilePath String : the absolute path to file on device.

    عائدات
    String A String containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    رميات
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    A convenience method to retrieve a file from the device's external storage, stores it in a local temporary ERROR(/File) , and return a reference to that File .

    حدود
    remoteFilePath String : the path to file on device, relative to the device's external storage mountpoint

    عائدات
    File A ERROR(/File) containing the contents of the device file, or null if the copy failed for any reason (including problems with the host filesystem)

    رميات
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                     excludedDirectories)

    Recursively push directory contents to device while excluding some directories that are filtered.

    حدود
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    excludedDirectories : Set of excluded directories names that shouldn't be pushed.

    عائدات
    boolean true if file was pushed successfully. false خلاف ذلك.

    رميات
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath)

    Recursively push directory contents to device.

    حدود
    localFileDir File : the local directory to push

    deviceFilePath String : the absolute file path of the remote destination

    عائدات
    boolean true if file was pushed successfully. false خلاف ذلك.

    رميات
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath, 
                    boolean evaluateContentProviderNeeded)

    Variant of pushFile(File, String) which can optionally consider evaluating the need for the content provider.

    حدود
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    evaluateContentProviderNeeded boolean : whether to check if we need the content provider

    عائدات
    boolean true if file was pushed successfully. false خلاف ذلك.

    رميات
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Push a file to device. By default using a content provider.

    حدود
    localFile File : the local file to push

    remoteFilePath String : the remote destination absolute file path

    عائدات
    boolean true if file was pushed successfully. false خلاف ذلك.

    رميات
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Push file created from a string to device

    حدود
    contents String : the contents of the file to push

    remoteFilePath String : the remote destination absolute file path

    عائدات
    boolean true if string was pushed successfully. false خلاف ذلك.

    رميات
    DeviceNotAvailableException

    اعادة التشغيل

    public void reboot (String reason)

    Reboots the device into adb mode with given reason to be persisted across reboot.

    Blocks until device becomes available.

    Last reboot reason can be obtained by querying sys.boot.reason propety.

    حدود
    reason String : a reason for this reboot, or null if no reason is specified.

    رميات
    DeviceNotAvailableException

    اعادة التشغيل

    public void reboot ()

    Reboots the device into adb mode.

    Blocks until device becomes available.

    رميات
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    Reboots the device into bootloader mode.

    Blocks until device is in bootloader mode.

    رميات
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    Reboots the device into fastbootd mode.

    Blocks until device is in fastbootd mode.

    رميات
    DeviceNotAvailableException

    إعادة التمهيد إلى الانتعاش

    public void rebootIntoRecovery ()

    Reboots the device into adb recovery mode.

    Blocks until device enters recovery

    رميات
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    رميات
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Reboots the device into adb sideload mode (note that this is a special mode under recovery)

    Blocks until device enters sideload mode

    حدود
    autoReboot boolean : whether to automatically reboot the device after sideload

    رميات
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    رميات
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

    An alternate to reboot() that only blocks until device is online ie visible to adb.

    حدود
    reason String : a reason for this reboot, or null if no reason is specified.

    رميات
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

    Reboots only userspace part of device.

    Blocks until device becomes available.

    تحذير. Userspace reboot is currently under active development, use it on your own risk.

    رميات
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

    An alternate to rebootUserspace() ()} that only blocks until device is online ie visible to adb.

    رميات
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Attempts to recover device communication.

    عائدات
    boolean True if recovery attempted and successful, returns False if recovery was skipped

    رميات
    DeviceNotAvailableException if device is no longer available

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registers a IDeviceActionReceiver for this device.

    All registered IDeviceActionReceiver s will be notified before a device action starts and after the device action ends.

    حدود
    deviceActionReceiver IDeviceActionReceiver : A IDeviceActionReceiver which will be registered.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    Make the system partition on the device read-only. May reboot the device.

    رميات
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    Make the system partition on the device writable. May reboot the device.

    رميات
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    Make the vendor partition on the device read-only. May reboot the device.

    رميات
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    Make the vendor partition on the device writable. May reboot the device.

    رميات
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

    Remove given device admin in given user and return true if it is successful, false otherwise.

    حدود
    componentName String : of device admin to be removed.

    userId int : of user that the device admin lives in.

    عائدات
    boolean True if it is successful, false otherwise.

    رميات
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Remove all existing device profile owners with the best effort.

    رميات
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Remove a given user from the device.

    حدود
    userId int : of the user to remove

    عائدات
    boolean true if we were successful in removing the user, false otherwise.

    رميات
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

    Reset the flag for content provider setup in order to trigger it again.

    runInstrumentationTests

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

    Convenience method for performing ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) with one or more listeners passed as parameters.

    حدود
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners ITestLifeCycleReceiver : the test result listener(s)

    عائدات
    boolean true if test command completed. false if it failed to complete, but recovery succeeded

    رميات
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

    Runs instrumentation tests, and provides device recovery.

    If connection with device is lost before test run completes, and recovery succeeds, all listeners will be informed of testRunFailed and "false" will be returned. The test command will not be rerun. It is left to callers to retry if necessary.

    If connection with device is lost before test run completes, and recovery fails, all listeners will be informed of testRunFailed and DeviceNotAvailableException will be thrown.

    حدود
    runner IRemoteAndroidTestRunner : the IRemoteAndroidTestRunner which runs the tests

    listeners : the test result listeners

    عائدات
    boolean true if test command completed. false if it failed to complete due to device communication exception, but recovery succeeded

    رميات
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)) but runs the test for the given user.

    حدود
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Same as ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) but runs the test for a given user.

    حدود
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Injects the IConfiguration in use.

    حدود
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    حدود
    avdInfo GceAvdInfo

    setDate

    public void setDate (Date date)

    Sets the date on device

    Note: setting date on device requires root

    حدود
    date Date : specify a particular date; will use host date if null

    رميات
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

    Set a device admin component as device owner in given user.

    حدود
    componentName String : of device admin to be device owner.

    userId int : of the user that the device owner lives in.

    عائدات
    boolean True if it is successful, false otherwise.

    رميات
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Update the device's state.

    حدود
    deviceState TestDeviceState : the TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    For emulator set SizeLimitedOutputStream to log output

    حدود
    output SizeLimitedOutputStream : to log the output

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Sets the Process , when this device is an emulator.

    حدود
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Set the fastboot option for the device. Should be set when device is first allocated.

    حدود
    fastbootEnabled boolean : whether fastboot is available for the device or not

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Sets the path to the fastboot binary that should be used. Still requires isFastbootEnabled() to be true, to have fastboot functions enabled.

    حدود
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    Update the IDevice associated with this ITestDevice.

    The new IDevice must refer the same physical device as the current reference. This method will be called if DDMS has allocated a new IDevice

    حدود
    newDevice IDevice : the IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Sets the time in ms to wait before starting logcat capture for a online device.

    حدود
    delay int : the delay in ms

    setOptions

    public void setOptions (TestDeviceOptions options)

    Set the TestDeviceOptions for the device

    حدود
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Sets the given property value on the device. Requires adb root is true.

    حدود
    propKey String : The key targeted to be set.

    propValue String : The property value to be set.

    عائدات
    boolean returns True if the setprop command was successful, False otherwise.

    رميات
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

    Set the IDeviceRecovery to use for this device. Should be set when device is first allocated.

    حدود
    recovery IDeviceRecovery : the IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

    Set the current recovery mode to use for the device.

    Used to control what recovery method to use when a device communication problem is encountered. Its recommended to only use this method sparingly when needed (for example, when framework is down, etc

    حدود
    mode ITestDevice.RecoveryMode : whether 'recover till online only' mode should be on or not.

    setSetting

    public void setSetting (String namespace, 
                    String key, 
                    String value)

    See setSetting(int, String, String, String) and performed on system user.

    حدود
    namespace String

    key String

    value String

    رميات
    DeviceNotAvailableException

    setSetting

    public void setSetting (int userId, 
                    String namespace, 
                    String key, 
                    String value)

    Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

    حدود
    userId int

    namespace String

    key String

    value String

    رميات
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Injects the ITestLogger instance

    حدود
    testLogger ITestLogger

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

    Set whether to use fastboot erase or fastboot format to wipe a partition on the device.

    حدود
    useFastbootErase boolean : true if fastboot erase should be used or false if fastboot format should be used.

    startLogcat

    public void startLogcat ()

    Start capturing logcat output from device in the background.

    Will have no effect if logcat output is already being captured. Data can be later retrieved via getLogcat.

    When the device is no longer in use, stopLogcat() must be called.

    startLogcat() and stopLogcat() do not normally need to be called when within a TF invocation context, as the TF framework will start and stop logcat.

    startUser

    public boolean startUser (int userId)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

    حدود
    userId int : of the user to start in the background

    عائدات
    boolean true if the user was successfully started in the background.

    رميات
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

    Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

    حدود
    userId int : of the user to start in the background

    waitFlag boolean : will make the command wait until user is started and unlocked.

    عائدات
    boolean true if the user was successfully started in the background.

    رميات
    DeviceNotAvailableException

    startVisibleBackgroundUser

    public boolean startVisibleBackgroundUser (int userId, 
                    int displayId, 
                    boolean waitFlag)

    Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

    NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

    حدود
    userId int : of the user to start in the background

    displayId int : display to start user visible on

    waitFlag boolean : will make the command wait until user is started and unlocked.

    عائدات
    boolean true if the user was successfully started visible in the background.

    رميات
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Close and delete the emulator output.

    stopLogcat

    public void stopLogcat ()

    Stop capturing logcat output from device, and discard currently saved logcat data.

    Will have no effect if logcat output is not being captured.

    stopUser

    public boolean stopUser (int userId)

    Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

    حدود
    userId int : of the user to stop.

    عائدات
    boolean true if the user was successfully stopped.

    رميات
    DeviceNotAvailableException

    stopUser

    public boolean stopUser (int userId, 
                    boolean waitFlag, 
                    boolean forceFlag)

    Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

    حدود
    userId int : of the user to stop.

    waitFlag boolean : will make the command wait until user is stopped.

    forceFlag boolean : will force stop the user.

    عائدات
    boolean true if the user was successfully stopped.

    رميات
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    Switch device to adb-over-tcp mode.

    عائدات
    String the tcp serial number or null if device could not be switched

    رميات
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    Switch device to adb over usb mode.

    عائدات
    boolean true if switch was successful, false otherwise.

    رميات
    DeviceNotAvailableException

    تغير المستخدم

    public boolean switchUser (int userId)

    Switch to another userId with a default timeout. switchUser(int, long) .

    حدود
    userId int

    عائدات
    boolean True if the new userId matches the userId provider. False otherwise.

    رميات
    DeviceNotAvailableException

    تغير المستخدم

    public boolean switchUser (int userId, 
                    long timeout)

    Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

    حدود
    userId int

    timeout long : to wait before returning false for switch-user failed.

    عائدات
    boolean True if the new userId matches the userId provider. False otherwise.

    رميات
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

    Incrementally syncs the contents of a local file directory to device.

    Decides which files to push by comparing timestamps of local files with their remote equivalents. Only 'newer' or non-existent files will be pushed to device. Thus overhead should be relatively small if file set on device is already up to date.

    Hidden files (with names starting with ".") will be ignored.

    Example usage: syncFiles("/tmp/files", "/sdcard") will created a /sdcard/files directory if it doesn't already exist, and recursively push the /tmp/files contents to /sdcard/files.

    حدود
    localFileDir File : the local file directory containing files to recursively push.

    deviceFilePath String : the remote destination absolute file path root. All directories in thos file path must be readable. ie pushing to /data/local/tmp when adb is not root will fail

    عائدات
    boolean true if files were synced successfully. false خلاف ذلك.

    رميات
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

    عائدات
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Uninstall an Android package from device.

    حدود
    packageName String : the Android package to uninstall

    عائدات
    String a String with an error code, or null if success.

    رميات
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Uninstall an Android package from device for a given user.

    حدود
    packageName String : the Android package to uninstall

    userId int : the integer user id to uninstall for.

    عائدات
    String a String with an error code, or null if success.

    رميات
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    Unlocks the device if the device is in an encrypted state.

    This method may restart the framework but will not call postBootSetup() . Therefore, the device might not be fully ready to be tested when this method returns.

    عائدات
    boolean true if successful or if the device is unencrypted.

    رميات
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Unmount debugfs.

    رميات
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blocks until the device's boot complete flag is set.

    حدود
    timeOut long : time in msecs to wait for the flag to be set

    عائدات
    boolean true if device's boot complete flag is set within the timeout

    رميات
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

    Waits for the device to be responsive and available for testing. Uses default timeout.

    عائدات
    boolean True if device is available, False if recovery is disabled and unavailable.

    رميات
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

    Waits for the device to be responsive and available for testing.

    حدود
    waitTime long : the time in ms to wait

    عائدات
    boolean True if device is available, False if recovery is disabled and unavailable.

    رميات
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    Waits for the device to be responsive and available without considering recovery path.

    حدود
    waitTime long

    عائدات
    boolean True if device is available, False if unavailable.

    رميات
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    Blocks until device is visible via fastboot. Use default timeout.

    رميات
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    Blocks for the device to be in the 'adb recovery' state (note this is distinct from IDeviceRecovery ).

    حدود
    waitTime long : the time in ms to wait

    عائدات
    boolean true if device boots into recovery before time expires. false otherwise

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blocks for the device to be in the 'adb sideload' state

    حدود
    waitTime long : the time in ms to wait

    عائدات
    boolean true if device boots into sideload before time expires. false otherwise

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Blocks for the device to be not available ie missing from adb

    حدود
    waitTime long : the time in ms to wait

    عائدات
    boolean true if device becomes not available before time expires. false otherwise

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    Blocks until device is visible via adb. Uses default timeout

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    رميات
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    Blocks until device is visible via adb.

    Note the device may not necessarily be responsive to commands on completion. Use waitForDeviceAvailable() instead.

    حدود
    waitTime long : the time in ms to wait

    رميات
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

    Waits for device to be responsive to a basic adb shell command.

    حدود
    waitTime long : the time in ms to wait

    عائدات
    boolean true if device becomes responsive before waitTime elapses.

    الأساليب المحمية

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    حدود
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

    protected String[] buildAdbShellCommand (String command, 
                    boolean forceExitStatusDetection)

    Builds the OS command for the given adb shell command session and args

    حدود
    command String

    forceExitStatusDetection boolean

    عائدات
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    حدود
    feature String

    strictMinLevel int

    createRebootDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Create a RebootDeviceAction to be used when performing a reboot action.

    حدود
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

    عائدات
    NativeDevice.RebootDeviceAction the created RebootDeviceAction .

    createRunUtil

    protected IRunUtil createRunUtil ()

    عائدات
    IRunUtil

    doAdbReboot

    protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                    String reason)

    Perform a adb reboot.

    حدود
    rebootMode NativeDevice.RebootMode : a mode of this reboot.

    reason String : for this reboot.

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

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    helper method to throw exception if runtime permission isn't supported

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

    getApiLevelSafe

    protected int getApiLevelSafe ()

    عائدات
    int

    getLogger

    protected ITestLogger getLogger ()

    عائدات
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Get the RunUtil instance to use.

    عائدات
    IRunUtil

    initializeConnection

    protected void initializeConnection (IBuildInfo info, 
                    MultiMap<String, String> attributes)

    حدود
    info IBuildInfo

    attributes MultiMap

    رميات
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

    protected String internalGetProperty (String propName, 
                    String fastbootVar, 
                    String description)

    Fetch a device property, from the ddmlib cache by default, and falling back to either `adb shell getprop` or `fastboot getvar` depending on whether the device is in Fastboot or not.

    حدود
    propName String : The name of the device property as returned by `adb shell getprop`

    fastbootVar String : The name of the equivalent fastboot variable to query. if null , fastboot query will not be attempted

    description String : A simple description of the variable. First letter should be capitalized.

    عائدات
    String A string, possibly null or empty, containing the value of the given property

    رميات
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Returns whether reboot callbacks is currently being executed or not. All public api's for reboot should be disabled if true.

    عائدات
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Return true if local file is newer than remote file. IFileEntry being accurate to the minute, in case of equal times, the file will be considered newer.

    حدود
    localFile File

    entry IFileEntry

    عائدات
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Notifies all IDeviceActionReceiver about reboot end event.

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

    notifyRebootStarted

    protected void notifyRebootStarted ()

    Notifies all IDeviceActionReceiver about reboot start event.

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

    performDeviceAction

    protected boolean performDeviceAction (String actionDescription, 
                    NativeDevice.DeviceAction action, 
                    int retryAttempts)

    Performs an action on this device. Attempts to recover device and optionally retry command if action fails.

    حدود
    actionDescription String : a short description of action to be performed. Used for logging purposes only.

    action NativeDevice.DeviceAction : the action to be performed

    retryAttempts int : the retry attempts to make for action if it fails but recovery succeeds

    عائدات
    boolean true if action was performed successfully

    رميات
    DeviceNotAvailableException if recovery attempt fails or max attempts done without success

    postAdbReboot

    protected void postAdbReboot ()

    Possible extra actions that can be taken after a reboot.

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

    prePostBootSetup

    protected void prePostBootSetup ()

    Allows each device type (AndroidNativeDevice, TestDevice) to override this method for specific post boot setup.

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

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    حدود
    remoteFilePath String

    localFile File

    عائدات
    boolean

    رميات
    DeviceNotAvailableException

    اضبط الساعة

    protected void setClock (Clock clock)

    Set the Clock instance to use.

    حدود
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Marks the TestDevice as microdroid and sets its CID.

    حدود
    process Process : Process of the Microdroid VM.

    setTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    حدود
    deviceOptions

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                     envVarMap, 
                    String[] fullCmd)

    Executes a simple fastboot command with environment variables and report the status of the command.

    حدود
    timeout long

    envVarMap

    fullCmd String

    عائدات
    CommandResult

    simpleFastbootCommand

    protected CommandResult simpleFastbootCommand (long timeout, 
                    String[] fullCmd)

    Executes a simple fastboot command and report the status of the command.

    حدود
    timeout long

    fullCmd String

    عائدات
    CommandResult

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

    Wait to see the device going unavailable (stop reporting to adb).

    حدود
    operationDesc String : The name of the operation that is waiting for unavailable.

    time long : The time to wait for unavailable to occur.

    عائدات
    boolean True if device did become unavailable.