NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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

التنفيذ التلقائي لأجهزة ITestDevice Android التي لا تتضمّن حِزم تطوير البرامج الكاملة

ملخّص

الفئات المُدمجة

class NativeDevice.AdbAction

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

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

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

الثوابت

int INVALID_USER_ID

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

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

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

الحقول

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

وظائف الإنشاء العامة

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

لإنشاء TestDevice.

الطرق العامة

void batchPrefetchStartupBuildProps()

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

boolean canSwitchToHeadlessSystemUser()

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

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

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

boolean checkConnectivity()

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

boolean clearErrorDialogs()

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

void clearLastConnectedWifiNetwork()

يؤدي هذا الإجراء إلى محو آخر شبكة Wi-Fi تم الاتصال بها.

void clearLogcat()

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

boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

الاتصال بشبكة Wi-Fi

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

الاتصال بشبكة Wi-Fi

boolean connectToWifiNetwork( wifiSsidToPsk)

الاتصال بشبكة Wi-Fi

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

الاتصال بشبكة Wi-Fi

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

أحد أنواع connectToWifiNetwork(String, String) التي لا تتصل إلا إذا لم يكن الجهاز متصلاً بالشبكة حاليًا.

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

أحد أنواع connectToWifiNetwork(String, String) التي لا تتصل إلا إذا لم يكن الجهاز متصلاً بالشبكة حاليًا.

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

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

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

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

int createUser(String name)

أنشئ مستخدمًا باسم معيّن وعلامات تلقائية 0.

int createUserNoThrow(String name)

أنشئ مستخدمًا باسم معيّن وعلامات تلقائية 0.

void deleteFile(String deviceFilePath, int userId)

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

void deleteFile(String deviceFilePath)

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

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

لإزالة IDeviceActionReceiver المسجَّل.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

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

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

boolean disableAdbRoot()

إيقاف إذن الوصول إلى الجذر من خلال adb

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

تفعيل إذن الوصول إلى الجذر من خلال adb

boolean enableNetworkMonitor()

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

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

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

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

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

String executeAdbCommand(String... cmdArgs)

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

CommandResult executeFastbootCommand(String... cmdArgs)

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

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

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

CommandResult executeLongFastbootCommand(String... cmdArgs)

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

CommandResult executeLongFastbootCommand( envVarMap, String... cmdArgs)

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

String executeShellCommand(String command)

طريقة مساعدة تنفِّذ أمر adb shell وتُعرِض الإخراج كString.

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

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

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

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

void executeShellCommand(String command, IShellOutputReceiver receiver)

تنفيذ أمر shell adb المحدَّد، مع إعادة المحاولة عدة مرات في حال تعذّر تنفيذ الأمر

CommandResult executeShellV2Command(String cmd)

طريقة مساعدة تنفِّذ أمر adb shell وتُعيد النتائج كقائمة CommandResult مملوءة بشكل صحيح بمخرجات حالة الأمر وstdout وstderr.

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

طريقة مساعدة تنفِّذ أمر adb shell وتُعيد النتائج كقائمة CommandResult تمّت تعبئتها بشكل صحيح بمخرجات حالة الأمر وstderr.

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

طريقة مساعدة تنفِّذ أمر adb shell وتُعيد النتائج كقائمة CommandResult مملوءة بشكل صحيح بمخرجات حالة الأمر وstdout وstderr.

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

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

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

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

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

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

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

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

CommandResult fastbootWipePartition(String partition)

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

getActiveApexes()

جلب المعلومات عن حسابات APEX التي تم تفعيلها على الجهاز

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 محفوظة في ذاكرة التخزين المؤقت إذا تم تخصيص الجهاز، وتعرِض DeviceDescriptor الحالية في حال عدم تخصيص الجهاز.

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

تعرِض هذه السمة قيمة DeviceDescriptor المخزّنة مؤقتًا في حال تم تخصيص الجهاز، وتعرِض DeviceDescriptor الحالية في حال عدم تخصيص الجهاز.

String[] getChildren(String path)

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

AbstractConnection getConnection()

عملية الربط الحالية المرتبطة بالجهاز

ContentProviderHandler getContentProvider(int userId)

تعرِض القيمة ContentProviderHandler أو قيمة فارغة إذا لم تكن متاحة.

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

عرض رقم تعريف المستخدم الحالي

String getDeviceClass()

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

long getDeviceDate()

عرض تاريخ الجهاز بالمللي ثانية منذ تاريخ بدء حساب الفترة

DeviceDescriptor getDeviceDescriptor()

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

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

TestDeviceState getDeviceState()

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

long getDeviceTimeOffset(Date date)

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

InputStreamSource getEmulatorOutput()

الحصول على بث stdout وstderr للمحاكي

Process getEmulatorProcess()

عرض القيمة Process الخاصة بهذا المحاكي

final File getExecuteShellCommandLog()

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

long getExternalStoreFreeSpace()

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

String getFastbootPath()

عرض مسار ملف fastboot الثنائي المستخدَم

String getFastbootProductType()

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

String getFastbootProductVariant()

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

String getFastbootSerialNumber()

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

String getFastbootVariable(String variableName)

استرداد قيمة متغيّر fastboot المحدَّدة من الجهاز

String getFastbootVersion()

لعرض سلسلة الإصدار الخاصة بالملف الثنائي لـ fastboot الذي يتم استخدامه.

IFileEntry getFileEntry(String path)

استرداد مرجع لملف عن بُعد على الجهاز

IFileEntry getFileEntry(FileListingService.FileEntry entry)

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

getFoldableStates()

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

IDevice getIDevice()

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

getInstalledPackageNames()

جلب أسماء حِزم التطبيقات المتوفّرة على الجهاز

long getIntProperty(String name, long defaultValue)

لعرض القيمة الصحيحة للسمة المحدّدة من الجهاز.

String getIpAddress()

الحصول على عنوان IP للجهاز

KeyguardControllerState getKeyguardState()

عرض عنصر للحصول على الحالة الحالية لقفل الشاشة أو عرض قيمة فارغة إذا لم يكن متاحًا

long getLastExpectedRebootTimeMillis()

تعرِض هذه السمة آخر مرة تسبّبت فيها واجهات برمجة تطبيقات Tradefed في إعادة تشغيل الجهاز بالمللي ثانية منذ EPOCH على النحو الذي يعرضه العنصر System.currentTimeMillis().

int getLaunchApiLevel()

الحصول على مستوى واجهة برمجة التطبيقات الذي تم إطلاقه للجهاز لأول مرة

InputStreamSource getLogcat()

تلتقط هذه الأداة لقطة سريعة لبيانات logcat.

InputStreamSource getLogcat(int maxBytes)

تلتقط هذه الأداة لقطات من آخر maxBytes من بيانات logcat التي تم تسجيلها.

InputStreamSource getLogcatDump()

الحصول على نسخة من logcat الحالي للجهاز

InputStreamSource getLogcatSince(long date)

تلتقط هذه الأداة لقطات من بيانات logcat التي تم تسجيلها بدءًا من التاريخ المقدَّم.

String getMacAddress()

تعرِض هذه السمة عنوان MAC للجهاز، وتكون قيمة هذه السمة فارغة إذا تعذّر إجراء طلب بحث من الجهاز.

Integer getMainUserId()

تعرِض هذه السمة رقم تعريف المستخدم الرئيسي.

getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

الحصول على الحد الأقصى لعدد المستخدمين المسموح لهم بالتشغيل المتزامن

int getMaxNumberOfUsersSupported()

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

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

عرض IDeviceStateMonitor المرتبط بالجهاز

String getMountPoint(String mountName)

لعرض نقطة تثبيت.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

عرض MountPointInfo مقابل مسار نقطة التثبيت المحدّد، أو null إذا لم يتم تثبيت أي عنصر في هذا المسار أو إذا لم يظهر في ‎/proc/mounts كنقطة تثبيت

getMountPointInfo()

لعرض نسخة مفسَّرة من المعلومات في ‎ /proc/mounts على الجهاز

TestDeviceOptions getOptions()

استرجاع خيارات الاختبار للجهاز

long getPartitionFreeSpace(String partition)

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

Integer getPrimaryUserId()

تعرِض هذه السمة رقم تعريف المستخدم الأساسي.

ProcessInfo getProcessByName(String processName)

تعمل الطريقة المساعِدة على تنفيذ الأمرَين "pidof" و "stat" وتعرض عنصر ProcessInfo يحتوي على رقم تعريف العملية ووقت بدء العملية المحدّدة.

String getProcessPid(String process)

تعرِض هذه الدالة رقم تعريف العملية للخدمة أو قيمة فارغة إذا حدث خطأ.

String getProductType()

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

String getProductVariant()

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

String getProperty(String name)

استرداد قيمة السمة المحدّدة من الجهاز

ITestDevice.RecoveryMode getRecoveryMode()

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

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot(String format)

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

InputStreamSource getScreenshot(String format, boolean rescale)

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

InputStreamSource getScreenshot()

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

String getSerialNumber()

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

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

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

String getSetting(String namespace, String key)

راجِع getSetting(int, String, String) ونفِّذ الإجراء على مستخدم النظام.

String getSimOperator()

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

String getSimState()

عرض حالة شريحة SIM أو القيمة null إذا لم تكن متاحة أو لم يكن الجهاز متاحًا

getTombstones()

جلب قائمة العناصر التي تم حذفها نهائيًا وإعادتها من الأجهزة

long getTotalMemory()

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

String getTrackingSerial()

لأغراض إدارة الجهاز، احصل على الرقم التسلسلي المستخدَم لتتبُّع الجهاز.

getUninstallablePackageNames()

جلب أسماء حِزم التطبيقات التي يمكن إلغاء تثبيتها

boolean getUseFastbootErase()

الحصول على ما إذا كان سيتم استخدام fastboot erase أو fastboot format لمحو قسم على الجهاز

int getUserFlags(int userId)

العثور على الإشعارات التي أرسلها مستخدم معيّن وإرجاعها

getUserInfos()

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

int getUserSerialNumber(int 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()

تحقَّق مما إذا كان قد تم تركيب debugfs.

boolean isDeviceEncrypted()

يعرض ما إذا كان الجهاز مشفَّرًا.

boolean isDirectory(String path)

عرض True إذا كان المسار على الجهاز دليلاً، وعرض False في غير ذلك

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

يعرض ما إذا كان التشفير متاحًا على الجهاز.

boolean isExecutable(String fullPath)

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

boolean isFastbootEnabled()

يُرجى الرجوع إذا كان وضع Fastboot متاحًا للجهاز.

boolean isHeadless()

عرض true إذا كان الجهاز غير مزوّد بشاشة (بدون شاشة)، وعرض false في الحالات الأخرى

boolean isHeadlessSystemUserMode()

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

boolean isMainUserPermanentAdmin()

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

boolean isMultiUserSupported()

لتحديد ما إذا كان استخدام حسابات متعدّدة مسموحًا به

boolean isPackageInstalled(String packageName, String userId)

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

boolean isPackageInstalled(String packageName)

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

boolean isRuntimePermissionSupported()

التحقّق مما إذا كانت المنصة على الجهاز تتيح منح أذونات التشغيل

boolean isStateBootloaderOrFastbootd()

تعرِض هذه الدالة القيمة true إذا كان الجهاز في وضع TestDeviceState.FASTBOOT أو TestDeviceState.FASTBOOTD.

boolean isUserRunning(int userId)

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

boolean isUserSecondary(int userId)

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

boolean isUserVisible(int userId)

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

boolean isUserVisibleOnDisplay(int userId, int displayId)

للتحقّق مما إذا كان المستخدم المحدّد مرئيًا في العرض المحدّد

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

boolean isVisibleBackgroundUsersSupported()

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

boolean isWifiEnabled()

تحقَّق مما إذا كانت شبكة Wi-Fi مفعَّلة.

listDisplayIds()

جمع قائمة أرقام تعريف الشاشات المتاحة على الجهاز كما هو موضّح في "dumpsys SurfaceFlinger"

listDisplayIdsForStartingVisibleBackgroundUsers()

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

listUsers()

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

boolean logAnrs(ITestLogger logger)

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

boolean logBugreport(String dataName, ITestLogger listener)

طريقة مساعدة لإنشاء تقرير خطأ وتسجيله لدى المُبلِغين

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

سجِّل رسالة في logcat للجهاز.

void mountDebugfs()

شغِّل debugfs.

void nonBlockingReboot()

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

void postAdbRootAction()

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

void postAdbUnrootAction()

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

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)

