iOS 개인정보 보호 매니페스트 누락 시 어떻게 해야 할까? 2026 아카이브 점검
ITMS-91061 등 개인정보 보호 매니페스트 알림을 받은 iOS 개발자와 소규모 팀을 위한 진단 안내입니다. 앱 자체 파일과 서드파티 SDK 문제, 누락과 형식 오류를 구분하고, 수정한 파일이 최종 아카이브에 포함됐는지 확인하는 절차를 설명합니다.
목차
Apple은 앱 또는 서드파티 SDK의 개인정보 보호 매니페스트 파일명을 PrivacyInfo.xcprivacy로 지정합니다. 이번 주에는 App Store Connect 알림의 오류 코드와 파일 경로로 책임 구성 요소를 먼저 가른 뒤, 수정한 파일이 최종 아카이브에 들어갔는지 확인하고 다시 업로드 검증하세요. SDK의 내용을 앱 매니페스트에 임의로 옮기는 방식은 피해야 합니다.
이 글은 ITMS-91061 또는 비슷한 매니페스트 알림을 받은 독립 개발자, CocoaPods·Swift Package·XCFramework 의존성을 관리하는 소규모 팀을 위한 안내입니다.
원격 맥이나 CI에서 Xcode 아카이브와 제출을 점검하는 개발자도 최종 산출물 검증 절차를 정리할 수 있습니다.
iOS 개인정보 보호 매니페스트 누락 진단
알림에 적힌 코드만으로 바로 파일을 추가하지 마세요. 먼저 알림 문구와 구성 요소 경로를 함께 읽어야 합니다. Apple의 서드파티 SDK 매니페스트 요구 사항은 해당 SDK 자체에 매니페스트가 필요한 상황을 설명합니다. 반면 TN3181은 매니페스트가 있지만 유효하지 않은 경우의 점검 자료입니다.
| 증상 또는 증거 | 우선 확인할 곳 | 수정 책임 | 판정 신뢰도 |
|---|---|---|---|
| 알림 경로가 앱 번들을 가리키고 파일이 없음 | 앱 타깃과 아카이브 안 앱 번들 | 앱 프로젝트 담당자 | 아카이브에서 경로를 확인하면 높음 |
| 경로가 내장 프레임워크나 SDK를 가리키고 파일이 없음 | 실제로 포함된 SDK와 버전 | SDK 제공자 또는 의존성 담당자 | 경로와 의존성 버전이 맞으면 높음 |
| 파일은 있지만 유효하지 않다는 알림이 표시됨 | plist 구조, 키 유형, 필수 값과 허용 값 | 파일을 배포하는 주체 | TN3181 기준으로 검증하면 높음 |
| 업로드 상태는 확인됐지만 심사 결과가 아직 없음 | App Store Connect 제출 상태 | 제출 담당자 | 업로드 상태만으로 심사 결과를 판단할 수 없음 |
여기서 신뢰도는 성능 점수가 아니라 책임 구성 요소를 특정할 수 있는 증거의 정도입니다. 알림의 파일 경로가 실제 아카이브 속 번들과 일치하지 않으면, 의존성 버전이나 빌드 입력이 달라졌는지도 확인해야 합니다.
앱 타깃과 패키지 경로 확인
프로젝트 탐색기에 파일이 보이는 것과 최종 앱 패키지에 파일이 포함되는 것은 다른 상태입니다. Apple은 앱 또는 서드파티 SDK에 매니페스트를 추가하는 안내에서 매니페스트를 대상 번들에 포함하는 방식을 설명합니다.
다음 순서로 앱 자체 파일을 확인하세요.
- Xcode에서 앱 타깃의 빌드 입력을 확인하고
PrivacyInfo.xcprivacy가 해당 타깃에 포함됐는지 살펴봅니다. - 파일이 프로젝트 폴더에만 존재하는지, 타깃의 리소스로 설정됐는지 구분합니다.
- 문제를 재현한 뒤 새로 만든
.xcarchive를 열어Products/Applications아래의 앱 번들을 확인합니다. - 앱 번들 안에서
PrivacyInfo.xcprivacy를 찾고, 알림에 표시된 경로와 위치가 일치하는지 대조합니다. - 파일이 없거나 내용이 이전 버전이면 빌드 설정과 입력 파일을 바로잡고 새 아카이브를 만듭니다.
필요하면 터미널에서 다음 명령으로 매니페스트 파일의 실제 위치를 확인할 수 있습니다.
find "/아카이브 경로/Products/Applications" -name PrivacyInfo.xcprivacy -print
검색 결과가 나오더라도 파일이 올바른 번들에 들어갔는지까지 확인해야 합니다. 다른 앱이나 오래된 아카이브에서 발견된 파일은 현재 제출물을 증명하지 못합니다.
서드파티 SDK의 책임과 수정 경계
알림 경로가 프레임워크나 SDK를 가리킨다면, 앱 자체 매니페스트를 수정하기 전에 해당 의존성의 출처와 실제 포함 버전을 찾으세요. 패키지 관리 화면의 버전만 보지 말고, 아카이브 속 프레임워크가 프로젝트에서 선택한 버전과 일치하는지도 확인해야 합니다. 의존성 갱신 과정에서 예전 바이너리가 남아 있거나 다른 경로의 SDK가 포함될 수 있기 때문입니다.
SDK 자체에 필요한 매니페스트가 없다면 SDK 제공자가 배포한 수정 버전을 확인하고, 사용할 버전으로 의존성을 갱신한 뒤 다시 아카이브하세요. Apple의 요구 SDK 안내를 근거로 SDK 제공자에게 문의할 수도 있습니다. 앱이 직접 사용하는 필수 사유 API와 데이터 처리 정보는 앱 자체 기준으로 작성해야 합니다. Apple의 필수 사유 API 설명을 확인하고, SDK의 내용을 근거 없이 앱 쪽에 복사하지 마세요.
형식 오류와 값 오류 구분
매니페스트가 존재하는데도 거부된다면 파일 유무보다 구조와 내용에 집중하세요. Apple의 무효한 매니페스트 점검 기술 문서는 형식과 값 문제를 찾아가는 기준을 제공합니다.
- 파일 형식: plist로 읽을 수 있는지, 잘못된 문법이나 손상된 파일은 없는지 확인합니다.
- 키와 유형: 키 이름이 올바른지, 값이 요구되는 데이터 유형과 일치하는지 점검합니다.
- 필수 항목과 허용 값: Apple 문서가 요구하는 항목과 허용된 값을 따릅니다.
- 필수 사유 API: 앱이나 SDK가 사용하는 API와 연결된 사유가 실제 사용에 맞는지 확인합니다.
근거 없이 추적 도메인이나 API 사용 사유를 덧붙이면 오류를 해결하는 대신 잘못된 선언을 만들 수 있습니다. 어떤 값이 필요한지 확신하기 어렵다면 Apple 문서와 SDK 제공자의 공식 설명을 먼저 대조하세요.
업로드 검증과 심사 결과의 구분
수정 후에는 새 아카이브를 만들고, 앞서 확인한 앱 및 SDK 경로에서 파일과 내용이 바뀌었는지 다시 검사합니다. 예전 아카이브를 재사용하면 프로젝트 수정이 제출 산출물에 반영되지 않을 수 있습니다. 매니페스트가 예상 경로에 있고 SDK 버전도 맞는 것을 확인한 다음, 그 아카이브를 대상으로 업로드 검증을 진행하세요.
App Store Connect의 빌드 업로드 상태 안내는 업로드 처리 상태를 확인할 때 참고할 수 있습니다. 업로드 검증이 통과했다는 사실은 해당 제출 단계의 결과이지, 앱 심사가 승인됐다는 뜻은 아닙니다. 심사 진행 여부는 별도의 앱 및 제출 상태 안내에서 확인하세요.
자주 묻는 질문
ITMS-91061 알림의 첫 확인 지점
App Store Connect 알림의 코드와 경로를 함께 확인하세요. 경로가 앱 번들을 가리키면 앱 타깃과 최종 산출물을 살펴보고, 프레임워크 경로라면 해당 SDK의 실제 버전과 패키징 상태를 추적합니다. 알림에 나온 구성 요소를 찾지 못하면 의존성 선택이나 빌드 입력이 달라졌는지 확인한 뒤, 최신 아카이브에서 경로를 다시 대조하세요.
매니페스트가 없는 서드파티 SDK 처리
알림 경로로 SDK 이름과 포함 버전을 확인한 뒤, SDK 제공자의 수정 버전과 공식 안내를 찾으세요. SDK 자체에 필요한 파일은 앱 개발자가 임의로 내용을 추정해 대체하지 말고, 제공된 수정 버전으로 교체하는 편이 안전합니다. 갱신한 뒤에는 프로젝트 표시만 믿지 말고 새 아카이브 안의 SDK 경로에서 매니페스트 존재 여부를 다시 확인하세요.
최종 아카이브에서 파일 확인
최신 .xcarchive의 앱 번들과 내장 프레임워크를 각각 살펴보세요. find 명령으로 PrivacyInfo.xcprivacy의 위치를 찾은 다음 알림에 적힌 구성 요소 및 경로와 비교할 수 있습니다. 파일이 발견됐다는 것만으로 끝내지 말고, 수정한 파일이 맞는지와 올바른 번들에 포함됐는지도 확인하세요. 검사를 마친 바로 그 아카이브로 업로드 검증을 진행합니다.
누락과 형식 오류의 차이
누락은 필요한 파일이 해당 번들에 없거나 빌드 산출물에 포함되지 않은 상태입니다. 형식 오류는 파일은 존재하지만 plist 구조, 키 유형, 필수 항목 또는 허용 값이 요구 조건에 맞지 않는 상태입니다. 먼저 아카이브에서 파일의 위치를 확인하고, 파일이 있다면 Apple의 TN3181을 따라 내용을 점검하세요. 두 문제는 수정 대상과 해결 순서가 다릅니다.
원격 맥 재현이 필요한 경우
문제 확인을 개인 맥 한 대에만 맡기면 팀원이 같은 의존성을 받아도 어떤 파일이 실제로 아카이브에 들어갔는지 공유하기 어려울 수 있습니다. 반대로 별도의 맥을 상시 운영하면 장비 관리와 업데이트, 보관 공간을 직접 챙겨야 합니다. 간헐적인 재현이나 제출 검증이 목적이라면 원격 맥에서 동일한 프로젝트를 열어 의존성, 아카이브 경로, 업로드 상태를 기록하는 방법도 검토할 수 있습니다. 실제 환경과 접근 방식은 VPSMAC 안내에서 확인하고, 필요하다면 제공 노드 정보와 프로젝트 요구 조건을 대조하세요.
핵심은 알림 경로로 책임자를 정하고, SDK와 앱의 매니페스트를 섞지 않으며, 수정 사실을 최종 아카이브에서 증명하는 것입니다. 재현용 맥이 일시적으로 필요하다면 임대가 장비 구매보다 유연할 수 있지만, 지속적인 고부하 작업이나 물리 인터페이스가 필요한 프로젝트에는 직접 보유한 장비가 더 적합할 수 있습니다. 임시 재현 환경을 찾는다면 VPSMAC의 실제 환경 정보를 확인한 뒤, 현재 제출 절차를 그대로 검증할 수 있는지 판단하세요.
자주 묻는 질문
ITMS-91061 알림을 받으면 어디부터 확인해야 하나요?
먼저 App Store Connect 알림에서 오류 코드와 함께 표시된 구성 요소 이름, 파일 경로, 알림 문구를 확인합니다. 경로가 앱 번들을 가리키는지, 내장된 프레임워크나 SDK를 가리키는지에 따라 수정 주체가 달라집니다. 알림에 나온 이름을 프로젝트의 실제 의존성 및 아카이브 안 파일과 대조하세요. 소스 폴더에 파일이 있다는 사실만으로 제출 파일에 포함됐다고 판단하지 마세요.
서드파티 SDK에 PrivacyInfo.xcprivacy가 없으면 어떻게 하나요?
알림 경로를 기준으로 문제가 된 SDK의 실제 버전과 배포 형태를 확인한 다음, SDK 제공자가 공개한 수정 버전이나 안내를 확인합니다. 매니페스트가 SDK 자체에 필요한 경우에는 제공자가 올바른 파일을 포함한 버전을 배포해야 합니다. SDK의 데이터 수집 항목이나 필수 사유를 앱의 매니페스트에 임의로 복사해 대체하지 마세요. 수정 버전으로 교체한 뒤 아카이브 속 해당 SDK를 다시 검사합니다.
수정한 개인정보 보호 매니페스트가 최종 아카이브에 들어갔는지 어떻게 확인하나요?
Xcode가 만든 최신 아카이브를 열고 앱 번들과 내장 프레임워크의 실제 패키지 경로에서 PrivacyInfo.xcprivacy를 찾습니다. 파일이 발견되면 위치가 알림에 표시된 구성 요소와 일치하는지, 수정 내용이 반영됐는지도 확인합니다. 프로젝트 탐색기에 파일이 보이는지만 검사하면 타깃 포함 여부나 빌드 결과를 놓칠 수 있습니다. 확인한 아카이브를 대상으로 업로드 검증을 다시 실행하세요.
매니페스트 형식 오류와 파일 누락은 같은 문제인가요?
아닙니다. 누락은 제출 대상 번들에 필요한 파일이 없거나 패키지에 포함되지 않은 경우이고, 형식 오류는 파일은 있지만 구조, 값의 유형, 필수 항목 또는 허용 값이 Apple 규칙에 맞지 않는 경우입니다. 먼저 알림과 아카이브에서 파일 존재 여부를 확인하고, 파일이 있다면 Apple의 TN3181 안내에 따라 내용을 검증하세요. 원인에 맞춰 수정해야 같은 오류가 반복되지 않습니다.