Assurer la compatibilité avec la navigation par gestes

À partir d'Android 10 (niveau d'API 29), le système Android prend en charge la navigation entièrement basée sur les gestes. Les développeurs d'applications doivent effectuer deux actions pour s'assurer que leurs applications sont compatibles avec cette fonctionnalité :

  • Étendre le contenu de l'application d'un bord à l'autre.
  • Gérer les gestes d'application en conflit.

De plus, Android 13 (niveau d'API 33) introduit la prévisualisation du geste Retour pour les appareils Android tels que les téléphones, les grands écrans et les pliables. Cette fonctionnalité fait partie d'une version pluriannuelle. Les développeurs d'applications peuvent prendre des mesures pour s'assurer que leurs applications sont compatibles avec la prévisualisation du geste Retour.

Fournir du contenu d'application bord à bord

Pour profiter de l'espace supplémentaire à l'écran rendu disponible par la barre de navigation flottante, vous devez configurer certaines modifications dans votre application.

Pour en savoir plus, consultez Afficher le contenu bord à bord dans votre application.

Gérer les gestes d'application en conflit

Le modèle de navigation par gestes peut entrer en conflit avec les gestes précédemment utilisés par les développeurs d'applications. Vous devrez peut-être ajuster l'interface utilisateur de votre application en conséquence.

Conflits avec les gestes Retour

Le nouveau geste système pour revenir en arrière consiste à balayer l'écran vers le milieu, depuis le bord gauche ou droit. Cela peut interférer avec les éléments de navigation de l'application dans ces zones. Pour conserver la fonctionnalité des éléments situés sur les bords gauche et droit de l'écran, désactivez le geste Retour de manière sélective en indiquant au système les zones qui doivent recevoir une saisie tactile. Pour ce faire, transmettez un List<Rect> à l'API View.setSystemGestureExclusionRects() introduite dans Android 10. Cette méthode est également disponible dans ViewCompat à partir de androidx.core:core:1.1.0-dev01.

Exemple :

Kotlin

var exclusionRects = listOf(rect1, rect2, rect3)

fun onLayout(
        changedCanvas: Boolean, left: Int, top: Int, right: Int, bottom: Int) {
  // Update rect bounds and the exclusionRects list
  setSystemGestureExclusionRects(exclusionRects)
}

fun onDraw(canvas: Canvas) {
  // Update rect bounds and the exclusionRects list
  setSystemGestureExclusionRects(exclusionRects)
}

Java

List<Rect> exclusionRects;

public void onLayout(
        boolean changedCanvas, int left, int top, int right, int bottom) {
    // Update rect bounds and the exclusionRects list
    setSystemGestureExclusionRects(exclusionRects);
}

public void onDraw(Canvas canvas) {
    // Update rect bounds and the exclusionRects list
    setSystemGestureExclusionRects(exclusionRects);
}

Conflits avec les gestes d'accueil ou de changement rapide

Les nouveaux gestes système pour l'écran d'accueil et le changement rapide impliquent tous deux des balayages en bas de l'écran, dans l'espace précédemment occupé par la barre de navigation. Les applications ne peuvent pas désactiver ces gestes comme elles le peuvent avec le geste Retour.

Pour atténuer ce problème, Android 10 introduit l'API WindowInsets.getMandatorySystemGestureInsets(), qui informe les applications des seuils de reconnaissance tactile.

Jeux et autres applications non basées sur les vues

Les jeux et autres applications qui n'ont pas de hiérarchie des vues nécessitent souvent que l'utilisateur balaie l'écran à proximité des zones de gestes système. Dans ce cas, les jeux peuvent utiliser Window.setSystemGestureExclusionRects() pour exclure les zones qui chevauchent celles réservées aux gestes système. Les jeux doivent s'assurer de n'exclure ces zones que lorsque cela est nécessaire, par exemple pendant le jeu.

Si un jeu nécessite que l'utilisateur balaie l'écran à proximité de la zone de gestes d'accueil, l'application peut demander à être affichée en mode immersif. Cela désactive les gestes système pendant que l'utilisateur interagit avec le jeu, mais lui permet de les réactiver en balayant l'écran vers le haut depuis le bas.

Mettre à jour votre appli pour prendre en charge la prévisualisation du geste Retour

Android 13 (niveau d'API 33) introduit la prévisualisation du geste Retour pour les appareils Android tels que les téléphones, les grands écrans et les pliables. La prévisualisation du geste Retour fait partie d'une version pluriannuelle. Lorsqu'elle est complètement implémentée, elle permet aux utilisateurs de prévisualiser la destination ou un autre résultat d'un geste Retour avant de l'exécuter complètement. Ils peuvent ainsi décider de continuer ou de rester dans l'affichage actuel.

Pour en savoir plus, consultez Ajouter la prise en charge de la prévisualisation du geste Retour.

Ressources supplémentaires

Pour en savoir plus sur la navigation par gestes, consultez les ressources suivantes :

Articles de blog

Vidéos