- синтаксис:
<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>
- описание:
Указывает аппаратные и программные функции, необходимые приложению. Например, приложение может указать, что ему требуется физическая клавиатура или определенное навигационное устройство, например трекбол. Спецификация используется для того, чтобы избежать установки приложения на устройства, на которых оно не работает.
Примечание. Большинство приложений не используют этот тег манифеста. Всегда поддерживайте ввод с помощью крестовины (D-pad), чтобы помочь пользователям с нарушениями зрения, и поддерживайте устройства, обеспечивающие ввод с помощью крестовины в дополнение к сенсорному вводу или вместо него.
Информацию о том, как поддерживать ввод с помощью D-pad в вашем приложении, можно найти в разделе «Обработка действий контроллера» . Если ваше приложение абсолютно не может работать без сенсорного экрана, вместо этого используйте тег
<uses-feature>
, чтобы объявить требуемый тип сенсорного экрана, начиная от"android.hardware.faketouch"
для основных событий сенсорного стиля и заканчивая более продвинутыми типами сенсорного экрана, такими как как"android.hardware.touchscreen.multitouch.jazzhand"
для четкого ввода несколькими пальцами.- атрибуты:
-
android:reqFiveWayNav
- Требуется ли приложению пятипозиционный навигационный элемент управления. Это
"true"
если это так, и"false"
если нет. Пятипозиционный элемент управления позволяет перемещать выделение вверх, вниз, вправо или влево, а также обеспечивает способ вызова текущего выделения. Это может быть крестовина, трекбол или другое устройство.Если приложению требуется элемент управления направлением, но не элемент управления определенного типа, оно может установить для этого атрибута значение
"true"
и игнорировать атрибутreqNavigation
. Однако, если требуется определенный тип управления направлением, он может игнорировать этот атрибут и вместо этого установитьreqNavigation
. -
android:reqHardKeyboard
- Требуется ли приложению аппаратная клавиатура. Это
"true"
если это так, и"false"
если нет. -
android:reqKeyboardType
- Тип клавиатуры, требуемой приложению, если таковая имеется. Этот атрибут не различает аппаратные и программные клавиатуры. Если требуется аппаратная клавиатура определенного типа, укажите здесь тип, а также установите для атрибута
reqHardKeyboard
значение"true"
.Значение должно быть одной из следующих строк:
Ценить Описание " undefined
"Приложение не требует клавиатуры. Требования к клавиатуре не определены. Это значение по умолчанию. " nokeys
"Приложение не требует клавиатуры. " qwerty
"Для приложения требуется стандартная QWERTY-клавиатура. « twelvekey
»Для приложения требуется клавиатура с двенадцатью клавишами, как на большинстве телефонов, с клавишами для цифр от 0
до9
, а также клавишами со звездочкой (*
) и решеткой (#
). -
android:reqNavigation
- Навигационное устройство, необходимое приложению, если таковое имеется. Значение должно быть одной из следующих строк:
Ценить Описание " undefined
"Приложение не требует какого-либо управления навигацией. Требование к навигации не определено. Это значение по умолчанию. " nonav
"Приложение не требует управления навигацией. " dpad
"Приложению требуется D-pad для навигации. " trackball
"Для навигации приложению требуется трекбол. " wheel
"Для приложения требуется навигационное колесо. Если приложению требуется элемент управления навигацией, но точный тип элемента управления не имеет значения, оно может установить для атрибута
reqFiveWayNav
значение"true"
, а не устанавливать его. -
android:reqTouchScreen
- Тип сенсорного экрана, который требуется приложению, если таковой имеется. Значение должно быть одной из следующих строк:
Ценить Описание " undefined
"Приложение не требует сенсорного экрана. Требование к сенсорному экрану не определено. Это значение по умолчанию. " notouch
"Приложение не требует сенсорного экрана. " stylus
"Для приложения требуется сенсорный экран, которым можно управлять с помощью стилуса. " finger
"Для приложения требуется сенсорный экран, которым можно управлять пальцем. Примечание. Если для вашего приложения требуется какой-либо тип сенсорного ввода, вместо этого используйте тег
<uses-feature>
, чтобы объявить требуемый тип сенсорного экрана, начиная с"android.hardware.faketouch"
для основных событий сенсорного стиля.
-
- представлено в:
- API уровня 3
- см. также:
- Атрибут
configChanges
элемента<activity>
-
ConfigurationInfo
- Атрибут
<использует-конфигурацию>
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-07-29 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)"]]