android-legacy-navigation

name	android-legacy-navigation
description	Implement Jetpack Navigation Component with XML graphs and SafeArgs for type-safe fragment navigation. Use when working with XML-based Navigation Component or SafeArgs in Android. (triggers: navigation/*.xml, findNavController, NavDirections, navArgs)

Android Legacy Navigation Standards

Priority: P1

1. Set Up Single-Activity Architecture

• Use one Host Activity with a NavHostFragment.
• Enable SafeArgs plugin — MANDATORY for passing data between fragments.

See XML graph & SafeArgs examples for NavHostFragment setup.

2. Manage Navigation Graphs

• Nested Graphs: Modularize navigation/ resources (e.g., nav_auth.xml, nav_main.xml) to keep graphs readable.
• Deep Links: Define explicit <deepLink> in graph, not AndroidManifest intent filters.

3. Navigate with SafeArgs

See XML graph & SafeArgs examples for type-safe navigation usage.

Anti-Patterns

• No Raw String Bundle Keys: Use SafeArgs generated type-safe classes.
• No Manual Fragment commit(): Use NavController for all navigation.

References

• XML Graph & SafeArgs