<uses-configuration>

بناء الجملة:
<uses-configuration
  android:reqFiveWayNav=["true" | "false"]
  android:reqHardKeyboard=["true" | "false"]
  android:reqKeyboardType=["undefined" | "nokeys" | "qwerty" | "twelvekey"]
  android:reqNavigation=["undefined" | "nonav" | "dpad" | "trackball" | "wheel"]
  android:reqTouchScreen=["undefined" | "notouch" | "stylus" | "finger"] />
المضمَّنة في:
<manifest>
description:

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

ملاحظة: لا تستخدم معظم التطبيقات علامة البيان هذه. يمكنك دائمًا إتاحة الإدخال باستخدام لوحة الاتجاهات (D-pad) لمساعدة المستخدمين ذوي العجز البصري ودعم الأجهزة التي توفّر إدخال لوحة التحكّم بالإضافة إلى اللمس أو بدلاً منه.

للحصول على معلومات حول كيفية إتاحة إدخال لوحة التحكم في تطبيقك، يُرجى قراءة التعامل مع إجراءات وحدة التحكم. إذا كان تطبيقك لا يعمل تمامًا بدون شاشة تعمل باللمس، استخدِم علامة <uses-feature> بدلاً من ذلك لتعريف نوع الشاشة التي تعمل باللمس المطلوب، بدءًا من "android.hardware.faketouch" للأحداث الأساسية بنمط اللمس وأنواع اللمس الأكثر تقدّمًا مثل "android.hardware.touchscreen.multitouch.jazzhand" للحصول على إدخال مميز من أصابع متعددة.

السمات:
android:reqFiveWayNav
ما إذا كان التطبيق يتطلب عنصر تحكُّم تنقُّل خماسيًا أو لا وتكون العلامة "true" في حال توافقها، و"false" إذا لم يتم عرضها. عنصر التحكم الخماسي هو الذي يمكنه تحريك التحديد لأعلى أو لأسفل أو اليمين أو اليسار، ويوفر أيضًا طريقة لاستدعاء التحديد الحالي. يمكن أن تكون لوحة الاتجاهات (D-pad) أو كرة التعقب أو أي جهاز آخر.

إذا كان التطبيق يتطلب تحكُّمًا في الاتجاه، وليس تحكمًا في نوع معيّن، يمكنه ضبط هذه السمة على "true" وتجاهل السمة reqNavigation. ومع ذلك، إذا كانت السمة تتطلّب نوعًا معيّنًا من التحكّم في الاتجاهات، يمكن تجاهُل هذه السمة وضبط reqNavigation بدلاً منها.

android:reqHardKeyboard
ما إذا كان التطبيق يتطلب لوحة مفاتيح خارجية وتكون العلامة "true" في حال توافقها، و"false" إذا لم يتم عرضها.
android:reqKeyboardType
نوع لوحة المفاتيح التي يتطلبها التطبيق، إن توفّرت. وهذه السمة لا تميّز بين لوحات المفاتيح في الأجهزة والبرامج. إذا كنت بحاجة إلى لوحة مفاتيح خارجية من نوع معيّن، يُرجى تحديد النوع هنا وضبط السمة reqHardKeyboard على "true".

يجب أن تكون القيمة إحدى السلاسل التالية:

القيمة الوصف
"undefined" لا يتطلب التطبيق لوحة مفاتيح. لم يتم تحديد متطلبات لوحة المفاتيح. هذه هي القيمة الافتراضية.
"nokeys" لا يتطلب التطبيق لوحة مفاتيح.
"qwerty" يتطلب التطبيق لوحة مفاتيح QWERTY عادية.
"twelvekey" يتطلب التطبيق استخدام لوحة مفاتيح مكوّنة من اثني عشر مفتاحًا، مثل تلك المتوفّرة في معظم الهواتف، مع مفاتيح للأرقام من 0 إلى 9، بالإضافة إلى مفتاحَي النجمة (*) والجنيه (#).
android:reqNavigation
جهاز التنقل الذي يتطلبه التطبيق، إن وجد. يجب أن تكون القيمة إحدى السلاسل التالية:
القيمة الوصف
"undefined" لا يتطلب التطبيق أي نوع من عناصر التحكم في التنقل. لم يتم تحديد متطلبات التنقل. هذه هي القيمة الافتراضية.
"nonav" لا يتطلب التطبيق عنصر تحكم للتنقل.
"dpad" يتطلب التطبيق لوحة تحكم للتنقل.
"trackball" يتطلب التطبيق كرة تعقب للتنقل.
"wheel" يتطلب التطبيق عجلة تنقل.

إذا كان التطبيق يتطلّب عنصر تحكّم في التنقّل، ولكن لا يهم نوع عنصر التحكّم الدقيق، يمكنه ضبط سمة reqFiveWayNav على "true" بدلاً من ضبط هذا العنصر.

android:reqTouchScreen
نوع الشاشة التي تعمل باللمس التي يتطلبها التطبيق، إن توفّرت. يجب أن تكون القيمة إحدى السلاسل التالية:
القيمة الوصف
"undefined" لا يتطلب التطبيق شاشة تعمل باللمس. شرط الشاشة التي تعمل باللمس غير محدّد. هذه هي القيمة الافتراضية.
"notouch" لا يتطلب التطبيق شاشة تعمل باللمس.
"stylus" يتطلب التطبيق شاشة تعمل باللمس تعمل بقلم الشاشة.
"finger" يتطلب التطبيق شاشة تعمل باللمس يمكن تشغيلها بإصبع.

ملاحظة: إذا كان نوع الإدخال باللمس مطلوبًا لتطبيقك، يمكنك استخدام العلامة <uses-feature> بدلاً من ذلك لتعريف النوع المطلوب للشاشة التي تعمل باللمس، بدءًا من "android.hardware.faketouch" للأحداث الأساسية التي يتم فيها لمس شاشة.

تم تقديمه في:
المستوى 3 لواجهة برمجة التطبيقات
راجِع أيضًا: