Перейти к содержанию

Установка сборки на iOS

Apple ограничивает установку .ipa — нужен правильный профиль подписи, зарегистрированное устройство и браузер Safari. Если хотя бы одно условие не выполнено, iOS откажет в установке без объяснения причины.

Причины ошибок установки

Несовпадение Bundle ID

Bundle ID — уникальный идентификатор приложения (например, com.company.myapp). Если Bundle ID в .ipa не совпадает с App ID в профиле — iOS отклонит установку. Любое расхождение — лишняя точка, разный регистр — приведёт к ошибке.

Как исправить:

Сверьте Bundle ID в трёх местах: Xcode, Provisioning Profile и PWS. Если есть расхождение — исправьте и пересоберите .ipa.

Проверяйте Bundle ID до сборки

Убедитесь, что Bundle ID совпадает во всех трёх местах до создания .ipa. Исправление после сборки требует пересоздания файла. Подробнее — в документации Apple.

UDID устройства отсутствует в профиле

Ad Hoc Provisioning Profile содержит фиксированный список UDID устройств, на которые разрешена установка. Если UDID устройства тестировщика не добавлен — установка невозможна.

Как исправить:

Получите UDID устройства и добавьте его в Apple Developer Portal. Если у вас нет доступа — отправьте UDID администратору или разработчику. После добавления устройства обновите Provisioning Profile и пересоберите .ipa. Подробнее — в документации Apple.

Неверный тип профиля

Для распространения через PWS App Distribution нужен профиль типа Ad Hoc. Если используется профиль типа Development или App Store — установка не будет работать.

Как исправить:

Проверьте тип профиля в Apple Developer Portal. Если он не Ad Hoc — создайте новый и пересоберите .ipa.

Просроченные сертификаты

Provisioning Profile привязан к сертификату подписи (Apple Distribution Certificate). Если сертификат истёк или был отозван — профиль становится недействительным, а сборки перестают устанавливаться.

Как исправить:

Проверьте статус сертификата в Apple Developer Portal. Если сертификат истёк — создайте новый, обновите Provisioning Profile и пересоберите .ipa.

Срок действия сертификатов

Apple Distribution Certificate действует 1 год. Отслеживайте дату истечения и обновляйте сертификат заранее.

Если сборка всё ещё не устанавливается

Если вы проверили все пункты выше, но установка не проходит:

  1. Убедитесь, что открываете ссылку на установку в Safari — другие браузеры не поддерживают установку .ipa
  2. Перейдите в Настройки → Основные → VPN и управление устройством и проверьте, доверяет ли устройство сертификату разработчика
  3. Убедитесь, что на устройстве достаточно свободного места
  4. Удалите предыдущую версию приложения и установите заново
  5. Проверьте, что версия iOS на устройстве соответствует минимальной версии в сборке (Minimum Deployment Target)

См. также