<compatible-screens>
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
- Sintaxe:
-
<compatible-screens>
<screen android:screenSize=["small" | "normal" | "large" | "xlarge"]
android:screenDensity=["ldpi" | "mdpi" | "hdpi" | "xhdpi"
| "280" | "360" | "420" | "480" | "560" ] />
...
</compatible-screens>
- contido em:
<manifest>- descrição:
- Especifica cada configuração de tela com que o aplicativo é compatível. Apenas uma instância
do elemento
<compatible-screens> é permitida no manifesto, mas ela pode
conter vários elementos <screen>. Cada elemento <screen>
indica uma combinação específica de tamanho-densidade de tela com que o app é compatível.
O sistema Android não lê o elemento de manifesto de <compatible-screens>
em nenhum momento. Esse elemento é apenas informativo e usado
por serviços externos (como o Google Play) para compreender melhor a compatibilidade do aplicativo
com configurações de tela específicas e ativar a filtragem para os usuários.
Qualquer configuração de tela que
não seja declarada nesse elemento é uma tela com que o aplicativo não é
compatível. Serviços externos, como o Google Play, não fornecem o aplicativo para
dispositivos com essas telas.
Cuidado: normalmente, você não usa esse elemento
de manifesto. O uso desse elemento pode reduzir drasticamente a base de usuários em potencial do
aplicativo, impedindo que os usuários o instalem se tiverem um dispositivo com uma configuração
de tela que não esteja listada. Use-o apenas como último recurso, quando o
aplicativo não funcionar com configurações de tela específicas. Em vez de usar esse
elemento, siga o guia sobre Suporte a várias telas para
oferecer suporte escalonável a várias telas usando layouts e bitmaps alternativos
para diferentes tamanhos e densidades de tela.
Se você quiser definir um tamanho mínimo de tela para o aplicativo, use o elemento <supports-screens>. Por exemplo, se você quiser que o aplicativo esteja disponível
apenas para dispositivos de tela grande e extra grande, o elemento <supports-screens> permite
declarar que o aplicativo não oferece suporte para telas pequenas e normais.
Em seguida, serviços externos, como o Google Play, filtram seu aplicativo conforme necessário. Você também pode usar o
elemento <supports-screens> para declarar se o sistema precisa redimensionar
o aplicativo em diferentes tamanhos de tela.
Para mais informações sobre como o Google Play filtra aplicativos usando esse e
outros elementos de manifesto, consulte Filtros no Google Play.
- elementos filhos:
-
<screen>Especifica uma configuração de tela única com que o aplicativo é compatível.
Pelo menos uma instância desse elemento precisa ser colocada dentro do elemento
<compatible-screens>. Esse elemento precisa incluir os atributos
android:screenSize e android:screenDensity. Se você não declarar os dois
atributos, o elemento será ignorado.
Atributos:
android:screenSize- Obrigatório. Especifica o tamanho da tela para esta configuração de tela.
Valores aceitos:
smallnormallargexlarge
Para informações sobre os diferentes tamanhos de tela, consulte Visão geral de compatibilidade de tela.
android:screenDensity- Obrigatório. Especifica a densidade da tela para esta configuração de tela.
Valores aceitos:
"ldpi" (aproximadamente 120 dpi)"mdpi" (aproximadamente 160 dpi)"hdpi" (aproximadamente 240 dpi)"xhdpi" (aproximadamente 320 dpi)"280""360""420""480""560"
Para informações sobre as diferentes densidades de tela, consulte Visão geral de compatibilidade de tela.
- exemplo
-
Se o aplicativo for compatível somente com telas pequenas e normais, independente
da densidade da tela, especifique 12 elementos <screen>,
porque cada tamanho de tela tem seis configurações de densidade diferentes.
É necessário declarar cada um
deles. Qualquer combinação de tamanho e densidade que você não especificar será considerada uma configuração
de tela com que seu aplicativo não é compatível. A entrada do manifesto será parecida
com o exemplo abaixo se o aplicativo for compatível somente com telas pequenas e normais:
<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>
- introduzido no:
- Nível 9 da API
- Confira também:
- Visão geral da compatibilidade de tela
- Filtros no Google Play
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 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)"]]
