ADR-0013: SDK 57/Xcode 27 iOS 런치 크래시를 fix-forward로 해결한다 (enableSceneSupport + 최소 iOS 18)
- Status: Accepted
- Date: 2026-09-18
- 관련: HMH-9383 (이번 작업) · ADR-0011 (이 크래시를 유발한 SDK 57/Xcode 27 업그레이드) · Expo #46664 · react-native-community/template #251 · LLVM #86077
Context
4.0.6(SDK 57/Xcode 27, ADR-0011)이 iOS 실기기에서 런치 즉시 크래시했다. 원인은 Xcode 27/iOS 27 SDK가 유발한 두 개의 별개 크래시다(각 .ips 크래시 로그로 확정):
- iOS 18 미만 — dyld
Symbol not found: std::exception_ptr::__from_native_exception_pointer(Expected in: /usr/lib/libc++.1.dylib). Xcode 27 툴체인이 참조하는 libc++ 심볼이 iOS 18 미만의 libc++에는 없어 앱 코드 실행 전 SIGABRT. (iPhone 11/iOS 17.4.1 확인) - iOS 27 —
EXC_BREAKPOINTin___UIApplicationEvaluateRuntimeIssueForNoSceneLifecycleAdoption. iOS 27 SDK가 UIScene 생명주기 미채택 앱을 런치 시 강제 트랩. (iOS 27 기기 확인)
3중 미탐(이 인시던트의 핵심 교훈):
- App Store 심사 통과 — Apple이 최신 iOS(심볼·UIScene 만족)로 테스트해 통과. 구버전/최신 실기기 유저만 크래시.
- Sentry 0건 — dyld/네이티브 런치 크래시라 JS
Sentry.init(enabled: !isDebugBuild) 이전. “같은 버전 Android는 이벤트 정상인데 iOS만 0건”이 결정적 신호였다. - OTA 무관 — 매니페스트 이전이라, 문제 OTA를 지워 매니페스트를 204로 만들어도 크래시 지속 = 네이티브 확정.
영향(RUM 실측): iOS 18–26은 정상(활성 약 97%), 크래시는 iOS 27(약 1.5%, 증가) + iOS 18 미만(약 1%). 제약: 로컬 Xcode 27만 사용 가능(최신 포인트릴리즈, libc++ 픽스 없음), iOS 스토어 빌드는 릴리즈 담당자 로컬 fastlane(ADR-0011).
그때 몰랐던 것: 수동 UIApplicationSceneManifest(UIApplicationSupportsMultipleScenes만)로는 iOS 27 강제를 못 넘는다(sim·실기기 크래시 지속 실측). Expo 57.0.23+ / expo-build-properties 57.0.20+ 가 enableSceneSupport opt-in 으로 SceneDelegate + Info.plist(UISceneConfigurations)를 자동 생성해준다(Expo #46664).
검토한 대안
| 대안 | 채택 안 한 이유 |
|---|---|
| A. old-Xcode revert (4.0.5 SDK 56 코드를 4.0.7로) | 두 문제가 없던 4.0.5를 재출시. 단 이전 Xcode로 빌드해야만 유효한데(구 iOS SDK = UIScene grandfathering + 호환 libc++), 로컬은 Xcode 27뿐. CI에 이전 Xcode 파이프라인을 급조하는 비용이 크고, SDK 57(ADR-0011)도 되돌림. |
| B. Xcode 포인트릴리즈로 libc++ 픽스 | libc++ 심볼 누락은 전형적 툴체인 버그(과거 Xcode 16.3→16.4 선례)지만, 현재 Xcode가 이미 최신이라 픽스 릴리즈가 없음. |
C. 수동 UIApplicationSceneManifest | 실측상 iOS 27 강제 트랩을 못 넘음(플래그만으론 불충분, 실제 SceneDelegate 채택 필요). |
D. deploymentTarget 하향(전 pod 강제) | libc++ 심볼은 SDK 헤더 레벨에서 emit되어 target을 18 미만으로 낮춰도 참조가 남음(실측). |
Decision
SDK 57을 유지한 채 fix-forward한다. apps/native-app/app.config.ts의 expo-build-properties ios 블록:
enableSceneSupport: true— 이슈2(iOS 27 UIScene). 빌드 시스템이 SceneDelegate + Info.plist를 자동 생성(Expo #46664). 요구: Expo SDK 57.0.23 이상 +expo-build-properties57.0.20 이상(둘 다 충족해야 플래그가 실제로 동작). 이번 작업에서expo-build-properties57.0.19 → 57.0.20 상향(apps/native-app/package.json), Expo는 이미 57.0.23(ADR-0011).deploymentTarget: '18.0'— 이슈1(libc++). 최소 iOS를 18로 올려 심볼이 있는 iOS 18 이상에만 설치되게 한다(구버전 회피). 수동UIApplicationSceneManifest는 제거.
버전: release.config.js APP_VERSION 4.0.7 / IOS_BUILD_NUMBER / ANDROID_VERSION_CODE 상향. iOS·Android 모두 4.0.7 재빌드(Android은 크래시가 없지만 OTA 트랙 동기화를 위해 함께 올림 — HMH-9012 이중발행 트랙 정합).
Consequences
좋아지는 것
- SDK 57 유지(ADR-0011 성과 보존, revert의 old-Xcode 영속 종속 회피).
- iOS 26/27 정상 — RUM에서 iOS 27 4.0.7 정상 세션 확인(프로덕션 검증 완료).
- 공식 경로(Expo가 지원하는 opt-in)라 수동 SceneDelegate/Info.plist 유지보수 불필요.
감수하는 것
- iOS 15–17 지원 중단(활성 약 1%). 이들은 4.0.7을 받지 못하고 현재 버전을 유지한다(대부분 무피해 — 어차피 4.0.6은 못 켬). iOS 스토어 최소 버전이 18로 올라간다.
이 결정을 다시 열어야 할 때
- Xcode/SDK가 libc++ 심볼을 구 iOS로 back-deploy하도록 고치면(포인트릴리즈), 최소 iOS를 다시 낮추는 것을 재검토한다.
- iOS 18 미만 사용자 비중이 유의미하게 커지면(제품 판단), 이전 Xcode를 핀한 CI iOS 빌드 파이프라인(대안 A) 구축을 재검토한다.