3.2 KiB
HAN Chat Mobile
Мобильный Android-клиент HAN Chat на Expo SDK 57.
Подготовка
-
Установить Node.js и npm.
-
Скопировать
.env.exampleв.envи указать адреса API и Keycloak. -
Установить зависимости:
npm install -
Зарегистрировать
han-chat://auth/callbackкак допустимый redirect URI клиента Keycloak.
Локальные проверки
npm run typecheck
npm test
Запуск приложения выполняется отдельно командой npm run android. Проект использует managed Expo workflow и не хранит каталоги android/ и ios/.
Сборка (EAS)
Профили заданы в eas.json. Env для билда берётся из профиля (eas.json → env), а не из локального .env.
| Профиль | Артефакт | API | EXPO_PUBLIC_APP_ENV |
|---|---|---|---|
preview |
APK (внутренняя установка) | dev-chat.han0107.ru |
production-like (есть «Диагностика») |
production |
AAB (Google Play) | chat.han0107.ru |
production (без диагностики) |
development |
Dev Client | из окружения/локально | для разработки с expo-dev-client |
Один раз: вход в Expo
cd C:\Users\MI\Documents\Assistent\HAN_chat_specification\VM4_Expo-mobile
npx eas-cli login
npx eas-cli whoami
Проект уже привязан (owner: anzh, projectId в app.config.ts). Android keystore хранится remote на Expo.
Перед сборкой (рекомендуется)
npm run typecheck
npm test
Preview — APK на телефон
npx eas-cli build --profile preview --platform android
После успеха откройте ссылку из вывода CLI (или https://expo.dev/accounts/anzh/projects/han-chat/builds) и скачайте APK.
Production — AAB для Play Store
npx eas-cli build --profile production --platform android
versionCode поднимается автоматически (appVersionSource: remote + autoIncrement).
Полезные команды
# только отправить билд и сразу вернуть ссылку (не ждать окончания)
npx eas-cli build --profile production --platform android --no-wait
# статус конкретной сборки
npx eas-cli build:view <BUILD_ID>
# список последних сборок
npx eas-cli build:list --platform android --limit 5
# скачать артефакт готовой сборки
npx eas-cli build:download --id <BUILD_ID>
# синхронизировать versionCode с Play Console (если нужно вручную)
npx eas-cli build:version:set
Keycloak redirect URI
Для боевого хоста в клиенте han-chat-frontend должны быть exact URI:
https://chat.han0107.ru/mobile/oidc/callbackhan-chat://auth/callback
Для preview — те же пути на https://dev-chat.han0107.ru.