- Syntax:
<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"] />
- enthalten in:
<manifest>
- description:
Gibt die Hardware- und Softwarefunktionen an, die die Anwendung benötigt. Beispielsweise kann in einer Anwendung angegeben sein, dass eine physische Tastatur erforderlich ist. oder ein bestimmtes Navigationsgerät, z. B. einen Trackball. Die Spezifikation ist um die Installation der App auf Geräten zu vermeiden, auf denen sie nicht funktioniert.
Hinweis:In den meisten Apps wird dieses Manifest-Tag nicht verwendet. Eingabe mit Richtungstasten (Steuerkreuz) für Sehbehinderte immer unterstützen Nutzern und Support-Geräten, die zusätzlich zu oder anstelle einer Berührung das Steuerkreuz bieten.
Für Informationen zur Unterstützung der Eingabe über das Steuerkreuz in Ihrer App finden Sie unter Umgang mit Controlleraktionen. Wenn Ihre App ohne Touchscreen nicht funktionieren, verwenden Sie stattdessen das Tag
<uses-feature>
, um Deklarieren Sie den erforderlichen Touchscreen-Typ, angefangen bei"android.hardware.faketouch"
für einfache Touch-Events auf erweiterte Touch-Typen wie"android.hardware.touchscreen.multitouch.jazzhand"
für die individuelle Eingabe durch mehrere Finger.- Attribute:
android:reqFiveWayNav
- Ob für die App eine Fünf-Wege-Navigation erforderlich ist. Es ist
"true"
, wenn dies der Fall ist, und"false"
, wenn nicht. Ein Fünf-Wege können Sie die Auswahl nach oben, unten, rechts oder links bietet auch eine Möglichkeit, die aktuelle Auswahl aufzurufen. Es kann sich um einen Richtungstasten (Steuerkreuz), Trackball oder anderes Gerät verwenden.Wenn für eine Anwendung eine Richtungskontrolle erforderlich ist, kann es dieses Attribut auf
"true"
setzen und die Das AttributreqNavigation
Sie können jedoch wenn eine bestimmte Richtungskontrolle erforderlich ist, dieses Attribut und legen Sie stattdessenreqNavigation
fest. android:reqHardKeyboard
- Ob für die Anwendung eine Hardwaretastatur erforderlich ist. Es ist
"true"
, wenn dies der Fall ist, und"false"
, wenn nicht. android:reqKeyboardType
- Der für die Anwendung erforderliche Tastaturtyp (sofern vorhanden).
Bei diesem Attribut wird nicht zwischen Hardware und Software unterschieden.
Tastaturen. Wird eine bestimmte Hardwaretastatur benötigt,
Geben Sie hier den Typ an und legen Sie auch das Attribut
reqHardKeyboard
fest an"true"
.Der Wert muss einer der folgenden Strings sein:
Wert Beschreibung „ undefined
“Für die Anwendung ist keine Tastatur erforderlich. Es wurde keine Tastaturanforderung definiert. Dies ist der Standardwert. „ nokeys
“Für die Anwendung ist keine Tastatur erforderlich. „ qwerty
“Für die Anwendung ist eine standardmäßige QWERTY-Tastatur erforderlich. „ twelvekey
“Für die Anwendung ist eine Wähltastatur mit zwölf Tasten erforderlich, wie sie auf den meisten Telefone mit Tasten für die Ziffern von 0
bis9
plus die Sterntaste (*
) und die Raute (#
). android:reqNavigation
- Das für die App erforderliche Navigationsgerät (falls vorhanden). Der Wert
muss einer der folgenden Strings sein:
Wert Beschreibung „ undefined
“Die App erfordert keine Steuerung zur Navigation. Die Navigationsanforderung ist nicht definiert. Dies ist der Standardwert. „ nonav
“Für die App ist kein Navigationssteuerelement erforderlich. „ dpad
“In der App ist zur Navigation ein Steuerkreuz erforderlich. „ trackball
“Die Anwendung erfordert einen Trackball zur Navigation. „ wheel
“Die App erfordert ein Navigationsrad. Wenn für eine App ein Navigationssteuerelement erforderlich ist, der genaue Typ keine Rolle spielt, können die Einstellungen Attribut
reqFiveWayNav
zu"true"
anstatt dieses hier festzulegen. android:reqTouchScreen
- Die Art des Touchscreens, das für die App erforderlich ist (sofern vorhanden).
Der Wert muss einer der folgenden Strings sein:
Wert Beschreibung „ undefined
“Die Anwendung benötigt keinen Touchscreen. Die Anforderung für den Touchscreen ist nicht definiert. Dies ist der Standardwert. „ notouch
“Die Anwendung benötigt keinen Touchscreen. „ stylus
“Die Anwendung erfordert einen Touchscreen, der mit einem Eingabestift bedient wird. „ finger
“Die Anwendung erfordert einen Touchscreen, der mit einem Finger bedient werden kann. Hinweis:Wenn für Ihre App eine Berührungseingabe erforderlich ist, verwenden Sie stattdessen die
<uses-feature>
-Tag, um den erforderlichen Touchscreen zu deklarieren eingeben, beginnend mit"android.hardware.faketouch"
für einfache Ereignisse im Touch-Stil.
- eingeführt in:
- API-Level 3
- Siehe auch:
-
configChanges
des Tags<activity>
UnterelementConfigurationInfo
<uses-configuration>
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[],[],null,["# <uses-configuration\u003e\n\nsyntax:\n:\n\n ```xml\n \u003cuses-configuration\n android:reqFiveWayNav=[\"true\" | \"false\"]\n android:reqHardKeyboard=[\"true\" | \"false\"]\n android:reqKeyboardType=[\"undefined\" | \"nokeys\" | \"qwerty\" | \"twelvekey\"]\n android:reqNavigation=[\"undefined\" | \"nonav\" | \"dpad\" | \"trackball\" | \"wheel\"]\n android:reqTouchScreen=[\"undefined\" | \"notouch\" | \"stylus\" | \"finger\"] /\u003e\n ```\n\ncontained in:\n: [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element)\n\ndescription:\n\n: Indicates the hardware and software features the application requires.\n For example, an application might specify that it requires a physical keyboard\n or a particular navigation device, like a trackball. The specification is\n used to avoid installing the application on devices where it doesn't work.\n\n **Note:** Most apps don't use this manifest tag.\n *Always* support input with a directional pad (D-pad) to assist sight-impaired\n users and support devices that provide D-pad input in addition to or instead of touch.\n\n For\n information about how to support D-pad input in your app, read [Handle controller actions](/develop/ui/views/touch-and-input/game-controllers/controller-input). If\n your app absolutely can't function without a touchscreen, then instead use the [`\u003cuses-feature\u003e`](/guide/topics/manifest/uses-feature-element) tag to\n declare the required touchscreen type, ranging from `\"android.hardware.faketouch\"` for basic\n touch-style events to more advanced touch types such as `\"android.hardware.touchscreen.multitouch.jazzhand\"` for distinct input from multiple fingers.\n\nattributes:\n:\n\n `android:reqFiveWayNav`\n : Whether the application requires a five-way navigation control. It's\n `\"true\"` if it does, and `\"false\"` if not. A five-way\n control is one that can move the selection up, down, right, or left, and\n also provides a way of invoking the current selection. It can be a\n directional pad (D-pad), trackball, or other device.\n\n\n If an application requires a directional control, but not a control of a\n particular type, it can set this attribute to `\"true\"` and ignore\n the [reqNavigation](#nav) attribute. However,\n if it requires a particular type of directional control, it can ignore\n this attribute and set `reqNavigation` instead.\n\n `android:reqHardKeyboard`\n : Whether the application requires a hardware keyboard. It's\n `\"true\"` if it does, and `\"false\"` if not.\n\n `android:reqKeyboardType`\n : The type of keyboard the application requires, if any.\n This attribute doesn't distinguish between hardware and software\n keyboards. If a hardware keyboard of a certain type is required,\n specify the type here and also set the `reqHardKeyboard` attribute\n to `\"true\"`.\n\n\n The value must be one of the following strings:\n\n\n | Value | Description |\n |---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n | \"`undefined`\" | The application doesn't require a keyboard. A keyboard requirement isn't defined. This is the default value. |\n | \"`nokeys`\" | The application doesn't require a keyboard. |\n | \"`qwerty`\" | The application requires a standard QWERTY keyboard. |\n | \"`twelvekey`\" | The application requires a twelve-key keypad, like those on most phones, with keys for the digits from `0` through `9`, plus star (`*`) and pound (`#`) keys. |\n\n `android:reqNavigation`\n : The navigation device required by the application, if any. The value\n must be one of the following strings:\n\n | Value | Description |\n |---------------|--------------------------------------------------------------------------------------------------------------------------------------|\n | \"`undefined`\" | The application doesn't require any type of navigation control. The navigation requirement isn't defined. This is the default value. |\n | \"`nonav`\" | The application doesn't require a navigation control. |\n | \"`dpad`\" | The application requires a D-pad for navigation. |\n | \"`trackball`\" | The application requires a trackball for navigation. |\n | \"`wheel`\" | The application requires a navigation wheel. |\n\n\n If an application requires a navigational control, but the exact type of\n control doesn't matter, it can set the\n [reqFiveWayNav](#five) attribute to `\"true\"`\n rather than setting this one.\n\n `android:reqTouchScreen`\n : The type of touch screen the application requires, if any.\n The value must be one of the following strings:\n\n | Value | Description |\n |---------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n | \"`undefined`\" | The application doesn't require a touch screen. The touch screen requirement is undefined. This is the default value. |\n | \"`notouch`\" | The application doesn't require a touch screen. |\n | \"`stylus`\" | The application requires a touch screen that is operated with a stylus. |\n | \"`finger`\" | The application requires a touch screen that is operated with a finger. **Note:** If some type of touch input is required for your app, instead use the [`\u003cuses-feature\u003e`](/guide/topics/manifest/uses-feature-element) tag to declare the required touchscreen type, beginning with `\"android.hardware.faketouch\"` for basic touch-style events. |\n\nintroduced in:\n: API level 3\n\nsee also:\n:\n - [configChanges](/guide/topics/manifest/activity-element#config) attribute of the [\u003cactivity\u003e](/guide/topics/manifest/activity-element) element\n - [ConfigurationInfo](/reference/android/content/pm/ConfigurationInfo)"]]