Skip to Content
DecisionsADR-0013: SDK 57/Xcode 27 iOS 런치 크래시를 fix-forward로 해결한다 (enableSceneSupport + 최소 iOS 18)

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 크래시 로그로 확정):

  1. 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 확인)
  2. iOS 27 — EXC_BREAKPOINT in ___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-properties 57.0.20 이상(둘 다 충족해야 플래그가 실제로 동작). 이번 작업에서 expo-build-properties 57.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) 구축을 재검토한다.
Last updated on