AgentSkillsCN

iOS Navigation

利用 NavigationStack 和 Universal Links 实现 SwiftUI 的导航与深度链接功能。

SKILL.md
--- frontmatter
name: iOS Navigation
description: SwiftUI navigation and deep linking using NavigationStack and Universal Links.
metadata:
  labels: [ios, swiftui, navigation, deep-linking, universal-links]
  triggers:
    files: ['**/*View.swift', '**/*App.swift']
    keywords:
      [
        NavigationStack,
        NavigationLink,
        onOpenURL,
        universalLink,
        NSUserActivity,
      ]

iOS Navigation (SwiftUI)

Priority: P2 (OPTIONAL)

SwiftUI path-based navigation and deep linking.

Guidelines

  • •Stack: Use NavigationStack (iOS 16+) with NavigationPath for programmatic control.
  • •Deep Links: Handle onOpenURL at the Root View (WindowGroup).
  • •Universal Links: Configure Associated Domains (applinks) in Entitlements.
  • •Tabs: Maintain separate NavigationStack instances per TabItem.

Navigation Patterns

Anti-Patterns

  • •No Force Unwrapping: Use guard let when parsing URL components.
  • •No Broken Back Stack: Ensure valid path state before appending destinations.
  • •No Missing Validation: Check content availability before deep-link navigation.

Related Topics

ios-design-system | ios-notifications | mobile-ux-core