Flutter iOS 27 ITMS-90870 오류 - launch screen 누락을 출시 전에 막는 법

Flutter iOS 출시 빌드의 launch screen 검수

2026년 iOS 27 SDK로 Flutter 앱을 App Store Connect에 올릴 때 ITMS-90870: Missing launch screen이 나오면 Dart 코드보다 Info.plist와 launch storyboard를 확인해야 한다. 기본 Flutter 템플릿은 LaunchScreen.storyboard를 연결하면 된다.

오류가 생기는 조건

Apple 기술 문서 기준으로 iOS 27 SDK 이상으로 빌드한 앱은 아래 키 중 하나가 Info.plist에 있어야 한다.

설정 확인할 값
UILaunchStoryboardName LaunchScreen 또는 storyboard 이름
UILaunchScreen 시스템 launch 화면 딕셔너리
UILaunchStoryboards storyboard 배열

파일이 프로젝트에 있다는 사실만으로 충분하지 않다. 타깃에서 빠졌거나 Info.plist가 다른 flavor 파일을 가리키면 최종 앱 번들에서 키가 사라진다.

Flutter 프로젝트에서 고치는 방법

Xcode에서 Runner 타깃의 Launch Screen File을 지정하거나, ios/Runner/Info.plist의 <dict> 안에 다음 항목을 둔다.

<key>UILaunchStoryboardName</key>
<string>LaunchScreen</string>

LaunchScreen.storyboard가 Target Membership에서 빠지면 설정만으로는 해결되지 않는다. File Inspector에서 Runner 체크를 확인하고, launch screen에는 UIKit의 정적 뷰만 둔다.

IPA 안에 실제로 들어갔는지 검증

업로드 전에 archive 산출물의 plist를 읽으면 flavor·CI 설정 차이를 잡을 수 있다.

flutter clean
flutter build ipa --release --export-options-plist=ios/ExportOptions.plist

unzip -q build/ios/ipa/*.ipa -d /tmp/flutter-ipa-check
APP=$(find /tmp/flutter-ipa-check/Payload -maxdepth 1 -name '*.app' -print -quit)
/usr/libexec/PlistBuddy -c 'Print :UILaunchStoryboardName' "$APP/Info.plist"
find "$APP" -name 'LaunchScreen.storyboardc' -print

첫 번째 명령이 키를 출력하고 두 번째 결과가 비어 있지 않아야 한다. 키만 있으면 리소스 포함 설정을, storyboard만 있으면 Release용 INFOPLIST_FILE을 확인한다.

출시 체크리스트

앱 아이콘이나 App Privacy 입력은 이 오류를 고치지 못한다. 업로드 바이너리의 launch screen 선언과 Flutter 초기화 지연에 따른 흰 화면은 별개다. 기준은 Apple의 launch screen 기술 문서와 Flutter의 iOS launch screen 안내에서 확인할 수 있다.