استرداد ملف من الجهاز وتخزينه في ERROR(/File) مؤقت على الجهاز، ثم عرضFile

File pullFile(String remoteFilePath)

استرداد ملف من الجهاز وتخزينه في ERROR(/File) مؤقت على الجهاز، ثم عرضFile

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

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

String pullFileContents(String remoteFilePath)

استرداد ملف من الجهاز وعرض محتواه

File pullFileFromExternal(String remoteFilePath)

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

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

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

boolean pushDir(File localFileDir, String deviceFilePath)

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

boolean pushDir(File localFileDir, String deviceFilePath, int userId)

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

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

نوع من pushFile(File, String) يمكنه اختياريًا تقييم الحاجة لمقدّم المحتوى.

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 باستخدام reason المحدَّد ليتم الاحتفاظ به أثناء إعادة التشغيل.

void reboot()

تؤدي هذه العملية إلى إعادة تشغيل الجهاز في وضع adb.

void rebootIntoBootloader()

إعادة تشغيل الجهاز في وضع برنامج الإقلاع

void rebootIntoFastbootd()

تؤدي هذه العملية إلى إعادة تشغيل الجهاز في وضع fastbootd.

void rebootIntoRecovery()

تؤدي هذه العملية إلى إعادة تشغيل الجهاز في وضع الاسترداد من adb.

void rebootIntoSideload()

إعادة تشغيل الجهاز في وضع "التثبيت من مصدر غير معروف" من خلال أداة adb (يُرجى العِلم أنّ هذا وضع خاص ضمن وضع الاسترداد)

يتم الحظر إلى أن يدخل الجهاز في وضع "التثبيت من مصدر غير معروف".

void rebootIntoSideload(boolean autoReboot)

إعادة تشغيل الجهاز في وضع "التثبيت من مصدر غير معروف" من خلال adb (يُرجى العِلم أنّ هذا وضع خاص ضمن وضع الاسترداد)

يتم الحظر إلى أن يدخل الجهاز في وضع "التثبيت من مصدر غير معروف".

void rebootUntilOnline()

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

void rebootUntilOnline(String reason)

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

void rebootUserspace()

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

void rebootUserspaceUntilOnline()

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

boolean recoverDevice()

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

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

تسجيل IDeviceActionReceiver لهذا الجهاز

void remountSystemReadOnly()

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

void remountSystemWritable()

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

void remountVendorReadOnly()

اضبط قسم المورّد على الجهاز على "للقراءة فقط".

void remountVendorWritable()

اجعل قسم المورّد على الجهاز قابلاً للكتابة.

boolean removeAdmin(String componentName, int userId)

أزِل مشرف الجهاز المحدّد في المستخدم المحدّد وأعِد true في حال نجاح العملية، وfalse في حال عدم نجاحها.

void removeOwners()

يُرجى إزالة جميع مالكي الملفات الشخصية الحالية للأجهزة بأفضل ما يمكن.

boolean removeUser(int userId)

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

void resetContentProviderSetup()

عليك إعادة ضبط علامة إعداد مقدّم المحتوى لتفعيلها مرة أخرى.

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

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

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

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))، ولكن يُجري الاختبار للمستخدم المحدّد.

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

يشبه ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) ولكنّه يُجري الاختبار لمستخدم معيّن.

void setConfiguration(IConfiguration configuration)

تحقِّق من استخدام IConfiguration.

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

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

ملاحظة: ضبط التاريخ على الجهاز يتطلب إذن الوصول إلى الجذر

boolean setDeviceOwner(String componentName, int userId)

ضبط مكوّن مشرف جهاز على أنّه مالك الجهاز في المستخدم المحدّد

void setDeviceState(TestDeviceState deviceState)

عدِّل حالة الجهاز.

void setEmulatorOutputStream(SizeLimitedOutputStream output)

بالنسبة إلى المحاكي، اضبط SizeLimitedOutputStream على تسجيل الإخراج.

void setEmulatorProcess(Process p)

تُستخدَم لضبط Process عندما يكون هذا الجهاز محاكيًا.

void setFastbootEnabled(boolean fastbootEnabled)

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

void setFastbootPath(String fastbootPath)

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

void setIDevice(IDevice newDevice)

عدِّل جهاز IDevice المرتبط بجهاز ITestDevice هذا.

void setLogStartDelay(int delay)

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

void setOptions(TestDeviceOptions options)

ضبط TestDeviceOptions للجهاز

boolean setProperty(String propKey, String propValue)

تُستخدَم لضبط قيمة السمة المحدّدة على الجهاز.

void setRecovery(IDeviceRecovery recovery)

اضبط IDeviceRecovery لاستخدامه مع هذا الجهاز.

void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

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

راجِع setSetting(int, String, String, String) ونفِّذ الإجراء على مستخدم النظام.

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

إضافة قيمة إعداد إلى مساحة الاسم الخاصة بمستخدم معيّن

void setTestLogger(ITestLogger testLogger)

إدراج مثيل ITestLogger

void setTrackingSerial(String trackingSerial)

لأغراض إدارة الجهاز، يمكنك تتبُّع الرقم التسلسلي الذي نستخدمه للإشارة إلى الجهاز.

void setUseFastbootErase(boolean useFastbootErase)

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

void startLogcat()

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

boolean startUser(int userId)

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

boolean startUser(int userId, boolean waitFlag)

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

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

بدء مستخدم معيّن في الخلفية، مرئي في العرض المحدّد (أي السماح للمستخدم ببدء الأنشطة في هذا العرض)

void stopEmulatorOutput()

أغلِق مخرج المحاكي واحذِف المحتوى منه.

void stopLogcat()

توقِف تسجيل بيانات logcat من الجهاز، وبذِل بيانات logcat المحفوظة حاليًا.

boolean stopUser(int userId)

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

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

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

String switchToAdbTcp()

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

boolean switchToAdbUsb()

عليك تبديل الجهاز إلى وضع adb عبر usb.

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

يمكنك التبديل إلى معرّف مستخدم آخر باستخدام مهلة الانتظار المقدَّمة كآخر مهلة.

boolean syncFiles(File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport()

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

String uninstallPackage(String packageName)

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

String uninstallPackageForUser(String packageName, int userId)

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

boolean unlockDevice()

فتح قفل الجهاز إذا كان الجهاز مشفَّرًا

void unmountDebugfs()

ألغِ تثبيت debugfs.

boolean waitForBootComplete(long timeOut)

يتم حظر الإجراء إلى أن يتم ضبط علامة اكتمال عملية تشغيل الجهاز.

boolean waitForDeviceAvailable()

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

boolean waitForDeviceAvailable(long waitTime)

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

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

ينتظر هذا الإجراء تفاعل الجهاز ومدى توفّره بدون النظر إلى مسار الاسترداد.

void waitForDeviceBootloader()

يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال Fastboot.

boolean waitForDeviceInRecovery(long waitTime)

يحظر هذا الإعداد أن يكون الجهاز في حالة "استرداد adb" (يُرجى العلم أنّ هذا الإعداد يختلف عن IDeviceRecovery).

boolean waitForDeviceInSideload(long waitTime)

حظر الجهاز في حالة "تحميل جانبي باستخدام adb"

boolean waitForDeviceNotAvailable(long waitTime)

الحظر لعدم توفّر الجهاز، أي عدم توفّره في adb

void waitForDeviceOnline()

يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال adb.

void waitForDeviceOnline(long waitTime)

يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال adb.

boolean waitForDeviceShell(long waitTime)

ينتظر حتى يستجيب الجهاز لأمر أساسي في واجهة برمجة التطبيقات adb shell.

الطرق المحمية

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

إنشاء أمر نظام التشغيل لجلسة أمر shell في adb وargs المحدَّدة

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

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

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

نفِّذ إعادة تشغيل adb.

void ensureRuntimePermissionSupported()

طريقة مساعدة لرمي استثناء في حال عدم توفّر إذن التشغيل

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

احصل على نسخة RunUtil لاستخدامها.

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

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

boolean isInRebootCallback()

يعرض ما إذا كان يتم حاليًا تنفيذ عمليات استدعاء إعادة التشغيل أم لا.

boolean isNewer(File localFile, IFileEntry entry)

عرض true إذا كان الملف على الجهاز أحدث من الملف على الجهاز البعيد

void notifyRebootEnded()

إرسال إشعار إلى جميع IDeviceActionReceiver بشأن حدث انتهاء إعادة التشغيل

void notifyRebootStarted()

تُرسِل إشعارًا إلى جميع IDeviceActionReceiver بشأن حدث بدء إعادة التشغيل.

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

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

void postAdbReboot()

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

void prePostBootSetup()

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

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

اضبط مثيل Clock المراد استخدامه.

void setMicrodroidProcess(Process process)

يضع علامة على TestDevice باعتباره microdroid ويضبط رقم تعريفه.

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

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

CommandResult simpleFastbootCommand(long timeout, String[] fullCmd)

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

boolean waitForDeviceNotAvailable(String operationDesc, long time)

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

الثوابت

INVALID_USER_ID

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

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

وظائف الإنشاء العامة

NativeDevice

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

لإنشاء TestDevice.

المعلمات
device IDevice: IDevice المرتبط
stateMonitor IDeviceStateMonitor: آلية IDeviceStateMonitor المُستخدَمة
allocationMonitor IDeviceMonitor: IDeviceMonitor لإعلامك بتغييرات حالة التخصيص يمكن أن تكون فارغة

الطرق العامة

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

المرتجعات
boolean

عمليات الرمي
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

المعلمات
strictMinLevel int: أدنى مستوى ممكن صارم يتيح استخدام الميزة
المرتجعات
boolean صحيح إذا كان المستوى متوافقًا. خطأ بخلاف ذلك.
عمليات الرمي
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

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

المرتجعات
boolean true إذا كان الجهاز متصلاً بالشبكة، false بخلاف ذلك
عمليات الرمي
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

المرتجعات
boolean true إذا لم تكن هناك مربّعات حوار أو تم محو مربّعات الحوار بنجاح. false بخلاف ذلك
عمليات الرمي
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

يؤدي هذا الإجراء إلى محو آخر شبكة Wi-Fi تم الاتصال بها. يجب استدعاء هذا الإجراء عند بدء طلب جديد لتجنُّب الاتصال بشبكة Wi-Fi المستخدَمة في الاختبار السابق بعد إعادة تشغيل الجهاز.

clearLogcat

public void clearLogcat ()

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

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

connectToWifiNetwork

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

connectToWifiNetwork

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

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

الاتصال بشبكة Wi-Fi

تفعِّل شبكة Wi-Fi وتحظرها إلى أن يتم إجراء اتصال ناجح بإحدى شبكات Wi-Fi المُدرَجة في خريطة wifiSsidToPsk. بعد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل إلى أن يتم استدعاء ITestDevice.disconnectFromWifi() أو ITestDevice.clearLastConnectedWifiNetwork().

المعلمات
wifiSsidToPsk : خريطة لمعرّفات SSID لشبكات Wi-Fi وكلمات المرور
المرتجعات
boolean true إذا تم الاتصال بشبكة Wi-Fi بنجاح false وإلا
عمليات الرمي
DeviceNotAvailableException

connectToWifiNetwork

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

connectToWifiNetworkIfNeeded

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

أحد أنواع connectToWifiNetwork(String, String) التي لا تتصل إلا إذا لم يكن الجهاز متصلاً بالشبكة حاليًا.

المعلمات
scanSsid boolean: ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة
المرتجعات
boolean true إذا تم الاتصال بشبكة Wi-Fi بنجاح false وإلا
عمليات الرمي
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

أحد أنواع connectToWifiNetwork(String, String) التي لا تتصل إلا إذا لم يكن الجهاز متصلاً بالشبكة حاليًا.

المرتجعات
boolean true إذا تم الاتصال بشبكة Wi-Fi بنجاح false وإلا
عمليات الرمي
DeviceNotAvailableException

createUser

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

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

المعلمات
name String: للمستخدم الذي يريد إنشاء حساب على الجهاز
guest boolean: تفعيل علامة المستخدم "--guest" أثناء الإنشاء
ephemeral ‫boolean: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء
المرتجعات
int رقم تعريف المستخدم الذي تم إنشاؤه
عمليات الرمي
DeviceNotAvailableException

createUser

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

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

المعلمات
name String: للمستخدم الذي يريد إنشاء حساب على الجهاز
guest boolean: تفعيل علامة المستخدم "--guest" أثناء الإنشاء
ephemeral ‫boolean: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء
forTesting boolean: تفعيل علامة الاختبار --for-testing أثناء الإنشاء
المرتجعات
int رقم تعريف المستخدم الذي تم إنشاؤه
عمليات الرمي
DeviceNotAvailableException

createUser

public int createUser (String name)

أنشئ مستخدمًا باسم معيّن وعلامات تلقائية 0.

المعلمات
name String: للمستخدم الذي يريد إنشاء حساب على الجهاز
المرتجعات
int عدد صحيح لرقم تعريف المستخدم الذي تم إنشاؤه
عمليات الرمي
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

أنشئ مستخدمًا باسم معيّن وعلامات تلقائية 0.

المعلمات
name String: للمستخدم الذي يريد إنشاء حساب على الجهاز
المرتجعات
int عدد صحيح لرقم تعريف المستخدم الذي تم إنشاؤه أو -1 للخطأ
عمليات الرمي
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

المعلمات
deviceFilePath String: المسار المطلق للملف على الجهاز
userId int: رقم تعريف المستخدم المطلوب حذفه منه
عمليات الرمي
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath)

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

