<Kompatible-Bildschirme>

Syntax:
<compatible-screens>
    <screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
            android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
                                   | "280" | "360" | "420" | "480" | "560" ] />
    ...
</compatible-screens>
enthalten in:
<manifest>
description:
Gibt jede Bildschirmkonfiguration an, mit der die App kompatibel ist. Im Manifest ist nur eine Instanz des <compatible-screens>-Elements zulässig, es kann aber mehrere <screen>-Elemente enthalten. Jedes <screen>-Element gibt eine bestimmte Kombination aus Bildschirmgröße und -dichte an, mit der die App kompatibel ist.

Das Android-System liest das Manifestelement <compatible-screens> zu keinem Zeitpunkt. Dieses Element dient nur zu Informationszwecken und wird von externen Diensten wie Google Play verwendet, um die Kompatibilität der App mit bestimmten Bildschirmkonfigurationen besser nachzuvollziehen und Filter für Nutzer zu ermöglichen.

Jede Bildschirmkonfiguration, die in diesem Element nicht deklariert ist, ist ein Bildschirm, mit dem die Anwendung nicht kompatibel ist. Externe Dienste wie Google Play stellen die App nicht für Geräte mit solchen Bildschirmen bereit.

Achtung:Normalerweise verwenden Sie dieses Manifestelement nicht. Durch die Verwendung dieses Elements können Sie die potenzielle Nutzerbasis Ihrer Anwendung erheblich reduzieren, da es Nutzer, die ein Gerät mit einer Bildschirmkonfiguration haben, die Sie nicht angeben, nicht installieren können. Verwenden Sie dies nur als letztes Mittel, wenn die Anwendung überhaupt nicht mit bestimmten Bildschirmkonfigurationen kompatibel ist. Anstatt dieses Element zu verwenden, folgen Sie der Anleitung zur Unterstützung mehrerer Bildschirme, um mithilfe von alternativen Layouts und Bitmaps für verschiedene Bildschirmgrößen und -dichten skalierbare Unterstützung für mehrere Bildschirme zu bieten.

Wenn Sie eine Mindestbildschirmgröße für Ihre App festlegen möchten, verwenden Sie das Element <supports-screens>. Wenn deine App beispielsweise nur auf Geräten mit großen und sehr großen Bildschirmen verfügbar sein soll, kannst du mit dem Element <supports-screens> deklarieren, dass deine App keine kleinen und normalen Bildschirmgrößen unterstützt. Anschließend filtern externe Dienste wie Google Play deine App entsprechend. Mit dem Element <supports-screens> können Sie auch deklarieren, ob das System die Größe Ihrer Anwendung an verschiedene Bildschirmgrößen anpassen kann.

Weitere Informationen dazu, wie Google Play Apps anhand dieses und anderer Manifestelemente filtert, findest du unter Filter bei Google Play.

Untergeordnete Elemente:
<screen>

Gibt eine Einzelbildschirmkonfiguration an, mit der die Anwendung kompatibel ist.

Mindestens eine Instanz dieses Elements muss innerhalb des <compatible-screens>-Elements platziert werden. Dieses Element muss die Attribute android:screenSize und android:screenDensity enthalten. Deklarieren Sie nicht beide Attribute, wird das Element ignoriert.

Attribute:

android:screenSize
Erforderlich. Gibt die Bildschirmgröße für diese Bildschirmkonfiguration an.

Zulässige Werte:

  • small
  • normal
  • large
  • xlarge

Informationen zu den verschiedenen Bildschirmgrößen finden Sie unter Bildschirmkompatibilität – Übersicht.

android:screenDensity
Erforderlich. Gibt die Bildschirmdichte für diese Bildschirmkonfiguration an.

Zulässige Werte:

  • "ldpi" (ca. 120 dpi)
  • "mdpi" (ca. 160 dpi)
  • "hdpi" (ca. 240 dpi)
  • "xhdpi" (ca. 320 dpi)
  • "280"
  • "360"
  • "420"
  • "480"
  • "560"

Informationen zu den verschiedenen Bildschirmdichten finden Sie unter Bildschirmkompatibilität – Übersicht.

Beispiel

Wenn Ihre App unabhängig von der Bildschirmdichte nur mit kleinen und normalen Bildschirmen kompatibel ist, müssen Sie 12 <screen>-Elemente angeben, da jede Bildschirmgröße über sechs unterschiedliche Dichtekonfigurationen verfügt.

Sie müssen jede Option deklarieren. Jede nicht angegebene Kombination von Größe und Dichte wird als Bildschirmkonfiguration betrachtet, mit der Ihre Anwendung nicht kompatibel ist. So sieht der Manifesteintrag aus, wenn Ihre Anwendung nur mit kleinen und normalen Bildschirmen kompatibel ist:

<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>
eingeführt in:
API-Level 9
Siehe auch:
Bildschirmkompatibilität – Übersicht
Filter bei Google Play