ios-app-lifecycle

name	ios-app-lifecycle
description	Configure AppDelegate, SceneDelegate, deep linking, and background tasks. Use when configuring iOS app lifecycle, deep linking, or background task scheduling.
metadata	{"triggers":{"files":["AppDelegate.swift","SceneDelegate.swift"],"keywords":["didFinishLaunchingWithOptions","willConnectTo","backgroundTask","Shortcut","UserActivity"]}}

iOS App Lifecycle

Priority: P0 (CRITICAL)

Implementation Workflow

1. Configure SceneDelegate — Use for UI windows and scene-specific state in iOS 13+.
2. Keep AppDelegate slim — Focus on app-wide setup (DI, Analytics, Push registration). Move initialization logic to dedicated Bootstrapper or AppCoordinator.
3. Handle deep links — Prefer Universal Links over custom URL schemes. Handle via scene(_:continue:userActivity:). Route through Root Coordinator.
4. Schedule background tasks — Use BGTaskScheduler for periodic data refresh. Always handle expirationHandler to avoid system kill.

See bootstrapper pattern and background task examples

Anti-Patterns

• No Complex AppDelegate Logic: Delegate to Bootstrapper service
• No Manual AppDelegate UIWindow: Use SceneDelegate for iOS 13+
• No Sync Launch Network: Move all launch calls to background threads

References

• Lifecycle & Background Tasks