TestDevice

public class TestDevice
extends NativeDevice

java.lang.Object
   ↳ com.android.tradefed.device.NativeDevice
     ↳ com.android.tradefed.device.TestDevice

تنفيذ ITestDevice لجهاز Android كامل الميزات

ملخّص

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

class TestDevice.MicrodroidBuilder

أداة إنشاء تُستخدَم لإنشاء Microdroid TestDevice. 

الثوابت

String DISMISS_KEYGUARD_CMD

الأوامر التي يمكن استخدامها لإغلاق شاشة القفل

طُرق وضع التصميم العامة

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

الإجراءات العامة

String adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)

تثبيت حزمة Android على الجهاز باستخدام أمر adb

String adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

تثبيت حزمة Android على الجهاز باستخدام أمر adb

boolean canSwitchToHeadlessSystemUser()

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

boolean clearErrorDialogs()

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

int createUser(String name)

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

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

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

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

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

int createUserNoThrow(String name)

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

void disableKeyguard()

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

boolean doesFileExist(String deviceFilePath, int userId)

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

boolean doesFileExist(String deviceFilePath)

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

File dumpHeap(String process, String devicePath)

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

Set<ITestDevice.ApexInfo> getActiveApexes()

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

Map<String, String> getAllSettings(String namespace)

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

String getAndroidId(int userId)

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

Map<Integer, String> getAndroidIds()

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

PackageInfo getAppPackageInfo(String packageName)

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

List<PackageInfo> getAppPackageInfos()

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

InputStreamSource getBugreport()

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

InputStreamSource getBugreportz()

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

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

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

Set<DeviceFoldableState> getFoldableStates()

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

Set<String> getInstalledPackageNames()

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

KeyguardControllerState getKeyguardState()

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

Integer getMainUserId()

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

Set<String> getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

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

int getMaxNumberOfUsersSupported(String userType)

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

int getMaxNumberOfUsersSupported()

احصل على الحد الأقصى لعدد المستخدمين القابلين للتبديل، باستثناء الضيوف.

Integer getPrimaryUserId()

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

int getRemainingCreatableUserCount(String userType)

تعرِض هذه السمة عدد المستخدمين من نوع المستخدم المحدّد الذين يمكن إنشاؤهم على هذا الجهاز.

InputStreamSource getScreenshot(Long displayId, String format, boolean rescale)

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

InputStreamSource getScreenshot(String format, boolean rescale)

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

InputStreamSource getScreenshot(String format)

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

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot()

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

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

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

String getSetting(String namespace, String key)

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

Set<String> getUninstallablePackageNames()

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

int getUserFlags(int userId)

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

Map<Integer, UserInfo> getUserInfos()

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

int getUserSerialNumber(int userId)

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

int getUserVisibleOnDisplay(int displayId)

تعرض هذه السمة رقم تعريف المستخدم المرئي على الشاشة المحدّدة.

boolean hasFeature(String feature)

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

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

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

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

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

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

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

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

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

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

تثبيت حِزم APK في الوضع التدريجي

String installPackages(List<File> packageFiles, boolean reinstall, String... extraArgs)

String installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)

