Nível da API: 21
Além de novos recursos e funcionalidades, o Android 5.0 inclui várias mudanças no sistema e no comportamento da API. Este documento destaca algumas das principais mudanças que você precisa entender e considerar nos seus apps.
Se você já publicou um app para Android, saiba que ele pode ser afetado por essas mudanças no Android 5.0.
Para uma visão geral dos novos recursos da plataforma, consulte os destaques do Android Lollipop.
Vídeos
Dev Byte: What's New in Android 5.0 (em inglês)
Android Runtime (ART)
No Android 5.0, o ambiente de execução ART substitui o Dalvik como padrão da plataforma. O ambiente de execução ART foi introduzido no Android 4.4 em caráter experimental.
Para uma visão geral dos novos recursos do ART, consulte Introdução ao ART. Alguns dos principais recursos novos são:
- Compilação antecipada (AOT, na sigla em inglês)
- Coleta de lixo (GC, na sigla em inglês) aprimorada
- Suporte aprimorado para depuração
A maioria dos apps Android funciona sem mudanças no ART. No entanto, algumas técnicas que funcionam na Dalvik não funcionam na ART. Para informações sobre os problemas mais importantes, consulte Como verificar o comportamento do app no Android Runtime (ART). Preste atenção especial se:
- Seu app usa a Java Native Interface (JNI) para executar código C/C++.
- Você usa ferramentas para desenvolvedores que geram código não padrão (como alguns ofuscadores).
- Você usa técnicas incompatíveis com a coleta de lixo compactada.
Notificações
Verifique se as notificações levam em conta essas mudanças do Android 5.0. Para saber mais sobre como criar notificações para o Android 5.0 e versões mais recentes, consulte o guia de design de notificações.
Estilo do Material Design
As notificações são desenhadas com texto escuro sobre fundos brancos (ou muito claros) para corresponder aos novos widgets do Material Design. Verifique se todas as suas notificações estão corretas com o novo esquema de cores. Se as notificações estiverem incorretas, corrija-as:
- Use
setColor()para definir uma cor de destaque em um círculo atrás da imagem do ícone. - Atualize ou remova recursos que envolvem cores. O sistema ignora todos os canais não alfa nos ícones de ação e no ícone de notificação principal. Presuma que esses ícones serão somente alfa. O sistema desenha ícones de notificação em branco e ícones de ação em cinza-escuro.
Som e vibração
Se você estiver adicionando sons e vibrações às suas notificações usando
as classes Ringtone, MediaPlayer
ou Vibrator, remova esse código para que
o sistema possa apresentar as notificações corretamente no
modo de prioridade. Em vez disso, use
os métodos Notification.Builder para adicionar sons e
vibração.
Definir o dispositivo como
RINGER_MODE_SILENT faz com que
ele entre no novo modo de prioridade. O dispositivo sai do modo prioritário
se você o definir como
RINGER_MODE_NORMAL ou
RINGER_MODE_VIBRATE.
Anteriormente, o Android usava STREAM_MUSIC
como o stream mestre para controlar o volume em tablets. No Android 5.0, o
stream de volume principal para smartphones e tablets foi unificado e
é controlado por STREAM_RING ou
STREAM_NOTIFICATION.
Visibilidade da tela de bloqueio
Por padrão, as notificações agora aparecem na tela de bloqueio do usuário no Android 5.0.
Os usuários podem optar por proteger informações sensíveis contra exposição. Nesse
caso, o sistema oculta automaticamente o texto exibido pela notificação. Para
personalizar essa notificação editada, use
setPublicVersion().
Se a notificação não tiver informações pessoais ou se você quiser
permitir o controle de mídia na notificação, chame o método
setVisibility()
e defina o nível de visibilidade da notificação como
VISIBILITY_PUBLIC.
Reprodução de mídia
Se você estiver implementando notificações que apresentam o status de reprodução de mídia
ou controles de transporte, use o novo modelo
Notification.MediaStyle em vez de um objeto
RemoteViews.RemoteView personalizado. Seja qual for a abordagem escolhida, defina a visibilidade da notificação como
VISIBILITY_PUBLIC para que
os controles fiquem acessíveis na tela de bloqueio. No Android 5.0, o sistema não mostra mais objetos RemoteControlClient na tela de bloqueio. Para mais
informações, consulte
Se o app usa o RemoteControlClient.
Notificação de informações básicas
As notificações agora podem aparecer em uma pequena janela flutuante (também chamada de notificação de alerta) quando o dispositivo está ativo (ou seja, desbloqueado e com a tela ligada). Essas notificações são semelhantes à forma compacta da sua notificação, mas a notificação de alerta também mostra botões de ação. Os usuários podem agir ou dispensar uma notificação de alerta sem sair do app atual.
Exemplos de condições que podem acionar notificações de alerta incluem:
- A atividade do usuário está no modo de tela cheia (o app usa
fullScreenIntent). - A notificação tem alta prioridade e usa toques ou vibrações.
Se o app implementar notificações em qualquer um desses cenários, verifique se as notificações de alerta são apresentadas corretamente.
Controles de mídia e RemoteControlClient
A classe RemoteControlClient foi descontinuada. Mude
para a nova API MediaSession assim
que possível.
As telas de bloqueio no Android 5.0 não mostram controles de transporte para
MediaSession ou
RemoteControlClient. Em vez disso, o app pode oferecer
controle de reprodução de mídia na tela de bloqueio usando uma notificação. Isso
dá ao app mais controle sobre a apresentação dos botões de mídia, além de
oferecer uma experiência consistente para os usuários em dispositivos bloqueados e
desbloqueados.
O Android 5.0 introduz um novo
modelo Notification.MediaStyle para essa finalidade.
O Notification.MediaStyle converte as ações de notificação
que você adicionou com
Notification.Builder.addAction() em botões compactos incorporados às notificações de reprodução de mídia
do app. Transmita o token de sessão para o
método setSession() para informar ao sistema que essa notificação controla uma
sessão de mídia em andamento.
Defina a visibilidade da notificação como
VISIBILITY_PUBLIC
para marcar a notificação como segura para exibição em qualquer tela de bloqueio (segura ou
não). Para mais informações, consulte
Notificações na tela de bloqueio.
Para mostrar os controles de mídia se o app estiver em execução na plataforma Android TV ou Wear, implemente a classe MediaSession. Você também precisa implementar
MediaSession se o app precisar receber eventos de botão de mídia
em dispositivos Android.
getRecentTasks()
Com a introdução do novo recurso de tarefas de documentos e atividades
simultâneas no Android 5.0 (consulte Documentos e atividades
simultâneos na tela de recentes),
o método ActivityManager.getRecentTasks() foi descontinuado para melhorar a privacidade
do usuário. Para compatibilidade com versões anteriores, esse método ainda retorna um pequeno subconjunto de
dados, incluindo as próprias tarefas do aplicativo de chamada e possivelmente algumas outras
tarefas não confidenciais (como a página inicial). Se o app estiver usando esse método para recuperar
as próprias tarefas, use getAppTasks()
para recuperar essas informações.
Suporte a 64 bits no Android NDK
O Android 5.0 introduz suporte para sistemas de 64 bits. A melhoria de 64 bits aumenta o espaço de endereço e melhora o desempenho, sem deixar de oferecer suporte total aos apps de 32 bits. O suporte a 64 bits também melhora o desempenho do OpenSSL para criptografia. Além disso, essa versão apresenta novas APIs de mídia nativas do NDK, bem como suporte nativo ao OpenGL ES (GLES) 3.1.
Para usar o suporte de 64 bits fornecido no Android 5.0, faça o download e instale a revisão 10c do NDK na página do Android NDK. Consulte as notas da versão da revisão 10c para mais informações sobre mudanças importantes e correções de bugs no NDK.
Como vincular a um serviço
O método
Context.bindService()
agora requer um Intent explícito
e gera uma exceção se receber uma intent implícita.
Para garantir que o app seja seguro, use uma intent explícita ao iniciar ou vincular
o Service e não declare filtros de intent para o serviço.
WebView
O Android 5.0 muda o comportamento padrão do app.
- Se o app for destinado ao nível 21 da API ou mais recente:
- O sistema
bloqueia conteúdo misto e cookies de terceiros por padrão. Para permitir conteúdo misto
e cookies de terceiros, use os métodos
setMixedContentMode()esetAcceptThirdPartyCookies(), respectivamente. - Agora, o sistema escolhe de forma inteligente partes do documento HTML
para renderizar. Esse novo comportamento padrão ajuda a reduzir o consumo de memória
e aumentar o desempenho. Se você quiser
renderizar todo o documento de uma vez, desative essa otimização chamando
enableSlowWholeDocumentDraw().
- O sistema
bloqueia conteúdo misto e cookies de terceiros por padrão. Para permitir conteúdo misto
e cookies de terceiros, use os métodos
- Se o app for direcionado a níveis de API anteriores ao 21: o sistema permite conteúdo misto e cookies de terceiros e sempre renderiza todo o documento de uma vez.
Requisito de exclusividade para permissões personalizadas
Conforme documentado na visão geral de Permissões,
os apps Android podem definir permissões personalizadas como uma forma de gerenciar
o acesso a componentes de maneira reservada, sem usar as permissões de sistema
predefinidas da plataforma. Os apps definem permissões personalizadas em elementos
<permission> declarados nos arquivos de manifesto.
Há alguns cenários em que a definição de permissões personalizadas é uma abordagem legítima e segura. No entanto, criar permissões personalizadas às vezes é desnecessário e pode até mesmo introduzir um risco potencial para um app, dependendo do nível de proteção atribuído às permissões.
O Android 5.0 inclui uma mudança de comportamento para garantir que apenas um app possa definir uma permissão personalizada, a menos que seja assinado com a mesma chave de outros apps que definem a permissão.
Apps que usam permissões personalizadas duplicadas
Qualquer app pode definir as permissões personalizadas que quiser. Por isso, é possível que vários apps definam a mesma permissão personalizada. Por exemplo, se dois apps oferecem um recurso semelhante, eles podem derivar o mesmo nome lógico para as permissões personalizadas. Os apps também podem incorporar bibliotecas públicas comuns ou exemplos de código que incluem as mesmas definições de permissão personalizada.
No Android 4.4 e versões anteriores, os usuários podiam instalar vários apps desse tipo em um determinado dispositivo, embora o sistema atribuísse o nível de proteção especificado pelo primeiro app instalado.
A partir do Android 5.0, o sistema aplica uma nova restrição de exclusividade em permissões personalizadas para apps assinados com chaves diferentes. Agora, apenas um app em um dispositivo pode definir uma determinada permissão personalizada (conforme determinado pelo nome), a menos que o outro app que define a permissão seja assinado com a mesma chave. Se o usuário tentar instalar um app com uma permissão personalizada duplicada e não assinado com a mesma chave do app residente que define a permissão, o sistema vai bloquear a instalação.
Considerações para seu app
No Android 5.0 e versões mais recentes, os apps podem continuar definindo as próprias permissões
personalizadas como antes e solicitando permissões personalizadas de outros apps
pelo mecanismo <uses-permission>. No entanto, com o
novo requisito introduzido no Android 5.0, é preciso avaliar cuidadosamente
os possíveis impactos no app.
Considere estes pontos importantes:
- Seu app declara algum elemento
<permission>no manifesto? Se sim, elas são realmente necessárias para o funcionamento adequado do app ou serviço? Ou você poderia usar uma permissão padrão do sistema? - Se você tiver elementos
<permission>no app, sabe de onde eles vieram? - Você realmente quer que outros apps solicitem suas permissões personalizadas
usando
<uses-permission>? - Você está usando código clichê ou de exemplo no app que inclui elementos
<permission>? Esses elementos de permissão são realmente necessários? - Suas permissões personalizadas usam nomes simples ou baseados em termos comuns que outros apps podem compartilhar?
Novas instalações e atualizações
Como mencionado acima, as novas instalações e atualizações do seu app em dispositivos com o Android 4.4 ou versões anteriores não são afetadas, e não há mudança no comportamento. Para novas instalações e atualizações em dispositivos com o Android 5.0 ou mais recente, o sistema impede a instalação do app se ele definir uma permissão personalizada que já esteja definida por um app residente existente.
Instalações atuais com a atualização do sistema Android 5.0
Se o app usa permissões personalizadas e é amplamente distribuído e instalado, é possível que ele seja afetado quando os usuários atualizarem os dispositivos para o Android 5.0. Depois que a atualização do sistema é instalada, o sistema revalida os apps instalados, incluindo uma verificação das permissões personalizadas. Se o app definir uma permissão personalizada que já foi definida por outro app validado, e o app não estiver assinado com a mesma chave do outro app, o sistema não vai reinstalar o app.
Recomendações
Em dispositivos com o Android 5.0 ou mais recente, recomendamos que você examine seu app imediatamente, faça os ajustes necessários e publique a versão atualizada o mais rápido possível para os usuários.
- Se você estiver usando permissões personalizadas no app, considere a origem delas
e se elas são realmente necessárias. Remova todos os elementos
<permission>do app, a menos que você tenha certeza de que eles são necessários para o funcionamento correto do app. - Considere substituir as permissões personalizadas pelas permissões padrão do sistema, quando possível.
- Se o app exigir permissões personalizadas, renomeie-as para que sejam exclusivas, por exemplo, anexando-as ao nome completo do pacote do app.
- Se você tiver um pacote de apps assinados com chaves diferentes e eles
acessarem um componente compartilhado por meio de uma permissão personalizada, verifique se ela
está definida apenas uma vez, no componente compartilhado. Os apps que
usam o componente compartilhado não podem definir a permissão personalizada,
mas precisam solicitar acesso pelo mecanismo
<uses-permission>. - Se você tiver um pacote de apps assinados com a mesma chave, cada app poderá definir as mesmas permissões personalizadas conforme necessário. O sistema permite que os apps sejam instalados da maneira habitual.
Mudanças na configuração padrão de TLS/SSL
O Android 5.0 introduz mudanças na configuração padrão de TLS/SSL usada por apps para HTTPS e outros tráfegos TLS/SSL:
- Os protocolos TLSv1.2 e TLSv1.1 agora estão ativados,
- Os conjuntos de criptografia AES-GCM (AEAD) agora estão ativados,
- Os pacotes de criptografia MD5, 3DES, de exportação e ECDH de chave estática agora estão desativados,
- Os pacotes de criptografia de Forward Secrecy (ECDHE e DHE) são preferenciais.
Essas mudanças podem causar falhas na conectividade HTTPS ou TLS/SSL em um pequeno número de casos listados abaixo.
O ProviderInstaller de segurança do Google Play Services já oferece essas mudanças em todas as versões da plataforma Android, desde o Android 2.3.
O servidor não é compatível com nenhum dos pacotes de criptografia ativados
Por exemplo, um servidor pode aceitar apenas pacotes de criptografia 3DES ou MD5. A correção preferencial é melhorar a configuração do servidor para ativar pacotes de criptografia e protocolos mais fortes e modernos. O ideal é que o TLSv1.2 e o AES-GCM estejam ativados, e os conjuntos de criptografia de Forward Secrecy (ECDHE, DHE) estejam ativados e sejam preferenciais.
Uma alternativa é modificar o app para usar um SSLSocketFactory personalizado para se comunicar com o servidor. A fábrica precisa ser projetada para criar instâncias de SSLSocket que tenham alguns dos pacotes de criptografia exigidos pelo servidor ativados, além dos pacotes de criptografia padrão.
O app está fazendo suposições erradas sobre os conjuntos de criptografia usados para se conectar ao servidor
Por exemplo, alguns apps contêm um X509TrustManager personalizado que falha porque espera que o parâmetro authType seja RSA, mas encontra ECDHE_RSA ou DHE_RSA.
O servidor não é compatível com TLSv1.1, TLSv1.2 ou novas extensões TLS
Por exemplo, o handshake TLS/SSL com um servidor é rejeitado por engano ou interrompido. A correção preferencial é fazer upgrade do servidor para obedecer ao protocolo TLS/SSL. Isso fará com que o servidor negocie esses protocolos mais recentes ou negocie o TLSv1 ou protocolos mais antigos e ignore as extensões TLS que não entende. Em alguns casos, desativar o TLSv1.1 e o TLSv1.2 no servidor pode funcionar como uma medida temporária até que o software do servidor seja atualizado.
Uma alternativa é modificar o app para usar um SSLSocketFactory personalizado para se comunicar com o servidor. A fábrica precisa ser projetada para criar instâncias de SSLSocket com apenas os protocolos ativados que são compatíveis com o servidor.
Suporte para perfis gerenciados
Os administradores de dispositivos podem adicionar um perfil gerenciado a um dispositivo. Esse perfil pertence ao administrador, que tem controle sobre ele, mas deixa o perfil pessoal do usuário e o espaço de armazenamento sob o controle do usuário. Essa mudança pode afetar o comportamento do seu app atual das seguintes maneiras.
Como processar intents
Os administradores de dispositivos podem restringir o acesso a aplicativos do sistema no
perfil gerenciado. Nesse caso, se um app disparar uma intent do perfil gerenciado
que normalmente seria processada por esse aplicativo e não houver um
gerenciador adequado para a intent no perfil gerenciado,
ela vai causar uma exceção. Por exemplo, o
administrador do dispositivo pode impedir que os apps no perfil gerenciado acessem
o aplicativo de câmera do sistema. Se o app estiver em execução no perfil gerenciado
e chamar startActivityForResult() para MediaStore.ACTION_IMAGE_CAPTURE, e não houver nenhum app no perfil gerenciado
que possa processar a intent, isso resultará em uma ActivityNotFoundException.
Para evitar isso, verifique se há pelo menos um gerenciador para qualquer intent antes de acioná-la. Para verificar se há um gerenciador válido, chame Intent.resolveActivity(). Confira
um exemplo de como fazer isso em Tirar fotos
com facilidade: tirar uma foto com o app de câmera.
Compartilhar arquivos entre perfis
Cada perfil tem o próprio armazenamento de arquivos. Como um URI de arquivo se refere a um local específico no armazenamento de arquivos, isso significa que um URI de arquivo válido em um perfil não é válido no outro. Normalmente, isso não é um problema para um app, que geralmente acessa apenas os arquivos que cria. No entanto, se um app anexar um arquivo a uma intent, não será seguro anexar um URI de arquivo, já que, em algumas circunstâncias, a intent pode ser processada no outro perfil. Por exemplo, um administrador de dispositivos pode especificar que os eventos de captura de imagem precisam ser processados pelo app de câmera no perfil pessoal. Se a intent for acionada por um app no perfil gerenciado, a câmera precisará gravar a imagem em um local onde os apps do perfil gerenciado possam lê-la.
Para garantir a segurança, quando
você precisar anexar um arquivo a uma intent que possa passar de um perfil para o
outro, crie e use um URI de conteúdo para o arquivo. Para mais
informações sobre como compartilhar arquivos com URIs de conteúdo, consulte Como compartilhar arquivos.
Por exemplo, o administrador do dispositivo pode permitir que ACTION_IMAGE_CAPTURE seja
processado pela câmera no perfil pessoal. A EXTRA_OUTPUT da intent de disparo precisa conter um URI de conteúdo
especificando onde a foto será armazenada. O app de câmera pode gravar a
imagem no local especificado por esse URI, e o app que acionou a intent
pode ler esse arquivo, mesmo que esteja no outro perfil.
Suporte a widgets na tela de bloqueio removido
O Android 5.0 removeu a compatibilidade com widgets na tela de bloqueio, mas continua oferecendo suporte a widgets na tela inicial.