Cette page décrit les bonnes pratiques à suivre pour interagir avec la carte de navigation dans votre application.
Utilisez SupportNavigationFragment à la place de NavigationView, dans la mesure du possible.
SupportNavigationFragment est un wrapper qui permet de gérer facilement les rappels de cycle de vie NavigationView. Vous n'avez donc pas besoin de gérer ces rappels vous-même. Cette méthode est moins sujette aux erreurs et est la méthode privilégiée pour utiliser Navigation dans votre application. Lorsque vous utilisez SupportNavigationFragment, veillez à ne pas appeler les événements de cycle de vie NavigationView.
Si vous utilisez NavigationView, utilisez un ordre strict lors de l'appel des méthodes de cycle de vie.
NavigationView héberge la carte de navigation et suit de près les événements de cycle de vie en tant qu'activités et fragments Android, en effectuant des actions spécifiques lorsque ces événements de cycle de vie sont appelés. NavigationView exécute plusieurs initialisations sur NavigationView#onCreate et NavigationView#onStart, ainsi que des nettoyages sur NavigationView#onStop et NavigationView#onDestroy, ainsi que lorsque d'autres événements de cycle de vie sont traités.
Les méthodes de cycle de vie NavigationView ont la même signification que pour les activités ou les fragments Android. Par exemple, onCreate() de NavigationView se traduit approximativement par des rappels de cycle de vie de l'activité ou du fragment Android, et doit être appelé par eux. Étant donné que les rappels de cycle de vie NavigationView sont basés sur les rappels de cycle de vie Android et qu'ils sont appelés dans le même ordre, un ordre strict de ces méthodes NavigationView est requis. Sinon, vous risquez de rencontrer des fuites de mémoire, des erreurs d'interface utilisateur, une mise à jour de l'emplacement et d'autres problèmes.
Pour en savoir plus sur le cycle de vie des activités Android, consultez la section Concepts de cycle de vie des activités dans la documentation destinée aux développeurs Android.
Le tableau suivant indique quand d'autres méthodes de cycle de vie doivent être appelées, après les méthodes de cycle de vie spécifiées:
| Méthode de cycle de vie | Invoqué où dans le cycle de vie de l'activité | Appelée après quelle méthode de cycle de vie |
|---|---|---|
onConfigurationChanged()
|
Appelé lorsque l'UI est au premier plan et que la configuration change. | Toujours après onStart()
|
onTrimMemory()
|
Appelé lorsqu'une activité est en arrière-plan. | Toujours après onPause()
|
onSaveInstance()
|
Appelé avant la destruction d'une activité. | Toujours après onStop()
|
N'appelez pas ces méthodes de cycle de vie plusieurs fois sans appeler d'abord la méthode de fermeture correspondante. En outre, gardez à l'esprit que si certains de ces rappels de cycle de vie Android sont gérés par l'application elle-même et que le NavigationView est ajouté au fragment après la création ou le démarrage, l'application doit appeler les méthodes spécifiques elles-mêmes dans l'ordre approprié afin d'initialiser correctement le SDK Navigation.
Pour obtenir des conseils supplémentaires sur l'utilisation de ces méthodes, consultez l'application de démonstration du SDK Navigation.
Si vous utilisez NavigationView, appelez les événements de cycle de vie à partir de l'activité ou du fragment, mais pas les deux.
Pour conserver l'ordre strict des méthodes de cycle de vie, appelez ces événements à partir des rappels de cycle de vie de l'activité ou du fragment, qui les reçoivent dans l'ordre. Cette approche garantit que les applications n'ont pas besoin de se coordonner entre les fragments et les activités, et qu'elles ne provoquent pas d'appels en double.