المعلمات
deviceFilePath String: المسار المطلق للملف على الجهاز
عمليات الرمي
DeviceNotAvailableException

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

لإزالة IDeviceActionReceiver المسجَّل.

المعلمات
deviceActionReceiver ‫IDeviceActionReceiver: IDeviceActionReceiver التي ستتم إزالتها

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

المعلمات
prevSystemServerProcess ProcessInfo: عملية system_server السابقة ProcessInfo.
المرتجعات
boolean true في حال إعادة تشغيل الجهاز من خلال إعادة التشغيل الناعم
عمليات الرمي
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

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

المعلمات
utcEpochTime ‫long: وقت الجهاز بالثواني منذ بدء حساب الفترة
timeUnit TimeUnit: وحدة الوقت TimeUnit لـ utcEpochTime المحدّد
المرتجعات
boolean true في حال إعادة تشغيل الجهاز من خلال إعادة التشغيل الناعم
عمليات الرمي
DeviceNotAvailableException

disableAdbRoot

public boolean disableAdbRoot ()

إيقاف إذن الوصول إلى الجذر من خلال adb

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

المرتجعات
boolean true في حال نجاح العملية
عمليات الرمي
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

يحاول إيقاف شاشة القفل.

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

عمليات الرمي
DeviceNotAvailableException

disableNetworkMonitor

public boolean disableNetworkMonitor ()

يُوقف ميزة مراقبة الشبكة على الجهاز.

المرتجعات
boolean true إذا تم إيقاف ميزة "التتبُّع" بنجاح false في حال تعذّر ذلك.
عمليات الرمي
DeviceNotAvailableException

disconnectFromWifi

public boolean disconnectFromWifi ()

قطع الاتصال بشبكة Wi-Fi

يؤدي هذا الإجراء إلى إزالة جميع الشبكات من قائمة الشبكات المعروفة وإيقاف شبكة Wi-Fi.

المرتجعات
boolean true في حال انقطاع الاتصال بشبكة Wi-Fi بنجاح false إذا تعذّر قطع الاتصال.
عمليات الرمي
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

المعلمات
deviceFilePath String: المسار المطلق للملف على الجهاز المطلوب التحقّق منه
userId int: رقم تعريف المستخدم الذي يتم التحقّق من توفّر الملف وفقًا له
المرتجعات
boolean true إذا كان الملف متوفّرًا، false في حال عدم توفّره
عمليات الرمي
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

المعلمات
deviceFilePath String: المسار المطلق للملف على الجهاز المطلوب التحقّق منه
المرتجعات
boolean true إذا كان الملف متوفّرًا، false في حال عدم توفّره
عمليات الرمي
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

المعلمات
process String: اسم عملية الجهاز التي يتم تشغيل dumpheap عليها.
devicePath ‫String: المسار على الجهاز الذي سيتم وضع ملف الترميز فيه يجب أن يكون هذا الموقع الجغرافي مكانًا يسمح فيه الأذونات بذلك.
المرتجعات
File ERROR(/File) التي تحتوي على التقرير قيمة فارغة إذا حدث خطأ.
عمليات الرمي
DeviceNotAvailableException

enableAdbRoot

public boolean enableAdbRoot ()

تفعيل إذن الوصول إلى الجذر من خلال adb إذا كان الإعداد "enable-root" هو "false"، سيتم تسجيل رسالة و الرجوع بدون تفعيل إذن الوصول إلى الجذر.

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

المرتجعات
boolean true في حال نجاح العملية
عمليات الرمي
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

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

المرتجعات
boolean true إذا تم تفعيل ميزة التتبُّع بنجاح false في حال تعذّر ذلك.
عمليات الرمي
DeviceNotAvailableException

executeAdbCommand

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

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

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

المعلمات
timeout ‫long: الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، 0L لعدم تحديد مهلة
cmdArgs String: أمر adb والوسيطات المطلوب تنفيذها
المرتجعات
String stdout من الأمر null إذا تعذّر تنفيذ الأمر.
عمليات الرمي
DeviceNotAvailableException

executeAdbCommand

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

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

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

المعلمات
timeout ‫long: الوقت بالمللي ثانية قبل اعتبار الجهاز غير مستجيب، 0L لعدم تحديد مهلة
envMap : البيئة المطلوب ضبطها للطلب
cmdArgs String: أمر adb والوسيطات المطلوب تنفيذها
المرتجعات
String stdout من الأمر null إذا تعذّر تنفيذ الأمر.
عمليات الرمي
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

المعلمات
cmdArgs String: أمر adb والوسيطات المطلوب تنفيذها
المرتجعات
String stdout من الأمر null إذا تعذّر تنفيذ الأمر.
عمليات الرمي
DeviceNotAvailableException

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

المعلمات
cmdArgs String: أمر fastboot والوسيطات المطلوب تنفيذها
المرتجعات
CommandResult نتيجة الأمر التي تحتوي على ناتج الأمر
عمليات الرمي
DeviceNotAvailableException

executeFastbootCommand

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

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

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

المعلمات
timeout ‫long: الوقت بالملي ثانية قبل انتهاء صلاحية الطلب
cmdArgs String: أمر fastboot والوسيطات المطلوب تنفيذها
المرتجعات
CommandResult نتيجة الأمر التي تحتوي على ناتج الأمر
عمليات الرمي
DeviceNotAvailableException

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

المعلمات
cmdArgs String: أمر fastboot والوسيطات المطلوب تنفيذها
المرتجعات
CommandResult نتيجة الأمر التي تحتوي على ناتج الأمر
عمليات الرمي
DeviceNotAvailableException

executeLongFastbootCommand

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

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

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

المعلمات
envVarMap : متغيّرات بيئة النظام التي يتم تشغيل أمر fastboot بها
cmdArgs String: أمر fastboot والوسيطات المطلوب تنفيذها
المرتجعات
CommandResult نتيجة الأمر التي تحتوي على ناتج الأمر
عمليات الرمي
DeviceNotAvailableException

executeShellCommand

public String executeShellCommand (String command)

طريقة مساعدة تنفِّذ أمر adb shell وتُعرِض الإخراج كString.

المعلمات
command String: أمر adb shell المطلوب تنفيذه
المرتجعات
String ناتج shell
عمليات الرمي
DeviceNotAvailableException

executeShellCommand

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

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

المعلمات
command String: أمر adb shell المطلوب تنفيذه
receiver ‫IShellOutputReceiver: IShellOutputReceiver لتوجيه إخراج shell إليه.
maxTimeToOutputShellResponse ‫long: الحد الأقصى للوقت الذي يُسمح فيه للأمر بعدم عرض أي استجابة، والوحدة كما هو موضّح في timeUnit
timeUnit TimeUnit: وحدة maxTimeToOutputShellResponse
retryAttempts ‫int: الحد الأقصى لعدد المرات التي يمكن فيها إعادة محاولة تنفيذ الأمر في حال تعذّر تنفيذه بسبب خطأ سيتم طرح DeviceNotResponsiveException إذا لم يتم تنفيذ retryAttempts بنجاح.
عمليات الرمي
DeviceNotAvailableException

executeShellCommand

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

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

المعلمات
command String: أمر adb shell المطلوب تنفيذه
receiver ‫IShellOutputReceiver: IShellOutputReceiver لتوجيه إخراج shell إليه.
maxTimeoutForCommand long: الحد الأقصى لمهلة إكمال الأمر، وحدته كما هو موضّح في timeUnit
maxTimeToOutputShellResponse ‫long: الحد الأقصى للوقت الذي يُسمح فيه للأمر بعدم عرض أي استجابة، والوحدة كما هو موضّح في timeUnit
timeUnit TimeUnit: وحدة maxTimeToOutputShellResponse
retryAttempts ‫int: الحد الأقصى لعدد المرات التي يمكن فيها إعادة محاولة تنفيذ الأمر في حال تعذّر تنفيذه بسبب استثناء سيتم طرح DeviceNotResponsiveException إذا تم تنفيذ retryAttempts بدون نجاح.
عمليات الرمي
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

تنفيذ أمر shell adb المحدَّد، مع إعادة المحاولة عدة مرات في حال تعذّر تنفيذ الأمر

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

المعلمات
command String: أمر adb shell المطلوب تنفيذه
receiver ‫IShellOutputReceiver: IShellOutputReceiver لتوجيه إخراج shell إليه.
عمليات الرمي
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

طريقة مساعدة تنفِّذ أمر adb shell وتُعيد النتائج كقائمة CommandResult مملوءة بشكل صحيح بمخرجات حالة الأمر وstdout وstderr.

المعلمات
cmd String: الأمر الذي يجب تنفيذه.
المرتجعات
CommandResult النتيجة باللغة CommandResult.
عمليات الرمي
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

طريقة مساعدة تنفِّذ أمرًا في shell adb وتُعيد النتائج كسلسلة CommandResult تم تعبئتها بشكل صحيح بإخراج حالة الأمر وstderr. يتم توجيه stdout إلى البث المحدّد.

المعلمات
cmd String: الأمر الذي يجب تنفيذه.
pipeToOutput OutputStream: ERROR(/OutputStream) حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة الخالية.
المرتجعات
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: الحد الأقصى لعدد المرات التي يمكن فيها إعادة محاولة تنفيذ الأمر في حال تعذّر تنفيذه بسبب استثناء سيتم طرح DeviceNotResponsiveException إذا تم تنفيذ retryAttempts بدون نجاح.
المرتجعات
CommandResult

عمليات الرمي
DeviceNotAvailableException

executeShellV2Command

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

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

