App Store Connect 오류 해결: Push Notifications 권한 누락 문제

cheshire0105·2025년 1월 1일

iOS

목록 보기

26/45

App Store Connect 오류 해결: Push Notifications 권한 누락 문제

App Store Connect에서 발생할 수 있는 ITMS-90078: Missing potentially required entitlement 오류에 대해 설명하고, 이를 해결하는 방법을 안내한다.

오류 내용

최근 앱 제출 시 다음과 같은 오류 메시지를 받았다:

ITMS-90078: Missing potentially required entitlement - Your app, or a library that’s included in your app, uses Apple Push Notification service (APNs) registration APIs, but the APS Environment Entitlement isn’t included in the app signature’s entitlements. If your app uses APNs, make sure the App ID is enabled for push notifications in Certificates, Identifiers & Profiles, sign the app with a distribution provisioning profile that includes the APS Environment Entitlement, and upload a new build to ensure that push notifications function as intended. For details, visit: https://developer.apple.com/documentation/usernotifications/registering-your-app-with-apns.

이 오류는 앱이 Apple Push Notification service(APNs) 등록 API를 사용하고 있으나, 앱 서명에 필요한 APS Environment 권한이 포함되지 않았음을 의미한다. 이로 인해 푸시 알림 기능이 제대로 작동하지 않을 수 있다.

해결 방법

Xcode를 통해 간단히 Push Notifications 권한을 추가함으로써 이 문제를 해결할 수 있다. 다음 단계에 따라 진행한다.

1. Xcode에서 프로젝트 열기

먼저, 문제가 발생한 프로젝트를 Xcode에서 연다.

2. 타겟(Target) 설정으로 이동

프로젝트 내에서 Targets를 선택한 후, 해당 앱의 Runner(또는 앱 이름) 타겟을 선택한다.

3. Signing & Capabilities 탭 선택

상단 메뉴에서 Signing & Capabilities 탭으로 이동한다.

4. Capability 추가

좌측 하단의 + Capability 버튼을 클릭하여 새로운 기능을 추가한다.

5. Push Notifications 추가

목록에서 Push Notifications를 찾아 더블 클릭하거나 드래그하여 추가한다. 이렇게 하면 Push Notifications가 Signing 섹션 아래에 정상적으로 추가된다.

6. 앱 다시 빌드

모든 설정이 완료되면 프로젝트를 다시 빌드하여 변경 사항을 반영한다. 이후 새로운 빌드를 App Store Connect에 업로드한다.

추가 고려 사항

Swift로 앱을 개발할 때, 실제로 앱 내에서 푸시 알림을 사용하지 않더라도 사용된 라이브러리나 패키지에 따라 푸시 알림 설정이 필요할 수 있다. 이러한 경우, 푸시 알림 권한을 누락하게 되면 App Review 과정에서 앱이 거부될 수 있다. 따라서 이메일을 통해 전달되는 오류 메시지는 꼼꼼히 확인하고, 필요한 권한을 정확히 설정하는 것이 중요하다.

결론

ITMS-90078 오류는 Push Notifications 권한이 누락되어 발생하는 문제로, Xcode에서 간단히 설정을 추가함으로써 해결할 수 있다. Swift로 개발된 앱이라도 이러한 권한 설정을 정확히 해두면 App Store 배포 과정에서 발생할 수 있는 불필요한 문제를 예방할 수 있다. 항상 App Store Connect에서 전달되는 오류 메시지를 주의 깊게 확인하고, 필요한 조치를 취하는 습관을 들이는 것이 좋다.