<écrans-compatibles>
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
- 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 :
smallnormallargexlarge
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
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[null,null,["Dernière mise à jour le 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)"]]
