> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Xcode 27 요건에 따른 SceneDelegate 방식 전환
Xcode 27부터 AppDelegate 방식을 사용하는 iOS 앱은 SceneDelegate 방식으로 전환해야 합니다. 아래에서 전환이 필요한 이유와 해야 할 조치, 플랫폼별 트러블 슈팅 가이드를 확인하세요.
## 왜 SceneDelegate 방식으로 전환해야 하나요?
2026년 9월 14일, iOS 앱을 빌드할 때 쓰는 도구인 Xcode의 새 버전 Xcode 27이 출시됐습니다. 애플은 Xcode 27부터 앱이 링크를 처리하고 화면을 표시하는 일을 Scene 단위로 관리하도록 요구합니다.
앱 화면이 표시되는 창 하나하나가 ‘Scene’이며, iPad에서 앱 창을 여러 개 띄우면 창마다 Scene이 하나씩 생깁니다. SceneDelegate 방식에서는 SceneDelegate가, SwiftUI 방식에서는 SwiftUI가 화면을 Scene 단위로 관리합니다. 반면 AppDelegate 방식에서는 AppDelegate가 화면을 Scene으로 나누지 않고 앱 단위로 관리합니다.
Xcode 27 이상으로 빌드한 앱은 화면을 Scene 단위로 관리해야 하므로, AppDelegate 방식을 사용하면 앱이 실행되지 않습니다. 따라서 AppDelegate 방식을 사용하는 iOS 앱은 SceneDelegate 방식으로 전환해야 합니다. React Native, Cordova-Ionic, Flutter, Expo, Unity, Unreal로 개발한 iOS 앱도 마찬가지입니다. SwiftUI 방식을 사용하는 앱은 이미 화면을 Scene 단위로 관리하므로 전환하지 않아도 됩니다. 안드로이드 앱은 영향을 받지 않습니다.
또한 애플은 2027년 4월부터 앱스토어 커넥트(App Store Connect)에 업로드하는 iOS 앱을 iOS 27 SDK 이상, 즉 Xcode 27 이상으로 빌드하도록 요구합니다. 아직 Xcode 26을 사용하더라도 앱을 계속 업데이트하려면 그 전까지 SceneDelegate 방식으로 전환해야 합니다.
자세한 내용은 애플의 [iOS 27 릴리스 노트](https://developer.apple.com/documentation/ios-ipados-release-notes/ios-ipados-27-release-notes)와 [앱스토어 제출 공지](https://developer.apple.com/news/?id=k1mtkt1k)를 참고하세요.
## AppDelegate 방식을 사용하는 앱은 무엇을 해야 하나요?
AppDelegate 방식을 사용하는 iOS 앱은 아래 2가지 조치를 순서대로 취하세요.
### SceneDelegate 방식으로 전환하기
iOS 네이티브 앱은 애플의 [SceneDelegate 방식 전환 문서](https://developer.apple.com/documentation/uikit/transitioning-to-the-uikit-scene-based-life-cycle)를 참고해 SceneDelegate 방식으로 전환하세요.
React Native, Cordova-Ionic, Flutter, Expo, Unity, Unreal로 개발한 iOS 앱은 플랫폼 버전에 따라 플랫폼을 먼저 업데이트해야 SceneDelegate 방식으로 전환할 수 있습니다. 자세한 방법은 아래 [플랫폼별 트러블 슈팅 가이드](#플랫폼별-트러블-슈팅-가이드)를 참고하세요.
### SceneDelegate에 에어브릿지 딥링크 설정하기
SceneDelegate에 에어브릿지 딥링크를 설정하지 않으면 딥링킹이 작동하지 않고 딥링크 이벤트가 수집되지 않습니다. SceneDelegate 방식으로 전환한 후 이어서 설정하세요.
에어브릿지 SDK 버전에 따라 딥링크 설정 방법이 다르며, SDK를 업데이트해야 하는 경우도 있습니다. 자세한 방법은 아래 [플랫폼별 트러블 슈팅 가이드](#플랫폼별-트러블-슈팅-가이드)를 참고하세요.
## 플랫폼별 트러블 슈팅 가이드
사용하는 플랫폼과 에어브릿지 SDK 버전에 맞는 가이드를 아래 표에서 찾아 자세한 조치 방법을 확인하세요.
| 플랫폼 | 에어브릿지 SDK 버전 | 가이드 링크 |
| - | - | - |
| iOS | v4 이상 | [트러블 슈팅 - iOS SDK](/ko/developers/troubleshooting-ios-sdk-v4#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| | v4 미만 (Deprecated) | [트러블 슈팅 - iOS SDK (Deprecated)](/ko/developers/troubleshooting-deprecated-ios-sdk-v1#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| React Native | v4 이상 | [트러블 슈팅 - React Native SDK](/ko/developers/troubleshooting-react-native-sdk-v4#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| | v4 미만 (Deprecated) | [트러블 슈팅 - React Native SDK (Deprecated)](/ko/developers/troubleshooting-deprecated-react-native-sdk-v2#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| Flutter | v4 이상 | [트러블 슈팅 - Flutter SDK](/ko/developers/troubleshooting-flutter-sdk-v4#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| | v4 미만 (Deprecated) | [트러블 슈팅 - Flutter SDK (Deprecated)](/ko/developers/troubleshooting-deprecated-flutter-sdk-v3#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| Cordova-Ionic | 모든 버전 | [트러블 슈팅 - Cordova-Ionic SDK](/ko/developers/troubleshooting-cordova-sdk-v4#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| Expo | v4 이상 | [트러블 슈팅 - Expo SDK](/ko/developers/troubleshooting-expo-sdk-v4#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| | v4 미만 (Deprecated) | [트러블 슈팅 - Expo SDK (Deprecated)](/ko/developers/troubleshooting-deprecated-expo-sdk-v2#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| Unity | v4 이상 | [트러블 슈팅 - Unity SDK](/ko/developers/troubleshooting-unity-sdk-v4#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| | v4 미만 (Deprecated) | [트러블 슈팅 - Unity SDK (Deprecated)](/ko/developers/troubleshooting-deprecated-unity-sdk-v1#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| Unreal | v4 이상 | [트러블 슈팅 - Unreal SDK](/ko/developers/troubleshooting-unreal-sdk-v4#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
| | v4 미만 (Deprecated) | [트러블 슈팅 - Unreal SDK (Deprecated)](/ko/developers/troubleshooting-deprecated-unreal-sdk-v1#a-xcode-27-scenedelegate-전환-필수화-및-airbridge-딥링크-추가-설정-안내) |
## 자주 묻는 질문
2027년 4월 전까지는 Xcode 26으로 빌드한 앱을 앱스토어 커넥트에 업로드할 수 있습니다. 그러나 2027년 4월부터는 Xcode 26으로 빌드한 앱을 앱스토어 커넥트에 업로드할 수 없으므로, 앱을 계속 업데이트하려면 그 전까지 SceneDelegate 방식으로 전환해야 합니다.
앱을 Xcode 27 이상으로 빌드하기 전에 SceneDelegate 방식으로 전환해야 합니다. Xcode 27은 2026년 9월 14일에 출시돼 이미 사용할 수 있습니다. Xcode 27로 앱을 빌드하고 있다면 바로 SceneDelegate 방식으로 전환하세요.
앱스토어 기준으로는 2027년 4월 전까지 전환해야 합니다. 2027년 4월부터는 iOS 27 SDK 이상, 즉 Xcode 27 이상으로 빌드한 앱만 앱스토어 커넥트에 업로드할 수 있기 때문입니다. 자세한 내용은 애플의 [앱스토어 제출 공지](https://developer.apple.com/news/?id=k1mtkt1k)를 참고하세요.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.