ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

الفئات الفرعية غير المباشرة المعروفة ‫IManagedTestDevice وLocalAndroidVirtualDevice وManagedRemoteDevice وNativeDevice وNestedRemoteDevice وRemoteAndroidDevice وRemoteAndroidVirtualDevice وTestDevice IManagedTestDevice واجهة برمجة تطبيقات ITestDevice التي تتم إدارة دورة حياتها  LocalAndroidVirtualDevice فئة الأجهزة الافتراضية المحلية التي تعمل على مضيف TradeFed  ManagedRemoteDevice جهاز يعمل داخل جهاز افتراضي ونديره عن بُعد من خلال مثيل Tradefed داخل الجهاز الافتراضي  NativeDevice التنفيذ التلقائي لأجهزة ITestDevice Android التي لا تتضمّن حِزم تطوير البرامج الكاملة  NestedRemoteDevice تمثيل للجهاز الذي يعمل داخل جهاز افتراضي عن بُعد من Cuttlefish  RemoteAndroidDevice تنفيذ ITestDevice لجهاز Android مزوّد بمجموعة كاملة من الأدوات ومتصل عبر adb connect  RemoteAndroidVirtualDevice توسيع نطاق سلوك RemoteAndroidDevice لجهاز Android مزوّد بمجموعة كاملة من البرامج والتطبيقات ويعمل على Google Compute Engine (Gce)  TestDevice تنفيذ ITestDevice لجهاز Android مزوّد بمجموعة كاملة من الأدوات

---

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

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

ملخّص

الفئات المُدمجة
class	ITestDevice.ApexInfo فئة بنية بسيطة لتخزين معلومات عن عنصر APEX واحد
class	ITestDevice.MountPointInfo فئة بنية بسيطة لتخزين معلومات عن نقطة ربط واحدة

