2026년 4월 28일부터 App Store Connect에 업로드되는 모든 앱과 업데이트는 Xcode 26 이상을 사용하여 빌드해야 하며, iOS 26 SDK 또는 iPadOS, tvOS, visionOS, watchOS용 26 SDK를 사용해야 합니다. Capacitor 앱을 배포 중이라면 이 데드라인을 반드시 확인하세요.
다행인 점은 대부분의 팀에게 이것이 전체 앱 마이그레이션이 아닌 빌드 환경의 변경이라는 것입니다. 그리고 이미 사용 중이라면 Capgo 빌드, iOS 빌드 시스템이 이미 Xcode 26을 사용 중입니다.
Apple의 변경 사항
Apple은 이 요구 사항을 향후 요구 사항 페이지에 발표했고, 같은 내용을 App Store 제출 페이지에서도 언급합니다.
적용 시작: 2026년 4월 28일, App Store Connect에서는 Xcode 26 미만 버전으로 빌드했거나 필수 26 SDK가 없는 업로드를 더 이상 허용하지 않습니다. 이미 App Store에 출시된 앱은 계속 작동하지만, 다음에 제출할 바이너리는 반드시 새 툴체인으로 빌드해야 합니다.
Capacitor 팀에 미치는 영향
대부분의 Capacitor 앱의 경우, 이는 Capacitor을 교체하거나 프로젝트를 다시 작성하는 문제가 아니라 주로 앱을 빌드하는 방식에 관한 문제입니다.
모든 빌드 경로에서 Xcode 26 이상을 사용하도록 설정하세요:
- 로컬 Mac 빌드: Xcode 26 이상을 설치하고 선택하세요.
- 자체 관리 CI: Xcode 26 이상이 설치된 macOS runner 이미지를 사용하세요.
- Native dependencies 및 이전 플러그인: 새로운 SDK에서 다시 빌드하고 다음 릴리스 전에 새 아카이브를 테스트하세요.
문제는 단순합니다. 개발 환경에서는 모든 것이 정상 작동할 수 있지만, 이전 버전의 Xcode로 빌드한 경우 App Store Connect에서 upload를 차단합니다.
Capgo Build는 이미 Xcode 26을 사용 중입니다
만약 다음을 통해 빌드한다면, Capgo 빌드, you do not need to scramble to update your build environment for this Apple deadline. As of April 29, 2026, our current iOS build system is already running on Xcode 26 or later through Capgo 빌드.
즉, Capgo Build를 사용하는 팀은 Apple의 2026년 4월 28일 제출 요구 사항을 이미 충족하고 있다는 의미입니다. 로컬 Mac을 새로 세팅하거나, runner 이미지를 찾거나, 배포를 위해 막판에 Xcode를 업그레이드할 필요가 없습니다.
지금 바로 조치해야 하는 경우
다음 중 하나라도 해당한다면 조치가 필요합니다:
- iOS 앱을 로컬에서 빌드 및 아카이브하며, 아직 Xcode 26 이상으로 전환하지 않은 경우.
- 자체 관리 중인 CI 파이프라인이 Xcode 26보다 낮은 버전의 Xcode 이미지를 사용하도록 고정된 경우.
- iOS 26 SDK 환경에서 재빌드 시 특정 native SDK나 플러그인에 문제가 발생하는 경우.
위와 같은 환경이라면, 먼저 툴체인을 업데이트한 후 클린 빌드와 TestFlight 제출을 진행하여 프로덕션 출시를 준비하세요.
최종 요약
이는 Apple의 통상적인 연례 툴체인 전환 주기이지만, 적용 시점은 엄격합니다: 2026년 4월 28일부터, 이전 버전의 Xcode 빌드로는 App Store 업로드가 불가능합니다.
Capgo Build를 사용 중이라면 이미 Xcode 26 이상을 사용하고 계신 것입니다. 다른 환경에서 빌드한다면, 다음 iOS 출시 전에 환경을 Xcode 26 이상으로 업데이트하세요.
Apple의 Capacitor 앱용 Xcode 26 요구 사항 관련 글 더 보기
사용 중이라면 Capacitor 앱을 위한 Apple Xcode 26 요구 사항 CI/CD 자동화를 계획하려면, 다음을 연결하세요 Capgo CI/CD 설정하기 Capgo CI/CD의 제품 워크플로우용, Capgo Native Build Capgo Native Builds의 제품 워크플로우용, Capgo 연동 서비스 Capgo Integrations의 제품 워크플로우용, CI/CD 통합 CI/CD Integration의 구현 세부 사항은, 그리고 GitHub Actions 연동 GitHub Actions Integration의 구현 세부 사항을 참고하세요.
