[RN/오류노트] Solved - Invalid bundle. The "UIInterfaceOrientationPortrait" orientations were provided,

해당 문제는 react-native 환경에서 Xcode를 빌드를 하는 중에 발생하는 오류입니다.

 

1) 문제점

---

💡 문제점

- Xcode를 빌드하는 도중에 아래와 같은 문제점이 발생하였습니다.

- Invalid bundle. The "UIInterfaceOrientationPortrait, UIInterfaceOrientationLandscapeLeft, UIInterfaceOrientationLandscapeRight" orientations were provided, but you need to include all of "UIInterfaceOrientationPortrait, UIInterfaceOrientationPortraitUpsideDown, UIInterfaceOrientationLandscapeLeft, UIInterfaceOrientationLandscapeRight" to support iPad multitasking.

 

 

2) 해결방법

---

💡 해결방법
- 현재 Info.plist → UISupportedInterfaceOrientations에 Portrait, LandscapeLeft, LandscapeRight만 있음이 확인이 되었습니다. 하지만 iPad 멀티태스킹 지원 앱이라면 PortraitUpsideDown 도 무조건 추가해야 한다는 규칙이 있습니다.

- 예를 들어서 Xcode 내에서, iPad를 지원함을 선택하였는데, UISupportedInterfaceOrientations 부분에 UIInterfaceOrientationPortrait 밖에 없다는 문제였습니다.

- 이를 해결하기 위해, plist.info 파일 내에 아래와 같이 추가를 합니다.

<key>UISupportedInterfaceOrientations</key>
<array>
	<string>UIInterfaceOrientationPortrait</string>
	<string>UIInterfaceOrientationPortraitUpsideDown</string>
	<string>UIInterfaceOrientationLandscapeLeft</string>
	<string>UIInterfaceOrientationLandscapeRight</string>
</array>

 

Info.plist 키 값	설명	일반 사용상황
UIInterfaceOrientationPortrait	세로 모드 (홈 버튼/Face ID 센서가 아래쪽)	기본 iPhone 사용 모드
UIInterfaceOrientationPortraitUpsideDown	세로 반전 모드 (홈 버튼/Face ID 센서가 위쪽)	iPad에서 주로 사용됨. iPhone은 기본적으로 이 방향을 막아둠
UIInterfaceOrientationLandscapeLeft	가로 모드 (홈 버튼/Face ID 센서가 왼쪽)	가로 모드 UI 지원할 때 필요
UIInterfaceOrientationLandscapeRight	가로 모드 (홈 버튼/Face ID 센서가 오른쪽)	가로 모드 UI 지원할 때 필요

 

 

💡 만약에 멀티 태스킹을 지원하지 않는 앱(iPad)이고, 세로 모드만 지원한다면 아래와 같은 설정만 있으면 됩니다.

<key>UISupportedInterfaceOrientations</key>
<array>
	<string>UIInterfaceOrientationPortrait</string>
</array>

 

 

 

오늘도 감사합니다. 😀