الطرق العامة
abstract boolean	canSwitchToHeadlessSystemUser() يعرض ما إذا كان يُسمح بالتبديل إلى مستخدم النظام بلا واجهة مستخدم رسومية.
abstract boolean	checkConnectivity() تأكَّد من أنّ الجهاز متصل بالشبكة.
abstract boolean	clearErrorDialogs() حاوِل إغلاق أي مربّعات حوار خطأ معروضة حاليًا على واجهة مستخدم الجهاز.
abstract void	clearLastConnectedWifiNetwork() يؤدي هذا الإجراء إلى محو آخر شبكة Wi-Fi تم الاتصال بها.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk) الاتصال بشبكة Wi-Fi
abstract boolean	connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid) الاتصال بشبكة Wi-Fi
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk) الاتصال بشبكة Wi-Fi
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid) الاتصال بشبكة Wi-Fi
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid) أحد أنواع connectToWifiNetwork(String, String) التي لا تتصل إلا إذا لم يكن الجهاز متصلاً بالشبكة حاليًا.
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk) أحد أنواع connectToWifiNetwork(String, String) التي لا تتصل إلا إذا لم يكن الجهاز متصلاً بالشبكة حاليًا.
abstract int	createUser(String name) أنشئ مستخدمًا باسم معيّن وعلامات تلقائية 0.
abstract int	createUser(String name, boolean guest, boolean ephemeral) إنشاء مستخدم باسم معيّن والعلامات المقدَّمة
abstract int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) إنشاء مستخدم باسم معيّن والعلامات المقدَّمة
abstract int	createUserNoThrow(String name) أنشئ مستخدمًا باسم معيّن وعلامات تلقائية 0.
abstract void	deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) لإزالة IDeviceActionReceiver المسجَّل.
abstract void	disableKeyguard() محاولات إيقاف شاشة القفل
abstract boolean	disableNetworkMonitor() يُوقف ميزة "مراقبة الشبكة" على الجهاز.
abstract boolean	disconnectFromWifi() قطع الاتصال بشبكة Wi-Fi
abstract boolean	doesFileExist(String deviceFilePath, int userId) طريقة مساعدة لتحديد ما إذا كان الملف على الجهاز متاحًا لمستخدم معيّن.
abstract File	dumpHeap(String process, String devicePath) حاوِل تفريغ الحِزمة من system_server.
abstract boolean	enableNetworkMonitor() تفعيل مراقبة الشبكة على الجهاز
abstract	getActiveApexes() استرجاع المعلومات عن حسابات APEX التي تم تفعيلها على الجهاز
abstract	getAllSettings(String namespace) عرض أزواج مفتاح/قيمة للمساحة الاسمية المطلوبة
abstract String	getAndroidId(int userId) العثور على معرّف android المرتبط بمعرّف مستخدم وعرضه، أو عرض قيمة فارغة في حال عدم العثور عليه
abstract	getAndroidIds() أنشئ خريطة لمعرّفات Android التي تم العثور عليها والتي تتطابق مع معرّفات المستخدمين.
abstract PackageInfo	getAppPackageInfo(String packageName) جلب معلومات عن حزمة مثبّتة على الجهاز
abstract	getAppPackageInfos() جلب معلومات الحِزم المثبّتة على الجهاز
abstract InputStreamSource	getBugreport() استرداد تقرير خطأ من الجهاز
abstract InputStreamSource	getBugreportz() استرداد تقرير خطأ من الجهاز
abstract DeviceFoldableState	getCurrentFoldableState() تعرِض هذه السمة الحالة الحالية للجهاز القابل للطي أو القيمة null إذا حدثت بعض المشاكل.
abstract int	getCurrentUser() عرض رقم تعريف المستخدم الحالي
abstract	getFoldableStates() عرض قائمة حالات الجهاز القابلة للطي
abstract	getInstalledPackageNames() استرجاع أسماء حِزم التطبيقات المتوفّرة على الجهاز
abstract String	getIpAddress() الحصول على عنوان IP للجهاز
abstract KeyguardControllerState	getKeyguardState() عرض عنصر للحصول على الحالة الحالية لقفل الشاشة أو عرض قيمة فارغة إذا لم يكن متاحًا
abstract Integer	getMainUserId() عرض رقم تعريف المستخدم الرئيسي
abstract	getMainlineModuleInfo() الحصول على معلومات عن وحدات الإصدار الرئيسي المثبّتة على الجهاز
abstract int	getMaxNumberOfRunningUsersSupported() الحصول على الحد الأقصى لعدد المستخدمين المسموح لهم بالتشغيل المتزامن
abstract int	getMaxNumberOfUsersSupported() الحصول على الحد الأقصى لعدد المستخدمين المتوافقين
abstract TestDeviceOptions	getOptions() استرجاع خيارات الاختبار للجهاز
abstract Integer	getPrimaryUserId() تم إيقاف هذه الطريقة نهائيًا. تم إيقاف getPrimaryUser نهائيًا من خدمة UserManager، استخدِم ERROR(/android.os.UserManager#getMainUserId()) للحصول على المستخدم الكامل الأول أو 0 للنظام. يُرجى العلم أنّه بالنسبة إلى النظام غير المزوّد بشاشة، لا يكون المستخدم مستخدمًا كاملاً.
abstract InputStreamSource	getScreenshot(String format, boolean rescale) يلتقط لقطة شاشة من الجهاز.
abstract InputStreamSource	getScreenshot(long displayId) يلتقط لقطة شاشة من الجهاز الذي تم تحديد معرّف العرض له.
abstract InputStreamSource	getScreenshot(String format) يلتقط لقطة شاشة من الجهاز.
abstract InputStreamSource	getScreenshot() يلتقط لقطة شاشة من الجهاز.
abstract String	getSetting(int userId, String namespace, String key) عرض قيمة الإعداد المطلوب
abstract String	getSetting(String namespace, String key) راجِع getSetting(int, String, String) ونفِّذ الإجراء على مستخدم النظام.
abstract	getUninstallablePackageNames() جلب أسماء حِزم التطبيقات التي يمكن إلغاء تثبيتها
abstract int	getUserFlags(int userId) العثور على الإشعارات التي أرسلها مستخدم معيّن وإرجاعها
abstract	getUserInfos() تحصل على خريطة useId إلى UserInfo على الجهاز.
abstract int	getUserSerialNumber(int userId) عرض الرقم التسلسلي المرتبط بمعرّف المستخدم إذا تم العثور عليه، أو -10000 في أي حالات أخرى
abstract boolean	hasFeature(String feature) التحقّق مما إذا كانت الميزة متوفّرة على جهاز
abstract String	installPackage(File packageFile, boolean reinstall, String... extraArgs) ثبِّت حزمة Android على الجهاز.
abstract String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) ثبِّت حزمة Android على الجهاز.
abstract String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) تثبيت حزمة Android على جهاز لمستخدم معيّن
abstract String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) تثبيت حزمة Android على جهاز لمستخدم معيّن
default String	installPackages( packageFiles, boolean reinstall, String... extraArgs) تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية وحِزم مجزّأة إضافية)
default String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية وحزمة مجزّأة إضافية) على جهاز Android
default String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs) تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية واحدة وحِزم مجزّأة إضافية) لمستخدم معيّن
default String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية واحدة وحِزم مجزّأة إضافية) لمستخدم معيّن
default String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs) تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية وحِزم إضافية مجزّأة) على جهاز Android
default String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية وحِزم إضافية مجزّأة) على جهاز Android
abstract boolean	isHeadlessSystemUserMode() يعرض ما إذا كان الجهاز يستخدم وضع المستخدم في النظام بلا واجهة مستخدم رسومية.
abstract boolean	isMainUserPermanentAdmin() تعرِض هذه السمة ما إذا كان المستخدم الرئيسي مشرفًا دائمًا ولا يمكن حذفه أو خفض رتبته إلى حالة "غير مشرف".
abstract boolean	isMultiUserSupported() لتحديد ما إذا كان استخدام حسابات متعدّدة مسموحًا به
abstract boolean	isPackageInstalled(String packageName, String userId) يمكنك طلب معلومات من الجهاز عن اسم حزمة معيّن ورقم تعريف مستخدم معيّن للتحقّق مما إذا كان التطبيق مُثبَّتًا حاليًا لهذا المستخدم أم لا.
abstract boolean	isPackageInstalled(String packageName) يمكنك طلب معلومات من الجهاز عن اسم حزمة معيّن لمعرفة ما إذا كان مثبّتًا حاليًا أم لا.
abstract boolean	isUserRunning(int userId) التحقّق مما إذا كان مستخدم معيّن قيد التشغيل
abstract boolean	isUserSecondary(int userId) عرض ما إذا كان المستخدم المحدّد مستخدمًا ثانويًا وفقًا لعلاماته
abstract boolean	isUserVisible(int userId) للتحقّق مما إذا كان المستخدم المحدّد مرئيًا
abstract boolean	isUserVisibleOnDisplay(int userId, int displayId) للتحقّق مما إذا كان المستخدم المحدّد مرئيًا في العرض المحدّد
abstract boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() تعرِض هذه السمة ما إذا كان الجهاز يسمح للمستخدمين ببدء التطبيقات التي تظهر في الخلفية في ERROR(/java.android.view.Display#DEFAULT_DISPLAY).
abstract boolean	isVisibleBackgroundUsersSupported() يعرض ما إذا كان الجهاز يسمح للمستخدمين ببدء التطبيقات التي تظهر في الخلفية.
abstract boolean	isWifiEnabled() تحقَّق مما إذا كانت شبكة Wi-Fi مفعَّلة.
abstract	listDisplayIds() جمع قائمة أرقام تعريف الشاشات المتاحة على الجهاز كما هو موضّح في "dumpsys SurfaceFlinger"
abstract	listDisplayIdsForStartingVisibleBackgroundUsers() تحصل على قائمة الشاشات التي يمكن استخدامها start a user visible in the background.
abstract	listUsers() الحصول على قائمة المستخدمين على الجهاز
abstract boolean	logBugreport(String dataName, ITestLogger listener) طريقة مساعدة لإنشاء تقرير خطأ وتسجيله لدى المُبلِغين
default void	notifySnapuserd(SnapuserdWaitPhase waitPhase) أطلِع الجهاز على أنّه يجب الانتظار إلى أن تكتمل عملية snapuserd.
abstract void	registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) تسجيل IDeviceActionReceiver لهذا الجهاز
abstract boolean	removeAdmin(String componentName, int userId) أزِل مشرف الجهاز المحدَّد في المستخدم المحدَّد وأعِد true في حال نجاح العملية، أو false في حال عدم نجاحها.
abstract void	removeOwners() يُرجى إزالة جميع مالكي الملفات الشخصية الحالية للأجهزة بأفضل ما يمكن.
abstract boolean	removeUser(int userId) إزالة مستخدم معيّن من الجهاز
abstract boolean	setDeviceOwner(String componentName, int userId) ضبط مكوّن مشرف جهاز على أنّه مالك الجهاز في المستخدم المحدّد
abstract void	setSetting(String namespace, String key, String value) راجِع setSetting(int, String, String, String) ونفِّذ الإجراء على مستخدم النظام.
abstract void	setSetting(int userId, String namespace, String key, String value) أضِف قيمة إعداد إلى مساحة الاسم الخاصة بمستخدم معيّن.
abstract boolean	startUser(int userId) يبدأ تشغيل حساب مستخدم معيّن في الخلفية إذا كان متوقفًا حاليًا.
abstract boolean	startUser(int userId, boolean waitFlag) يبدأ تشغيل حساب مستخدم معيّن في الخلفية إذا كان متوقفًا حاليًا.
abstract boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) بدء مستخدم معيّن في الخلفية، مرئي في العرض المحدّد (أي السماح للمستخدم ببدء الأنشطة في هذا العرض)
abstract boolean	stopUser(int userId) يوقف مستخدمًا معيّنًا.
abstract boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) إيقاف مستخدم معيّن
abstract boolean	switchUser(int userId) التبديل إلى معرّف مستخدم آخر باستخدام مهلة تلقائية
abstract boolean	switchUser(int userId, long timeout) يمكنك التبديل إلى معرّف مستخدم آخر باستخدام مهلة الانتظار المقدَّمة كآخر مهلة.
abstract Bugreport	takeBugreport() تأخذ تقرير أخطاء وتُعيده داخل عنصر Bugreport للتعامل معه.
abstract String	uninstallPackage(String packageName) إلغاء تثبيت حزمة Android من الجهاز
abstract String	uninstallPackageForUser(String packageName, int userId) إلغاء تثبيت حزمة Android من جهاز لمستخدم معيّن
default void	waitForSnapuserd(SnapuserdWaitPhase currentPhase) يُرجى الانتظار حتى تكتمل عملية snapuserd، إذا كان ذلك متوقّعًا.

