Syntaxe :
<compatible-screens>
    <screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
            android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
                                   | "280" | "360" | "420" | "480" | "560" ] />
    ...
</compatible-screens>
Conteneur(s) :
<manifest>
Description :
Spécifie chaque configuration d'écran avec laquelle l'application est compatible. Une seule instance de l'élément <compatible-screens> est autorisée dans le fichier manifeste, mais elle peut contenir plusieurs éléments <screen>. Chaque élément <screen> spécifie une combinaison de taille d'écran et de densité spécifique avec laquelle l'application est compatible.

Le système Android ne lit pas l'élément du fichier manifeste <compatible-screens> (ni au moment de l'installation ni au moment de l'exécution). Cet élément est fourni à titre indicatif uniquement et peut être utilisé par des services externes (tels que Google Play) afin de mieux comprendre la compatibilité de l'application avec des configurations d'écran spécifiques et de permettre le filtrage pour les utilisateurs. Toute configuration d'écran non déclarée dans cet élément est un écran avec lequel l'application n'est pas compatible. Les services externes (tels que Google Play) ne doivent donc pas fournir l'application aux appareils dotés de ces écrans.

Attention : Normalement, vous ne devez pas utiliser cet élément manifeste. Son utilisation peut réduire considérablement la base d'utilisateurs potentiels de votre application, car elle ne pourra pas être installée si la configuration d'écran de l'appareil ne correspond pas à ce que vous avez spécifié. Utilisez uniquement cet élément en dernier recours, lorsque l'application est entièrement incompatible avec des configurations d'écran spécifiques. Au lieu de cela, nous vous conseillons de consulter le guide Compatibilité avec plusieurs écrans afin d'assurer une compatibilité évolutive de différents écrans à l'aide d'autres mises en pages et bitmaps pour différentes tailles et densités d'écran.

Si vous souhaitez définir uniquement une taille d'écran minimale pour votre application, vous devez utiliser l'élément <supports-screens>. Par exemple, si vous souhaitez que votre application ne soit disponible que pour les appareils à grand ou à très grand écran, l'élément <supports-screens> permet d'indiquer que votre application n'est pas compatible avec les tailles d'écran petites et standards. Les services externes (tels que Google Play) filtreront votre application en conséquence. Vous pouvez également utiliser l'élément <supports-screens> pour indiquer si le système doit redimensionner votre application pour différentes tailles d'écran.

Consultez le document Filtres sur Google Play pour découvrir comment Google Play filtre les applications en utilisant cet élément et d'autres éléments du fichier manifeste.

Éléments enfants :
<screen>
Spécifie une configuration d'écran unique avec laquelle l'application est compatible.

Au moins une instance de cet élément doit être placée dans l'élément <compatible-screens>. Il doit inclure les attributs android:screenSize et android:screenDensity (si vous ne déclarez pas les deux, l'élément est ignoré).

Attributs :

android:screenSize
Obligatoire. Indique la taille de l'écran pour cette configuration.

Valeurs acceptées :

  • small
  • normal
  • large
  • xlarge

Pour en savoir plus sur les différentes tailles d'écran, consultez Compatibilité avec plusieurs écrans.

android:screenDensity
Obligatoire. Indique la densité d'écran pour cette configuration.

Valeurs acceptées :

  • "ldpi" (environ 120 PPP)
  • "mdpi" (environ 160 PPP)
  • "hdpi" (environ 240 PPP)
  • "xhdpi" (environ 320 PPP)
  • "280"
  • "360"
  • "420"
  • "480"
  • "560"

Pour en savoir plus sur les différentes densités d'écran, consultez la section Compatibilité avec plusieurs écrans.

Exemple

Si votre application n'est compatible qu'avec les écrans de taille petite à standard, quelle que soit la densité de l'écran, vous devez spécifier 12 éléments <screen> différents, car chaque taille d'écran possède six configurations de densité différentes. Vous devez toutes les déclarer. Toute combinaison de taille et de densité que vous ne spécifiez pas sera considérée comme une configuration d'écran avec laquelle votre application n'est pas compatible. Voici à quoi ressemble l'entrée du fichier manifeste si votre application n'est compatible qu'avec les écrans de taille petite à standard :

<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>
Première apparition :
Niveau d'API 9
Voir aussi :
Compatibilité avec plusieurs écrans
Filtres sur Google Play