Diretrizes principais de qualidade de apps

As orientações de tela e os estados de dobra expõem basicamente os mesmos recursos e ações e preservam a paridade funcional.

O app preenche a janela do app em ambas as orientações e não tem efeito letterbox devido a mudanças de configuração, incluindo dobrar e desdobrar o dispositivo.

Um leve efeito letterbox para compensar pequenas variações na geometria da tela é aceitável.

O app exibe gráficos, textos, imagens e outros elementos da interface sem distorção, desfoque ou pixelização perceptível.

• O app usa drawables vetoriais sempre que possível
• O app usa gráficos de alta qualidade para todos os tamanhos e formatos de tela.
• Nenhum serrilhado nas bordas dos menus, botões e outros elementos da interface

O app preserva o estado do usuário ou do aplicativo ao sair do primeiro plano e evita perdas acidentais de dados devido à navegação de retorno e a outras mudanças de estado.

Ao retornar para o primeiro plano, o app restaura o estado preservado e as transações com estado pendentes. Isso inclui, por exemplo, mudanças em campos editáveis, progresso em jogos, menus, vídeos e outras seções do app.

• Quando o app é retomado pelo seletor de apps Recentes, ele retorna o usuário exatamente para o mesmo estado em que estava no último uso.
• Quando o app é reiniciado depois que o dispositivo é ativado de um estado de suspensão (bloqueado), ele retorna o usuário exatamente para o mesmo estado em que estava no último uso.
• Quando o app é reiniciado pela tela Inicial ou Todos os apps, ele precisa executar uma das seguintes ações, dependendo do tempo decorrido desde o último uso:
• Se o app tiver sido usado pela última vez há poucos minutos, restaure o estado dele para que fique o mais próximo possível do anterior.
• Se mais tempo se passou desde que o app foi usado pela última vez, tente restaurá-lo para que fique o mais próximo possível do estado anterior ou abra-o na tela inicial ou em outro estado padrão.

As notificações fornecem informações relevantes relacionadas ao seu app.

• Não use notificações para fazer promoção cruzada ou publicidade de outro produto, já que isso é estritamente proibido pela Google Play Store.
• Os canais de notificação são definidos de acordo com as práticas recomendadas em vez de mostrar todas as notificações de um canal.
• Selecione a prioridade de notificação correta.
• Empilhe várias notificações em um único grupo de notificações sempre que possível.
• Defina tempos limite para as notificações, quando apropriado.
• As notificações são persistentes apenas quando estão relacionadas a eventos contínuos, como reprodução de música ou uma chamada telefônica. Para mais informações, consulte a seção Funcionalidade.

Para apps de mensagens, sociais e conversas, siga estas recomendações:

• Use as notificações MessagingStyle para conversas.
• Ofereça suporte à ação de resposta direta.
• Ofereça compatibilidade com atalhos de conversa e implemente as práticas recomendadas para conseguir a melhor classificação de compartilhamento direto.
• Ofereça compatibilidade com balões.

O texto e o conteúdo em primeiro plano do app mantêm as seguintes taxas de contraste com o plano de fundo do app:

• 3:1 para texto e gráficos grandes
• 4,5:1 para textos pequenos (menos de 18 pt ou menos de 14 pt se o texto estiver em negrito)

Saiba mais sobre cor e contraste.

Quando o usuário inicia a reprodução de áudio, o app precisa executar uma das seguintes ações em até um segundo:

• Começar a tocar o áudio
• Fornecer um indicador visual de que os dados de áudio estão sendo preparados

O app precisa ser compatível com a reprodução em segundo plano.

O app precisa usar um serviço em primeiro plano para evitar que o sistema encerre o processo do app quando ele não estiver mais visível. O app também precisa mostrar uma notificação persistente e não dispensável na barra de status ou na tela de bloqueio para informar ao usuário que o app está em execução.

Os usuários precisam conseguir controlar a reprodução usando os controles de notificação ou da tela de bloqueio ou os controles em um acessório conectado.

O app oferece suporte à reprodução de vídeo em segundo plano quando não é o app principal, inclusive quando a janela do app está:

• Minimizado
• Atrás de outras janelas ou da interface do sistema (por exemplo, aba de notificações ou tela inicial/tela de bloqueio)
• Fora da tela visível da área de trabalho

O app evita a execução de serviços desnecessariamente longos em segundo plano para garantir o bom funcionamento do dispositivo do usuário.

Observação:o sistema aplica várias restrições aos serviços em segundo plano.

Estes são exemplos de uso inadequado de serviços em segundo plano:

• Manter uma conexão de rede para notificações
• Manter uma conexão Bluetooth
• Manter o GPS ligado

Para mais informações, consulte Visão geral das tarefas em segundo plano.

Todos os SDKs do Google ou de terceiros usados estão atualizados. Qualquer melhoria nesses SDKs relacionada à estabilidade, compatibilidade ou segurança precisa ser disponibilizada aos usuários em tempo hábil.

Para SDKs do Google, use SDKs com a tecnologia do Google Play Services sempre que ela estiver disponível. Esses SDKs são compatíveis com versões anteriores, recebem atualizações automáticas, reduzem o tamanho do pacote de apps e usam os recursos do dispositivo com eficiência.

O app é compatível com os recursos de gerenciamento de energia Soneca e App em espera.

Os apps podem pedir uma isenção de manutenção de energia. Consulte Suporte a outros casos de uso em Otimizar para os modos Soneca e App em espera.

