На этой странице
Видео: мобильные релизы0:39
Раздел «Приложения»
Раздел «Приложения»: добавьте приложение и загрузите первую сборку — из панели, CLI или CI.

Hangar собирает приложение прямо из репозитория — или принимает готовые .ipa для iOS и .aab для Android — проверяет сборку и отправляет её в App Store Connect или Google Play, а потом следит за ревью. AI-ревьювер заранее находит причины отказа, разбирает отказы и пишет заметки «Что нового».

Как это работает#

  1. Подключите стор

    Настройки → Интеграции: ключ App Store Connect и/или сервисный аккаунт Google Play.

  2. Добавьте приложение

    Приложения → Новое приложение: платформа, название, bundle ID / package name.

  3. Загрузите сборку

    Перетащите файл в панель или выполните hangar apps upload. Версия и номер сборки читаются из файла.

  4. Отправьте

    TestFlight, App Review или трек Google Play — вручную или автоматически после загрузки.

Интеграции#

Ключи подключает админ или владелец workspace в разделе Настройки → Интеграции. При сохранении Hangar проверяет ключ у самого сервиса, хранит его зашифрованным и больше никогда не показывает.

App Store Connect#

  • App Store Connect → Users and Access → Integrations → App Store Connect API → «+»
  • Роль ключа — App Manager (нужна для загрузки сборок, TestFlight и отправки на ревью)
  • Скопируйте Issuer ID и Key ID, скачайте файл .p8 — Apple даёт скачать его только один раз
  • В Hangar: Интеграции → App Store Connect → Подключить, укажите оба ID и выберите .p8

Google Play#

  • Google Cloud Console → включите Google Play Android Developer API
  • IAM → Service Accounts → создайте аккаунт → Keys → Add key → JSON
  • Play Console → Users and permissions → пригласите email сервисного аккаунта с правами на выпуск релизов для нужных приложений
  • В Hangar: Интеграции → Google Play → Подключить и выберите JSON-файл

Google требует, чтобы первая сборка нового приложения была загружена в Play Console вручную, — дальше Hangar справится сам.

AI-провайдер#

Подключите OpenAI (platform.openai.com → API keys) или любой совместимый с OpenAI API провайдер: укажите Base URL, модель и ключ. Без AI-провайдера работает всё, кроме AI-проверки, разбора отказов и генерации заметок.

Приложения#

Приложение в Hangar связано с записью в сторе по bundle ID (iOS) или package name (Android) — само приложение в App Store Connect / Play Console должно уже существовать. Если с ключом что-то не так или приложение не найдено, на его странице появится предупреждение с кнопкой «Проверить снова».

Загрузка сборки#

В панели: Приложения → приложение → перетащите файл в поле загрузки. Можно сразу включить отправку в стор и написать «Что нового». Из терминала или CI:

Терминал
hangar apps upload build/App.ipa --app com.company.app
hangar apps upload app-release.aab --app com.company.app --send --target internal

При загрузке Hangar:

  • читает версию, номер сборки и bundle ID из файла и сверяет их с приложением
  • отказывает, если такой номер сборки уже есть — в Hangar или в сторе, чтобы не ждать отказа от Apple или Google
  • запускает автоматические проверки и, если включено, AI-проверку
  • запоминает git-коммит и сообщения коммитов с прошлой сборки (CLI передаёт их сам) — для заметок к релизу

Максимальный размер сборки — 4 ГБ.

Отправка в стор#

В карточке сборки выберите, куда отправить, и нажмите «Отправить». Дальше всё идёт в фоне, статус и хронология обновляются сами.

iOS#

  • TestFlight — сборка загружается в App Store Connect, Apple обрабатывает её (обычно 5–30 минут), затем Hangar выдаёт её выбранным группам тестировщиков и заполняет «Что тестировать». Для внешних групп Hangar сам отправляет сборку на бета-ревью
  • App Review — Hangar создаёт версию в App Store Connect (если её нет), прикрепляет сборку, заполняет «Что нового» и отправляет на ревью. Скриншоты, описание и данные для ревьюера должны быть заполнены в App Store Connect
  • Экспортное шифрование: если в Info.plist нет ITSAppUsesNonExemptEncryption, укажите ответ в настройках приложения — иначе сборка остановится на «Missing Compliance»
  • После одобрения ревью: опубликовать вручную или сразу — настройка приложения

