- sintassi:
<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"] />
- contenuto in:
<manifest>
- description:
Indica le funzionalità hardware e software richieste dall'applicazione. Ad esempio, un'applicazione potrebbe specificare che richiede una tastiera fisica o un particolare dispositivo di navigazione, come una trackball. La specifica è utilizzato per evitare di installare l'applicazione su dispositivi su cui non funziona.
Nota:la maggior parte delle app non utilizza questo tag manifest. Supporta sempre l'input con un pad direzionale (D-pad) per aiutare ipovedenti utenti e dispositivi di supporto che forniscono l'input del D-pad in aggiunta o al posto del tocco.
Per informazioni su come supportare l'inserimento del D-pad nella tua app, leggi Gestire le azioni del controller. Se la tua app non può funzionare senza un touchscreen, utilizza il tag
<uses-feature>
per dichiara il tipo di touchscreen richiesto, compreso tra"android.hardware.faketouch"
per le a tipi di tocco più avanzati, come"android.hardware.touchscreen.multitouch.jazzhand"
per un input distinto da più dita.- attributi:
android:reqFiveWayNav
- Se l'applicazione richiede un controllo di navigazione in cinque direzioni. È
"true"
in caso affermativo e"false"
in caso contrario. Un percorso a cinque controllo è un'opzione che può spostare la selezione in alto, in basso, a destra o a sinistra e consente anche di richiamare la selezione corrente. Può essere un d-pad, trackball o altro dispositivo.Se un'applicazione richiede un controllo direzionale, ma non un controllo di un tipo specifico, può impostare questo attributo su
"true"
e ignorare l'attributoreqNavigation
. Tuttavia, se richiede un particolare tipo di controllo direzionale, può ignorare questo attributo e impostare invecereqNavigation
. android:reqHardKeyboard
- Se l'applicazione richiede una tastiera hardware. È
"true"
in caso affermativo e"false"
in caso contrario. android:reqKeyboardType
- L'eventuale tipo di tastiera richiesto dall'applicazione.
Questo attributo non fa distinzione tra hardware e software
tastiere. Se è necessaria una tastiera hardware di un certo tipo,
specifica il tipo qui e imposta anche l'attributo
reqHardKeyboard
a"true"
.Il valore deve corrispondere a una delle seguenti stringhe:
Valore Descrizione " undefined
"L'applicazione non richiede una tastiera. Non è stato definito un requisito della tastiera. Questo è il valore predefinito. " nokeys
"L'applicazione non richiede una tastiera. " qwerty
"L'applicazione richiede una tastiera QWERTY standard. " twelvekey
"L'applicazione richiede un tastierino a 12 tasti, come quelli della maggior parte telefoni, con tasti per i numeri da 0
a9
, più i tasti stella (*
) e cancelletto (#
). android:reqNavigation
- L'eventuale dispositivo di navigazione richiesto dall'applicazione. Il valore
deve contenere una delle seguenti stringhe:
Valore Descrizione " undefined
"L'applicazione non richiede alcun tipo di controllo di navigazione. Il requisito di navigazione non è definito. Questo è il valore predefinito. " nonav
"L'applicazione non richiede un controllo di navigazione. " dpad
"L'applicazione richiede un D-pad per la navigazione. " trackball
"L'applicazione richiede una trackball per la navigazione. " wheel
"L'applicazione richiede una rotellina di navigazione. Se un'applicazione richiede un controllo di navigazione, ma il tipo esatto di di controllo non importa, può impostare Attributo
reqFiveWayNav
a"true"
anziché impostarlo. android:reqTouchScreen
- Il tipo di touchscreen richiesto dall'applicazione, se presente.
Il valore deve corrispondere a una delle seguenti stringhe:
Valore Descrizione " undefined
"L'applicazione non richiede un touchscreen. Il requisito del touchscreen non è definito. Questo è il valore predefinito. " notouch
"L'applicazione non richiede un touchscreen. " stylus
"L'applicazione richiede un touchscreen che funzioni con uno stilo. " finger
"L'applicazione richiede un touchscreen che si aziona con un dito. Nota: se per la tua app è necessario un qualche tipo di input tocco, utilizza invece Tag
<uses-feature>
per dichiarare il touchscreen richiesto di testo, a partire da"android.hardware.faketouch"
per eventi di base con stile touch.
- introdotto in:
- Livello API 3
- vedi anche:
-
configChanges
attributo del<activity>
elementoConfigurationInfo
<use-configuration>
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)"]]