ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

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

ملخّص

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

class ITestDevice.ApexInfo

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

class ITestDevice.MountPointInfo

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

الطرق العامة

abstract boolean canSwitchToHeadlessSystemUser()

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

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 المرتبط بمعرّف مستخدم وعرضه، أو عرض قيمة فارغة في حال عدم العثور عليه

abstract getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract getAppPackageInfos()

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

abstract InputStreamSource getBugreport()

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

abstract InputStreamSource getBugreportz()

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

abstract DeviceFoldableState getCurrentFoldableState()

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

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 على جهاز لمستخدم معيّن

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)

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

abstract boolean switchUser(int userId, long timeout)

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

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

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

المرتجعات
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: رقم تعريف شبكة 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: رقم تعريف شبكة 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، ويبدو أنّه غير متزامن، لأنّ تنفيذ الإطار العملي الحالي يتضمّن أحيانًا حالة تنافُس. بعد ذلك، يتم إرسال الأمر لإيقاف شاشة القفل (يعمل على الأجهزة غير الآمنة فقط).

عمليات الرمي
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"}
المرتجعات
خريطة أزواج المفتاح/القيمة قيمة فارغة إذا لم تكن مساحة الاسم متاحة.
عمليات الرمي
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

المعلمات
userId int

المرتجعات
String

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

getAndroidIds

public abstract  getAndroidIds ()

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

المرتجعات
خريطة أرقام تعريف 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 ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

المرتجعات
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 userId للمستخدم الرئيسي إذا كان هناك مستخدم رئيسي، وقيمة فارغة إذا لم يكن هناك مستخدم رئيسي
عمليات الرمي
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException إذا لم يكن الناتج من الجهاز على النحو المتوقّع
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

المرتجعات
ERROR(/Set) من 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 userId للمستخدم الأساسي في حال توفّر مستخدم أساسي، وقيمة فارغة في حال عدم توفّر مستخدم أساسي
عمليات الرمي
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: توسيع نطاق عمليات التنفيذ أعلاه لتتوافق مع "التنسيق" و"إعادة الحجم"

المعلمات
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 القيمة المرتبطة بـ namespace:key الخاصة بمستخدم قيمة فارغة إذا لم يتم العثور على القيمة
عمليات الرمي
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 إذا لم يكن إذن التشغيل متوافقًا مع النظام الأساسي على الجهاز

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 صحيح إذا تم تشغيل المستخدم بنجاح في الخلفية.
عمليات الرمي
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

المعلمات
userId ‫int: للمستخدم لبدء التشغيل في الخلفية
waitFlag boolean: سيجعل الأمر الانتظار إلى أن يتم تشغيل المستخدم وفتح قفله.
المرتجعات
boolean صحيح إذا تم تشغيل المستخدم بنجاح في الخلفية.
عمليات الرمي
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)

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

المعلمات
userId int

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

المعلمات
userId int

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

takeBugreport

public abstract Bugreport takeBugreport ()

تأخذ تقرير أخطاء وتُعيده داخل عنصر Bugreport للتعامل معه. عرض القيمة null في حال حدوث مشكلة يجب تنظيف الملف المُشار إليه في عنصر 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