- söz dizimi:
<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"] />
- bulunduğu yer:
<manifest>
- description:
Uygulamanın gerektirdiği donanım ve yazılım özelliklerini belirtir. Örneğin, bir uygulama, fiziksel klavye gerektirdiğini belirtebilir veya iztopu gibi belirli bir gezinme cihazını kullanabilirsiniz. Spesifikasyon uygulamanın çalışmadığı cihazlara yüklenmesini önlemek için kullanılır.
Not: Çoğu uygulama bu manifest etiketini kullanmaz. Görme engellilere destek için yön tuşlarıyla (D-pad) her zaman girişi destekleyin Dokunmaya ek olarak veya dokunma yerine D-pad girişi sağlayan kullanıcılar ve destek cihazları.
Örneğin, Uygulamanızda D-pad girişini destekleme hakkında daha fazla bilgi için Kumanda işlemlerini işleme başlıklı makaleyi okuyun. Eğer Uygulamanız dokunmatik ekran olmadan kesinlikle çalışmıyor. Bunun yerine aşağıdakileri yapmak için
<uses-feature>
etiketini kullanın: gerekli dokunmatik ekran türünü (temel ekran için"android.hardware.faketouch"
aralığından) bildirin. Dokunma tarzı etkinlikleri, birden fazla parmaktan ayrı giriş için"android.hardware.touchscreen.multitouch.jazzhand"
gibi daha gelişmiş dokunma türlerine uygular.- özellikler:
android:reqFiveWayNav
- Uygulamanın beş yönlü gezinme kontrolü gerektirip gerektirmediği. İnsanların
Varsa
"true"
, değilse"false"
. Beş yönlü Ctrl, seçimi yukarı, aşağı, sağa veya sola taşıyabilen bir öğedir ve geçerli seçimi çağırmak için de bir yöntem sunar. Bu bir yön tuşları (D-pad), iztopu veya başka bir cihazla kullanılamaz.Uygulama, yönsel kontrol gerektiriyor ancak belirli bir bu özelliği
"true"
olarak ayarlayıpreqNavigation
özelliği. Ancak, belirli bir yön kontrolü türü gerekiyorsa Bunun yerinereqNavigation
değerini ayarlayın. android:reqHardKeyboard
- Uygulamanın donanım klavyesi gerektirip gerektirmediği. İnsanların
Varsa
"true"
, değilse"false"
. android:reqKeyboardType
- Varsa, uygulamanın gerektirdiği klavye türü.
Bu özellik, donanım ile yazılımı ayırt etmez
klavyeler. Belirli bir türde donanım klavyesi gerekiyorsa
türü burada belirtin ve
reqHardKeyboard
özelliğini ayarlayın Hedef:"true"
.Değer, aşağıdaki dizelerden biri olmalıdır:
Değer Açıklama " undefined
"Uygulama klavye gerektirmez. Klavye gereksinimi tanımlanmamış. Bu, varsayılan değerdir. " nokeys
"Uygulama klavye gerektirmez. " qwerty
"Uygulama standart bir Q klavye gerektirir. " twelvekey
"Uygulama, çoğu tuş takımında olduğu gibi on iki tuşlu telefonlar, 0
ile arasındaki rakamlar için anahtarlar9
, artı yıldız (*
) ve kare (#
) tuşları. android:reqNavigation
- Uygulama için gereken navigasyon cihazı (varsa). Değer
aşağıdaki dizelerden biri olmalıdır:
Değer Açıklama " undefined
"Uygulama, herhangi bir gezinme denetimi gerektirmez. Gezinme gereksinimi tanımlanmamış. Bu, varsayılan değerdir. " nonav
"Uygulama, gezinme denetimi gerektirmez. " dpad
"Uygulamada gezinme için d-pad gerekir. " trackball
"Uygulama, navigasyon için bir iztopu gerektiriyor. " wheel
"Uygulama bir gezinme tekerleği gerektirir. Bir uygulama gezinme kontrolü gerektiriyorsa, ancak herhangi bir şey olmasa da
reqFiveWayNav
özelliği"true"
ile ilişkili tercih edebilirsiniz. android:reqTouchScreen
- Uygulamanın gerektirdiği dokunmatik ekran türü (varsa).
Değer, aşağıdaki dizelerden biri olmalıdır:
Değer Açıklama " undefined
"Uygulama dokunmatik ekran gerektirmez. Dokunmatik ekran gereksinimi tanımlanmadı. Bu, varsayılan değerdir. " notouch
"Uygulama dokunmatik ekran gerektirmez. " stylus
"Uygulama, ekran kalemiyle çalıştırılan bir dokunmatik ekran gerektirir. " finger
"Uygulama, parmağınızla çalıştırılabilen bir dokunmatik ekran gerektirir. Not: Uygulamanız için bir tür dokunmatik giriş gerekiyorsa bunun yerine Gerekli dokunmatik ekranı tanımlamak için
<uses-feature>
etiketi türü, temel dokunma stili etkinlikler için"android.hardware.faketouch"
ile başlar.
- tanıtıldığı yer:
- API düzeyi 3
- ayrıca bkz.:
-
configChanges
. özelliğinin<activity>
öğeConfigurationInfo
<uses-configuration>
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[null,null,["Son güncelleme tarihi: 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)"]]