Preparar o app para mudanças de comportamento no Wear OS 4

O Wear OS 4 é baseado no Android 13 (nível 33 da API), que é mais recente que a versão em que o Wear OS 3 se baseia, o Android 11 (nível 30 da API). Durante a preparação do seu app para usar o Wear OS 4, é preciso processar as mudanças de comportamento do sistema que entraram em vigor para todos os apps no Android 12 e no Android 13.

Você pode melhorar ainda mais a compatibilidade do app com essa versão do Wear OS direcionando-o ao Android 13 (nível 33 da API).

Mudanças nas permissões

As seguintes mudanças relacionadas às permissões têm mais probabilidade de afetar seu app para Wear OS em um dispositivo com o Wear OS 4.

Permissão de notificações

A opção "Permitir" é o primeiro botão na caixa de diálogo
Figura 1. Caixa de diálogo de permissões do sistema que solicita que o usuário permita que o app para Wear OS poste notificações. O usuário pode escolher entre Permitir e Não permitir.

Na maioria dos casos, o usuário precisa conceder uma permissão de execução de notificações para o app, inclusive para receber notificações de atividades em andamento.

Observação: a permissão de notificações não se aplica a notificações em ponte, bem como a vários casos de uso específicos que são isentos, como os relacionados a sessões de mídia.

Quando um usuário instala seu app em um dispositivo que executa o Wear OS 4, as notificações são desativadas por padrão. Antes de publicar uma notificação local ou iniciar uma atividade em andamento, chame areNotificationsEnabled() para conferir se o app tem permissão para postar notificações. Se esse método retornar true, o app poderá mostrar notificações. Se o app não tiver a permissão adequada, essas notificações vão falhar silenciosamente, sem que nenhuma exceção seja gerada durante a execução.

Quando você solicita a permissão POST_NOTIFICATIONS no app, a caixa de diálogo de permissões do sistema mostrada na Figura 1 aparece para o usuário.

Permissão de sensores corporais em segundo plano

Em um dispositivo com o Wear OS 4, o usuário precisa conceder permissão para que o app acesse informações de sensores corporais comuns, como a frequência cardíaca, em segundo plano.

Saiba mais no guia para solicitar acesso aos dados de sensores corporais em segundo plano.

Permissão de localização aproximada

Em um dispositivo com o Wear OS 4, o usuário pode solicitar que o app extraia apenas informações do local aproximado, mesmo quando o app pedir a permissão de execução ACCESS_FINE_LOCATION.

Confira se o app ainda consegue atender aos principais casos de uso, como mostrar um trajeto em execução, quando o usuário concede apenas o local aproximado. Principalmente ao usar os Recursos de saúde no Wear OS, é importante considerar os erros de posição.

Saiba mais sobre como o usuário pode conceder acesso apenas ao local aproximado.

Mudanças nos componentes e na navegação do app

As mudanças abaixo relacionadas aos componentes e à navegação do app têm maior probabilidade de afetar seu app para Wear OS em um dispositivo com o Wear OS 4.

Filtros de intent bloqueiam intents não correspondentes

Quando o app envia uma intent para um componente exportado de outro app direcionado ao Android 13 ou mais recente, essa intent só será entregue se corresponder a um elemento <intent-filter> no app de destino.

Aprenda a fazer a correspondência de intents e filtros de intents de outros apps.

Comportamento de atividades raiz da tela de início

Uma atividade da tela de início estará na raiz de uma tarefa quando declarar um filtro de intent que inclua ACTION_MAIN e CATEGORY_LAUNCHER.

Se o usuário sair desse tipo de atividade da tela de início para a tela anterior, o sistema não vai finalizar a atividade da tela de início. Em vez disso, ele colocará a atividade em segundo plano.

Saiba mais sobre essa mudança nas atividades raiz da tela de início e sobre o ciclo de vida da atividade.

O sistema faz várias mudanças na forma como os Links do app Android são verificados. Mais especificamente, o sistema aplica uma sintaxe de filtro de intent mais rigorosa para demonstrar que os URLs em um domínio precisam abrir o conteúdo diretamente no app. Essas mudanças melhoram a confiabilidade da experiência de links nos apps, oferecendo mais controle para desenvolvedores e usuários finais.

Para testar a confiabilidade das declarações, invoque a verificação de domínio manualmente.

A interface da janela de alertas do sistema foi removida

O Wear OS 4 remove a interface do sistema para conceder a permissão SYSTEM_ALERT_WINDOW. Essa interface está disponível em alguns dispositivos com o Wear OS 3 e versões anteriores.

Se você usar ACTION_MANAGE_OVERLAY_PERMISSION para direcionar os usuários a uma página de configurações, em que eles possam sobrepor o app a outros, atualize a lógica do app. Por exemplo, se você depende de janelas de alerta do sistema para mostrar mensagens importantes, use as notificações.

Mudanças no gerenciamento de dados e energia

As mudanças abaixo relacionadas ao gerenciamento de dados e energia têm maior probabilidade de afetar seu app para Wear OS em um dispositivo com o Wear OS 4.

Bucket restrito do App em espera

O sistema vai colocar o app no bucket "restrito" do App em espera se ele não for usado por um longo período ou se ele invocar um número excessivo de transmissões e vinculações.

Hibernação do app

Se o usuário não interagir com o app por alguns meses, o sistema vai colocá-lo em um estado de hibernação.

Backup e restauração

No Wear OS 4 e mais recentes, quando um dispositivo Wear OS específico oferece suporte ao backup na nuvem, o usuário pode fazer backup dos dados dele para transferi-los desse dispositivo a outro. Ele também pode restaurar dados da nuvem e transferi-los para outro dispositivo Wear OS.