피드로 돌아가기
Flutter Deep Linking: Complete Guide for Android App Links & iOS Universal Links
Dev.toDev.to
Frontend

Android App Links 및 iOS Universal Links 기반의 Flutter 통합 Deep Linking 설계

Flutter Deep Linking: Complete Guide for Android App Links & iOS Universal Links

Ankush Lokhande2026년 5월 27일7intermediate

Context

단순 URL 오픈을 넘어 특정 앱 화면으로의 직접 진입을 구현하기 위한 플랫폼별 Deep Linking 체계 필요. OS 수준의 검증 절차 누락 시 브라우저 리다이렉션 발생 및 사용자 경험 저하라는 한계 존재.

Technical Solution

  • app_links 패키지를 통한 플랫폼 독립적인 incoming URL 수신 및 라우팅 처리 구조 설계
  • Android App Links 구현을 위해 assetlinks.json 파일을 .well-known 경로에 배치하여 도메인 소유권 검증 수행
  • iOS Universal Links 구현을 위해 apple-app-site-association 파일을 통한 App ID 및 컴포넌트 경로 매핑 설정
  • Google Play Console의 App signing certificate SHA-256 지문 반영을 통한 프로덕션 환경의 인증 무결성 확보
  • AndroidManifest.xml 내 intent-filter의 autoVerify 설정을 통한 OS 수준의 자동 링크 연결 최적화
  • 특정 경로(/product/*)와 전체 경로(/)를 구분한 세부 라우팅 전략 수립으로 앱 내 진입점 제어

- 프로덕션 배포 전 Play Console의 SHA-256 지문을 assetlinks.json에 반드시 포함했는지 확인 - .well-known 경로의 검증 파일이 Content-Type: application/json으로 정상 응답하는지 검증 - iOS의 경우 Team ID와 Bundle Identifier의 정확한 조합으로 apple-app-site-association 파일 구성 - adb shell 및 xcrun simctl 명령어를 활용한 OS 수준의 링크 트리거 테스트 수행

원문 읽기