الطرق العامة

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

المرتجعات
boolean

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

checkConnectivity

public abstract boolean checkConnectivity ()

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

المرتجعات
boolean	true إذا كان الجهاز متصلاً بالشبكة، false بخلاف ذلك

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

المرتجعات
boolean	true إذا لم تكن هناك مربّعات حوار أو تم محو مربّعات الحوار بنجاح. false بخلاف ذلك

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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

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

المعلمات
wifiSsidToPsk	: خريطة لمعرّفات SSID لشبكات Wi-Fi وكلمات المرور

المرتجعات
boolean	true إذا تم الاتصال بشبكة Wi-Fi بنجاح false وإلا

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

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

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

المعلمات
wifiSsidToPsk	: خريطة لمعرّفات SSID لشبكات Wi-Fi وكلمات المرور
scanSsid	‫boolean: ما إذا كان سيتم البحث عن معرّفات SSID مخفية لهذه الشبكة

المرتجعات
boolean	true إذا تم الاتصال بشبكة Wi-Fi بنجاح false وإلا

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

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

تفعيل شبكة Wi-Fi وحظر الاتصال إلى أن يتم الاتصال بشبكة Wi-Fi المحدّدة بنجاح بعد إجراء عملية اتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل إلى أن يتم استدعاء ITestDevice.disconnectFromWifi() أو ITestDevice.clearLastConnectedWifiNetwork().

