<pantallas-compatibles>
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
- sintaxis:
-
<compatible-screens>
<screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
| "280" | "360" | "420" | "480" | "560" ] />
...
</compatible-screens>
- se incluye en:
<manifest>- descripción:
- Especifica cada configuración de pantalla con la que la aplicación es compatible. Solo se permite una instancia del elemento
<compatible-screens> en el manifiesto, pero este puede contener varios elementos <screen>. Cada elemento <screen> indica una combinación de densidad de tamaño de pantalla específica con la que la aplicación es compatible.
El sistema Android no lee el elemento <compatible-screens> del manifiesto en ningún momento. Este elemento es solo informativo y pueden usarlo servicios externos (como Google Play) para comprender mejor la compatibilidad de la aplicación con configuraciones de pantalla específicas y habilitar los filtros para los usuarios puedan usarlos.
Cualquier configuración de la pantalla que no se declare en este elemento es una pantalla con la cual la aplicación no es compatible. Los servicios externos, como Google Play, no proporcionan la aplicación a los dispositivos con esas pantallas.
Precaución: Por lo general, no deberías usar este elemento del manifiesto. El uso de este elemento puede reducir notablemente la base de usuarios potenciales para tu aplicación, ya que evita que los usuarios instalen tu aplicación si tienen un dispositivo con una configuración de la pantalla que no incluiste. Debes usarlo solamente como último recurso, cuando la aplicación no funciona con alguna configuración de la pantalla específica. En lugar de usar este elemento, sigue la guía de compatibilidad con varias pantallas y proporciona compatibilidad escalable para varias pantallas utilizando diseños y mapas de bits alternativos para diferentes tamaños y densidades de pantalla.
Si deseas establecer un tamaño mínimo de pantalla para tu aplicación, usa el elemento <supports-screens>. Por ejemplo, si deseas que tu aplicación esté disponible únicamente para dispositivos con pantallas grandes y extragrandes, el elemento <supports-screens> te permite declarar que tu aplicación no admite pantallas pequeñas ni normales.
Luego, los servicios externos, como Google Play, filtran la aplicación según corresponda. También puedes usar el elemento <supports-screens> para declarar si el sistema debe cambiar el tamaño de tu aplicación en función de los diferentes tamaños de pantalla.
Para obtener más información sobre cómo Google Play filtra las aplicaciones que usan este y otros elementos del manifiesto, consulta Filtros en Google Play.
- elementos secundarios:
-
<screen>Especifica una configuración de la pantalla única con la que la aplicación es compatible.
Debe incluirse al menos una instancia de este elemento dentro del elemento <compatible-screens>, que debe incluir los atributos android:screenSize y android:screenDensity. Si no declaras ambos, se ignora el elemento.
Atributos:
android:screenSize- Obligatorio. Especifica el tamaño de la pantalla para esta configuración.
Valores aceptados:
smallnormallargexlarge
Para obtener información sobre los diferentes tamaños de pantalla, consulta Descripción general de la compatibilidad de pantallas.
android:screenDensity- Obligatorio. Especifica la densidad de pantalla para esta configuración.
Valores aceptados:
"ldpi" (aproximadamente 120 dpi)"mdpi" (aproximadamente 160 dpi)"hdpi" (aproximadamente 240 dpi)"xhdpi" (aproximadamente 320 dpi)"280""360""420""480""560"
Para obtener información sobre las diferentes densidades de pantalla, consulta Descripción general de la compatibilidad de pantallas.
- ejemplo
-
Si tu aplicación es compatible solo con pantallas pequeñas y normales, independientemente de la densidad, debes especificar 12 elementos <screen> diferentes, ya que cada tamaño de pantalla tiene seis configuraciones de densidad diferentes.
Debes declarar cada uno de ellos. Cualquier combinación de tamaño y densidad que no especifiques se considera una configuración de la pantalla con la que tu aplicación no es compatible. A continuación, se muestra el modo en que se ve la entrada de manifiesto si tu aplicación solo admite pantallas pequeñas y normales:
<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>
- primera inclusión:
- Nivel de API 9
- Consulta también:
- Descripción general de la compatibilidad de pantallas
- Filtros en Google Play
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[null,null,["Última actualización: 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)"]]
