<תואם-מסכים>
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
- תחביר:
-
<compatible-screens>
<screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
| "280" | "360" | "420" | "480" | "560" ] />
...
</compatible-screens>
- בתוך:
<manifest>- תיאור:
- ההגדרה קובעת כל תצורת מסך שהאפליקציה תואמת אליה. רק מופע אחד
של הרכיב
<compatible-screens> מותר במניפסט, אבל הוא יכול
מכילים מספר רכיבי <screen>. כל רכיב <screen>
מציין שילוב ספציפי של צפיפות גודל מסך שאיתו האפליקציה תואמת.
מערכת Android לא קוראת את המניפסט <compatible-screens>
בכל שלב. הרכיב הזה הוא למידע בלבד והוא משמש
על ידי שירותים חיצוניים, כמו Google Play, כדי להבין טוב יותר את התאימות של האפליקציה
עם הגדרות מסך ספציפיות ולאפשר סינון למשתמשים.
כל הגדרת מסך
לא מוצהר ברכיב הזה הוא מסך שהאפליקציה לא
תואמת. שירותים חיצוניים, כמו Google Play, לא מספקים את האפליקציה ל
עם מסכים כאלה.
זהירות: בדרך כלל לא משתמשים במניפסט הזה
רכיב. השימוש ברכיב זה יכול לצמצם באופן משמעותי את בסיס המשתמשים הפוטנציאלי עבור
על ידי מניעת ההתקנה של האפליקציה אם יש להם מכשיר עם מסך
של ההגדרות האישיות שלא תציינו. השתמשו בו רק בתור מוצא אחרון,
פשוט לא עובדת עם תצורות מסך ספציפיות. במקום להשתמש
רכיב, יש לפעול לפי המדריך לתמיכה במספר מסכים כדי
לספק תמיכה ניתנת להרחבה במספר מסכים באמצעות פריסות חלופיות ומפות סיביות
למסכים בגדלים שונים ולצפיפות.
כדי להגדיר גודל מסך מינימלי לאפליקציה, אפשר להשתמש ברכיב <supports-screens>. לדוגמה, אם רוצים שהאפליקציה תהיה זמינה
רק למכשירים עם מסך גדול וגדול במיוחד, הרכיב <supports-screens> מאפשר
הצהרת שהאפליקציה שלך לא תומכת במסכים קטנים ורגילים.
לאחר מכן, שירותים חיצוניים כמו Google Play מסננים את האפליקציה בהתאם. אפשר גם להשתמש
<supports-screens> להצהרה אם המערכת יכולה לשנות את גודל
למסכים בגדלים שונים.
למידע נוסף על האופן שבו Google Play מסננת אפליקציות באמצעות המסנן הזה
רכיבי מניפסט אחרים זמינים במאמר מסננים ב-Google Play.
- רכיבי צאצא:
-
<screen>מציינת תצורה של מסך יחיד שהאפליקציה תואמת לו.
יש למקם לפחות מופע אחד של הרכיב הזה בתוך <compatible-screens>
לרכיב מסוים. הרכיב הזה חייב לכלול גם את android:screenSize וגם את
android:screenDensity. אם לא מצהירים על שניהם
ומאפיינים, המערכת מתעלמת מהרכיב.
מאפיינים:
android:screenSize- חובה. מציינת את גודל המסך של הגדרות המסך האלה.
ערכים קבילים:
smallnormallargexlarge
למידע על גודלי המסכים השונים, ראו סקירה כללית על תאימות המסך.
android:screenDensity- חובה. מציינת את דחיסות המסך בהגדרת המסך הזו.
ערכים קבילים:
"ldpi" (בערך 120 dpi)"mdpi" (בערך 160 dpi)"hdpi" (בערך 240dpi)"xhdpi" (כ-320dpi)"280""360""420""480""560"
למידע על דחיסות המסך השונות, ראו סקירה כללית על תאימות המסך.
- דוגמה
-
אם האפליקציה תואמת למסכים קטנים ורגילים בלבד, ללא קשר
של דחיסות המסך, צריך לציין 12 רכיבי <screen>,
מפני שלכל גודל מסך יש שש תצורות שונות של דחיסות.
עליך להצהיר על כל אחד מ-
האלה. כל שילוב של גודל וצפיפות שלא מציינים נחשב למסך
תצורה שהאפליקציה שלך לא תואמת אליה. כך מופיע המניפסט
הרשומה נראית אם האפליקציה שלך תואמת למסכים קטנים ורגילים בלבד:
<manifest ... >
...
<compatible-screens>
<!-- all small size screens -->
<screen android:screenSize="small" android:screenDensity="ldpi" />
<screen android:screenSize="small" android:screenDensity="mdpi" />
<screen android:screenSize="small" android:screenDensity="hdpi" />
<screen android:screenSize="small" android:screenDensity="xhdpi" />
<screen android:screenSize="small" android:screenDensity="xxhdpi" />
<screen android:screenSize="small" android:screenDensity="xxxhdpi" />
<!-- all normal size screens -->
<screen android:screenSize="normal" android:screenDensity="ldpi" />
<screen android:screenSize="normal" android:screenDensity="mdpi" />
<screen android:screenSize="normal" android:screenDensity="hdpi" />
<screen android:screenSize="normal" android:screenDensity="xhdpi" />
<screen android:screenSize="normal" android:screenDensity="xxhdpi" />
<screen android:screenSize="normal" android:screenDensity="xxxhdpi" />
</compatible-screens>
<application ... >
...
<application>
</manifest>
- הושקו ב:
- רמת API 9
- למידע נוסף:
- סקירה כללית על תאימות המסך
- מסננים ב-Google Play
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# <compatible-screens\u003e\n\nsyntax:\n:\n\n ```xml\n \u003ccompatible-screens\u003e\n \u003cscreen android:screenSize=[\"small\" | \"normal\" | \"large\" | \"xlarge\"]\n android:screenDensity=[\"ldpi\" | \"mdpi\" | \"hdpi\" | \"xhdpi\"\n | \"280\" | \"360\" | \"420\" | \"480\" | \"560\" ] /\u003e\n ...\n \u003c/compatible-screens\u003e\n ```\n\ncontained in:\n: [\u003cmanifest\u003e](/guide/topics/manifest/manifest-element)\n\ndescription:\n: Specifies each screen configuration with which the application is compatible. Only one instance\n of the `\u003ccompatible-screens\u003e` element is allowed in the manifest, but it can\n contain multiple `\u003cscreen\u003e` elements. Each `\u003cscreen\u003e` element\n specifies a specific screen size-density combination with which the application is compatible.\n\n The Android system *doesn't* read the `\u003ccompatible-screens\u003e` manifest\n element at any point. This element is informational only and is used\n by external services, such as Google Play, to better understand the application's compatibility\n with specific screen configurations and to enable filtering for users.\n\n\n Any screen configuration that\n *isn't* declared in this element is a screen with which the application *isn't*\n compatible. External services, such as Google Play, don't provide the application to\n devices with such screens.\n\n\n **Caution:** Normally, *you don't use this manifest\n element* . Using this element can dramatically reduce the potential user base for your\n application by preventing users from installing your application if they have a device with a screen\n configuration that you don't list. Use it only as a last resort, when the\n application absolutely doesn't work with specific screen configurations. Instead of using this\n element, follow the guide to [supporting multiple screens](/guide/practices/screens_support) to\n provide scalable support for multiple screens using alternative layouts and bitmaps\n for different screen sizes and densities.\n\n\n If you want to set a minimum screen size for your your application, use the [`\u003csupports-screens\u003e`](/guide/topics/manifest/supports-screens-element) element. For example, if you want your application to be available\n only for large and extra-large screen devices, the `\u003csupports-screens\u003e` element lets\n you declare that your application doesn't support small and normal screen sizes.\n Then, external services like Google Play filter your application accordingly. You can also use the\n `\u003csupports-screens\u003e` element to declare whether the system can resize your\n application for different screen sizes.\n\n\n For more information about how Google Play filters applications using this and\n other manifest elements, see [Filters on Google Play](/google/play/filters).\n\n\nchild elements:\n:\n\n `\u003cscreen\u003e`\n\n : Specifies a single screen configuration with which the application is compatible.\n\n At least one instance of this element must be placed inside the `\u003ccompatible-screens\u003e`\n element. This element must include both the `android:screenSize` and\n `android:screenDensity` attributes. If you don't declare both\n attributes, then the element is ignored.\n\n Attributes:\n\n `android:screenSize`\n : **Required.** Specifies the screen size for this screen configuration.\n\n Accepted values:\n\n - `small`\n - `normal`\n - `large`\n - `xlarge`\n\n\n For information about the different screen sizes, see [Screen compatibility overview](/guide/practices/screens_support#sizes).\n\n `android:screenDensity`\n : **Required.** Specifies the screen density for this screen configuration.\n\n Accepted values:\n\n - `\"ldpi\"` (approximately 120 dpi)\n - `\"mdpi\"` (approximately 160 dpi)\n - `\"hdpi\"` (approximately 240 dpi)\n - `\"xhdpi\"` (approximately 320 dpi)\n - `\"280\"`\n - `\"360\"`\n - `\"420\"`\n - `\"480\"`\n - `\"560\"`\n\n\n For information about the different screen densities, see [Screen compatibility overview](/guide/practices/screens_support#density).\n\n\nexample\n\n: If your application is compatible with only small and normal screens, regardless\n of screen density, then you must specify 12 `\u003cscreen\u003e` elements,\n because each screen size has six different density configurations.\n\n You must declare each one of\n these. Any combination of size and density that you *don't* specify is considered a screen\n configuration with which your application *isn't* compatible. Here's what the manifest\n entry looks like if your application is compatible with only small and normal screens: \n\n ```xml\n \u003cmanifest ... \u003e\n ...\n \u003ccompatible-screens\u003e\n \u003c!-- all small size screens --\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"ldpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"mdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"hdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"xhdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"xxhdpi\" /\u003e\n \u003cscreen android:screenSize=\"small\" android:screenDensity=\"xxxhdpi\" /\u003e\n \u003c!-- all normal size screens --\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"ldpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"mdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"hdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"xhdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"xxhdpi\" /\u003e\n \u003cscreen android:screenSize=\"normal\" android:screenDensity=\"xxxhdpi\" /\u003e\n \u003c/compatible-screens\u003e\n \u003capplication ... \u003e\n ...\n \u003capplication\u003e\n \u003c/manifest\u003e\n ```\n\nintroduced in:\n: API level 9\n\nsee also:\n: [Screen compatibility overview](/guide/practices/screens_support)\n: [Filters on Google Play](/google/play/filters)"]]