المعلمات
wifiSsid	String: رقم تعريف شبكة Wi-Fi المطلوب الاتصال بها
wifiPsk	String: عبارة مرور PSK أو قيمة فارغة في حال عدم التشفير

المرتجعات
boolean	true إذا تم الاتصال بشبكة Wi-Fi بنجاح false وإلا

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

connectToWifiNetwork

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

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

تفعيل شبكة Wi-Fi وحظر الاتصال إلى أن يتم الاتصال بشبكة Wi-Fi المحدّدة بنجاح بعد إجراء عملية اتصال، سيحاول المثيل استعادة الاتصال بعد كل عملية إعادة تشغيل إلى أن يتم استدعاء ITestDevice.disconnectFromWifi() أو ITestDevice.clearLastConnectedWifiNetwork().

المعلمات
wifiSsid	String: رقم تعريف شبكة Wi-Fi المطلوب الاتصال بها
wifiPsk	String: عبارة مرور PSK أو قيمة فارغة في حال عدم التشفير
scanSsid	boolean: يشير إلى ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة.

المرتجعات
boolean	true إذا تم الاتصال بشبكة Wi-Fi بنجاح false وإلا

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

connectToWifiNetworkIfNeeded

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

أحد أنواع connectToWifiNetwork(String, String) التي لا تتصل إلا إذا لم يكن الجهاز متصلاً بالشبكة حاليًا.

