ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

توفّر واجهة برمجة تطبيقات موثوقة وأعلى مستوى قليلاً من واجهة برمجة التطبيقات ddmlib IDevice.

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

ملخّص

الفئات المتداخلة

class ITestDevice.ApexInfo

فئة بنية بسيطة لتخزين معلومات حول APEX واحد

class ITestDevice.MountPointInfo

فئة struct بسيطة لتخزين معلومات حول نقطة ربط واحدة 

الطُرق العامة

abstract boolean canSwitchToHeadlessSystemUser()

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

abstract boolean checkConnectivity()

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

abstract boolean clearErrorDialogs()

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

abstract void clearLastConnectedWifiNetwork()

يمحو شبكة Wi-Fi التي تم الاتصال بها آخر مرة.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

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

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

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

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

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

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

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

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

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

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

abstract int createUser(String name)

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

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

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

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

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

abstract int createUserNoThrow(String name)

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

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

تؤدي هذه الطريقة إلى إزالة IDeviceActionReceiver المسجَّلة.

abstract void disableKeyguard()

محاولات إيقاف قفل الشاشة

abstract boolean disableNetworkMonitor()

يؤدي ذلك إلى إيقاف مراقبة الشبكة على الجهاز.

abstract boolean disconnectFromWifi()

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

abstract boolean doesFileExist(String deviceFilePath, int userId)

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

abstract File dumpHeap(String process, String devicePath)

محاولة تفريغ الذاكرة المؤقتة من system_server

abstract boolean enableNetworkMonitor()

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

abstract getActiveApexes()

استرجاع المعلومات حول حِزم APEX المفعَّلة على الجهاز

abstract getAllSettings(String namespace)

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

abstract String getAndroidId(int userId)

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

abstract getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

استرداد معلومات حول حزمة مثبَّتة على الجهاز

abstract getAppPackageInfos()

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

abstract InputStreamSource getBugreport()

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

abstract InputStreamSource getBugreportz()

يسترد هذا الأمر تقرير bugreportz من الجهاز.

abstract DeviceFoldableState getCurrentFoldableState()

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

abstract int getCurrentUser()

لعرض رقم تعريف المستخدم الحالي الذي يتم تشغيله

abstract getFoldableStates()

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

abstract getInstalledPackageNames()

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

abstract String getIpAddress()

تعرض هذه السمة عنوان IP الخاص بالجهاز.

abstract KeyguardControllerState getKeyguardState()

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

abstract Integer getMainUserId()

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

abstract getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

تم إيقاف هذه الطريقة نهائيًا. تم إيقاف getPrimaryUser نهائيًا من خدمة UserManager، استخدِم ERROR(/android.os.UserManager#getMainUserId()) للحصول على أول مستخدم كامل أو 0 للنظام. يُرجى العِلم أنّ نظام التشغيل بدون واجهة مستخدم ليس مستخدمًا كاملاً.

abstract InputStreamSource getScreenshot(String format, boolean rescale)

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

abstract InputStreamSource getScreenshot(long displayId)

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

abstract InputStreamSource getScreenshot(String format)

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

abstract InputStreamSource getScreenshot()

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

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

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

abstract String getSetting(String namespace, String key)

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

abstract getUninstallablePackageNames()

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

abstract int getUserFlags(int userId)

للعثور على علامات مستخدم معيّن وعرضها

abstract getUserInfos()

تعرض هذه السمة خريطة تربط بين useId وUserInfo على الجهاز.

abstract int getUserSerialNumber(int userId)

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

abstract boolean hasFeature(String feature)

التحقّق من توفّر ميزة على جهاز

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

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

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

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

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

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

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

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

abstract boolean installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)

تثبيت حِزم APK باستخدام الوضع التزايدي

default String installPackages( packageFiles, boolean reinstall, String... extraArgs)

تثبيت تطبيق Android يتألف من عدة ملفات APK (حزمة رئيسية وحِزم مقسّمة إضافية)

default String installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

تثبيت تطبيق Android يتألف من عدة ملفات APK (ملف رئيسي وحِزم مقسّمة إضافية) على جهاز Android

default String installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)

تثبيت تطبيق Android يتألف من عدة ملفات APK (حزمة رئيسية وحِزم مقسّمة إضافية) لمستخدم معيّن

default String installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

تثبيت تطبيق Android يتألف من عدة ملفات APK (حزمة رئيسية وحِزم مقسّمة إضافية) لمستخدم معيّن

default String installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)

