외부 패키지 없이 Flutter로 구현하는 고성능 Deep Link 설계 전략

Context

사용자가 앱 설치 전후에 특정 페이지로 즉시 진입하는 매끄러운 경험 제공 필요. 외부 라이브러리 의존 시 내부 동작 원리 파악이 어렵고 유지보수 리스크 발생. 앱 미설치 상태에서도 컨텍스트를 유지하는 Deferred Deep Linking 구현 요구사항 존재.

Technical Solution

• Custom Schemes와 App Links/Universal Links의 특성을 구분하여 개발 환경과 운영 환경에 맞춤 적용하는 전략
• OS 차원의 도메인 검증을 위해 Android의 assetlinks.json과 iOS의 apple-app-site-association 파일을 활용한 양방향 인증 구조
• Dart와 Native 계층 간의 통신 신뢰성 확보를 위해 MethodChannel 및 EventChannel 명칭을 상수로 중앙 집중 관리하는 설계
• URL 구조를 Scheme, Host, Path, Query로 분해하여 처리하는 전용 데이터 모델링 및 Freezed 기반의 불변 객체 적용
• DeepLinkType Enum을 도입하여 보안 연결 여부(isSecure)를 판단하는 표현력 높은 로직 구현

Key Takeaway

플랫폼 네이티브 기능을 직접 제어함으로써 외부 의존성을 제거하고 시스템 레벨의 라우팅 메커니즘을 정확히 통제하는 설계 원칙의 중요성.