المعلمات
scanSsid	boolean: ما إذا كان سيتم البحث عن معرّف SSID مخفي لهذه الشبكة

المرتجعات
boolean	true إذا تم الاتصال بشبكة Wi-Fi بنجاح false وإلا

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

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

أحد أنواع connectToWifiNetwork(String, String) التي لا تتصل إلا إذا لم يكن الجهاز متصلاً بالشبكة حاليًا.

المرتجعات
boolean	true إذا تم الاتصال بشبكة Wi-Fi بنجاح false وإلا

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

createUser

public abstract int createUser (String name)

أنشئ مستخدمًا باسم معيّن وعلامات تلقائية 0.

المعلمات
name	String: للمستخدم الذي يريد إنشاء حساب على الجهاز

المرتجعات
int	عدد صحيح لرقم تعريف المستخدم الذي تم إنشاؤه

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

createUser

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

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

المعلمات
name	String: للمستخدم الذي يريد إنشاء حساب على الجهاز
guest	boolean: تفعيل علامة المستخدم "--guest" أثناء الإنشاء
ephemeral	‫boolean: تفعيل علامة المستخدم --ephemeral أثناء الإنشاء

المرتجعات
int	رقم تعريف المستخدم الذي تم إنشاؤه

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

createUser

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

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

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

المرتجعات
int	رقم تعريف المستخدم الذي تم إنشاؤه

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

createUserNoThrow

public abstract int createUserNoThrow (String name)

أنشئ مستخدمًا باسم معيّن وعلامات تلقائية 0.

المعلمات
name	String: للمستخدم الذي يريد إنشاء حساب على الجهاز

المرتجعات
int	عدد صحيح لرقم تعريف المستخدم الذي تم إنشاؤه أو -1 للخطأ

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

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

لإزالة IDeviceActionReceiver المسجَّل.

المعلمات
deviceActionReceiver	‫IDeviceActionReceiver: IDeviceActionReceiver التي ستتم إزالتها

disableKeyguard

public abstract void disableKeyguard ()

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

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

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

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

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

المرتجعات
boolean	true إذا تم إيقاف ميزة "التتبُّع" بنجاح false في حال تعذّر ذلك.

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

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

يؤدي هذا الإجراء إلى إزالة جميع الشبكات من قائمة الشبكات المعروفة وإيقاف شبكة Wi-Fi.

المرتجعات
boolean	true في حال انقطاع الاتصال بشبكة Wi-Fi بنجاح false إذا تعذّر قطع الاتصال.

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

المعلمات
deviceFilePath	String: المسار المطلق للملف على الجهاز المطلوب التحقّق منه
userId	‫int: رقم تعريف المستخدم الذي يتم التحقّق من توفّر الملف وفقًا له

المرتجعات
boolean	true إذا كان الملف متوفّرًا، false في حال عدم توفّره

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

حاوِل تفريغ الحِزمة من system_server. تقع على عاتق المتصل مسؤولية تنظيف الملف الذي تم تفريغه.

المعلمات
process	String: اسم عملية الجهاز التي يتم تشغيل dumpheap عليها.
devicePath	‫String: المسار على الجهاز الذي سيتم وضع ملف الترميز فيه يجب أن يكون هذا الموقع الجغرافي مكانًا يسمح فيه الأذونات بذلك.

المرتجعات
File	ERROR(/File) التي تحتوي على التقرير قيمة فارغة إذا حدث خطأ

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

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

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

المرتجعات
boolean	true إذا تم تفعيل ميزة التتبُّع بنجاح false في حال تعذّر ذلك.

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

getActiveApexes

public abstract  getActiveApexes ()

استرجاع المعلومات عن حسابات APEX التي تم تفعيلها على الجهاز

المرتجعات
	ERROR(/Set) من ApexInfo رمز مُفعَّل حاليًا على الجهاز

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

getAllSettings

public abstract  getAllSettings (String namespace)

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

المعلمات
namespace	String: يجب أن يكون أحد الخيارات التالية: {"system", "secure", "global"}

المرتجعات
	خريطة أزواج المفتاح/القيمة قيمة فارغة إذا لم تكن مساحة الاسم متاحة.

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

getAndroidId

public abstract String getAndroidId (int userId)

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

المعلمات
userId	int

المرتجعات
String

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

getAndroidIds

public abstract  getAndroidIds ()

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

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

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

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

المعلمات
packageName	String

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

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