تثبيت تطبيق Android يتألف من عدّة ملفات APK (ملف رئيسي وحِزم مقسّمة إضافية) على جهاز Android

default String installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

تثبيت تطبيق Android يتألف من عدة ملفات APK (ملف رئيسي وحِزم مقسّمة إضافية) على جهاز Android

abstract boolean isHeadlessSystemUserMode()

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

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

تحدِّد ما إذا كان يمكن استخدام حسابات متعدّدة.

abstract boolean isPackageInstalled(String packageName, String userId)

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

abstract boolean isPackageInstalled(String packageName)

طلب البحث من الجهاز عن اسم حزمة معيّن للتحقّق مما إذا كانت الحزمة مثبَّتة حاليًا أم لا

abstract boolean isUserRunning(int userId)

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

abstract boolean isUserSecondary(int userId)

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

abstract boolean isUserVisible(int userId)

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

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

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

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

اختبار ما إذا كانت شبكة Wi-Fi مفعّلة

abstract listDisplayIds()

اجمع قائمة بمعرّفات الشاشات المتاحة على الجهاز كما تمّت الإشارة إليها من خلال "dumpsys SurfaceFlinger".

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

تعرض هذه الطريقة قائمة الشاشات التي يمكن استخدامها في start a user visible in the background.

abstract listUsers()

تعرض هذه الطريقة قائمة بالمستخدمين على الجهاز.

abstract boolean logBugreport(String dataName, ITestLogger listener)

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

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

إبلاغ الجهاز بالانتظار إلى أن تكتمل عملية snapuserd

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

تسجّل هذه السمة IDeviceActionReceiver لهذا الجهاز.

abstract boolean removeAdmin(String componentName, int userId)

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

abstract void removeOwners()

إزالة جميع مالكي ملفات الأجهزة الحالية بأفضل جهد ممكن

abstract boolean removeUser(int userId)

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

abstract boolean setDeviceOwner(String componentName, int userId)

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

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

اطّلِع على setSetting(int, String, String, String) التي تم تنفيذها على مستخدم النظام.

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

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

abstract boolean startUser(int userId)

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

abstract boolean startUser(int userId, boolean waitFlag)

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

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

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

abstract boolean stopUser(int userId)

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

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

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

abstract boolean switchUser(int userId)

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

abstract boolean switchUser(int userId, long timeout)

بدِّل إلى userId آخر مع المهلة المقدَّمة كموعد نهائي.

abstract Bugreport takeBugreport()

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

abstract String uninstallPackage(String packageName)

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

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

إذا كان ذلك متوقعًا، انتظِر حتى تكتمل عملية snapuserd.

الطُرق العامة

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

المرتجعات
boolean true إذا كان الجهاز يتصل اتصالاً سليمًا بالشبكة، false في الحالات الأخرى.
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

المرتجعات
boolean ‫true إذا لم تكن هناك مربّعات حوار أو إذا تمت إزالة مربّعات الحوار بنجاح false في ما عدا ذلك.
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract 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 abstract 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 abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

يتم تفعيل شبكة Wi-Fi والحظر إلى أن يتم إنشاء اتصال ناجح بشبكة Wi-Fi المحدّدة. بعد إنشاء اتصال، ستحاول الآلة الافتراضية استعادة الاتصال بعد كل عملية إعادة تشغيل إلى أن يتم استدعاء ITestDevice.disconnectFromWifi() أو ITestDevice.clearLastConnectedWifiNetwork().

المعلمات
wifiSsid String: معرّف SSID لشبكة Wi-Fi المطلوب الاتصال بها
wifiPsk ‫String: عبارة مرور PSK أو قيمة فارغة إذا لم يكن مشفّرًا
المرتجعات
boolean ‫true في حال الاتصال بشبكة Wi-Fi بنجاح false غير ذلك
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

connectToWifiNetwork

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

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

يتم تفعيل شبكة Wi-Fi والحظر إلى أن يتم إنشاء اتصال ناجح بشبكة Wi-Fi المحدّدة. بعد إنشاء اتصال، ستحاول الآلة الافتراضية استعادة الاتصال بعد كل عملية إعادة تشغيل إلى أن يتم استدعاء ITestDevice.disconnectFromWifi() أو ITestDevice.clearLastConnectedWifiNetwork().

