<uses-Configuration>
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
- תחביר:
<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) בנוסף למגע או במקום מגע.
עבור
מידע על התמיכה בקלט D-pad באפליקציה זמין במאמר טיפול בפעולות של השלט רחוק. אם המיקום
האפליקציה לא יכולה לפעול בלי מסך מגע. במקום זאת, אפשר להשתמש בתג <uses-feature> כדי
סוג מסך המגע נדרש להצהרה, החל מ-"android.hardware.faketouch" לשימוש בסיסי
אירועים בסגנון מגע לסוגים מתקדמים יותר של מגע, כמו "android.hardware.touchscreen.multitouch.jazzhand", לקלט ייחודי ממספר אצבעות.
- :
android:reqFiveWayNav- אם לאפליקציה נדרשת פקד ניווט עם חמישה כיוונים. זו
"true" אם כן, ו-"false" אם לא. A Fit-way
רכיב זה יכול להזיז את הבחירה למעלה, למטה, ימינה או שמאלה, וגם
מספקת גם דרך להפעיל את הבחירה הנוכחית. הוא יכול להיות
לחצני החיצים (D-pad), כדור עקיבה או מכשיר אחר.
אם אפליקציה דורשת שליטה כיוונית, אבל לא שליטה
סוג מסוים, הוא יכול להגדיר את המאפיין הזה ל-"true" ולתעלם
המאפיין reqNavigation. אבל, לפעמים
אם נדרש סוג מסוים של שליטה כיוונית, היא יכולה להתעלם
את המאפיין הזה ומגדירים במקומו reqNavigation.
android:reqHardKeyboard- אם האפליקציה מחייבת מקלדת חומרה. זו
"true" אם כן, ו-"false" אם לא.
android:reqKeyboardType- סוג המקלדת שנדרשת לאפליקציה, אם יש כזו.
המאפיין הזה לא יוצר הבחנה בין חומרה לתוכנה
מקלדות. אם נדרשת מקלדת חומרה מסוג מסוים,
לציין את הסוג כאן ולהגדיר את המאפיין
reqHardKeyboard
אל "true".
הערך חייב להיות אחת מהמחרוזות הבאות:
| ערך |
תיאור |
"undefined" |
כדי להשתמש באפליקציה אין צורך במקלדת.
לא הוגדרה דרישה למקלדת.
זהו ערך ברירת המחדל. |
"nokeys" |
כדי להשתמש באפליקציה אין צורך במקלדת. |
"qwerty" |
האפליקציה דורשת מקלדת QWERTY רגילה. |
"twelvekey" |
כדי להשתמש באפליקציה צריך להשתמש במקלדת עם 12 מקשים, כמו אלה שברוב
טלפונים, עם מפתחות למספרים מ-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
- למידע נוסף:
-
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 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)"]]
