Autorisation d'exécution des notifications

Android 13 (niveau d'API 33) et versions ultérieures sont compatibles avec une autorisation d'exécution pour l'envoi de notifications non exemptées (y compris les services de premier plan) depuis une application : POST_NOTIFICATIONS. Cette modification permet aux utilisateurs de se concentrer sur les notifications qui sont les plus importantes pour eux.

Nous vous recommandons vivement de cibler Android 13 ou version ultérieure dès que possible pour bénéficier du contrôle et de la flexibilité supplémentaires de cette fonctionnalité. Si vous continuez à cibler la version 12L (niveau d'API 32) ou une version antérieure, vous perdrez en flexibilité pour demander l'autorisation dans le contexte des fonctionnalités de votre application.

Déclarer l'autorisation

Pour demander la nouvelle autorisation de notification depuis votre application, mettez à jour votre application pour cibler Android 13 et suivez une procédure similaire à celle utilisée pour demander d'autres autorisations d'exécution, comme indiqué dans les sections suivantes.

L'autorisation que vous devez déclarer dans le fichier manifeste de votre application apparaît dans l'extrait de code suivant :

<manifest ...>
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
    <application ...>
        ...
    </application>
</manifest>

Les fonctionnalités de l'application dépendent du choix de l'utilisateur dans la boîte de dialogue des autorisations

Dans cette boîte de dialogue, les utilisateurs peuvent effectuer les actions suivantes :

Les sections suivantes décrivent le comportement de votre application en fonction de l'action effectuée par l'utilisateur.

L'utilisateur sélectionne "Autoriser".

Si l'utilisateur sélectionne l'option Autoriser, votre application peut effectuer les opérations suivantes :

L'utilisateur sélectionne "Ne pas autoriser".

Si l'utilisateur sélectionne l'option Ne pas autoriser, votre application ne peut pas envoyer de notifications, sauf si elle est exemptée. Tous les canaux de notification sont bloqués, à l'exception de quelques rôles spécifiques. Ce comportement est semblable à celui qui se produit lorsque l'utilisateur désactive manuellement toutes les notifications pour votre application dans les paramètres système.

Attention : Si votre application cible la version 12L ou une version antérieure et que l'utilisateur appuie sur Ne pas autoriser, même une seule fois, il ne sera plus invité à autoriser l'accès tant que l'un des événements suivants ne se produira pas :

  • L'utilisateur désinstalle votre application, puis la réinstalle.
  • Vous mettez à jour votre application pour qu'elle cible Android 13 ou version ultérieure.

L'utilisateur fait glisser le doigt pour fermer la boîte de dialogue

Si l'utilisateur fait glisser la boîte de dialogue pour la fermer (c'est-à-dire qu'il ne sélectionne ni Autoriser ni Ne pas autoriser), l'état de l'autorisation de notification ne change pas.

Effets sur les applications nouvellement installées

Si un utilisateur installe votre application sur un appareil exécutant Android 13 ou une version ultérieure, ses notifications sont désactivées par défaut. Votre application doit attendre d'avoir demandé la nouvelle autorisation et que l'utilisateur l'ait accordée avant d'envoyer des notifications.

Le moment où la boîte de dialogue des autorisations s'affiche dépend de la version du SDK cible de votre application :

  • Si votre application cible Android 13 ou une version ultérieure, elle contrôle entièrement le moment où la boîte de dialogue d'autorisation s'affiche. Profitez-en pour expliquer aux utilisateurs pourquoi l'application a besoin de cette autorisation et les encourager à l'accorder.
  • Si votre application cible 12L (niveau d'API 32) ou une version antérieure, le système affiche la boîte de dialogue d'autorisation la première fois que votre application démarre une activité après la création d'un canal de notification, ou lorsque votre application démarre une activité, puis crée son premier canal de notification. Cela se produit généralement au démarrage de l'application.

Effets sur les mises à jour des applications existantes

Pour minimiser les perturbations associées à l'autorisation de notification, le système accorde automatiquement cette autorisation à toutes les applications éligibles lorsque l'utilisateur met à niveau son appareil vers Android 13 ou une version ultérieure. En d'autres termes, ces applications peuvent continuer à envoyer des notifications aux utilisateurs, et les utilisateurs ne voient pas d'invite d'autorisation d'exécution.

Éligibilité à l'autorisation préalable

Pour que votre application soit éligible à une pré-autorisation automatique, elle doit disposer d'un canal de notification existant et ne pas avoir de notifications explicitement désactivées par l'utilisateur sur un appareil exécutant 12L ou une version antérieure.

Si l'utilisateur a désactivé les notifications pour votre application sur un appareil équipé d'Android 12L ou version antérieure, ce refus persiste lorsque l'appareil passe à Android 13 ou version ultérieure.

Exceptions

Cette section contient l'ensemble des notifications et des applications exemptées du changement de comportement de l'autorisation de notification. Sur Android 13 (niveau d'API 33) ou version ultérieure, si l'utilisateur refuse l'autorisation de notification, il voit toujours les notifications liées aux services de premier plan dans le Gestionnaire de tâches, mais pas dans le panneau de notifications.

Sessions multimédias

Les notifications liées aux sessions multimédias sont exemptées de ce changement de comportement.

Applications configurées pour gérer elles-mêmes les appels téléphoniques

Si votre application se configure pour gérer elle-même les appels téléphoniques, vous n'avez pas besoin de l'autorisation POST_NOTIFICATIONS pour qu'elle envoie des notifications qui utilisent le style de notification Notification.CallStyle.

Le système considère que votre application s'est configurée pour gérer elle-même les appels téléphoniques si elle effectue chacune des opérations suivantes :

  1. Déclare l'autorisation MANAGE_OWN_CALLS
  2. Implémente l'interface ConnectionService.
  3. S'enregistre auprès de l'opérateur télécom de l'appareil en appelant registerPhoneAccount().

Tester votre application

Vous pouvez évaluer l'impact de l'autorisation de notification sur votre application lorsqu'elle est utilisée pour la première fois sur un appareil exécutant Android 13 ou version ultérieure. Les ensembles de commandes Android Debug Bridge (ADB) suivants vous permettent de simuler les séquences les plus courantes de choix des utilisateurs et de mises à niveau des appareils sans avoir à réinitialiser votre appareil de test :

  • L'application est nouvellement installée sur un appareil équipé d'Android 13 ou version ultérieure :

    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
  • L'utilisateur conserve les notifications activées lorsque l'application est installée sur un appareil exécutant 12L ou une version antérieure, puis que l'appareil est mis à niveau vers Android 13 ou une version ultérieure :

    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
  • L'utilisateur désactive manuellement les notifications lorsque l'application est installée sur un appareil exécutant 12L ou une version antérieure, puis l'appareil passe à Android 13 ou version ultérieure :

    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

Bonnes pratiques

Cette section décrit plusieurs façons d'utiliser la nouvelle autorisation de notification de la manière la plus efficace dans votre application.

Mettre à jour la version du SDK cible de votre application

Pour que votre application ait plus de flexibilité quant au moment où la boîte de dialogue d'autorisation s'affiche, mettez-la à jour pour qu'elle cible Android 13 ou une version ultérieure.

Attendre avant d'afficher l'invite d'autorisation pour les notifications

Avant de demander aux utilisateurs d'accorder des autorisations, laissez-les se familiariser avec votre application.

Les nouveaux utilisateurs peuvent explorer l'application et constater par eux-mêmes les avantages de chaque demande de notification. Vous pouvez déclencher une invite d'autorisation à partir d'une action de l'utilisateur. La liste suivante présente plusieurs exemples de situations où il est judicieux d'afficher l'invite d'autorisation des notifications :

  • L'utilisateur appuie sur le bouton en forme de cloche d'alerte.
  • L'utilisateur choisit de suivre le compte de réseau social d'une personne.
  • L'utilisateur envoie une commande de livraison de nourriture.

La figure 1 illustre un workflow recommandé pour demander l'autorisation d'envoyer des notifications. Sauf si shouldShowRequestPermissionRationale() renvoie true, votre application n'a pas besoin d'afficher l'écran intermédiaire, celui qui contient le texte "Recevez des notifications !".

Vous pouvez également définir une requête qui s'affiche après que les utilisateurs ont eu l'occasion de se familiariser avec votre application. Par exemple, vous pouvez attendre la troisième ou quatrième fois que l'utilisateur lance votre application.

Une fois l&#39;utilisateur connecté, il est invité à recevoir des notifications sur les mises à jour de voyage. Une fois que l&#39;utilisateur a appuyé sur le bouton &quot;J&#39;ai compris&quot;, l&#39;application demande la nouvelle autorisation, ce qui provoque l&#39;affichage de la boîte de dialogue système.
Figure 1. Workflow recommandé, axé sur l'utilisateur, pour demander l'autorisation d'envoyer des notifications. L'écran intermédiaire n'est nécessaire que si shouldShowRequestPermissionRationale() renvoie true.

Demander l'autorisation en contexte

Lorsque vous demandez des autorisations de notification dans votre application, faites-le dans le bon contexte, afin que l'objectif des notifications et la raison pour laquelle l'utilisateur doit les activer soient clairement indiqués. Par exemple, une application de messagerie peut inclure des options permettant d'envoyer des notifications pour chaque nouvel e-mail ou uniquement pour les e-mails dont l'utilisateur est le seul destinataire.

Profitez-en pour expliquer clairement vos intentions. Les utilisateurs seront plus susceptibles d'accorder l'autorisation de notification à votre application.

Vérifier si votre application peut envoyer des notifications

Avant que votre application envoie une notification, vérifiez si l'utilisateur a activé les notifications pour votre application en appelant areNotificationsEnabled().

Utiliser l'autorisation de manière responsable

Une fois que vous avez obtenu l'autorisation d'envoyer des notifications, n'oubliez pas d'utiliser cette autorisation de manière responsable. Les utilisateurs peuvent voir le nombre de notifications quotidiennes envoyées par votre application et révoquer l'autorisation à tout moment.