Манифест конфиденциальности для приложений iOS

В чём проблема

Требования Apple к отправке приложений в App Store изменились весной 2024 года. App Store Connect больше не принимает приложения, в манифестах конфиденциальности которых не указана причина использования API, для которых требуется указать причину.

Это автоматическая проверка, а не ручная модерация: код вашего приложения анализируется, после чего вы получаете список проблем по электронной почте. В письме будет указана проблема «ITMS-91053: Missing API declaration» и перечислены все категории API, используемые в приложении и относящиеся к категории API, для использования которых требуется указать причину.

В идеале все используемые приложением SDK предоставляют собственный манифест конфиденциальности, и вам не о чем беспокоиться. Но если некоторые зависимости этого не делают, отправка приложения в App Store может быть отмечена как проблемная.

Как решить проблему

После попытки отправить приложение и получения от App Store подробного списка проблем вы можете создать манифест, следуя документации Apple:

• Обзор файлов манифеста конфиденциальности

• Описание использования данных в манифестах конфиденциальности

• Описание использования API, для которых требуется указать причину

В результате получится файл, представляющий собой набор словарей. Для каждого типа используемого API выберите одну или несколько причин его использования из предложенного списка. Xcode упрощает редактирование файлов .xcprivacy, предоставляя визуальное представление и раскрывающиеся списки допустимых значений для каждого поля.

Чтобы найти места использования API, для которых требуется указать причину, в зависимостях вашего фреймворка Kotlin, можно воспользоваться специальным инструментом, а чтобы добавить файл .xcprivacy к артефактам Kotlin — отдельным плагином.

Если новый манифест конфиденциальности не поможет выполнить требования App Store или вы не сможете разобраться, как пройти все шаги, свяжитесь с нами и опишите свой случай в этой задаче YouTrack.

Поиск мест использования API, для которых требуется указать причину

Код Kotlin в вашем приложении или одной из его зависимостей может обращаться к API, для которых требуется указать причину, из таких библиотек, как platform.posix, например fstat:

import platform.posix.fstat

fun useRequiredReasonAPI() {
    fstat(...)
}

В некоторых случаях бывает сложно определить, какие зависимости используют API, для которого требуется указать причину. Чтобы помочь найти их, мы создали простой инструмент.

Чтобы воспользоваться им, выполните следующую команду в каталоге, где в проекте объявлен фреймворк Kotlin:

/usr/bin/python3 -c "$(curl -fsSL https://github.com/JetBrains/kotlin/raw/rrf_v0.0.1/libraries/tools/required-reason-finder/required_reason_finder.py)"

Вы также можете отдельно скачать этот скрипт, изучить его и запустить с помощью python3.

Добавление файла .xcprivacy в артефакты Kotlin

Если вам нужно включить файл PrivacyInfo.xcprivacy в артефакты Kotlin, используйте плагин apple-privacy-manifests:

plugins {
    kotlin("multiplatform")
    kotlin("apple-privacy-manifests") version "1.0.0"
}

kotlin {
    privacyManifest {
        embed(
            privacyManifest = layout.projectDirectory.file("PrivacyInfo.xcprivacy").asFile,
        )
    }
}

Плагин скопирует файл манифеста конфиденциальности в соответствующее место в выходных данных.

Известные случаи использования