<écrans-compatibles>

Syntaxe :
<compatible-screens>
    <screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
            android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
                                   | "280" | "360" | "420" | "480" | "560" ] />
    ...
</compatible-screens>
Contenu dans :
<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 aucun élément du fichier manifeste <compatible-screens>. Cet élément est fourni à titre indicatif uniquement. Il est 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 fournissent pas l'application aux appareils dotés de ces écrans.

Attention : Généralement, vous n'utilisez pas cet élément manifeste. Son utilisation peut réduire considérablement la base d'utilisateurs potentiels de votre application qui ne pourra pas être installée si la configuration d'écran de l'appareil ne correspond pas à ce que vous avez spécifié. Utilisez-le uniquement en dernier recours, lorsque l'application ne fonctionne pas 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 une taille d'écran minimale pour votre application, utilisez l'élément <supports-screens>. Par exemple, si vous souhaitez que votre application ne soit disponible que pour les appareils à grand et à très grand écran, l'élément <supports-screens> vous permet de déclarer qu'elle n'est pas compatible avec les écrans de petite taille et de taille moyenne. Ensuite, les services externes, tels que Google Play, filtrent votre application en conséquence. Vous pouvez également utiliser l'élément <supports-screens> pour indiquer si le système peut redimensionner votre application pour différentes tailles d'écran.

Pour découvrir comment Google Play filtre les applications avec cet élément et d'autres éléments du fichier manifeste, consultez Filtres sur Google Play.

É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>. Cet élément doit inclure les attributs android:screenSize et android:screenDensity. Si vous ne déclarez pas ces deux attributs, 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 la section Présentation de la compatibilité des é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 Présentation de la compatibilité des é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 :
Présentation de la compatibilité des écrans
Filtres sur Google Play