Como nas versões anteriores, o Android 17 inclui mudanças de comportamento que podem afetar seu app. As mudanças de comportamento a seguir se aplicam exclusivamente a apps que segmentam o Android 17 ou versões mais recentes. Se o app for direcionado ao Android 17 ou a versões mais recentes, faça modificações para oferecer suporte a esses comportamentos, quando aplicável.
Consulte também a lista de mudanças de comportamento que afetam todos os apps
executados no Android 17, independente da targetSdkVersion do seu app.
Principal recurso
O Android 17 inclui as seguintes mudanças que modificam ou ampliam vários recursos principais do sistema Android.
Nova implementação sem bloqueio de MessageQueue
A partir do Android 17, os apps destinados ao Android 17
ou versões mais recentes recebem uma nova implementação sem bloqueio de
android.os.MessageQueue. A nova implementação melhora a performance e reduz os frames perdidos, mas pode causar falhas em clientes que refletem em campos e métodos particulares de MessageQueue.
Para mais informações, incluindo estratégias de mitigação, consulte Orientação sobre a mudança de comportamento do MessageQueue.
Os campos finais estáticos não podem mais ser modificados
Os apps executados no Android 17 ou em versões mais recentes que têm como destino
o Android 17 ou versões mais recentes não podem mudar os campos static final. Se
um app tentar mudar um campo static final usando reflexão, isso vai
causar um IllegalAccessException. Tentar modificar um desses campos
usando APIs JNI (como SetStaticLongField()) vai causar falha no app.
Acessibilidade
O Android 17 faz as seguintes mudanças para melhorar a acessibilidade.
Suporte de acessibilidade para digitação complexa no teclado físico do IME
Esse recurso introduz novas APIs AccessibilityEvent e TextAttribute
para melhorar o feedback falado do leitor de tela para entrada de texto em idiomas CJKV. Os apps de IME CJKV
agora podem sinalizar se um candidato à conversão de texto foi selecionado durante
a composição de texto. Os apps com campos de edição podem especificar tipos de mudança de texto ao
enviar eventos de acessibilidade de texto alterado.
Por exemplo, os apps podem especificar que uma mudança de texto ocorreu durante a composição
de texto ou que uma mudança de texto resultou de uma confirmação.
Isso permite que serviços de acessibilidade, como leitores de tela, ofereçam feedback mais preciso com base na natureza da modificação do texto.
Adoção de apps
Apps de IME:ao definir a composição de texto em campos de edição, os IMEs podem usar
TextAttribute.Builder.setTextSuggestionSelected()para indicar se um candidato a conversão específico foi selecionado.Apps com "Editar campos":os apps que mantêm um
InputConnectionpersonalizado podem recuperar dados de seleção de candidatos chamandoTextAttribute.isTextSuggestionSelected(). Esses apps precisam chamarAccessibilityEvent.setTextChangeTypes()ao despachar eventosTYPE_VIEW_TEXT_CHANGED. Apps direcionados ao Android 17 que usam oTextViewpadrão terão esse recurso ativado por padrão. Ou seja,TextViewvai processar a recuperação de dados do IME e definir tipos de mudança de texto ao enviar eventos para serviços de acessibilidade.Serviços de acessibilidade:os serviços de acessibilidade que processam eventos
TYPE_VIEW_TEXT_CHANGEDpodem chamarAccessibilityEvent.getTextChangeTypes()para identificar a natureza da modificação e ajustar as estratégias de feedback de acordo.
Privacidade
O Android 17 inclui as seguintes mudanças para melhorar a privacidade do usuário.
Permissão de rede local necessária para apps destinados ao Android 17
| Disponível para teste? (build obrigatório) | Sim (Android 17 ou mais recente) |
|---|---|
Requer a mudança de targetSDKVersion? (nível da API) |
Sim (nível da API "CINNAMON_BUN"). Consulte a documentação do atributo de manifesto para mais informações sobre esse valor. |
O Android 17 apresenta a permissão de execução ACCESS_LOCAL_NETWORK
para proteger os usuários contra acesso não autorizado à rede local. Como isso se enquadra no grupo de permissões NEARBY_DEVICES atual, os usuários que já concederam outras permissões NEARBY_DEVICES não vão receber outra solicitação. Esse novo requisito impede que apps mal-intencionados explorem o acesso irrestrito à rede local para rastreamento de usuários e técnicas de impressão digital encobertos. Ao declarar e solicitar
essa permissão, seu app pode descobrir e se conectar a dispositivos na rede
local (LAN), como dispositivos de casa inteligente ou receptores de transmissão.
Os apps destinados ao Android 17 ou versões mais recentes agora têm dois caminhos para manter a comunicação com dispositivos de rede local: adotar seletores de dispositivos que preservam a privacidade mediados pelo sistema para pular a solicitação de permissão ou solicitar explicitamente essa nova permissão durante o tempo de execução para manter a comunicação da rede local.
Para mais informações, consulte a documentação sobre permissão de rede local.
Segurança
O Android 17 faz as seguintes melhorias na segurança de dispositivos e apps.
Segurança de atividade
No Android 17, a plataforma continua a transição para uma arquitetura "segura por padrão", introduzindo um conjunto de melhorias projetadas para reduzir explorações de alta gravidade, como phishing, sequestro de interação e ataques de confusão de representantes. Essa atualização exige que os desenvolvedores ativem explicitamente os novos padrões de segurança para manter a compatibilidade do app e a proteção do usuário.
Os principais impactos para os desenvolvedores incluem:
- Reforço da BAL e melhoria da ativação:estamos refinando as restrições de inicialização de atividades em segundo plano (BAL, na sigla em inglês) ao estender as proteções para
IntentSender. Os desenvolvedores precisam migrar da constante legadaMODE_BACKGROUND_ACTIVITY_START_ALLOWED. Em vez disso, adote controles granulares, comoMODE_BACKGROUND_ACTIVITY_START_ALLOW_IF_VISIBLE, que restringe inícios de atividade a cenários em que o app de chamada está visível, reduzindo significativamente a superfície de ataque. - Ferramentas de adoção:os desenvolvedores precisam usar o modo estrito e verificações de lint atualizadas para identificar padrões legados e garantir a preparação para requisitos futuros do SDK de destino.
Ativar a CT por padrão
Se um app for direcionado ao Android 17 ou versões mais recentes, a transparência de certificado (CT) será ativada por padrão. No Android 16, a CT está disponível, mas os apps precisam ativar.
DCL nativo mais seguro: C
Se o app for direcionado ao Android 17 ou versões mais recentes, a proteção de carregamento dinâmico de código (DCL) mais seguro introduzida no Android 14 para arquivos DEX e JAR agora se estenderá às bibliotecas nativas.
Todos os arquivos nativos carregados usando System.load() precisam ser marcados como somente leitura.
Caso contrário, o sistema vai gerar UnsatisfiedLinkError.
Recomendamos que os apps evitem carregar código dinamicamente sempre que possível, porque isso aumenta muito o risco de comprometimento do app por injeção ou adulteração de código.
Formatos de dispositivos
O Android 17 inclui as seguintes mudanças para melhorar a experiência do usuário em vários tamanhos de dispositivos e formatos.
Mudanças na API Platform para ignorar restrições de orientação, redimensionamento e proporção em telas grandes (sw>=600 dp)
Introduzimos mudanças na API Platform no Android 16 para ignorar restrições de orientação, proporção e redimensionamento em telas grandes (sw >= 600 dp) para apps destinados ao nível 36 da API ou mais recente. Os desenvolvedores têm a opção de desativar essas mudanças com o SDK 36, mas essa desativação não estará mais disponível para apps destinados ao Android 17 ou mais recente.
Para mais informações, consulte Restrições de orientação e redimensionamento são ignoradas.