Praktik terbaik interaksi peta navigasi

Halaman ini menjelaskan praktik terbaik untuk berinteraksi dengan peta Navigasi di aplikasi Anda.

Gunakan SupportNavigationFragment, bukan NavigationView, jika memungkinkan

SupportNavigationFragment adalah wrapper untuk memudahkan penanganan callback siklus proses NavigationView, sehingga Anda tidak perlu mengelola callback ini sendiri. Metode ini tidak terlalu rentan terhadap kesalahan dan merupakan cara yang lebih disukai untuk menggunakan Navigasi di aplikasi Anda. Saat menggunakan SupportNavigationFragment, pastikan tidak untuk memanggil peristiwa siklus proses NavigationView.

Jika menggunakan NavigationView, gunakan pengurutan yang ketat saat memanggil metode siklus proses

NavigationView menghosting peta Navigasi dan mengikuti peristiwa siklus proses secara cermat sebagai aktivitas dan fragmen Android, mengambil tindakan tertentu saat peristiwa siklus proses ini dipanggil. NavigationView menjalankan beberapa inisialisasi pada NavigationView#onCreate dan NavigationView#onStart, serta pembersihan pada NavigationView#onStop dan NavigationView#onDestroy, serta saat peristiwa siklus proses akan diproses.

Metode siklus proses NavigationView memiliki arti yang sama seperti untuk Android aktivitas atau fragmen Anda. Misalnya, onCreate() dari NavigationView secara kasar diterjemahkan dan harus dipanggil oleh callback siklus proses dari aktivitas atau fragmen Android. Karena callback siklus proses NavigationView didasarkan aktif dan dipanggil dalam urutan yang sama dengan callback siklus proses Android. urutan metode NavigationView ini diperlukan. Jika tidak, Anda mungkin pengalaman memori kebocoran, UI error, lokasi tidak diperbarui, dan masalah lainnya.

Untuk informasi selengkapnya tentang siklus proses aktivitas Android, lihat bagian Konsep siklus proses aktivitas dalam dokumentasi developer Android.

Tabel berikut menunjukkan kapan metode siklus proses lainnya harus dipanggil, setelah metode siklus proses yang ditentukan:

Metode siklus proses Dipanggil dalam siklus proses aktivitas Dipanggil setelah metode siklus proses
onConfigurationChanged() Dipanggil saat UI berada di latar depan dan konfigurasi berubah. Selalu setelah onStart()
onTrimMemory() Dipanggil saat aktivitas berada di latar belakang. Selalu setelah onPause()
onSaveInstance() Dipanggil sebelum aktivitas dihancurkan. Selalu setelah onStop()

Jangan panggil metode siklus proses ini beberapa kali tanpa memanggil metode penutupan yang sesuai terlebih dahulu. Selain itu, perlu diingat bahwa jika beberapa callback siklus proses Android ini dikelola oleh aplikasi itu sendiri, dan NavigationView ditambahkan ke fragmen setelah pembuatan atau mulai, aplikasi harus memanggil metode tertentu itu sendiri dalam urutan yang tepat untuk melakukan inisialisasi Navigation SDK dengan benar.

Untuk panduan tambahan tentang penggunaan metode ini, lihat aplikasi demo Navigation SDK.

Jika menggunakan NavigationView, panggil peristiwa siklus proses dari aktivitas atau fragmen, bukan keduanya

Untuk mempertahankan pengurutan metode siklus proses yang ketat, panggil peristiwa ini dari callback siklus proses aktivitas atau fragmen, yang menerima peristiwa ini secara berurutan. Pendekatan ini memastikan bahwa aplikasi tidak perlu berkoordinasi antara fragmen dan aktivitas serta menyebabkan panggilan duplikat.