Flutter iOS 로컬 네트워크 권한 오류 - Debug Bonjour를 Release에 넣지 않는 조건

Flutter iOS Debug와 Release 네트워크 권한 분리

Flutter iOS 앱에서 flutter attach와 hot reload를 쓰려고 넣은 Bonjour 설정은 Debug에만 둬야 한다. TestFlight나 App Store 빌드에서 _dartVmService._tcp를 그대로 유지하면 로컬 네트워크 권한 문구가 출시 앱에 나타나거나 심사 리스크가 생긴다. 반대로 앱 기능 자체가 같은 Wi-Fi의 기기를 검색한다면 Release에서도 로컬 네트워크 권한을 선언해야 하므로, “Release에서 네트워크 키를 전부 삭제”하는 방식도 정답은 아니다.

어떤 설정이 문제를 만드는가

Flutter 공식 문서는 iOS 14 이상에서 Dart VM 서비스용 multicast DNS를 Debug에만 활성화하라고 안내한다. 이 서비스는 개발 도구 연결을 위한 것이지 사용자가 쓰는 앱 기능이 아니다. NSLocalNetworkUsageDescription은 권한 설명이고, NSBonjourServices는 검색할 Bonjour 서비스 목록이라 역할도 다르다.

대상 NSBonjourServices 로컬 네트워크 설명 판단
Debug·Profile _dartVmService._tcp 개발용 문구 Flutter 도구 연결에 사용
Release, 로컬 네트워크 미사용 없음 없음 개발 권한을 출시물에서 제거
Release, 기기 검색 기능 사용 실제 서비스 타입만 사용자에게 기능 설명 앱 기능에 필요한 권한

여기서 헷갈린 부분은 Info.plist 하나를 모든 빌드가 공유한다는 점이다. Debug에서 권한 대화상자가 잘 뜬다는 이유로 그 파일을 Release에도 연결하면, 출시 앱의 권한 목록이 개발 환경과 같아진다.

빌드 구성별 plist를 분리한다

Xcode의 Build Settings에서 Debug는 Info-Debug.plist, Release는 Info-Release.plist를 가리키게 만든다. 아래처럼 개발용 Bonjour 서비스는 Debug 파일에만 둔다.

<!-- Info-Debug.plist -->
<key>NSBonjourServices</key>
<array>
    <string>_dartVmService._tcp</string>
</array>
<key>NSLocalNetworkUsageDescription</key>
<string>개발 도구 연결을 위해 로컬 네트워크에 접근한다.</string>
// Debug configuration
INFOPLIST_FILE = Runner/Info-Debug.plist

// Release configuration
INFOPLIST_FILE = Runner/Info-Release.plist

Info-Release.plist에는 앱이 실제로 로컬 기기 검색을 하지 않는다면 두 키를 넣지 않는다. 스마트홈·BLE 보조 검색·프린터 탐색처럼 Release에서도 Bonjour를 쓰는 앱이라면 _http._tcp처럼 실제 서비스 타입만 남기고, 사용자에게 왜 필요한지 설명하는 문구를 작성한다. 개발용 _dartVmService._tcp를 기능용 서비스처럼 재사용하면 안 된다.

Release 산출물에서 확인할 것

flutter build ipa --release가 성공했다고 설정이 올바른 것은 아니다. Archive 안의 최종 앱 번들을 확인해야 한다.

plutil -p build/ios/archive/Runner.xcarchive/Products/Applications/Runner.app/Info.plist \
  | rg 'NSBonjourServices|NSLocalNetworkUsageDescription|dartVmService'

출력에 _dartVmService._tcp가 나오면 Release plist 경로, Xcode의 INFOPLIST_FILE, Build Phases에 복사된 plist를 함께 확인한다. Info-Release.plist를 프로젝트에 추가했지만 Copy Bundle Resources에만 넣고 빌드 설정을 바꾸지 않은 경우도 있다. Archive를 다시 만들 때는 이전 산출물을 혼동하지 않도록 flutter clean 후 실행한다.

출시 전 체크리스트

Flutter 공식 기준은 Debug에서 Dart multicast DNS를 켜고 Release에서는 켜지 않는 것이다. Apple도 로컬 네트워크를 실제로 사용하는 앱에는 NSLocalNetworkUsageDescription을 요구한다. 따라서 해결 기준은 키를 무조건 삭제하는 것이 아니라, 개발 도구 권한과 제품 기능 권한을 빌드 구성 및 서비스 타입별로 분리하는 데 있다.

참고: Flutter iOS 프로젝트 설정, Flutter iOS 디버깅, Apple NSLocalNetworkUsageDescription