Манифест приватности PrivacyInfo.xcprivacy. Что в него записать и когда он нужен

Что лежит в файле PrivacyInfo.xcprivacy

Манифест приватности это список свойств (property list) с четырьмя ключами верхнего уровня. Свой манифест бывает у приложения и у каждого стороннего SDK, будь то XCFramework, Swift Package или проект Xcode.

• NSPrivacyTracking. Да или нет, отслеживает ли код людей в том смысле, который Apple вкладывает в App Tracking Transparency.
• NSPrivacyTrackingDomains. Домены, которые занимаются отслеживанием. Пока человек не дал согласия, запросы к ним система не пропускает, и приложение получает ошибку.
• NSPrivacyCollectedDataTypes. Какие типы данных собраны, связаны ли они с человеком, идут ли на отслеживание и с какой целью. Это нужно на всех платформах.
• NSPrivacyAccessedAPITypes. Группы системных функций, которым нужна заявленная причина, и коды причин. Это нужно на iOS, iPadOS, tvOS, visionOS и watchOS.

Причины Apple спрашивает потому, что метки времени файлов, свободное место на диске или время с загрузки системы годятся для отпечатка устройства (fingerprinting). Такой сбор Apple запрещает, даже если человек разрешил отслеживание.

Где манифест в Xcode

Файл создают через File › New › File. В разделе Resource выберите тип App Privacy File, нажмите Next, отметьте цель приложения и нажмите Create. Xcode назовёт файл PrivacyInfo.xcprivacy, и это имя обязательно.

Файл должен входить в ресурсы цели, иначе Xcode не возьмёт его в отчёт. В готовом приложении для iPhone он лежит в корне пакета рядом с Info.plist, у приложения для Mac в папке Contents/Resources. В Swift Package манифест сам ресурсом не считается, его объявляют явно, например .process("PrivacyInfo.xcprivacy").

Сроки и числа Apple

Что	Как у Apple
Впервые показан	на WWDC23, в 2023 году, вместе с подписями SDK
Причины для вызовов в коде приложения	обязательны с 1 мая 2024 года, без них App Store Connect не принимает загрузку
SDK из списка Apple	с 1 мая 2024 года нужен его манифест, если новое приложение или обновление добавляет такой SDK, и подпись, если он подключён готовым бинарным файлом
Проверка правильности файла	с 12 ноября 2024 года, при ошибке приходит письмо ITMS-91056 с путём к файлу
Правильный манифест у популярных SDK	обязателен с 12 февраля 2025 года
SDK в списке Apple	86 названий, от Abseil и Alamofire до Flutter и webview_flutter_wkwebview
Ключей верхнего уровня	4
Групп вызовов с заявленной причиной	5, метки времени файлов, время с загрузки системы, место на диске, активные клавиатуры и UserDefaults

По данным документации Apple о манифестах, списка SDK, TN3181 и новости Apple от 07.12.2023, проверено 16.10.2026. SDK мы посчитали по списку Apple.

Как добавить манифест по шагам

1. Создайте PrivacyInfo.xcprivacy в цели приложения через File › New › File › App Privacy File.
2. Если приложение не отслеживает людей, поставьте NSPrivacyTracking в NO. Если отслеживает, поставьте YES и перечислите домены в NSPrivacyTrackingDomains, без пути и косой черты в конце.
3. В NSPrivacyCollectedDataTypes опишите каждый собранный тип данных. Значения берите только из списка Apple, на собственных названиях типов и целей отчёт Xcode собирается неправильно.
4. Найдите в коде вызовы из пяти групп. Частый случай это UserDefaults, на нём же работает @AppStorage в SwiftUI. Если данные читает и пишет только само приложение, подходит причина CA92.1.
5. Обновите SDK до версий со своим манифестом. Данные SDK в ваш файл не переносят, каждый SDK описывает себя сам.
6. Соберите архив через Product › Archive, в Organizer нажмите на него с клавишей Control и выберите Generate Privacy Report. Xcode сохранит PDF, по которому удобно заполнять анкету App Privacy.

Частые ошибки

• Файл не в ресурсах цели. Тогда Xcode не видит манифест, когда собирает отчёт, и ваших данных в PDF нет.
• Свои значения вместо значений Apple. Неизвестный ключ, неверный тип или домен с путём делают манифест неправильным, и App Store Connect присылает письмо ITMS-91056 с именем и путём файла.
• Копировать данные SDK в свой манифест. Apple ждёт, что сторонний SDK опишет себя сам, а приложение только свой код. При этом за весь код SDK внутри приложения отвечаете вы.
• Править чужой манифест в архиве и забыть о подписи. Неправильный файл из SDK можно поправить или удалить в архиве, но подпись архива после этого ломается. Выгружайте такую сборку из Organizer, Xcode подпишет её заново.

Отчёт о приватности перед анкетой App Privacy

Отчёт Xcode сводит манифесты приложения и всех подключённых SDK в один PDF, разбитый так же, как этикетка приватности в App Store. Apple советует держать его под рукой, когда вы отвечаете на вопросы App Privacy.

Агент Appto собирает приложение на SwiftUI в проекте Xcode, а анкету App Privacy в App Store Connect Appto заполняет сама и перед записью ждёт вашего «да». Подробнее на странице о работе с App Store Connect.