المعلمات
cmd String: أمر adb shell المطلوب تنفيذه
maxTimeoutForCommand long: الحد الأقصى لمهلة إكمال الأمر، وحدته كما هو موضّح في timeUnit
timeUnit TimeUnit: وحدة maxTimeToOutputShellResponse
المرتجعات
CommandResult

عمليات الرمي
DeviceNotAvailableException

executeShellV2Command

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

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

المعلمات
cmd String: أمر adb shell المطلوب تنفيذه
pipeAsInput File: ERROR(/File) التي سيتم توجيهها كمدخل إلى الأمر، أو قيمة فارغة
pipeToOutput OutputStream: ERROR(/OutputStream) حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة الخالية.
maxTimeoutForCommand long: الحد الأقصى لمهلة إكمال الأمر، وحدته كما هو موضّح في timeUnit
timeUnit TimeUnit: وحدة maxTimeToOutputShellResponse
retryAttempts ‫int: الحد الأقصى لعدد المرات التي يمكن فيها إعادة محاولة تنفيذ الأمر في حال تعذّر تنفيذه بسبب استثناء سيتم طرح DeviceNotResponsiveException إذا تم تنفيذ retryAttempts بدون نجاح.
المرتجعات
CommandResult

عمليات الرمي
DeviceNotAvailableException

executeShellV2Command

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

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

المعلمات
cmd String: أمر adb shell المطلوب تنفيذه
pipeAsInput File: ERROR(/File) التي سيتم توجيهها كمدخل إلى الأمر، أو قيمة فارغة
pipeToOutput OutputStream: ERROR(/OutputStream) حيث سيتم إعادة توجيه الإخراج العادي، أو القيمة الخالية.
pipeToError OutputStream: ERROR(/OutputStream) حيث سيتم إعادة توجيه الخطأ العادي، أو القيمة الخالية.
maxTimeoutForCommand long: الحد الأقصى لمهلة إكمال الأمر، وحدته كما هو موضّح في timeUnit
timeUnit TimeUnit: وحدة maxTimeToOutputShellResponse
retryAttempts ‫int: الحد الأقصى لعدد المرات التي يمكن فيها إعادة محاولة تنفيذ الأمر في حال تعذّر تنفيذه بسبب استثناء سيتم طرح DeviceNotResponsiveException إذا تم تنفيذ retryAttempts بدون نجاح.
المرتجعات
CommandResult

عمليات الرمي
DeviceNotAvailableException

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

المعلمات
partition String: قسم القرص المطلوب محو بياناته
المرتجعات
CommandResult نتيجة الأمر التي تحتوي على ناتج الأمر
عمليات الرمي
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

جلب المعلومات عن حسابات APEX التي تم تفعيلها على الجهاز

المرتجعات
ERROR(/Set) من ApexInfo رمز مُفعَّل حاليًا على الجهاز
عمليات الرمي
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

عرض أزواج مفتاح/قيمة للمساحة الاسمية المطلوبة

المعلمات
namespace String: يجب أن يكون أحد الخيارات التالية: {"system", "secure", "global"}
المرتجعات
خريطة أزواج المفتاح/القيمة قيمة فارغة إذا لم تكن مساحة الاسم متاحة.
عمليات الرمي
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

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

المرتجعات
DeviceAllocationState

getAndroidId

public String getAndroidId (int userId)

العثور على معرّف android المرتبط بمعرّف مستخدم وعرضه، أو عرض قيمة فارغة في حال عدم العثور عليه

المعلمات
userId int

المرتجعات
String

عمليات الرمي
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

أنشئ خريطة لمعرّفات Android التي تم العثور عليها والتي تتطابق مع معرّفات المستخدمين. ما مِن ضمان بأنّ كل معرّف مستخدم سيعثر على معرّف android مرتبط في هذه الدالة، لذا قد تتطابق بعض معرّفات المستخدمين مع القيمة null.

المرتجعات
خريطة أرقام تعريف Android التي تم العثور عليها مطابقة لأرقام تعريف المستخدمين
عمليات الرمي
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

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

المرتجعات
int عدد صحيح يشير إلى مستوى واجهة برمجة التطبيقات للجهاز
عمليات الرمي
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

المعلمات
packageName String

المرتجعات
PackageInfo PackageInfo أو null في حال تعذّر استرداد المعلومات
عمليات الرمي
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

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

المرتجعات
ERROR(/List) من PackageInfo مثبّتة على الجهاز
عمليات الرمي
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

طريقة سهلة للحصول على إصدار النطاق الأساسي (الراديو) لهذا الجهاز يعتمد الحصول على إصدار الراديو على الجهاز، لذا قد لا يعرض المعلومات الصحيحة لجميع الأجهزة. تعتمد هذه الطريقة على السمة gsm.version.baseband لعرض معلومات الإصدار الصحيحة. لا يكون هذا الإجراء دقيقًا لبعض أجهزة CDMA، وقد لا يتطابق الإصدار المعروض هنا مع الإصدار الذي تم الإبلاغ عنه من خلال Fastboot، وقد لا يعرض الإصدار الخاص بجهاز CDMA. النصّ المختصر: لا تُبلغ هذه الطريقة عن إصدار دقيق إلا إذا كانت قيمة السمة gsm.version.baseband هي نفسها القيمة التي تُرجعها fastboot getvar version-baseband.

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

getBattery

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

public  getBootHistory ()

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

المرتجعات
خريطة لوقت التمهيد (التوقيت العالمي المنسق بالثواني منذ بدء حساب الفترة) وسبب التمهيد
عمليات الرمي
DeviceNotAvailableException

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

تجمع طريقة المساعدة خريطة سجلّ التشغيل مع وقت التشغيل وسبب التشغيل منذ المدّة المحدّدة منذ بدء حساب الوقت من الجهاز ووحدة الوقت المحدّدة. يمكن الحصول على utcEpochTime الحالي للجهاز بالمللي ثانية باستخدام الطريقة getDeviceDate().

المعلمات
utcEpochTime ‫long: وقت الجهاز منذ بداية حساب الفترة
timeUnit ‫TimeUnit: الوحدة الزمنية TimeUnit.
المرتجعات
خريطة لوقت التمهيد (التوقيت العالمي المنسق بالثواني منذ بدء حساب الفترة) وسبب التمهيد
عمليات الرمي
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

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

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

المرتجعات
String إصدار برنامج الإقلاع String أو null في حال تعذّر العثور عليه
عمليات الرمي
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

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

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

المرتجعات
InputStreamSource InputStreamSource الذي سينشئ محتوى تقرير الأخطاء عند الطلب في حال حدوث خطأ، سينتج عن InputStreamSource ERROR(/InputStream) فارغ.

getBugreportz

public InputStreamSource getBugreportz ()

استرداد تقرير أخطاء من الجهاز يحتوي تقرير الأخطاء بتنسيق Zip على تقرير الأخطاء الرئيسي وملفّات سجلّ أخرى مفيدة لتصحيح الأخطاء.

لا تتوفّر هذه الميزة إلا لإصدار "adb" الأحدث من 1.0.36.

المرتجعات
InputStreamSource InputStreamSource من ملف zip الذي يحتوي على bugreportz، يُرجى عرض قيمة فارغة في حال حدوث خطأ.

getBuildAlias

public String getBuildAlias ()

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

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

المرتجعات
String الاسم المعرِّف للإصدار أو الرجوع إلى رقم تعريف الإصدار في حال تعذّر استرجاعه
عمليات الرمي
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

استرداد نوع الإصدار للجهاز

المرتجعات
String نكهة الإصدار أو القيمة null إذا تعذّر استردادها
عمليات الرمي
DeviceNotAvailableException

getBuildId

public String getBuildId ()

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

المرتجعات
String معرّف الإصدار أو IBuildInfo.UNKNOWN_BUILD_ID إذا تعذّر استرجاعه
عمليات الرمي
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

المرتجعات
String مفتاح التوقيع إذا تم العثور عليه، وقيمة فارغة بخلاف ذلك
عمليات الرمي
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

تعرِض هذه السمة قيمة DeviceDescriptor المخزّنة مؤقتًا في حال تم تخصيص الجهاز، وتعرِض DeviceDescriptor الحالية في حال عدم تخصيص الجهاز.

المرتجعات
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

تعرِض هذه السمة قيمة DeviceDescriptor محفوظة في ذاكرة التخزين المؤقت إذا تم تخصيص الجهاز، وتعرِض DeviceDescriptor الحالية في حال عدم تخصيص الجهاز.

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

getChildren

public String[] getChildren (String path)

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

المعلمات
path ‫String: هو المسار على الجهاز الذي سيتم فيه إجراء البحث.
المرتجعات
String[] صفيف من السلاسل يحتوي على كل الملف في مسار على الجهاز
عمليات الرمي
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

عملية الربط الحالية المرتبطة بالجهاز

المرتجعات
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

تعرِض القيمة ContentProviderHandler أو قيمة فارغة إذا لم تكن متاحة.

يمكن إعادة استخدام مقدّم المحتوى إذا تم إنشاؤه من قبل باستخدام userId نفسه.

المعلمات
userId ‫int: رقم تعريف المستخدم لبدء موفِّر المحتوى
المرتجعات
ContentProviderHandler

عمليات الرمي
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

المرتجعات
DeviceFoldableState

عمليات الرمي
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

عرض رقم تعريف المستخدم الحالي في حال حدوث خطأ، يتم عرض القيمة -10000.

المرتجعات
int

عمليات الرمي
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

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

المرتجعات
String فئة جهاز String

getDeviceDate

public long getDeviceDate ()

عرض تاريخ الجهاز بالمللي ثانية منذ تاريخ بدء حساب الفترة

المرتجعات
long تاريخ الجهاز بتنسيق بدء الفترة
عمليات الرمي
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

المرتجعات
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

getDeviceState

public TestDeviceState getDeviceState ()

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

المرتجعات
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

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

المعلمات
date Date

المرتجعات
long الفرق بالملي ثانية
عمليات الرمي
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

الحصول على بث stdout وstderr للمحاكي

المرتجعات
InputStreamSource ناتج المحاكي

getEmulatorProcess

public Process getEmulatorProcess ()

عرض القيمة Process الخاصة بهذا المحاكي

المرتجعات
Process Process أو null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

المرتجعات
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

المرتجعات
long مقدار المساحة الفارغة بالكيلوبايت
عمليات الرمي
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

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

المرتجعات
String

getFastbootProductType

public String getFastbootProductType ()

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

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

المرتجعات
String اسم نوع المنتج String أو null في حال تعذّر تحديده
عمليات الرمي
DeviceNotAvailableException

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

المرتجعات
String اسم نوع المنتج String أو null في حال تعذّر تحديده
عمليات الرمي
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

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

المرتجعات
String

getFastbootVariable

public String getFastbootVariable (String variableName)

استرداد قيمة متغيّر fastboot المحدَّدة من الجهاز

المعلمات
variableName String: اسم المتغيّر
المرتجعات
String قيمة السمة أو null في حال عدم توفّرها
عمليات الرمي
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

لعرض سلسلة الإصدار الخاصة بالملف الثنائي لـ fastboot الذي يتم استخدامه. أو فارغة إذا حدث خطأ

المرتجعات
String

getFileEntry

public IFileEntry getFileEntry (String path)

استرداد مرجع لملف عن بُعد على الجهاز

المعلمات
path String: مسار الملف المطلوب استرجاعه يمكن أن يكون مسارًا مطلقًا أو مسارًا نسبيًا إلى "/". (أي يمكن استخدام البنية "‎/system" و "system")
المرتجعات
IFileEntry IFileEntry أو null إذا تعذّر العثور على الملف في path المحدّد
عمليات الرمي
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

مساعد غير رسمي للحصول على FileEntry من مسار غير جذر FIXME: إعادة صياغة نظام FileEntry لإتاحته من أي مسار (حتى إذا لم يكن لديك إذن الوصول إلى الجذر).

