chore(openspec): archive add-make-install-android and sync main specs
This commit is contained in:
@@ -0,0 +1,41 @@
|
||||
# Proposal
|
||||
|
||||
## Why
|
||||
|
||||
Разработчику нужно ставить Android-клиент на подключённое устройство, но сегодня в
|
||||
`Makefile` есть только `make android`, который собирает debug-APK и никуда его не
|
||||
устанавливает. При этом голый `make` по умолчанию запускает цель `frontend`
|
||||
(`cd frontend && npm ci && npm run build`), что неочевидно и тянет `npm ci`.
|
||||
|
||||
## What Changes
|
||||
|
||||
- Новая Make-цель `install-android-app`: собирает debug-APK клиента и устанавливает его
|
||||
на устройство.
|
||||
- Выбор устройства: явный серийный номер (`SERIAL`/`ANDROID_SERIAL`) либо автоматически,
|
||||
если подключено ровно одно устройство.
|
||||
- Если устройств несколько и серийный номер не задан — цель печатает список устройств и
|
||||
**не** выполняет установку, завершаясь ненулевым кодом.
|
||||
- **BREAKING** (изменение поведения по умолчанию): голый `make` теперь печатает список
|
||||
доступных целей и больше не собирает фронтенд; сборка фронтенда остаётся за целями
|
||||
`frontend` и `build`.
|
||||
- Обновление `android/README.md`: документировать установку на устройство.
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
|
||||
- `dev-make-workflow`: Make-интерфейс разработчика — установка Android-клиента на
|
||||
выбранное устройство и обзор доступных Make-целей.
|
||||
|
||||
### Modified Capabilities
|
||||
|
||||
<!-- Нет: спеки продукта (android-client и др.) не меняются, изменение — только dev-инструмент. -->
|
||||
|
||||
## Impact
|
||||
|
||||
- `Makefile`: новая цель `install-android-app`, новая цель `help`, смена `.DEFAULT_GOAL`
|
||||
с `frontend` на `help`.
|
||||
- `android/README.md`: раздел «Build» дополняется установкой на устройство.
|
||||
- Код сервера и Android-приложения не затрагивается.
|
||||
- Новых внешних зависимостей нет: используется уже требуемый Android SDK и `adb` из
|
||||
`platform-tools`.
|
||||
Reference in New Issue
Block a user