المرتجعات
	ERROR(/List) من PackageInfo مثبّتة على الجهاز

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

getBugreport

public abstract InputStreamSource getBugreport ()

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

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

المرتجعات
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

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

المرتجعات
int

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

getFoldableStates

public abstract  getFoldableStates ()

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

المرتجعات

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

المرتجعات
	ERROR(/Set) من String أسماء الحِزم المثبَّتة حاليًا على الجهاز.

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

getIpAddress

public abstract String getIpAddress ()

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

المرتجعات
String	عنوان IP للجهاز، أو null إذا لم يكن للجهاز عنوان IP

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

getMainUserId

public abstract Integer getMainUserId ()

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

المرتجعات
Integer	userId للمستخدم الرئيسي إذا كان هناك مستخدم رئيسي، وقيمة فارغة إذا لم يكن هناك مستخدم رئيسي

عمليات الرمي
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	إذا لم يكن الناتج من الجهاز على النحو المتوقّع
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

المرتجعات
	ERROR(/Set) من String وحدة رئيسية مثبّتة حاليًا على الجهاز

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

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

getOptions

public abstract TestDeviceOptions getOptions ()

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

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

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

تم إيقاف هذه الطريقة نهائيًا.
تم إيقاف getPrimaryUser نهائيًا من خدمة UserManager، استخدِم ERROR(/android.os.UserManager#getMainUserId()) للحصول على المستخدم الكامل الأول أو 0 للنظام. يُرجى العِلم أنّه بالنسبة إلى النظام غير المزوّد بشاشة، لا يكون هذا المستخدم مستخدمًا كاملاً.

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

المرتجعات
Integer	userId للمستخدم الأساسي في حال توفّر مستخدم أساسي، وقيمة فارغة في حال عدم توفّر مستخدم أساسي

عمليات الرمي
	com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException	إذا لم يكن الناتج من الجهاز على النحو المتوقّع
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

المعلمات
format	String: تنسيقات PNG وJPEG المتوافقة
rescale	‫boolean: إذا كان يجب إعادة تغيير حجم لقطة الشاشة لتقليل حجم الصورة الناتجة

المرتجعات
InputStreamSource	InputStreamSource لقطة الشاشة بتنسيق null إذا لم تنجح لقطة الشاشة

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

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: توسيع نطاق عمليات التنفيذ أعلاه لتتوافق مع "التنسيق" و"إعادة الحجم"

المعلمات
displayId	‫long: معرّف العرض للشاشة التي تريد الحصول على لقطة شاشة منها.

المرتجعات
InputStreamSource	InputStreamSource لقطة الشاشة بتنسيق null إذا لم تنجح لقطة الشاشة

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

المعلمات
format	String: تنسيقات PNG وJPEG المتوافقة

المرتجعات
InputStreamSource	InputStreamSource لقطة الشاشة بتنسيق null إذا لم تنجح عملية التقاط لقطة الشاشة

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

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

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

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

getSetting

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

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

المعلمات
userId	int
namespace	String
key	String

المرتجعات
String	القيمة المرتبطة بـ namespace:key الخاصة بمستخدم قيمة فارغة إذا لم يتم العثور على القيمة

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

راجِع getSetting(int, String, String) ونفِّذ الإجراء على مستخدم النظام.

المعلمات
namespace	String
key	String

المرتجعات
String

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

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

المرتجعات
	ERROR(/Set) من أسماء حِزم String غير القابلة للإزالة المثبَّتة حاليًا على الجهاز

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

getUserFlags

public abstract int getUserFlags (int userId)

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

المعلمات
userId	int

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

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

getUserInfos

public abstract  getUserInfos ()

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

المرتجعات
	قائمة عناصر UserInfo

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

المعلمات
userId	int

المرتجعات
int

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

hasFeature

public abstract boolean hasFeature (String feature)

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

المعلمات
feature	String: يجب أن يكون التنسيق "feature:" أو "" مباشرةً.

المرتجعات
boolean	صحيح إذا تم العثور على العنصر، وخطأ في الحالات الأخرى.

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

installPackage

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

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

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

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

installPackage

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

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

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

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

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده
UnsupportedOperationException	إذا لم يكن إذن التشغيل متوافقًا مع النظام الأساسي على الجهاز

installPackageForUser

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

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

المعلمات
packageFile	File: ملف APK المطلوب تثبيته
reinstall	boolean: true إذا كان يجب إجراء إعادة تثبيت
userId	‫int: رقم تعريف المستخدم الصحيح المطلوب تثبيت التطبيق له.
extraArgs	String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" لمعرفة الخيارات المتاحة.

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

installPackageForUser

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

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

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

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

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده
UnsupportedOperationException	إذا لم يكن إذن التشغيل متوافقًا مع النظام الأساسي على الجهاز

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية وحِزم مجزّأة إضافية) يُرجى الاطّلاع على "https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حزمة APK إلى عدة ملفات.