O app solicita permissão para acessar dados sensíveis, como grupos de permissões de SMS ou registro de chamadas ou localização, ou serviços que geram custos, como Telefone ou SMS, somente quando ela está diretamente relacionada aos principais casos de uso. As implicações relacionadas a essas permissões precisam ser divulgadas em destaque para o usuário.

Dependendo de como o app usa as permissões, pode haver uma forma alternativa de atender ao caso de uso do app sem depender de acesso a informações sensíveis. Por exemplo, em vez de solicitar permissões relacionadas aos contatos de um usuário, use uma intent implícita para pedir acesso.

O app define o atributo android:exported explicitamente para todas as atividades, serviços, broadcast receivers e, principalmente, provedores de conteúdo.

Apenas componentes de aplicativo que compartilham dados com outros apps ou que deveriam ser invocados por outros apps são exportados.

Todas as intents e transmissões seguem as práticas recomendadas:

• Use intents explícitas se o app de destino estiver bem definido.
• Use intents para adiar permissões para outro app que já tenha a permissão.
• Compartilhe dados de forma segura entre apps.
• As intents que contêm um payload precisam ser verificadas antes do uso.
• Se você precisar transmitir uma intent para outro app para que o receptor possa invocar e esperar um callback no app de chamada, não inclua uma intent aninhada nos extras. Use um PendingIntent.
• Ao configurar intents pendentes, defina explicitamente a flag imutável, quando aplicável.

Todos os componentes que compartilham conteúdo entre apps usam android:protectionLevel="signature" para permissões personalizadas. Isso inclui atividades, serviços, broadcast receivers e, principalmente, provedores de conteúdo.

Os apps não podem acessar uma lista de pacotes instalados.

As visualizações da Web não usam addJavaScriptInterface() com conteúdo não confiável.

No Android 6.0 (nível 23 da API e mais recentes), use canais de mensagem HTML.

O app não carrega dinamicamente códigos de fora do APK. Use os Android App Bundles, que incluem o Play Feature Delivery e o Play Asset Delivery.

Desde agosto de 2021, o uso de Android App Bundles é obrigatório para todos os novos apps na Google Play Store.

O recurso gráfico do app segue as diretrizes descritas neste artigo de suporte. Confira se:

• A página de detalhes do app inclui um recurso gráfico de alta qualidade
• o recurso gráfico não contém imagens do dispositivo, capturas de tela ou textos pequenos que ficarão ilegíveis quando reduzidos e exibidos em uma tela menor do que aquela para a qual o app é destinado;
• O recurso gráfico não se assemelha a um anúncio

Navegue por todas as partes do app: todas as telas, caixas de diálogo, configurações e todos os fluxos de usuários.

Faça testes de funcionalidade principal com o app instalado no cartão SD do dispositivo, se o app for compatível com esse método de instalação.

Para mover o app para um cartão SD, consulte as Configurações do app.

Em cada tela do app, gire o dispositivo entre as orientações paisagem e retrato e os estados dobrado e desdobrado pelo menos três vezes.

Revise todos os blocos de texto no app. Verifique se o texto e o comprimento da linha do bloco de texto estão limitados a 45 a 75 caracteres (incluindo espaços) para facilitar a leitura.

Navegue por todas as partes do app: todas as telas, caixas de diálogo, configurações e todos os fluxos de usuários.

Em cada tela do app, pressione o botão Voltar ou use o gesto de deslizar para voltar. O app precisa navegar para a tela anterior ou inicial.

Iniciar a reprodução de áudio. Interaja com outro app não relacionado a áudio como o aplicativo em primeiro plano. O app precisa continuar tocando áudio em segundo plano e mostrar uma notificação na barra de status. Verifique se você consegue gerenciar a reprodução usando os controles exibidos na notificação.

Bloqueie a tela do dispositivo. O app precisa continuar tocando áudio em segundo plano e mostrar uma notificação na tela de bloqueio. Verifique se você consegue gerenciar a reprodução usando os controles exibidos na notificação.

Use todos os principais recursos do app. Verifique se nenhum serviço em segundo plano de longa duração foi iniciado.

Alterne para outro app para enviar o seu para o segundo plano. Acesse Configurações e confira se o app está executando algum serviço enquanto está em segundo plano. No Android 4.0 e mais recentes, acesse a tela Apps e localize o app na guia Em execução.

Ative o StrictMode no seu app e use todos os recursos principais. Verifique se o app não produz nenhum aviso de desempenho StrictMode. Ou seja, nenhum flash vermelho fica visível ao testar o app. Os flashes vermelhos indicam mau comportamento em relação ao armazenamento, ao acesso à rede ou ao gerenciamento de memória (como vazamentos de memória).

Preste muita atenção à coleta de lixo e ao impacto dela na experiência do usuário.

Use todos os principais recursos do app nos modos Soneca e App em espera. Verifique se alarmes, timers, notificações e sincronizações funcionam corretamente na janela de manutenção do modo Soneca e quando o app sai do modo App em espera.

Teste o comportamento dos recursos Soneca e App em espera usando comandos do ADB. Consulte Testes com os recursos Soneca e App em espera para ver os requisitos e as orientações.

Para diagnosticar o consumo inesperado da bateria, use o Power Profiler do Android Studio ou a ferramenta Battery Historian combinada com trabalho planejado em segundo plano.