Visão geral de compatibilidade de dispositivos

O Android foi projetado para ser executado em muitos dispositivos diferentes, como smartphones, tablets e televisões. A variedade de dispositivos oferece um público-alvo em potencial enorme para seu app. Para que ele seja bem-sucedido em todos os dispositivos, é preciso tolerar a variabilidade de recursos e oferecer uma interface do usuário flexível que se adapte a diferentes configurações de tela.

Para ajudar na compatibilidade de dispositivos, o Android oferece um framework de app dinâmico em que é possível fornecer recursos de app específicos de configuração em arquivos estáticos, como layouts XML diferentes para tamanhos de tela distintos. Em seguida, o Android carrega os recursos adequados com base na configuração atual do dispositivo. Com um planejamento prévio do design e dos recursos adicionais do app, é possível publicar um único pacote de aplicativo (APK) que otimiza a experiência do usuário em vários dispositivos.

No entanto, se necessário, é possível especificar os requisitos de recursos do app e controlar quais tipos de dispositivos podem instalar o app pela Google Play Store. Neste documento, explicamos como controlar quais dispositivos têm acesso aos seus apps e como prepará-los para alcançar o público-alvo certo.

O que significa "compatibilidade"?

Em relação ao desenvolvimento para Android, há dois tipos de compatibilidade: com o dispositivo e com o app.

Como o Android é um projeto de código aberto, qualquer fabricante de hardware pode criar um dispositivo que execute o sistema operacional Android. No entanto, um dispositivo só é "compatível com Android" se puder executar corretamente apps criados para o ambiente de execução do Android. Os detalhes exatos do ambiente de execução do Android são definidos pelo Programa de compatibilidade do Android. Cada dispositivo precisa passar no conjunto de teste de compatibilidade (CTS, na sigla em inglês) para ser considerado compatível.

Como desenvolvedor de apps, você não precisa se preocupar se um dispositivo é compatível com o Android, porque apenas os dispositivos compatíveis com o Android incluem a Google Play Store. Portanto, se um usuário instalar seu app pela Google Play Store, ele estará usando um dispositivo compatível com o Android.

No entanto, é preciso considerar se o app é compatível com cada configurador do dispositivo em potencial. Como o Android é executado em uma ampla variedade de configurações de dispositivos, alguns recursos não estão disponíveis em todos os dispositivos. Por exemplo, alguns dispositivos podem não ter um sensor de bússola. Se a funcionalidade principal do app exigir um sensor de bússola, o app será compatível apenas com dispositivos que incluam esse recurso.

Controlar a disponibilidade do app para dispositivos

O Android oferece suporte a vários recursos que seu app pode usar com as APIs da plataforma. Alguns recursos são baseados em hardware, como um sensor de bússola, outros são baseados em software, como widgets de apps, e alguns dependem da versão da plataforma. Nem todos os dispositivos são compatíveis com todos os recursos. Por isso, talvez seja necessário controlar a disponibilidade do app para dispositivos com base nos recursos necessários.

Para alcançar a maior base de usuários possível para seu app, ofereça suporte ao maior número possível de configurações de dispositivo usando um único APK ou AAB. Na maioria das situações, isso pode ser feito desativando recursos opcionais no momento da execução e fornecendo recursos do app com alternativas para diferentes configurações, como layouts diferentes para tamanhos de tela distintos. Se necessário, é possível restringir a disponibilidade do app a determinados dispositivos na Google Play Store com base nas seguintes características:

• Recursos do dispositivo
• Versão da plataforma
• Configuração da tela

Recursos do dispositivo

Para gerenciar a disponibilidade do app com base nos recursos do dispositivo, o Android define IDs de recursos para qualquer recurso de hardware ou software que possa não estar disponível em todos os dispositivos. Por exemplo, o ID do recurso para o sensor de bússola é FEATURE_SENSOR_COMPASS, e o ID do recurso para widgets de apps é FEATURE_APP_WIDGETS.

Se necessário, você pode impedir que os usuários instalem o app quando os dispositivos não tiverem um recurso necessário. Para isso, declare o recurso usando um elemento <uses-feature> no arquivo de manifesto do app.

Por exemplo, se o app não faz sentido em um dispositivo que não tem um sensor de bússola, é possível declarar o sensor de bússola como um requisito com a seguinte tag de manifesto:

<manifest ... >
    <uses-feature android:name="android.hardware.sensor.compass"
                  android:required="true" />
    ...
</manifest>

A Google Play Store compara os recursos exigidos pelo app com os recursos disponíveis no dispositivo de cada usuário para determinar se o app é compatível com cada dispositivo. Se o dispositivo não tiver todos os recursos necessários, o usuário não poderá instalar o app.

No entanto, se a funcionalidade principal do app não exigir um recurso do dispositivo, defina o atributo required como "false" e verifique o recurso do dispositivo no momento da execução. Se o recurso do app não estiver disponível no dispositivo atual, faça uma degradação suave do recurso correspondente. Por exemplo, é possível consultar se um recurso está disponível chamando hasSystemFeature() desta forma:

if (!packageManager.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature()
}

