O Android 13 (API de nível 33) e versões mais recentes oferece têm suporte para uma
permissão de execução para enviar
notificações não isentas, incluindo serviços em primeiro plano (FGS),
em um app:
POST_NOTIFICATIONS
.
Essa mudança ajuda os usuários a se concentrarem nas notificações que eles consideram mais
importantes.
Recomendamos que você destine o app ao Android 13 ou mais recente o quanto antes para fazer uso do maior controle e da maior flexibilidade proporcionados por esse recurso. Se o app continuar a ser destinado ao 12L (API de nível 32) ou versões anteriores, você não vai poder solicitar permissões no contexto de uso das funcionalidades do app.
Declarar a permissão
Para solicitar a nova permissão de notificações no app, é necessário atualizá-lo para que ele seja destinado ao Android 13 e seguir um processo semelhante ao de solicitação de outras permissões de execução, conforme apresentado nas seções abaixo.
O snippet de código abaixo mostra a permissão que precisa ser declarada no arquivo de manifesto do app:
<manifest ...> <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/> <application ...> ... </application> </manifest>
O uso dos recursos do app depende da escolha do usuário na caixa de diálogo de permissões
Nessa caixa de diálogo, o usuário tem estas opções:
- Selecionar permitir
- Selecionar não permitir
- Deslizar para sair da caixa de diálogo sem pressionar nenhum dos botões
As seções abaixo descrevem como o app se comporta de acordo com a ação realizada pelo usuário.
O usuário seleciona "Permitir"
Se o usuário selecionar a opção permitir, o app vai poder fazer o seguinte:
- Enviar notificações. Todos os canais de notificação são permitidos.
- Enviar notificações relacionadas a serviços em primeiro plano . Essas notificações são exibidas na gaveta de notificações.
O usuário seleciona "Não permitir"
Se o usuário selecionar a opção não permitir, o app não vai poder enviar notificações, a menos que esteja qualificado para uma isenção. Todos os canais de notificação ficam bloqueados, exceto alguns papéis específicos. Esse comportamento é semelhante ao que ocorre quando o usuário desativa manualmente todas as notificações do app nas configurações do sistema.
Atenção: caso o app seja destinado ao Android 12L ou versões anteriores, e o usuário toque em Não permitir, mesmo que apenas uma vez, a solicitação não vai ser exibida novamente até que uma das seguintes situações ocorra:
- O usuário desinstale e reinstale o app.
- Você atualize o app para o Android 13 ou versões mais recentes.
O usuário desliza para sair da caixa de diálogo
Se o usuário deslizar para fora da caixa de diálogo, ou seja, não selecionar nenhuma allow ou don't allow: o estado da permissão de notificação não mudar.
Efeitos em apps recém-instalados
Se um usuário instalar o app em um dispositivo com o Android 13 ou versões mais recentes, as notificações do app vão ser desativadas por padrão. Seu app precisa aguardar para enviar notificações até que você solicite a nova permissão e o usuário concede essa permissão ao app.
O momento em que a caixa de diálogo de permissões é exibida depende da versão do SDK de destino do app:
- Se o app for destinado ao Android 13 ou a versões mais recentes, ele vai ter controle total sobre o momento em que a caixa de diálogo de permissão é exibida. Use essa oportunidade para explicar por que o app precisa dessa permissão e pedir que o usuário a conceda.
- Caso o app seja destinado ao 12L (API de nível 32) ou versões anteriores, o sistema vai exibir a caixa de diálogo de permissão quando o app for iniciado pela primeira vez após você criar um canal de notificação ou quando o app iniciar uma atividade e criar o primeiro canal de notificação. Isso geralmente ocorre na inicialização do app.
Efeitos nas atualizações de apps existentes
Para minimizar as interrupções associadas à permissão de notificações, o sistema concede automaticamente essa permissão a todos os apps qualificados quando o usuário atualiza para o Android 13 ou mais recente. Em outras palavras, os apps podem continuar a enviar notificações para os usuários, e a solicitação de permissão de execução não será exibida.
Qualificação para concessão de permissão prévia
Para que o app seja qualificado para receber uma permissão prévia automaticamente, é necessário que ele tenha um canal de notificação existente e que o usuário não desative explicitamente as notificações do app em um dispositivo com o 12L ou versões anteriores.
Caso o usuário tenha desativado as notificações do app em um dispositivo com o 12L ou versões anteriores, essa configuração vai permanecer válida quando o dispositivo for atualizado para o Android 13 ou versões mais recentes.
Isenções
Esta seção apresenta as notificações e os apps em que não ocorre nenhuma mudança de comportamento devido à permissão de notificações. No Android 13 (nível 33 da API) ou versões mais recentes, se o usuário negar a permissão de notificação, ele ainda verá os avisos relacionados para serviços em primeiro plano Gerenciador de tarefas mas não consegue vê-los gaveta de notificações.
Sessões de mídia
As notificações relacionadas a sessões de mídia estão isentas dessa mudança de comportamento.
Apps configurados para gerenciar chamadas telefônicas
Se o app for configurado para gerenciar chamadas telefônicas, não é
necessário ter a permissão POST_NOTIFICATIONS
para que ele envie
notificações com o
estilo
Notification.CallStyle
.
O sistema considera que o app foi configurado para gerenciar chamadas se ele:
- Declara a
permissão
MANAGE_OWN_CALLS
. - Implementa a
interface
ConnectionService
. - Chama
registerPhoneAccount()
para se cadastrar com a operadora de celular do dispositivo.
Testar o app
É possível avaliar como a permissão de notificações afeta o app quando ele é usado pela primeira vez em um dispositivo com Android 13 ou mais recente. A seguindo conjuntos de comandos do Android Debug Bridge (adb) permitem você simular as sequências mais comuns de escolhas do usuário e upgrades de dispositivos sem precisar redefinir o dispositivo de teste:
O app foi instalado recentemente em um dispositivo com o Android 13 ou mais recente:
adb shell pm revoke PACKAGE_NAME android.permission.POST_NOTIFICATIONS
adb shell pm clear-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-set
adb shell pm clear-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-fixed
O usuário mantém as notificações ativadas quando o app é instalado em um dispositivo com o 12L ou versões anteriores e, em seguida, o dispositivo é atualizado para o Android 13 ou mais recente:
adb shell pm grant PACKAGE_NAME android.permission.POST_NOTIFICATIONS
adb shell pm set-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-set
adb shell pm clear-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-fixed
O usuário desativa manualmente as notificações quando o app é instalado em um dispositivo com o 12L ou versões anteriores e, em seguida, o dispositivo é atualizado para o Android 13 ou mais recente:
adb shell pm revoke PACKAGE_NAME android.permission.POST_NOTIFICATIONS
adb shell pm set-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-set
adb shell pm clear-permission-flags PACKAGE_NAME \ android.permission.POST_NOTIFICATIONS user-fixed
Práticas recomendadas
Esta seção descreve várias maneiras de usar a nova permissão de notificação de forma mais eficaz no app.
Atualizar a versão do SDK de destino do app
Para oferecer mais flexibilidade ao app com relação ao momento em que a caixa de diálogo de permissões vai ser exibida, atualize o app para que ele seja destinado ao Android 13 ou mais recente.
Esperar para exibir a solicitação de permissão de notificação
Antes de solicitar permissões aos usuários, permita que eles conheçam melhor o app.
Novos usuários podem querer experimentar o app e entender por conta própria os benefícios de cada solicitação de notificação. É possível acionar uma solicitação de permissões com base em uma ação do usuário. A lista abaixo mostra vários exemplos de bons momentos para exibir a solicitação de permissão de notificação:
- O usuário toca no ícone de "sino de notificações" de alerta.
- O usuário decide seguir uma nova conta em uma mídia social.
- O usuário faz um pedido de entrega de comida.
A Figura 1 apresenta um fluxo de trabalho recomendado para solicitar a permissão de
notificação. A menos que
shouldShowRequestPermissionRationale()
retorne true
, o app não precisa exibir a tela do meio, com o texto
"Receber notificação".
Como alternativa, é possível definir uma solicitação que será exibida depois de um tempo de uso, para que o usuário possa conhecer o app melhor. Por exemplo, você pode aguardar até a terceira ou quarta vez que o usuário iniciar o app.
shouldShowRequestPermissionRationale()
retornar true
.
Solicitar a permissão no contexto
Solicite permissões de notificação no contexto correto de modo que fique explicitamente claro para qual função as notificações vão ser usadas e por que o usuário precisaria as ativar. Por exemplo, um app de e-mails pode incluir opções para enviar notificações a cada novo e-mail ou apenas de e-mails em que o usuário é o único destinatário.
Use essa oportunidade para apresentar suas intenções de forma transparente. Assim, os usuários vão estar mais propensos a conceder a permissão de notificação ao app.
Conferir se o app pode enviar notificações
Antes de enviar uma notificação, confirme se o usuário ativou
as notificações para o app. Para fazer isso, chame
areNotificationsEnabled()
.
Usar a permissão de forma responsável
Depois de receber a permissão para enviar notificações, use-a de forma responsável. Os usuários vão ver o número de notificações diárias enviadas pelo app e vão poder revogar a permissão a qualquer momento.