المعلمات
wifiSsid String: معرّف SSID لشبكة Wi-Fi المطلوب الاتصال بها
wifiPsk ‫String: عبارة مرور PSK أو قيمة فارغة إذا لم يكن مشفّرًا
scanSsid ‫boolean: لتحديد ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة.
المرتجعات
boolean ‫true في حال الاتصال بشبكة Wi-Fi بنجاح false غير ذلك
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

connectToWifiNetworkIfNeeded

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

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

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

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

المرتجعات
boolean ‫true في حال الاتصال بشبكة Wi-Fi بنجاح false غير ذلك
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

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

المعلمات
name ‫String: هو اسم المستخدم الذي سيتم إنشاؤه على الجهاز
المرتجعات
int العدد الصحيح لمعرّف المستخدم الذي تم إنشاؤه
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

المعلمات
name ‫String: هو اسم المستخدم الذي سيتم إنشاؤه على الجهاز
guest boolean: تفعيل علامة المستخدم --guest أثناء الإنشاء
ephemeral ‫boolean: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء
المرتجعات
int معرّف المستخدم الذي تم إنشاؤه
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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

المعلمات
name ‫String: هو اسم المستخدم الذي سيتم إنشاؤه على الجهاز
guest boolean: تفعيل علامة المستخدم --guest أثناء الإنشاء
ephemeral ‫boolean: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء
forTesting boolean: تفعيل العلامة الاختبارية --for-testing أثناء الإنشاء
المرتجعات
int معرّف المستخدم الذي تم إنشاؤه
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

المعلمات
name ‫String: هو اسم المستخدم الذي سيتم إنشاؤه على الجهاز
المرتجعات
int عدد صحيح يمثّل رقم تعريف المستخدم الذي تم إنشاؤه أو القيمة -1 في حال حدوث خطأ.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

disableKeyguard

public abstract void disableKeyguard ()

محاولات إيقاف قفل الشاشة

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

الرميات
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

يؤدي ذلك إلى إيقاف مراقبة الشبكة على الجهاز.

المرتجعات
boolean ‫true إذا تم إيقاف ميزة التتبُّع بنجاح false في حال تعذّر ذلك.
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

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

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

المرتجعات
boolean ‫true في حال قطع الاتصال بشبكة Wi-Fi بنجاح false في حال تعذّر إلغاء الربط.
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

المرتجعات
boolean ‫true إذا تم تفعيل ميزة التتبُّع بنجاح false في حال تعذّر ذلك.
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

getActiveApexes

public abstract  getActiveApexes ()

استرجاع المعلومات حول حِزم APEX المفعَّلة على الجهاز

المرتجعات
ERROR(/Set) من إجمالي ApexInfo تم تفعيله حاليًا على الجهاز
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

getAndroidId

public abstract String getAndroidId (int userId)

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

المعلمات
userId int

المرتجعات
String

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

getAndroidIds

public abstract  getAndroidIds ()

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

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

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

استرداد معلومات حول حزمة مثبَّتة على الجهاز

المعلمات
packageName String

المرتجعات
PackageInfo PackageInfo أو null في حال تعذّر استرداد المعلومات
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

المرتجعات
ERROR(/List) من حِزم PackageInfo المثبَّتة على الجهاز
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

لا يتوافق إلا مع الإصدار "adb version" الأحدث من 1.0.36

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

المرتجعات
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

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

المرتجعات
int

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

getFoldableStates

public abstract  getFoldableStates ()

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

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

getIpAddress

public abstract String getIpAddress ()

تعرض هذه السمة عنوان IP الخاص بالجهاز.

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

المرتجعات
KeyguardControllerState KeyguardControllerState يحتوي على لقطة لحالة شاشة القفل ويعرض القيمة Null إذا كان طلب البحث عن شاشة القفل غير متاح.
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

getMainUserId

public abstract Integer getMainUserId ()

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

المرتجعات
Integer معرّف المستخدم الرئيسي إذا كان هناك مستخدم رئيسي، والقيمة null إذا لم يكن هناك مستخدم رئيسي
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException إذا لم يكن الناتج من الجهاز على النحو المتوقّع
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

المرتجعات
int عدد صحيح يشير إلى عدد المستخدمين المسموح بهم
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

