Реализована проверка версионности и требование soft\force обновлений приложения
This commit is contained in:
mi
@@ -1,6 +1,7 @@
|
||||
# HAN Chat Mobile
|
||||
|
||||
Мобильный Android-клиент HAN Chat на Expo SDK 57.
|
||||
Мобильный клиент HAN Chat на Expo SDK 57. Текущая версия приложения — `1.0.1`,
|
||||
native identity — Android `versionCode: 2` и iOS `buildNumber: 2`.
|
||||
|
||||
## Подготовка
|
||||
|
||||
@@ -23,15 +24,49 @@ npm test
|
||||
|
||||
Запуск приложения выполняется отдельно командой `npm run android`. Проект использует managed Expo workflow и не хранит каталоги `android/` и `ios/`.
|
||||
|
||||
## Store-only обновления
|
||||
|
||||
Приложение не загружает JS/asset OTA-обновления. Оно читает `mobile_update` из
|
||||
`GET /api/v1/public/app-config` и отправляет пользователя в магазин своей сборки.
|
||||
Канал фиксируется на этапе EAS build:
|
||||
|
||||
- `EXPO_PUBLIC_DISTRIBUTION_STORE=google_play`;
|
||||
- `EXPO_PUBLIC_DISTRIBUTION_STORE=rustore`;
|
||||
- `EXPO_PUBLIC_DISTRIBUTION_STORE=app_store`.
|
||||
|
||||
Неизвестное или отсутствующее значение отключает механику. Поэтому профили
|
||||
`development` и `preview` имеют значение `disabled`. Профиль
|
||||
`preview-rustore` намеренно задаёт `rustore`, чтобы проверять update policy на
|
||||
внутреннем APK через dev-backend.
|
||||
|
||||
Решение принимается только по целому native build:
|
||||
|
||||
- build ниже `minimum_build` — обязательное (`force`) обновление;
|
||||
- build ниже `latest_build`, но не ниже minimum — мягкое (`soft`) обновление;
|
||||
- build не ниже latest — обновление не показывается.
|
||||
|
||||
Soft-карточку можно закрыть; выбор запоминается в SecureStore отдельно для пары
|
||||
`канал + latest_build`. Force-карточка блокирует Android Back и не имеет способов
|
||||
закрытия. Проверка выполняется на холодном старте и при возврате в foreground,
|
||||
параллельные проверки объединяются. Сетевая ошибка, невалидный build или
|
||||
недоверенный URL работают fail-open и не блокируют интерфейс.
|
||||
|
||||
Допускаются только HTTPS-ссылки соответствующего магазина:
|
||||
`play.google.com/store/apps/details?id=ru.han.chat`,
|
||||
`www.rustore.ru/catalog/app/ru.han.chat` и App Store URL на `apps.apple.com` с Apple ID.
|
||||
|
||||
## Сборка (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` |
|
||||
| `preview` | APK (внутренняя установка) | `dev-chat.han0107.ru` | update policy отключена |
|
||||
| `preview-rustore` | APK (тест RuStore policy) | `dev-chat.han0107.ru` | `rustore` |
|
||||
| `google-play` | AAB (Google Play) | `chat.han0107.ru` | `google_play` |
|
||||
| `rustore` | AAB (RuStore) | `chat.han0107.ru` | `rustore` |
|
||||
| `app-store` | iOS App Store | `chat.han0107.ru` | `app_store` |
|
||||
| `development` | Dev Client | из окружения/локально | update policy отключена |
|
||||
|
||||
### Один раз: вход в Expo
|
||||
|
||||
@@ -58,19 +93,52 @@ npx eas-cli build --profile preview --platform android
|
||||
|
||||
После успеха откройте ссылку из вывода CLI (или `https://expo.dev/accounts/anzh/projects/han-chat/builds`) и скачайте APK.
|
||||
|
||||
### Production — AAB для Play Store
|
||||
### Preview RuStore — проверка soft/force update
|
||||
|
||||
```powershell
|
||||
npx eas-cli build --profile production --platform android
|
||||
npx eas-cli build:version:get --platform android --profile preview-rustore
|
||||
npx eas-cli build --profile preview-rustore --platform android
|
||||
```
|
||||
|
||||
`versionCode` поднимается автоматически (`appVersionSource: remote` + `autoIncrement`).
|
||||
Профиль использует dev API и встраивает канал `rustore`, но не увеличивает общий
|
||||
remote Android `versionCode` (`autoIncrement: false`). Запишите build из
|
||||
`build:version:get` или карточки завершённой сборки. Для build `B` настройте
|
||||
политику RuStore на dev-backend:
|
||||
|
||||
- soft: `latest_build=B+1`, `minimum_build<=B`;
|
||||
- force: `latest_build=B+1`, `minimum_build=B+1`;
|
||||
- none: `latest_build<=B`.
|
||||
|
||||
После изменения dev settings примените штатный `seed-settings`, подождите до
|
||||
истечения cache TTL и перезапустите APK. Для повторной проверки soft на том же
|
||||
`latest_build` очистите данные приложения или увеличьте `latest_build`, так как
|
||||
«Позже» сохраняется в SecureStore без TTL.
|
||||
|
||||
APK имеет тот же package `ru.han.chat` и подпись EAS, поэтому может заменить
|
||||
установленную store-сборку. Используйте отдельное тестовое устройство или заранее
|
||||
учтите замену приложения и его локальных данных.
|
||||
|
||||
### Store-сборки
|
||||
|
||||
```powershell
|
||||
npx eas-cli build --profile google-play --platform android
|
||||
npx eas-cli build --profile rustore --platform android
|
||||
npx eas-cli build --profile app-store --platform ios
|
||||
```
|
||||
|
||||
Native build поднимается через `appVersionSource: remote` и platform-specific
|
||||
`autoIncrement`. Google Play и RuStore используют общий Android application ID
|
||||
`ru.han.chat`, поэтому их последовательные сборки увеличивают один remote
|
||||
`versionCode`: например, первая получит `7`, следующая — `8`. Backend-пороги
|
||||
магазинов поэтому заполняются независимо по фактически опубликованным
|
||||
артефактам. Локальные `versionCode: 2`/`buildNumber: 2` служат исходной native
|
||||
identity, но при remote source фактическое значение сборки определяет EAS.
|
||||
|
||||
### Полезные команды
|
||||
|
||||
```powershell
|
||||
# только отправить билд и сразу вернуть ссылку (не ждать окончания)
|
||||
npx eas-cli build --profile production --platform android --no-wait
|
||||
npx eas-cli build --profile google-play --platform android --no-wait
|
||||
|
||||
# статус конкретной сборки
|
||||
npx eas-cli build:view <BUILD_ID>
|
||||
@@ -78,6 +146,11 @@ npx eas-cli build:view <BUILD_ID>
|
||||
# список последних сборок
|
||||
npx eas-cli build:list --platform android --limit 5
|
||||
|
||||
# прочитать текущий remote versionCode/buildNumber
|
||||
npx eas-cli build:version:get --platform android --profile google-play
|
||||
npx eas-cli build:version:get --platform android --profile rustore
|
||||
npx eas-cli build:version:get --platform ios --profile app-store
|
||||
|
||||
# скачать артефакт готовой сборки
|
||||
npx eas-cli build:download --id <BUILD_ID>
|
||||
|
||||
@@ -85,6 +158,9 @@ npx eas-cli build:download --id <BUILD_ID>
|
||||
npx eas-cli build:version:set
|
||||
```
|
||||
|
||||
Полная процедура rollout, включения soft/force policy и отката:
|
||||
`../VM1_app/codebase/backend/deployment/RUNBOOK.mobile-updates.ru.md`.
|
||||
|
||||
### Keycloak redirect URI
|
||||
|
||||
Для боевого хоста в клиенте `han-chat-frontend` должны быть exact URI:
|
||||
|
||||
Reference in New Issue
Block a user