Flutter iOS 27 흰 화면 오류 - 실기기 Device Support 심볼 준비와 flutter run 복구

Flutter iOS 27 실기기 흰 화면과 Device Support 준비

iOS 27로 업데이트했거나 새 iPhone을 페어링한 뒤 flutter run이 흰 화면에서 멈춘다면 앱 코드보다 Mac의 Xcode Device Support 심볼 준비 상태를 먼저 확인하는 편이 맞다. Xcode 27과 Flutter 3.50 조합이면 CLI가 준비를 자동 처리하지만, Flutter가 낮거나 준비가 실패한 환경은 xcodebuild -prepareDeviceSupport를 직접 실행해야 한다. TestFlight 출시 앱의 흰 화면에는 이 해결책이 적용되지 않는다.

증상이 앱 오류처럼 보이는 이유

Flutter 공식 이슈에는 iOS 27 실기기에서 앱이 설치·실행된 뒤 흰 화면으로 멈추고, LLDB가 기기의 shared cache를 찾지 못한다는 경고를 남기는 사례가 기록돼 있다. 새 OS의 디버깅 심볼을 Xcode가 내려받는 동안 Flutter가 Dart VM Service 연결을 기다리는 상황이다. 약 5분 뒤 열릴 수도 있지만, 매번 기다리는 방식은 정상적인 개발 조건이 아니다.

확인 지점 Device Support 문제 앱 초기화 문제
대상 새로 업데이트·페어링한 실기기 특정 앱 또는 모든 기기
로그 단서 libobjc.A.dylib shared cache 경고 main() 이후 플러그인·네트워크 오류
우선 조치 Xcode 심볼 준비 앱 초기화와 플러그인 분리

Xcode 심볼을 직접 준비하는 방법

기기의 UDID를 확인한 뒤, Xcode가 설치된 Mac에서 아래 명령을 실행한다. flutter devices 출력의 id 값을 사용하면 된다.

flutter devices
xcrun xcodebuild -prepareDeviceSupport -destination "id=기기-UDID"

명령이 끝날 때까지 USB 연결을 유지하고 iPhone의 잠금도 해제한다. Xcode가 Developer Mode, 컴퓨터 신뢰, 기기 페어링을 요구하면 화면에서 승인한다. 준비가 끝난 뒤 다시 실행한다.

flutter clean
flutter pub get
flutter run -d 기기-UDID

여기서 flutter clean은 심볼을 내려받는 핵심 명령이 아니다. 이전 빌드 산출물이 남아 결과를 헷갈리게 할 때만 함께 사용한다. prepareDeviceSupport가 실패했다면 Xcode 선택 경로와 버전을 확인한다.

xcode-select -p
xcodebuild -version
flutter doctor -v

Flutter 버전에 따른 판단

Flutter 3.50 공식 변경 사항에는 새로 페어링했거나 업데이트한 iPhone에서 CLI가 기기를 자동 준비하고, 준비에 실패하면 안내하도록 바뀐 내용이 포함됐다. 따라서 이 증상이 반복되면 무작정 프로젝트 코드를 고치기보다 flutter --version부터 기록한다.

출시 전 체크는 새 iOS 기기 연결 → prepareDeviceSupport 완료 → debug 실행 → release 실행 → 백그라운드 복귀 순서로 남기는 것이 안전하다. 시뮬레이터에서 화면이 열렸다는 사실만으로 실기기 디버깅 환경이 준비됐다고 볼 수 없다.

핵심은 흰 화면이 보인다는 결과가 아니라, 앱이 첫 프레임을 못 그린 것인지 Flutter가 디버거 연결을 기다리는 것인지 나누는 데 있다. iOS 27 실기기에서만 오래 멈추고 shared cache 경고가 보이면 Device Support를 준비한 뒤 다시 판단하면 된다.

참고 문서: Flutter 3.50 변경 사항, Flutter iOS Device Support 관련 이슈, Flutter iOS 개발 환경 설정