Bonnes pratiques concernant les interactions avec la carte de navigation

Cette page décrit les bonnes pratiques à suivre pour interagir avec la carte de navigation dans votre application.

Utilisez NavigationFragment à la place de NavigationView, dans la mesure du possible.

NavigationFragment encapsule NavigationView et gère automatiquement ses rappels de cycle de vie. Vous n'avez donc pas besoin de les gérer vous-même. Cette approche est moins sujette aux erreurs et constitue la méthode recommandée pour utiliser la navigation dans votre application. Lorsque vous utilisez NavigationFragment, n'appelez pas directement les événements de cycle de vie NavigationView.

Si vous utilisez NavigationView, respectez un ordre strict lorsque vous appelez 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, et 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 ceux-ci. Étant donné que les rappels de cycle de vie NavigationView sont basés sur les rappels de cycle de vie Android et 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, des problèmes de mise à jour de la position et d'autres problèmes.

Pour en savoir plus sur le cycle de vie d'une activité Android, consultez la section Concepts du cycle de vie d'une activité dans la documentation pour les 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 :

N'appelez pas ces méthodes de cycle de vie plusieurs fois sans appeler d'abord la méthode de fermeture correspondante. De plus, n'oubliez pas 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 sa création ou son démarrage, l'application doit appeler les méthodes spécifiques dans l'ordre approprié pour initialiser correctement le SDK Navigation.

Pour en savoir plus 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 des 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 reçoivent ces événements dans l'ordre. Cette approche garantit que les applications n'ont pas besoin de coordonner les fragments et les activités, ce qui évite les appels en double.

Mise à jour de SupportNavigationFragment vers NavigationFragment

À partir de la version 8.0.0 du SDK Navigation, NavigationFragment remplace l'élément SupportNavigationFragment obsolète en tant que conteneur de fragments standard pour la navigation détaillée et l'affichage de la carte.

NavigationFragment maintient une parité d'API complète avec SupportNavigationFragment. Pour mettre à jour votre application, remplacez SupportNavigationFragment par NavigationFragment dans vos fichiers de mise en page XML et vos importations de code source. Toutes les signatures de méthode et les appels getSupportFragmentManager() restent identiques.

Mettre à jour le fichier XML de mise en page

Remplacez SupportNavigationFragment par NavigationFragment dans vos fichiers XML de mise en page :

Avant (v7.x et versions antérieures) :

<fragment
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/navigation_fragment"
    android:name="com.google.android.libraries.navigation.SupportNavigationFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Après (v8.0.0+) :

<fragment
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/navigation_fragment"
    android:name="com.google.android.libraries.navigation.NavigationFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Si votre application utilise FragmentContainerView (recommandé pour l'hébergement de fragments), mettez à jour l'attribut android:name :

<androidx.fragment.app.FragmentContainerView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/navigation_fragment"
    android:name="com.google.android.libraries.navigation.NavigationFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

Mettre à jour le code de l'application

Remplacez les importations et les conversions de classes dans votre code Java ou Kotlin. Étant donné que les deux classes étendent androidx.fragment.app.Fragment, continuez à utiliser getSupportFragmentManager() pour rechercher le fragment :

Avant (v7.x et versions antérieures) :

import com.google.android.libraries.navigation.SupportNavigationFragment;

public class MainActivity extends AppCompatActivity {
  private SupportNavigationFragment mNavFragment;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    mNavFragment = (SupportNavigationFragment) getSupportFragmentManager()
        .findFragmentById(R.id.navigation_fragment);
  }
}
    

import com.google.android.libraries.navigation.SupportNavigationFragment

class MainActivity : AppCompatActivity() {
  private lateinit var navFragment: SupportNavigationFragment

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    navFragment = supportFragmentManager
        .findFragmentById(R.id.navigation_fragment) as SupportNavigationFragment
  }
}
    

Après (v8.0.0+) :

import com.google.android.libraries.navigation.NavigationFragment;

public class MainActivity extends AppCompatActivity {
  private NavigationFragment mNavFragment;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    mNavFragment = (NavigationFragment) getSupportFragmentManager()
        .findFragmentById(R.id.navigation_fragment);
  }
}
    

import com.google.android.libraries.navigation.NavigationFragment

class MainActivity : AppCompatActivity() {
  private lateinit var navFragment: NavigationFragment

  override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)

    navFragment = supportFragmentManager
        .findFragmentById(R.id.navigation_fragment) as NavigationFragment
  }
}
    

Parité des API

Vous n'avez pas besoin d'apporter d'autres modifications de comportement ni de restructurer votre code. NavigationFragment est compatible avec toutes les méthodes publiques, les interfaces d'écouteur et les commandes d'interface utilisateur personnalisées de SupportNavigationFragment avec des signatures de méthode identiques (y compris getMapAsync(), getNavigator(), setEtaCardEnabled() et setStylingOptions()).