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 tem várias versões uma versão mais recente do que a versão em que o Wear OS 3 se baseia, o Android 11 (nível 30 da API); Portanto, ao preparar seu app para Wear OS 4, é preciso processar as mudanças de comportamento do sistema que entram em vigor para todos os apps no Android 12 e Android 13:

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

Mudanças nas permissões

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

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 com o Wear OS 4 ou mais recente, o as notificações do seu app ficam desativadas por padrão. Antes de postar uma notificação local ou iniciar uma atividade em andamento, verifique se o app tem permissão para publicar as notificações chamando areNotificationsEnabled(). Se esse método retornar true, seu app poderá mostrar notificações. Caso seu app não tenha a permissão adequada, essas notificações falham silenciosamente sem qualquer tempo de execução exceções sendo geradas.

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 ou mais recente, os usuários precisam conceder a permissão do app para obter informações de sensores corporais comuns, como frequência cardíaca, no plano de fundo.

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 ou mais recente, os usuários podem solicitar que seu app recupere apenas informações de localização aproximada, mesmo quando o aplicativo solicitar o 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 seguintes mudanças relacionadas aos componentes do app e à navegação são mais prováveis afetar o app para Wear OS em um dispositivo com o Wear OS 4 ou mais recente.

Filtros de intent bloqueiam intents não correspondentes

Quando seu app envia uma intent para um componente exportado de outro app que for destinada ao Android 13 ou versões mais recentes, essa intent só vai ser entregue se corresponder um elemento <intent-filter> no app receptor.

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 SYSTEM_ALERT_WINDOW. permissão. 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 seguintes mudanças relacionadas ao gerenciamento de dados e energia são mais prováveis afetar o 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

A partir do Wear OS 4, se um dispositivo Wear OS específico oferecer suporte ao backup na nuvem, os usuários pode fazer backup dos próprios dados na nuvem para transferi-los para fora desse dispositivo; e restaurar dados da nuvem e transferi-los a um novo dispositivo Wear OS.