<używa-konfiguracji>
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
- składnia:
<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"] />
- zawarte w:
<manifest>- description:
Wskazuje funkcje sprzętu i oprogramowania, których wymaga aplikacja.
Na przykład aplikacja może określić, że wymaga klawiatury fizycznej.
albo konkretne urządzenie nawigacyjne, np. kulka. Specyfikacja jest
w celu uniknięcia instalowania aplikacji na urządzeniach, na których nie działa.
Uwaga: większość aplikacji nie używa tego tagu manifestu.
Zawsze wspomagaj wprowadzanie tekstu za pomocą pada kierunkowego (pada kierunkowego), aby pomagać osobom z wadą wzroku.
dla użytkowników i obsługiwanych urządzeń, które oprócz dotyku lub zamiast nich mają pad kierunkowy.
Dla:
informacje o obsłudze wprowadzania w aplikacji pada kierunkowego znajdziesz w artykule Obsługiwanie działań kontrolera. Jeśli
aplikacja nie może działać bez ekranu dotykowego. Zamiast tego użyj tagu <uses-feature>,
zadeklaruj wymagany typ ekranu dotykowego, od "android.hardware.faketouch" do podstawowego
zdarzeń dotyku po bardziej zaawansowane rodzaje dotyku, np. "android.hardware.touchscreen.multitouch.jazzhand", które pozwalają wprowadzać różne dane za pomocą wielu palców.
- atrybuty:
android:reqFiveWayNav- Określ, czy aplikacja wymaga 5-kierunkowej nawigacji. Jest
"true", jeśli tak, lub "false", jeśli nie. Pięciokanałowe
umożliwia przeniesienie zaznaczenia w górę, w dół, w prawo lub w lewo oraz
pozwala też wywołać bieżący wybór. Może to być
pada kierunkowego, manipulatora kierunkowego lub kulki.
Jeśli aplikacja wymaga sterowania kierunkowego, ale nie elementu sterującego
określonego typu, może ustawić ten atrybut na "true" i zignorować
atrybut reqNavigation. Pamiętaj jednak:
jeśli wymaga określonego rodzaju sterowania kierunkowego, może zignorować
ten atrybut i ustaw reqNavigation.
android:reqHardKeyboard- Określ, czy aplikacja wymaga klawiatury sprzętowej. Jest
"true", jeśli tak, lub "false", jeśli nie.
android:reqKeyboardType- Typ klawiatury wymaganej przez aplikację (jeśli istnieje).
Ten atrybut nie rozróżnia sprzętu od oprogramowania
klawiatury. Jeśli wymagana jest klawiatura sprzętowa określonego typu,
określ tutaj typ, a także ustaw atrybut
reqHardKeyboard
do: "true".
Wartość musi być jednym z tych ciągów:
| Wartość |
Opis |
„undefined” |
Aplikacja nie wymaga klawiatury.
Niezdefiniowane wymagania dotyczące klawiatury.
jest to wartość domyślna |
„nokeys” |
Aplikacja nie wymaga klawiatury. |
„qwerty” |
Aplikacja wymaga standardowej klawiatury QWERTY. |
„twelvekey” |
Aplikacja wymaga klawiatury z 12 klawiszami, tak jak w większości
telefony z kluczami od cyfr od 0 do
9 oraz klucze w postaci gwiazdek (*) i funta (#). |
android:reqNavigation- Urządzenie nawigacyjne wymagane przez aplikację (w stosownych przypadkach). Wartość
musi być jednym z tych ciągów:
| Wartość |
Opis |
„undefined” |
Aplikacja nie wymaga żadnego rodzaju elementów sterujących nawigacją.
Niezdefiniowane wymagania dotyczące nawigacji.
jest to wartość domyślna |
„nonav” |
Aplikacja nie wymaga elementów sterujących nawigacją. |
„dpad” |
Aplikacja wymaga pada kierunkowego do nawigacji. |
„trackball” |
Aplikacja wymaga kulki do nawigacji. |
„wheel” |
Aplikacja wymaga koła nawigacyjnego. |
Jeśli aplikacja wymaga elementów sterujących nawigacją, ale dokładny typ
nie ma znaczenia, ale określa on
Atrybut reqFiveWayNav do "true"
zamiast ustawiać ten.
android:reqTouchScreen- Typ ekranu dotykowego, którego wymaga aplikacja, (jeśli taki istnieje).
Wartość musi być jednym z tych ciągów:
| Wartość |
Opis |
„undefined” |
Aplikacja nie wymaga ekranu dotykowego.
Niezdefiniowane wymagania dotyczące ekranu dotykowego.
jest to wartość domyślna |
„notouch” |
Aplikacja nie wymaga ekranu dotykowego. |
„stylus” |
Aplikacja wymaga ekranu dotykowego, który obsługuje się rysikiem. |
„finger” |
Aplikacja wymaga ekranu dotykowego obsługiwanego palcem.
Uwaga: jeśli aplikacja wymaga sterowania dotykowego,
zamiast tego użyj
Tag <uses-feature> do deklarowania wymaganego ekranu dotykowego
typu, rozpoczynając od "android.hardware.faketouch" w przypadku podstawowych zdarzeń dotyku.
|
- wprowadzone w:
- Poziom API 3
- zobacz też:
-
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 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)"]]
