NativeDevice
public class NativeDevice
extends Object
implements IManagedTestDevice , IConfigurationReceiver , ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
التنفيذ الافتراضي لأجهزة Android غير الكاملة من ITestDevice
.
ملخص
فصول متداخلة | |
---|---|
class | NativeDevice.AdbAction |
class | NativeDevice.AdbShellAction |
class | NativeDevice.RebootDeviceAction |
الثوابت | |
---|---|
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) يقوم بإنشاء |
الأساليب العامة | |
---|---|
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) متغير من |
boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) متغير من |
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) يزيل |
boolean | deviceSoftRestarted ( ProcessInfo prevSystemServerProcess) طريقة مساعدة للتحقق مما إذا كان الجهاز قد تمت إعادة تشغيله من خلال مقارنة خادم النظام الحالي مع خادم System_server السابق |
boolean | deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit) طريقة مساعدة للتحقق مما إذا كان الجهاز قد تمت إعادة تشغيله بشكل بسيط منذ وقت UTC منذ فترة من الجهاز |
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 ويعيد الإخراج |
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 | executeShellV2Command (String cmd, OutputStream pipeToOutput) الأسلوب المساعد الذي ينفذ أمر adb Shell ويعيد النتائج على شكل |
CommandResult | executeShellV2Command (String cmd, File pipeAsInput) أسلوب مساعد ينفذ أمر adb Shell ويعيد النتائج على شكل |
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 | getCachedDeviceDescriptor (boolean shortDescriptor) يتم إرجاع |
String[] | getChildren (String path) بديل لاستخدام |
AbstractConnection | getConnection () الاتصال الحالي المرتبط بالجهاز. |
DeviceFoldableState | getCurrentFoldableState () يُرجع الحالة الحالية القابلة للطي للجهاز أو فارغة في حالة حدوث بعض المشكلات. |
int | getCurrentUser () قم بإرجاع معرف المستخدم الحالي قيد التشغيل. |
String | getDeviceClass () الحصول على فئة الجهاز. |
long | getDeviceDate () إرجاع تاريخ الجهاز بالمللي ثانية منذ العصر. |
DeviceDescriptor | getDeviceDescriptor () قم بإرجاع |
DeviceDescriptor | getDeviceDescriptor (boolean shortDescriptor) قم بإرجاع |
TestDeviceState | getDeviceState () الحصول على حالة الجهاز. |
long | getDeviceTimeOffset (Date date) مساعد للحصول على الفارق الزمني بين الجهاز |
InputStreamSource | getEmulatorOutput () احصل على دفق المحاكي stdout وstderr |
Process | getEmulatorProcess () قم بإرجاع |
final File | getExecuteShellCommandLog () السجل الذي يحتوي على كافة سجلات |
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) مساعد غير رسمي للحصول على |
getFoldableStates () إرجاع قائمة الحالات القابلة للطي على الجهاز. | |
IDevice | getIDevice () تقوم بإرجاع مرجع إلى ddmlib |
getInstalledPackageNames () جلب أسماء حزم التطبيقات الموجودة على الجهاز. | |
long | getIntProperty (String name, long defaultValue) إرجاع قيمة عددية للخاصية المحددة من الجهاز. |
String | getIpAddress () يحصل على عنوان IP الخاص بالجهاز. |
KeyguardControllerState | getKeyguardState () قم بإرجاع كائن للحصول على الحالة الحالية للوحة المفاتيح أو فارغة إذا لم تكن مدعومة. |
long | getLastExpectedRebootTimeMillis () إرجاع آخر مرة قامت فيها Tradefed APIs بتشغيل عملية إعادة التشغيل بالمللي ثانية منذ EPOCH كما تم إرجاعها بواسطة |
int | getLaunchApiLevel () احصل على أول مستوى API تم إطلاقه بالجهاز. |
InputStreamSource | getLogcat () الاستيلاء على دفق لقطة من بيانات logcat. |
InputStreamSource | getLogcat (int maxBytes) احصل على دفق لقطة لآخر |
InputStreamSource | getLogcatDump () احصل على تفريغ السجل الحالي للجهاز. |
InputStreamSource | getLogcatSince (long date) احصل على دفق لقطة من بيانات logcat التي تم التقاطها بدءًا من التاريخ المقدم. |
String | getMacAddress () يُرجع عنوان MAC الخاص بالجهاز، ويكون فارغًا إذا فشل في الاستعلام من الجهاز. |
Integer | getMainUserId () إرجاع معرف المستخدم الرئيسي. |
getMainlineModuleInfo () احصل على معلومات حول الوحدات الرئيسية المثبتة على الجهاز. | |
int | getMaxNumberOfRunningUsersSupported () احصل على الحد الأقصى لعدد المستخدمين المدعومين الذين يعملون في نفس الوقت. |
int | getMaxNumberOfUsersSupported () احصل على الحد الأقصى لعدد المستخدمين المدعومين. |
Process | getMicrodroidProcess () |
IDeviceStateMonitor | getMonitor () قم بإرجاع |
String | getMountPoint (String mountName) إرجاع نقطة التحميل. |
ITestDevice.MountPointInfo | getMountPointInfo (String mountpoint) يُرجع |
getMountPointInfo () يُرجع نسخة مُحللة من المعلومات الموجودة في /proc/mounts على الجهاز | |
TestDeviceOptions | getOptions () جلب خيارات الاختبار للجهاز. |
long | getPartitionFreeSpace (String partition) طريقة مساعدة لتحديد مقدار المساحة الحرة على قسم الجهاز. |
Integer | getPrimaryUserId () إرجاع معرف المستخدم الأساسي. |
ProcessInfo | getProcessByName (String processName) يقوم الأسلوب المساعد بتشغيل الأمر "pidof" و"stat" وإرجاع كائن |
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) راجع |
String | getSimOperator () قم بإرجاع مشغل بطاقة SIM أو فارغًا إذا لم يكن متاحًا أو إذا كان الجهاز غير متاح. |
String | getSimState () قم بإرجاع حالة بطاقة SIM أو فارغة إذا لم تكن متوفرة أو كان الجهاز غير متوفر. |
getTombstones () جلب وإرجاع قائمة شواهد القبور من الأجهزة. | |
long | getTotalMemory () يُرجع إجمالي حجم الذاكرة الفعلية بالبايت أو -1 في حالة حدوث خطأ داخلي |
getUninstallablePackageNames () قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. | |
boolean | getUseFastbootErase () تعرف على ما إذا كنت تريد استخدام مسح fastboot أو تنسيق fastboot لمسح قسم على الجهاز. |
int | getUserFlags (int userId) البحث عن إشارات مستخدم معين وإعادتها. |
getUserInfos () يحصل على خريطة useId لمعلومات | |
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 () يُرجع صحيحًا إذا كان الجهاز في |
boolean | isUserRunning (int userId) تحقق مما إذا كان مستخدم معين قيد التشغيل. |
boolean | isUserSecondary (int userId) قم بإرجاع ما إذا كان المستخدم المحدد مستخدمًا ثانويًا وفقًا لعلاماته. |
boolean | isUserVisible (int userId) يتحقق مما إذا كان المستخدم المحدد مرئيًا. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) يتحقق مما إذا كان المستخدم المحدد مرئيًا في الشاشة المحددة. |
boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () يُرجع ما إذا كان الجهاز يسمح للمستخدمين ببدء الظهور في الخلفية في |
boolean | isVisibleBackgroundUsersSupported () إرجاع ما إذا كان الجهاز يسمح للمستخدمين ببدء الظهور في الخلفية. |
boolean | isWifiEnabled () اختبار ما إذا تم تمكين واي فاي. |
listDisplayIds () قم بتجميع قائمة معرفات شاشات العرض المتوفرة على الجهاز كما ورد في "dumpsys SurfaceFlinger". | |
listDisplayIdsForStartingVisibleBackgroundUsers () يحصل على قائمة العروض التي يمكن استخدامها | |
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) يسترد ملفًا من الجهاز، ويخزنه في ملف |
File | pullFile (String remoteFilePath) يسترد ملفًا من الجهاز، ويخزنه في ملف |
boolean | pullFile (String remoteFilePath, File localFile, int userId) استرداد ملف من الجهاز. |
String | pullFileContents (String remoteFilePath) يسترد ملفًا من الجهاز، ويعيد محتوياته. |
File | pullFileFromExternal (String remoteFilePath) طريقة ملائمة لاسترداد ملف من وحدة التخزين الخارجية للجهاز، وتخزينه في ملف |
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) متغير من |
boolean | pushFile (File localFile, String remoteFilePath) ادفع ملفًا إلى الجهاز. |
boolean | pushString (String contents, String remoteFilePath) دفع الملف الذي تم إنشاؤه من سلسلة إلى الجهاز |
void | reboot (String reason) يعيد تشغيل الجهاز في وضع adb مع وجود |
void | reboot () يعيد تشغيل الجهاز في وضع adb. |
void | rebootIntoBootloader () يعيد تشغيل الجهاز في وضع أداة تحميل التشغيل. |
void | rebootIntoFastbootd () يعيد تشغيل الجهاز إلى وضع fastbootd. |
void | rebootIntoRecovery () يعيد تشغيل الجهاز في وضع الاسترداد adb. |
void | rebootIntoSideload () يعيد تشغيل الجهاز في وضع التحميل الجانبي لـ adb (لاحظ أن هذا وضع خاص قيد الاسترداد) يتم الحظر حتى يدخل الجهاز في وضع التحميل الجانبي |
void | rebootIntoSideload (boolean autoReboot) يعيد تشغيل الجهاز في وضع التحميل الجانبي لـ adb (لاحظ أن هذا وضع خاص قيد الاسترداد) يتم الحظر حتى يدخل الجهاز في وضع التحميل الجانبي |
void | rebootUntilOnline () بديل لإعادة |
void | rebootUntilOnline (String reason) بديل لإعادة |
void | rebootUserspace () يعيد تشغيل جزء مساحة المستخدم فقط من الجهاز. |
void | rebootUserspaceUntilOnline () بديل لـ |
boolean | recoverDevice () محاولات لاستعادة اتصالات الجهاز. |
void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) يقوم بتسجيل |
void | remountSystemReadOnly () جعل قسم النظام على الجهاز للقراءة فقط. |
void | remountSystemWritable () جعل قسم النظام على الجهاز قابلاً للكتابة. |
void | remountVendorReadOnly () اجعل قسم البائع على الجهاز للقراءة فقط. |
void | remountVendorWritable () جعل قسم البائع على الجهاز قابلاً للكتابة. |
boolean | removeAdmin (String componentName, int userId) قم بإزالة مسؤول الجهاز المحدد في مستخدم معين وإرجاع |
void | removeOwners () قم بإزالة جميع مالكي ملفات تعريف الجهاز الحاليين بأقصى جهد. |
boolean | removeUser (int userId) إزالة مستخدم معين من الجهاز. |
void | resetContentProviderSetup () قم بإعادة تعيين العلامة لإعداد موفر المحتوى لتشغيلها مرة أخرى. |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners) طريقة ملائمة لتنفيذ |
boolean | runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) runInstrumentationTests (IRemoteAndroidTestRunner runner, listeners) يقوم بإجراء اختبارات الأجهزة، ويوفر إمكانية استرداد الجهاز. |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, listeners) نفس الخطأ مثل |
boolean | runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners) مثل |
void | setConfiguration ( IConfiguration configuration) يقوم بإدخال |
final void | setConnectionAvdInfo ( GceAvdInfo avdInfo) |
void | setDate (Date date) يضبط التاريخ على الجهاز ملاحظة: تحديد التاريخ على الجهاز يتطلب الجذر |
boolean | setDeviceOwner (String componentName, int userId) قم بتعيين مكون مسؤول الجهاز كمالك للجهاز في مستخدم معين. |
void | setDeviceState ( TestDeviceState deviceState) تحديث حالة الجهاز. |
void | setEmulatorOutputStream ( SizeLimitedOutputStream output) بالنسبة للمحاكي، قم بتعيين |
void | setEmulatorProcess (Process p) يضبط |
void | setFastbootEnabled (boolean fastbootEnabled) اضبط خيار التشغيل السريع للجهاز. |
void | setFastbootPath (String fastbootPath) يضبط المسار إلى ملف fastboot الثنائي الذي يجب استخدامه. |
void | setIDevice (IDevice newDevice) قم بتحديث IDevice المرتبط بـ ITestDevice هذا. |
void | setLogStartDelay (int delay) يضبط الوقت بالمللي ثانية للانتظار قبل بدء التقاط logcat لجهاز متصل بالإنترنت. |
void | setOptions ( TestDeviceOptions options) قم بتعيين |
boolean | setProperty (String propKey, String propValue) يضبط قيمة الخاصية المحددة على الجهاز. |
void | setRecovery ( IDeviceRecovery recovery) قم بتعيين |
void | setRecoveryMode ( ITestDevice.RecoveryMode mode) اضبط وضع الاسترداد الحالي الذي سيتم استخدامه للجهاز. |
void | setSetting (String namespace, String key, String value) راجع |
void | setSetting (int userId, String namespace, String key, String value) أضف قيمة إعداد إلى مساحة الاسم لمستخدم معين. |
void | setTestLogger ( ITestLogger testLogger) يقوم بإدخال مثيل |
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 () خذ تقرير الأخطاء وأعده داخل كائن |
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" (لاحظ أن هذا يختلف عن |
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) قم بإنشاء |
IRunUtil | createRunUtil () |
void | doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason) إجراء إعادة تشغيل بنك التنمية الآسيوي. |
void | ensureRuntimePermissionSupported () أسلوب مساعد لطرح الاستثناء إذا كان إذن وقت التشغيل غير مدعوم |
int | getApiLevelSafe () |
ITestLogger | getLogger () |
IRunUtil | getRunUtil () احصل على مثيل |
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) يُرجع |
void | notifyRebootEnded () يقوم بإعلام كافة |
void | notifyRebootStarted () يخطر كافة |
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
المقاولين العامة
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 | |
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 |
عائدات | |
---|---|
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 | |
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
publicgetActiveApexes ()
قم بإحضار معلومات حول القمة التي تم تنشيطها على الجهاز.
عائدات | |
---|---|
ERROR(/Set) من ApexInfo تم تنشيطه حاليًا على الجهاز |
رميات | |
---|---|
DeviceNotAvailableException |
getAllsettings
publicgetAllSettings (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
publicgetAndroidIds ()
إنشاء خريطة معرفات 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
publicgetAppPackageInfos ()
جلب معلومات الحزم المثبتة على الجهاز.
عائدات | |
---|---|
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
publicgetBootHistory ()
تقوم طريقة Helper بجمع خريطة تاريخ التمهيد مع وقت التمهيد وسبب التمهيد.
عائدات | |
---|---|
خريطة وقت التمهيد (وقت UTC في الثانية منذ عصر) وعقل التمهيد |
رميات | |
---|---|
DeviceNotAvailableException |
getBoothistorysince
publicgetBootHistorySince (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 |
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
publicgetFoldableStates ()
إرجاع قائمة الحالات القابلة للطي على الجهاز. يمكن الحصول عليها باستخدام "CMD Device_State Print-States".
عائدات | |
---|---|
رميات | |
---|---|
DeviceNotAvailableException |
getidevice
public IDevice getIDevice ()
إرجاع إشارة إلى ddmlib IDevice
المرتبطة.
قد يتم تخصيص IDevice
الجديد بواسطة DDMS في كل مرة يقوم فيها الجهاز بفصل وإعادة الاتصال من ADB. وبالتالي ، يجب ألا يحتفظ المتصلين بالإشارة إلى IDevice
، لأن هذه المرجع قد تصبح قديمة.
عائدات | |
---|---|
IDevice | IDevice |
getInstalledPackagenames
publicgetInstalledPackageNames ()
جلب أسماء حزمة التطبيق الموجودة على الجهاز.
عائدات | |
---|---|
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.
يعمل في وضعين:
TestDeviceOptions.getMaxLogcatDataSize()
بايت للمحتويات الحالية لالتقاط الخلفية لوجاتعائدات | |
---|---|
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
publicgetMainlineModuleInfo ()
احصل على المعلومات حول وحدات الخط الرئيسي المثبتة على الجهاز.
عائدات | |
---|---|
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
publicgetMountPointInfo ()
إرجاع نسخة محسورة من المعلومات في /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
publicgetTombstones ()
جلب وإعادة قائمة شواهد القبور من الأجهزة. يتطلب الجذر.
الطريقة هي أفضل آثار ، لذا إذا فشل أحد شاهد القبور في سحبه لأي سبب من الأسباب ، فستكون مفقودًا من القائمة. فقط DeviceNotAvailableException
سوف ينهي الطريقة في وقت مبكر.
عائدات | |
---|---|
قائمة ملفات Tombstone ، فارغة إذا لم يكن هناك قبر. |
رميات | |
---|---|
DeviceNotAvailableException |
getTotalmemory
public long getTotalMemory ()
إرجاع حجم الذاكرة الفيزيائية الكلية بالبايت أو -1 في حالة وجود خطأ داخلي
عائدات | |
---|---|
long |
getuninstallablePackagenames
publicgetUninstallablePackageNames ()
جلب أسماء حزمة التطبيق التي يمكن إلغاء تثبيتها. يتم تعريف هذا في الوقت الحالي على أنه حزم غير نظام ، وحزم النظام المحدثة.
عائدات | |
---|---|
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
publicgetUserInfos ()
يحصل على خريطة 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 ()
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
publiclistDisplayIds ()
جمع قائمة معرف العرض المتاح على الجهاز كما ذكرت "Dumpsys SurfaceFlinger".
عائدات | |
---|---|
قائمة العروض. الافتراضي يعيد دائمًا العرض الافتراضي 0. |
رميات | |
---|---|
DeviceNotAvailableException |
ListDisplayIDSForStartingVisiblebackers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
الحصول على قائمة العروض التي يمكن استخدامها start a user visible in the background
.
عائدات | |
---|---|
رميات | |
---|---|
DeviceNotAvailableException |
قائمة
publiclistUsers ()
يحصل على قائمة المستخدمين على الجهاز. سوف يرمي 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 (). |
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 |
عائدات | |
---|---|
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 |
عائدات | |
---|---|
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 callpostBootSetup()
. 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 |
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 . |
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 |
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. |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2023-12-04 (حسب التوقيت العالمي المتفَّق عليه)