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 () مسح آخر شبكة wifi متصلة. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) يتصل بشبكة واي فاي. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) يتصل بشبكة واي فاي. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) يتصل بشبكة واي فاي. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) يتصل بشبكة واي فاي. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) متغير من |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) متغير من |
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) يزيل |
abstract void | disableKeyguard () محاولات لتعطيل حارس المفاتيح. |
abstract boolean | disableNetworkMonitor () تعطيل مراقبة الشبكة على الجهاز. |
abstract boolean | disconnectFromWifi () قطع الاتصال بشبكة wifi. |
abstract boolean | doesFileExist (String deviceFilePath, int userId) طريقة مساعدة لتحديد ما إذا كان الملف الموجود على الجهاز موجودًا لمستخدم معين. |
abstract File | dumpHeap (String process, String devicePath) محاولة تفريغ الكومة من system_server. |
abstract boolean | enableNetworkMonitor () تمكين مراقبة الشبكة على الجهاز. |
abstract | getActiveApexes () جلب المعلومات حول APEXes المنشط على الجهاز. |
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 () احصل على الحد الأقصى لعدد المستخدمين المدعومين الذين يعملون في نفس الوقت. |
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) راجع |
abstract | getUninstallablePackageNames () قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. |
abstract int | getUserFlags (int userId) البحث عن إشارات مستخدم معين وإعادتها. |
abstract | getUserInfos () يحصل على خريطة useId |
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) installPackages ( packageFiles, boolean reinstall, String... extraArgs) قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة واحدة رئيسية وإضافية). |
default String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة رئيسية واحدة وإضافية مقسمة) الموجودة على جهاز Android. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة رئيسية واحدة وإضافية مقسمة) لمستخدم معين. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة رئيسية واحدة وإضافية مقسمة) لمستخدم معين. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة رئيسية واحدة وإضافية مقسمة) الموجودة على جهاز Android. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) 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 () يُرجع ما إذا كان الجهاز يسمح للمستخدمين ببدء الظهور في الخلفية في |
abstract boolean | isVisibleBackgroundUsersSupported () إرجاع ما إذا كان الجهاز يسمح للمستخدمين ببدء الظهور في الخلفية. |
abstract boolean | isWifiEnabled () اختبار ما إذا تم تمكين واي فاي. |
abstract | listDisplayIds () قم بتجميع قائمة معرفات شاشات العرض المتوفرة على الجهاز كما ورد في "dumpsys SurfaceFlinger". |
abstract | listDisplayIdsForStartingVisibleBackgroundUsers () يحصل على قائمة العروض التي يمكن استخدامها |
abstract | listUsers () يحصل على قائمة المستخدمين على الجهاز. |
abstract boolean | logBugreport (String dataName, ITestLogger listener) طريقة مساعدة لأخذ تقرير الأخطاء وتسجيله للصحفيين. |
default void | notifySnapuserd ( SnapuserdWaitPhase waitPhase) قم بإعلام الجهاز بالانتظار حتى اكتمال snapuserd. |
abstract void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) يقوم بتسجيل |
abstract boolean | removeAdmin (String componentName, int userId) قم بإزالة مسؤول الجهاز المحدد في مستخدم معين وإرجاع |
abstract void | removeOwners () قم بإزالة جميع مالكي ملفات تعريف الجهاز الحاليين بأقصى جهد. |
abstract boolean | removeUser (int userId) إزالة مستخدم معين من الجهاز. |
abstract boolean | setDeviceOwner (String componentName, int userId) قم بتعيين مكون مسؤول الجهاز كمالك للجهاز في مستخدم معين. |
abstract void | setSetting (String namespace, String key, String value) راجع |
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 () خذ تقرير الأخطاء وأعده داخل كائن |
abstract String | uninstallPackage (String packageName) قم بإلغاء تثبيت حزمة Android من الجهاز. |
abstract String | uninstallPackageForUser (String packageName, int userId) قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين. |
default void | waitForSnapuserd ( SnapuserdWaitPhase currentPhase) إذا كان متوقعًا، فانتظر حتى يكتمل snapuserd. |
public abstract boolean canSwitchToHeadlessSystemUser ()
إرجاع ما إذا كان مسموحًا بالتبديل إلى مستخدم النظام مقطوع الرأس.
عائدات | |
---|---|
boolean |
رميات | |
---|---|
DeviceNotAvailableException |
public abstract boolean checkConnectivity ()
تأكد من أن الجهاز لديه اتصال بالشبكة.
عائدات | |
---|---|
boolean | true إذا كان الجهاز لديه اتصال شبكة فعال، false أيضًا. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract boolean clearErrorDialogs ()
حاول استبعاد أي مربعات حوار خطأ معروضة حاليًا على واجهة مستخدم الجهاز.
عائدات | |
---|---|
boolean | true في حالة عدم وجود مربعات حوار أو تم مسح مربعات الحوار بنجاح. false خلاف ذلك. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract void clearLastConnectedWifiNetwork ()
مسح آخر شبكة wifi متصلة. يجب استدعاء هذا عند بدء استدعاء جديد لتجنب الاتصال بشبكة wifi المستخدمة في الاختبار السابق بعد إعادة تشغيل الجهاز.
public abstract boolean connectToWifiNetwork (wifiSsidToPsk)
يتصل بشبكة واي فاي.
يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بإحدى شبكات wifi الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi()
أو ITestDevice#clearLastConnectedWifiNetwork()
.
حدود | |
---|---|
wifiSsidToPsk |
عائدات | |
---|---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
يتصل بشبكة واي فاي.
يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بإحدى شبكات wifi الواردة في خريطة wifiSsidToPsk. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi()
أو ITestDevice#clearLastConnectedWifiNetwork()
.
حدود | |
---|---|
wifiSsidToPsk | |
scanSsid | boolean : ما إذا كان سيتم البحث عن معرفات SSID المخفية لهذه الشبكة. |
عائدات | |
---|---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
يتصل بشبكة واي فاي.
يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بشبكة wifi المحددة. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi()
أو ITestDevice#clearLastConnectedWifiNetwork()
.
حدود | |
---|---|
wifiSsid | String : wifi ssid للاتصال به |
wifiPsk | String : عبارة مرور PSK أو فارغة إذا كانت غير مشفرة |
عائدات | |
---|---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
يتصل بشبكة واي فاي.
يقوم بتشغيل wifi ويحظر حتى يتم إجراء اتصال ناجح بشبكة wifi المحددة. بمجرد إجراء الاتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل حتى يتم استدعاء ITestDevice#disconnectFromWifi()
أو ITestDevice#clearLastConnectedWifiNetwork()
.
حدود | |
---|---|
wifiSsid | String : wifi ssid للاتصال به |
wifiPsk | String : عبارة مرور PSK أو فارغة إذا كانت غير مشفرة |
scanSsid | boolean : ما إذا كان سيتم البحث عن SSID المخفي لهذه الشبكة. |
عائدات | |
---|---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
متغير من connectToWifiNetwork(String, String)
الذي يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.
حدود | |
---|---|
scanSsid | boolean : ما إذا كان سيتم البحث عن SSID المخفي لهذه الشبكة |
عائدات | |
---|---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. false خلاف ذلك |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
متغير من connectToWifiNetwork(String, String)
الذي يتصل فقط إذا كان الجهاز لا يحتوي حاليًا على اتصال بالشبكة.
عائدات | |
---|---|
boolean | true إذا تم الاتصال بشبكة wifi بنجاح. 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 : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء |
عائدات | |
---|---|
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 : قم بتمكين علامة المستخدم --ephemeral أثناء الإنشاء |
forTesting | boolean : قم بتمكين علامة الاختبار --for-testing أثناء الإنشاء |
عائدات | |
---|---|
int | معرف المستخدم الذي تم إنشاؤه |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int createUserNoThrow (String name)
أنشئ مستخدمًا باسم محدد وإشارات افتراضية 0.
حدود | |
---|---|
name | String : من المستخدم لإنشائها على الجهاز |
عائدات | |
---|---|
int | العدد الصحيح لمعرف المستخدم الذي تم إنشاؤه أو -1 للخطأ. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
يزيل IDeviceActionReceiver
المسجل .
حدود | |
---|---|
deviceActionReceiver | IDeviceActionReceiver : IDeviceActionReceiver الذي ستتم إزالته. |
public abstract void disableKeyguard ()
محاولات لتعطيل حارس المفاتيح.
انتظر أولاً حتى يصبح إرسال الإدخال جاهزًا، ويحدث هذا في نفس الوقت تقريبًا عندما يقوم الجهاز بالإبلاغ عن BOOT_COMPLETE، بشكل غير متزامن على ما يبدو، لأن تنفيذ إطار العمل الحالي له حالة سباق عرضية. ثم يتم إرسال الأمر لإغلاق حارس المفاتيح (يعمل على المفاتيح غير الآمنة فقط)
رميات | |
---|---|
DeviceNotAvailableException |
public abstract boolean disableNetworkMonitor ()
تعطيل مراقبة الشبكة على الجهاز.
عائدات | |
---|---|
boolean | true إذا تم تعطيل المراقبة بنجاح. false إذا فشلت. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract boolean disconnectFromWifi ()
قطع الاتصال بشبكة wifi.
إزالة جميع الشبكات من قائمة الشبكات المعروفة وتعطيل wifi.
عائدات | |
---|---|
boolean | true إذا تم قطع الاتصال بشبكة wifi بنجاح. false إذا فشل قطع الاتصال. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract boolean doesFileExist (String deviceFilePath, int userId)
طريقة مساعدة لتحديد ما إذا كان الملف الموجود على الجهاز موجودًا لمستخدم معين.
حدود | |
---|---|
deviceFilePath | String : المسار المطلق للملف الموجود على الجهاز المراد فحصه |
userId | int : معرف المستخدم الذي يتم من خلاله التحقق من وجود الملف |
عائدات | |
---|---|
boolean | true في حالة وجود الملف، false في غير ذلك. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract File dumpHeap (String process, String devicePath)
محاولة تفريغ الكومة من system_server. تقع على عاتق المتصل مسؤولية تنظيف الملف الذي تم تفريغه.
حدود | |
---|---|
process | String : اسم عملية الجهاز المطلوب تفريغها. |
devicePath | String : المسار الموجود على الجهاز حيث سيتم وضع التفريغ. يجب أن يكون هذا موقعًا تسمح به الأذونات. |
عائدات | |
---|---|
File | ERROR(/File) الذي يحتوي على التقرير. فارغة إذا فشل شيء ما. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean enableNetworkMonitor ()
تمكين مراقبة الشبكة على الجهاز.
عائدات | |
---|---|
boolean | true إذا تم تمكين المراقبة بنجاح. false إذا فشلت. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstractgetActiveApexes ()
جلب المعلومات حول APEXes المنشط على الجهاز.
عائدات | |
---|---|
ERROR(/Set) من ApexInfo المنشط حاليًا على الجهاز |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetAllSettings (String namespace)
إرجاع أزواج القيمة الرئيسية لمساحة الاسم المطلوبة.
حدود | |
---|---|
namespace | String : يجب أن تكون واحدة من {"system"، "secure"، "global"} |
عائدات | |
---|---|
خريطة أزواج القيمة الرئيسية. فارغة إذا كانت مساحة الاسم غير مدعومة. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract String getAndroidId (int userId)
ابحث عن معرف android المرتبط بمعرف المستخدم وأعده، ويكون فارغًا إذا لم يتم العثور عليه.
حدود | |
---|---|
userId | int |
عائدات | |
---|---|
String |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetAndroidIds ()
قم بإنشاء خريطة لمعرفات android التي تم العثور عليها مطابقة لمعرفات المستخدمين. لا يوجد ضمان بأن كل معرف مستخدم سيعثر على معرف android مرتبط بهذه الوظيفة، لذا قد تتطابق بعض معرفات المستخدمين مع قيمة فارغة.
عائدات | |
---|---|
تم العثور على خريطة لمعرفات android المطابقة لمعرفات المستخدمين. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract PackageInfo getAppPackageInfo (String packageName)
جلب معلومات حول الحزمة المثبتة على الجهاز.
حدود | |
---|---|
packageName | String |
عائدات | |
---|---|
PackageInfo | PackageInfo أو null إذا تعذر استرداد المعلومات |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetAppPackageInfos ()
جلب معلومات الحزم المثبتة على الجهاز.
عائدات | |
---|---|
ERROR(/List) من PackageInfo مثبت على الجهاز. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract InputStreamSource getBugreport ()
استرداد تقرير الأخطاء من الجهاز.
يتم ضمان تنفيذ ذلك لمواصلة العمل على جهاز بدون بطاقة sdcard (أو حيث لم يتم تثبيت بطاقة sdcard بعد).
عائدات | |
---|---|
InputStreamSource | InputStreamSource الذي سينتج محتويات تقرير الأخطاء عند الطلب. في حالة الفشل، سينتج InputStreamSource ERROR(/InputStream) فارغًا. |
public abstract InputStreamSource getBugreportz ()
يسترد تقرير الأخطاء من الجهاز. يحتوي تقرير الأخطاء بتنسيق Zip على تقرير الأخطاء الرئيسي وملفات السجل الأخرى المفيدة لتصحيح الأخطاء.
مدعوم فقط لـ "إصدار adb" > 1.0.36
عائدات | |
---|---|
InputStreamSource | InputStreamSource للملف المضغوط الذي يحتوي على تقرير الأخطاء، ويُرجع قيمة فارغة في حالة الفشل. |
public abstract DeviceFoldableState getCurrentFoldableState ()
يُرجع الحالة الحالية القابلة للطي للجهاز أو فارغة في حالة حدوث بعض المشكلات.
عائدات | |
---|---|
DeviceFoldableState |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int getCurrentUser ()
قم بإرجاع معرف المستخدم الحالي قيد التشغيل. في حالة الخطأ، قم بإرجاع -10000.
عائدات | |
---|---|
int |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetFoldableStates ()
إرجاع قائمة الحالات القابلة للطي على الجهاز. يمكن الحصول عليها باستخدام "حالات الطباعة cmd devices_state".
عائدات | |
---|---|
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetInstalledPackageNames ()
جلب أسماء حزم التطبيقات الموجودة على الجهاز.
عائدات | |
---|---|
ERROR(/Set) لأسماء حزم String المثبتة حاليًا على الجهاز. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract String getIpAddress ()
يحصل على عنوان IP الخاص بالجهاز.
عائدات | |
---|---|
String | عنوان IP الخاص بالجهاز، أو null إذا لم يكن للجهاز عنوان IP |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract KeyguardControllerState getKeyguardState ()
قم بإرجاع كائن للحصول على الحالة الحالية للوحة المفاتيح أو فارغة إذا لم تكن مدعومة.
عائدات | |
---|---|
KeyguardControllerState | KeyguardControllerState الذي يحتوي على لقطة لحالة حارس المفاتيح ويقوم بإرجاع Null إذا كان استعلام Keyguard غير مدعوم. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract Integer getMainUserId ()
إرجاع معرف المستخدم الرئيسي.
عائدات | |
---|---|
Integer | معرف المستخدم للمستخدم الرئيسي إذا كان هناك واحد، وفارغ إذا لم يكن هناك مستخدم رئيسي. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceRuntimeException | إذا كان الإخراج من الجهاز ليس كما هو متوقع. |
DeviceNotAvailableException |
public abstractgetMainlineModuleInfo ()
احصل على معلومات حول الوحدات الرئيسية المثبتة على الجهاز.
عائدات | |
---|---|
ERROR(/Set) من وحدات String الرئيسية المثبتة حاليًا على الجهاز. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int getMaxNumberOfRunningUsersSupported ()
احصل على الحد الأقصى لعدد المستخدمين المدعومين الذين يعملون في نفس الوقت. الإعدادات الافتراضية إلى 0.
عائدات | |
---|---|
int | عدد صحيح يشير إلى عدد المستخدمين الذين يعملون في نفس الوقت |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int getMaxNumberOfUsersSupported ()
احصل على الحد الأقصى لعدد المستخدمين المدعومين. الإعدادات الافتراضية إلى 0.
عائدات | |
---|---|
int | عدد صحيح يشير إلى عدد المستخدمين المدعومين |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract TestDeviceOptions getOptions ()
جلب خيارات الاختبار للجهاز.
عائدات | |
---|---|
TestDeviceOptions | TestDeviceOptions المتعلقة بالجهاز قيد الاختبار. |
public abstract Integer getPrimaryUserId ()
إرجاع معرف المستخدم الأساسي.
عائدات | |
---|---|
Integer | معرف المستخدم للمستخدم الأساسي إذا كان هناك واحد، وفارغ إذا لم يكن هناك مستخدم أساسي. |
رميات | |
---|---|
| 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)
يلتقط لقطة شاشة من الجهاز. يوصى باستخدام getScreenshot(format) بدلاً من ذلك مع تشفير JPEG للحجم الأصغر
حدود | |
---|---|
format | String : مدعومة PNG، JPEG |
عائدات | |
---|---|
InputStreamSource | InputStreamSource للقطة الشاشة بالتنسيق، أو null إذا لم تكن لقطة الشاشة ناجحة. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract InputStreamSource getScreenshot (long displayId)
يلتقط لقطة شاشة من الجهاز المحدد بمعرف العرض. التنسيق هو PNG.
TODO: توسيع التطبيقات المذكورة أعلاه لدعم "التنسيق" و"إعادة القياس"
حدود | |
---|---|
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 |
public abstractgetUninstallablePackageNames ()
قم بإحضار أسماء حزم التطبيقات التي يمكن إلغاء تثبيتها. يتم تعريف هذا حاليًا على أنه الحزم غير التابعة للنظام، وحزم النظام المحدثة.
عائدات | |
---|---|
ERROR(/Set) لأسماء حزم String القابلة للإلغاء والمثبتة حاليًا على الجهاز. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract int getUserFlags (int userId)
البحث عن إشارات مستخدم معين وإعادتها. يتم تعريف العلامات في فئة "android.content.pm.UserInfo" في مشروع Android مفتوح المصدر.
حدود | |
---|---|
userId | int |
عائدات | |
---|---|
int | العلامات المرتبطة بمعرف المستخدم المقدم إذا تم العثور عليه، -10000 في أي حالات أخرى. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractgetUserInfos ()
يحصل على خريطة useId UserInfo
على الجهاز. سيتم طرح DeviceRuntimeException
إذا لم يكن الإخراج من الجهاز كما هو متوقع.
عائدات | |
---|---|
قائمة كائنات UserInfo. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException |
public abstract int getUserSerialNumber (int userId)
إعادة الرقم التسلسلي المرتبط بمعرف المستخدم إذا وجد، -10000 في أي حالات أخرى.
حدود | |
---|---|
userId | int |
عائدات | |
---|---|
int |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean hasFeature (String feature)
تحقق مما إذا كانت الميزة متوفرة على الجهاز.
حدود | |
---|---|
feature | String : التنسيق الذي يجب أن يكون "الميزة: |
عائدات | |
---|---|
boolean | صحيح إذا تم العثور على الميزة، وخطأ فيما عدا ذلك. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
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 | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
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 | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
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 | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
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 | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
public String installPackages (packageFiles, boolean reinstall, String... extraArgs)
قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة واحدة رئيسية وإضافية). راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم APK إلى عدة ملفات.
حدود | |
---|---|
packageFiles | |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
extraArgs | String : وسيطات إضافية اختيارية للتمرير. راجع "adb Shell PM -h" للتعرف على الخيارات المتاحة. |
عائدات | |
---|---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
UnsupportedOperationException | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
public String installPackages (packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة رئيسية واحدة وإضافية مقسمة) الموجودة على جهاز Android. راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم APK إلى عدة ملفات.
ملاحظة: حالات الاستخدام التي تتطلب تحكمًا صريحًا في منح إذن وقت التشغيل أثناء التثبيت فقط هي التي يجب أن تستدعي هذه الوظيفة.
حدود | |
---|---|
packageFiles | |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
grantPermissions | boolean : إذا كان يجب منح كافة أذونات وقت التشغيل في وقت التثبيت |
extraArgs | String : وسيطات إضافية اختيارية للتمرير. راجع "adb Shell PM -h" للتعرف على الخيارات المتاحة. |
عائدات | |
---|---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
UnsupportedOperationException | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
public String installPackagesForUser (packageFiles, boolean reinstall, int userId, String... extraArgs)
قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة رئيسية واحدة وإضافية مقسمة) لمستخدم معين. راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم APK إلى عدة ملفات.
حدود | |
---|---|
packageFiles | |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
userId | int : معرف المستخدم الصحيح الذي سيتم التثبيت له. |
extraArgs | String : وسيطات إضافية اختيارية للتمرير. راجع "adb Shell PM -h" للتعرف على الخيارات المتاحة. |
عائدات | |
---|---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
UnsupportedOperationException | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
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 | |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
grantPermissions | boolean : إذا كان يجب منح كافة أذونات وقت التشغيل في وقت التثبيت |
userId | int : معرف المستخدم الصحيح الذي سيتم التثبيت له. |
extraArgs | String : وسيطات إضافية اختيارية للتمرير. راجع "adb Shell PM -h" للتعرف على الخيارات المتاحة. |
عائدات | |
---|---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
UnsupportedOperationException | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
public String installRemotePackages (remoteApkPaths, boolean reinstall, String... extraArgs)
قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة رئيسية واحدة وإضافية مقسمة) الموجودة على جهاز Android. راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم APK إلى عدة ملفات.
حدود | |
---|---|
remoteApkPaths | |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
extraArgs | String : وسيطات إضافية اختيارية للتمرير. راجع "adb Shell PM -h" للتعرف على الخيارات المتاحة. |
عائدات | |
---|---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
UnsupportedOperationException | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
public String installRemotePackages (remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
قم بتثبيت تطبيق Android يتكون من عدة ملفات APK (حزمة رئيسية واحدة وإضافية مقسمة) الموجودة على جهاز Android. راجع "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم APK إلى عدة ملفات.
ملاحظة: حالات الاستخدام التي تتطلب تحكمًا صريحًا في منح إذن وقت التشغيل أثناء التثبيت فقط هي التي يجب أن تستدعي هذه الوظيفة.
حدود | |
---|---|
remoteApkPaths | |
reinstall | boolean : true إذا كان يجب إجراء إعادة التثبيت |
grantPermissions | boolean : إذا كان يجب منح كافة أذونات وقت التشغيل في وقت التثبيت |
extraArgs | String : وسيطات إضافية اختيارية للتمرير. راجع "adb Shell PM -h" للتعرف على الخيارات المتاحة. |
عائدات | |
---|---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
UnsupportedOperationException | إذا كان إذن وقت التشغيل غير مدعوم من قبل النظام الأساسي الموجود على الجهاز. |
public abstract boolean isHeadlessSystemUserMode ()
إرجاع ما إذا كان الجهاز يستخدم وضع مستخدم النظام بدون رأس.
عائدات | |
---|---|
boolean |
رميات | |
---|---|
DeviceNotAvailableException |
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 | صحيح إذا كان المستخدم قيد التشغيل، وخطأ في كل الحالات الأخرى. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
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 |
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 |
public abstract boolean isWifiEnabled ()
اختبار ما إذا تم تمكين واي فاي.
يتحقق مما إذا تم تمكين wifi على الجهاز. مفيد لتأكيد حالة wifi قبل الاختبارات التي لا ينبغي تشغيلها باستخدام wifi، على سبيل المثال اختبارات بيانات الهاتف المحمول.
عائدات | |
---|---|
boolean | true إذا تم تمكين wifi. false إذا تم تعطيلها |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstractlistDisplayIds ()
قم بتجميع قائمة معرفات شاشات العرض المتوفرة على الجهاز كما ورد في "dumpsys SurfaceFlinger".
عائدات | |
---|---|
قائمة المعروضات. يقوم الخيار الافتراضي دائمًا بإرجاع العرض الافتراضي 0. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstractlistDisplayIdsForStartingVisibleBackgroundUsers ()
يحصل على قائمة العروض التي يمكن استخدامها start a user visible in the background
.
عائدات | |
---|---|
رميات | |
---|---|
DeviceNotAvailableException |
public abstractlistUsers ()
يحصل على قائمة المستخدمين على الجهاز. سيتم طرح DeviceRuntimeException
إذا لم يكن الإخراج من الجهاز كما هو متوقع.
عائدات | |
---|---|
قائمة معرفات المستخدمين. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException |
public abstract boolean logBugreport (String dataName, ITestLogger listener)
طريقة مساعدة لأخذ تقرير الأخطاء وتسجيله للصحفيين.
حدود | |
---|---|
dataName | String : الاسم الذي سيتم بموجبه الإبلاغ عن تقرير الأخطاء. |
listener | ITestLogger : ITestLogger لتسجيل تقرير الأخطاء. |
عائدات | |
---|---|
boolean | صحيح إذا تم التسجيل بنجاح، وخطأ فيما عدا ذلك. |
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
قم بإعلام الجهاز بالانتظار حتى اكتمال snapuserd.
حدود | |
---|---|
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 | صحيح إذا نجحنا في إزالة المستخدم، وخطأ فيما عدا ذلك. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
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 | صحيح إذا تم إيقاف المستخدم بنجاح. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
إيقاف مستخدم معين. من الممكن توفير إشارات إضافية لانتظار تفعيل العملية وإنهاء المستخدم بالقوة. لا يمكن إيقاف المستخدم الحالي ومستخدم النظام.
حدود | |
---|---|
userId | int : من المستخدم أن يتوقف. |
waitFlag | boolean : سيجعل الأمر ينتظر حتى يتم إيقاف المستخدم. |
forceFlag | boolean : سيفرض إيقاف المستخدم. |
عائدات | |
---|---|
boolean | صحيح إذا تم إيقاف المستخدم بنجاح. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean switchUser (int userId)
قم بالتبديل إلى معرف مستخدم آخر بمهلة افتراضية. switchUser(int, long)
.
حدود | |
---|---|
userId | int |
عائدات | |
---|---|
boolean | صحيح إذا كان معرف المستخدم الجديد يتطابق مع موفر معرف المستخدم. باطل غير ذلك. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract boolean switchUser (int userId, long timeout)
قم بالتبديل إلى معرف مستخدم آخر مع تحديد المهلة المحددة كموعد نهائي. محاولة تعطيل حماية المفاتيح بعد نجاح تغيير المستخدم.
حدود | |
---|---|
userId | int |
timeout | long : للانتظار قبل إرجاع الخطأ لفشل تبديل المستخدم. |
عائدات | |
---|---|
boolean | صحيح إذا كان معرف المستخدم الجديد يتطابق مع موفر معرف المستخدم. باطل غير ذلك. |
رميات | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
public abstract Bugreport takeBugreport ()
خذ تقرير الأخطاء وأعده داخل كائن Bugreport
للتعامل معه. العودة فارغة في حالة الإصدار. يجب تنظيف الملف المشار إليه في كائن Bugreport عبر Bugreport.close()
.
عائدات | |
---|---|
Bugreport |
public abstract String uninstallPackage (String packageName)
قم بإلغاء تثبيت حزمة Android من الجهاز.
حدود | |
---|---|
packageName | String : حزمة Android المراد إلغاء تثبيتها |
عائدات | |
---|---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public abstract String uninstallPackageForUser (String packageName, int userId)
قم بإلغاء تثبيت حزمة Android من الجهاز لمستخدم معين.
حدود | |
---|---|
packageName | String : حزمة Android المراد إلغاء تثبيتها |
userId | int : معرف المستخدم الصحيح الذي سيتم إلغاء تثبيته. |
عائدات | |
---|---|
String | String تحتوي على رمز خطأ، أو null في حالة النجاح. |
رميات | |
---|---|
DeviceNotAvailableException | إذا انقطع الاتصال بالجهاز ولا يمكن استعادته. |
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
إذا كان متوقعًا، فانتظر حتى يكتمل snapuserd.
حدود | |
---|---|
currentPhase | SnapuserdWaitPhase |
رميات | |
---|---|
DeviceNotAvailableException |
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2024-04-02 (حسب التوقيت العالمي المتفَّق عليه)