SDK 55 브레이킹 체인지 총정리
New Arch 전용 전환, 제거된 API, 마이그레이션 체크리스트
핵심 변경: New Architecture 전용
SDK 55부터 Legacy Architecture가 완전히 제거되었습니다.
newArchEnabled 플래그는 더 이상 의미가 없으며, Bridge 기반 네이티브 모듈은 동작하지 않습니다.
| 항목 | SDK 54 | SDK 55 |
|---|---|---|
| Legacy Architecture | 지원 (opt-out) | 제거 |
| Bridge 모듈 | 동작 | 미동작 |
| Fabric Renderer | opt-in | 기본값 (유일) |
| TurboModules | opt-in | 기본값 (유일) |
제거된 API 및 패키지
| 제거 항목 | 대체 방법 |
|---|---|
AsyncStorage (커뮤니티) | expo-secure-store 또는 MMKV |
ExpoRequest / ExpoResponse (Expo Router) | 표준 Request / Response |
expo-video-thumbnails | SDK 56에서 완전 제거 예정, expo-video 활용 |
reset prop (headless tabs) | resetOnFocus로 이름 변경 |
Legacy MainApplication.java 템플릿 | Kotlin MainApplication.kt 기본 |
React Native 0.83 → 0.84 업그레이드 주의점
SDK 55는 RN 0.83.1을 번들하지만, RN 0.84.1이 이미 출시되었습니다 (2026-03-04). SDK 56에서 RN 0.85가 포함될 예정이며, 0.84 주요 변경점을 미리 파악해야 합니다.
| RN 0.84 변경 | 프로덕션 영향 |
|---|---|
| Hermes V1 기본 | TTI 10~15% 개선, 일부 Hermes V0 바이트코드 비호환 |
| iOS 프리컴파일 바이너리 | M4 기준 클린 빌드 8배 빨라짐 |
| Legacy Arch 코드 iOS 제거 | 빌드 크기 감소, Bridge 의존 코드 완전 불가 |
| Node.js v22.11+ 필수 | CI 러너 Node 버전 업그레이드 필요 |
| RN 0.81 지원 종료 | 0.81 이하 프로젝트는 보안 패치 미제공 |
React 19.2.1 보안 패치
React 19.2.1에 Server Components 보안 취약점 패치가 포함되었습니다.
Expo SDK 55의 기본 React 19.2.0과 버전 불일치가 발생할 수 있으므로,
react-native-renderer 호환성을 확인 후 업데이트하세요.
마이그레이션 체크리스트
- Bridge 기반 네이티브 모듈을 TurboModules/Expo Modules API로 전환
-
AsyncStorage→expo-secure-store또는 MMKV 마이그레이션 -
ExpoRequest/ExpoResponse→ 표준Request/Response변경 -
resetprop →resetOnFocus이름 변경 반영 - CI/CD Node.js 버전 22.11+ 확인 (RN 0.84 대비)
- Hermes V1 바이트코드 호환성 테스트
-
expo-video-thumbnails사용 여부 확인 및 대체 계획 - React 19.2.1 보안 패치 적용 가능 여부 확인
- EAS Build에서
eas-cli18.3.0+ 및 Node 20+ 설정