Android#

  • Треки: internal (внутреннее тестирование), alpha, beta, production
  • Для production можно задать процент раскатки — релиз выйдет постепенно (staged rollout)
  • Если приложение ещё ни разу не публиковалось, Google принимает только черновики: Hangar сохранит релиз черновиком, опубликуйте его в Play Console

Статусы#

  • Загружена — сборка в Hangar, никуда не отправлялась
  • Отправляется / Обработка в сторе — идёт загрузка или Apple обрабатывает сборку
  • Готова — сборка в TestFlight (iOS)
  • Ждёт ревью / На ревью — версия у ревьюеров Apple
  • Одобрена / Опубликована — прошла ревью; для Android «Опубликована» — релиз выложен в трек
  • Отклонена / Ошибка — подробности в хронологии сборки

Статус ревью Google Play через API недоступен: для Android Hangar показывает, в какой трек и с каким статусом выложен релиз.

Автоматизация#

В настройках приложения можно включить отправку сразу после загрузки (TestFlight, App Review или трек) и AI-проверку каждой сборки. С опцией «Не отправлять автоматически, если найдены блокеры» сборка с серьёзными проблемами остановится и подождёт вас.

AI-ревьювер#

Проверка перед отправкой#

Встроенные проверки работают всегда: отладочная сборка, устаревший targetSdkVersion, чувствительные разрешения Android (SMS, журнал звонков, все файлы, геолокация в фоне…), отключённый App Transport Security, слишком короткие описания запросов доступа (NS…UsageDescription), не указанное экспортное шифрование. AI дополнительно сверяет сборку, заметки и описание в сторе с App Store Review Guidelines и правилами Google Play. Каждое замечание — с правилом и тем, как исправить.

Разбор отказа#

Вкладка «Разбор отказа»: вставьте текст от ревьюера (App Store Connect → Resolution Center или письмо Google Play). AI объяснит простыми словами, за что отклонили, что исправить, нужна ли новая сборка, и подготовит ответ ревьюеру на английском.

Заметки «Что нового»#

В карточке сборки нажмите «Написать AI»: заметки появятся на всех языках приложения по коммитам с прошлой сборки или по вашему короткому описанию. Лимиты сторов учитываются: 500 символов для Google Play, 4000 для App Store.

CI#

Для мобильных релизов в CI используйте персональный API-токен (Настройки → API-токены): токены проекта действуют только внутри одного проекта.

.github/workflows/ios-release.yml
name: ios-release
on: { push: { tags: ['v*'] } }
jobs:
  release:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
        with: { fetch-depth: 0 }
      - run: |
          xcodebuild -scheme App -archivePath App.xcarchive archive
          xcodebuild -exportArchive -archivePath App.xcarchive -exportOptionsPlist ExportOptions.plist -exportPath build
      - run: curl -fsSL https://hangar.my/v1/cli/install.sh | HANGAR_INSTALL_DIR=$HOME/bin sh
      - run: $HOME/bin/hangar apps upload build/App.ipa --app com.company.app --send --target testflight --wait
        env:
          HANGAR_API_URL: https://hangar.my
          HANGAR_TOKEN: ${{ secrets.HANGAR_TOKEN }}

fetch-depth: 0 нужен, чтобы CLI видел историю коммитов для заметок к релизу. С --wait команда дождётся, пока стор обработает сборку, и завершится ошибкой, если сборку отклонят.

Сборщик на Mac#

Терминал
hangar builder connect hmb_…      # подключить этот Mac (токен — в Hangar → Приложения)
hangar builder install            # агент в фоне, при входе в систему
hangar builder status             # подключение, macOS, Xcode, утилиты
hangar builder run                # запустить в этом окне (Ctrl+C — стоп)
hangar builder uninstall          # остановить агент
# лог агента: ~/Library/Logs/hangar-builder.log

Команды#

hangar apps
приложения workspace и их последние сборки
hangar apps upload FILE --app APP [--send] [--target T] [--notes TEXT] [--wait]
загрузить .ipa / .aab; T: testflight | review | internal | alpha | beta | production
hangar apps builds APP
сборки приложения
hangar apps send BUILD --target T [--wait]
отправить загруженную сборку в стор
hangar apps status BUILD
статус, замечания проверки и хронология сборки

APP — id приложения, bundle ID / package name или название. Заметки на нескольких языках: --notes-file notes.json с объектом вида {"ru": "…", "en": "…"}.

Автоматизируйте релизы вместе с деплоем бэкенда.

CI/CD и токены