جهاز NativeDevice
public
class
NativeDevice
extends Object
implements
IManagedTestDevice,
IConfigurationReceiver,
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 getPro" لكل عنصر. |
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)
طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكل مبدئي منذ التوقيت العالمي المنسَّق (UTC) منذ بدء الجهاز من الجهاز و |
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 في حال حدوث خطأ داخلي |
|
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()
يمكنك تجاوز هذا الإعداد ما إذا كان الجهاز بحاجة إلى اتخاذ بعض الإجراءات المحدّدة بعد إلغاء إذن الوصول إلى الجذر وقبل اتصال الجهاز بالإنترنت مجددًا. |
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
|
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)
حظر الجهاز |
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 getbro" أو "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
القيمة الثابتة: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
القيمة الثابتة: 5000 (0x0000000000001388)
عدد المحاولات: MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
العدد الافتراضي لمحاولات الأمر لإعادة محاولة تنفيذ
القيمة الثابتة: 2 (0x00000002)
الحقول
DEBUGFS_PATH
public static final String DEBUGFS_PATH
بطاقة 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 getPro" لكل منتج، أي أن جلب كل الخصائص بنفس السرعة كما هو الحال بالنسبة إلى جلب واحدة. وتستدعي عناصر مثل device.getApiLevel() وcheckApiLevelAgesstNextRelease وgetBuild اعتبارًا من الخيارات المتقدمة "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 المحدّدة في خريطة wifiSsidToPsk. بعد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل حتى يتم استدعاء 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 المحدّدة في خريطة wifiSsidToPsk. بعد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل إعادة تشغيل حتى يتم استدعاء الدالة 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)
طريقة مساعِدة للتحقّق مما إذا تمت إعادة تشغيل الجهاز بشكل مبدئي منذ التوقيت العالمي المنسَّق (UTC) منذ بدء الجهاز من الجهاز و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 : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotAnswerException في حال تنفيذ 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 : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ 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 : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ 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 : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ 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 : الحد الأقصى لعدد مرات إعادة محاولة استخدام الأمر في حال تعذُّر تنفيذ الأمر بسبب
استثناء. سيتم طرح DeviceNotResponseException في حال تنفيذ 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 مرتبط بهذه الدالة، لذا قد تتطابق بعض أرقام تعريف المستخدمين مع قيمة فارغة.
الركلات المردودة | |
---|---|
|
تم العثور على خريطة لأرقام تعريف 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.
تُبلغ هذه الطريقة عن الإصدار الدقيق فقط إذا كانت السمة 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 (Fastboot).
الركلات المردودة | |
---|---|
String |
إصدار برنامج إقلاع String أو null إذا تعذّر العثور عليه |
الرميات | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
لاسترداد تقرير أخطاء من الجهاز.
يضمن تنفيذ هذا الإجراء استمرار العمل على جهاز بدون بطاقة SD (أو لم يتم تثبيت بطاقة sdcard بعد).
الركلات المردودة | |
---|---|
InputStreamSource |
InputStreamSource الذي سيُنشئ محتوى تقرير الأخطاء عند الطلب وفي حال تعذُّر ذلك، سينتج عن InputStreamSource قيمة ERROR(/InputStream) فارغة. |
getBugreportz
public InputStreamSource getBugreportz ()
لاسترداد تقرير الأخطاء من الجهاز. يحتوي تقرير الأخطاء في تنسيق Zip على تقرير الأخطاء الرئيسي وملفات السجلّ الأخرى المفيدة لتصحيح الأخطاء.
غير متوافق إلا مع "إصدار adb" > 1.0.36
الركلات المردودة | |
---|---|
InputStreamSource |
InputStreamSource من ملف ZIP الذي يحتوي على Bugreportz، لعرض قيمة فارغة في حال تعذّر تشغيله. |
الحصول على عنوان البريد الإلكتروني البديل
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)
معيّن استخدِم وقت Epoch داخليًا.
المعلّمات | |
---|---|
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 سيعرف إمكانية استرداد الجهاز في وضع التشغيل السريع إذا كان الجهاز في حالة غير صحيحة أو غير مستجيب.
الركلات المردودة | |
---|---|
String |
اسم نوع المنتج String أو null إذا تعذّر تحديده |
الرميات | |
---|---|
DeviceNotAvailableException |
getFastbootProductVariant
public String getFastbootProductVariant ()
طريقة ملائمة للحصول على نوع المنتج لهذا الجهاز عندما يكون في وضع التشغيل السريع.
يجب عدم استخدام هذه الطريقة إلا إذا كان الجهاز في وضع Fastboot (Fastboot). وفي هذه الحالة، يُعدّ هذا الخيار أكثر أمانًا من طريقة getProductType()
العامة، لأنّ ITestDevice سيعرف إمكانية استرداد الجهاز في وضع التشغيل السريع إذا كان الجهاز في حالة غير صحيحة أو غير مستجيب.
الركلات المردودة | |
---|---|
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.
قائمة المهام: توسيع عمليات التنفيذ أعلاه لدعم 'format' و 'rescale'
المعلّمات | |
---|---|
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 |
الحصول على UninstallablePackageNames
publicgetUninstallablePackageNames ()
جلب أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. ويُعرف ذلك حاليًا على أنّه حِزم غير تابعة للنظام وحِزم النظام المعدَّلة.
الركلات المردودة | |
---|---|
|
ERROR(/Set) من أسماء حزم String القابلة للإلغاء المثبّتة حاليًا على الجهاز. |
الرميات | |
---|---|
DeviceNotAvailableException |
الطريقة getUseFastboot تبيّن
public boolean getUseFastbootErase ()
تعرَّف على ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
الركلات المردودة | |
---|---|
boolean |
true في حال استخدام محو البيانات بشكل سريع أو false في حال استخدام تنسيق Fastboot (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 قبل إجراء الاختبارات التي يجب ألّا يتم تشغيلها مع شبكة Wi-Fi، مثل اختبارات بيانات الجوّال.
الركلات المردودة | |
---|---|
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 في هذه المرحلة.
الرميات | |
---|---|
|
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 وسيتم عرض DeviceNotavailableException.
المعلّمات | |
---|---|
runner |
IRemoteAndroidTestRunner : IRemoteAndroidTestRunner الذي يجري الاختبارات |
listeners |
: أدوات معالجة نتائج الاختبار |
الركلات المردودة | |
---|---|
boolean |
true في حال اكتمال الأمر التجريبي. false إذا تعذّر إكمال العملية بسبب استثناء في الاتصال بالجهاز، ولكن نجحت عملية الاسترداد |
الرميات | |
---|---|
DeviceNotAvailableException |
runinstrumentationTestsAUser
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 |
runinstrumentationTestsAUser
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 |
setUseFastboot تبيّن
public void setUseFastbootErase (boolean useFastbootErase)
يمكنك ضبط ما إذا كنت تريد استخدام محو بيانات Fastboot أو تنسيق Fastboot لمسح قسم في الجهاز.
المعلّمات | |
---|---|
useFastbootErase |
boolean : true إذا كان يجب استخدام محو بيانات Fastboot أو false إذا كان يجب استخدام تنسيق Fastboot. |
startLogcat
public void startLogcat ()
ابدأ التقاط مخرجات Logcat من الجهاز في الخلفية.
لن يكون لذلك أي تأثير إذا كان قد سبق تسجيل مخرجات Logcat. يمكن استرداد البيانات لاحقًا من خلال الطريقة getLogcat.
يجب الاتصال بـ "stopLogcat()
" إذا لم يعُد الجهاز قيد الاستخدام.
ليس من الضروري عادةً استدعاء startLogcat()
وstopLogcat()
عندما
يكون ضمن سياق استدعاء TF، حيث يبدأ إطار عمل TF ويوقفه.
مستخدم البدء
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)
حظر الجهاز
المعلّمات | |
---|---|
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 getbro" أو "Fastboot getvar" استنادًا إلى ما إذا كان الجهاز في Fastboot أم لا.
المعلّمات | |
---|---|
propName |
String : اسم خاصية الجهاز كما يعرضه `adb shell getrep` |
fastbootVar |
String : اسم متغيّر Fastboot المكافئ لطلب البحث. إذا كانت السمة null ،
لن تتم محاولة إجراء طلب بحث Fastboot. |
description |
String : وصف بسيط للمتغيّر. يجب أن يكون الحرف الأول كبيرًا. |
الركلات المردودة | |
---|---|
String |
سلسلة، من المحتمل أن تكون null أو فارغة، وتحتوي على قيمة السمة المحدّدة |
الرميات | |
---|---|
DeviceNotAvailableException |
عبارة إعادة تشغيل الاتصال
protected boolean isInRebootCallback ()
يعرض ما إذا كان يتم حاليًا تنفيذ استدعاءات إعادة التشغيل أم لا. يجب إيقاف جميع واجهات برمجة التطبيقات العامة الخاصة بإعادة التشغيل إذا كانت القيمة هي true.
الركلات المردودة | |
---|---|
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 |
صحيح إذا أصبح الجهاز غير متاح. |