المعلمات
entry FileListingService.FileEntry: لا يُشترط أن يكون FileEntry الجذر كما تتطلّب Ddmlib.
المرتجعات
IFileEntry عنصر FileEntryWrapper يمثّل FileEntry
عمليات الرمي
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

عرض قائمة حالات الجهاز القابلة للطي يمكن الحصول عليها باستخدام "cmd device_state print-states".

المرتجعات
عمليات الرمي
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

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

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

المرتجعات
IDevice IDevice

getInstalledPackageNames

public  getInstalledPackageNames ()

جلب أسماء حِزم التطبيقات المتوفّرة على الجهاز

المرتجعات
ERROR(/Set) من String أسماء الحِزم المثبَّتة حاليًا على الجهاز
عمليات الرمي
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

لعرض القيمة الصحيحة للسمة المحدّدة من الجهاز.

المعلمات
name String: اسم السمة
defaultValue ‫long: القيمة التلقائية التي يتم عرضها إذا كانت السمة فارغة أو غير متوفّرة
المرتجعات
long قيمة السمة أو defaultValue إذا كانت السمة فارغة أو غير متوفّرة أو لا تحتوي على قيمة عددية
عمليات الرمي
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

الحصول على عنوان IP للجهاز

المرتجعات
String عنوان IP للجهاز، أو null إذا لم يكن للجهاز عنوان IP
عمليات الرمي
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

عرض عنصر للحصول على الحالة الحالية لقفل الشاشة أو عرض قيمة فارغة إذا لم يكن متاحًا

المرتجعات
KeyguardControllerState KeyguardControllerState يحتوي على لقطة شاشة لحالة شاشة القفل ويعرض القيمة Null إذا لم يكن طلب البحث عن شاشة القفل متوافقًا.
عمليات الرمي
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

المرتجعات
long

getLaunchApiLevel

public int getLaunchApiLevel ()

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

المرتجعات
int عدد صحيح يشير إلى أول مستوى واجهة برمجة تطبيقات تم تشغيله على الجهاز
عمليات الرمي
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

تلتقط هذه الأداة لقطة سريعة لبيانات logcat.

