Permissão de execução para notificações

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.

Observação: os apps não precisam solicitar a permissão POST_NOTIFICATIONS para iniciar um serviço em primeiro plano, mas precisam incluir uma notificação, assim como em versões anteriores do Android.

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 sair da caixa de diálogo, ou seja, não selecionar permitir ou não permitir, o estado da permissão de notificação não vai 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. O app precisa aguardar para enviar notificações somente após você solicitar a nova permissão e receber a autorização do usuário.

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.

Observação: imagine que um app já havia sido instalado em um dispositivo com o 12L ou versões anteriores e que o usuário já havia concedido permissão de notificação para o app nesse dispositivo antigo, que agora está sendo descartado. Em um novo dispositivo com o Android 13 ou mais recente, o usuário restaura o app usando o recurso de backup e restauração.

Nesse caso, o sistema considera o app como já existente e, por isso, concede automaticamente a permissão para que ele continue enviando notificações.

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 vai receber avisos relacionados a serviços em primeiro plano no Gerenciador de tarefas, mas não na 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:

1. Declara a permissão MANAGE_OWN_CALLS.
2. Implementa a interface ConnectionService.
3. 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. Os conjuntos de comandos do Android Debug Bridge (adb) a seguir permitem simular as sequências mais comuns de escolhas de 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.

Figura 1. Fluxo de trabalho recomendado para solicitar a permissão de notificação, orientado pelas ações do usuário Só será necessário usar a tela do meio se 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.