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.