AgentSkillsCN

Android Legacy Navigation

Jetpack Navigation Component（XML）与 SafeArgs 的标准。

SKILL.md
--- frontmatter
name: Android Legacy Navigation
description: Standards for Jetpack Navigation Component (XML) and SafeArgs
metadata:
  labels: [android, navigation, xml, safeargs]
  triggers:
    files: ['navigation/*.xml']
    keywords: ['findNavController', 'NavDirections', 'navArgs']

Android Legacy Navigation Standards

Priority: P1

Implementation Guidelines

Setup

  • •Single Activity: Use one Host Activity with a NavHostFragment.
  • •SafeArgs: MANDATORY for passing data between fragments.

Graph Management

  • •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 (Nav handles them).

Anti-Patterns

  • •Bundle Keys: **No "strings"**: Use SafeArgs generated classes.
  • •Fragment Transations: **No Manual commit()**: Use NavController.

References