جهاز ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

يوفّر واجهة برمجة تطبيقات موثوقة وعالية المستوى بعض الشيء لملف ddmlib IDevice.

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

ملخّص

الصفوف المتداخلة

class ITestDevice.ApexInfo

يشير هذا المصطلح إلى فئة بنية بسيطة لتخزين المعلومات المتعلّقة بنقطة APEX واحدة.

class ITestDevice.MountPointInfo

يشير هذا المصطلح إلى فئة بنية بسيطة لتخزين المعلومات حول نقطة تثبيت واحدة.

الطرق العامة

abstract boolean canSwitchToHeadlessSystemUser()

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

abstract boolean checkConnectivity()

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

abstract boolean clearErrorDialogs()

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

abstract void clearLastConnectedWifiNetwork()

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

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

يتصل بشبكة Wi-Fi.

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

يتصل بشبكة Wi-Fi.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

يتصل بشبكة Wi-Fi.

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

يتصل بشبكة Wi-Fi.

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

إصدار بديل من connectToWifiNetwork(String, String) لا يمكن الاتصال به إلا عند استخدام الجهاز لا تتوفّر بها حاليًا إمكانية الاتصال بالشبكة.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

إصدار بديل من connectToWifiNetwork(String, String) لا يمكن الاتصال به إلا عند استخدام الجهاز لا تتوفّر بها حاليًا إمكانية الاتصال بالشبكة.

abstract int createUser(String name)

قم بإنشاء مستخدم بالاسم المعين والعلامات الافتراضية 0.

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

إنشاء مستخدم باسم معين والعلامات المتوفرة

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

إنشاء مستخدم باسم معين والعلامات المتوفرة

abstract int createUserNoThrow(String name)

قم بإنشاء مستخدم بالاسم المعين والعلامات الافتراضية 0.

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

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

abstract void disableKeyguard()

محاولات لإيقاف حارس المفاتيح.

abstract boolean disableNetworkMonitor()

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

abstract boolean disconnectFromWifi()

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

abstract boolean doesFileExist(String deviceFilePath, int userId)

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

abstract File dumpHeap(String process, String devicePath)

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

abstract boolean enableNetworkMonitor()

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

abstract getActiveApexes()

استرجاع المعلومات حول ملفات APK التي تم تفعيلها على الجهاز

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

يحصل على لقطة شاشة من الجهاز.

abstract InputStreamSource getScreenshot(long displayId)

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

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)

اعرض الرقم التسلسلي المرتبط برقم تعريف المستخدم (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)

قم بإعلام الجهاز بالانتظار حتى اكتمال التقاط الصور.

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

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

abstract boolean removeAdmin(String componentName, int userId)

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

abstract void removeOwners()

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

abstract boolean removeUser(int userId)

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

abstract boolean setDeviceOwner(String componentName, int userId)

ضبط مكوِّن مشرف الجهاز كمالك للجهاز في مستخدم معيَّن.

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

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

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

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

abstract boolean startUser(int userId)

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

abstract boolean startUser(int userId, boolean waitFlag)

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

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

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

abstract boolean stopUser(int userId)

تؤدي هذه السياسة إلى إيقاف مستخدم معيّن.

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

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

abstract boolean switchUser(int userId)

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

abstract boolean switchUser(int userId, long timeout)

يُرجى التبديل إلى userId آخر ضمن المهلة المحدّدة كموعد نهائي.

abstract Bugreport takeBugreport()

يمكنك تسجيل تقرير خطأ وإرجاعه إلى عنصر Bugreport لمعالجته.

abstract String uninstallPackage(String packageName)

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

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

إذا كان ذلك متوقعًا، يُرجى الانتظار إلى أن تكتمل العملية.

الطرق العامة

مستخدم canSwitchToHeadlessSystem

public abstract boolean canSwitchToHeadlessSystemUser ()

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

المرتجعات
boolean

الرميات
DeviceNotAvailableException

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

public abstract boolean checkConnectivity ()

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

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

مربعات حوار clearErrors

public abstract boolean clearErrorDialogs ()

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

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

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

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

يتصل بشبكة Wi-Fi.

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

