STAR 프로젝트를 진행하며 Screen Time API를 사용하기 위해 권한 설정이 필요했다. 이에 참고할 만한 조언을 구하고자 다른 프로젝트를 진행 중인 Max에게 도움을 요청했다.

Max는 카메라 권한 설정 경험이 있는데, 이를 위해 Info.plist에 관련 키를 추가하는 것만으로 충분했다고 했다. 하지만 나는 Screen Time API의 경우 entitlements 파일을 추가로 설정해야 한다고 알고 있었기에, 두 권한 설정의 차이가 궁금해졌다.

Max님은 entitlements 파일에 대해 모르고 있어서, 덕분에 카메라 권한은 사용자의 동의만 받으면 충분하다는 것을 알게 되었다. 반면, Screen Time API는 애플 시스템과의 추가적인 인증이 필요하기 때문에 entitlements 파일이 반드시 필요하다는 점을 확인했다.

이번 조언과 비교를 통해 애플의 권한 관리 체계와 각 권한의 설정 방식에 대해 더욱 명확히 이해할 수 있었다.

---

.entitlements 파일 생성

entitlements 파일은 iOS와 macOS 앱에서 특정 시스템 기능이나 리소스에 접근할 권한을 선언하는 파일이다. 이 파일은 앱의 권한과 보안을 관리하기 위해 사용된다.

---

1. entitlements 파일이란?

entitlements는 앱이 특정 기능을 사용할 수 있도록 iOS 시스템에 권한을 알리는 설정 파일이다. 앱이 기본적으로 사용할 수 없는 민감한 기능이나 애플 서비스에 접근할 수 있도록 선언해야 하는 경우에 사용된다.

주요 사용 사례

• Push Notifications
• iCloud
• Background Modes
• App Groups
• HealthKit, HomeKit
• Screen Time (FamilyControls Framework)

이런 기능을 사용하려면 entitlements 파일을 통해 iOS 시스템에 권한을 요청해야 한다.

---

2. 왜 카메라 권한에서는 entitlements가 필요 없을까?

카메라와 같은 일반적인 사용자 권한은 Info.plist를 통해 설정한다.

카메라 권한 설정 방법

Info.plist에 키 추가

<key>NSCameraUsageDescription</key>
<string>이 앱은 사진 및 비디오 촬영을 위해 카메라 접근 권한이 필요합니다.</string>

이유

• 카메라 권한은 사용자의 동의를 받아야 하므로 시스템이 자동으로 권한을 처리한다.
• 시스템 리소스에 접근할 권한은 기본적으로 Info.plist로 처리된다.
• 따라서 entitlements 파일은 필요하지 않다.

---

3. entitlements가 필요한 경우

entitlements는 시스템 권한을 넘어서 특수 기능에 접근하거나, 애플 개발자 계정과 연결된 권한이 필요한 경우에 사용된다.

주요 사용 사례

1. Push Notifications
   • 푸시 알림을 보내기 위해 애플 서버와의 인증 필요.
2. iCloud
   • iCloud 데이터 동기화 권한 설정.
3. Background Modes
   • 앱이 백그라운드에서 작업을 수행하려면 설정 필요.
4. Screen Time API
   • FamilyControls Framework로 스크린타임 데이터를 접근할 때 필요.

비교

기능	Info.plist	entitlements
카메라 접근	필요 (NSCameraUsageDescription)	필요하지 않음
Push Notifications	필요하지 않음	필요 (aps-environment)
iCloud	필요하지 않음	필요 (com.apple.developer.icloud-services)
Screen Time API	필요 (NSFamilyControlsUsageDescription)	필요 (com.apple.developer.family-controls)

---

4. Entitlements 파일 생성 및 설정 방법

1. 파일 생성 (파일구조에 따라 다름 주의 ⚠️)

1. App 폴더 선택
   • AppDelegate와 Info.plist가 있는 App 폴더를 선택.
2. Entitlements 파일 생성
   • Xcode에서 App 폴더 우클릭 → New File... 선택.
   • iOS > Resource > Empty를 선택 후, 파일 이름을 App.entitlements로 지정.

2. 권한 설정 추가

생성된 파일에 필요한 설정 추가

<key>com.apple.developer.family-controls</key>
<true/>

나는 Family Controls가 필요하므로 선택 후 Type Boolean에 Yes를 선택했다.

3. Signing & Capabilities 확인

1. Xcode에서 Targets > Signing & Capabilities 탭으로 이동.

2. Entitlements 파일이 자동으로 연결되었는지 확인.

3. 연결되지 않았다면, Code Signing Entitlements에 App.entitlements 파일 경로를 수동으로 추가.

4. Info.plist 설정

Screen Time API를 사용하려면 Info.plist에 아래 키를 추가

<key>NSFamilyControlsUsageDescription</key>
<string>이 앱은 스크린타임 데이터에 접근하기 위해 권한이 필요합니다.</string>

---

결론

• 카메라 권한은 Info.plist를 통해 설정하고, Screen Time API 같은 특수 기능은 entitlements 파일이 필요하다.
• entitlements 파일은 애플 시스템과의 추가적인 인증과 권한이 필요한 경우에 사용된다.