<תואם-מסכים>

תחביר:
<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
חובה. מציינת את גודל המסך של הגדרות המסך האלה.

ערכים קבילים:

  • small
  • normal
  • large
  • xlarge

למידע על גודלי המסכים השונים, ראו סקירה כללית על תאימות המסך.

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