المعلمات
wifiSsidToPsk : خريطة لمعرّفات SSID لشبكات Wi-Fi وكلمات المرور
المرتجعات
boolean true في حال الاتصال بشبكة Wi-Fi بنجاح. false أو
الرميات
DeviceNotAvailableException في حال فقد الاتصال بالجهاز وتعذر تم استرداده.

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

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

يتصل بشبكة Wi-Fi.

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

المعلمات
wifiSsidToPsk : خريطة لمعرّفات SSID لشبكات Wi-Fi وكلمات المرور
scanSsid boolean: ما إذا كان سيتم البحث عن معرِّفات مجموعة الخدمات (SSID) المخفية لهذه الشبكة.
المرتجعات
boolean true في حال الاتصال بشبكة Wi-Fi بنجاح. false أو
الرميات
DeviceNotAvailableException في حال فقد الاتصال بالجهاز وتعذر تم استرداده.

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

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

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

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

الاتصال بشبكة Wi-FiNetworkIfبحاج

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

الاتصال بشبكة Wi-FiNetworkIfبحاج

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

إصدار بديل من connectToWifiNetwork(String, String) لا يمكن الاتصال به إلا عند استخدام الجهاز لا تتوفّر بها حاليًا إمكانية الاتصال بالشبكة.

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

إنشاء مستخدم

public abstract int createUser (String name)

قم بإنشاء مستخدم بالاسم المعين والعلامات الافتراضية 0.

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

إنشاء مستخدم

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

إنشاء مستخدم باسم معين والعلامات المتوفرة

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

إنشاء مستخدم

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

إنشاء مستخدم باسم معين والعلامات المتوفرة

المعلمات
name String: للمستخدم المطلوب إنشاؤه على الجهاز
guest boolean: تفعيل ميزة إبلاغ المستخدم عن الحدث --الضيف أثناء الإنشاء
ephemeral boolean: تفعيل علامة المستخدم -- المؤقتة أثناء الإنشاء
forTesting boolean: تفعيل علامة الاختبار --للاختبار أثناء الإنشاء
المرتجعات
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 ستتم إزالته.

إيقاف قفل المفاتيح

public abstract void disableKeyguard ()

محاولات لإيقاف حارس المفاتيح.

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

الرميات
DeviceNotAvailableException

إيقاف NetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

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

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

public abstract boolean disconnectFromWifi ()

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

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

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

حالة الملف

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

الحصول على ActiveApexes

public abstract  getActiveApexes ()

استرجاع المعلومات حول ملفات APK التي تم تفعيلها على الجهاز

المرتجعات
تم تفعيل 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

getAndroidId

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

الحصول على AppPackageInfos

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

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

المرتجعات
DeviceFoldableState

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

الحصول على المستخدم الحالي

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

الحصول على عنوان IP

public abstract String getIpAddress ()

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

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

الحصول على KeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

المرتجعات
KeyguardControllerState جهاز KeyguardControllerState يحتوي على نبذة عن حالة قفل المفاتيح وتعرض "Null" (فارغ) إذا لم يكن استعلام لوحة المفاتيح متاحًا.
الرميات
DeviceNotAvailableException في حال فقد الاتصال بالجهاز وتعذر تم استرداده.

الحصول على معرّف المستخدم الرئيسي

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

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

public abstract int getMaxNumberOfRunningUsersSupported ()

الحصول على الحد الأقصى لعدد الأجهزة المتوافقة التي تعمل بنظام التشغيل Android في آنٍ واحد وتكون القيم التلقائية 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 مرتبط بالجهاز قيد الاختبار.

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

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 للقطة الشاشة بالتنسيق، أو null إذا لم يتم إرسال لقطة الشاشة بنجاح.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

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

public abstract InputStreamSource getScreenshot (String format)

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

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

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

public abstract InputStreamSource getScreenshot (long displayId)

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

قائمة المهام: توسيع عمليات التنفيذ أعلاه لدعم "التنسيق" و"إعادة القياس"

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

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

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 القيمة المرتبطة بـ مساحة الاسم:مفتاح المستخدم. قيمة فارغة إذا لم يتم العثور عليها.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

الإعداد

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

الحصول على علامات المستخدم

public abstract int getUserFlags (int userId)

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

المعلمات
userId int

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

الحصول على معلومات المستخدم

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)

