ITMS-90683: як виправити Missing purpose string в Expo

ITMS-90683 це автоматична відмова Apple: вона приходить на e-mail невдовзі після надсилання білда, ще до будь-якої перевірки людиною. Вона означає, що у твоєму файлі Info.plist бракує фрази, яка пояснює, навіщо застосунку доступ до чутливих даних. Виправлення зводиться до двох дій: додати ключ, названий у повідомленні, до ios.infoPlist, а потім зробити новий білд.

Я отримав її на Solys, моєму будильнику з міні-іграми, через дані, які застосунок навіть не використовує. Ось що означає повідомлення, чому воно приходить і як його уникнути.

Що означає помилка ITMS-90683?

Повне повідомлення називається «ITMS-90683: Missing purpose string in Info.plist». У ньому сказано, що код твого застосунку звертається до API, яке працює з чутливими даними (фото, камера, мікрофон, геолокація, контакти), а твій Info.plist не містить відповідного ключа з описом. Повідомлення називає цей ключ, наприклад NSPhotoLibraryUsageDescription.

Ця фраза-опис називається «purpose string». Це текст, який iOS показує у вікні запиту дозволу. Apple пише про це у своїй документації щодо доступу до захищених ресурсів: App Review відхиляє застосунки, чий код звертається до цих ресурсів без purpose string.

Це не відмова рев'юера. Перевірка автоматична і спрацьовує під час доставки білда, до потрапляння на перевірку, як ITMS-91053 для маніфесту конфіденційності. Білд відкидається, і треба надіслати новий.

Чому Apple відмовляє, хоча твій застосунок не використовує ці дані

Саме це й дивує. Apple аналізує код, що міститься у твоєму білді, а не те, що застосунок робить насправді. Якщо бібліотека, яку ти підключаєш, містить звернення до фототеки, ключ вимагається, навіть якщо жоден екран ніколи не просить доступу до фото. Повідомлення Apple саме це уточнює: стороння бібліотека чи SDK може звертатися до цих API, і purpose string однаково обов'язковий.

Мій випадок, 26 вересня 2026 року. Прибираючи конфігурацію Solys, я видалив ключ NSPhotoLibraryUsageDescription, адже застосунок не торкається жодного фото. Наступний білд відхилили з ITMS-90683. Причина: дві бібліотеки Expo, які використовує застосунок, expo-image і expo-file-system, містять код, що звертається до фототеки. Попередній білд проходив, бо ключ ще був на місці.

Висновок: ключ опису не видаляють «бо ним не користуються». Його видаляють лише тоді, коли жодна бібліотека в білді більше не звертається до цього API.

Найпоширеніші ключі

• NSPhotoLibraryUsageDescription: читання або запис фото.
• NSPhotoLibraryAddUsageDescription: додавання фото без читання.
• NSCameraUsageDescription: камера.
• NSMicrophoneUsageDescription: мікрофон.
• NSLocationWhenInUseUsageDescription: геолокація під час використання.
• NSContactsUsageDescription: контакти.
• NSUserTrackingUsageDescription: рекламне відстеження (App Tracking Transparency).

Apple описує кожен ключ у документації, наприклад NSPhotoLibraryUsageDescription: він обов'язковий, щойно застосунок використовує API, яке читає чи записує у фототеку.

Як виправити ITMS-90683 у застосунку на Expo

1. Знайди ключ, названий у листі від Apple. Повідомлення дає його точну назву.
2. Додай його у свою конфігурацію, у ios.infoPlist, як вказано в документації Expo про дозволи:

{
  "expo": {
    "ios": {
      "infoPlist": {
        "NSPhotoLibraryUsageDescription": "Solys не має доступу до твоїх фото. Цей дозвіл ніколи не запитується."
      }
    }
  }
}

3. Зроби новий білд. Expo це уточнює: зміна Info.plist не проходить через віддалене оновлення, потрібен новий бінарник.
4. Надішли білд в Apple, а потім вибери його у своїй версії.

Пастка, якщо твій застосунок перекладено: файли локалізації перекладають ключ, але не оголошують його. Ключ спершу має існувати в ios.infoPlist (або в конфігурації відповідного плагіна). Інакше застосунок може впасти під час першого виклику.