تم إيقاف استخدام هذه الطريقة نهائيًا.
تم إيقاف getPrimaryUser نهائيًا من خدمة UserManager، استخدِم ERROR(/android.os.UserManager#getMainUserId()) للحصول على أول مستخدم كامل أو 0 للنظام. يُرجى العِلم أنّ نظام التشغيل بدون واجهة مستخدم ليس مستخدمًا كاملاً.

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

المرتجعات
Integer معرّف المستخدم الأساسي إذا كان هناك مستخدم أساسي، والقيمة null إذا لم يكن هناك مستخدم أساسي
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException إذا لم يكن الناتج من الجهاز على النحو المتوقّع
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

المعلمات
format String: PNG وJPEG
rescale ‫boolean: ما إذا كان يجب إعادة تحجيم لقطة الشاشة لتقليل حجم الصورة الناتجة
المرتجعات
InputStreamSource InputStreamSource من لقطة الشاشة بالتنسيق، أو null إذا لم تنجح لقطة الشاشة.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: extend the implementations above to support 'format' and 'rescale'

المعلمات
displayId long: المعرّف المعروض للشاشة التي سيتم أخذ لقطة شاشة منها
المرتجعات
InputStreamSource InputStreamSource من لقطة الشاشة بالتنسيق، أو null إذا لم تنجح لقطة الشاشة.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

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

getSetting

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

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

المعلمات
userId int

namespace String

key String

المرتجعات
String القيمة المرتبطة بالمساحة:مفتاح الخاص بمستخدِم. تكون القيمة فارغة إذا لم يتم العثور على أي نتائج.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

المعلمات
namespace String

key String

المرتجعات
String

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

getUserFlags

public abstract int getUserFlags (int userId)

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

المعلمات
userId int

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

getUserInfos

public abstract  getUserInfos ()

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

المرتجعات
قائمة عناصر UserInfo
الرميات
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

المعلمات
userId int

المرتجعات
int

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

hasFeature

public abstract boolean hasFeature (String feature)

التحقّق من توفّر ميزة على جهاز

المعلمات
feature ‫String: يجب أن يكون التنسيق "feature:" أو "" مباشرةً.
المرتجعات
boolean صحيح إذا تم العثور على الميزة، وخطأ في الحالات الأخرى.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

public abstract 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 abstract 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 في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.
UnsupportedOperationException إذا كانت المنصة لا تتيح أذونات وقت التشغيل على الجهاز

installPackageForUser

public abstract 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 abstract 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 في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.
UnsupportedOperationException إذا كانت المنصة لا تتيح أذونات وقت التشغيل على الجهاز

installPackageWithIncrementalMode

public abstract boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

تثبيت حِزم APK باستخدام الوضع التزايدي

المعلمات
apkFiles استبدِل File بملفات APK المطلوب تثبيتها.
extraArgs String

userId String

المرتجعات
boolean

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

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

تثبيت تطبيق Android يتألف من عدة ملفات APK (حزمة رئيسية وحِزم مقسّمة إضافية) راجِع الرابط "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حِزمة APK إلى عدة ملفات.

المعلمات
packageFiles ‫: ملفات APK المحلية
reinstall boolean: true إذا كان يجب إعادة التثبيت
extraArgs String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.
المرتجعات
String String مع رمز خطأ، أو null في حال النجاح
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.
UnsupportedOperationException إذا كانت المنصة لا تتيح أذونات وقت التشغيل على الجهاز

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

تثبيت تطبيق Android يتألف من عدّة ملفات APK (ملف رئيسي وحِزم مقسّمة إضافية) على جهاز Android راجِع الرابط "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حِزمة APK إلى عدة ملفات.

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

المعلمات
packageFiles ‫: مسارات ملفات APK البعيدة المطلوب تثبيتها
reinstall boolean: true إذا كان يجب إعادة التثبيت
grantPermissions ‫boolean: لتحديد ما إذا كان يجب منح جميع أذونات وقت التشغيل عند التثبيت
extraArgs String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.
المرتجعات
String String مع رمز خطأ، أو null في حال النجاح
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.
UnsupportedOperationException إذا كانت المنصة لا تتيح أذونات وقت التشغيل على الجهاز

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

تثبيت تطبيق Android يتألف من عدة ملفات APK (حزمة رئيسية وحِزم مقسّمة إضافية) لمستخدم معيّن يمكنك الاطّلاع على الرابط "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حِزمة APK إلى عدة ملفات.

المعلمات
packageFiles ‫: ملفات APK المحلية
reinstall boolean: true إذا كان يجب إعادة التثبيت
userId ‫int: هو رقم تعريف المستخدم الصحيح الذي سيتم التثبيت له.
extraArgs String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.
المرتجعات
String String مع رمز خطأ، أو null في حال النجاح
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.
UnsupportedOperationException إذا كانت المنصة لا تتيح أذونات وقت التشغيل على الجهاز

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

تثبيت تطبيق Android يتألف من عدة ملفات APK (حزمة رئيسية وحِزم مقسّمة إضافية) لمستخدم معيّن يمكنك الاطّلاع على الرابط "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حِزمة APK إلى عدة ملفات.

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

المعلمات
packageFiles ‫: ملفات APK المحلية
reinstall boolean: true إذا كان يجب إعادة التثبيت
grantPermissions ‫boolean: لتحديد ما إذا كان يجب منح جميع أذونات وقت التشغيل عند التثبيت
userId ‫int: هو رقم تعريف المستخدم الصحيح الذي سيتم التثبيت له.
extraArgs String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.
المرتجعات
String String مع رمز خطأ، أو null في حال النجاح
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.
UnsupportedOperationException إذا كانت المنصة لا تتيح أذونات وقت التشغيل على الجهاز

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

تثبيت تطبيق Android يتألف من عدّة ملفات APK (ملف رئيسي وحِزم مقسّمة إضافية) على جهاز Android راجِع الرابط "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حِزمة APK إلى عدة ملفات.

المعلمات
remoteApkPaths ‫: مسارات ملفات APK البعيدة
reinstall boolean: true إذا كان يجب إعادة التثبيت
extraArgs String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.
المرتجعات
String String مع رمز خطأ، أو null في حال النجاح
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.
UnsupportedOperationException إذا كانت المنصة لا تتيح أذونات وقت التشغيل على الجهاز

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

تثبيت تطبيق Android يتألف من عدّة ملفات APK (ملف رئيسي وحِزم مقسّمة إضافية) على جهاز Android راجِع الرابط "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حِزمة APK إلى عدة ملفات.

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

المعلمات
remoteApkPaths ‫: مسارات ملفات APK البعيدة
reinstall boolean: true إذا كان يجب إعادة التثبيت
grantPermissions ‫boolean: لتحديد ما إذا كان يجب منح جميع أذونات وقت التشغيل عند التثبيت
extraArgs String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" للاطّلاع على الخيارات المتاحة.
المرتجعات
String String مع رمز خطأ، أو null في حال النجاح
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.
UnsupportedOperationException إذا كانت المنصة لا تتيح أذونات وقت التشغيل على الجهاز

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

تحدِّد ما إذا كان يمكن استخدام حسابات متعدّدة.

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

طلب البحث من الجهاز عن اسم حزمة معيّن للتحقّق مما إذا كانت الحزمة مثبَّتة حاليًا أم لا

المعلمات
packageName String

المرتجعات
boolean تكون القيمة "صحيح" إذا تم الإبلاغ عن تثبيت الحزمة. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

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

المعلمات
userId int

المرتجعات
boolean تكون القيمة "صحيح" إذا كان المستخدم يمارس رياضة الجري، وتكون "خطأ" في كل الحالات الأخرى.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

المعلمات
userId int

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

isUserVisible

public abstract boolean isUserVisible (int userId)

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

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

المعلمات
userId int

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

المعلمات
userId int

displayId int

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract 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 abstract boolean isVisibleBackgroundUsersSupported ()

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

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

اختبار ما إذا كانت شبكة Wi-Fi مفعّلة

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

المرتجعات
boolean ‫true إذا كانت شبكة Wi-Fi مفعّلة ‫false في حال إيقافها
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

listDisplayIds

public abstract  listDisplayIds ()

اجمع قائمة بمعرّفات الشاشات المتاحة على الجهاز كما تمّت الإشارة إليها من خلال "dumpsys SurfaceFlinger".

المرتجعات
تمثّل هذه السمة قائمة بالشاشات. تعرض القيمة التلقائية دائمًا القيمة التلقائية 0.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

تعرض هذه الطريقة قائمة الشاشات التي يمكن استخدامها في start a user visible in the background.

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

listUsers

public abstract  listUsers ()

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

المرتجعات
قائمة أرقام تعريف المستخدمين
الرميات
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

المعلمات
dataName ‫String: الاسم الذي سيتم الإبلاغ عنه في تقرير الأخطاء.
listener ITestLogger: ITestLogger لتسجيل تقرير الأخطاء
المرتجعات
boolean صحيح إذا تم التسجيل بنجاح، وخطأ في الحالات الأخرى.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

إبلاغ الجهاز بالانتظار إلى أن تكتمل عملية snapuserd

المعلمات
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

تسجّل هذه السمة IDeviceActionReceiver لهذا الجهاز.

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

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

removeOwners

public abstract void removeOwners ()

إزالة جميع مالكي ملفات الأجهزة الحالية بأفضل جهد ممكن

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

removeUser

public abstract boolean removeUser (int userId)

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

المعلمات
userId ‫int: معرّف المستخدم المطلوب إزالته
المرتجعات
boolean صحيح إذا نجحنا في إزالة المستخدم، وخطأ في الحالات الأخرى.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

المعلمات
componentName String: من مشرف الجهاز ليكون مالك الجهاز.
userId int: الخاصة بالمستخدم الذي يعيش فيه مالك الجهاز.
المرتجعات
boolean صحيح إذا كانت العملية ناجحة، وخطأ في الحالات الأخرى.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

اطّلِع على setSetting(int, String, String, String) التي تم تنفيذها على مستخدم النظام.

المعلمات
namespace String

key String

value String

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

setSetting

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

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

المعلمات
userId int

namespace String

key String

value String

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

startUser

public abstract boolean startUser (int userId)

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

المعلمات
userId ‫int: تمثّل هذه السمة المستخدم الذي سيتم تشغيل التطبيق في الخلفية.
المرتجعات
boolean تعرض القيمة "true" إذا تم بدء المستخدم بنجاح في الخلفية.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

المعلمات
userId ‫int: تمثّل هذه السمة المستخدم الذي سيتم تشغيل التطبيق في الخلفية.
waitFlag سيؤدي استخدام boolean إلى إيقاف الأمر مؤقتًا إلى أن يتم بدء تشغيل المستخدم وفتح قفله.
المرتجعات
boolean تعرض القيمة "true" إذا تم بدء المستخدم بنجاح في الخلفية.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

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

stopUser

public abstract boolean stopUser (int userId)

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

المعلمات
userId int: تمثّل هذه السمة معرّف المستخدم الذي سيتم إيقافه.
المرتجعات
boolean صحيح إذا تم إيقاف المستخدم بنجاح.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

إيقاف مستخدم معيّن من الممكن تقديم علامات إضافية لانتظار أن يسري مفعول العملية، وإيقاف المستخدم نهائيًا. لا يمكن إيقاف المستخدم الحالي ومستخدم النظام.

المعلمات
userId int: تمثّل هذه السمة معرّف المستخدم الذي سيتم إيقافه.
waitFlag ‫boolean: سيؤدي إلى انتظار الأمر إلى أن يتم إيقاف المستخدم.
forceFlag ‫boolean: سيتم فرض إيقاف المستخدم.
المرتجعات
boolean صحيح إذا تم إيقاف المستخدم بنجاح.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

التبديل إلى userId آخر مع مهلة تلقائية switchUser(int, long).

المعلمات
userId int

المرتجعات
boolean تعرض القيمة "صحيح" إذا كان رقم تعريف المستخدم الجديد يتطابق مع موفّر رقم تعريف المستخدم. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

المعلمات
userId int

timeout ‫long: للانتظار قبل عرض القيمة false في حال تعذُّر التبديل بين المستخدمين
المرتجعات
boolean تعرض القيمة "صحيح" إذا كان رقم تعريف المستخدم الجديد يتطابق مع موفّر رقم تعريف المستخدم. ويتم عرض القيمة "خطأ" إذا لم تكن نقطة الإدخال داخله.
الرميات
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

تأخذ هذه الدالة تقرير خطأ وتعرضه داخل عنصر Bugreport للتعامل معه. تعرِض قيمة فارغة في حال حدوث مشكلة. يجب تنظيف الملف المشار إليه في عنصر Bugreport باستخدام Bugreport.close().

المرتجعات
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

المعلمات
packageName ‫String: حزمة Android المطلوب إلغاء تثبيتها
المرتجعات
String String مع رمز خطأ، أو null في حال النجاح
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

المعلمات
packageName ‫String: حزمة Android المطلوب إلغاء تثبيتها
userId ‫int: رقم تعريف المستخدم الصحيح المطلوب إلغاء تثبيت التطبيق له.
المرتجعات
String String مع رمز خطأ، أو null في حال النجاح
الرميات
DeviceNotAvailableException في حال فقدان الاتصال بالجهاز وتعذُّر استعادته.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

إذا كان ذلك متوقعًا، انتظِر حتى تكتمل عملية snapuserd.

المعلمات
currentPhase SnapuserdWaitPhase

الرميات
DeviceNotAvailableException