호환성 매트릭스 (Known-Bad Combos)
모바일·백엔드 툴체인/런타임 조합 중 재현 가능한 버그를 가진 것을 모은다. CLAUDE.md 의 네이티브 디버깅 프로토콜에서 이 파일을 1단계로 참조한다.
양식
| 날짜 | 프레임워크 × OS × 기기 | 증상 | 원인·이슈 | 워크어라운드 | 해결 버전 |
|---|
기록
| 날짜 | 조합 | 증상 | 원인 | 워크어라운드 | 해결 |
|---|---|---|---|---|---|
| 2026-04-24 | Flutter 3.38–3.41.7 × iOS 26.1 (빌드 23B85) × iPhone 12 Pro (그리고 iPhone 14 Plus 등 비-ProMotion 포함) | 앱 실행 성공 · Dart 코드 빌드 · 흰/검은 화면만 표시 · crash log 없음 | Flutter 엔진의 Metal/Skia 렌더링 서피스 초기화 실패 — iOS 26.1 특유. flutter#179592, flutter#180115 | iOS 26.1 회피 — 26.0 유지 또는 26.2+ 업그레이드. 코드·Info.plist·AppDelegate/SceneDelegate 수정으론 해결되지 않음 | 미확정 (triage 중) |
체크 규칙
- 새 버그 조합 만나면 해결 시점에 이 표에 append.
원인칸에는 공식 이슈 링크 필수 (추측 금지).- 워크어라운드 없이 회피만 가능한 건
워크어라운드에 "회피: <조건>" 으로 표기. - 해결되면
해결칸에 버전/날짜 기록 + 이 행은 계속 남겨둠 (회귀 방지 힌트용).