String installPackagesForUser(List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

boolean isAppEnumerationSupported()

التحقّق مما إذا كانت المنصة على الجهاز تتيح تعداد التطبيقات

boolean isHeadlessSystemUserMode()

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

boolean isMainUserPermanentAdmin()

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

boolean isMultiUserSupported()

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

boolean isPackageInstalled(String packageName, String userId)

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

boolean isPackageInstalled(String packageName)

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

boolean isUserRunning(int userId)

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

boolean isUserSecondary(int userId)

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

boolean isUserVisible(int userId)

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

boolean isUserVisibleOnDisplay(int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

boolean isVisibleBackgroundUsersSupported()

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

Set<Long> listDisplayIds()

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

Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers()

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

ArrayList<Integer> listUsers()

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

boolean logBugreport(String dataName, ITestLogger listener)

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

void notifySnapuserd(SnapuserdWaitPhase waitPhase)
void postInvocationTearDown(Throwable exception)

خطوات إضافية لتنظيف البيانات المطلوبة الخاصة بالجهاز سيتم تنفيذها بعد اكتمال عملية الاستدعاء.

boolean removeAdmin(String componentName, int userId)

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

void removeOwners()

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

boolean removeUser(int userId)

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

boolean setDeviceOwner(String componentName, int userId)

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

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

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

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

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

void shutdownMicrodroid(ITestDevice microdroidDevice)

يؤدي هذا الإجراء إلى إيقاف جهاز microdroid، إذا كان متوفّرًا.

boolean startUser(int userId)

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

boolean startUser(int userId, boolean waitFlag)

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

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

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

boolean stopUser(int userId)

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

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

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

boolean supportsMicrodroid()

يتحقّق من الشروط المسبقة لتشغيل جهاز microdroid.

boolean supportsMicrodroid(boolean protectedVm)

يتحقّق من الشروط المسبقة لتشغيل جهاز microdroid.

boolean switchUser(int userId)

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

boolean switchUser(int userId, long timeout)

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

Bugreport takeBugreport()

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

String uninstallPackage(String packageName)

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

String uninstallPackageForUser(String packageName, int userId)

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

void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

طُرق محمية

AaptParser createParser(File appFile)
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

نفِّذ عملية إعادة تشغيل adb.

InputStreamSource getBugreportInternal()
File getBugreportzInternal()

طريقة مساعدة داخلية للحصول على ملف bugreportz zip كـ File.

long getCheckNewUserSleep()

يتم عرضها للاختبار.

long getHostCurrentTime()

معرَّض للاختبار

void prePostBootSetup()

تسمح هذه السمة لكل نوع جهاز (AndroidNativeDevice وTestDevice) بتجاوز هذه الطريقة لإعدادات محدّدة بعد التشغيل.

الثوابت

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

الأوامر التي يمكن استخدامها لإغلاق شاشة القفل

Constant Value: "input keyevent 82"

طُرق وضع التصميم العامة

TestDevice

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

الإجراءات العامة

adbInstallPackage

public String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

تثبيت حزمة Android على الجهاز باستخدام أمر adb

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

adbInstallPackage

public String adbInstallPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

تثبيت حزمة Android على الجهاز باستخدام أمر adb

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

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

المرتجعات
boolean

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

clearErrorDialogs

public boolean clearErrorDialogs ()

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

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

createUser

public int createUser (String name)

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

المعلَمات
name ‫String: اسم المستخدم الذي سيتم إنشاؤه على الجهاز
المرتجعات
int العدد الصحيح لرقم تعريف المستخدم الذي تم إنشاؤه
عمليات الطرح
DeviceNotAvailableException
IllegalStateException

createUser

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

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

المعلَمات
name ‫String: اسم المستخدم الذي سيتم إنشاؤه على الجهاز
guest boolean: تفعيل علامة المستخدم --guest أثناء الإنشاء
ephemeral ‫boolean: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء
المرتجعات
int معرّف المستخدم الذي تم إنشاؤه
عمليات الطرح
DeviceNotAvailableException
IllegalStateException

createUser

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

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

المعلَمات
name ‫String: اسم المستخدم الذي سيتم إنشاؤه على الجهاز
guest boolean: تفعيل علامة المستخدم --guest أثناء الإنشاء
ephemeral ‫boolean: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء
forTesting ‫boolean: تفعيل العلامة التجريبية --for-testing أثناء الإنشاء
المرتجعات
int معرّف المستخدم الذي تم إنشاؤه
عمليات الطرح
DeviceNotAvailableException
IllegalStateException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

disableKeyguard

public void disableKeyguard ()

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

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

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

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

المعلَمات
process String: اسم عملية الجهاز التي سيتم تفريغ الذاكرة المؤقتة فيها.
devicePath ‫String: المسار على الجهاز الذي سيتم وضع ملف التفريغ فيه يجب أن يكون هذا الموقع الجغرافي موقعًا تسمح الأذونات بتسجيل الفيديو فيه.
المرتجعات
File File الذي يحتوي على التقرير قيمة فارغة في حال حدوث خطأ
عمليات الطرح
DeviceNotAvailableException

getActiveApexes

public Set<ITestDevice.ApexInfo> getActiveApexes ()

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

المرتجعات
Set<ITestDevice.ApexInfo> Set من إجمالي ApexInfo بطاقة تم تفعيلها حاليًا على الجهاز
عمليات الطرح
DeviceNotAvailableException

getAllSettings

public Map<String, String> getAllSettings (String namespace)

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

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

getAndroidId

public String getAndroidId (int userId)

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

المعلَمات
userId int

القيم المُعادة
String

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

getAndroidIds

public Map<Integer, String> getAndroidIds ()

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

المرتجعات
Map<Integer, String> خريطة لأرقام تعريف Android التي تم العثور عليها مطابقة لأرقام تعريف المستخدمين
عمليات الطرح
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

المعلَمات
packageName String

المرتجعات
PackageInfo PackageInfo أو null في حال تعذّر استرداد المعلومات
عمليات الطرح
DeviceNotAvailableException

getAppPackageInfos

public List<PackageInfo> getAppPackageInfos ()

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

المرتجعات
List<PackageInfo> List من PackageInfo المثبَّتة على الجهاز
عمليات الطرح
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

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

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

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

getBugreportz

public InputStreamSource getBugreportz ()

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

لا تتوفّر إلا للإصدارات الأحدث من 1.0.36 من "أداة تصحيح أخطاء Android"

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

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

المرتجعات
DeviceFoldableState

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

getCurrentUser

public int getCurrentUser ()

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

المرتجعات
int

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

getFoldableStates

public Set<DeviceFoldableState> getFoldableStates ()

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

المرتجعات
Set<DeviceFoldableState>

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

getInstalledPackageNames

public Set<String> getInstalledPackageNames ()

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

المرتجعات
Set<String> ‫Set من أسماء حِزم String المثبَّتة حاليًا على الجهاز
عمليات الطرح
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

المرتجعات
KeyguardControllerState KeyguardControllerState يحتوي على لقطة لحالة شاشة القفل، ويعرض القيمة Null إذا كان طلب البحث عن شاشة القفل غير متاح.
عمليات الطرح
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

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

المرتجعات
Integer معرّف المستخدم الرئيسي إذا كان هناك مستخدم رئيسي، والقيمة null إذا لم يكن هناك مستخدم رئيسي
عمليات الطرح
DeviceNotAvailableException

getMainlineModuleInfo

public Set<String> getMainlineModuleInfo ()

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

المرتجعات
Set<String> Set من وحدات String الرئيسية المثبَّتة حاليًا على الجهاز
عمليات الطرح
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

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

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported (String userType)

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

المعلَمات
userType ‫String: نوع المستخدم، كما هو محدّد في UserManager، مثل "android.os.usertype.full.SECONDARY".
المرتجعات
int عدد صحيح يشير إلى عدد المستخدمين المسموح بهم من نوع المستخدم المحدّد
عمليات الطرح
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

احصل على الحد الأقصى لعدد المستخدمين القابلين للتبديل، باستثناء الضيوف. بعد الإصدار 36 من واجهة برمجة التطبيقات، لا يتضمّن المستخدمين غير القابلين للتبديل (مثل الملفات الشخصية). القيمة التلقائية هي 0.

المرتجعات
int عدد صحيح يشير إلى عدد المستخدمين القابلين للتبديل
عمليات الطرح
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

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

المرتجعات
Integer معرّف المستخدم الأساسي إذا كان هناك مستخدم أساسي، وقيمة فارغة إذا لم يكن هناك مستخدم أساسي
عمليات الطرح
DeviceNotAvailableException

getRemainingCreatableUserCount

public int getRemainingCreatableUserCount (String userType)

تعرِض هذه السمة عدد المستخدمين من نوع المستخدم المحدّد الذين يمكن إنشاؤهم على هذا الجهاز.

المعلَمات
userType ‫String: نوع المستخدم، كما هو محدّد في UserManager، مثل "android.os.usertype.full.SECONDARY".
المرتجعات
int عدد المستخدمين من نوع المستخدم المحدّد الذين يمكن إضافتهم
عمليات الطرح
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

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

المعلَمات
displayId Long: المعرّف المعروض للشاشة التي سيتم أخذ لقطة شاشة منها.
format String: PNG أو JPEG
rescale ‫boolean: ما إذا كان يجب إعادة تحجيم لقطة الشاشة لتقليل حجم الصورة الناتجة
المرتجعات
InputStreamSource InputStreamSource من لقطة الشاشة بالتنسيق، أو null إذا لم تنجح لقطة الشاشة.
عمليات الطرح
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

getScreenshot

public InputStreamSource getScreenshot (String format)

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

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

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

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

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

getScreenshot

public InputStreamSource getScreenshot ()

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

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

getSetting

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

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

المعلَمات
userId int

namespace String

key String

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

getSetting

public String getSetting (String namespace, 
                String key)

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

المعلَمات
namespace String

key String

القيم المُعادة
String

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

getUninstallablePackageNames

public Set<String> getUninstallablePackageNames ()

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

المرتجعات
Set<String> ‫Set من أسماء حِزم String غير القابلة للإزالة والمثبَّتة حاليًا على الجهاز.
عمليات الطرح
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

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

المعلَمات
userId int

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

getUserInfos

public Map<Integer, UserInfo> getUserInfos ()

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

المرتجعات
Map<Integer, UserInfo> قائمة عناصر UserInfo
عمليات الطرح
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

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

المعلَمات
userId int

القيم المُعادة
int

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

getUserVisibleOnDisplay

public int getUserVisibleOnDisplay (int displayId)

تعرض هذه السمة رقم تعريف المستخدم المرئي على الشاشة المحدّدة.

المعلَمات
displayId ‫int: رقم تعريف شاشة العرض
المرتجعات
int معرّف المستخدم المرئي على الشاشة المحدّدة. ولا يفرّق بين مستخدم الخلفية المرئي ومستخدم المقدّمة الحالي لأنّ كلا النوعين مرئيان. للتفريق بينهما، قارِنها بنتيجة استدعاء getCurrentUser().
عمليات الطرح
DeviceNotAvailableException

hasFeature

public boolean hasFeature (String feature)

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

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

installPackage

public 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

installPackage

public 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

installPackageForUser

public 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

installPackageForUser

public 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

installPackageWithIncrementalMode

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

تثبيت حِزم APK في الوضع التدريجي

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

userId String

المرتجعات
boolean

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

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                String... extraArgs)

المعلَمات
packageFiles List

reinstall boolean

extraArgs String

القيم المُعادة
String

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

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

المعلَمات
packageFiles List

reinstall boolean

grantPermissions boolean

extraArgs String

القيم المُعادة
String

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

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

المعلَمات
packageFiles List

reinstall boolean

userId int

extraArgs String

القيم المُعادة
String

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

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

المعلَمات
packageFiles List

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

القيم المُعادة
String

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

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

التحقّق مما إذا كانت المنصة على الجهاز تتيح تعداد التطبيقات

المرتجعات
boolean "صحيح" إذا كان تعداد التطبيقات متاحًا، و"خطأ" في الحالات الأخرى
عمليات الطرح
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

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

المرتجعات
boolean

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

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

المرتجعات
boolean

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

isMultiUserSupported

public boolean isMultiUserSupported ()

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

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

يتحقّق هذا الإجراء أيضًا من config_enableMultiUserUI. بناءً على الطلب، يُسمح لنا بافتراض أنّ الأجهزة التي ينطبق عليها هذا الشرط تم ضبطها للسماح بإضافة مستخدمين ثانويين من خلال أداة adb.

المرتجعات
boolean تحديد ما إذا كان الجهاز يتيح استخدام عدة مستخدمين يمكن التبديل بينهم
عمليات الطرح
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

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

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

isPackageInstalled

public boolean isPackageInstalled (String packageName)

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

المعلَمات
packageName String

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

isUserRunning

public boolean isUserRunning (int userId)

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

المعلَمات
userId int

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

isUserSecondary

public boolean isUserSecondary (int userId)

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

المعلَمات
userId int

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

isUserVisible

public boolean isUserVisible (int userId)

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

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

المعلَمات
userId int

القيم المُعادة
boolean

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

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

المعلَمات
userId int

displayId int

القيم المُعادة
boolean

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

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

إذا كان الأمر كذلك، يمكنك استدعاء startVisibleBackgroundUser(int, int, boolean)، مع تمرير عرض تم إرجاعه بواسطة listDisplayIdsForStartingVisibleBackgroundUsers() (الذي يجب أن يتضمّن ERROR(/java.android.view.Display#DEFAULT_DISPLAY)).

المرتجعات
boolean

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

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

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

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

المرتجعات
boolean

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

listDisplayIds

public Set<Long> listDisplayIds ()

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

المرتجعات
Set<Long> قائمة الشاشات تعرض القيمة التلقائية دائمًا القيمة التلقائية 0.
عمليات الطرح
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

المرتجعات
Set<Integer>

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

listUsers

public ArrayList<Integer> listUsers ()

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

المرتجعات
ArrayList<Integer> قائمة أرقام تعريف المستخدمين
عمليات الطرح
DeviceNotAvailableException

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

المعلَمات
waitPhase SnapuserdWaitPhase

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

خطوات إضافية لتنظيف البيانات المطلوبة الخاصة بالجهاز سيتم تنفيذها بعد اكتمال عملية الاستدعاء.

المعلَمات
exception ‫Throwable: إذا كان هناك أي استثناء نهائي تم طرحه بسبب تعذُّر التنفيذ

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

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

المعلَمات
componentName String: من مشرف الجهاز الذي ستتم إزالته.
userId ‫int: هو المستخدم الذي يتضمّن مشرف الجهاز.
المرتجعات
boolean صحيح إذا كان ناجحًا، وخطأ في الحالات الأخرى.
عمليات الطرح
DeviceNotAvailableException

removeOwners

public void removeOwners ()

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

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

removeUser

public boolean removeUser (int userId)

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

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

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

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

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

setFirstBootloaderReboot

public void setFirstBootloaderReboot ()

setSetting

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

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

المعلَمات
namespace String

key String

value String

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

setSetting

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

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

المعلَمات
userId int

namespace String

key String

value String

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

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

يؤدي هذا الإجراء إلى إيقاف جهاز microdroid، إذا كان متوفّرًا.

المعلَمات
microdroidDevice ITestDevice

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

startUser

public boolean startUser (int userId)

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

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

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

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

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

startVisibleBackgroundUser

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

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

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

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

stopUser

public boolean stopUser (int userId)

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

المعلَمات
userId int: تمثّل هذه السمة معرّف المستخدم الذي سيتم إيقافه.
المرتجعات
boolean تعرض القيمة "صحيح" إذا تم إيقاف المستخدم بنجاح.
عمليات الطرح
DeviceNotAvailableException

stopUser

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

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

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

supportsMicrodroid

public boolean supportsMicrodroid ()

يتحقّق من الشروط المسبقة لتشغيل جهاز microdroid.

المرتجعات
boolean تعرض القيمة "صحيح" إذا تم استيفاء الشروط المسبقة، وتعرض القيمة "خطأ" في الحالات الأخرى.
عمليات الطرح
Exception

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

يتحقّق من الشروط المسبقة لتشغيل جهاز microdroid.

المعلَمات
protectedVm ‫boolean: تكون القيمة true إذا كان من المفترض أن يعمل microdroid على جهاز افتراضي محمي.
المرتجعات
boolean تعرض القيمة "صحيح" إذا تم استيفاء الشروط المسبقة، وتعرض القيمة "خطأ" في الحالات الأخرى.
عمليات الطرح
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId)

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

المعلَمات
userId int

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

switchUser

public boolean switchUser (int userId, 
                long timeout)

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

المعلَمات
userId int

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

takeBugreport

public Bugreport takeBugreport ()

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

المرتجعات
Bugreport

uninstallPackage

public String uninstallPackage (String packageName)

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

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

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

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

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

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

المعلَمات
currentPhase SnapuserdWaitPhase

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

طُرق محمية

createParser

protected AaptParser createParser (File appFile)

المعلَمات
appFile File

المرتجعات
AaptParser

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

نفِّذ عملية إعادة تشغيل adb.

المعلَمات
rebootMode ‫NativeDevice.RebootMode: وضع إعادة التشغيل هذا
reason ‫String: لإعادة التشغيل هذه.
عمليات الطرح
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

المرتجعات
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

طريقة مساعدة داخلية للحصول على ملف bugreportz zip كـ File.

المرتجعات
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

يتم عرضها للاختبار.

المرتجعات
long

getHostCurrentTime

protected long getHostCurrentTime ()

معرَّض للاختبار

المرتجعات
long

prePostBootSetup

protected void prePostBootSetup ()

تسمح هذه السمة لكل نوع جهاز (AndroidNativeDevice وTestDevice) بتجاوز هذه الطريقة لإعدادات محدّدة بعد التشغيل.

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