Info.plist에 사용 목적 문자열이 있어야 합니다. SDK가 대신 선언해 주지 않으므로 앱에서 직접 넣습니다.
2단계: Info.plist와 Capability | 시작하기 | Appbox iOS SDK 가이드
2단계: Info.plist와 Capability
Android와 함께 연동 중이라면 주의하세요. Android에서는 SDK가 매니페스트에 권한을 선언하므로, iOS에서만 이 단계가 앱의 몫입니다.
| 키 | 필요한 기능 |
|---|---|
NSCameraUsageDescription | openQRCodeScanner, openBarcodeScanner |
NSFaceIDUsageDescription | biometricAuth (Face ID) |
NSLocationWhenInUseUsageDescription | getLocationCurrent |
NSHealthShareUsageDescription | 걸음 수 |
LSApplicationQueriesSchemes | openApp: 실행할 앱의 scheme을 배열로 등록 |
2단계: Info.plist와 Capability
Text
1
<key>NSCameraUsageDescription</key>
2
<string>QR 코드와 바코드 스캔에 카메라를 사용합니다.</string>
3
4
<key>LSApplicationQueriesSchemes</key>
5
<array>
6
<string>instagram</string> <!-- openApp으로 실행할 앱의 scheme -->
7
</array>
LSApplicationQueriesSchemes에 등록하지 않으면 iOS가 scheme 조회를 차단합니다. 대상 앱이 설치돼 있어도 openApp이 App Store로 이동합니다.
연락처 기능은 사용 목적 문자열이 필요 없습니다. SDK가 OS의 연락처 선택 화면을 사용하므로 앱이 주소록을 직접 읽지 않습니다.
Capability
| 기능 | 앱 target에 추가할 것 |
|---|---|
| 푸시 | Push Notifications |
| 사일런트 푸시, 백그라운드 처리 | Background Modes → Remote notifications |
| 걸음 수 | HealthKit |
| 푸시 이미지(NSE) | 앱과 NSE target에 같은 App Groups |
NSAllowsArbitraryLoads = true를 기본으로 켜지 말고, 불가피한 HTTP 도메인이 있으면 그 도메인만 예외로 선언하세요. 이 안내는 SDK를 직접 붙이는 앱 기준입니다. 앱박스 클라우드 빌드로 만든 앱은 기존 사이트 호환을 위해 NSAllowsArbitraryLoads = true가 켜진 채 빌드되므로 따로 설정할 것이 없습니다.