
Hangar собирает приложение прямо из репозитория — или принимает готовые .ipa для iOS и .aab для Android — проверяет сборку и отправляет её в App Store Connect или Google Play, а потом следит за ревью. AI-ревьювер заранее находит причины отказа, разбирает отказы и пишет заметки «Что нового».
Как это работает#
- Подключите стор
Настройки → Интеграции: ключ App Store Connect и/или сервисный аккаунт Google Play.
- Добавьте приложение
Приложения → Новое приложение: платформа, название, bundle ID / package name.
- Загрузите сборку
Перетащите файл в панель или выполните hangar apps upload. Версия и номер сборки читаются из файла.
- Отправьте
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-токены): токены проекта действуют только внутри одного проекта.
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": "…"}.

