جهاز NativeDevice
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
java.lang.Object | |
↳ | com.android.tradefed.device.NativeDevice |
التنفيذ التلقائي لأجهزة ITestDevice
التي تعمل بنظام التشغيل Android غير المكدّسة بالكامل
ملخّص
الصفوف المتداخلة | |
---|---|
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" الحصول على لكل منها. |
boolean
|
canSwitchToHeadlessSystemUser()
تعرض ما إذا كان مسموحًا بالتبديل إلى مستخدم SYSTEM بلا واجهة مستخدم رسومية. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
تحقَّق مما إذا كانت إحدى الميزات متوفّرة حاليًا بالمستوى الأدنى المتاح بها. |
boolean
|
checkConnectivity()
تأكَّد من اتصال الجهاز بالشبكة. |
boolean
|
clearErrorDialogs()
حاول إغلاق أي مربعات حوار تعرض أخطاءً معروضة حاليًا في واجهة مستخدم الجهاز. |
void
|
clearLastConnectedWifiNetwork()
يؤدي هذا الإجراء إلى محو آخر شبكة Wi-Fi متصلة. |
void
|
clearLogcat()
يؤدي هذا الإجراء إلى حذف أي بيانات متراكمة لبيانات Logcat. |
boolean
|
connectToWifiNetwork(
يتصل بشبكة Wi-Fi. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
يتصل بشبكة Wi-Fi. |
boolean
|
connectToWifiNetwork(
الاتصال بشبكة wifi network.f |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
يتصل بشبكة Wi-Fi. |
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, int userId)
طريقة مساعِدة لحذف ملف أو دليل على الجهاز |
void
|
deleteFile(String deviceFilePath)
طريقة مساعِدة لحذف ملف أو دليل على الجهاز |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
يؤدي هذا الإجراء إلى إزالة |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكلٍ مبدئي من خلال مقارنة النظام الحالي مع system_server
خادم System_server السابق هو |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكلٍ مبدئي منذ التوقيت العالمي المنسَّق منذ بدء حساب الفترة
الجهاز و |
boolean
|
disableAdbRoot()
يؤدي هذا الإجراء إلى إيقاف جذر الإعلان. |
void
|
disableKeyguard()
محاولات لإيقاف حارس المفاتيح. |
boolean
|
disableNetworkMonitor()
لإيقاف مراقبة الشبكة على الجهاز. |
boolean
|
disconnectFromWifi()
انقطاع الاتصال بشبكة Wi-Fi |
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,
طريقة مساعد تنفِّذ أمر 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(
الطريقة المساعِدة التي تنفّذ أمر 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()
استرجاع المعلومات حول ملفات APK التي تم تفعيلها على الجهاز |
|
getAllSettings(String namespace)
عرض أزواج قيم المفاتيح لمساحة الاسم المطلوبة |
DeviceAllocationState
|
getAllocationState()
عرض حالة التخصيص الحالية للجهاز |
String
|
getAndroidId(int userId)
ابحث عن معرّف android المرتبط بمعرّف المستخدم، واعرضه فارغًا في حال عدم العثور عليه. |
|
getAndroidIds()
إنشاء خريطة لأرقام تعريف Android التي تم العثور على أرقام تعريف المستخدمين المطابقة لها. |
int
|
getApiLevel()
الحصول على مستوى واجهة برمجة التطبيقات للجهاز |
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()
الاتصال الحالي المرتبط بالجهاز |
ContentProviderHandler
|
getContentProvider(int userId)
تعرض القيمة |
DeviceFoldableState
|
getCurrentFoldableState()
تعرض الحالة الحالية القابلة للطيّ للجهاز أو القيمة فارغة في حال حدوث بعض المشاكل. |
int
|
getCurrentUser()
عرض معرّف المستخدم الحالي قيد التشغيل. |
String
|
getDeviceClass()
الحصول على فئة الجهاز. |
long
|
getDeviceDate()
عرض تاريخ الجهاز بالمللي ثانية منذ تاريخ بدء حساب الفترة |
DeviceDescriptor
|
getDeviceDescriptor()
إرجاع |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
إرجاع |
TestDeviceState
|
getDeviceState()
تعرَّف على حالة الجهاز. |
long
|
getDeviceTimeOffset(Date date)
المساعدة في معرفة فرق الوقت بين الجهاز وجهاز |
InputStreamSource
|
getEmulatorOutput()
احصل على مجموعات بث الألعاب الأساسية والمحاكية |
Process
|
getEmulatorProcess()
اعرض |
final
File
|
getExecuteShellCommandLog()
السجلّ الذي يحتوي على جميع سجلّات |
long
|
getExternalStoreFreeSpace()
طريقة مساعد لتحديد مقدار المساحة الخالية على وحدة التخزين الخارجية للجهاز. |
String
|
getFastbootPath()
لعرض مسار البرنامج الثنائي Fastboot المستخدَم. |
String
|
getFastbootProductType()
طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع. |
String
|
getFastbootProductVariant()
طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع. |
String
|
getFastbootSerialNumber()
لعرض الرقم التسلسلي لوضع Fastboot (Fastboot mode). |
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 إعادة التشغيل بالمللي ثانية منذ EPOCH بالشكل
تم إرجاعه بواسطة |
int
|
getLaunchApiLevel()
يمكنك الحصول على مستوى واجهة برمجة التطبيقات الذي تم إطلاقه في الجهاز للمرة الأولى. |
InputStreamSource
|
getLogcat()
الحصول على بث موجز لبيانات Logcat |
InputStreamSource
|
getLogcat(int maxBytes)
يتيح هذا الإعداد الحصول على لقطة شاشة من آخر |
InputStreamSource
|
getLogcatDump()
يمكنك الحصول على ملف تفريغ لسجلّ Logcat الحالي الخاص بالجهاز. |
InputStreamSource
|
getLogcatSince(long date)
يتيح هذا الإجراء الحصول على لقطة من بيانات Logcat التي تم التقاطها اعتبارًا من التاريخ المحدَّد. |
String
|
getMacAddress()
يعرض عنوان MAC للجهاز، فارغًا في حال تعذّر طلب البحث من الجهاز. |
Integer
|
getMainUserId()
تعرض رقم تعريف المستخدم الرئيسي. |
|
getMainlineModuleInfo()
الحصول على معلومات حول الوحدات الرئيسية المثبتة على الجهاز |
int
|
getMaxNumberOfRunningUsersSupported()
الحصول على الحد الأقصى لعدد الأجهزة المتوافقة التي تعمل بنظام التشغيل Android في آنٍ واحد |
int
|
getMaxNumberOfUsersSupported()
الحصول على أقصى عدد من المستخدمين المعتمَدين |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
إرجاع |
String
|
getMountPoint(String mountName)
تعرض نقطة تثبيت. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
عرض |
|
getMountPointInfo()
عرض نسخة محللة من المعلومات في الملف /proc/خاصية التثبيت على الجهاز |
TestDeviceOptions
|
getOptions()
جلب خيارات الاختبار للجهاز |
long
|
getPartitionFreeSpace(String partition)
طريقة مساعِدة لتحديد مقدار المساحة الخالية في قسم الجهاز |
Integer
|
getPrimaryUserId()
تعرض معرّف المستخدم الأساسي. |
ProcessInfo
|
getProcessByName(String processName)
تشغِّل الطريقة المساعدة "pidof". و"stat" وتُرجع الكائن |
String
|
getProcessPid(String process)
تعرض pid للخدمة أو صفرًا إذا حدث خطأ ما. |
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()
يمكنك استرجاع قائمة ملفات Tombstones وإرجاعها من الأجهزة. |
long
|
getTotalMemory()
عرض إجمالي حجم الذاكرة الفعلية بالبايت أو -1 في حال حدوث خطأ داخلي |
String
|
getTrackingSerial()
لأغراض إدارة الجهاز، احصل على الرقم التسلسلي المستخدَم لتتبُّع الجهاز. |
|
getUninstallablePackageNames()
جلب أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. |
boolean
|
getUseFastbootErase()
تعرَّف على ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز. |
int
|
getUserFlags(int userId)
يمكنك العثور على علامات مستخدم معيّن وعرضها. |
|
getUserInfos()
يحصل على خريطة UseId إلى |
int
|
getUserSerialNumber(int userId)
اعرض الرقم التسلسلي المرتبط برقم تعريف المستخدم (userId) إن تم العثور عليه، والذي يبلغ -10000 في أي حالات أخرى. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
معالجة DeviceEvent المحدد. معالجة 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()
تأكَّد من تثبيت برامج تصحيح الأخطاء. |
boolean
|
isDeviceEncrypted()
يعرض هذا الخيار ما إذا كان الجهاز مشفرًا. |
boolean
|
isDirectory(String path)
يمكنك عرض "صحيح" إذا كان المسار على الجهاز دليلاً وخطأ في الحالات الأخرى. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
يعرض هذا الخيار ما إذا كان التشفير متاحًا على الجهاز. |
boolean
|
isExecutable(String fullPath)
يعرض True إذا كان مسار الملف على الجهاز ملفًا تنفيذيًا، وخطأ في الحالات الأخرى. |
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()
اختبِر ما إذا تم تفعيل شبكة Wi-Fi. |
|
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()
يمكنك تجاوز ما إذا كان الجهاز يحتاج إلى اتخاذ بعض الإجراءات المحددة بعد adb unroot وقبل اتصال الجهاز بالإنترنت مرة أخرى. |
void
|
postBootSetup()
نفِّذ التعليمات لإعداد الجهاز لاختبار ذلك بعد كل تمهيد. |
void
|
postInvocationTearDown(Throwable exception)
خطوات إضافية سيتم تنفيذها بعد الاستدعاء والتنظيف المطلوب المتعلق بالجهاز . |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
خطوات إضافية للإعداد المطلوب المحدد للجهاز والذي سيتم تنفيذه على الجهاز قبل تدفق الاستدعاء. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
سحب محتوى الدليل من الجهاز بشكل متكرر |
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,
دفع محتويات الدليل إلى الجهاز بشكل متكرر مع استبعاد بعض الأدلة تمت تصفيته. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
دفع محتوى الدليل إلى الجهاز بشكل متكرر. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
دفع محتوى الدليل إلى الجهاز بشكل متكرر. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
صيغة |
boolean
|
pushFile(File localFile, String remoteFilePath)
إرسال ملف إلى الجهاز |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
إرسال ملف إلى الجهاز |
boolean
|
pushString(String contents, String remoteFilePath)
ملف دفع تم إنشاؤه من سلسلة إلى جهاز |
void
|
reboot(String reason)
يؤدي إلى إعادة تشغيل الجهاز في وضع adb باستخدام |
void
|
reboot()
يعيد تشغيل الجهاز في وضع adb. |
void
|
rebootIntoBootloader()
يؤدي هذا الإجراء إلى إعادة تشغيل الجهاز باستخدام وضع برنامج الإقلاع. |
void
|
rebootIntoFastbootd()
يعيد تشغيل الجهاز في وضع Fastbootd. |
void
|
rebootIntoRecovery()
يعيد تشغيل الجهاز في وضع الاسترداد (Recovery mode) باستخدام 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,
إجراء اختبارات قياس حالة الجهاز وتوفير إمكانية استرداد الأجهزة |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
الأسعار نفسها في فندق |
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)
يمكنك ضبط خيار Fastboot للجهاز. |
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
|
setTrackingSerial(String trackingSerial)
لأغراض إدارة الجهاز، يمكنك تتبُّع الرقم التسلسلي الذي نستخدمه للإشارة إلى الجهاز. |
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)
بدِّل إلى userId آخر له مهلة تلقائية. |
boolean
|
switchUser(int userId, long timeout)
يُرجى التبديل إلى userId آخر ضمن المهلة المحدّدة كموعد نهائي. |
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 (Fastboot). |
boolean
|
waitForDeviceInRecovery(long waitTime)
حظر وصول الجهاز إلى الإعداد "استرداد adb" (لاحظ أن هذا يختلف عن
|
boolean
|
waitForDeviceInSideload(long waitTime)
يحظر وصول الجهاز إلى الحقل "adb sideload" (التحميل الجانبي من adb) ولاية |
boolean
|
waitForDeviceNotAvailable(long waitTime)
قوالب عدم توفُّر الجهاز، أي أنّه غير متوفّر في adb |
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)
أعِد تشغيل أداة Adb. |
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 getrep` أو `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)
تضع علامة على TestDevice على أنّه ميكروdroid وتضبط الرقم التعريفي للعميل الخاص به. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
يتم تنفيذ أمر Fastboot بسيط باستخدام متغيرات البيئة والإبلاغ عن حالة الأمر. |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
ينفّذ أمر Fastboot بسيطًا ويبلغ عن حالة الأمر. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
يُرجى الانتظار إلى أن يكون الجهاز غير متاح (يمكنك إيقاف التقارير إلى adb). |
الثوابت
معرِّف المستخدم غير الصالح
public static final int INVALID_USER_ID
القيمة التي تم عرضها لأي رقم تعريف مستخدم غير صالح/لم يتم العثور عليه: حدّد UserHandle القيمة -10000
القيمة الثابتة: -10,000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
القيمة الثابتة: 5,000 (0x0000000000001388)
عدد المحاولات: MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
العدد الافتراضي لمحاولات الأمر لإعادة محاولة تنفيذ
القيمة الثابتة: 2 (0x00000002)
الحقول
DEBUGFS_PATH
public static final String DEBUGFS_PATH
بطاقة SD_CARD
protected static final String SD_CARD
سعة التخزين_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 للإبلاغ عن تغييرات حالة التخصيص.
يمكن تركه فارغًا |
الطرق العامة
paymentsPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
التحسين الجزئي (حوالي 400 مللي ثانية) من خلال الجلب المسبق لجميع الأدوات التي نحتاجها بدلاً من استدعاء "adb" الحصول على لكل منها. بمعنى أنه يمكن استرجاع جميع المواقع بنفس السرعة التي يتم بها استرجاع إحدى السمات. أشياء مثل device.getApiLevel() وcheckApiLevelAsuchstNextRelease وgetBuildAlias كل المكالمات الميزات المتقدّمة في "adb getrep" نجلبها من خلال استدعاء واحد ونسميها NativeDevice.setProperty. وحتى إذا لم نفعل ذلك، فسوف يستدعي NativeDevice نفسه setProperty وتخزّن النتيجة مؤقتًا في المستقبل. نحن نفعل ذلك في وقت سابق بقليل. إذا كان الجهاز في وضع الاسترداد أو هناك أخطاء أخرى في جلب الدعائم، ونتجاهلها فقط.
مستخدم canSwitchToHeadlessSystem
public boolean canSwitchToHeadlessSystemUser ()
تعرض ما إذا كان مسموحًا بالتبديل إلى مستخدم SYSTEM بلا واجهة مستخدم رسومية.
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
تحقق منApiLevelAمقابلstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
تحقَّق مما إذا كانت إحدى الميزات متوفّرة حاليًا بالمستوى الأدنى المتاح بها. هذا النمط الميزات التي لم يتم إطلاقها بعد، قبل رفع مستوى واجهة برمجة التطبيقات.
المعلمات | |
---|---|
strictMinLevel |
int : الحد الأدنى المتشدد المُحتمل الذي يتيح استخدام الميزة. |
المرتجعات | |
---|---|
boolean |
صحيح إذا كان المستوى متوافقًا. خطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
التحقق من الاتصال
public boolean checkConnectivity ()
تأكَّد من اتصال الجهاز بالشبكة.
المرتجعات | |
---|---|
boolean |
true إذا كان الجهاز متصلاً بشبكة سليمة،
false بشكل زائد. |
الرميات | |
---|---|
DeviceNotAvailableException |
مربعات حوار clearErrors
public boolean clearErrorDialogs ()
حاول إغلاق أي مربعات حوار تعرض أخطاءً معروضة حاليًا في واجهة مستخدم الجهاز.
المرتجعات | |
---|---|
boolean |
true في حال عدم توفّر مربّعات حوار أو محو مربّعات الحوار بنجاح.
false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
يؤدي هذا الإجراء إلى محو آخر شبكة Wi-Fi متصلة. يجب طلب هذه البيانات عند بدء استدعاء جديد. لتجنُّب الاتصال بشبكة Wi-Fi المستخدَمة في الاختبار السابق بعد إعادة تشغيل الجهاز.
clearLogcat
public void clearLogcat ()
يؤدي هذا الإجراء إلى حذف أي بيانات متراكمة لبيانات Logcat.
يمكنك الاستفادة من هذه الميزة في الحالات التي تريد فيها ضمان إرجاع ITestDevice#getLogcat()
فقط.
بيانات السجل الناتجة عن نقطة معينة (على سبيل المثال، بعد وميض إصدار جهاز جديد، إلخ).
الاتصال بشبكة Wi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
يتصل بشبكة Wi-Fi.
تفعيل شبكة Wi-Fi وحظرها إلى أن يتم الاتصال بنجاح باستخدام إحدى شبكات Wi-Fi
الشبكات المقدمة في خريطة wifiSidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل
استعادة الاتصال بعد كل إعادة تشغيل حتى ITestDevice#disconnectFromWifi()
أو
ITestDevice#clearLastConnectedWifiNetwork()
يَحْمِلُ الِاسْمْ.
المعلمات | |
---|---|
wifiSsidToPsk |
: خريطة لمعرّفات SSID لشبكات Wi-Fi وكلمات المرور |
scanSsid |
boolean : ما إذا كان سيتم البحث عن معرِّفات مجموعة الخدمات (SSID) المخفية لهذه الشبكة. |
المرتجعات | |
---|---|
boolean |
true في حال الاتصال بشبكة Wi-Fi بنجاح. false
أو |
الرميات | |
---|---|
DeviceNotAvailableException |
الاتصال بشبكة Wi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
يتصل بشبكة Wi-Fi.
يؤدي هذا الوضع إلى تفعيل شبكة Wi-Fi والحظر إلى أن يتم إجراء اتصال ناجح بشبكة Wi-Fi المحدّدة.
بعد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل.
حتى ITestDevice#disconnectFromWifi()
أو
ITestDevice#clearLastConnectedWifiNetwork()
يَحْمِلُ الِاسْمْ.
المعلمات | |
---|---|
wifiSsid |
String : معرِّف شبكة Wi-Fi للاتصال به |
wifiPsk |
String : عبارة مرور PSK أو قيمة فارغة إذا لم يتم تشفيرها |
المرتجعات | |
---|---|
boolean |
true في حال الاتصال بشبكة Wi-Fi بنجاح. false
أو |
الرميات | |
---|---|
DeviceNotAvailableException |
الاتصال بشبكة Wi-Fi
public boolean connectToWifiNetwork (wifiSsidToPsk)
يتصل بشبكة Wi-Fi.
تفعيل شبكة Wi-Fi وحظرها إلى أن يتم الاتصال بنجاح باستخدام إحدى شبكات Wi-Fi
الشبكات المقدمة في خريطة wifiSidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل
استعادة الاتصال بعد كل إعادة تشغيل حتى ITestDevice#disconnectFromWifi()
أو
يُطلق على ITestDevice#clearLastConnectedWifiNetwork()
اسم.f
المعلمات | |
---|---|
wifiSsidToPsk |
: خريطة لمعرّفات SSID لشبكات Wi-Fi وكلمات المرور |
المرتجعات | |
---|---|
boolean |
true في حال الاتصال بشبكة Wi-Fi بنجاح. false
أو |
الرميات | |
---|---|
DeviceNotAvailableException |
الاتصال بشبكة Wi-Fi
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
يتصل بشبكة Wi-Fi.
يؤدي هذا الوضع إلى تفعيل شبكة Wi-Fi والحظر إلى أن يتم إجراء اتصال ناجح بشبكة Wi-Fi المحدّدة.
بعد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل.
حتى ITestDevice#disconnectFromWifi()
أو
ITestDevice#clearLastConnectedWifiNetwork()
يَحْمِلُ الِاسْمْ.
المعلمات | |
---|---|
wifiSsid |
String : معرِّف شبكة Wi-Fi للاتصال به |
wifiPsk |
String : عبارة مرور PSK أو قيمة فارغة إذا لم يتم تشفيرها |
scanSsid |
boolean : ما إذا كان سيتم البحث عن SSID مخفي لهذه الشبكة. |
المرتجعات | |
---|---|
boolean |
true في حال الاتصال بشبكة Wi-Fi بنجاح. false
أو |
الرميات | |
---|---|
DeviceNotAvailableException |
الاتصال بشبكة Wi-FiNetworkIfبحاج
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
إصدار بديل من connectToWifiNetwork(String, String)
لا يمكن الاتصال به إلا عند استخدام الجهاز
لا تتوفّر بها حاليًا إمكانية الاتصال بالشبكة.
المعلمات | |
---|---|
scanSsid |
boolean : ما إذا كان سيتم البحث عن SSID مخفي لهذه الشبكة |
المرتجعات | |
---|---|
boolean |
true في حال الاتصال بشبكة Wi-Fi بنجاح. false
أو |
الرميات | |
---|---|
DeviceNotAvailableException |
الاتصال بشبكة Wi-FiNetworkIfبحاج
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
إصدار بديل من connectToWifiNetwork(String, String)
لا يمكن الاتصال به إلا عند استخدام الجهاز
لا تتوفّر بها حاليًا إمكانية الاتصال بالشبكة.
المرتجعات | |
---|---|
boolean |
true في حال الاتصال بشبكة Wi-Fi بنجاح. false
أو |
الرميات | |
---|---|
DeviceNotAvailableException |
إنشاء مستخدم
public int createUser (String name, boolean guest, boolean ephemeral)
إنشاء مستخدم باسم معين والعلامات المتوفرة
المعلمات | |
---|---|
name |
String : للمستخدم المطلوب إنشاؤه على الجهاز |
guest |
boolean : تفعيل ميزة إبلاغ المستخدم عن الحدث --الضيف أثناء الإنشاء |
ephemeral |
boolean : تفعيل علامة المستخدم -- المؤقتة أثناء الإنشاء |
المرتجعات | |
---|---|
int |
رقم تعريف المستخدم الذي تم إنشاؤه |
الرميات | |
---|---|
DeviceNotAvailableException |
إنشاء مستخدم
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
إنشاء مستخدم باسم معين والعلامات المتوفرة
المعلمات | |
---|---|
name |
String : للمستخدم المطلوب إنشاؤه على الجهاز |
guest |
boolean : تفعيل ميزة إبلاغ المستخدم عن الحدث --الضيف أثناء الإنشاء |
ephemeral |
boolean : تفعيل علامة المستخدم -- المؤقتة أثناء الإنشاء |
forTesting |
boolean : تفعيل علامة الاختبار --للاختبار أثناء الإنشاء |
المرتجعات | |
---|---|
int |
رقم تعريف المستخدم الذي تم إنشاؤه |
الرميات | |
---|---|
DeviceNotAvailableException |
إنشاء مستخدم
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, int userId)
طريقة مساعِدة لحذف ملف أو دليل على الجهاز
المعلمات | |
---|---|
deviceFilePath |
String : المسار المطلق للملف على الجهاز |
userId |
int : رقم تعريف المستخدم المطلوب الحذف منه |
الرميات | |
---|---|
DeviceNotAvailableException |
حذف الملف
public void deleteFile (String deviceFilePath)
طريقة مساعِدة لحذف ملف أو دليل على الجهاز
المعلمات | |
---|---|
deviceFilePath |
String : المسار المطلق للملف على الجهاز |
الرميات | |
---|---|
DeviceNotAvailableException |
deregisterDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
يؤدي هذا الإجراء إلى إزالة IDeviceActionReceiver
المسجَّل.
المعلمات | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : عنصر IDeviceActionReceiver ستتم إزالته. |
تمت إعادة تشغيل جهاز DeviceSoftLinux.
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكلٍ مبدئي من خلال مقارنة النظام الحالي مع system_server
خادم System_server السابق هو ProcessInfo
. استخدِم getProcessByName(String)
للحصول على ProcessInfo
.
المعلمات | |
---|---|
prevSystemServerProcess |
ProcessInfo : عملية System_server السابقة ProcessInfo . |
المرتجعات | |
---|---|
boolean |
true في حال إعادة تشغيل الجهاز بشكل مبدئي |
الرميات | |
---|---|
DeviceNotAvailableException |
تم إعادة تشغيل جهاز DeviceSoftاعتبارًا من
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكلٍ مبدئي منذ التوقيت العالمي المنسَّق منذ بدء حساب الفترة
الجهاز وERROR(/TimeUnit)
. تشير "إعادة التشغيل اللينة" إلى أن "system_server" تمت إعادة تشغيله خارج
إعادة التشغيل الثابت للجهاز (على سبيل المثال: طلب إعادة التشغيل). utcEpochTime للجهاز الحالي
يمكن الحصول على Milliseccond باستخدام الطريقة getDeviceDate()
.
المعلمات | |
---|---|
utcEpochTime |
long : وقت الجهاز بالثواني منذ تاريخ بدء حساب الفترة |
timeUnit |
TimeUnit : الوحدة الزمنية TimeUnit لوقت utcEpochTime المحدّد |
المرتجعات | |
---|---|
boolean |
true في حال إعادة تشغيل الجهاز بشكل مبدئي |
الرميات | |
---|---|
DeviceNotAvailableException |
إيقاف AdbRoot
public boolean disableAdbRoot ()
يؤدي هذا الإجراء إلى إيقاف جذر الإعلان.
قد يؤدي إيقاف جذر adb إلى إلغاء ربط الجهاز بـ adb. ستحظر هذه الطريقة حتى جهاز المستخدم.
المرتجعات | |
---|---|
boolean |
true إذا كانت ناجحة. |
الرميات | |
---|---|
DeviceNotAvailableException |
إيقاف قفل المفاتيح
public void disableKeyguard ()
محاولات لإيقاف حارس المفاتيح.
انتظر أولاً حتى يصبح إرسال الإدخال جاهزًا، يحدث ذلك في الوقت نفسه تقريبًا عندما BOOT_COMPLETE، على ما يبدو بشكل غير متزامن، لأن إطار العمل الحالي والتنفيذ له شرط سباق عرضي. ثم يتم إرسال الأمر لإغلاق حارس المفاتيح (يعمل على الأجهزة غير الآمنة فقط)
الرميات | |
---|---|
DeviceNotAvailableException |
إيقاف NetworkMonitor
public boolean disableNetworkMonitor ()
لإيقاف مراقبة الشبكة على الجهاز.
المرتجعات | |
---|---|
boolean |
true في حال إيقاف التتبُّع بنجاح. false
إذا فشلت. |
الرميات | |
---|---|
DeviceNotAvailableException |
قطع الاتصال بشبكة Wi-Fi
public boolean disconnectFromWifi ()
انقطاع الاتصال بشبكة Wi-Fi
إزالة جميع الشبكات من قائمة الشبكات المعروفة وإيقاف Wi-Fi
المرتجعات | |
---|---|
boolean |
true إذا تم قطع الاتصال بشبكة Wi-Fi بنجاح. false
إذا فشل قطع الاتصال. |
الرميات | |
---|---|
DeviceNotAvailableException |
ويفعل الملف
public boolean doesFileExist (String deviceFilePath, int userId)
طريقة مساعِدة لتحديد ما إذا كان هناك ملف على الجهاز لمستخدم معيّن
المعلمات | |
---|---|
deviceFilePath |
String : المسار المطلق للملف على الجهاز المطلوب التحقّق منه |
userId |
int : رقم تعريف المستخدم المطلوب التحقّق من توفُّر الملف وفقًا له |
المرتجعات | |
---|---|
boolean |
true في حال توفّر الملف، وfalse في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
ويفعل الملف
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 |
EnableAdbRoot
public boolean enableAdbRoot ()
يفعِّل جذر الإعلان. إذا كانت سياسة "enable-root" هو "خطأ"، فسيتم تسجيل رسالة بدون تفعيل الجذر.
قد يؤدي تفعيل جذر adb إلى فصل الجهاز عن Adb. ستحظر هذه الطريقة حتى جهاز المستخدم.
المرتجعات | |
---|---|
boolean |
true إذا كانت ناجحة. |
الرميات | |
---|---|
DeviceNotAvailableException |
EnableNetworkMonitor
public boolean enableNetworkMonitor ()
لتفعيل مراقبة الشبكة على الجهاز.
المرتجعات | |
---|---|
boolean |
true في حال تفعيل التتبُّع بنجاح. false
إذا فشلت. |
الرميات | |
---|---|
DeviceNotAvailableException |
تنفيذ AdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
طريقة مساعد تنفِّذ أمر adb كأمر نظام مع انتهاء مهلة محددة.
يجب استخدام executeShellCommand(String)
بدلاً من ذلك حيثما أمكن، لأنّها
للكشف عن العطل وأدائه بشكل أفضل.
المعلمات | |
---|---|
timeout |
long : الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، و0 لتر
بدون مهلة |
cmdArgs |
String : أمر adb ووسيطاته المطلوب تشغيلهما |
المرتجعات | |
---|---|
String |
الأمر stdout from. null في حال تعذُّر تنفيذ الأمر. |
الرميات | |
---|---|
DeviceNotAvailableException |
تنفيذ AdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
طريقة مساعد تنفِّذ أمر adb كأمر نظام مع انتهاء مهلة محددة.
يجب استخدام executeShellCommand(String)
بدلاً من ذلك حيثما أمكن، لأنّها
للكشف عن العطل وأدائه بشكل أفضل.
المعلمات | |
---|---|
timeout |
long : الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، و0 لتر
بدون مهلة |
envMap |
: البيئة المطلوب إعدادها للأمر |
cmdArgs |
String : أمر adb ووسيطاته المطلوب تشغيلهما |
المرتجعات | |
---|---|
String |
الأمر stdout from. null في حال تعذُّر تنفيذ الأمر. |
الرميات | |
---|---|
DeviceNotAvailableException |
تنفيذ AdbCommand
public String executeAdbCommand (String... cmdArgs)
طريقة مساعِد تنفِّذ أمر adb كأمر نظام
يجب استخدام executeShellCommand(String)
بدلاً من ذلك حيثما أمكن، لأنّها
للكشف عن العطل وأدائه بشكل أفضل.
المعلمات | |
---|---|
cmdArgs |
String : أمر adb ووسيطاته المطلوب تشغيلهما |
المرتجعات | |
---|---|
String |
الأمر stdout from. null في حال تعذُّر تنفيذ الأمر. |
الرميات | |
---|---|
DeviceNotAvailableException |
تنفيذ FastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
الطريقة المساعِدة التي تنفّذ أمر Fastboot كأمر نظام مع انتهاء مهلة افتراضية دقيقتان.
من المتوقَّع أن يتم استخدامه عندما يكون الجهاز في وضع Fastboot (Fastboot mode).
المعلمات | |
---|---|
cmdArgs |
String : أمر Fastboot ووسيطاته المطلوب تشغيلها |
المرتجعات | |
---|---|
CommandResult |
نتيجة CommandResult التي تحتوي على ناتج الأمر |
الرميات | |
---|---|
DeviceNotAvailableException |
تنفيذ FastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
الطريقة المساعِدة التي تنفِّذ أمر Fastboot كأمر نظام
من المتوقَّع أن يتم استخدامه عندما يكون الجهاز في وضع Fastboot (Fastboot mode).
المعلمات | |
---|---|
timeout |
long : الوقت بالمللي ثانية قبل انتهاء صلاحية الأمر |
cmdArgs |
String : أمر Fastboot ووسيطاته المطلوب تشغيلها |
المرتجعات | |
---|---|
CommandResult |
نتيجة CommandResult التي تحتوي على ناتج الأمر |
الرميات | |
---|---|
DeviceNotAvailableException |
التنفيذ الطويلالسريع التمهيد للأمر
public CommandResult executeLongFastbootCommand (String... cmdArgs)
الطريقة المساعِدة التي تنفّذ أمر Fastboot طويل المدى كأمر نظام
مماثلة لـ executeFastbootCommand(String)
باستثناء استخدام مهلة أطول.
المعلمات | |
---|---|
cmdArgs |
String : أمر Fastboot ووسيطاته المطلوب تشغيلها |
المرتجعات | |
---|---|
CommandResult |
نتيجة CommandResult التي تحتوي على ناتج الأمر |
الرميات | |
---|---|
DeviceNotAvailableException |
التنفيذ الطويلالسريع التمهيد للأمر
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
الطريقة المساعِدة التي تنفّذ أمر Fastboot طويل المدى كأمر نظام باستخدام النظام والمتغيرات البيئية.
مماثلة لـ executeFastbootCommand(String)
باستثناء استخدام مهلة أطول.
المعلمات | |
---|---|
envVarMap |
: متغيرات بيئة النظام التي يتم استخدامها في أمر Fastboot (Fastboot) |
cmdArgs |
String : أمر Fastboot ووسيطاته المطلوب تشغيلها |
المرتجعات | |
---|---|
CommandResult |
نتيجة CommandResult التي تحتوي على ناتج الأمر |
الرميات | |
---|---|
DeviceNotAvailableException |
تنفيذ ShellCommand
public String executeShellCommand (String command)
الطريقة المساعدة التي تنفّذ أمر adb Shell وتعرض المخرجات في صورة String
المعلمات | |
---|---|
command |
String : أمر adb Shell الذي سيتم تشغيله |
المرتجعات | |
---|---|
String |
إخراج واجهة المستخدم |
الرميات | |
---|---|
DeviceNotAvailableException |
تنفيذ ShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
ينفِّذ أمر adb Shell مع مزيد من المعلمات للتحكم في سلوك الأوامر.
المعلمات | |
---|---|
command |
String : أمر adb Shell الذي سيتم تشغيله |
receiver |
IShellOutputReceiver : السمة IShellOutputReceiver المطلوب توجيه ناتج واجهة المستخدم إليها. |
maxTimeToOutputShellResponse |
long : الحد الأقصى لوقت تشغيل الأمر
يُسمح له بعدم إخراج أي رد الوحدة كما هو محدد في timeUnit |
timeUnit |
TimeUnit : وحدة لـ maxTimeToOutputShellResponse |
retryAttempts |
int : الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب
. سيتم طرح DeviceNotResponseException إذا كانت retryAttempts.
يتم تنفيذها دون نجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
تنفيذ ShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
ينفِّذ أمر adb Shell مع مزيد من المعلمات للتحكم في سلوك الأوامر.
المعلمات | |
---|---|
command |
String : أمر adb Shell الذي سيتم تشغيله |
receiver |
IShellOutputReceiver : السمة IShellOutputReceiver المطلوب توجيه ناتج واجهة المستخدم إليها. |
maxTimeoutForCommand |
long : الحد الأقصى لمهلة اكتمال الأمر، وحدة كـ
محدد في timeUnit |
maxTimeToOutputShellResponse |
long : الحد الأقصى لوقت تشغيل الأمر
يُسمح له بعدم إخراج أي رد الوحدة كما هو محدد في timeUnit |
timeUnit |
TimeUnit : وحدة لـ maxTimeToOutputShellResponse |
retryAttempts |
int : الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب
. سيتم طرح DeviceNotAnswerException إذا كانت retryAttempts
أداء المشروع بدون نجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
تنفيذ ShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
لتنفيذ الأمر adb Shell، إعادة المحاولة عدة مرات إذا تعذّر الأمر.
شكل أبسط من
executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
باستخدام
القيم الافتراضية.
المعلمات | |
---|---|
command |
String : أمر adb Shell الذي سيتم تشغيله |
receiver |
IShellOutputReceiver : السمة IShellOutputReceiver المطلوب توجيه ناتج واجهة المستخدم إليها. |
الرميات | |
---|---|
DeviceNotAvailableException |
أمر executeShellV2Command
public 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، أو حقل فارغ. |
المرتجعات | |
---|---|
CommandResult |
هذه النتيجة باللغة CommandResult . |
الرميات | |
---|---|
DeviceNotAvailableException |
أمر executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
الطريقة المساعدة التي تنفّذ أمر adb shell وتعرض النتائج كـ CommandResult
مع تعبئة مخرجات حالة الأمر وstdout وstderr
المعلمات | |
---|---|
cmd |
String : الأمر الذي يجب تشغيله |
pipeAsInput |
File : عنصر ERROR(/File) الذي سيتم توجيهه كإدخال في الأمر أو فارغًا |
المرتجعات | |
---|---|
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 : الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب
. سيتم طرح DeviceNotAnswerException إذا كانت 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) الذي سيتم توجيهه كإدخال في الأمر أو فارغًا |
pipeToOutput |
OutputStream : ERROR(/OutputStream) حيث ستتم إعادة توجيه إخراج std، أو حقل فارغ. |
maxTimeoutForCommand |
long : الحد الأقصى لمهلة اكتمال الأمر، وحدة كـ
محدد في timeUnit |
timeUnit |
TimeUnit : وحدة لـ maxTimeToOutputShellResponse |
retryAttempts |
int : الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب
. سيتم طرح DeviceNotAnswerException إذا كانت 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) الذي سيتم توجيهه كإدخال في الأمر أو فارغًا |
pipeToOutput |
OutputStream : ERROR(/OutputStream) حيث ستتم إعادة توجيه إخراج std، أو حقل فارغ. |
pipeToError |
OutputStream : ERROR(/OutputStream) حيث ستتم إعادة توجيه خطأ ثابت، أو يكون فارغًا. |
maxTimeoutForCommand |
long : الحد الأقصى لمهلة اكتمال الأمر، وحدة كـ
محدد في timeUnit |
timeUnit |
TimeUnit : وحدة لـ maxTimeToOutputShellResponse |
retryAttempts |
int : الحد الأقصى لعدد مرات إعادة محاولة تنفيذ الأمر في حال تعذُّر تنفيذه بسبب
. سيتم طرح DeviceNotAnswerException إذا كانت retryAttempts
أداء المشروع بدون نجاح. |
المرتجعات | |
---|---|
CommandResult |
الرميات | |
---|---|
DeviceNotAvailableException |
FastbootRemove Partition
public CommandResult fastbootWipePartition (String partition)
الطريقة المساعدة التي تحجب بيانات قسم في الجهاز
إذا كانت قيمة "getUseFastbootErase()
" هي true
، سيتم استخدام ميزة "محو البيانات في وضع Fastboot" لمحو البيانات.
القسم. ينبغي أن ينشئ الجهاز نظام ملفات في المرة التالية التي يتم فيها تشغيل الجهاز.
وبخلاف ذلك، يتم استخدام تنسيق Fastboot الذي سيؤدي إلى إنشاء نظام ملفات جديد على الجهاز.
من المتوقَّع أن يتم استخدامه عندما يكون الجهاز في وضع Fastboot (Fastboot mode).
المعلمات | |
---|---|
partition |
String : القسم المطلوب حجبه |
المرتجعات | |
---|---|
CommandResult |
نتيجة CommandResult التي تحتوي على ناتج الأمر |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على ActiveApexes
publicgetActiveApexes ()
استرجاع المعلومات حول ملفات APK التي تم تفعيلها على الجهاز
المرتجعات | |
---|---|
|
تم تفعيل ERROR(/Set) من إجمالي ApexInfo على الجهاز حاليًا. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على جميع الإعدادات
publicgetAllSettings (String namespace)
عرض أزواج قيم المفاتيح لمساحة الاسم المطلوبة
المعلمات | |
---|---|
namespace |
String : يجب أن يكون أحد ما يلي {"system", "secure", "global"} |
المرتجعات | |
---|---|
|
خريطة أزواج القيم الرئيسية. قيمة فارغة إذا لم تكن مساحة الاسم متاحة. |
الرميات | |
---|---|
DeviceNotAvailableException |
GetAllocationState
public DeviceAllocationState getAllocationState ()
عرض حالة التخصيص الحالية للجهاز
المرتجعات | |
---|---|
DeviceAllocationState |
getAndroidId
public String getAndroidId (int userId)
ابحث عن معرّف android المرتبط بمعرّف المستخدم، واعرضه فارغًا في حال عدم العثور عليه.
المعلمات | |
---|---|
userId |
int |
المرتجعات | |
---|---|
String |
الرميات | |
---|---|
DeviceNotAvailableException |
getAndroidId
publicgetAndroidIds ()
إنشاء خريطة لأرقام تعريف Android التي تم العثور على أرقام تعريف المستخدمين المطابقة لها. لا يوجد تأمين على كل مستخدم على معرّف android مرتبط بهذه الدالة، لذا قد تتطابق بعض معرّفات المستخدمين مع قيمة null.
المرتجعات | |
---|---|
|
تم العثور على خريطة لأرقام تعريف Android مطابقة لأرقام تعريف المستخدمين. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على مستوى أعلى
public int getApiLevel ()
الحصول على مستوى واجهة برمجة التطبيقات للجهاز وتكون القيمة التلقائية هي UNKNOWN_API_LEVEL
.
المرتجعات | |
---|---|
int |
عدد صحيح يشير إلى مستوى واجهة برمجة التطبيقات للجهاز |
الرميات | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
استرجاع معلومات حول حزمة مثبَّتة على الجهاز
المعلمات | |
---|---|
packageName |
String |
المرتجعات | |
---|---|
PackageInfo |
PackageInfo أو null إذا تعذّر استرداد المعلومات |
الرميات | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos (الحصول على AppPackageInfos)
publicgetAppPackageInfos ()
استرجاع معلومات الحزم المثبّتة على الجهاز
المرتجعات | |
---|---|
|
تم تثبيت ERROR(/List) من أصل PackageInfo على الجهاز. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على الإصدار الأساسي للنطاق
public String getBasebandVersion ()
طريقة سهلة للحصول على إصدار النطاق الأساسي (الراديو) من هذا الجهاز الحصول على إصدار الراديو
يكون خاصًا بالجهاز، لذا قد لا يتم عرض المعلومات الصحيحة لجميع الأجهزة. هذا النمط
على الحالة الخاصة بـ gsm.version.base Band لعرض معلومات الإصدار الصحيحة.
وهذا ليس دقيقًا لبعض أجهزة CDMA وقد لا يتطابق الإصدار المعروض هنا.
الإصدار الذي تم الإبلاغ عنه من Fastboot وقد لا يعرض إصدار الراديو CDMA.
نصّ مختصر (TL;DR) لا تُبلغ هذه الطريقة عن الإصدار الدقيق إلا إذا كانت الخاصية gsm.version.base Band
هو نفسه الإصدار الذي عرضه fastboot getvar version-baseband
.
المرتجعات | |
---|---|
String |
إصدار النطاق الأساسي String أو null إذا تعذّر تحديده
(لا يمكن قراءة سلسلة الراديو أو الإصدار) |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على البطارية
public Integer getBattery ()
لعرض مستوى البطارية الحالي لجهاز، أو القيمة "Null" (فارغ) إذا كان مستوى البطارية غير متاح.
المرتجعات | |
---|---|
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 ()
تجمع الطريقة المساعِدة خريطة سجلّ التشغيل مع وقت التشغيل وسببه.
المرتجعات | |
---|---|
|
خريطة وقت التشغيل (التوقيت العالمي المنسق (UTC) بالثانية منذ البداية) وسبب التشغيل |
الرميات | |
---|---|
DeviceNotAvailableException |
cannot translate
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
تجمع الطريقة المساعِدة خريطة سجلّ التشغيل مع وقت التشغيل وسبب التشغيل بدءًا من
الوقت منذ تاريخ الجهاز والوحدة الزمنية المحدّدة. utcEpochTime للجهاز الحالي
يمكن الحصول على المللي ثانية باستخدام الطريقة getDeviceDate()
.
المعلمات | |
---|---|
utcEpochTime |
long : وقت الجهاز منذ تاريخ بدء حساب الفترة |
timeUnit |
TimeUnit : الوحدة الزمنية TimeUnit |
المرتجعات | |
---|---|
|
خريطة وقت التشغيل (التوقيت العالمي المنسق (UTC) بالثانية منذ البداية) وسبب التشغيل |
الرميات | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
تتوفّر طريقة ملائمة للحصول على إصدار برنامج الإقلاع لهذا الجهاز.
سنحاول استرداد إصدار برنامج الإقلاع من الحالة الحالية للجهاز. (أي إذا كان الجهاز في وضع Fastboot (Fastboot mode)، ستحاول استرداد الإصدار من Fastboot).
المرتجعات | |
---|---|
String |
إصدار برنامج إقلاع String أو null إذا تعذّر العثور عليه |
الرميات | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
لاسترداد تقرير أخطاء من الجهاز.
يضمن تنفيذ هذا الإجراء استمرار العمل على جهاز بدون بطاقة SD (أو حيث لم يتم تثبيت بطاقة SD بعد)
المرتجعات | |
---|---|
InputStreamSource |
InputStreamSource الذي سيُنشئ محتوى تقرير الأخطاء عند الطلب ضِمن
حالة الإخفاق، سينتج عن InputStreamSource قيمة ERROR(/InputStream) فارغة. |
getBugreportz
public InputStreamSource getBugreportz ()
لاسترداد تقرير الأخطاء من الجهاز. يحتوي تقرير أخطاء تنسيق Zip على تقرير الأخطاء الرئيسي ملفات السجل الأخرى المفيدة لتصحيح الأخطاء.
غير متوافق إلا مع "إصدار adb" > 1.0.36
المرتجعات | |
---|---|
InputStreamSource |
InputStreamSource من ملف ZIP الذي يحتوي على Bugreportz، عليك إرجاع القيمة null (فارغ) في
حالة الفشل. |
الحصول على عنوان البريد الإلكتروني البديل
public String getBuildAlias ()
استرداد الاسم المستعار للإصدار الذي يعمل عليه الجهاز حاليًا.
عادةً ما يكون الاسم المستعار للإصدار سلسلة أكثر قابلية للقراءة من معرّف الإصدار (يكون عادةً رقمًا إصدارات Nexus). على سبيل المثال، يتضمن الإصدار الأخير من Android 4.2 اسمًا مستعارًا JDQ39 ومعرّف الإصدار 573038
المرتجعات | |
---|---|
String |
الاسم المستعار للإصدار أو الرجوع إلى معرّف الإصدار إذا تعذر استرداده |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على BuildFLAor
public String getBuildFlavor ()
استرداد سمة التصميم للجهاز
المرتجعات | |
---|---|
String |
نكهة التصميم أو قيمة خالية إذا تعذر استردادها |
الرميات | |
---|---|
DeviceNotAvailableException |
معرّف getBuildId
public String getBuildId ()
يمكنك استرداد الإصدار الذي يعمل به الجهاز حاليًا.
المرتجعات | |
---|---|
String |
رقم تعريف الإصدار أو IBuildInfo#UNKNOWN_BUILD_ID إذا تعذّر استرداده |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على عناصر توقيع المفاتيح
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 |
الحصول على الاتصال
public AbstractConnection getConnection ()
الاتصال الحالي المرتبط بالجهاز
المرتجعات | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
تعرض القيمة ContentProviderHandler
أو قيمة خالية إذا لم تكن متاحة.
ويمكن إعادة استخدام موفّر المحتوى إذا تم إنشاؤه من قبل باستخدام userId
نفسه.
المعلمات | |
---|---|
userId |
int : رقم تعريف المستخدم المطلوب إعداد موفّر المحتوى له |
المرتجعات | |
---|---|
ContentProviderHandler |
الرميات | |
---|---|
DeviceNotAvailableException |
الحالة getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
تعرض الحالة الحالية القابلة للطيّ للجهاز أو القيمة فارغة في حال حدوث بعض المشاكل.
المرتجعات | |
---|---|
DeviceFoldableState |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على المستخدم الحالي
public int getCurrentUser ()
عرض معرّف المستخدم الحالي قيد التشغيل. في حالة حدوث خطأ، قم بإرجاع -10000.
المرتجعات | |
---|---|
int |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على فئة الجهاز
public String getDeviceClass ()
الحصول على فئة الجهاز.
المرتجعات | |
---|---|
String |
فئة الجهاز String . |
الحصول على بيانات الجهاز
public long getDeviceDate ()
عرض تاريخ الجهاز بالمللي ثانية منذ تاريخ بدء حساب الفترة
المرتجعات | |
---|---|
long |
تاريخ الجهاز بتنسيق الحقبة. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على أداة وصف الجهاز
public DeviceDescriptor getDeviceDescriptor ()
إرجاع DeviceDescriptor
من معلومات الجهاز للحصول على معلومات حوله بدون
وتمرير كائن الجهاز الفعلي.
المرتجعات | |
---|---|
DeviceDescriptor |
الحصول على أداة وصف الجهاز
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
إرجاع DeviceDescriptor
من معلومات الجهاز للحصول على معلومات حوله بدون
وتمرير كائن الجهاز الفعلي.
المعلمات | |
---|---|
shortDescriptor |
boolean : تحديد ما إذا كان الواصف يقتصر على الحد الأدنى من المعلومات أم لا |
المرتجعات | |
---|---|
DeviceDescriptor |
الحصول على حالة الجهاز
public TestDeviceState getDeviceState ()
تعرَّف على حالة الجهاز.
المرتجعات | |
---|---|
TestDeviceState |
الحصول على DeviceTimeOffset
public long getDeviceTimeOffset (Date date)
المساعدة في معرفة فرق الوقت بين الجهاز وجهاز ERROR(/Date)
معيّن استخدام وقت الحقبة
داخليًا.
المعلمات | |
---|---|
date |
Date |
المرتجعات | |
---|---|
long |
الفرق بالملي ثانية |
الرميات | |
---|---|
DeviceNotAvailableException |
إخراج GetEmulator
public InputStreamSource getEmulatorOutput ()
احصل على مجموعات بث الألعاب الأساسية والمحاكية
المرتجعات | |
---|---|
InputStreamSource |
ناتج المحاكي |
عملية getEmulatorProcess
public Process getEmulatorProcess ()
اعرض Process
المقابلة لهذا المحاكي.
المرتجعات | |
---|---|
Process |
Process أو null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
السجلّ الذي يحتوي على جميع سجلّات executeShellCommand(String)
المرتجعات | |
---|---|
File |
الحصول على مساحة تخزين خارجية مجانية
public long getExternalStoreFreeSpace ()
طريقة مساعد لتحديد مقدار المساحة الخالية على وحدة التخزين الخارجية للجهاز.
المرتجعات | |
---|---|
long |
مقدار المساحة الخالية بالكيلوبايت |
الرميات | |
---|---|
DeviceNotAvailableException |
الطريقة getFastbootPath
public String getFastbootPath ()
لعرض مسار البرنامج الثنائي Fastboot المستخدَم.
لا يزال يشترط ضبط السمة isFastbootEnabled()
على "صحيح" لتفعيل دوال Fastboot (Fastboot).
المرتجعات | |
---|---|
String |
getFastbootProductType
public String getFastbootProductType ()
طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
يجب عدم استخدام هذه الطريقة إلا إذا كان الجهاز في وضع Fastboot (Fastboot). الخيار أكثر أمانًا
من طريقة getProductType()
العامة في هذه الحالة، لأن ITestDevice
إمكانية استرداد الجهاز في وضع Fastboot (Fastboot) إذا كان الجهاز في حالة غير صحيحة أو كان
لا يستجيب.
المرتجعات | |
---|---|
String |
اسم نوع المنتج String أو null إذا تعذّر تحديده |
الرميات | |
---|---|
DeviceNotAvailableException |
getFastbootProductVariant
public String getFastbootProductVariant ()
طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
يجب عدم استخدام هذه الطريقة إلا إذا كان الجهاز في وضع Fastboot (Fastboot). الخيار أكثر أمانًا
من طريقة getProductType()
العامة في هذه الحالة، لأن ITestDevice
إمكانية استرداد الجهاز في وضع Fastboot (Fastboot) إذا كان الجهاز في حالة غير صحيحة أو كان
لا يستجيب.
المرتجعات | |
---|---|
String |
اسم نوع المنتج String أو null إذا تعذّر تحديده |
الرميات | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
لعرض الرقم التسلسلي لوضع Fastboot (Fastboot mode).
المرتجعات | |
---|---|
String |
الطريقة getFastbootVariable
public String getFastbootVariable (String variableName)
يمكنك استرداد قيمة متغيّر Fastboot المحدّدة من الجهاز.
المعلمات | |
---|---|
variableName |
String : اسم المتغيّر |
المرتجعات | |
---|---|
String |
قيمة الخاصية أو null إذا لم تكن موجودة |
الرميات | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
تعرض سلسلة الإصدار البرنامج الثنائي Fastboot المستخدَم. أو خالية إذا حدث شيء ما خطأ.
المرتجعات | |
---|---|
String |
إدخال ملف
public IFileEntry getFileEntry (String path)
استرداد مرجع إلى ملف بعيد على الجهاز.
المعلمات | |
---|---|
path |
String : مسار الملف المطلوب استرداده يمكن أن يكون مسارًا أو مسارًا مطلقًا بالنسبة إلى '/'. (أي
كلاً من " /system" و"النظام" بناء الجملة مدعوم) |
المرتجعات | |
---|---|
IFileEntry |
IFileEntry أو null إذا لم يتمكن الملف في path المحدد
يمكن العثور عليه |
الرميات | |
---|---|
DeviceNotAvailableException |
إدخال ملف
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
مساعد غير رسمي للحصول على FileEntry
من مسار غير جذري حل المشكلة
نظام إدخال الملفات لإتاحته من أي مسار. (حتى لو لم يكن جذرًا).
المعلمات | |
---|---|
entry |
FileListingService.FileEntry : ليس بالضرورة أن يكون جذر FileEntry كما يتطلبه Ddmlib. |
المرتجعات | |
---|---|
IFileEntry |
ملف FileEntryWrapper الذي يمثل إدخال الملف. |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
الحالات القابلة للطي
publicgetFoldableStates ()
تعرض قائمة الحالات القابلة للطي على الجهاز. يمكن الحصول عليه باستخدام "cmd device_state" print-states".
المرتجعات | |
---|---|
|
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على IDevice
public IDevice getIDevice ()
تعرض مرجعًا إلى ملف ddmlib IDevice
المرتبط.
قد يتم تخصيص IDevice
جديد من قِبل DDMS في كل مرة ينقطع فيها اتصال الجهاز
يعيد الربط من adb. وبالتالي لا يجب أن يحتفظ المتصلون بإشارة إلى IDevice
،
لأن هذا المرجع قد يصبح قديمًا.
المرتجعات | |
---|---|
IDevice |
IDevice |
أسماء الحِزم المُثبّتة
publicgetInstalledPackageNames ()
استرجِع أسماء حِزم التطبيقات المتوفّرة على الجهاز.
المرتجعات | |
---|---|
|
ERROR(/Set) من String اسم حزمة مثبَّتة حاليًا على الجهاز. |
الرميات | |
---|---|
DeviceNotAvailableException |
موقع getIntProperty
public long getIntProperty (String name, long defaultValue)
تعرض قيمة العدد الصحيح للسمة المحددة من الجهاز.
المعلمات | |
---|---|
name |
String : اسم الموقع |
defaultValue |
long : القيمة التلقائية التي يتم عرضها إذا كانت السمة فارغة أو غير موجودة. |
المرتجعات | |
---|---|
long |
قيمة السمة أو defaultValue إذا كانت السمة فارغة أو غير متوفّرة
أو لا يحتوي على عدد صحيح. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على عنوان IP
public String getIpAddress ()
الحصول على عنوان IP للجهاز.
المرتجعات | |
---|---|
String |
عنوان IP للجهاز، أو null إذا لم يكن للجهاز عنوان IP. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على KeyguardState
public KeyguardControllerState getKeyguardState ()
يمكنك إرجاع كائن للحصول على الحالة الحالية لقفل المفاتيح أو القيمة "فارغ" إذا لم يكن الأمر كذلك.
المرتجعات | |
---|---|
KeyguardControllerState |
جهاز KeyguardControllerState يحتوي على نبذة عن حالة قفل المفاتيح
وتعرض "Null" (فارغ) إذا كان استعلام لوحة المفاتيح غير مدعوم. |
الرميات | |
---|---|
DeviceNotAvailableException |
getLastExpectedResetTimeMillis
public long getLastExpectedRebootTimeMillis ()
عرض آخر مرة شغّلت فيها واجهات برمجة التطبيقات Tradefed إعادة التشغيل بالمللي ثانية منذ EPOCH بالشكل
تم إرجاعه بواسطة System.currentTimeMillis()
.
المرتجعات | |
---|---|
long |
الحصول على واجهة برمجة التطبيقات getLaunchApiLevel
public int getLaunchApiLevel ()
يمكنك الحصول على مستوى واجهة برمجة التطبيقات الذي تم إطلاقه في الجهاز للمرة الأولى. وتكون القيمة التلقائية هي UNKNOWN_API_LEVEL
.
المرتجعات | |
---|---|
int |
عدد صحيح يشير إلى أول مستوى واجهة برمجة تطبيقات تم إطلاقه في الجهاز |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على
public InputStreamSource getLogcat ()
الحصول على بث موجز لبيانات Logcat
تعمل هذه الميزة في وضعَين:
TestDeviceOptions.getMaxLogcatDataSize()
بايت من المحتوى الحالي للخلفية.
تسجيل أداة Logcat
المرتجعات | |
---|---|
InputStreamSource |
الحصول على
public InputStreamSource getLogcat (int maxBytes)
يتيح هذا الإعداد الحصول على لقطة شاشة من آخر maxBytes
من بيانات Logcat التي تم التقاطها.
يكون هذا الخيار مفيدًا في الحالات التي تريد فيها الحصول على لقطات متكرّرة لبيانات Logcat التي تم التقاطها.
بدون تحمُّل مسؤولية مساحة القرص الكبيرة التي قد تنتج عن الحصول على لقطة getLogcat()
بالكامل.
المعلمات | |
---|---|
maxBytes |
int : الحد الأقصى لمقدار البيانات المطلوب عرضها. ينبغي أن يكون مبلغًا يمكن
مناسبة للذاكرة بشكل مريح |
المرتجعات | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
يمكنك الحصول على ملف تفريغ لسجلّ Logcat الحالي الخاص بالجهاز. على عكس getLogcat()
، ستعرض هذه الطريقة ما يلي:
دائمًا بإرجاع تفريغ ثابت لـ Logcat.
لديه عيب أنّه لن يتم إرجاع أي شيء إذا تعذّر الوصول إلى الجهاز.
المرتجعات | |
---|---|
InputStreamSource |
InputStreamSource لبيانات Logcat. يتم عرض بث فارغ في حال تعذّر تشغيله
لتسجيل بيانات Logcat. |
الحصول على خلفية
public InputStreamSource getLogcatSince (long date)
يتيح هذا الإجراء الحصول على لقطة من بيانات Logcat التي تم التقاطها اعتبارًا من التاريخ المحدَّد. الوقت في
يجب استخدام الجهاز getDeviceDate()
.
المعلمات | |
---|---|
date |
long : بالمللي ثانية منذ وقت بدء اللقطة حتى الآن
(يمكن الحصول عليه باستخدام 'تاريخ +%s') |
المرتجعات | |
---|---|
InputStreamSource |
الحصول على MacAddress
public String getMacAddress ()
يعرض عنوان MAC للجهاز، فارغًا في حال تعذّر طلب البحث من الجهاز.
المرتجعات | |
---|---|
String |
الحصول على معرّف المستخدم الرئيسي
public Integer getMainUserId ()
تعرض رقم تعريف المستخدم الرئيسي.
المرتجعات | |
---|---|
Integer |
userId للمستخدم الرئيسي إن وجد، وقيمة فارغة إذا لم يكن هناك مستخدم رئيسي. |
الرميات | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
الحصول على معلومات حول الوحدات الرئيسية المثبتة على الجهاز
المرتجعات | |
---|---|
|
ERROR(/Set) من إجمالي String وحدة رئيسية مثبَّتة حاليًا على الجهاز. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على الحد الأقصى لعدد مستخدمي التطبيق المتوافق
public int getMaxNumberOfRunningUsersSupported ()
الحصول على الحد الأقصى لعدد الأجهزة المتوافقة التي تعمل بنظام التشغيل Android في آنٍ واحد وتكون القيم التلقائية 0.
المرتجعات | |
---|---|
int |
عدد صحيح يشير إلى عدد حسابات المستخدمين قيد التشغيل في آنٍ واحد |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على MaxNumberOfUsers مجددًا
public int getMaxNumberOfUsersSupported ()
الحصول على أقصى عدد من المستخدمين المعتمَدين وتكون القيم التلقائية 0.
المرتجعات | |
---|---|
int |
عدد صحيح يشير إلى عدد المستخدمين المعتمَدين |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على ماكروdroidProcess
public Process getMicrodroidProcess ()
المرتجعات | |
---|---|
Process |
لعرض عملية الجهاز الافتراضي Microdroid. إذا لم يكن TestDevice هو جهاز Microdroid، يتم إرجاعه خالية. |
getMonitor
public IDeviceStateMonitor getMonitor ()
إرجاع IDeviceStateMonitor
المرتبطة بالجهاز
المرتجعات | |
---|---|
IDeviceStateMonitor |
الحصول على ماونت بوينت
public String getMountPoint (String mountName)
تعرض نقطة تثبيت.
يتم إرسال طلبات البحث إلى الجهاز مباشرةً إذا كانت المعلومات المخزّنة مؤقتًا في "IDevice
" غير متاحة.
قائمة المهام: نقل هذا السلوك إلى IDevice#getMountPoint(String)
المعلمات | |
---|---|
mountName |
String : اسم نقطة التثبيت |
المرتجعات | |
---|---|
String |
نقطة التثبيت أو null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
عرض MountPointInfo
يتوافق مع مسار نقطة التثبيت المحدّد
null
إذا لم يتم تثبيت أي شيء على هذا المسار أو لا يظهر في أي
/proc/ثبت كنقطة تثبيت.
المعلمات | |
---|---|
mountpoint |
String |
المرتجعات | |
---|---|
ITestDevice.MountPointInfo |
ERROR(/List) من MountPointInfo تحتوي على المعلومات في " /proc/muns" |
الرميات | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
عرض نسخة محللة من المعلومات في الملف /proc/خاصية التثبيت على الجهاز
المرتجعات | |
---|---|
|
ERROR(/List) من MountPointInfo تحتوي على المعلومات في " /proc/muns" |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على خيارات
public TestDeviceOptions getOptions ()
جلب خيارات الاختبار للجهاز
المرتجعات | |
---|---|
TestDeviceOptions |
TestDeviceOptions مرتبط بالجهاز قيد الاختبار. |
الحصول على تجزئة FreeSpace
public long getPartitionFreeSpace (String partition)
طريقة مساعِدة لتحديد مقدار المساحة الخالية في قسم الجهاز
المعلمات | |
---|---|
partition |
String |
المرتجعات | |
---|---|
long |
مقدار المساحة الخالية بالكيلوبايت |
الرميات | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId
public Integer getPrimaryUserId ()
تعرض معرّف المستخدم الأساسي.
المرتجعات | |
---|---|
Integer |
userId للمستخدم الأساسي إذا كان موجودًا، وتكون فارغة إذا لم يكن هناك مستخدم أساسي. |
الرميات | |
---|---|
DeviceNotAvailableException |
GetProcessByName
public ProcessInfo getProcessByName (String processName)
تشغِّل الطريقة المساعدة "pidof". و"stat" وتُرجع الكائن ProcessInfo
باستخدام
معرّف PID ووقت بدء العملية للعملية المحددة
المعلمات | |
---|---|
processName |
String : اسم العملية "سلسلة". |
المرتجعات | |
---|---|
ProcessInfo |
ProcessInfo (معلومات العملية) المحددة |
الرميات | |
---|---|
DeviceNotAvailableException |
أمر getProcessPid
public String getProcessPid (String process)
تعرض pid للخدمة أو صفرًا إذا حدث خطأ ما.
المعلمات | |
---|---|
process |
String : اسم العملية "سلسلة" |
المرتجعات | |
---|---|
String |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على نوع المنتج
public String getProductType ()
طريقة سهلة للحصول على نوع المنتج لهذا الجهاز
ستُنجح هذه الطريقة إذا كان الجهاز في وضع adb أو Fastboot.
المرتجعات | |
---|---|
String |
اسم نوع المنتج String . لن تكون فارغة |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على منتج بديل
public String getProductVariant ()
طريقة سهلة للحصول على نوع المنتج من هذا الجهاز
ستُنجح هذه الطريقة إذا كان الجهاز في وضع adb أو Fastboot.
المرتجعات | |
---|---|
String |
اسم خيار المنتج "String " أو null إذا تعذّر ذلك
مُصمَّم |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على الخاصية
public String getProperty (String name)
استرِد قيمة السمة المحدّدة من الجهاز.
المعلمات | |
---|---|
name |
String : اسم الموقع |
المرتجعات | |
---|---|
String |
قيمة الخاصية أو null إذا لم تكن موجودة |
الرميات | |
---|---|
DeviceNotAvailableException |
استعادة وضع الاسترداد
public ITestDevice.RecoveryMode getRecoveryMode ()
يمكنك تفعيل وضع الاسترداد الحالي المستخدَم على الجهاز.
المرتجعات | |
---|---|
ITestDevice.RecoveryMode |
وضع الاسترداد الحالي المستخدَم للجهاز. |
الحصول على لقطة شاشة
public InputStreamSource getScreenshot (String format)
يحصل على لقطة شاشة من الجهاز. يُنصح باستخدام getلقطة الشاشة(التنسيق) بدلاً من ذلك بترميز JPEG للحجم الأصغر.
المعلمات | |
---|---|
format |
String : يمكن استخدام تنسيقات PNG وJPEG |
المرتجعات | |
---|---|
InputStreamSource |
InputStreamSource من لقطة الشاشة بالتنسيق، أو null إذا
لم تكن لقطة الشاشة ناجحة. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على لقطة شاشة
public InputStreamSource getScreenshot (long displayId)
يحصل على لقطة شاشة من الجهاز الذي تم تقديم رقم تعريف الشاشة فيه. التنسيق هو PNG.
قائمة المهام: توسيع عمليات التنفيذ أعلاه لدعم "التنسيق" و"إعادة القياس"
المعلمات | |
---|---|
displayId |
long : معرّف العرض للشاشة للحصول على لقطة شاشة منها |
المرتجعات | |
---|---|
InputStreamSource |
InputStreamSource للقطة الشاشة بالتنسيق، أو null إذا
لم يتم إرسال لقطة الشاشة بنجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على لقطة شاشة
public InputStreamSource getScreenshot (String format, boolean rescale)
يحصل على لقطة شاشة من الجهاز. يُنصح باستخدام getScreenshot(String)
بدلاً من ذلك
بترميز JPEG لأحجام أصغر.
المعلمات | |
---|---|
format |
String : يمكن استخدام تنسيقات PNG وJPEG |
rescale |
boolean : إذا كان يجب إعادة ضبط لقطة الشاشة لتقليل حجم الصورة الناتجة |
المرتجعات | |
---|---|
InputStreamSource |
InputStreamSource للقطة الشاشة بالتنسيق، أو null إذا
لم يتم إرسال لقطة الشاشة بنجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على لقطة شاشة
public InputStreamSource getScreenshot ()
يحصل على لقطة شاشة من الجهاز.
المرتجعات | |
---|---|
InputStreamSource |
InputStreamSource من لقطة الشاشة بتنسيق png أو null إذا
لم تكن لقطة الشاشة ناجحة. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على الرقم التسلسلي
public String getSerialNumber ()
طريقة سهلة للحصول على الرقم التسلسلي لهذا الجهاز.
المرتجعات | |
---|---|
String |
الرقم التسلسلي String |
الإعداد
public String getSetting (int userId, String namespace, String key)
عرض قيمة الإعداد المطلوب. يجب أن تكون مساحة الاسم واحدة مما يلي: {"system", "secure", "global"}
المعلمات | |
---|---|
userId |
int |
namespace |
String |
key |
String |
المرتجعات | |
---|---|
String |
القيمة المرتبطة بـ مساحة الاسم:مفتاح المستخدم. قيمة فارغة إذا لم يتم العثور عليها. |
الرميات | |
---|---|
DeviceNotAvailableException |
الإعداد
public String getSetting (String namespace, String key)
يمكنك الاطّلاع على getSetting(int, String, String)
وتنفيذها على مستخدم النظام.
المعلمات | |
---|---|
namespace |
String |
key |
String |
المرتجعات | |
---|---|
String |
الرميات | |
---|---|
DeviceNotAvailableException |
GetSimOperator
public String getSimOperator ()
يمكنك إرجاع مشغل شريحة SIM أو القيمة "فارغة" إذا لم يكن متاحًا أو إذا كان الجهاز غير متاح.
المرتجعات | |
---|---|
String |
GetSimState
public String getSimState ()
يمكنك إرجاع حالة شريحة SIM أو القيمة "فارغة" إذا لم يكن متاحًا أو إذا كان الجهاز غير متاح.
المرتجعات | |
---|---|
String |
الحصول على تومبستون
publicgetTombstones ()
يمكنك استرجاع قائمة ملفات Tombstones وإرجاعها من الأجهزة. يجب توفّر الجذر.
هي أفضل جهد، لذلك إذا فشل استخراج أحد شواهد القبور لأي سبب من الأسباب،
مفقود من القائمة. سيؤدي استخدام DeviceNotAvailableException
فقط إلى إنهاء الطريقة.
مبكرًا.
المرتجعات | |
---|---|
|
قائمة بملفات Tombstone، فارغة في حال عدم وجود ملف Tombstone. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على إجمالي الذاكرة
public long getTotalMemory ()
عرض إجمالي حجم الذاكرة الفعلية بالبايت أو -1 في حال حدوث خطأ داخلي
المرتجعات | |
---|---|
long |
الحصول علىتتبُّع الرقم التسلسلي
public String getTrackingSerial ()
لأغراض إدارة الجهاز، احصل على الرقم التسلسلي المستخدَم لتتبُّع الجهاز.
المرتجعات | |
---|---|
String |
الحصول على UninstallablePackageNames
publicgetUninstallablePackageNames ()
جلب أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. يتم تعريف ذلك حاليًا على أنه والحزم غير التابعة للنظام، وحزم النظام المُحدثة.
المرتجعات | |
---|---|
|
ERROR(/Set) من أسماء حزمة String القابلة للإزالة المثبّتة حاليًا على
الخاص بك. |
الرميات | |
---|---|
DeviceNotAvailableException |
الطريقة getUseFastboot تبيّن
public boolean getUseFastbootErase ()
تعرَّف على ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
المرتجعات | |
---|---|
boolean |
true في حال استخدام ميزة "محو بيانات Fastboot" أو false في حال تفعيل تنسيق Fastboot
تنبؤي. |
الحصول على علامات المستخدم
public int getUserFlags (int userId)
يمكنك العثور على علامات مستخدم معيّن وعرضها. يتم تحديد العلامات في "android.content.pm.UserInfo" الصف في مشروع مفتوح المصدر لنظام Android.
المعلمات | |
---|---|
userId |
int |
المرتجعات | |
---|---|
int |
العلامات المرتبطة بـ userId المقدم في حال العثور عليه، -10000 في أي حالات أخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على معلومات المستخدم
publicgetUserInfos ()
يحصل على خريطة UseId إلى UserInfo
على الجهاز. سيتم عرض DeviceRuntimeException
إذا لم يكن الناتج من الجهاز كما هو متوقع.
المرتجعات | |
---|---|
|
قائمة كائنات UserInfo. |
الرميات | |
---|---|
DeviceNotAvailableException |
الحصول على UserSerialNumber
public int getUserSerialNumber (int userId)
اعرض الرقم التسلسلي المرتبط برقم تعريف المستخدم (userId) إن تم العثور عليه، والذي يبلغ -10000 في أي حالات أخرى.
المعلمات | |
---|---|
userId |
int |
المرتجعات | |
---|---|
int |
الرميات | |
---|---|
DeviceNotAvailableException |
HandAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
معالجة DeviceEvent المحدد. قد ينقل الجهاز
إلى حالة جديدة. سيتم إعلام IDeviceMonitor
بأيّ عمليات انتقال في الولاية.
معالجة DeviceEvent، التي قد تؤدي أو لا تنقل هذا الجهاز إلى عملية تخصيص جديدة الولاية.
المعلمات | |
---|---|
event |
DeviceEvent |
المرتجعات | |
---|---|
IManagedTestDevice.DeviceEventResponse |
تحتوي على ميزة
public boolean hasFeature (String feature)
تحقَّق من توفُّر الميزة على الجهاز.
المعلمات | |
---|---|
feature |
String : التنسيق الذي يجب أن يكون "feature: |
المرتجعات | |
---|---|
boolean |
صحيح إذا تم العثور على الميزة، وخطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
installPackage
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 |
installPackage
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 : العدد الصحيح لرقم تعريف المستخدم المطلوب التثبيت له |
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 : العدد الصحيح لرقم تعريف المستخدم المطلوب التثبيت له |
extraArgs |
String : وسيطات إضافية اختيارية لتمريرها. الاطّلاع على "adb shell pm -h" للمتاح
الخيارات. |
المرتجعات | |
---|---|
String |
أو String مع رمز خطأ، أو null في حال النجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
غير صالح خاصية ذاكرة التخزين المؤقت
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
المرتجعات | |
---|---|
boolean |
متوافق مع عبارة isAppEnumeration
public boolean isAppEnumerationSupported ()
التحقّق مما إذا كان النظام الأساسي على الجهاز يتيح تعداد التطبيقات
المرتجعات | |
---|---|
boolean |
صحيح إذا كان تعداد التطبيق متاحًا، وخطأ في الحالات الأخرى |
الرميات | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlock متوافق
public boolean isBypassLowTargetSdkBlockSupported ()
التحقّق مما إذا كان النظام الأساسي على الجهاز يتيح تجاوز مجموعة حزم تطوير البرامج (SDK) المستهدَفة المنخفضة في عمليات تثبيت التطبيقات
المرتجعات | |
---|---|
boolean |
صحيح في حال توفُّر كتلة حزمة SDK منخفضة الهدف، وخطأ في الحالات الأخرى |
الرميات | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
تأكَّد من تثبيت برامج تصحيح الأخطاء.
المرتجعات | |
---|---|
boolean |
true في حال تثبيت برامج تصحيح الأخطاء |
الرميات | |
---|---|
DeviceNotAvailableException |
يكون الجهاز مشفّرًا
public boolean isDeviceEncrypted ()
يعرض هذا الخيار ما إذا كان الجهاز مشفرًا.
المرتجعات | |
---|---|
boolean |
true إذا كان الجهاز مشفرًا. |
الرميات | |
---|---|
DeviceNotAvailableException |
الدليل
public boolean isDirectory (String path)
يمكنك عرض "صحيح" إذا كان المسار على الجهاز دليلاً وخطأ في الحالات الأخرى.
المعلمات | |
---|---|
path |
String |
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
قيمة isEnableAdbRoot
public boolean isEnableAdbRoot ()
المرتجعات | |
---|---|
boolean |
true إذا كان يجب تفعيل جذر الإعلان على الجهاز |
متوافق مع isEncryption
public boolean isEncryptionSupported ()
يعرض هذا الخيار ما إذا كان التشفير متاحًا على الجهاز.
المرتجعات | |
---|---|
boolean |
true إذا كان الجهاز يتيح التشفير. |
الرميات | |
---|---|
DeviceNotAvailableException |
قابل للتنفيذ
public boolean isExecutable (String fullPath)
يعرض True إذا كان مسار الملف على الجهاز ملفًا تنفيذيًا، وخطأ في الحالات الأخرى.
المعلمات | |
---|---|
fullPath |
String |
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
سياسة isFastbootEnabled
public boolean isFastbootEnabled ()
يمكنك الرجوع في حال توفّر Fastboot للجهاز.
المرتجعات | |
---|---|
boolean |
بلا واجهة مستخدم رسومية
public boolean isHeadless ()
يتم عرض القيمة "صحيح" إذا كان الجهاز بلا واجهة مستخدم رسومية (بدون شاشة)، أو على "خطأ" في الحالات الأخرى.
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
isheadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
يعرض ما إذا كان الجهاز يستخدم وضع مستخدم نظام التشغيل بلا واجهة مستخدم رسومية.
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
عرض ما إذا كان المستخدم الرئيسي مشرفًا دائمًا ولا يمكن حذفه أو الرجوع إلى إصدار سابق حالة غير المشرف.
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
متوافق مع متعدد المستخدمين
public boolean isMultiUserSupported ()
يُحدِّد هذا الإعداد ما إذا كانت الميزة متاحة لمستخدمين متعددين.
المرتجعات | |
---|---|
boolean |
صحيح إذا كان تعدد المستخدمين مدعومًا، وخطأ في الحالات الأخرى |
الرميات | |
---|---|
DeviceNotAvailableException |
تم تثبيت الحزمة
public boolean isPackageInstalled (String packageName, String userId)
يمكن إرسال طلب بحث إلى الجهاز عن اسم حزمة معيّنة ورقم تعريف مستخدم محدّد مثبتة أم لا لهذا المستخدم.
المعلمات | |
---|---|
packageName |
String : الحزمة التي نتحقّق منها ما إذا كانت مثبّتة أم لا. |
userId |
String : رقم تعريف المستخدم الذي نتحقق من تثبيت الحزمة من أجله إذا كانت القيمة فارغة، يكون المستخدم الأساسي
صفر. |
المرتجعات | |
---|---|
boolean |
صحيح إذا تم الإبلاغ عن الحزمة كتثبيت. خطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
تم تثبيت الحزمة
public boolean isPackageInstalled (String packageName)
يمكنك إرسال طلب بحث إلى الجهاز عن اسم حزمة معيّن لمعرفة ما إذا كان مثبّتًا حاليًا أم لا.
المعلمات | |
---|---|
packageName |
String |
المرتجعات | |
---|---|
boolean |
صحيح إذا تم الإبلاغ عن الحزمة كتثبيت. خطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
isRuntimePermission متوافق
public boolean isRuntimePermissionSupported ()
التحقّق مما إذا كان النظام الأساسي على الجهاز يتيح منح إذن التشغيل
المرتجعات | |
---|---|
boolean |
صحيح إذا كان إذن التشغيل متاحًا، وخطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
تعرض القيمة "صحيح" إذا كان الجهاز في TestDeviceState#FASTBOOT
أو TestDeviceState.FASTBOOTD
.
المرتجعات | |
---|---|
boolean |
قيد التشغيل
public boolean isUserRunning (int userId)
تحقق مما إذا كان مستخدم معين قيد التشغيل.
المعلمات | |
---|---|
userId |
int |
المرتجعات | |
---|---|
boolean |
True إذا كان المستخدم قيد التشغيل، وfalse في كل الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
مستخدم ثانوي
public boolean isUserSecondary (int userId)
يعرض ما إذا كان المستخدم المحدّد مستخدمًا ثانويًا وفقًا لعلاماته.
المعلمات | |
---|---|
userId |
int |
المرتجعات | |
---|---|
boolean |
true إذا كان المستخدم ثانويًا، وعلى false في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
يكون Userمرئي
public boolean isUserVisible (int userId)
للتحقّق مما إذا كان المستخدم المحدّد مرئيًا
و"مرئي" هو مستخدم يتفاعل مع "الإنسان" المستخدم وبالتالي يكون قادرًا على أنشطة الإطلاق (عادةً في الشاشة الافتراضية).
المعلمات | |
---|---|
userId |
int |
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
isUserمرئيOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
يتحقّق مما إذا كان المستخدم المحدّد مرئيًا على الشاشة المحدّدة.
و"مرئي" هو مستخدم يتفاعل مع "الإنسان" المستخدم وبالتالي يكون قادرًا على أو إطلاق أنشطة الإطلاق في تلك الشاشة.
المعلمات | |
---|---|
userId |
int |
displayId |
int |
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
متاح
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
تعرض ما إذا كان الجهاز يسمح للمستخدمين بالبدء مرئيًا في الخلفية في ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
.
إذا كان الأمر كذلك، يمكنك الاتصال بـ startVisibleBackgroundUser(int, int, boolean)
، وتم تمريره
شاشة تم عرضها بواسطة listDisplayIdsForStartingVisibleBackgroundUsers()
(والتي
يجب أن تتضمن ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
).
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
متاح
public boolean isVisibleBackgroundUsersSupported ()
يعرض ما إذا كان الجهاز يسمح للمستخدمين بالبدء مرئيًا في الخلفية.
إذا كان الأمر كذلك، يمكنك الاتصال بـ startVisibleBackgroundUser(int, int, boolean)
، وتم تمريره
شاشة تم عرضها بواسطة listDisplayIdsForStartingVisibleBackgroundUsers()
.
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
مع تفعيل Wi-Fi
public boolean isWifiEnabled ()
اختبِر ما إذا تم تفعيل شبكة Wi-Fi.
للتحقّق من تفعيل شبكة Wi-Fi على الجهاز يفيد ذلك في تأكيد حالة شبكة Wi-Fi قبل إجراء الاختبارات التي يجب ألا يعمل باستخدام شبكة wifi، على سبيل المثال اختبارات بيانات الجوال.
المرتجعات | |
---|---|
boolean |
true إذا تم تفعيل Wi-Fi. false إذا تم إيقافها |
الرميات | |
---|---|
DeviceNotAvailableException |
أرقام تعريف قائمة العرض
publiclistDisplayIds ()
جمع قائمة أرقام تعريف الشاشات المتاحة على الجهاز كما تم الإبلاغ عنه بواسطة "dumpsys" SurfaceFlinger".
المرتجعات | |
---|---|
|
قائمة الشاشات يُرجع الإعداد التلقائي دائمًا قيمة العرض التلقائي 0. |
الرميات | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForOpenVisualUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
الحصول على قائمة الشاشات التي يمكن استخدامها من أجل start a user visible in the background
.
المرتجعات | |
---|---|
|
الرميات | |
---|---|
DeviceNotAvailableException |
قائمة المستخدمين
publiclistUsers ()
الحصول على قائمة المستخدمين على الجهاز سيتم عرض DeviceRuntimeException
في حال كان الناتج
من الجهاز ليس كما هو متوقع.
المرتجعات | |
---|---|
|
قائمة معرّفات المستخدمين. |
الرميات | |
---|---|
DeviceNotAvailableException |
لوغاريتمات
public boolean logAnrs (ITestLogger logger)
جمع أخطاء ANR وتسجيلها من الجهاز
المعلمات | |
---|---|
logger |
ITestLogger : ITestLogger لتسجيل أخطاء ANR. |
المرتجعات | |
---|---|
boolean |
صحيح إذا كان التسجيل ناجحًا، وخطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
LogBugreport
public boolean logBugreport (String dataName, ITestLogger listener)
طريقة مساعِدة لتدوين تقرير خطأ وتسجيله للمراسلين الصحفيين
المعلمات | |
---|---|
dataName |
String : الاسم الذي سيتم الإبلاغ بموجبه عن تقرير الأخطاء |
listener |
ITestLogger : ITestLogger لتسجيل تقرير الخطأ |
المرتجعات | |
---|---|
boolean |
صحيح إذا كان التسجيل ناجحًا، وخطأ في الحالات الأخرى. |
تسجيل على الجهاز
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
سجِّل رسالة في سجلّ الجهاز. هذه مكالمة آمنة لن يتم الرد عليها حتى لو فشل التسجيل.
المعلمات | |
---|---|
tag |
String : العلامة التي نسجّل بموجبها رسالتنا في Logcat. |
level |
Log.LogLevel : مستوى تصحيح أخطاء الرسالة في سجلّ Logcat |
format |
String : تنسيق الرسالة |
args |
Object : الوسيطات المراد استبدالها من خلال String.format(). |
إصلاح الأخطاء
public void mountDebugfs ()
حمّل برامج تصحيح الأخطاء.
الرميات | |
---|---|
DeviceNotAvailableException |
غير الحظر إعادة التشغيل
public void nonBlockingReboot ()
إصدار أمر بإعادة تشغيل الجهاز وعرض الأمر بعد اكتمال الأمر وعندما يكون الجهاز غير مفعَّل مرئية أطول لـ adb.
الرميات | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
يمكنك إلغاء هذا الإعداد إذا كان الجهاز بحاجة إلى اتخاذ بعض الإجراءات المحدّدة بعد جذر adb وقبل اتصال جهازك بالإنترنت مرة أخرى. لا تتضمّن عملية التنفيذ التلقائية أي إجراءات إضافة. لا يمكن ضمان تفعيل جذر adb في هذه المرحلة.
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
ما بعد AdbUnrootAction
public void postAdbUnrootAction ()
يمكنك تجاوز ما إذا كان الجهاز يحتاج إلى اتخاذ بعض الإجراءات المحددة بعد adb unroot وقبل اتصال الجهاز بالإنترنت مرة أخرى. لا تتضمّن عملية التنفيذ التلقائية أيّ إجراءات إضافية. لا نضمن إيقاف جذر adb في هذه المرحلة.
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
إعداد postBootSetup
public void postBootSetup ()
نفِّذ التعليمات لإعداد الجهاز لاختبار ذلك بعد كل تمهيد.
يجب طلب البيانات بعد تشغيل الجهاز بالكامل أو توفّره.
في الظروف العادية، لا يلزم استدعاء هذه الطريقة بشكل صريح، حيث وتنفيذ هذه الخطوات تلقائيًا عند إجراء إعادة تشغيل.
وقد يلزم استدعاؤها عند إعادة تشغيل الجهاز بسبب أحداث أخرى (على سبيل المثال، عند اكتمل أمر تحديث Fastboot)
الرميات | |
---|---|
DeviceNotAvailableException |
سلسلة إجراءات ما بعد الاستدعاء
public void postInvocationTearDown (Throwable exception)
خطوات إضافية سيتم تنفيذها بعد الاستدعاء والتنظيف المطلوب المتعلق بالجهاز .
المعلمات | |
---|---|
exception |
Throwable : إن وجد، هو الاستثناء النهائي الذي أثاره تعذُّر الاستدعاء. |
إعداد ما قبل الاستدعاء
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
خطوات إضافية للإعداد المطلوب المحدد للجهاز والذي سيتم تنفيذه على الجهاز قبل تدفق الاستدعاء.
المعلمات | |
---|---|
info |
IBuildInfo : IBuildInfo للجهاز |
attributes |
MultiMap : السمات المخزّنة في سياق الاستدعاء |
الرميات | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
سحب
public boolean pullDir (String deviceFilePath, File localDir, int userId)
سحب محتوى الدليل من الجهاز بشكل متكرر
المعلمات | |
---|---|
deviceFilePath |
String : المسار المطلق للملف للمصدر البعيد |
localDir |
File : الدليل المحلي لسحب الملفات إليه |
userId |
int : رقم تعريف المستخدم المطلوب السحب منه |
المرتجعات | |
---|---|
boolean |
true إذا تم سحب الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
سحب
public boolean pullDir (String deviceFilePath, File localDir)
سحب محتوى الدليل من الجهاز بشكل متكرر
المعلمات | |
---|---|
deviceFilePath |
String : المسار المطلق للملف للمصدر البعيد |
localDir |
File : الدليل المحلي لسحب الملفات إليه |
المرتجعات | |
---|---|
boolean |
true إذا تم سحب الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
ملف سحب
public boolean pullFile (String remoteFilePath, File localFile)
لاسترداد ملف من الجهاز.
المعلمات | |
---|---|
remoteFilePath |
String : المسار المطلق للملف على الجهاز |
localFile |
File : الملف على الجهاز الذي تريد تخزين المحتوى فيه وإذا لم تكن فارغة، سيكون المحتوى
التي تم استبدالها. |
المرتجعات | |
---|---|
boolean |
true في حال استرداد الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
ملف سحب
public File pullFile (String remoteFilePath, int userId)
استرداد ملف من الجهاز وتخزينه في ERROR(/File)
مؤقت محلي، وإرجاعه
File
المعلمات | |
---|---|
remoteFilePath |
String : المسار المطلق للملف على الجهاز |
userId |
int : رقم تعريف المستخدم المطلوب السحب منه |
المرتجعات | |
---|---|
File |
علامة ERROR(/File) تتضمّن محتوى ملف الجهاز، أو null إذا كانت
فشل النسخ لأي سبب (بما في ذلك المشكلات في نظام الملفات المضيف) |
الرميات | |
---|---|
DeviceNotAvailableException |
ملف سحب
public File pullFile (String remoteFilePath)
استرداد ملف من الجهاز وتخزينه في ERROR(/File)
مؤقت محلي، وإرجاعه
File
المعلمات | |
---|---|
remoteFilePath |
String : المسار المطلق للملف على الجهاز |
المرتجعات | |
---|---|
File |
علامة ERROR(/File) تتضمّن محتوى ملف الجهاز، أو null إذا كانت
فشل النسخ لأي سبب (بما في ذلك المشكلات في نظام الملفات المضيف) |
الرميات | |
---|---|
DeviceNotAvailableException |
ملف سحب
public boolean pullFile (String remoteFilePath, File localFile, int userId)
لاسترداد ملف من الجهاز.
المعلمات | |
---|---|
remoteFilePath |
String : المسار المطلق للملف على الجهاز |
localFile |
File : الملف على الجهاز الذي تريد تخزين المحتوى فيه وإذا لم تكن فارغة، سيكون المحتوى
التي تم استبدالها. |
userId |
int : رقم تعريف المستخدم المطلوب السحب منه |
المرتجعات | |
---|---|
boolean |
true في حال استرداد الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
سحب ملف المحتوى
public String pullFileContents (String remoteFilePath)
يسترد الملف من الجهاز ويعرض المحتوى.
المعلمات | |
---|---|
remoteFilePath |
String : المسار المطلق للملف على الجهاز |
المرتجعات | |
---|---|
String |
علامة String تتضمّن محتوى ملف الجهاز، أو null إذا كانت
فشل النسخ لأي سبب (بما في ذلك المشكلات في نظام الملفات المضيف) |
الرميات | |
---|---|
DeviceNotAvailableException |
سحب ملف من الخارج
public File pullFileFromExternal (String remoteFilePath)
طريقة ملائمة لاسترداد ملف من وحدة التخزين الخارجية للجهاز وتخزينها في
ERROR(/File)
المحلية المؤقتة، وعرض إشارة إلى File
تلك.
المعلمات | |
---|---|
remoteFilePath |
String : مسار الملف على الجهاز، بالنسبة إلى وحدة التخزين الخارجية للجهاز
نقطة تثبيت |
المرتجعات | |
---|---|
File |
علامة ERROR(/File) تتضمّن محتوى ملف الجهاز، أو null إذا كانت
فشل النسخ لأي سبب (بما في ذلك المشكلات في نظام الملفات المضيف) |
الرميات | |
---|---|
DeviceNotAvailableException |
مفتاح الدفع
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
دفع محتويات الدليل إلى الجهاز بشكل متكرر مع استبعاد بعض الأدلة تمت تصفيته.
المعلمات | |
---|---|
localFileDir |
File : الدليل المحلي لإرساله |
deviceFilePath |
String : المسار المطلق للملف الوجهة البعيدة |
excludedDirectories |
: مجموعة من أسماء الدلائل المستبعَدة التي لا يجب إرسالها |
المرتجعات | |
---|---|
boolean |
true إذا تم إرسال الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
مفتاح الدفع
public boolean pushDir (File localFileDir, String deviceFilePath)
دفع محتوى الدليل إلى الجهاز بشكل متكرر.
المعلمات | |
---|---|
localFileDir |
File : الدليل المحلي لإرساله |
deviceFilePath |
String : المسار المطلق للملف الوجهة البعيدة |
المرتجعات | |
---|---|
boolean |
true إذا تم إرسال الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
مفتاح الدفع
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
دفع محتوى الدليل إلى الجهاز بشكل متكرر.
المعلمات | |
---|---|
localFileDir |
File : الدليل المحلي لإرساله |
deviceFilePath |
String : المسار المطلق للملف الوجهة البعيدة |
userId |
int : رقم تعريف المستخدم المطلوب التوجيه إليه |
المرتجعات | |
---|---|
boolean |
true إذا تم إرسال الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
ملف الدفع
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
صيغة pushFile(File, String)
التي يمكنها اختياريًا تقييم الحاجة
لمقدم المحتوى.
المعلمات | |
---|---|
localFile |
File : الملف المحلي المطلوب إرساله |
remoteFilePath |
String : المسار المطلق للملف الوجهة البعيدة |
evaluateContentProviderNeeded |
boolean : ما إذا كنا بحاجة إلى التحقق من موفر المحتوى أم لا |
المرتجعات | |
---|---|
boolean |
true إذا تم إرسال الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
ملف الدفع
public boolean pushFile (File localFile, String remoteFilePath)
إرسال ملف إلى الجهاز استخدام موفّر محتوى بشكل تلقائي
المعلمات | |
---|---|
localFile |
File : الملف المحلي المطلوب إرساله |
remoteFilePath |
String : المسار المطلق للملف الوجهة البعيدة |
المرتجعات | |
---|---|
boolean |
true إذا تم إرسال الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
ملف الدفع
public boolean pushFile (File localFile, String remoteFilePath, int userId)
إرسال ملف إلى الجهاز استخدام موفّر محتوى بشكل تلقائي
المعلمات | |
---|---|
localFile |
File : الملف المحلي المطلوب إرساله |
remoteFilePath |
String : المسار المطلق للملف الوجهة البعيدة |
userId |
int : رقم تعريف المستخدم لإرساله إلى |
المرتجعات | |
---|---|
boolean |
true إذا تم إرسال الملف بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
PushString
public boolean pushString (String contents, String remoteFilePath)
ملف دفع تم إنشاؤه من سلسلة إلى جهاز
المعلمات | |
---|---|
contents |
String : محتوى الملف المطلوب إرساله |
remoteFilePath |
String : المسار المطلق للملف الوجهة البعيدة |
المرتجعات | |
---|---|
boolean |
true إذا تم إرسال السلسلة بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة تشغيل
public void reboot (String reason)
يؤدي إلى إعادة تشغيل الجهاز في وضع adb باستخدام reason
المحدَّد للاستمرار خلال إعادة التشغيل.
يتم حظر هذا الإعداد إلى أن يصبح الجهاز متاحًا.
يمكن الحصول على سبب آخر إعادة تشغيل من خلال تقديم طلب بحث خاص بـ sys.boot.reason
.
المعلمات | |
---|---|
reason |
String : سبب إعادة التشغيل هذه، أو null إذا لم يتم تحديد سبب. |
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة تشغيل
public void reboot ()
يعيد تشغيل الجهاز في وضع adb.
يتم حظر هذا الإعداد إلى أن يصبح الجهاز متاحًا.
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة تشغيل في برنامج التحميل
public void rebootIntoBootloader ()
يؤدي هذا الإجراء إلى إعادة تشغيل الجهاز باستخدام وضع برنامج الإقلاع.
يؤدي هذا الخيار إلى حظر الجهاز إلى أن يكون الجهاز في وضع برنامج الإقلاع.
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة تشغيل IntoFastbootd
public void rebootIntoFastbootd ()
يعيد تشغيل الجهاز في وضع Fastbootd.
يحظر هذا الإعداد وضع الجهاز في وضع Fastbootd.
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة التشغيل في عملية الاسترداد
public void rebootIntoRecovery ()
يعيد تشغيل الجهاز في وضع الاسترداد (Recovery mode) باستخدام adb.
يتم حظرها إلى أن يدخل الجهاز في حالة الاسترداد
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة التشغيل في التحميل الجانبي
public void rebootIntoSideload ()
إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف في adb (يُرجى ملاحظة أنّ هذا وضع خاص ضمن عملية الاسترداد)
يحظر هذا الإجراء إلى أن يدخل الجهاز في وضع التثبيت من مصدر غير معروف.
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة التشغيل في التحميل الجانبي
public void rebootIntoSideload (boolean autoReboot)
إعادة تشغيل الجهاز في وضع التثبيت من مصدر غير معروف في adb (يُرجى ملاحظة أنّ هذا وضع خاص ضمن عملية الاسترداد)
يحظر هذا الإجراء إلى أن يدخل الجهاز في وضع التثبيت من مصدر غير معروف.
المعلمات | |
---|---|
autoReboot |
boolean : ما إذا كان ستتم إعادة تشغيل الجهاز تلقائيًا بعد التثبيت من مصدر غير معروف |
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة التشغيل حتى الإنترنت
public void rebootUntilOnline ()
بديل reboot()
الذي لا يحظر إلا إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئي لـ adb.
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة التشغيل حتى الإنترنت
public void rebootUntilOnline (String reason)
بديل reboot()
الذي لا يحظر إلا إلى أن يصبح الجهاز متصلاً بالإنترنت، أي مرئي لـ adb.
المعلمات | |
---|---|
reason |
String : سبب إعادة التشغيل هذه، أو null إذا لم يتم تحديد سبب. |
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة تشغيل مساحة المستخدم
public void rebootUserspace ()
يؤدي إلى إعادة تشغيل جزء "مساحة المستخدم" فقط من الجهاز.
يتم حظر هذا الإعداد إلى أن يصبح الجهاز متاحًا.
تحذير إعادة تشغيل Userspace قيد التطوير النشط حاليًا، لذا يمكنك استخدامها على مسؤوليتك الخاصة.
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة تشغيلUserspace حتى الإنترنت
public void rebootUserspaceUntilOnline ()
بديل rebootUserspace()
()} الذي لا يحظر إلا إلى أن يصبح الجهاز متصلاً بالإنترنت، أي
مرئية لـ Adb.
الرميات | |
---|---|
DeviceNotAvailableException |
استرداد الجهاز
public boolean recoverDevice ()
محاولات استعادة الاتصال بالجهاز
المرتجعات | |
---|---|
boolean |
صحيح إذا تمت محاولة الاسترداد ونجحت، يعرض "خطأ" إذا تم تخطي الاسترداد |
الرميات | |
---|---|
DeviceNotAvailableException |
إذا لم يعُد الجهاز متاحًا |
جهاز استقبال عنصر التسجيل
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
يتم تسجيل IDeviceActionReceiver
لهذا الجهاز.
سيتم إرسال إشعار إلى جميع "IDeviceActionReceiver
" المسجَّلة قبل اتّخاذ إجراء على الجهاز
يبدأ وبعد انتهاء إجراء الجهاز.
المعلمات | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : IDeviceActionReceiver الذي سيتم تسجيله. |
إعادة تحميل النظام للقراءة فقط
public void remountSystemReadOnly ()
ضبط جزء النظام على الجهاز للقراءة فقط وقد تتم إعادة تشغيل الجهاز.
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة تثبيت النظام القابل للكتابة
public void remountSystemWritable ()
جعل تقسيم النظام على الجهاز قابلاً للكتابة وقد تتم إعادة تشغيل الجهاز.
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة تثبيت المورّدقراءة فقط
public void remountVendorReadOnly ()
اضبط قسم المورِّد على الجهاز للقراءة فقط. وقد تتم إعادة تشغيل الجهاز.
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة تركيب البائع
public void remountVendorWritable ()
جعل قسم البائع على الجهاز قابلاً للكتابة وقد تتم إعادة تشغيل الجهاز.
الرميات | |
---|---|
DeviceNotAvailableException |
إزالة مسؤول
public boolean removeAdmin (String componentName, int userId)
عليك إزالة مشرف الجهاز المحدّد من مستخدم معيّن وعرض true
إذا تم ذلك بنجاح، أو عرض false
بخلاف ذلك.
المعلمات | |
---|---|
componentName |
String : من مشرف الجهاز ستتم إزالته. |
userId |
int : للمستخدم الذي يتواجد فيه مشرف الجهاز. |
المرتجعات | |
---|---|
boolean |
صحيح إذا كان ناجحًا، وخطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
إزالة المالكين
public void removeOwners ()
يمكنك إزالة جميع مالكي الملفات الشخصية الحالية للأجهزة مع بذل قصارى جهدك.
الرميات | |
---|---|
DeviceNotAvailableException |
إزالة مستخدم
public boolean removeUser (int userId)
إزالة مستخدم معيّن من الجهاز
المعلمات | |
---|---|
userId |
int : للمستخدم المطلوب إزالته |
المرتجعات | |
---|---|
boolean |
true إذا نجحنا في إزالة المستخدم، على false وإلا. |
الرميات | |
---|---|
DeviceNotAvailableException |
إعادة ضبطContentProviderSetup
public void resetContentProviderSetup ()
يُرجى إعادة ضبط العلامة لإعداد موفّر المحتوى لتفعيلها مرة أخرى.
اختبارات Runالفيديو
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
طريقة ملائمة لإجراء ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
باستخدام مستمع واحد أو أكثر يتم تمريره كمعلَمات.
المعلمات | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner الذي يجري الاختبارات |
listeners |
ITestLifeCycleReceiver : أدوات معالجة نتائج الاختبار |
المرتجعات | |
---|---|
boolean |
true في حال اكتمال الأمر التجريبي. false إذا تعذّر
مكتملة، ولكن تم الاسترداد بنجاح |
الرميات | |
---|---|
DeviceNotAvailableException |
اختبارات Runالفيديو
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
إجراء اختبارات قياس حالة الجهاز وتوفير إمكانية استرداد الأجهزة
في حال فقدان الاتصال بالجهاز قبل اكتمال إجراء الاختبار ونجاح عملية الاسترداد، سيتم تنفيذ جميع سيتم إعلام المستمعين بـ testRunFound وfalse" سيتم إرجاعه. الأمر التجريبي لن تتم إعادة تشغيله. ويتم تركه للمتصلين لإعادة المحاولة إذا لزم الأمر.
في حال فقدان الاتصال بالجهاز قبل اكتمال إجراء الاختبار وتعذُّر عملية الاسترداد، سيتم إعلام المستمعين بـ testRunFound وDeviceNotavailableException.
المعلمات | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner الذي يجري الاختبارات |
listeners |
: أدوات معالجة نتائج الاختبار |
المرتجعات | |
---|---|
boolean |
true في حال اكتمال الأمر التجريبي. false إذا تعذّر
اكتمل التحديث بسبب استثناء في الاتصال بالجهاز، ولكن عملية الاسترداد نجحت |
الرميات | |
---|---|
DeviceNotAvailableException |
runElementationTestsAUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
الأسعار نفسها في فندق ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
ولكن
إجراء الاختبار لمستخدم معين.
المعلمات | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
runElementationTestsAUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
مثل ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
، ولكن يتم إجراء الاختبار لمستخدم معيَّن.
المعلمات | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
ضبط الإعدادات
public void setConfiguration (IConfiguration configuration)
إدخال IConfiguration
قيد الاستخدام.
المعلمات | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
المعلمات | |
---|---|
avdInfo |
GceAvdInfo |
تاريخ الضبط
public void setDate (Date date)
لضبط التاريخ على الجهاز
ملاحظة: يجب توفّر الجذر لضبط التاريخ على الجهاز.
المعلمات | |
---|---|
date |
Date : تحديد تاريخ معيّن سيتم استخدام تاريخ المضيف إذا كانت السمة null |
الرميات | |
---|---|
DeviceNotAvailableException |
setDeviceOwner
public boolean setDeviceOwner (String componentName, int userId)
ضبط مكوِّن مشرف الجهاز كمالك للجهاز في مستخدم معيَّن.
المعلمات | |
---|---|
componentName |
String : من مشرف الجهاز ليكون مالك الجهاز. |
userId |
int : للمستخدم الذي يعيش فيه مالك الجهاز |
المرتجعات | |
---|---|
boolean |
صحيح إذا كان ناجحًا، وخطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
تعيين حالة الجهاز
public void setDeviceState (TestDeviceState deviceState)
تغيير حالة الجهاز
المعلمات | |
---|---|
deviceState |
TestDeviceState : TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
بالنسبة إلى المحاكي، تم ضبط SizeLimitedOutputStream
على تسجيل الناتج.
المعلمات | |
---|---|
output |
SizeLimitedOutputStream : لتسجيل الناتج |
عملية setEmulatorProcess
public void setEmulatorProcess (Process p)
تضبط هذه السياسة سياسة Process
عندما يكون هذا الجهاز محاكيًا.
المعلمات | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
يمكنك ضبط خيار Fastboot للجهاز. يجب ضبط هذه السياسة عندما يتم تشغيل الجهاز لأول مرة. المخصص.
المعلمات | |
---|---|
fastbootEnabled |
boolean : ما إذا كان Fastboot متاحًا للجهاز أم لا |
setFastbootPath
public void setFastbootPath (String fastbootPath)
لضبط المسار إلى البرنامج الثنائي Fastboot الذي يجب استخدامه.
لا يزال يشترط ضبط السمة isFastbootEnabled()
على "صحيح" لتفعيل دوال Fastboot (Fastboot).
المعلمات | |
---|---|
fastbootPath |
String |
جهاز setIDevice
public void setIDevice (IDevice newDevice)
يُرجى تحديث IDevice المرتبط بـ ITestDevice هذا.
يجب أن يشير IDevice الجديد إلى الجهاز الفعلي نفسه كمرجع حالي. هذه الطريقة سيتم استدعاؤه في حال تخصيص إدارة DDMS لجهاز IDevice جديد
المعلمات | |
---|---|
newDevice |
IDevice : IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
تحدِّد هذه السياسة الوقت بالملّي ثانية للانتظار قبل بدء التقاط سجلّ Logcat لجهاز على الإنترنت.
المعلمات | |
---|---|
delay |
int : التأخير بالمللي ثانية |
تعيين خيارات
public void setOptions (TestDeviceOptions options)
ضبط TestDeviceOptions
للجهاز
المعلمات | |
---|---|
options |
TestDeviceOptions |
خاصية set
public boolean setProperty (String propKey, String propValue)
لضبط قيمة السمة المحدّدة على الجهاز يجب ضبط جذر adb على "صحيح".
المعلمات | |
---|---|
propKey |
String : المفتاح الذي سيتم إعداده. |
propValue |
String : قيمة السمة التي سيتمّ ضبطها |
المرتجعات | |
---|---|
boolean |
تعرض الدالة True إذا كان الأمر setpr ناجحًا، ويكون False في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
استعادة البيانات
public void setRecovery (IDeviceRecovery recovery)
يمكنك ضبط IDeviceRecovery
حتى يتم استخدامها لهذا الجهاز. يجب ضبط هذه السياسة عندما يتم تشغيل الجهاز لأول مرة.
المخصص.
المعلمات | |
---|---|
recovery |
IDeviceRecovery : IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
يمكنك ضبط وضع الاسترداد الحالي لاستخدامه على الجهاز.
يُستخدم للتحكم في طريقة الاسترداد التي يجب استخدامها عند حدوث مشكلة في الاتصال بالجهاز واجهناها. يُنصَح باستخدام هذه الطريقة باعتدال عند الحاجة فقط (على سبيل المثال، عندما يكون إطار العمل معطلاً، وما إلى ذلك
المعلمات | |
---|---|
mode |
ITestDevice.RecoveryMode : ما إذا كان "الاسترداد حتى الإنترنت فقط" تمكين الوضع أم لا. |
ضبط الإعداد
public void setSetting (String namespace, String key, String value)
يمكنك الاطّلاع على setSetting(int, String, String, String)
وتنفيذها على مستخدم النظام.
المعلمات | |
---|---|
namespace |
String |
key |
String |
value |
String |
الرميات | |
---|---|
DeviceNotAvailableException |
ضبط الإعداد
public void setSetting (int userId, String namespace, String key, String value)
أضِف قيمة إعداد إلى مساحة الاسم لمستخدم معيّن. ستكون بعض الإعدادات متاحة فقط بعد إعادة التشغيل. يجب أن تكون مساحة الاسم واحدة مما يلي: {"system", "secure", "global"}
المعلمات | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
الرميات | |
---|---|
DeviceNotAvailableException |
ضبط مسجِّل الاختبار
public void setTestLogger (ITestLogger testLogger)
إدخال مثيل ITestLogger
المعلمات | |
---|---|
testLogger |
ITestLogger |
تعيين الرقم التسلسلي
public void setTrackingSerial (String trackingSerial)
لأغراض إدارة الجهاز، يمكنك تتبُّع الرقم التسلسلي الذي نستخدمه للإشارة إلى الجهاز.
المعلمات | |
---|---|
trackingSerial |
String |
setUseFastbootمحو
public void setUseFastbootErase (boolean useFastbootErase)
يمكنك ضبط ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
المعلمات | |
---|---|
useFastbootErase |
boolean : true إذا كان يجب استخدام محو بيانات Fastboot أو false إذا
استخدام تنسيق Fastboot (Fastboot). |
startLogcat
public void startLogcat ()
ابدأ التقاط مخرجات Logcat من الجهاز في الخلفية.
لن يكون لذلك أي تأثير إذا كان قد سبق تسجيل مخرجات Logcat. يمكن استرداد البيانات لاحقًا من خلال الطريقة getLogcat.
يجب الاتصال بـ "stopLogcat()
" إذا لم يعُد الجهاز قيد الاستخدام.
لا يلزم عادةً الاتصال بـ startLogcat()
وstopLogcat()
عند
في سياق استدعاء TF، حيث يبدأ إطار عمل TF (TF) ويوقفه في سجلّ Logcat.
مستخدم البدء
public boolean startUser (int userId)
لبدء تشغيل مستخدم معيّن في الخلفية إذا كان متوقفًا في الوقت الحالي. إذا كان المستخدم بالفعل يعمل في الخلفية، هذه الطريقة هي NOOP.
المعلمات | |
---|---|
userId |
int : للمستخدم للبدء في الخلفية |
المرتجعات | |
---|---|
boolean |
صحيح إذا تم بدء تشغيل المستخدم بنجاح في الخلفية. |
الرميات | |
---|---|
DeviceNotAvailableException |
مستخدم البدء
public boolean startUser (int userId, boolean waitFlag)
لبدء تشغيل مستخدم معيّن في الخلفية إذا كان متوقفًا في الوقت الحالي. إذا كان المستخدم بالفعل يعمل في الخلفية، هذه الطريقة هي NOOP. من الممكن تقديم علامة إضافية لانتظارها العملية المراد تطبيقها.
المعلمات | |
---|---|
userId |
int : للمستخدم للبدء في الخلفية |
waitFlag |
boolean : سيجعل الأمر ينتظر حتى يتم بدء تشغيل المستخدم وفتح قفله. |
المرتجعات | |
---|---|
boolean |
صحيح إذا تم بدء تشغيل المستخدم بنجاح في الخلفية. |
الرميات | |
---|---|
DeviceNotAvailableException |
مستخدم خلفية مرئي
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
لبدء تشغيل مستخدم معيّن في الخلفية، ويكون مرئيًا في الشاشة المحدّدة (أي السماح للمستخدم) لبدء الأنشطة في هذه الشاشة).
ملاحظة: لا يتحقّق هذا الأمر مما إذا كان المستخدم متوفّرًا أو ما إذا كان العرض متاحًا أم device supports such feature
وما إلى ذلك.
المعلمات | |
---|---|
userId |
int : للمستخدم للبدء في الخلفية |
displayId |
int : يظهر للمستخدم المستخدم على شاشة البدء. |
waitFlag |
boolean : سيجعل الأمر ينتظر حتى يتم بدء تشغيل المستخدم وفتح قفله. |
المرتجعات | |
---|---|
boolean |
true إذا تم بدء ظهور حساب المستخدم بنجاح في الخلفية. |
الرميات | |
---|---|
DeviceNotAvailableException |
جهاز إيقاف المحاكي
public void stopEmulatorOutput ()
أغلِق نتائج المحاكي واحذفها.
إيقاف Logcat
public void stopLogcat ()
أوقِف تسجيل مخرجات Logcat من الجهاز، وتجاهَل بيانات Logcat المحفوظة حاليًا.
ولن يكون لذلك أي تأثير إذا لم يتم تسجيل مخرجات Logcat.
إيقاف المستخدم
public boolean stopUser (int userId)
تؤدي هذه السياسة إلى إيقاف مستخدم معيّن. في حال إيقاف المستخدم، تكون هذه الطريقة هي NOOP. لا يمكن إيقاف المستخدم الحالي والمستخدم الحالي.
المعلمات | |
---|---|
userId |
int : للمستخدم المطلوب إيقافه. |
المرتجعات | |
---|---|
boolean |
true إذا تم إيقاف المستخدم بنجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
إيقاف المستخدم
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
إيقاف مستخدم معيّن. من الممكن تقديم علامات إضافية لانتظار تنفيذ العملية، وفرض إنهاء المستخدم. لا يمكن إيقاف المستخدم الحالي والمستخدم الحالي.
المعلمات | |
---|---|
userId |
int : للمستخدم المطلوب إيقافه. |
waitFlag |
boolean : سيجعل الأمر ينتظر حتى يتم إيقاف المستخدم. |
forceFlag |
boolean : سيتم فرض إيقاف المستخدم. |
المرتجعات | |
---|---|
boolean |
true إذا تم إيقاف المستخدم بنجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
SwitchToAdbTcp
public String switchToAdbTcp ()
تبديل الجهاز إلى وضع adb-over-tcp
المرتجعات | |
---|---|
String |
الرقم التسلسلي لأداة tcp أو null في حال تعذّر تبديل الجهاز |
الرميات | |
---|---|
DeviceNotAvailableException |
SwitchToAdbUsb
public boolean switchToAdbUsb ()
تبديل الجهاز إلى وضع adb عبر وضع USB.
المرتجعات | |
---|---|
boolean |
true إذا تمت عملية التبديل بنجاح، وfalse بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
مبدِّل المستخدِم
public boolean switchUser (int userId)
بدِّل إلى userId آخر له مهلة تلقائية. switchUser(int, long)
.
المعلمات | |
---|---|
userId |
int |
المرتجعات | |
---|---|
boolean |
صحيح في حال تطابق رقم تعريف المستخدم الجديد مع موفِّر رقم تعريف المستخدم. خطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
مبدِّل المستخدِم
public boolean switchUser (int userId, long timeout)
يُرجى التبديل إلى userId آخر ضمن المهلة المحدّدة كموعد نهائي. يمكنك محاولة إيقاف قفل المفاتيح بعد تغيير المستخدم بنجاح.
المعلمات | |
---|---|
userId |
int |
timeout |
long : يجب الانتظار قبل عرض الخطأ "خطأ" لتعذُّر تغيير المستخدم. |
المرتجعات | |
---|---|
boolean |
صحيح في حال تطابق رقم تعريف المستخدم الجديد مع موفِّر رقم تعريف المستخدم. خطأ في الحالات الأخرى. |
الرميات | |
---|---|
DeviceNotAvailableException |
مزامنة الملفات
public boolean syncFiles (File localFileDir, String deviceFilePath)
يزامن هذا الإعداد محتوى دليل ملفات محلي مع الجهاز بشكل متزايد.
يحدِّد الملفات التي يمكن إرسالها من خلال مقارنة الطوابع الزمنية للملفات المحلية بجهاز التحكّم عن بُعد. مماثلة. "الأحدث" فقط أو الملفات غير الموجودة سيتم دفعها إلى الجهاز. لهذا السبب النفقات العامة صغيرة نسبيًا إذا كانت مجموعة الملفات على الجهاز مُحدّثة من قبل.
سيتم تجاهل الملفات المخفية (التي تبدأ أسماؤها بـ ".").
مثال على الاستخدام: سيتم إنشاء دليل SyncFiles("/tmp/files", "/sdcard") بناءً على لم تكن موجودة مسبقًا، وتدفع بشكل متكرر محتوى /tmp/files إلى /sdcard/files.
المعلمات | |
---|---|
localFileDir |
File : دليل الملفات المحلي الذي يحتوي على الملفات المطلوب فرضها بشكل متكرر. |
deviceFilePath |
String : جذر المسار المطلق للملف الوجهة البعيدة. جميع الأدلة بهذه الطريقة
يجب أن يكون مسار الملف قابلاً للقراءة. أي الدفع إلى /data/local/tmp عندما لا يكون adb جذرًا
سيفشل |
المرتجعات | |
---|---|
boolean |
true إذا تمت مزامنة الملفات بنجاح. false بخلاف ذلك. |
الرميات | |
---|---|
DeviceNotAvailableException |
TakeBugreport
public Bugreport takeBugreport ()
يمكنك تسجيل تقرير خطأ وإرجاعه إلى عنصر Bugreport
لمعالجته. إرجاع فارغ
في حال حدوث مشكلة. يجب إزالة المحتوى المُشار إليه في عنصر تقرير الأخطاء من خلال Bugreport.close()
.
المرتجعات | |
---|---|
Bugreport |
إلغاء تثبيت الحزمة
public String uninstallPackage (String packageName)
إلغاء تثبيت حزمة Android من الجهاز
المعلمات | |
---|---|
packageName |
String : حزمة Android المطلوب إلغاء تثبيتها |
المرتجعات | |
---|---|
String |
أو String مع رمز خطأ، أو null في حال النجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
إلغاء تثبيت PackageForUser
public String uninstallPackageForUser (String packageName, int userId)
إلغاء تثبيت حزمة Android من الجهاز لمستخدم معيّن.
المعلمات | |
---|---|
packageName |
String : حزمة Android المطلوب إلغاء تثبيتها |
userId |
int : العدد الصحيح لرقم تعريف المستخدم المطلوب إلغاء التثبيت له |
المرتجعات | |
---|---|
String |
أو String مع رمز خطأ، أو null في حال النجاح. |
الرميات | |
---|---|
DeviceNotAvailableException |
فتح قفل الجهاز
public boolean unlockDevice ()
يؤدي هذا الإجراء إلى فتح قفل الجهاز إذا كان في حالة مشفّرة.
قد تتم إعادة تشغيل إطار العمل باستخدام هذه الطريقة ولكنها لن تستدعيpostBootSetup()
. ولذلك،
قد لا يكون الجهاز جاهزًا بالكامل للاختبار عند عودة هذه الطريقة.
المرتجعات | |
---|---|
boolean |
true إذا نجحت العملية أو كان الجهاز غير مشفَّر. |
الرميات | |
---|---|
DeviceNotAvailableException |
إلغاء تصحيح الأخطاء
public void unmountDebugfs ()
إلغاء تحميل برامج تصحيح الأخطاء
الرميات | |
---|---|
DeviceNotAvailableException |
انتظار ForBootComplete
public boolean waitForBootComplete (long timeOut)
يحظر هذا الخيار إلى أن يتم ضبط علامة اكتمال تشغيل الجهاز.
المعلمات | |
---|---|
timeOut |
long : الوقت بالميلي ثانية لانتظار ضبط العلامة |
المرتجعات | |
---|---|
boolean |
صحيح إذا تم ضبط علامة اكتمال تشغيل الجهاز خلال المهلة |
الرميات | |
---|---|
DeviceNotAvailableException |
انتظار_الجهاز متاح
public boolean waitForDeviceAvailable ()
في انتظار أن يصبح الجهاز مستجيبًا ومتاحًا للاختبار. يتم استخدام المهلة التلقائية.
المرتجعات | |
---|---|
boolean |
صحيح إذا كان الجهاز متاحًا، وخطأ في حال إيقاف الاسترداد ولم يكن متاحًا. |
الرميات | |
---|---|
DeviceNotAvailableException |
انتظار_الجهاز متاح
public boolean waitForDeviceAvailable (long waitTime)
في انتظار أن يصبح الجهاز مستجيبًا ومتاحًا للاختبار.
المعلمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
المرتجعات | |
---|---|
boolean |
صحيح إذا كان الجهاز متاحًا، وخطأ في حال إيقاف الاسترداد ولم يكن متاحًا. |
الرميات | |
---|---|
DeviceNotAvailableException |
انتظار_الجهاز متاح_في_مسار الاسترداد
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
بانتظار أن يصبح الجهاز مستجيبًا ومتاحًا بدون وضع مسار الاسترداد في الاعتبار.
المعلمات | |
---|---|
waitTime |
long |
المرتجعات | |
---|---|
boolean |
صحيح في حال توفُّر الجهاز، وخطأ في حال عدم توفّره. |
الرميات | |
---|---|
DeviceNotAvailableException |
برنامج setForDeviceBootloader
public void waitForDeviceBootloader ()
يحظر هذا الإعداد ظهور الجهاز عبر Fastboot (Fastboot). استخدام المهلة التلقائية.
الرميات | |
---|---|
DeviceNotAvailableException |
فترة الانتظارForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
حظر وصول الجهاز إلى الإعداد "استرداد adb" (لاحظ أن هذا يختلف عن
IDeviceRecovery
).
المعلمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
المرتجعات | |
---|---|
boolean |
true في حال تم تشغيل الجهاز لعملية الاسترداد قبل انتهاء الوقت.
false في الحالات الأخرى |
فترة الانتظارForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
يحظر وصول الجهاز إلى الحقل "adb sideload" (التحميل الجانبي من adb) ولاية
المعلمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
المرتجعات | |
---|---|
boolean |
true في حال تم تشغيل الجهاز في التحميل الجانبي قبل انتهاء الوقت. false
في الحالات الأخرى |
فترة الانتظار للجهاز غير متاحة
public boolean waitForDeviceNotAvailable (long waitTime)
قوالب عدم توفُّر الجهاز، أي أنّه غير متوفّر في adb
المعلمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
المرتجعات | |
---|---|
boolean |
true إذا لم يصبح الجهاز متاحًا قبل انتهاء الوقت.
false في الحالات الأخرى |
انتظار الجهاز على الإنترنت
public void waitForDeviceOnline ()
يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb. يتم استخدام المهلة التلقائية.
يُرجى العِلم أنّ الجهاز قد لا يستجيب بالضرورة للأوامر عند اكتمالها. استخدام
waitForDeviceAvailable()
بدلاً من ذلك.
الرميات | |
---|---|
DeviceNotAvailableException |
انتظار الجهاز على الإنترنت
public void waitForDeviceOnline (long waitTime)
يحظر هذا الحقل إلى أن يظهر الجهاز عبر adb.
يُرجى العِلم أنّ الجهاز قد لا يستجيب بالضرورة للأوامر عند اكتمالها. استخدام
waitForDeviceAvailable()
بدلاً من ذلك.
المعلمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
الرميات | |
---|---|
DeviceNotAvailableException |
انتظار ForDeviceShell
public boolean waitForDeviceShell (long waitTime)
في انتظار استجابة الجهاز لأمر adb Shell الأساسي.
المعلمات | |
---|---|
waitTime |
long : وقت الانتظار بالمللي ثانية |
المرتجعات | |
---|---|
boolean |
true إذا أصبح الجهاز متجاوبًا قبل انقضاء waitTime. |
الطرق المحمية
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
المعلمات | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
BuildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
إنشاء أمر نظام التشغيل لجلسة أمر adb shell المحدد والوسيطات
المعلمات | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
المرتجعات | |
---|---|
String[] |
التحقق من مستوى ApiLevelAst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
المعلمات | |
---|---|
feature |
String |
strictMinLevel |
int |
إنشاء إعادة تشغيل الجهاز
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
إنشاء "RebootDeviceAction
" لاستخدامه عند تنفيذ إجراء إعادة التشغيل
المعلمات | |
---|---|
rebootMode |
NativeDevice.RebootMode : وضع لإعادة التشغيل هذه. |
reason |
String : لإعادة التشغيل هذه |
المرتجعات | |
---|---|
NativeDevice.RebootDeviceAction |
RebootDeviceAction التي تم إنشاؤها. |
إعادة تشغيل
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
أعِد تشغيل أداة Adb.
المعلمات | |
---|---|
rebootMode |
NativeDevice.RebootMode : وضع لإعادة التشغيل هذه. |
reason |
String : لإعادة التشغيل هذه |
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
ضمان وقت التشغيل المتاح
protected void ensureRuntimePermissionSupported ()
طريقة مساعدة لطرح استثناء إذا لم يكن إذن التشغيل متاحًا
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
الحصول على ApiLevelSafe
protected int getApiLevelSafe ()
المرتجعات | |
---|---|
int |
الحصول على RunUtil
protected IRunUtil getRunUtil ()
احصل على المثيل RunUtil
لاستخدامه.
المرتجعات | |
---|---|
IRunUtil |
تهيئة الاتصال
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
المعلمات | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
الرميات | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
الموقع الداخلي
protected String internalGetProperty (String propName, String fastbootVar, String description)
استرجاع خاصية الجهاز من ذاكرة التخزين المؤقت ddmlib بشكل تلقائي، والانتقال إلى "adb" Shell getrep` أو `Fastboot getvar` استنادًا إلى ما إذا كان الجهاز في Fastboot أم لا.
المعلمات | |
---|---|
propName |
String : اسم خاصية الجهاز كما يعرضه `adb shell getrep` |
fastbootVar |
String : اسم متغيّر Fastboot المكافئ لطلب البحث إذا null ،
لن تتم محاولة إجراء طلب بحث Fastboot |
description |
String : وصف بسيط للمتغيّر. يجب أن يكون الحرف الأول كبيرًا. |
المرتجعات | |
---|---|
String |
سلسلة، من المحتمل أن تكون null أو فارغة، وتحتوي على قيمة السمة المحدّدة |
الرميات | |
---|---|
DeviceNotAvailableException |
عبارة إعادة تشغيل الاتصال
protected boolean isInRebootCallback ()
يعرض ما إذا كان يتم حاليًا تنفيذ استدعاءات إعادة التشغيل أم لا. جميع واجهات برمجة التطبيقات العامة لـ يجب إيقاف إعادة التشغيل إذا كانت صحيحة.
المرتجعات | |
---|---|
boolean |
أحدث
protected boolean isNewer (File localFile, IFileEntry entry)
يمكنك عرض true
إذا كان الملف المحلي أحدث من الملف البعيد. IFileEntry
يجري
دقيقًا بالدقيقة، وفي حال تساوى الأوقات، سيتم اعتبار الملف أحدث.
المعلمات | |
---|---|
localFile |
File |
entry |
IFileEntry |
المرتجعات | |
---|---|
boolean |
ارسال الارسال
protected void notifyRebootEnded ()
يتم إرسال إشعار إلى جميع IDeviceActionReceiver
بشأن حدث إنهاء إعادة التشغيل.
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
إخطار إعادة التشغيل
protected void notifyRebootStarted ()
إرسال إشعار إلى كل IDeviceActionReceiver
بشأن حدث بدء إعادة التشغيل.
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
تنفيذ الإجراء على الجهاز
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
ينفذ إجراءً على هذا الجهاز. محاولات استرداد الجهاز وإعادة محاولة الأمر اختياريًا إذا فشل الإجراء.
المعلمات | |
---|---|
actionDescription |
String : وصف موجز للإجراء المطلوب تنفيذه. يُستخدَم للتسجيل
على الأغراض فقط. |
action |
NativeDevice.DeviceAction : الإجراء الذي سيتم تنفيذه |
retryAttempts |
int : تحاول إعادة المحاولة اتخاذ إجراء في حال تعذّر الإجراء ونجحت عملية الاسترداد |
المرتجعات | |
---|---|
boolean |
true إذا تم تنفيذ الإجراء بنجاح |
الرميات | |
---|---|
DeviceNotAvailableException |
إذا فشلت محاولة الاسترداد أو تم تنفيذ الحد الأقصى لعدد المحاولات بدون نجحت العملية |
بعد إعادة تشغيل الإعلانات
protected void postAdbReboot ()
الإجراءات الإضافية المحتملة التي يمكن اتخاذها بعد إعادة التشغيل.
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
إعداد prePostBootSetup
protected void prePostBootSetup ()
يسمح هذا الإذن لكل نوع جهاز (AndroidNativeDevice وTestDevice) بإلغاء هذه الطريقة في إعداد ما بعد التمهيد المحدد.
الرميات | |
---|---|
|
com.android.tradefed.device.DeviceNotavailableException |
DeviceNotAvailableException |
سحب الملف الداخلي
protected boolean pullFileInternal (String remoteFilePath, File localFile)
المعلمات | |
---|---|
remoteFilePath |
String |
localFile |
File |
المرتجعات | |
---|---|
boolean |
الرميات | |
---|---|
DeviceNotAvailableException |
ضبط الساعة
protected void setClock (Clock clock)
اضبط مثيل "الساعة" لاستخدامه.
المعلمات | |
---|---|
clock |
Clock |
عملية ضبط البيانات المجهرية
protected void setMicrodroidProcess (Process process)
تضع علامة على TestDevice على أنّه ميكروdroid وتضبط الرقم التعريفي للعميل الخاص به.
المعلمات | |
---|---|
process |
Process : عملية تشغيل الجهاز الافتراضي Microdroid |
setTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
المعلمات | |
---|---|
deviceOptions |
|
أمر SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
يتم تنفيذ أمر Fastboot بسيط باستخدام متغيرات البيئة والإبلاغ عن حالة الأمر.
المعلمات | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
المرتجعات | |
---|---|
CommandResult |
أمر SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
ينفّذ أمر Fastboot بسيطًا ويبلغ عن حالة الأمر.
المعلمات | |
---|---|
timeout |
long |
fullCmd |
String |
المرتجعات | |
---|---|
CommandResult |
فترة الانتظار للجهاز غير متاحة
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
يُرجى الانتظار إلى أن يكون الجهاز غير متاح (يمكنك إيقاف التقارير إلى adb).
المعلمات | |
---|---|
operationDesc |
String : اسم العملية التي تنتظر عدم توفُّرها |
time |
long : وقت الانتظار حتى حدوث غير متاح |
المرتجعات | |
---|---|
boolean |
صحيح إذا أصبح الجهاز غير متاح. |