148 lines
6.0 KiB
Markdown
148 lines
6.0 KiB
Markdown
# APRS RadioRubka
|
||
|
||
Android-приложение: анимированная заставка «APRS» → веб-карта APRS и
|
||
пуш-уведомления (RuStore Push). Кнопка «назад» закрывает приложение, экран не
|
||
гаснет при активном приложении.
|
||
|
||
- Пакет: `ru.ua1zbe.aprsmap`
|
||
- Карта: https://aprs.radiorubka.org/?center=67.5096,32.8271&zoom=8
|
||
(задаётся строкой `map_url` в `app/src/main/res/values/strings.xml`)
|
||
- Репозиторий: https://git2.ua1zbe.ru/ua1zbe/aprsmap
|
||
|
||
## Стек сборки
|
||
|
||
- Gradle wrapper 9.2.0, AGP 8.13.2, Kotlin 2.2.21, JDK 25
|
||
- compileSdk 34, targetSdk 34, minSdk 26
|
||
|
||
> Не использовать системный gradle 4.4.1 — только `./gradlew`.
|
||
|
||
## Сборка
|
||
|
||
```bash
|
||
./gradlew :app:assembleDebug # отладочный APK
|
||
./gradlew :app:assembleRelease # релизный APK (подписан)
|
||
```
|
||
|
||
Релизный APK: `app/build/outputs/apk/release/app-release.apk`.
|
||
|
||
Перед релизной сборкой нужны (в git НЕ хранятся):
|
||
|
||
- `keystore.properties` — подпись релиза (файл в корне проекта):
|
||
```
|
||
storeFile=/полный/путь/aprsmap-release.jks
|
||
storePassword=...
|
||
keyAlias=aprsmap
|
||
keyPassword=...
|
||
```
|
||
- `aprsmap-release.jks` — файл ключа (`.gitignore`).
|
||
|
||
Отпечаток подписи (SHA-256) релиза. Получение:
|
||
|
||
```bash
|
||
keytool -list -v -keystore aprsmap-release.jks -alias aprsmap -storepass <пароль> | grep SHA256
|
||
# или
|
||
$ANDROID_HOME/build-tools/35.0.0/apksigner verify --print-certs app-release.apk
|
||
```
|
||
|
||
## Версионирование
|
||
|
||
`app/build.gradle.kts`:
|
||
|
||
```kotlin
|
||
versionCode = 4 // инкремент для каждого релиза
|
||
versionName = "1.0.3"
|
||
```
|
||
|
||
## Установка на телефон (adb)
|
||
|
||
```bash
|
||
$ANDROID_HOME/platform-tools/adb install -r app/build/outputs/apk/release/app-release.apk
|
||
$ANDROID_HOME/platform-tools/adb shell am start -n ru.ua1zbe.aprsmap/.SplashActivity
|
||
```
|
||
|
||
Запуск только через `.SplashActivity` (MainActivity не exported).
|
||
Google Play Protect может блокировать sideload — выключите усиленную защиту.
|
||
|
||
## Выпуск релиза на Gitea
|
||
|
||
1. Собрать `assembleRelease`.
|
||
2. Токен API Gitea — в `/tmp/gitea_token.txt` (`Authorization: token`).
|
||
3. Создать релиз и загрузить APK (см. пример ниже). Имена тегов: `v1.0.0`, `v1.0.1`, ...
|
||
|
||
```bash
|
||
TOKEN=$(cat /tmp/gitea_token.txt)
|
||
curl -s -X POST -H "Authorization: token $TOKEN" -H "Content-Type: application/json" \
|
||
-d '{"tag_name":"v1.0.3","target_commitish":"main","name":"v1.0.3","body":"...","draft":false,"prerelease":false}' \
|
||
"https://git2.ua1zbe.ru/api/v1/repos/ua1zbe/aprsmap/releases"
|
||
# затем прикрепить APK, взяв id релиза:
|
||
curl -s -H "Authorization: token $TOKEN" \
|
||
-F "attachment=@app/build/outputs/apk/release/app-release.apk" \
|
||
"https://git2.ua1zbe.ru/api/v1/repos/ua1zbe/aprsmap/releases/<id>/assets?name=APRS_RadioRubka_v1.0.3.apk"
|
||
```
|
||
|
||
Сверка обновлений идёт по интерфейсу
|
||
`https://git2.ua1zbe.ru/api/v1/repos/ua1zbe/aprsmap/releases/latest`
|
||
— поэтому репозиторий публичный.
|
||
|
||
## Автообновление
|
||
|
||
- При старте `MainActivity.checkForUpdates()` сравнивает `versionName` с последним
|
||
релизом Gitea; если есть новее — диалог «Обновить».
|
||
- APK скачивается в `cacheDir/updates/`, установка через
|
||
`ContentProvider` `UpdateFileProvider` (authority `ru.ua1zbe.aprsmap.fileprovider`)
|
||
+ `ACTION_VIEW`, при необходимости запрос «Разрешить установку из этого источника».
|
||
- `tools/push.sh` — служебное, рассылка пушей (см. ниже).
|
||
|
||
## Пуш-уведомления (RuStore Push)
|
||
|
||
Актуально с v1.0.3. SDK `ru.rustore.sdk:pushclient:7.4.0`, топик рассылки —
|
||
**`aprsmap`**.
|
||
|
||
- Параметры в `app/src/main/java/ru/ua1zbe/aprsmap/App.kt`:
|
||
`RUSTORE_PROJECT_ID` (project id из консоли RuStore),
|
||
`PUSH_TOPIC`. При старте: `RuStorePushClient.init` → `getToken` →
|
||
`subscribeToTopic("aprsmap")`.
|
||
- `PushMessagingService` получает `onNewToken`/`onMessageReceived`; уведомления с
|
||
секцией `notification` показывает сам SDK, `data` с ключами `title`/`body` —
|
||
приложение. Канал `aprs_push`.
|
||
- Токен устройства пишется в `shared_prefs/aprsmap.xml` (`push_token`) и виден в
|
||
logcat `RuStorePush:`.
|
||
|
||
### Секреты (в git НЕ хранить)
|
||
|
||
`tools/.push.secrets` (в `.gitignore`):
|
||
|
||
```
|
||
SERVICE_TOKEN="..."
|
||
PROJECT_ID="..."
|
||
```
|
||
|
||
SDK на устройстве требует установленный и авторизованный RuStore.
|
||
|
||
### Рассылка всем подписчикам топика
|
||
|
||
```bash
|
||
./tools/push.sh "Заголовок" "Текст"
|
||
```
|
||
|
||
Реализация: `POST https://vkpns-topics.rustore.ru/v1/projects/{PROJECT_ID}/topics/aprsmap/publish`
|
||
с `Authorization: Bearer {SERVICE_TOKEN}`. Ответ
|
||
`{"message":"payload has been successfully published to topic aprsmap"}` — успех.
|
||
|
||
### Точечная отправка на устройство
|
||
|
||
```bash
|
||
curl -s -X POST \
|
||
"https://vkpns.rustore.ru/v1/projects/${PROJECT_ID}/messages:send" \
|
||
-H "Authorization: Bearer ${SERVICE_TOKEN}" -H "Content-Type: application/json" \
|
||
-d '{"message":{"token":"<push_token устройства>","notification":{"title":"...","body":"..."}}}'
|
||
```
|
||
|
||
### Проверка на устройстве
|
||
|
||
```bash
|
||
adb logcat -d | grep -E "RuStorePush:"
|
||
adb shell dumpsys notification | grep -E "aprs_push|aprsmap"
|
||
```
|
||
|
||
Ожидаемое: `push token: ...`, `subscribed to aprsmap`, `push displayed by SDK`. |