| 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