المعلمات
packageFiles	: ملفات APK المحلية
reinstall	boolean: true إذا كان يجب إجراء إعادة تثبيت
extraArgs	String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" لمعرفة الخيارات المتاحة.

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده
UnsupportedOperationException	إذا لم يكن إذن التشغيل متوافقًا مع النظام الأساسي على الجهاز

installPackages

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية وحِزم إضافية مجزّأة) على جهاز Android يمكنك الاطّلاع على ‎"https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حزمة APK إلى عدة ملفات.

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

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

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده
UnsupportedOperationException	إذا لم يكن إذن التشغيل متوافقًا مع النظام الأساسي على الجهاز

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية واحدة وحِزم مجزّأة إضافية) لمستخدم معيّن يُرجى الاطّلاع على "https://developer.android.com/studio/build/configure-apk-splits" للتعرّف على كيفية تقسيم حزمة APK إلى عدة ملفات.

المعلمات
packageFiles	: ملفات APK المحلية
reinstall	boolean: true إذا كان يجب إجراء إعادة تثبيت
userId	‫int: رقم تعريف المستخدم الصحيح المطلوب تثبيت التطبيق له.
extraArgs	String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" لمعرفة الخيارات المتاحة.

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده
UnsupportedOperationException	إذا لم يكن إذن التشغيل متوافقًا مع النظام الأساسي على الجهاز

installPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية واحدة وحِزم مجزّأة إضافية) لمستخدم معيّن يُرجى الاطّلاع على "https://developer.android.com/studio/build/configure-apk-splits" للتعرّف على كيفية تقسيم حزمة APK إلى عدة ملفات.

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

المعلمات
packageFiles	: ملفات APK المحلية
reinstall	boolean: true إذا كان يجب إجراء إعادة تثبيت
grantPermissions	‫boolean: إذا كان يجب منح جميع أذونات وقت التشغيل في وقت التثبيت
userId	‫int: رقم تعريف المستخدم الصحيح المطلوب تثبيت التطبيق له.
extraArgs	String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" لمعرفة الخيارات المتاحة.

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده
UnsupportedOperationException	إذا لم يكن إذن التشغيل متوافقًا مع النظام الأساسي على الجهاز

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية وحِزم إضافية مجزّأة) على جهاز Android يمكنك الاطّلاع على ‎"https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حزمة APK إلى عدة ملفات.

المعلمات
remoteApkPaths	: مسارات ملفات APK البعيدة
reinstall	boolean: true إذا كان يجب إجراء إعادة تثبيت
extraArgs	String: وسيطات إضافية اختيارية يتم تمريرها. راجِع "adb shell pm -h" لمعرفة الخيارات المتاحة.

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده
UnsupportedOperationException	إذا لم يكن إذن التشغيل متوافقًا مع النظام الأساسي على الجهاز

installRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

تثبيت تطبيق Android مكوّن من عدة ملفات APK (حزمة رئيسية وحِزم إضافية مجزّأة) على جهاز Android يمكنك الاطّلاع على ‎"https://developer.android.com/studio/build/configure-apk-splits" لمعرفة كيفية تقسيم حزمة APK إلى عدة ملفات.

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

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

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده
UnsupportedOperationException	إذا لم يكن إذن التشغيل متوافقًا مع النظام الأساسي على الجهاز

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

المرتجعات
boolean

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

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

المرتجعات
boolean

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

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

لتحديد ما إذا كان استخدام حسابات متعدّدة مسموحًا به

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

المعلمات
packageName	String: الحزمة التي نتحقّق من تثبيتها
userId	String: رقم تعريف المستخدم الذي نتحقق من تثبيت الحزمة له. إذا كان القيمة فارغة، سيتم استخدام مستخدم أساسي القيمة صفر.

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

المعلمات
packageName	String

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

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

isUserRunning

public abstract boolean isUserRunning (int userId)

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

المعلمات
userId	int

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

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