PackageManager pm = getPackageManager();
if (!pm.hasSystemFeature(PackageManager.FEATURE_SENSOR_COMPASS)) {
    // This device doesn't have a compass. Turn off the compass feature.
    disableCompassFeature();
}

Para saber mais sobre todos os filtros que você pode usar para controlar a disponibilidade do seu app na Google Play Store, consulte a documentação Filtros no Google Play.

Versão da plataforma

Dispositivos diferentes podem executar versões diferentes da plataforma Android, como o Android 12 ou o Android 13. Cada nova versão da plataforma geralmente adiciona APIs que não estavam disponíveis na versão anterior. Para indicar qual conjunto de APIs está disponível, cada versão da plataforma especifica um nível da API. Por exemplo, o Android 12 é o nível 31 da API, e o Android 13 é o nível 33.

É necessário especificar os valores minSdkVersion e targetSdkVersion no arquivo build.gradle:

android {
    defaultConfig {
        applicationId = "com.example.myapp"

        // Defines the minimum API level required to run the app.
        minSdkVersion(30)

        // Specifies the API level used to test the app.
        targetSdkVersion(36)
        ...
    }
}

android {
    defaultConfig {
        applicationId 'com.example.myapp'

        // Defines the minimum API level required to run the app.
        minSdkVersion 30

        // Specifies the API level used to test the app.
        targetSdkVersion 36
        ...
    }
}

Para mais informações sobre o arquivo build.gradle, consulte Configurar seu build.

Cada versão sucessiva do Android oferece compatibilidade com apps criados usando as APIs de versões anteriores da plataforma. Assim, seu app é compatível com versões futuras do Android ao usar as APIs documentadas do Android.

No entanto, se o app usa APIs adicionadas em uma versão mais recente da plataforma, mas não precisa delas para a funcionalidade principal, verifique o nível da API no momento da execução e faça uma degradação suave dos recursos correspondentes quando o nível da API for muito baixo. Nesse caso, defina o minSdkVersion como o menor valor possível para a funcionalidade principal do app e compare a versão do sistema atual, SDK_INT, com a constante de codinome em Build.VERSION_CODES que corresponde ao nível da API que você quer verificar, conforme mostrado no exemplo abaixo:

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop()
}

if (Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) {
    // Running on something older than API level 11, so disable
    // the drag and drop features that use ClipboardManager APIs.
    disableDragAndDrop();
}

Configuração da tela

O Android é executado em dispositivos de vários tamanhos, como smartphones, tablets e TVs. Para categorizar os dispositivos pelo tipo de tela, o Android define duas características para cada dispositivo: tamanho da tela (o tamanho físico da tela) e densidade da tela (a densidade física dos pixels na tela, conhecida como DPI). Para simplificar as diferentes configurações, o Android generaliza essas variantes em grupos que facilitam a segmentação:

• Quatro tamanhos generalizados: pequeno, normal, grande e extra grande
• Várias densidades generalizadas: mdpi (média), hdpi (alta), xhdpi (extra-alta), xxhdpi (extra-extra-alta) e outras.

Por padrão, o app é compatível com todos os tamanhos e densidades de tela, porque o sistema faz ajustes no layout da interface e nos recursos de imagem conforme necessário para cada tela. Forneça imagens de bitmap otimizadas para densidades de tela comuns.

Otimize a experiência do usuário usando layouts flexíveis sempre que possível. Quando houver layouts para grandes mudanças de configuração, como retrato e paisagem, ou tamanhos de janela grandes e pequenos, considere fornecer layouts alternativos que sejam flexíveis para mudanças menores na configuração. Isso melhora a experiência do usuário em formatos como tablets, smartphones e dobráveis. Ele também ajuda quando as janelas mudam de tamanho no modo de várias janelas.

Para saber como criar recursos alternativos para telas diferentes e como restringir o app a determinados tamanhos de tela quando necessário, leia a visão geral de compatibilidade de tela e consulte as diretrizes de qualidade de apps para telas grandes.

Controlar a disponibilidade do app por motivos comerciais

Além de restringir a disponibilidade do app com base nas características do dispositivo, talvez seja necessário restringir a disponibilidade do app por motivos comerciais ou legais. Para esse tipo de situação, a Google Play Store oferece opções de filtragem no Play Console que permitem controlar a disponibilidade do app por motivos não técnicos, como local do usuário ou operadora de celular.

A filtragem por compatibilidade técnica, como componentes de hardware necessários, é sempre baseada nas informações contidas no arquivo APK ou AAB. No entanto, a filtragem por motivos não técnicos, como local geográfico, é sempre processada no Google Play Console.

Recursos adicionais:

Visão geral dos recursos de aplicativo

Informações sobre como os apps Android são estruturados para separar os recursos do código do app, incluindo como fornecer recursos alternativos para configurações específicas do dispositivo.

Filtros no Google Play

Informações sobre as diferentes maneiras como a Google Play Store pode impedir que seu app seja instalado em diferentes dispositivos.

Permissões no Android

Como o Android restringe o acesso de apps a determinadas APIs com um sistema de permissões que exige o consentimento do usuário para que o app use essas APIs.