Яку фразу написати, якщо застосунок не використовує ці дані?

Apple вимагає точного, корисного і конкретного опису. Якщо застосунок справді використовує дані, скажи одним реченням, навіщо: «Застосунок використовує камеру, щоб сканувати штрихкод твого квитка».

Якщо ключ потрібен лише через бібліотеку, Apple пропонує два рішення: написати фразу або прибрати код, що звертається до даних. Коли цей код у бібліотеці, просто прибрати його не вийде. Тож для Solys я написав правду: «Solys не має доступу до твоїх фото. Цей дозвіл ніколи не запитується». Це прагматичний вибір: наступний білд пройшов доставку, але я не можу обіцяти, що Apple завжди прийматиме таку фразу.

Як знайти відсутні ключі до надсилання

З кореня проєкту ця команда виводить файли бібліотек, чий iOS-код звертається до API, за якими найпильніше стежать:

grep -rlE "PHPhotoLibrary|AVCaptureDevice|CLLocationManager|CNContactStore|EKEventStore|ATTrackingManager" \
  node_modules/*/ios node_modules/@*/*/ios

Кожна назва відповідає типу даних: PHPhotoLibrary для фото, AVCaptureDevice для камери й мікрофона, CLLocationManager для геолокації, CNContactStore для контактів, EKEventStore для календаря, ATTrackingManager для відстеження. Для кожного результату перевір, що відповідний ключ опису є у твоїй конфігурації.

Ця сітка ловить випадки, з якими я стикався. Вона не замінює читання листа від Apple, який лишається єдиним надійним списком, як і для непублічних API в ITMS-90338. Після тієї відмови я роблю цю перевірку перед кожним білдом: вона займає кілька секунд, а відмова ITMS-90683 коштує білд і час на його повторення.

Як надіслати білд без неприємних сюрпризів

ITMS-90683 виправляється швидко, коли вмієш його читати, так само як ITMS-90725, що стосується версії Xcode. Відмови, які приходять далі, від рев'юера, потребують більше уваги: порядок дій описано на сторінці застосунок відхилено Apple, а найчастіші причини в статті чому Apple відхиляє застосунок.

Щоб перевірити все перед надсиланням, Apple Review Kit містить мій чекліст і скіли Claude Code, які переглядають твій проєкт. Якщо надсилання застрягло і ти хочеш живого погляду, забронюй годину зі мною: розберемо твій проєкт по відео, на твоєму екрані. А якщо готуєш свій перший реліз, пройди безкоштовну діагностику: вона розставить кроки по порядку і надішле тобі мій чекліст проти відмов Apple.

Поширені запитання

ITMS-90683 це відмова App Review?

Не в сенсі рев'юера-людини. Це автоматична перевірка білда під час доставки, до потрапляння на перевірку, як ITMS-90717 для іконки. Ніхто не відкривав твій застосунок. Білд відкидається: треба виправити Info.plist і надіслати новий.

Чому Apple вимагає ключ для даних, які мій застосунок не використовує?

Бо Apple аналізує код у білді, а не поведінку застосунку. Якщо вбудована бібліотека звертається до фототеки чи камери, ключ опису обов'язковий, навіть якщо жоден екран ніколи не просить такого доступу.

Чи можна виправити ITMS-90683 віддаленим оновленням?

Ні. Відсутній ключ знаходиться в Info.plist, який є частиною бінарника. Віддалене оновлення не змінює цей файл: треба зробити новий білд і надіслати його в Apple.

Куди додати NSPhotoLibraryUsageDescription у проєкті Expo?

У конфігурацію застосунку, у ios.infoPlist, з фразою, що описує використання. Деякі бібліотеки також мають окреме налаштування у своєму плагіні, яке може додавати інші ключі, наприклад фоновий режим. В обох випадках ключ має існувати в базовій конфігурації, а не лише у файлах перекладу.

Чи треба видаляти невикористані ключі опису?

Лише якщо жодна бібліотека в білді більше не звертається до відповідного API. Інакше наступне надсилання відхилять з ITMS-90683. Перш ніж видаляти ключ, пошукай назву API в iOS-коді своїх залежностей.