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 mengalami error dan merupakan cara yang direkomendasikan untuk menggunakan Navigasi di aplikasi Anda. Saat menggunakan SupportNavigationFragment, pastikan untuk tidak 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 mengeksekusi beberapa inisialisasi di NavigationView#onCreate dan NavigationView#onStart, serta pembersihan di NavigationView#onStop dan NavigationView#onDestroy, serta saat peristiwa siklus proses lainnya diproses.

Metode siklus proses NavigationView memiliki makna yang sama seperti untuk aktivitas atau fragmen Android. 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 dan dipanggil dalam urutan yang sama dengan callback siklus proses Android, pengurutan yang kuat dari metode NavigationView ini diperlukan. Jika tidak, Anda mungkin mengalami kebocoran memori, error UI, lokasi tidak diperbarui, dan masalah lainnya.

Untuk mengetahui 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 agar dapat 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.