TestFlight - Публикация

Краткое содержание

При возникновении ошибок TestFlight следуйте этим шагам по порядку:

1. Проверьте статус соглашений - Убедитесь, что все соглашения (особенно Соглашение о платных приложениях) активны
2. Проверьте бета-информацию - Заполните тестовую информацию в настройках TestFlight
3. Проверьте статус сборки - Убедитесь, что сборка обработана и доступна для тестирования
4. Удалите и снова добавьте сборку в группы - Иногда помогает обновить соединение
5. Выйдите и войдите в Media & Purchases - Исправляет проблемы синхронизации аккаунта на устройстве
6. Проверьте приглашения по email - Примите приглашения TestFlight по электронной почте
7. Проверьте совместимость устройства - Убедитесь, что вы тестируете на правильном типе устройства
8. Обратитесь в поддержку Apple - Если ничего не помогает

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

Ошибка 1: BETA_CONTRACT_MISSING

Сообщение об ошибке:

{
  "errors" : [ {
    "id" : "e98ea35a-36f8-4c26-8a04-40663800b69c",
    "status" : "422",
    "code" : "ENTITY_UNPROCESSABLE.BETA_CONTRACT_MISSING",
    "title" : "Beta contract is missing for the app.",
    "detail" : "Beta Contract is missing."
  } ]
}

Что это означает: Эта ошибка 422 Unprocessable Entity указывает на то, что владелец аккаунта вашей команды разработчиков Apple не подписал необходимое юридическое соглашение. Apple требует активные подписанные контракты перед тем, как вы сможете:

• Распространять сборки в TestFlight (бета-тестирование)
• Добавлять новых бета-тестеров
• Отправлять приложение на проверку

Решение:

1. Владелец аккаунта должен войти в систему

   • Только владелец аккаунта может принять эти соглашения (не администратор или разработчик)
   • Войдите в App Store Connect

2. Проверьте страницу соглашений

   • Перейдите в раздел "Agreements, Tax, and Banking" (Соглашения, налоги и банковские реквизиты)
   • Найдите ожидающие соглашения в разделе "Agreements in Effect" или "Pending Agreements"

3. Частая проблема: Соглашение о платных приложениях ожидает

   • Даже для бесплатных приложений Apple требует, чтобы Соглашение о платных приложениях было активным для TestFlight
   • Если статус показывает "Pending User Info", вам нужно добавить банковскую информацию
   • Нажмите "Add Bank Account" (Добавить банковский счёт) и заполните банковские реквизиты
   • После добавления статус должен измениться с "Pending User Info" на "Active"

4. Дождитесь распространения изменений
   • После подписания соглашений подождите несколько минут, чтобы изменения вступили в силу
   • Попробуйте выполнить запрос снова

Примечание: Существует связь между TestFlight и требованиями к банковскому счёту. Даже только для внутреннего тестирования Apple требует, чтобы Соглашение о платных приложениях было активным, что требует банковской информации.

Ошибка 2: Отсутствует описание бета-версии приложения

Сообщение об ошибке:

Failure: POST https://api.appstoreconnect.apple.com/v1/betaAppReviewSubmissions 
returned 422: Beta App Description is missing. 
- Beta App Description is required to submit a build for external testing.

Что это означает: При отправке сборки для внешнего тестирования TestFlight Apple требует заполнить тестовую информацию (Описание бета-версии приложения).

Решение:

1. Перейдите в App Store Connect → вкладка TestFlight
2. Выберите ваше приложение
3. Перейдите в раздел Test Information (Тестовая информация)
4. Заполните все обязательные поля:
   • What to Test (Что тестировать)
   • Beta App Description (Описание бета-версии приложения)
   • Feedback Email (Email для обратной связи, опционально, но рекомендуется)
   • Marketing URL (Маркетинговый URL, опционально)
   • Privacy Policy URL (URL политики конфиденциальности, если требуется)

5. Сохраните информацию
6. Попробуйте снова отправить сборку для внешнего тестирования

Ошибка 3: "App Not Available" или "Запрошенное приложение недоступно или не существует"

Сообщение об ошибке: Приложение показывается как недоступное или не существует, когда тестеры пытаются его установить.