يعمل هذا الإجراء بطريقتَين:

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

    المرتجعات
    InputStreamSource

    • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

    تلتقط هذه الأداة لقطات من آخر maxBytes من بيانات logcat التي تم تسجيلها.

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

    المعلمات
    maxBytes int: الحد الأقصى للبيانات التي سيتم عرضها يجب أن يكون الحجم مناسبًا ليتم تخزينه في الذاكرة
    المرتجعات
    InputStreamSource

    getLogcatDump

    public InputStreamSource getLogcatDump ()

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

    يتمثل عُدم التوافق في أنّه لن يتم عرض أي معلومات إذا لم يكن بالإمكان الوصول إلى الجهاز.

    المرتجعات
    InputStreamSource InputStreamSource من بيانات logcat يتم عرض مصدر بيانات فارغ في حال تعذّر تسجيل بيانات logcat.

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

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

    المعلمات
    date ‫long: بالملي ثانية منذ تاريخ بدء حساب الفترة، وهو وقت بدء اللقطة حتى الوقت الحالي (يمكن الحصول عليها باستخدام "date +%s")
    المرتجعات
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

    تعرِض هذه السمة عنوان MAC للجهاز، وتكون قيمة هذه السمة فارغة إذا تعذّر إجراء طلب بحث من الجهاز.

    المرتجعات
    String

    getMainUserId

    public Integer getMainUserId ()

    تعرِض هذه السمة رقم تعريف المستخدم الرئيسي.

    المرتجعات
    Integer userId للمستخدم الرئيسي إذا كان هناك مستخدم رئيسي، وقيمة فارغة إذا لم يكن هناك مستخدم رئيسي
    عمليات الرمي
    DeviceNotAvailableException

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

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

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

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

    الحصول على الحد الأقصى لعدد المستخدمين المسموح لهم بالتشغيل المتزامن القيمة التلقائية هي 0.

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

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported ()

    الحصول على الحد الأقصى لعدد المستخدمين المتوافقين القيمة التلقائية هي 0.

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

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

    المرتجعات
    Process تعرِض هذه السمة عملية جهاز Microdroid الافتراضي. إذا لم يكن TestDevice جهاز Microdroid، يتم إرجاع قيمة فارغة.

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    عرض IDeviceStateMonitor المرتبط بالجهاز

    المرتجعات
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    لعرض نقطة تثبيت.

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

    TODO: move this behavior to IDevice.getMountPoint(String)

    المعلمات
    mountName String: اسم نقطة التثبيت
    المرتجعات
    String نقطة التثبيت أو null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    عرض MountPointInfo مقابل مسار نقطة التثبيت المحدّد، أو null إذا لم يتم تثبيت أي عنصر في هذا المسار أو إذا لم يظهر في ‎/proc/mounts كنقطة تثبيت

    المعلمات
    mountpoint String

    المرتجعات
    ITestDevice.MountPointInfo ERROR(/List) من MountPointInfo يحتوي على المعلومات الواردة في "‎/proc/mounts"
    عمليات الرمي
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

    لعرض نسخة مفسَّرة من المعلومات في ‎ /proc/mounts على الجهاز

    المرتجعات
    ERROR(/List) من MountPointInfo يحتوي على المعلومات الواردة في "‎/proc/mounts"
    عمليات الرمي
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

    استرجاع خيارات الاختبار للجهاز

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

    getPartitionFreeSpace

    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 يحتوي على رقم تعريف العملية ووقت بدء العملية المحدّدة.

    المعلمات
    processName String: سلسلة اسم العملية
    المرتجعات
    ProcessInfo ProcessInfo من processName المحدَّد
    عمليات الرمي
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

    تعرِض هذه الدالة رقم تعريف العملية للخدمة أو قيمة فارغة إذا حدث خطأ.

    المعلمات
    process String: سلسلة اسم العملية
    المرتجعات
    String

    عمليات الرمي
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

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

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

    المرتجعات
    String اسم نوع المنتج String لن تكون فارغة
    عمليات الرمي
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

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

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

    المرتجعات
    String اسم خيار المنتج String أو null إذا تعذّر تحديده

    عمليات الرمي
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    استرداد قيمة السمة المحدّدة من الجهاز

    المعلمات
    name String: اسم السمة
    المرتجعات
    String قيمة السمة أو null في حال عدم توفّرها
    عمليات الرمي
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

    يلتقط لقطة شاشة من الجهاز الذي تم تحديد معرّف العرض له. التنسيق هو PNG.

    TODO: توسيع نطاق عمليات التنفيذ أعلاه لتتوافق مع "التنسيق" و"إعادة الحجم"

    المعلمات
    displayId ‫long: معرّف العرض للشاشة التي تريد الحصول على لقطة شاشة منها.
    المرتجعات
    InputStreamSource InputStreamSource من لقطة الشاشة بتنسيق png أو null إذا لم تنجح لقطة الشاشة
    عمليات الرمي
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format)

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

    المعلمات
    format String: تنسيقات PNG وJPEG المتوافقة
    المرتجعات
    InputStreamSource InputStreamSource لقطة الشاشة بالتنسيق، أو null إذا لم تنجح عملية التقاط لقطة الشاشة
    عمليات الرمي
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

    المعلمات
    format String: تنسيقات PNG وJPEG المتوافقة
    rescale boolean: إذا كان يجب إعادة تغيير حجم لقطة الشاشة لتقليل حجم الصورة الناتجة
    المرتجعات
    InputStreamSource InputStreamSource من لقطة الشاشة بتنسيق png أو null إذا لم تنجح لقطة الشاشة
    عمليات الرمي
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot ()

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

    المرتجعات
    InputStreamSource InputStreamSource لقطة شاشة بتنسيق png، أو null إذا لم تنجح لقطة الشاشة
    عمليات الرمي
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

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

    المرتجعات
    String الرقم التسلسلي String

    getSetting

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

    عرض قيمة الإعداد المطلوب يجب أن تكون مساحة الاسم إحدى القيم التالية: {"system", "secure", "global"}

    المعلمات
    userId int

    namespace String

    key String

    المرتجعات
    String القيمة المرتبطة بـ namespace:key الخاصة بمستخدم قيمة فارغة إذا لم يتم العثور على القيمة
    عمليات الرمي
    DeviceNotAvailableException

    getSetting

    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 أو القيمة null إذا لم تكن متاحة أو لم يكن الجهاز متاحًا

    المرتجعات
    String

    getTombstones

    public  getTombstones ()

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

    الطريقة هي أفضل جهد، لذا إذا تعذّر سحب ملف واحد من ملفات السجلّ المؤقت لأي سبب، لن يظهر في القائمة. ولن تؤدي سوى DeviceNotAvailableException إلى إنهاء الأسلوب مبكرًا.

    المرتجعات
    قائمة بملفات الإشارات إلى الملفات المحذوفة، تكون فارغة إذا لم يكن هناك ملف إشارة إلى الملف المحذوفة
    عمليات الرمي
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

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

    المرتجعات
    long

    getTrackingSerial

    public String getTrackingSerial ()

    لأغراض إدارة الجهاز، احصل على الرقم التسلسلي المستخدَم لتتبُّع الجهاز.

    المرتجعات
    String

    getUninstallablePackageNames

    public  getUninstallablePackageNames ()

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

    المرتجعات
    ERROR(/Set) من أسماء حِزم String غير القابلة للإزالة المثبَّتة حاليًا على الجهاز
    عمليات الرمي
    DeviceNotAvailableException

    getUseFastbootErase

    public boolean getUseFastbootErase ()

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

    المرتجعات
    boolean true إذا كان سيتم استخدام ميزة "محو البيانات" من خلال Fastboot أو false إذا كان سيتم استخدام ميزة "تنسيق الجهاز" من خلال Fastboot

    getUserFlags

    public int getUserFlags (int userId)

    العثور على الإشعارات التي أرسلها مستخدم معيّن وإرجاعها يتم تعريف العلامات في فئة "android.content.pm.UserInfo" في "مشروع Android المفتوح المصدر".

    المعلمات
    userId int

    المرتجعات
    int الإشارات المرتبطة بمعرّف المستخدم المقدَّم في حال العثور عليه، أو -10000 في أي حالات أخرى
    عمليات الرمي
    DeviceNotAvailableException

    getUserInfos

    public  getUserInfos ()

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

    المرتجعات
    قائمة عناصر UserInfo
    عمليات الرمي
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

    عرض الرقم التسلسلي المرتبط بمعرّف المستخدم في حال العثور عليه، أو -10000 في أي حالات أخرى

    المعلمات
    userId int

    المرتجعات
    int

    عمليات الرمي
    DeviceNotAvailableException

    handleAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    معالجة DeviceEvent المحدّد قد يؤدي ذلك إلى نقل الجهاز إلى حالة جديدة. سيتم إبلاغ IDeviceMonitor بأي انتقالات للحالة.

    عالج حدث DeviceEvent الذي قد يؤدي إلى نقل هذا الجهاز إلى حالة تخصيص جديدة أو قد لا يؤدي إلى ذلك.

    المعلمات
    event DeviceEvent

    المرتجعات
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    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

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    المرتجعات
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

    التحقّق مما إذا كانت المنصة على الجهاز تتيح إدراج التطبيقات

    المرتجعات
    boolean صحيح إذا كان إدراج التطبيقات متاحًا، خطأ بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

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

    المرتجعات
    boolean صحيح إذا كان من الممكن تجاوز حظر حزمة تطوير البرامج المخصّصة للأجهزة ذات الإصدارات القديمة، خطأ بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    تحقَّق مما إذا كان قد تم تركيب debugfs.

    المرتجعات
    boolean true في حال تركيب debugfs
    عمليات الرمي
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

    يعرض ما إذا كان الجهاز مشفَّرًا.

    المرتجعات
    boolean true إذا كان الجهاز مشفَّرًا
    عمليات الرمي
    DeviceNotAvailableException

    isDirectory

    public boolean isDirectory (String path)

    عرض True إذا كان المسار على الجهاز دليلاً، وعرض False في غير ذلك

    المعلمات
    path String

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isEnableAdbRoot

    public boolean isEnableAdbRoot ()

    المرتجعات
    boolean true إذا كان يجب تفعيل إذن الوصول إلى الجذر من adb على الجهاز

    isEncryptionSupported

    public boolean isEncryptionSupported ()

    يعرض ما إذا كان التشفير متاحًا على الجهاز.

    المرتجعات
    boolean true إذا كان الجهاز يتيح التشفير
    عمليات الرمي
    DeviceNotAvailableException

    isExecutable

    public boolean isExecutable (String fullPath)

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

    المعلمات
    fullPath String

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

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

    المرتجعات
    boolean

    isHeadless

    public boolean isHeadless ()

    عرض true إذا كان الجهاز غير مزوّد بشاشة (بدون شاشة)، وعرض false في الحالات الأخرى

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

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

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

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

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isMultiUserSupported

    public boolean isMultiUserSupported ()

    لتحديد ما إذا كان استخدام حسابات متعدّدة مسموحًا به

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

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

    isPackageInstalled

    public boolean isPackageInstalled (String packageName)

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

    المعلمات
    packageName String

    المرتجعات
    boolean صحيح إذا تم الإبلاغ عن الحزمة على أنّها مثبّتة. خطأ بخلاف ذلك.
    عمليات الرمي
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

    التحقّق مما إذا كانت المنصة على الجهاز تتيح منح أذونات التشغيل

    المرتجعات
    boolean صحيح إذا كانت أذونات وقت التشغيل متاحة، وخطأ في الحالات الأخرى.
    عمليات الرمي
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

    تعرِض هذه الدالة القيمة true إذا كان الجهاز في وضع TestDeviceState.FASTBOOT أو TestDeviceState.FASTBOOTD.

    المرتجعات
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

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

    المعلمات
    userId int

    المرتجعات
    boolean صحيح إذا كان المستخدم يركض، خطأ في جميع الحالات الأخرى.
    عمليات الرمي
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

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

    المعلمات
    userId int

    المرتجعات
    boolean صحيح إذا كان المستخدم ثانويًا، خطأ بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

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

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

    المعلمات
    userId int

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

    للتحقّق مما إذا كان المستخدم المحدّد مرئيًا في العرض المحدّد

    المستخدِم "المرئي" هو مستخدِم يتفاعل مع المستخدِم "البشري"، وبالتالي يمكنه بدء أنشطة الإطلاق في هذا العرض.

    المعلمات
    userId int

    displayId int

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

    إذا كان الأمر كذلك، يمكنك استدعاء startVisibleBackgroundUser(int, int, boolean) مع تمرير شاشة يعرضها listDisplayIdsForStartingVisibleBackgroundUsers() (يجب أن يحتوي على ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

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

    إذا كان الأمر كذلك، يمكنك استدعاء startVisibleBackgroundUser(int, int, boolean) مع تمرير شاشة عرض يعرضها listDisplayIdsForStartingVisibleBackgroundUsers().

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    isWifiEnabled

    public boolean isWifiEnabled ()

    تحقَّق مما إذا كانت شبكة Wi-Fi مفعَّلة.

    للتحقّق مما إذا كان الاتصال بالإنترنت عبر شبكة Wi-Fi مفعّلاً على الجهاز يُعدّ هذا الإجراء مفيدًا للتأكّد من حالة شبكة Wi-Fi قبل إجراء الاختبارات التي لا يجب إجراؤها باستخدام شبكة Wi-Fi، مثل اختبارات بيانات الجوّال.

    المرتجعات
    boolean true إذا كانت شبكة Wi-Fi مفعّلة false إذا كانت غير مفعّلة
    عمليات الرمي
    DeviceNotAvailableException

    listDisplayIds

    public  listDisplayIds ()

    جمع قائمة أرقام تعريف الشاشات المتاحة على الجهاز كما هو موضّح في "dumpsys SurfaceFlinger"

    المرتجعات
    قائمة الشاشات يعرض الخيار التلقائي دائمًا القيمة التلقائية 0.
    عمليات الرمي
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    المرتجعات
    عمليات الرمي
    DeviceNotAvailableException

    listUsers

    public  listUsers ()

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

    المرتجعات
    قائمة أرقام تعريف المستخدمين
    عمليات الرمي
    DeviceNotAvailableException

    logAnrs

    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 صحيح إذا كان التسجيل ناجحًا، وخطأ في الحالات الأخرى.

    logOnDevice

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

    سجِّل رسالة في logcat للجهاز. هذه مكالمة آمنة لن يتم طرحها حتى إذا تعذّر التسجيل.

    المعلمات
    tag ‫String: العلامة التي نُسجِّل رسالتنا ضِمنها في logcat
    level Log.LogLevel: مستوى تصحيح الأخطاء للرسالة في logcat
    format String: تنسيق الرسالة
    args ‫Object: الوسيطات التي سيتم استبدالها من خلال String.format().

    mountDebugfs

    public void mountDebugfs ()

    شغِّل debugfs.

    عمليات الرمي
    DeviceNotAvailableException

    nonBlockingReboot

    public void nonBlockingReboot ()

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

    عمليات الرمي
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

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

    عمليات الرمي
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

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

    عمليات الرمي
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public void postBootSetup ()

    اتّبِع التعليمات لضبط الجهاز للاختبار بعد كل عملية تشغيل.

    يجب استدعاء هذه الوظيفة بعد تشغيل الجهاز بالكامل أو بعد أن يصبح متاحًا.

    في الحالات العادية، لا يلزم استدعاء هذه الطريقة بشكل صريح، لأنّه من المفترض أن تُجري عمليات التنفيذ هذه الخطوات تلقائيًا عند إعادة التشغيل.

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

    عمليات الرمي
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

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

    المعلمات
    exception Throwable: الاستثناء النهائي الذي تمّ طرحه بسبب تعذُّر الاستدعاء، إن توفّر.

    preInvocationSetup

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

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

    المعلمات
    info ‫IBuildInfo: IBuildInfo الجهاز
    attributes MultiMap: السمات المخزّنة في سياق الاستدعاء
    عمليات الرمي
    DeviceNotAvailableException
    TargetSetupError

    pullDir

    public boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

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

    المعلمات
    deviceFilePath String: المسار المطلق للملف في المصدر البعيد
    localDir File: الدليل المحلي الذي يتم سحب الملفات إليه
    userId int: رقم تعريف المستخدم المطلوب سحبه
    المرتجعات
    boolean true إذا تم سحب الملف بنجاح. false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                File localDir)

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

    المعلمات
    deviceFilePath String: المسار المطلق للملف في المصدر البعيد
    localDir File: الدليل المحلي الذي يتم نقل الملفات إليه
    المرتجعات
    boolean true إذا تم سحب الملف بنجاح. false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                File localFile)

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

    المعلمات
    remoteFilePath ‫String: المسار المطلق للملف على الجهاز
    localFile ‫File: الملف المحلي الذي يتم تخزين المحتوى فيه إذا لم تكن فارغة، سيتم استبدال المحتوى.
    المرتجعات
    boolean true إذا تم استرداد الملف بنجاح. false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                int userId)

    استرداد ملف من الجهاز وتخزينه في ERROR(/File) مؤقت على الجهاز، ثم عرضFile

    المعلمات
    remoteFilePath ‫String: المسار المطلق للملف على الجهاز
    userId int: رقم تعريف المستخدِم المطلوب سحبه
    المرتجعات
    File ERROR(/File) يحتوي على محتوى ملف الجهاز، أو null إذا تعذّر النسخ لأي سبب (بما في ذلك المشاكل في نظام الملفات المضيف)
    عمليات الرمي
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

    استرداد ملف من الجهاز وتخزينه في ERROR(/File) مؤقت على الجهاز، ثم إرجاع File

    المعلمات
    remoteFilePath ‫String: المسار المطلق للملف على الجهاز
    المرتجعات
    File ERROR(/File) يحتوي على محتوى ملف الجهاز، أو null إذا تعذّر النسخ لأي سبب (بما في ذلك المشاكل في نظام الملفات المضيف)
    عمليات الرمي
    DeviceNotAvailableException

    pullFile

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

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

    المعلمات
    remoteFilePath ‫String: المسار المطلق للملف على الجهاز
    localFile ‫File: الملف المحلي الذي يتم تخزين المحتوى فيه إذا لم تكن فارغة، سيتم استبدال المحتوى.
    userId int: رقم تعريف المستخدِم المطلوب سحبه
    المرتجعات
    boolean true إذا تم استرداد الملف بنجاح. false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

    استرداد ملف من الجهاز وعرض محتواه

    المعلمات
    remoteFilePath ‫String: المسار المطلق للملف على الجهاز
    المرتجعات
    String String يحتوي على محتوى ملف الجهاز، أو null إذا تعذّر النسخ لأي سبب (بما في ذلك مشاكل في نظام الملفات المضيف)
    عمليات الرمي
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

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

    المعلمات
    remoteFilePath ‫String: مسار الملف على الجهاز، بالنسبة إلى نقطة تثبيت مساحة التخزين الخارجية للجهاز
    المرتجعات
    File ERROR(/File) يحتوي على محتوى ملف الجهاز، أو null إذا تعذّر النسخ لأي سبب (بما في ذلك المشاكل في نظام الملفات المضيف)
    عمليات الرمي
    DeviceNotAvailableException

    pushDir

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

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

    المعلمات
    localFileDir File: الدليل المحلي المطلوب إرساله
    deviceFilePath String: المسار المطلق للملف في الوجهة البعيدة
    excludedDirectories : مجموعة من أسماء الدلائل المستبعَدة التي يجب عدم دفعها
    المرتجعات
    boolean true إذا تمّ تحميل الملف بنجاح. false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                String deviceFilePath)

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

    المعلمات
    localFileDir File: الدليل المحلي المطلوب إرساله
    deviceFilePath String: المسار المطلق للملف في الوجهة البعيدة
    المرتجعات
    boolean true إذا تمّ تحميل الملف بنجاح. false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

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

    المعلمات
    localFileDir File: الدليل المحلي المطلوب إرساله
    deviceFilePath String: المسار المطلق للملف في الوجهة البعيدة
    userId int: رقم تعريف المستخدم المطلوب نقل البيانات إليه
    المرتجعات
    boolean true إذا تمّ تحميل الملف بنجاح. false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    pushFile

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

    نوع من pushFile(File, String) يمكنه اختياريًا تقييم الحاجة لمقدّم المحتوى.

    المعلمات
    localFile File: الملف المحلي المطلوب إرساله
    remoteFilePath String: المسار المطلق للملف في الوجهة البعيدة
    evaluateContentProviderNeeded boolean: ما إذا كان علينا التحقّق مما إذا كنا بحاجة إلى مقدّم المحتوى
    المرتجعات
    boolean true إذا تمّ تحميل الملف بنجاح. false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                String remoteFilePath)

    أرسِل ملفًا إلى الجهاز. تلقائيًا باستخدام مقدّم محتوى

    المعلمات
    localFile File: الملف المحلي المطلوب إرساله
    remoteFilePath String: المسار المطلق للملف في الوجهة البعيدة
    المرتجعات
    boolean true إذا تمّ تحميل الملف بنجاح. false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    pushFile

    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

    rebootIntoBootloader

    public void rebootIntoBootloader ()

    إعادة تشغيل الجهاز في وضع برنامج الإقلاع

    يتم حظر الجهاز إلى أن يصبح في وضع برنامج الإقلاع.

    عمليات الرمي
    DeviceNotAvailableException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

    تؤدي هذه العملية إلى إعادة تشغيل الجهاز في وضع fastbootd.

    يتم حظر الإجراء إلى أن يصبح الجهاز في وضع fastbootd.

    عمليات الرمي
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

    تؤدي هذه العملية إلى إعادة تشغيل الجهاز في وضع الاسترداد من adb.

    يتم الحظر إلى أن يدخل الجهاز وضع الاسترداد

    عمليات الرمي
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

    إعادة تشغيل الجهاز في وضع "التثبيت من مصدر غير معروف" من خلال أداة adb (يُرجى العِلم أنّ هذا وضع خاص ضمن وضع الاسترداد)

    يتم الحظر إلى أن يدخل الجهاز في وضع "التثبيت من مصدر غير معروف".

    عمليات الرمي
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    إعادة تشغيل الجهاز في وضع "التثبيت من مصدر غير معروف" من خلال أداة adb (يُرجى العِلم أنّ هذا وضع خاص ضمن وضع الاسترداد)

    يتم الحظر إلى أن يدخل الجهاز في وضع "التثبيت من مصدر غير معروف".

    المعلمات
    autoReboot ‫boolean: ما إذا كان سيتم إعادة تشغيل الجهاز تلقائيًا بعد التثبيت من مصدر غير معروف
    عمليات الرمي
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

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

    عمليات الرمي
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

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

    المعلمات
    reason String: سبب إعادة التشغيل هذه، أو null في حال عدم تحديد سبب
    عمليات الرمي
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

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

    يتم الحظر إلى أن يصبح الجهاز متاحًا.

    تحذير: إنّ ميزة إعادة التشغيل في مساحة المستخدم قيد التطوير حاليًا، ويمكنك استخدامها على مسؤوليتك الخاصة.

    عمليات الرمي
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

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

    عمليات الرمي
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

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

    المرتجعات
    boolean صحيح إذا تمّت محاولة الاسترداد بنجاح، وخطأ إذا تمّ تخطّي الاسترداد
    عمليات الرمي
    DeviceNotAvailableException إذا لم يعُد الجهاز متاحًا

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    تسجيل IDeviceActionReceiver لهذا الجهاز

    سيتم إشعار جميع IDeviceActionReceiver المسجَّلة قبل بدء أحد إجراءات الجهاز وبعد انتهائه.

    المعلمات
    deviceActionReceiver ‫IDeviceActionReceiver: IDeviceActionReceiver الذي سيتم تسجيله

    remountSystemReadOnly

    public void remountSystemReadOnly ()

    اجعل قسم النظام على الجهاز للقراءة فقط. قد تتم إعادة تشغيل الجهاز.

    عمليات الرمي
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

    اجعل قسم النظام على الجهاز قابلاً للكتابة. قد تتم إعادة تشغيل الجهاز.

    عمليات الرمي
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

    اضبط قسم المورّد على الجهاز على "للقراءة فقط". قد تتم إعادة تشغيل الجهاز.

    عمليات الرمي
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

    اجعل قسم المورّد على الجهاز قابلاً للكتابة. قد تتم إعادة تشغيل الجهاز.

    عمليات الرمي
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                int userId)

    أزِل مشرف الجهاز المحدّد في المستخدم المحدّد وأعِد true في حال نجاح العملية، وfalse في حال عدم نجاحها.

    المعلمات
    componentName String: من مشرف الجهاز الذي سيتمّت إزالته.
    userId int: البلد الذي يقيم فيه مشرف الجهاز
    المرتجعات
    boolean صحيح إذا كان الإجراء ناجحًا، وخطأ في الحالات الأخرى.
    عمليات الرمي
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    يُرجى إزالة جميع مالكي الملفات الشخصية الحالية للأجهزة بأفضل ما يمكن.

    عمليات الرمي
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

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

    المعلمات
    userId int: للمستخدِم المطلوب إزالته
    المرتجعات
    boolean صحيح إذا نجحنا في إزالة المستخدم، وخطأ في حال عدم نجاحنا
    عمليات الرمي
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

    عليك إعادة ضبط علامة إعداد مقدّم المحتوى لتفعيلها مرة أخرى.

    runInstrumentationTests

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

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

    المعلمات
    runner ‫IRemoteAndroidTestRunner: IRemoteAndroidTestRunner الذي يُجري الاختبارات
    listeners ITestLifeCycleReceiver: أدوات معالجة نتائج الاختبار
    المرتجعات
    boolean true إذا اكتمل أمر الاختبار. false في حال تعذّر اكتمالها، ولكن تم استردادها بنجاح
    عمليات الرمي
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

    إذا انقطع الاتصال بالجهاز قبل اكتمال تشغيل الاختبار، ونجحت عملية الاسترداد، سيتم إبلاغ جميع المستمعين بخطأ testRunFailed وسيتم عرض القيمة "false". لن تتم إعادة تنفيذ الأمر test. على المتصلين إعادة المحاولة إذا لزم الأمر.

    في حال انقطاع الاتصال بالجهاز قبل اكتمال تشغيل الاختبار وتعذُّر الاسترداد، سيتم إبلاغ جميع المستمعين بخطأ testRunFailed وسيتم طرح DeviceNotAvailableException.

    المعلمات
    runner ‫IRemoteAndroidTestRunner: IRemoteAndroidTestRunner الذي يُجري الاختبارات
    listeners : أدوات معالجة نتائج الاختبار
    المرتجعات
    boolean true إذا اكتمل أمر الاختبار. false إذا تعذّر إكمالها بسبب استثناء في عملية التواصل مع الجهاز، ولكن تم استرداد البيانات بنجاح
    عمليات الرمي
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    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

    runInstrumentationTestsAsUser

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

    يشبه ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...) ولكنّه يُجري الاختبار لمستخدم معيّن.

    المعلمات
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    تحقِّق من استخدام IConfiguration.

    المعلمات
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    المعلمات
    avdInfo GceAvdInfo

    setDate

    public void setDate (Date date)

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

    ملاحظة: ضبط التاريخ على الجهاز يتطلب إذن الوصول إلى الجذر

    المعلمات
    date Date: تحديد تاريخ محدّد، سيتم استخدام تاريخ المضيف في حال null
    عمليات الرمي
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                int userId)

    ضبط مكوّن مشرف جهاز على أنّه مالك الجهاز في المستخدم المحدّد

    المعلمات
    componentName String: من مشرف الجهاز ليصبح مالك الجهاز
    userId int: البلد الذي يقيم فيه مالك الجهاز
    المرتجعات
    boolean صحيح إذا كان الإجراء ناجحًا، وخطأ في الحالات الأخرى.
    عمليات الرمي
    DeviceNotAvailableException

    setDeviceState

    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)

    اضبط خيار "التشغيل السريع" للجهاز. يجب ضبطه عند تخصيص الجهاز لأول مرة.

    المعلمات
    fastbootEnabled ‫boolean: ما إذا كان وضع Fastboot متاحًا للجهاز أم لا

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    تُستخدَم لضبط المسار إلى ملف fastboot الثنائي الذي يجب استخدامه. لا يزال مطلوبًا أن تكون قيمة isFastbootEnabled() صحيحة لتفعيل وظائف 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: التأخير بالملي ثانية

    setOptions

    public void setOptions (TestDeviceOptions options)

    ضبط TestDeviceOptions للجهاز

    المعلمات
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                String propValue)

    تُستخدَم لضبط قيمة السمة المحدّدة على الجهاز. يتطلب أن يكون adb root صحيحًا.

    المعلمات
    propKey String: المفتاح المستهدَف الذي سيتم ضبطه
    propValue String: قيمة السمة المطلوب ضبطها
    المرتجعات
    boolean تعرِض القيمة True إذا كان تنفيذ الأمر setprop ناجحًا، وتعرض False في حال عدم نجاحه.
    عمليات الرمي
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

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

    المعلمات
    recovery IDeviceRecovery: IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    تُستخدَم للتحكّم في طريقة الاسترداد التي يجب استخدامها عند مواجهة مشكلة في التواصل مع الجهاز. ننصح باستخدام هذه الطريقة بشكل مقتصد عند الحاجة فقط (على سبيل المثال، عند تعطُّل إطار العمل وما إلى ذلك).

    المعلمات
    mode ‫ITestDevice.RecoveryMode: ما إذا كان يجب تفعيل وضع "استرداد البيانات إلى أن يتوفّر اتصال بالإنترنت فقط" أم لا

    setSetting

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

    راجِع setSetting(int, String, String, String) ونفِّذ الإجراء على مستخدم النظام.

    المعلمات
    namespace String

    key String

    value String

    عمليات الرمي
    DeviceNotAvailableException

    setSetting

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

    إضافة قيمة إعداد إلى مساحة الاسم الخاصة بمستخدم معيّن لن تتوفّر بعض الإعدادات إلا بعد إعادة التشغيل. يجب أن تكون مساحة الاسم إحدى القيم التالية: {"system", "secure", "global"}

    المعلمات
    userId int

    namespace String

    key String

    value String

    عمليات الرمي
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    إدراج مثيل ITestLogger

    المعلمات
    testLogger ITestLogger

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

    لأغراض إدارة الجهاز، يمكنك تتبُّع الرقم التسلسلي الذي نستخدمه للإشارة إلى الجهاز.

    المعلمات
    trackingSerial String

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

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

    المعلمات
    useFastbootErase boolean: true إذا كان يجب استخدام ميزة محو البيانات باستخدام Fastboot أو false إذا كان يجب استخدام ميزة تنسيق البيانات باستخدام Fastboot.

    startLogcat

    public void startLogcat ()

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

    لن يكون لذلك أي تأثير إذا كان يتم تسجيل ناتج logcat. ويمكن استرداد البيانات لاحقًا من خلال getLogcat.

    عندما يتوقف استخدام الجهاز، يجب استدعاء stopLogcat().

    لا يلزم عادةً استدعاء startLogcat() وstopLogcat() عند ضمن سياق استدعاء TF، لأنّ إطار عمل TF سيبدأ logcat ويوقفه.

    startUser

    public boolean startUser (int userId)

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

    المعلمات
    userId ‫int: للمستخدم لبدء التشغيل في الخلفية
    المرتجعات
    boolean صحيح إذا تم تشغيل المستخدم بنجاح في الخلفية.
    عمليات الرمي
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                boolean waitFlag)

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

    المعلمات
    userId ‫int: للمستخدم لبدء التشغيل في الخلفية
    waitFlag boolean: سيجعل الأمر الانتظار إلى أن يتم تشغيل المستخدم وفتح قفله.
    المرتجعات
    boolean صحيح إذا تم تشغيل المستخدم بنجاح في الخلفية.
    عمليات الرمي
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

    بدء مستخدم معيّن في الخلفية، مرئي في العرض المحدّد (أي السماح للمستخدم ببدء الأنشطة في هذا العرض)

    ملاحظة: لا يتحقّق هذا الأمر ممّا إذا كان المستخدم متوفّرًا أو كان العرض متوفّرًا أو device supports such feature وما إلى ذلك.

    المعلمات
    userId ‫int: للمستخدم لبدء التشغيل في الخلفية
    displayId int: عرض لبدء ظهور المستخدم على
    waitFlag boolean: سيجعل الأمر الانتظار إلى أن يتم تشغيل المستخدم وفتح قفله.
    المرتجعات
    boolean true إذا تم تشغيل المستخدم بنجاح، يظهر في الخلفية.
    عمليات الرمي
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    أغلِق مخرج المحاكي واحذِف المحتوى منه.

    stopLogcat

    public void stopLogcat ()

    توقِف تسجيل بيانات logcat من الجهاز، وبذِّل بيانات logcat المحفوظة حاليًا.

    لن يكون لذلك أي تأثير في حال عدم تسجيل ناتج logcat.

    stopUser

    public boolean stopUser (int userId)

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

    المعلمات
    userId int: من المستخدم لإيقافها.
    المرتجعات
    boolean صحيح إذا تم إيقاف المستخدم بنجاح.
    عمليات الرمي
    DeviceNotAvailableException

    stopUser

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

    إيقاف مستخدم معيّن من الممكن تقديم علامات إضافية للانتظار إلى أن تسري العملية، وإغلاق الحساب على الفور. لا يمكن إيقاف المستخدم الحالي ومستخدم النظام.

    المعلمات
    userId int: من المستخدم لإيقافها.
    waitFlag boolean: سيجعل الأمر ينتظر إلى أن يتم إيقاف المستخدم.
    forceFlag boolean: سيؤدي ذلك إلى فرض إيقاف المستخدم.
    المرتجعات
    boolean صحيح إذا تم إيقاف المستخدم بنجاح.
    عمليات الرمي
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

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

    المرتجعات
    String الرقم التسلسلي لبروتوكول النقل المتعدّد (TCP) أو null إذا تعذّر تبديل الجهاز
    عمليات الرمي
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

    عليك تبديل الجهاز إلى وضع adb عبر usb.

    المرتجعات
    boolean ‫true إذا تم التبديل بنجاح، false في حال عدم نجاحه
    عمليات الرمي
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId)

    التبديل إلى معرّف مستخدم آخر باستخدام مهلة تلقائية switchUser(int, long).

    المعلمات
    userId int

    المرتجعات
    boolean صحيح إذا كان معرّف المستخدم الجديد يتطابق مع مقدّم معرّف المستخدم. خطأ بخلاف ذلك.
    عمليات الرمي
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                long timeout)

    يمكنك التبديل إلى معرّف مستخدم آخر باستخدام مهلة الانتظار المقدَّمة كآخر مهلة. محاولة إيقاف شاشة القفل بعد تغيير المستخدم بنجاح

    المعلمات
    userId int

    timeout long: للانتظار قبل عرض قيمة false لخطأ switch-user
    المرتجعات
    boolean صحيح إذا كان معرّف المستخدم الجديد يتطابق مع مقدّم معرّف المستخدم. خطأ بخلاف ذلك.
    عمليات الرمي
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

    سيتم تجاهل الملفات المخفية (التي تبدأ أسماؤها بنقطة).

    مثال على الاستخدام: سيؤدي syncFiles("‎/tmp/files", "‎/sdcard") إلى إنشاء دليل ‎ /sdcard/files إذا لم يكن متوفّرًا، وسيتم دفع محتويات ‎ /tmp/files بشكل متكرّر إلى ‎ /sdcard/files.

    المعلمات
    localFileDir File: دليل الملفات المحلي الذي يحتوي على الملفات المطلوب دفعها بشكل متكرر
    deviceFilePath String: جذر المسار المطلق للملف في الوجهة البعيدة يجب أن تكون جميع الأدلة في مسار ملف هذا قابلة للقراءة. على سبيل المثال، لن يتم إرسال الملف إلى ‎ /data/local/tmp عندما لا يكون adb هو ملف التمهيد .
    المرتجعات
    boolean true إذا تمت مزامنة الملفات بنجاح false بخلاف ذلك
    عمليات الرمي
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    تأخذ تقرير أخطاء وتُعيده داخل عنصر Bugreport للتعامل معه. عرض القيمة null في حال حدوث مشكلة يجب تنظيف الملف المُشار إليه في عنصر Bugreport من خلال Bugreport.close().

    المرتجعات
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

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

    المعلمات
    packageName String: حزمة Android المطلوب إلغاء تثبيتها
    المرتجعات
    String String مع رمز خطأ، أو null في حال نجاح العملية
    عمليات الرمي
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                int userId)

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

    المعلمات
    packageName String: حزمة Android المطلوب إلغاء تثبيتها
    userId ‫int: رقم تعريف المستخدم الصحيح المطلوب إلغاء تثبيت التطبيق له.
    المرتجعات
    String String مع رمز خطأ، أو null في حال نجاح العملية
    عمليات الرمي
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

    فتح قفل الجهاز إذا كان الجهاز مشفَّرًا

    قد تؤدي هذه الطريقة إلى إعادة تشغيل الإطار الأساسي، ولكنّها لن تُجري مكالمة إلى postBootSetup(). لذلك، قد لا يكون الجهاز جاهزًا تمامًا للاختبار عند استخدام هذه الطريقة.

    المرتجعات
    boolean true في حال نجاح العملية أو إذا كان الجهاز غير مشفَّر
    عمليات الرمي
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    ألغِ تثبيت debugfs.

    عمليات الرمي
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    يتم حظر الإجراء إلى أن يتم ضبط علامة اكتمال عملية تشغيل الجهاز.

    المعلمات
    timeOut ‫long: الوقت بالملي ثانية للانتظار إلى أن يتم ضبط العلامة
    المرتجعات
    boolean صحيح إذا تم ضبط علامة اكتمال تشغيل الجهاز خلال مهلة الانتظار
    عمليات الرمي
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

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

    المرتجعات
    boolean صحيح إذا كان الجهاز متاحًا، خطأ إذا كان الاسترداد غير مفعَّل وغير متاح
    عمليات الرمي
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

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

    المعلمات
    waitTime ‫long: المدة بالملي ثانية للانتظار
    المرتجعات
    boolean صحيح إذا كان الجهاز متاحًا، خطأ إذا كان الاسترداد غير مفعَّل وغير متاح
    عمليات الرمي
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

    ينتظر هذا الإجراء تفاعل الجهاز ومدى توفّره بدون النظر إلى مسار الاسترداد.

    المعلمات
    waitTime long

    المرتجعات
    boolean صحيح إذا كان الجهاز متاحًا، خطأ إذا لم يكن متاحًا.
    عمليات الرمي
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

    يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال Fastboot. استخدام المهلة التلقائية

    عمليات الرمي
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

    يحظر هذا الإعداد أن يكون الجهاز في حالة "استرداد adb" (يُرجى العلم أنّ هذا الإعداد يختلف عن IDeviceRecovery).

    المعلمات
    waitTime ‫long: المدة بالملي ثانية للانتظار
    المرتجعات
    boolean true إذا تم تشغيل الجهاز في وضع الاسترداد قبل انتهاء الوقت false غير ذلك

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    حظر الجهاز في حالة "تحميل جانبي باستخدام adb"

    المعلمات
    waitTime ‫long: المدة بالملي ثانية للانتظار
    المرتجعات
    boolean true إذا تم تشغيل الجهاز في وضع "التثبيت من مصدر غير معروف" قبل انتهاء المهلة false غير ذلك

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    الحظر لعدم توفّر الجهاز، أي عدم توفّره في adb

    المعلمات
    waitTime ‫long: المدة بالملي ثانية للانتظار
    المرتجعات
    boolean true إذا لم يعُد الجهاز متاحًا قبل انتهاء الوقت false غير ذلك

    waitForDeviceOnline

    public void waitForDeviceOnline ()

    يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال adb. استخدام المهلة التلقائية

    يُرجى العِلم أنّه قد لا يستجيب الجهاز للأوامر بعد اكتمال العملية. استخدِم waitForDeviceAvailable() بدلاً من ذلك.

    عمليات الرمي
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

    يتم الحظر إلى أن يصبح الجهاز مرئيًا من خلال adb.

    يُرجى العِلم أنّه قد لا يستجيب الجهاز للأوامر بعد اكتمال العملية. استخدِم waitForDeviceAvailable() بدلاً من ذلك.

    المعلمات
    waitTime ‫long: المدة بالملي ثانية للانتظار
    عمليات الرمي
    DeviceNotAvailableException

    waitForDeviceShell

    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)

    إنشاء أمر نظام التشغيل لجلسة أمر shell في adb وargs المحدَّدة

    المعلمات
    command String

    forceExitStatusDetection boolean

    المرتجعات
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

    المعلمات
    feature String

    strictMinLevel int

    createRebootDeviceAction

    protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

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

    المعلمات
    rebootMode NativeDevice.RebootMode: أحد أوضاع إعادة التشغيل هذه.
    reason String: لإجراء عملية إعادة التشغيل هذه.
    المرتجعات
    NativeDevice.RebootDeviceAction RebootDeviceAction التي تم إنشاؤها.

    createRunUtil

    protected IRunUtil createRunUtil ()

    المرتجعات
    IRunUtil

    doAdbReboot

    protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

    نفِّذ إعادة تشغيل adb.

    المعلمات
    rebootMode NativeDevice.RebootMode: أحد أوضاع إعادة التشغيل هذه.
    reason String: لإجراء عملية إعادة التشغيل هذه.
    عمليات الرمي
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    طريقة مساعدة لرمي استثناء في حال عدم توفّر إذن التشغيل

    عمليات الرمي
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    المرتجعات
    int

    getLogger

    protected ITestLogger getLogger ()

    المرتجعات
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    احصل على نسخة RunUtil لاستخدامها.

    المرتجعات
    IRunUtil

    initializeConnection

    protected void initializeConnection (IBuildInfo info, 
                MultiMap<String, String> attributes)

    المعلمات
    info IBuildInfo

    attributes MultiMap

    عمليات الرمي
    DeviceNotAvailableException
    TargetSetupError

    internalGetProperty

    protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

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

    المعلمات
    propName String: اسم خاصية الجهاز كما تظهر في القيمة التي يعرضها الأمر "adb shell getprop"
    fastbootVar String: اسم متغيّر fastboot المكافئ الذي سيتم الاستعلام عنه. إذا كان null، لن تتم محاولة طلب البحث في fastboot
    description String: وصف بسيط للمتغيّر يجب كتابة الحرف الأول كبيرًا.
    المرتجعات
    String سلسلة، قد تكون null أو فارغة، تحتوي على قيمة السمة المحدّدة
    عمليات الرمي
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

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

    المرتجعات
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                IFileEntry entry)

    عرض true إذا كان الملف على الجهاز أحدث من الملف على الجهاز البعيد IFileEntry دقة التنسيق إلى الدقيقة، في حال تساوي الأوقات، سيتم اعتبار الملف أحدث.

    المعلمات
    localFile File

    entry IFileEntry

    المرتجعات
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    إرسال إشعار إلى جميع IDeviceActionReceiver بشأن حدث انتهاء إعادة التشغيل

    عمليات الرمي
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

    تُرسِل إشعارًا إلى جميع IDeviceActionReceiver بشأن حدث بدء إعادة التشغيل.

    عمليات الرمي
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    performDeviceAction

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

    تنفيذ إجراء على هذا الجهاز تحاول استرداد الجهاز وإعادة محاولة تنفيذ الأمر اختياريًا في حال تعذّر تنفيذه.

    المعلمات
    actionDescription String: وصف موجز للعمل الذي سيتم تنفيذه يُستخدَم لأغراض تسجيل البيانات فقط.
    action NativeDevice.DeviceAction: الإجراء الذي سيتم تنفيذه
    retryAttempts ‫int: تحاول إعادة المحاولة تنفيذ الإجراء في حال تعذّر ذلك ولكن تمكّنت عملية الاسترداد من إكماله.
    المرتجعات
    boolean true إذا تم تنفيذ الإجراء بنجاح
    عمليات الرمي
    DeviceNotAvailableException إذا تعذّرت محاولة الاسترداد أو تم تنفيذ الحد الأقصى من المحاولات بدون نجاح

    postAdbReboot

    protected void postAdbReboot ()

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

    عمليات الرمي
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

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

    عمليات الرمي
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

    المعلمات
    remoteFilePath String

    localFile File

    المرتجعات
    boolean

    عمليات الرمي
    DeviceNotAvailableException

    setClock

    protected void setClock (Clock clock)

    اضبط مثيل Clock المراد استخدامه.

    المعلمات
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    يضع علامة على TestDevice باعتباره microdroid ويضبط رقم تعريفه.

    المعلمات
    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

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

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

    المعلمات
    operationDesc String: اسم العملية التي في انتظار اكتمالها غير متاح.
    time long: المدة التي يجب الانتظار خلالها إلى أن يحدث الحدث "غير متوفّر"
    المرتجعات
    boolean صحيح إذا أصبح الجهاز غير متاح.