Práticas recomendadas para interação de navegação com o mapa

Esta página explica as práticas recomendadas para interagir com o mapa de navegação no seu app.

Sempre que possível, use SupportNavigationFragment em vez de NavigationView

O SupportNavigationFragment é um wrapper para a conveniência de processar os callbacks do ciclo de vida de NavigationView. Assim, você não precisa gerenciar esses callbacks. Esse método é menos propenso a erros e é a maneira preferida de usar a navegação no app. Ao usar SupportNavigationFragment, não invoque eventos de ciclo de vida NavigationView.

Se estiver usando NavigationView, aplique a ordem estrita ao invocar métodos do ciclo de vida

O NavigationView hospeda o mapa de navegação e segue de perto os eventos do ciclo de vida como atividades e fragmentos do Android, realizando ações específicas quando esses eventos são invocados. O NavigationView executa várias inicializações em NavigationView#onCreate e NavigationView#onStart, além de limpezas em NavigationView#onStop e NavigationView#onDestroy, bem como quando outros eventos de ciclo de vida são processados.

Os métodos de ciclo de vida NavigationView têm o mesmo significado que as atividades ou fragmentos do Android. Por exemplo, onCreate() de NavigationView é aproximadamente traduzido e precisa ser invocado por callbacks de ciclo de vida da atividade ou do fragmento do Android. Como os callbacks do ciclo de vida NavigationView são baseados e invocados na mesma ordem que os callbacks do ciclo de vida do Android, é necessário ordenar esses métodos NavigationView. Caso contrário, você poderá encontrar vazamentos de memória, erros de interface, localização não atualizada e outros problemas.

Para mais informações sobre o ciclo de vida da atividade do Android, consulte a seção Conceitos do ciclo de vida da atividade na documentação para desenvolvedores Android.

A tabela a seguir mostra quando outros métodos do ciclo de vida precisam ser invocados, após os métodos do ciclo de vida especificados:

Método de ciclo de vida Invocado em que parte do ciclo de vida da atividade Invocado após qual método do ciclo de vida
onConfigurationChanged() Invocado quando a interface está em primeiro plano e a configuração muda. Sempre depois de onStart()
onTrimMemory() Invocado quando uma atividade está em segundo plano. Sempre depois de onPause()
onSaveInstance() Invocado antes de uma atividade ser destruída. Sempre depois de onStop()

Não chame esses métodos de ciclo de vida várias vezes sem chamar o método de fechamento correspondente primeiro. Além disso, lembre-se de que, se alguns desses callbacks do ciclo de vida do Android forem gerenciados pelo próprio app e o NavigationView for adicionado ao fragmento após a criação ou a inicialização, o app precisa chamar os métodos específicos na ordem correta para inicializar corretamente o SDK de navegação.

Para mais orientações sobre o uso desses métodos, consulte o app de demonstração do SDK do Navigation.

Se você usar NavigationView, invoque eventos de ciclo de vida da atividade ou do fragmento, não dos dois.

Para manter a ordem estrita dos métodos do ciclo de vida, invoque esses eventos dos callbacks do ciclo de vida da atividade ou do fragmento, que recebem esses eventos em ordem. Essa abordagem garante que os apps não precisem coordenar entre fragmentos e atividades e causar chamadas duplicadas.