ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

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

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

ملخّص

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

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

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

abstract int getCurrentUser()

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

abstract getFoldableStates()

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

abstract getInstalledPackageNames()

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

abstract String getIpAddress()

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

abstract KeyguardControllerState getKeyguardState()

يمكنك إرجاع كائن للحصول على الحالة الحالية لقفل المفاتيح أو القيمة "فارغ" إذا لم يكن ذلك متاحًا.

abstract Integer getMainUserId()

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

abstract getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

الحصول على الحد الأقصى لعدد الأجهزة المتوافقة التي تعمل بنظام التشغيل Android في آنٍ واحد

abstract int getMaxNumberOfUsersSupported()

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

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

تعرض معرّف المستخدم الأساسي.

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

التحقق من الاتصال

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 إذا انقطع الاتصال بالجهاز ولا يمكن استرداده.

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

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: اسم عملية تفريغ البيانات على الجهاز
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

الحصول على جميع الإعدادات

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، يُرجى عرض قيمة فارغة في حال حدوث خطأ.

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

الحالات القابلة للطي

public abstract  getFoldableStates ()

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

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

أسماء الحِزم المُثبّتة

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

الحصول على MaxNumberOfUsers مجددًا

public abstract int getMaxNumberOfUsersSupported ()

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

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

الحصول على خيارات

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

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

الحصول على لقطة شاشة

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

المعلمات
format String: يمكن استخدام تنسيقات PNG وJPEG
rescale boolean: إذا كان يجب إعادة تغيير حجم لقطة الشاشة لتقليل حجم الصورة الناتجة
المرتجعات
InputStreamSource InputStreamSource من لقطة الشاشة بتنسيق png أو 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

الإعداد

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

الحصول على UninstallablePackageNames

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 العلامات المرتبطة بـ userId المقدم في حال العثور عليه، -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

الحصول على UserSerialNumber

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

تم تثبيت الحزمة

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

يكون المستخدم مرئي

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

متاح

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

متاح

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

إزالة المالكين

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

ضبط الإعداد

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

مستخدم البدء

public abstract boolean startUser (int userId)

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

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

مستخدم البدء

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

المرتجعات
Bugreport

إلغاء تثبيت الحزمة

public abstract String uninstallPackage (String packageName)

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

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

إلغاء تثبيت PackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

إذا كان ذلك متوقعًا، انتظر حتى اكتمال عرض الصور.

المعلمات
currentPhase SnapuserdWaitPhase

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