اعرض الرقم التسلسلي المرتبط برقم تعريف المستخدم (userId) إن تم العثور عليه، والذي يبلغ -10000 في أي حالات أخرى.

المعلمات
userId int

المرتجعات
int

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

تحتوي على ميزة

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 إذا لم يكن إذن التشغيل متاحًا على المنصة على الجهاز.

حزم install

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 إذا لم يكن إذن التشغيل متاحًا على المنصة على الجهاز.

حزم install

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

متوافق مع متعدد المستخدمين

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

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

public abstract boolean isPackageInstalled (String packageName)

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

المعلمات
packageName String

المرتجعات
boolean صحيح إذا تم الإبلاغ عن الحزمة كتثبيت. خطأ في الحالات الأخرى.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

قيد التشغيل

public abstract boolean isUserRunning (int userId)

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

المعلمات
userId int

المرتجعات
boolean True إذا كان المستخدم قيد التشغيل، وfalse في كل الحالات الأخرى.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

مستخدم ثانوي

public abstract boolean isUserSecondary (int userId)

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

المعلمات
userId int

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

يكون Userمرئي

public abstract boolean isUserVisible (int userId)

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

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

المعلمات
userId int

المرتجعات
boolean

الرميات
DeviceNotAvailableException

isUserمرئيOnDisplay

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

مع تفعيل Wi-Fi

public abstract boolean isWifiEnabled ()

اختبِر ما إذا تم تفعيل شبكة Wi-Fi.

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

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

معرِّفات قائمة العرض

public abstract  listDisplayIds ()

جمع قائمة أرقام تعريف الشاشات المتاحة على الجهاز كما تم الإبلاغ عنه بواسطة "dumpsys" SurfaceFlinger".

المرتجعات
قائمة الشاشات يُرجع الإعداد التلقائي دائمًا قيمة العرض التلقائي 0.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

listDisplayIdsForStartVisualBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

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

قائمة المستخدمين

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

إرسال إشعار

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

قم بإعلام الجهاز بالانتظار حتى اكتمال التقاط الصور.

المعلمات
waitPhase SnapuserdWaitPhase

جهاز استقبال عنصر التسجيل

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

إزالة مسؤول

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

إزالة مستخدم

public abstract boolean removeUser (int userId)

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

المعلمات
userId int: للمستخدم المطلوب إزالته
المرتجعات
boolean true إذا نجحنا في إزالة المستخدم، على false وإلا.
الرميات
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

ضبط الإعداد

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)

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

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

مستخدم البدء

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

مستخدم خلفية مرئي

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

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

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

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

إيقاف المستخدم

public abstract boolean stopUser (int userId)

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

المعلمات
userId int: للمستخدم المطلوب إيقافه.
المرتجعات
boolean true إذا تم إيقاف المستخدم بنجاح.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

إيقاف المستخدم

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

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

المعلمات
userId int: للمستخدم المطلوب إيقافه.
waitFlag boolean: سيجعل الأمر ينتظر حتى يتم إيقاف المستخدم.
forceFlag boolean: سيتم فرض إيقاف المستخدم.
المرتجعات
boolean true إذا تم إيقاف المستخدم بنجاح.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

مبدِّل المستخدِم

public abstract boolean switchUser (int userId)

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

المعلمات
userId int

المرتجعات
boolean صحيح في حال تطابق رقم تعريف المستخدم الجديد مع موفِّر رقم تعريف المستخدم. خطأ في الحالات الأخرى.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

مبدِّل المستخدِم

public abstract boolean switchUser (int userId, 
                long timeout)

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

المعلمات
userId int

timeout long: يجب الانتظار قبل عرض الخطأ "خطأ" لتعذُّر تغيير المستخدم.
المرتجعات
boolean صحيح في حال تطابق رقم تعريف المستخدم الجديد مع موفِّر رقم تعريف المستخدم. خطأ في الحالات الأخرى.
الرميات
com.android.tradefed.device.DeviceNotavailableException
DeviceNotAvailableException

TakeBugreport

public abstract Bugreport takeBugreport ()

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

انتظار لـ Snapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

إذا كان ذلك متوقعًا، يُرجى الانتظار إلى أن تكتمل العملية.

المعلمات
currentPhase SnapuserdWaitPhase

الرميات
DeviceNotAvailableException