Flutter 딥링킹 완벽 가이드 1편: 기초 개념과 플랫폼 설정

<!-- android/app/src/main/AndroidManifest.xml -->
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
    <application>
        <activity
            android:name=".MainActivity"
            android:exported="true"
            android:launchMode="singleTop"
            android:theme="@style/LaunchTheme"
            android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
            android:hardwareAccelerated="true"
            android:windowSoftInputMode="adjustResize">
            
            <!-- 기본 런처 인텐트 필터 -->
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
            
            <!-- 커스텀 URL 스킴 설정 -->
            <intent-filter>
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <!-- 여러 스킴을 지원할 수 있음 -->
                <data android:scheme="myflutterapp" />
                <data android:scheme="myapp" />
            </intent-filter>
            
            <!-- App Links 설정 (Android 6.0+) -->
            <!-- autoVerify="true"는 자동으로 도메인 소유권을 확인 -->
            <intent-filter android:autoVerify="true">
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                
                <!-- HTTPS 스킴만 지원 -->
                <data android:scheme="https" />
                
                <!-- 여러 호스트 지원 가능 -->
                <data android:host="myapp.example.com" />
                <data android:host="www.myapp.example.com" />
                <data android:host="m.myapp.example.com" />
                
                <!-- 특정 경로 패턴만 처리하고 싶을 때 -->
                <data android:pathPrefix="/app" />
                <data android:pathPattern="/share/.*" />
            </intent-filter>
            
            <!-- 특정 파일 타입 처리 (선택사항) -->
            <intent-filter>
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <data android:scheme="content" />
                <data android:mimeType="application/myapp" />
            </intent-filter>
        </activity>
    </application>
</manifest>

<!-- ios/Runner/Info.plist -->
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <!-- 기존 설정들... -->
    
    <!-- URL Schemes 설정 (커스텀 스킴) -->
    <key>CFBundleURLTypes</key>
    <array>
        <dict>
            <!-- 스킴 식별자 (역방향 도메인 형식 권장) -->
            <key>CFBundleURLName</key>
            <string>com.example.myflutterapp.deeplink</string>
            
            <!-- 실제 URL 스킴들 -->
            <key>CFBundleURLSchemes</key>
            <array>
                <string>myflutterapp</string>
                <string>myapp</string>
                <!-- 여러 스킴 등록 가능 -->
            </array>
        </dict>
    </array>
    
    <!-- iOS 9+ 보안 설정 (필요한 경우) -->
    <key>LSApplicationQueriesSchemes</key>
    <array>
        <!-- 앱에서 체크하거나 열 수 있는 다른 앱의 스킴 -->
        <string>whatsapp</string>
        <string>instagram</string>
        <string>fb</string>
    </array>
</dict>
</plist>

// iOS Runner.entitlements 파일 (자동 생성됨)
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.developer.associated-domains</key>
    <array>
        <!-- applinks: 접두사는 Universal Links를 의미 -->
        <string>applinks:myapp.example.com</string>
        <string>applinks:*.myapp.example.com</string>
        <!-- 와일드카드 서브도메인 지원 -->
        <string>applinks:www.myapp.example.com</string>
    </array>
</dict>
</plist>

// https://myapp.example.com/.well-known/apple-app-site-association
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "TEAM_ID.com.example.myflutterapp",
        "paths": [
          "/app/*",
          "/product/*",
          "/user/*",
          "/share/*",
          "NOT /api/*",
          "NOT /admin/*"
        ]
      },
      {
        // 여러 앱 지원 가능
        "appID": "TEAM_ID.com.example.myflutterapp.beta",
        "paths": ["/beta/*"]
      }
    ]
  },
  "webcredentials": {
    // 자동 로그인 지원 (선택사항)
    "apps": ["TEAM_ID.com.example.myflutterapp"]
  }
}

// https://myapp.example.com/.well-known/assetlinks.json
[
  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.myflutterapp",
      "sha256_cert_fingerprints": [
        // Play Console에서 확인 가능한 SHA256 지문
        "14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"
      ]
    }
  },
  {
    // 여러 빌드 변형 지원 (debug, release 등)
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.myflutterapp.debug",
      "sha256_cert_fingerprints": [
        "디버그용_SHA256_지문"
      ]
    }
  }
]

# Android 테스트 (에뮬레이터 또는 연결된 기기에서)
# 커스텀 스킴
adb shell am start -a android.intent.action.VIEW \
    -d "myflutterapp://product/123" com.example.myflutterapp

# App Link (HTTPS)
adb shell am start -a android.intent.action.VIEW \
    -d "https://myapp.example.com/product/123" com.example.myflutterapp

# iOS 테스트 (시뮬레이터에서)
# 커스텀 스킴
xcrun simctl openurl booted "myflutterapp://product/123"

# Universal Link
xcrun simctl openurl booted "https://myapp.example.com/product/123"

# 실제 기기 테스트
# 1. 메모 앱이나 메시지 앱에 링크 입력
# 2. 링크를 탭하여 앱이 열리는지 확인
# 3. 앱이 설치되어 있지 않은 경우 웹 페이지가 열리는지 확인