المعلمات
userId	int

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

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

isUserVisible

public abstract boolean isUserVisible (int userId)

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

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

المعلمات
userId	int

المرتجعات
boolean

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

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

المعلمات
userId	int
displayId	int

المرتجعات
boolean

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

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

المرتجعات
boolean

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

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

المرتجعات
boolean

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

isWifiEnabled

public abstract boolean isWifiEnabled ()

تحقَّق مما إذا كانت شبكة Wi-Fi مفعَّلة.

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

المرتجعات
boolean	true إذا كانت شبكة Wi-Fi مفعّلة false إذا كانت غير مفعّلة

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

listDisplayIds

public abstract  listDisplayIds ()

جمع قائمة أرقام تعريف الشاشات المتاحة على الجهاز كما هو موضّح في "dumpsys SurfaceFlinger"

المرتجعات
	قائمة الشاشات يعرض الخيار التلقائي دائمًا القيمة التلقائية 0.

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

المرتجعات

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

listUsers

public abstract  listUsers ()

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

المرتجعات
	قائمة أرقام تعريف المستخدمين

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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

طريقة مساعدة لإنشاء تقرير خطأ وتسجيله لدى المُبلِغين

المعلمات
dataName	‫String: الاسم الذي سيتم الإبلاغ عن الخطأ باسمه
listener	ITestLogger: ITestLogger لتسجيل تقرير الخطأ

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

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

أطلِع الجهاز على أنّه يجب الانتظار إلى أن تكتمل عملية snapuserd.

المعلمات
waitPhase	SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

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

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

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

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

المعلمات
componentName	String: من مشرف الجهاز الذي سيتمّت إزالته.
userId	int: البلد الذي يقيم فيه مشرف الجهاز

المرتجعات
boolean	صحيح إذا كان الإجراء ناجحًا، وخطأ في الحالات الأخرى

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

removeOwners

public abstract void removeOwners ()

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

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

removeUser

public abstract boolean removeUser (int userId)

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

المعلمات
userId	int: للمستخدِم المطلوب إزالته

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

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

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

المعلمات
componentName	String: من مشرف الجهاز ليصبح مالك الجهاز
userId	int: البلد الذي يقيم فيه مالك الجهاز

المرتجعات
boolean	صحيح إذا كان الإجراء ناجحًا، وخطأ في الحالات الأخرى

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

setSetting

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

راجِع setSetting(int, String, String, String) ونفِّذ الإجراء على مستخدم النظام.

المعلمات
namespace	String
key	String
value	String

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

setSetting

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

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

المعلمات
userId	int
namespace	String
key	String
value	String

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

startUser

public abstract boolean startUser (int userId)

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

المعلمات
userId	‫int: للمستخدم لبدء التشغيل في الخلفية

المرتجعات
boolean	صحيح إذا تم تشغيل المستخدم بنجاح في الخلفية.

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

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

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

المرتجعات
boolean	صحيح إذا تم تشغيل المستخدم بنجاح في الخلفية.

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

startVisibleBackgroundUser

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

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

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

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

المرتجعات
boolean	true إذا تم تشغيل المستخدم بنجاح، يظهر في الخلفية.

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

stopUser

public abstract boolean stopUser (int userId)

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

المعلمات
userId	int: من المستخدم لإيقافها.

المرتجعات
boolean	صحيح إذا تم إيقاف المستخدم بنجاح.

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

stopUser

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

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

المعلمات
userId	int: من المستخدم لإيقافها.
waitFlag	boolean: سيجعل الأمر ينتظر إلى أن يتم إيقاف المستخدم.
forceFlag	boolean: سيتم فرض إيقاف المستخدم.

المرتجعات
boolean	صحيح إذا تم إيقاف المستخدم بنجاح.

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

switchUser

public abstract boolean switchUser (int userId)

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

المعلمات
userId	int

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

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

المعلمات
userId	int
timeout	long: للانتظار قبل عرض قيمة false لخطأ switch-user

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

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

takeBugreport

public abstract Bugreport takeBugreport ()

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

المرتجعات
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

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

المعلمات
packageName	String: حزمة Android المطلوب إلغاء تثبيتها

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

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

المرتجعات
String	String مع رمز خطأ، أو null في حال نجاح العملية

عمليات الرمي
DeviceNotAvailableException	إذا انقطع الاتصال بالجهاز ولا يمكن استرداده

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

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

المعلمات
currentPhase	SnapuserdWaitPhase

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