Что это означает: Обычно это проблема синхронизации между App Store Connect и приложением TestFlight на устройстве.

Решения (пробуйте по порядку):

Решение 1: Проверьте приглашение по email

Даже если вы владелец аккаунта, если вы добавили себя в тестовую группу, вы должны получить приглашение по email:

1. Проверьте вашу почту (ту, что связана с вашим Apple ID)
2. Найдите письмо от TestFlight с темой "You're invited to test [App Name]" (Вас пригласили протестировать [Название приложения])
3. Нажмите кнопку "Accept" (Принять) или "View in TestFlight" (Открыть в TestFlight) в письме
4. Это официально свяжет ваш Apple ID со слотом тестера

Решение 2: Выйдите из Media & Purchases

Apple ID для App Store может отличаться от вашего основного iCloud ID. Именно он важен для TestFlight:

1. На вашем iPhone перейдите в Настройки
2. Нажмите на ваше имя вверху
3. Нажмите Media & Purchases (Медиа и покупки)
4. Появится всплывающее окно. Нажмите Sign Out (Выйти)
5. Подождите несколько секунд
6. Снова нажмите Media & Purchases и войдите обратно с вашим Apple ID
7. Откройте приложение TestFlight - оно должно обновиться и показать приложение

Решение 3: Удалите и снова добавьте сборку в группы

Принудительно заставьте App Store Connect повторно отправить данные о доступности:

1. Перейдите во вкладку TestFlight в App Store Connect
2. Выберите вашу сборку (например, версия 2.0.2, сборка 14)
3. В разделе Groups (Группы) нажмите красную иконку минуса (-), чтобы удалить сборку из текущей группы
4. Подождите 5-10 минут
5. Нажмите синюю иконку плюса (+), чтобы снова добавить сборку в вашу тестовую группу
6. Полностью закройте приложение TestFlight на вашем iPhone (смахните его вверх из переключателя приложений)
7. Снова откройте приложение TestFlight

Решение 4: Проверьте совместимость устройства

Если вы пытаетесь установить приложение для iPhone на Mac:

• Приложение TestFlight на Mac может видеть все сборки, но может устанавливать только приложения для macOS или iPad (на Mac с чипом Apple Silicon)
• Приложения только для iPhone должны устанавливаться из приложения TestFlight на iPhone

Проверьте информацию о вашей сборке - если deviceFamilies: ["IPHONE"], вы должны использовать iPhone.

Ошибка 4: Проблемы со статусом сборки

Понимание состояний сборки:

При проверке статуса вашей сборки вы можете увидеть:

{
  "processingState": "VALID",
  "internalBuildState": "IN_BETA_TESTING",
  "externalBuildState": "READY_FOR_BETA_SUBMISSION"
}

Что это означает:

• processingState: "VALID" - Ваша сборка в порядке
• internalBuildState: "IN_BETA_TESTING" - Доступна для внутренней команды
• externalBuildState: "READY_FOR_BETA_SUBMISSION" - Готова для внешнего тестирования (но требует отправки)

Для внутреннего тестирования: Если internalBuildState равен "IN_BETA_TESTING", вам не нужно отправлять на проверку:

1. Перейдите во вкладку TestFlight в App Store Connect
2. Выберите ваше приложение
3. Нажмите на вашу внутреннюю тестовую группу (часто называется "Internal Group" или "App Store Connect Users")
4. Нажмите кнопку "+", чтобы добавить вашу сборку в эту группу
5. Внутренние тестеры должны затем получить уведомления

Для внешнего тестирования: Если вы хотите внешнее тестирование, вам нужно:

1. Убедиться, что заполнено описание бета-версии приложения (см. Ошибку 2)
2. Убедиться, что все соглашения активны (см. Ошибку 1)
3. Отправить сборку на внешнюю бета-проверку

Общие шаги по устранению неполадок

При возникновении любой проблемы с TestFlight следуйте этим шагам систематически:

Шаг 1: Проверьте Inspector на ошибки API

Если вы получаете неясную ошибку при попытке опубликовать в TestFlight:

1. Откройте инструменты разработчика браузера (Inspector)
2. Перейдите на вкладку Network (Сеть)
3. Попробуйте выполнить действие, которое не работает
4. Найдите неудачные запросы с ответами об ошибках
5. Проверьте тело ответа на наличие подробных сообщений об ошибках

Это даст вам точный код ошибки и сообщение из API Apple.

Шаг 2: Проверьте статус соглашений

1. Войдите в App Store Connect
2. Перейдите в Agreements, Tax, and Banking (Соглашения, налоги и банковские реквизиты)
3. Убедитесь, что все соглашения показывают статус "Active" (Активно)
4. Если какое-либо показывает "Pending User Info" (Ожидает информации пользователя), заполните требуемую информацию (обычно банковский счёт)
5. Подождите несколько минут, чтобы изменения распространились

Шаг 3: Проверьте бета-информацию

1. Перейдите в TestFlight → Ваше приложение
2. Проверьте раздел Test Information (Тестовая информация)
3. Убедитесь, что все обязательные поля заполнены:
   • What to Test (Что тестировать)
   • Beta App Description (Описание бета-версии приложения)
4. Сохраните, если вы внесли изменения

Шаг 4: Проверьте статус обработки сборки

1. Перейдите в TestFlight → Ваше приложение → Builds (Сборки)
2. Убедитесь, что ваша сборка показывает:
   • Обработка завершена
   • Статус: Готова для тестирования (или подобное)
3. Если сборка всё ещё обрабатывается, дождитесь завершения

Шаг 5: Удалите и снова добавьте сборку в группы

Иногда соединение между сборками и тестовыми группами рассинхронизируется:

1. Удалите сборку из всех тестовых групп
2. Подождите 5-10 минут
3. Снова добавьте сборку в соответствующие тестовые группы
4. Подождите ещё 5-10 минут
5. Попросите тестеров полностью закрыть и перезапустить приложение TestFlight

Шаг 6: Проверьте устройство и аккаунт

1. На iPhone:

   • Выйдите из Media & Purchases (Медиа и покупки) в Настройках
   • Войдите обратно с правильным Apple ID
   • Откройте приложение TestFlight

2. Проверьте email:

   • Найдите письма с приглашениями TestFlight
   • Примите любые ожидающие приглашения

3. Проверьте тип устройства:

   • Убедитесь, что вы тестируете на правильном устройстве (iPhone vs iPad vs Mac)
   • Проверьте deviceFamilies сборки для подтверждения совместимости

Шаг 7: Обратитесь в поддержку Apple

Если ни один из вышеперечисленных шагов не помог:

1. Перейдите на App Store Connect Support
2. Выберите "App Store Connect" в качестве темы
3. Укажите:
   • Название вашего приложения и bundle ID
   • Номер сборки и версию
   • Точные сообщения об ошибках
   • Шаги, которые вы уже попробовали
   • Скриншоты ошибок

Быстрый справочный чеклист

Перед отправкой в TestFlight убедитесь:

• Все соглашения активны (особенно Соглашение о платных приложениях)
• Банковская информация добавлена (если требуется)
• Описание бета-версии приложения заполнено в Тестовой информации
• Сборка завершила обработку
• Сборка добавлена в соответствующие тестовые группы
• Тестеры приняли приглашения по email
• Тестеры используют правильный тип устройства
• Тестеры вошли с правильным Apple ID в Media & Purchases

Резюме

Большинство проблем TestFlight возникают из-за:

1. Отсутствующих соглашений - Владелец аккаунта должен подписать все необходимые соглашения, включая добавление банковской информации
2. Отсутствующей бета-информации - Требуется для внешнего тестирования
3. Проблем синхронизации аккаунта - Выход/вход из Media & Purchases на устройстве
4. Синхронизации групп сборок - Удаление и повторное добавление сборок в группы
5. Совместимости устройства - Убедитесь в правильном типе устройства для приложения

Следование этим шагам по устранению неполадок по порядку должно решить большинство проблем TestFlight. Если проблемы сохраняются, обратитесь в поддержку Apple с подробной информацией об ошибках и шагах, которые вы уже попробовали.