878 lines
39 KiB
Markdown
878 lines
39 KiB
Markdown
# Подготовка radiOLA к публикации в RuStore — план реализации
|
||
|
||
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||
|
||
**Goal:** Подготовить Android-приложение radiOLA к публикации в RuStore: разделить
|
||
сборку на флейворы `store`/`sideload`, добавить релизную подпись, перевести API на
|
||
HTTPS, оформить политику конфиденциальности, почистить настройки и добавить
|
||
дип-линк-кнопку SOVA (только sideload).
|
||
|
||
**Architecture:** Один кодовый базис, два product flavor. `store` — чистая сборка
|
||
для RuStore (без авто-апдейтера и `REQUEST_INSTALL_PACKAGES`, без dev-тестера и
|
||
SOVA). `sideload` — текущий канал. API уходит за HTTPS-домен `api.radiola.nexaweb.su`
|
||
через уже работающий на сервере хостовый Caddy.
|
||
|
||
**Tech Stack:** Kotlin/Compose/Hilt (Android), Gradle product flavors, NestJS
|
||
(бэкенд-сабмодуль), Caddy (reverse-proxy + авто-TLS), Docker Compose.
|
||
|
||
**Замечание по методу:** задачи — конфигурация и инфраструктура, классический
|
||
TDD неприменим. Роль теста выполняют команды-проверки (gradle-сборка,
|
||
`aapt dump permissions`, `curl`, `adb`). Каждая задача: изменение → проверка →
|
||
коммит.
|
||
|
||
**Git:** Android — ветка `feat/bootstrap-project` (репо radiola-android, корень
|
||
`C:\radiOLA`). Бэкенд — ветка `main` (сабмодуль `C:\radiOLA\backend`, деплой
|
||
scp+`docker compose` на ru-server `121.127.37.212`, `/opt/radiola` — НЕ git-репо).
|
||
|
||
**Зависимости от пользователя (отметить и дождаться):**
|
||
- DNS A-запись `api.radiola.nexaweb.su → 121.127.37.212` (Задача 1).
|
||
- Генерация release-keystore + `keystore.properties` (Задача 6).
|
||
- Полный `IP:порт` adb «Беспроводная отладка» для добычи пакета SOVA (Задача 11).
|
||
- Действия в консоли RuStore (Задача 14).
|
||
|
||
---
|
||
|
||
## Файловая карта
|
||
|
||
**Бэкенд / сервер (сабмодуль + ru-server):**
|
||
- Caddyfile на сервере (расположение определить) — vhost `api.radiola.nexaweb.su`.
|
||
- `backend/public/privacy.html` (создать) или статический роут — текст политики.
|
||
- `backend/src/main.ts` — при необходимости статика `/privacy`.
|
||
- `/opt/radiola/.env` (сервер) — `PUBLIC_BASE_URL` на https.
|
||
- `/opt/radiola/appdist/app-version.json` (сервер) — `download_url` на https.
|
||
|
||
**Android:**
|
||
- `app/build.gradle.kts` — flavors, BuildConfig-поля, signingConfig.
|
||
- `keystore.properties`, `.gitignore` (корень) — подпись.
|
||
- `app/src/main/AndroidManifest.xml` — убрать `REQUEST_INSTALL_PACKAGES`.
|
||
- `app/src/sideload/AndroidManifest.xml` (создать) — `REQUEST_INSTALL_PACKAGES`.
|
||
- `app/src/main/java/com/radiola/MainActivity.kt` — gate апдейтера.
|
||
- `app/src/main/java/com/radiola/update/UpdateManager.kt` — BASE_URL → https.
|
||
- `app/src/main/java/com/radiola/di/AppModule.kt` — baseUrl → https.
|
||
- `app/src/main/java/com/radiola/ui/settings/SettingsScreen.kt` — убрать тумблер записи, gate тестера.
|
||
- `app/src/main/java/com/radiola/ui/settings/SettingsViewModel.kt` — убрать recording.
|
||
- `app/src/main/java/com/radiola/domain/repository/SettingsRepository.kt` — убрать recording.
|
||
- `app/src/main/java/com/radiola/data/repository/SettingsRepositoryImpl.kt` — убрать recording.
|
||
- `app/src/main/java/com/radiola/domain/model/DeeplinkService.kt` — packageName + SOVA.
|
||
- `app/src/main/java/com/radiola/deeplink/DeeplinkNavigator.kt` — setPackage + фолбэк.
|
||
|
||
---
|
||
|
||
## ФАЗА 1 — Инфраструктура HTTPS + политика конфиденциальности
|
||
|
||
### Задача 1: HTTPS-домен для API (DNS + Caddy)
|
||
|
||
**Files:** Caddyfile на ru-server (расположение определить в шаге 2).
|
||
|
||
- [ ] **Шаг 1: Пользователь добавляет DNS A-запись**
|
||
|
||
Попросить пользователя: в DNS-зоне `nexaweb.su` создать запись
|
||
`api.radiola.nexaweb.su A 121.127.37.212`. Дождаться подтверждения.
|
||
|
||
Проверка резолвинга:
|
||
```bash
|
||
nslookup api.radiola.nexaweb.su
|
||
```
|
||
Ожидаемо: возвращает `121.127.37.212`. Если нет — подождать распространения DNS.
|
||
|
||
- [ ] **Шаг 2: Найти Caddyfile на сервере**
|
||
|
||
```bash
|
||
ssh ru-server 'systemctl status caddy | grep -i caddyfile; ls -la /etc/caddy/Caddyfile 2>/dev/null; caddy version'
|
||
```
|
||
Ожидаемо: путь к Caddyfile (обычно `/etc/caddy/Caddyfile`).
|
||
|
||
- [ ] **Шаг 3: Добавить vhost-блок в Caddyfile**
|
||
|
||
Дописать в Caddyfile (через ssh, с бэкапом):
|
||
```bash
|
||
ssh ru-server 'cp /etc/caddy/Caddyfile /etc/caddy/Caddyfile.bak.$(date +%s); cat >> /etc/caddy/Caddyfile <<"EOF"
|
||
|
||
api.radiola.nexaweb.su {
|
||
reverse_proxy localhost:3000
|
||
}
|
||
EOF'
|
||
```
|
||
(Путь подставить из шага 2. `date` — на сервере, не в JS-окружении.)
|
||
|
||
- [ ] **Шаг 4: Перезагрузить Caddy и проверить TLS**
|
||
|
||
```bash
|
||
ssh ru-server 'caddy validate --config /etc/caddy/Caddyfile && systemctl reload caddy'
|
||
sleep 5
|
||
curl -s -o /dev/null -w "%{http_code}\n" https://api.radiola.nexaweb.su/app-version
|
||
```
|
||
Ожидаемо: валидный TLS, HTTP `200`. (Caddy сам выпустит Let's Encrypt cert.)
|
||
|
||
- [ ] **Шаг 5: Проверить /downloads и /covers по https**
|
||
|
||
```bash
|
||
curl -s -o /dev/null -w "downloads:%{http_code}\n" https://api.radiola.nexaweb.su/downloads/radiola-latest.apk
|
||
```
|
||
Ожидаемо: `downloads:200`.
|
||
|
||
(Коммита нет — изменение на сервере. Caddyfile.bak оставлен.)
|
||
|
||
---
|
||
|
||
### Задача 2: Политика конфиденциальности (текст + хостинг)
|
||
|
||
**Files:**
|
||
- Create: `backend/src/privacy/privacy.controller.ts`
|
||
- Create: `backend/src/privacy/privacy.module.ts`
|
||
- Modify: `backend/src/app.module.ts` (импорт PrivacyModule)
|
||
|
||
- [ ] **Шаг 1: Создать контроллер с инлайн-HTML политики**
|
||
|
||
Создать `backend/src/privacy/privacy.controller.ts` — `@Get('privacy')`, отдаёт
|
||
`text/html`. HTML хранить константой в файле (без внешних зависимостей/файлов —
|
||
проще для Docker). Содержание: заголовок «Политика конфиденциальности radiOLA»,
|
||
дата; разделы — какие данные собираются (email для входа по magic-link; история
|
||
прослушиваний и распознанных треков; технические логи ошибок), сторонние сервисы
|
||
(shazam-api.com — фрагмент аудио для распознавания; Discogs — обложки; радиопотоки
|
||
третьих лиц), цели обработки, хранение, удаление данных по запросу, контакт
|
||
оператора (`blinnafeg@gmail.com`). Скелет:
|
||
```typescript
|
||
import { Controller, Get, Header } from '@nestjs/common';
|
||
|
||
const PRIVACY_HTML = `<!doctype html><html lang="ru"><head>
|
||
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
||
<title>Политика конфиденциальности radiOLA</title>
|
||
<style>body{font:16px/1.6 system-ui,sans-serif;max-width:760px;margin:40px auto;padding:0 16px;color:#1a1a1a}h1{font-size:1.6rem}h2{font-size:1.15rem;margin-top:2rem}</style>
|
||
</head><body>
|
||
<h1>Политика конфиденциальности radiOLA</h1>
|
||
<p>Дата вступления в силу: 08.06.2026</p>
|
||
<!-- ... разделы по содержанию выше ... -->
|
||
<h2>Контакты</h2><p>По вопросам обработки данных: blinnafeg@gmail.com</p>
|
||
</body></html>`;
|
||
|
||
@Controller()
|
||
export class PrivacyController {
|
||
@Get('privacy')
|
||
@Header('Content-Type', 'text/html; charset=utf-8')
|
||
getPrivacy(): string {
|
||
return PRIVACY_HTML;
|
||
}
|
||
}
|
||
```
|
||
(Заполнить разделы полностью — не оставлять `<!-- ... -->`.)
|
||
|
||
- [ ] **Шаг 2: Модуль + регистрация**
|
||
|
||
Создать `backend/src/privacy/privacy.module.ts`:
|
||
```typescript
|
||
import { Module } from '@nestjs/common';
|
||
import { PrivacyController } from './privacy.controller';
|
||
|
||
@Module({ controllers: [PrivacyController] })
|
||
export class PrivacyModule {}
|
||
```
|
||
В `backend/src/app.module.ts` импортировать `PrivacyModule` и добавить в `imports`.
|
||
|
||
- [ ] **Шаг 3: Компиляция бэкенда**
|
||
|
||
```bash
|
||
cd C:/radiOLA/backend && npx tsc --noEmit 2>&1 | grep -viE "sharp|undici" | head; echo "tsc done"
|
||
```
|
||
Ожидаемо: без ошибок (sharp/undici — предсуществующие, игнорируем).
|
||
|
||
- [ ] **Шаг 4: Закоммитить (backend, main)**
|
||
|
||
```bash
|
||
cd C:/radiOLA/backend
|
||
git add src/privacy/ src/app.module.ts
|
||
git commit -m "feat(privacy): страница политики конфиденциальности на /privacy"
|
||
git push
|
||
```
|
||
|
||
- [ ] **Шаг 5: Задеплоить и проверить**
|
||
|
||
```bash
|
||
cd C:/radiOLA/backend
|
||
ssh ru-server 'mkdir -p /opt/radiola/src/privacy'
|
||
scp src/privacy/privacy.controller.ts src/privacy/privacy.module.ts ru-server:/opt/radiola/src/privacy/
|
||
scp src/app.module.ts ru-server:/opt/radiola/src/app.module.ts
|
||
ssh ru-server 'cd /opt/radiola && docker compose build app && docker compose up -d app'
|
||
sleep 8
|
||
curl -s -o /dev/null -w "%{http_code}\n" https://api.radiola.nexaweb.su/privacy
|
||
```
|
||
Ожидаемо: `200`, страница открывается в браузере.
|
||
|
||
- [ ] **Шаг 6: Закоммитить гитлинк сабмодуля (android, feat/bootstrap-project)**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git add backend
|
||
git commit -m "chore: bump backend submodule (privacy)"
|
||
git push
|
||
```
|
||
|
||
---
|
||
|
||
### Задача 3: Перевести серверные ссылки на HTTPS
|
||
|
||
**Files:** `/opt/radiola/.env`, `/opt/radiola/appdist/app-version.json` (сервер).
|
||
|
||
- [ ] **Шаг 1: PUBLIC_BASE_URL на https**
|
||
|
||
```bash
|
||
ssh ru-server 'cd /opt/radiola && sed -i "s#PUBLIC_BASE_URL=.*#PUBLIC_BASE_URL=https://api.radiola.nexaweb.su#" .env && grep PUBLIC_BASE_URL .env'
|
||
```
|
||
Ожидаемо: `PUBLIC_BASE_URL=https://api.radiola.nexaweb.su`.
|
||
(Если строки нет — добавить `echo` в .env.)
|
||
|
||
- [ ] **Шаг 2: download_url в манифесте версии на https**
|
||
|
||
```bash
|
||
ssh ru-server 'cd /opt/radiola/appdist && sed -i "s#http://121.127.37.212:3000/downloads#https://api.radiola.nexaweb.su/downloads#" app-version.json && grep download_url app-version.json'
|
||
```
|
||
Ожидаемо: `download_url` начинается с `https://api.radiola.nexaweb.su/downloads`.
|
||
|
||
- [ ] **Шаг 3: Перезапустить контейнер (подхватить PUBLIC_BASE_URL)**
|
||
|
||
```bash
|
||
ssh ru-server 'cd /opt/radiola && docker compose up -d app'
|
||
sleep 8
|
||
curl -s https://api.radiola.nexaweb.su/app-version
|
||
```
|
||
Ожидаемо: JSON, `download_url` по https.
|
||
|
||
- [ ] **Шаг 4: Проверить обложки по https**
|
||
|
||
```bash
|
||
curl -s "https://api.radiola.nexaweb.su/now-playing" | head -c 300
|
||
```
|
||
Ожидаемо: ответ приходит; `coverUrl` (если есть) — по https.
|
||
|
||
(Коммита нет — конфиг на сервере.)
|
||
|
||
---
|
||
|
||
## ФАЗА 2 — Android: флейворы, подпись, манифест, апдейтер
|
||
|
||
### Задача 4: Product flavors + BuildConfig-флаги
|
||
|
||
**Files:** Modify `app/build.gradle.kts`.
|
||
|
||
- [ ] **Шаг 1: Добавить flavorDimensions + productFlavors**
|
||
|
||
В `app/build.gradle.kts`, внутри `android { }`, после блока `buildTypes { }`
|
||
добавить:
|
||
```kotlin
|
||
flavorDimensions += "distribution"
|
||
productFlavors {
|
||
create("store") {
|
||
dimension = "distribution"
|
||
buildConfigField("boolean", "ENABLE_SELF_UPDATE", "false")
|
||
buildConfigField("boolean", "SHOW_DEV_TOOLS", "false")
|
||
}
|
||
create("sideload") {
|
||
dimension = "distribution"
|
||
buildConfigField("boolean", "ENABLE_SELF_UPDATE", "true")
|
||
buildConfigField("boolean", "SHOW_DEV_TOOLS", "true")
|
||
}
|
||
}
|
||
```
|
||
|
||
- [ ] **Шаг 2: Проверить, что Gradle видит флейворы**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:tasks --all -q 2>&1 | grep -iE "assembleStore|assembleSideload" | head
|
||
```
|
||
Ожидаемо: присутствуют задачи `assembleStoreDebug`, `assembleSideloadDebug`,
|
||
`assembleStoreRelease`, `assembleSideloadRelease`.
|
||
|
||
- [ ] **Шаг 3: Компиляция (BuildConfig поля сгенерированы)**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:compileSideloadDebugKotlin -q 2>&1 | tail -10; echo done
|
||
grep -r "ENABLE_SELF_UPDATE\|SHOW_DEV_TOOLS" app/build/generated/source/buildConfig/sideload/debug/com/radiola/BuildConfig.java
|
||
```
|
||
Ожидаемо: компиляция без ошибок; поля `ENABLE_SELF_UPDATE=true`, `SHOW_DEV_TOOLS=true`.
|
||
|
||
- [ ] **Шаг 4: Коммит**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git add app/build.gradle.kts
|
||
git commit -m "build(app): product flavors store/sideload + BuildConfig флаги"
|
||
```
|
||
|
||
---
|
||
|
||
### Задача 5: Gate апдейтера + baseUrl/BASE_URL на HTTPS
|
||
|
||
**Files:**
|
||
- Modify `app/src/main/java/com/radiola/MainActivity.kt:119-122`
|
||
- Modify `app/src/main/java/com/radiola/update/UpdateManager.kt:35`
|
||
- Modify `app/src/main/java/com/radiola/di/AppModule.kt` (baseUrl `radiola`)
|
||
|
||
- [ ] **Шаг 1: Gate вызова проверки обновления в MainActivity**
|
||
|
||
Заменить блок (строки ~119-122):
|
||
```kotlin
|
||
LaunchedEffect(Unit) {
|
||
val info = com.radiola.update.UpdateManager.checkUpdate() ?: return@LaunchedEffect
|
||
if (info.versionCode > BuildConfig.VERSION_CODE) pendingUpdate = info
|
||
}
|
||
```
|
||
на:
|
||
```kotlin
|
||
LaunchedEffect(Unit) {
|
||
// Авто-обновление только в sideload-сборке (в store обновляет RuStore).
|
||
if (!BuildConfig.ENABLE_SELF_UPDATE) return@LaunchedEffect
|
||
val info = com.radiola.update.UpdateManager.checkUpdate() ?: return@LaunchedEffect
|
||
if (info.versionCode > BuildConfig.VERSION_CODE) pendingUpdate = info
|
||
}
|
||
```
|
||
|
||
- [ ] **Шаг 2: UpdateManager BASE_URL → https**
|
||
|
||
В `app/src/main/java/com/radiola/update/UpdateManager.kt` строка 35:
|
||
```kotlin
|
||
private const val BASE_URL = "http://121.127.37.212:3000"
|
||
```
|
||
заменить на:
|
||
```kotlin
|
||
private const val BASE_URL = "https://api.radiola.nexaweb.su"
|
||
```
|
||
|
||
- [ ] **Шаг 3: AppModule Retrofit baseUrl → https**
|
||
|
||
В `app/src/main/java/com/radiola/di/AppModule.kt` найти `provideRadiolaRetrofit`
|
||
и заменить:
|
||
```kotlin
|
||
.baseUrl("http://121.127.37.212:3000/")
|
||
```
|
||
на:
|
||
```kotlin
|
||
.baseUrl("https://api.radiola.nexaweb.su/")
|
||
```
|
||
|
||
- [ ] **Шаг 4: Компиляция обоих флейворов**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:compileStoreDebugKotlin :app:compileSideloadDebugKotlin -q 2>&1 | tail -10; echo done
|
||
```
|
||
Ожидаемо: без ошибок.
|
||
|
||
- [ ] **Шаг 5: Коммит**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git add app/src/main/java/com/radiola/MainActivity.kt app/src/main/java/com/radiola/update/UpdateManager.kt app/src/main/java/com/radiola/di/AppModule.kt
|
||
git commit -m "feat(app): апдейтер только в sideload; API/BASE_URL на https"
|
||
```
|
||
|
||
---
|
||
|
||
### Задача 6: Релизная подпись (keystore.properties)
|
||
|
||
**Files:**
|
||
- Modify `app/build.gradle.kts`
|
||
- Modify `.gitignore` (корень)
|
||
- Create (пользователь): `radiola-release.jks`, `keystore.properties`
|
||
|
||
- [ ] **Шаг 1: Добавить keystore.properties и *.jks в .gitignore**
|
||
|
||
В корневой `.gitignore` дописать:
|
||
```
|
||
# Релизная подпись (секреты — не в git)
|
||
keystore.properties
|
||
*.jks
|
||
*.keystore
|
||
```
|
||
|
||
- [ ] **Шаг 2: Пользователь генерирует keystore**
|
||
|
||
Дать пользователю команду (выполняет в `C:\radiOLA`, пароли придумывает сам):
|
||
```
|
||
keytool -genkeypair -v -keystore radiola-release.jks -alias radiola -keyalg RSA -keysize 2048 -validity 10000
|
||
```
|
||
И создать `C:\radiOLA\keystore.properties`:
|
||
```
|
||
storeFile=radiola-release.jks
|
||
storePassword=<пароль хранилища>
|
||
keyAlias=radiola
|
||
keyPassword=<пароль ключа>
|
||
```
|
||
⚠️ Предупредить: keystore нужно сохранить навсегда (потеря = нет обновлений).
|
||
Дождаться подтверждения, что файлы созданы.
|
||
|
||
- [ ] **Шаг 3: Добавить signingConfig в build.gradle.kts**
|
||
|
||
В `app/build.gradle.kts` перед `android { }` добавить:
|
||
```kotlin
|
||
val keystorePropsFile = rootProject.file("keystore.properties")
|
||
val keystoreProps = java.util.Properties().apply {
|
||
if (keystorePropsFile.exists()) load(keystorePropsFile.inputStream())
|
||
}
|
||
```
|
||
Внутри `android { }` (перед `buildTypes`) добавить:
|
||
```kotlin
|
||
signingConfigs {
|
||
create("release") {
|
||
if (keystorePropsFile.exists()) {
|
||
storeFile = rootProject.file(keystoreProps.getProperty("storeFile"))
|
||
storePassword = keystoreProps.getProperty("storePassword")
|
||
keyAlias = keystoreProps.getProperty("keyAlias")
|
||
keyPassword = keystoreProps.getProperty("keyPassword")
|
||
}
|
||
}
|
||
}
|
||
```
|
||
В `buildTypes { release { } }` добавить первой строкой:
|
||
```kotlin
|
||
signingConfig = signingConfigs.getByName("release")
|
||
```
|
||
|
||
- [ ] **Шаг 4: Проверить подпись release-сборки**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:assembleStoreRelease -q 2>&1 | tail -10; echo done
|
||
"$ANDROID_HOME/build-tools/34.0.0/apksigner" verify --print-certs app/build/outputs/apk/store/release/app-store-release.apk 2>&1 | head -5
|
||
```
|
||
Ожидаемо: сборка успешна; apksigner показывает сертификат (CN=...), НЕ debug-ключ.
|
||
(Если `apksigner` не в PATH — найти в `$ANDROID_HOME/build-tools/*/`.)
|
||
|
||
- [ ] **Шаг 5: Коммит (только .gitignore и gradle, без секретов)**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git status --short # убедиться: keystore.properties и *.jks НЕ в списке
|
||
git add .gitignore app/build.gradle.kts
|
||
git commit -m "build(app): релизная подпись из keystore.properties (в .gitignore)"
|
||
```
|
||
|
||
---
|
||
|
||
### Задача 7: REQUEST_INSTALL_PACKAGES → sideload sourceSet
|
||
|
||
**Files:**
|
||
- Modify `app/src/main/AndroidManifest.xml:14-15`
|
||
- Create `app/src/sideload/AndroidManifest.xml`
|
||
|
||
- [ ] **Шаг 1: Убрать разрешение из главного манифеста**
|
||
|
||
В `app/src/main/AndroidManifest.xml` удалить строки:
|
||
```xml
|
||
<!-- Авто-обновление: установка скачанного APK -->
|
||
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
|
||
```
|
||
|
||
- [ ] **Шаг 2: Создать sideload-манифест с разрешением**
|
||
|
||
Создать `app/src/sideload/AndroidManifest.xml`:
|
||
```xml
|
||
<?xml version="1.0" encoding="utf-8"?>
|
||
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
|
||
<!-- Установка скачанного APK — только в sideload-сборке (авто-апдейтер). -->
|
||
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />
|
||
</manifest>
|
||
```
|
||
|
||
- [ ] **Шаг 3: Проверить итоговые разрешения каждого флейвора**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:assembleStoreDebug :app:assembleSideloadDebug -q 2>&1 | tail -5; echo done
|
||
AAPT="$ANDROID_HOME/build-tools/34.0.0/aapt"
|
||
echo "=== store (НЕ должно быть REQUEST_INSTALL_PACKAGES) ==="
|
||
"$AAPT" dump permissions app/build/outputs/apk/store/debug/app-store-debug.apk | grep -i INSTALL_PACKAGES || echo "нет — верно"
|
||
echo "=== sideload (ДОЛЖНО быть) ==="
|
||
"$AAPT" dump permissions app/build/outputs/apk/sideload/debug/app-sideload-debug.apk | grep -i INSTALL_PACKAGES
|
||
```
|
||
Ожидаемо: в store — «нет — верно»; в sideload — строка с `REQUEST_INSTALL_PACKAGES`.
|
||
|
||
- [ ] **Шаг 4: Коммит**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git add app/src/main/AndroidManifest.xml app/src/sideload/AndroidManifest.xml
|
||
git commit -m "build(app): REQUEST_INSTALL_PACKAGES только в sideload"
|
||
```
|
||
|
||
---
|
||
|
||
## ФАЗА 3 — Чистка экрана настроек
|
||
|
||
### Задача 8: Убрать осиротевший тумблер «Запись эфира» (G1)
|
||
|
||
**Files:**
|
||
- Modify `app/src/main/java/com/radiola/ui/settings/SettingsScreen.kt:452-493`
|
||
- Modify `app/src/main/java/com/radiola/ui/settings/SettingsViewModel.kt`
|
||
- Modify `app/src/main/java/com/radiola/domain/repository/SettingsRepository.kt:15-16`
|
||
- Modify `app/src/main/java/com/radiola/data/repository/SettingsRepositoryImpl.kt`
|
||
|
||
- [ ] **Шаг 1: Удалить секцию «Запись эфира» из SettingsScreen**
|
||
|
||
В `SettingsScreen.kt` удалить весь блок `// --- Запись эфира ---` целиком — это
|
||
`item { ... }` со строки 452 (комментарий) по 493 (закрывающая `}` item'а),
|
||
включающий `Column` с `Switch(checked = isRecordingEnabled, ...)`.
|
||
|
||
- [ ] **Шаг 2: Удалить collectAsState записи в SettingsScreen**
|
||
|
||
В `SettingsScreen.kt` удалить строку (≈53):
|
||
```kotlin
|
||
val isRecordingEnabled by viewModel.isRecordingEnabled.collectAsState()
|
||
```
|
||
|
||
- [ ] **Шаг 3: Удалить recording из SettingsViewModel**
|
||
|
||
В `SettingsViewModel.kt` удалить:
|
||
```kotlin
|
||
val isRecordingEnabled: StateFlow<Boolean> = settingsRepository.isRecordingEnabled()
|
||
.stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), false)
|
||
```
|
||
и метод:
|
||
```kotlin
|
||
fun setRecordingEnabled(enabled: Boolean) {
|
||
viewModelScope.launch { settingsRepository.setRecordingEnabled(enabled) }
|
||
}
|
||
```
|
||
|
||
- [ ] **Шаг 4: Удалить из интерфейса SettingsRepository**
|
||
|
||
В `SettingsRepository.kt` удалить строки:
|
||
```kotlin
|
||
fun isRecordingEnabled(): Flow<Boolean>
|
||
suspend fun setRecordingEnabled(enabled: Boolean)
|
||
```
|
||
|
||
- [ ] **Шаг 5: Удалить из SettingsRepositoryImpl**
|
||
|
||
В `SettingsRepositoryImpl.kt` удалить ключ (строка 31):
|
||
```kotlin
|
||
private val RECORDING_ENABLED = booleanPreferencesKey("recording_enabled")
|
||
```
|
||
и реализации (строки 60-61):
|
||
```kotlin
|
||
override fun isRecordingEnabled(): Flow<Boolean> = dataStore.data.map { it[RECORDING_ENABLED] ?: false }
|
||
override suspend fun setRecordingEnabled(enabled: Boolean) { dataStore.edit { it[RECORDING_ENABLED] = enabled } }
|
||
```
|
||
|
||
- [ ] **Шаг 6: Компиляция (проверка, что ничего не ссылается)**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:compileSideloadDebugKotlin -q 2>&1 | tail -10; echo done
|
||
```
|
||
Ожидаемо: без ошибок (если есть «unresolved reference: isRecordingEnabled» —
|
||
осталась ссылка, удалить её).
|
||
|
||
- [ ] **Шаг 7: Коммит**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git add app/src/main/java/com/radiola/ui/settings/SettingsScreen.kt app/src/main/java/com/radiola/ui/settings/SettingsViewModel.kt app/src/main/java/com/radiola/domain/repository/SettingsRepository.kt app/src/main/java/com/radiola/data/repository/SettingsRepositoryImpl.kt
|
||
git commit -m "refactor(settings): убрать осиротевший тумблер «Запись эфира»"
|
||
```
|
||
|
||
---
|
||
|
||
### Задача 9: Тестер станций под BuildConfig.SHOW_DEV_TOOLS (G2)
|
||
|
||
**Files:** Modify `app/src/main/java/com/radiola/ui/settings/SettingsScreen.kt:495-561`
|
||
|
||
- [ ] **Шаг 1: Обернуть секцию тестирования в флаг**
|
||
|
||
В `SettingsScreen.kt` секцию `// --- Тестирование станций ---` (это `item { ... }`,
|
||
строки ~495-561) обернуть телом в условие. Изменить начало `item {` на:
|
||
```kotlin
|
||
// Диагностический тестер станций — только в sideload (dev-инструмент).
|
||
if (com.radiola.BuildConfig.SHOW_DEV_TOOLS) item {
|
||
```
|
||
(Остальное тело item'а без изменений.)
|
||
|
||
- [ ] **Шаг 2: Скрыть диалог отчёта в store (он зависит от testResults)**
|
||
|
||
Диалог `if (showReport) { AlertDialog(...) }` (строки ~565-615) оставить как есть —
|
||
в store `showReport` никогда не станет true (кнопка скрыта). Доп. правок не нужно.
|
||
Проверить, что `StationTestStatus`/`testResults` всё ещё импортируются (используются
|
||
диалогом) — компиляция покажет.
|
||
|
||
- [ ] **Шаг 3: Сборка обоих флейворов + проверка**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:compileStoreDebugKotlin :app:compileSideloadDebugKotlin -q 2>&1 | tail -10; echo done
|
||
```
|
||
Ожидаемо: без ошибок в обоих.
|
||
|
||
- [ ] **Шаг 4: Коммит**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git add app/src/main/java/com/radiola/ui/settings/SettingsScreen.kt
|
||
git commit -m "feat(settings): тестер станций только в sideload (SHOW_DEV_TOOLS)"
|
||
```
|
||
|
||
---
|
||
|
||
## ФАЗА 4 — Кнопка дип-линк-поиска SOVA (только sideload)
|
||
|
||
### Задача 10: Расширить дип-линк-архитектуру (packageName + прямое открытие)
|
||
|
||
**Files:**
|
||
- Modify `app/src/main/java/com/radiola/domain/model/DeeplinkService.kt`
|
||
- Modify `app/src/main/java/com/radiola/deeplink/DeeplinkNavigator.kt`
|
||
|
||
- [ ] **Шаг 1: Добавить packageName в DeeplinkService**
|
||
|
||
В `DeeplinkService.kt` изменить сигнатуру enum, добавив 4-й параметр со значением
|
||
по умолчанию (существующие записи не меняются):
|
||
```kotlin
|
||
enum class DeeplinkService(
|
||
val serviceId: String,
|
||
val displayName: String,
|
||
val searchUrlTemplate: String,
|
||
val packageName: String? = null
|
||
) {
|
||
```
|
||
(Записи YANDEX..DEEZER остаются как есть — `packageName` у них null.)
|
||
|
||
- [ ] **Шаг 2: Учесть packageName в DeeplinkNavigator**
|
||
|
||
В `DeeplinkNavigator.kt` заменить тело `openSearch`:
|
||
```kotlin
|
||
fun openSearch(context: Context, track: Track, service: DeeplinkService) {
|
||
val url = service.buildSearchUrl(track.artist, track.song)
|
||
val intent = Intent(Intent.ACTION_VIEW, Uri.parse(url))
|
||
val pkg = service.packageName
|
||
if (pkg != null) {
|
||
// Сторонний клиент: открыть напрямую в его пакете, если установлен.
|
||
val installed = try {
|
||
context.packageManager.getPackageInfo(pkg, 0); true
|
||
} catch (e: Exception) { false }
|
||
if (installed) {
|
||
intent.setPackage(pkg)
|
||
try {
|
||
context.startActivity(intent)
|
||
return
|
||
} catch (e: Exception) {
|
||
Log.e("DeeplinkNavigator", "Не удалось открыть в $pkg", e)
|
||
}
|
||
} else {
|
||
Toast.makeText(context, "${service.displayName} не установлено", Toast.LENGTH_SHORT).show()
|
||
return
|
||
}
|
||
}
|
||
// Обычные сервисы (или фолбэк) — системный выбор приложения.
|
||
try {
|
||
context.startActivity(Intent.createChooser(intent, "Открыть в..."))
|
||
} catch (e: Exception) {
|
||
Log.e("DeeplinkNavigator", "Failed to open deeplink", e)
|
||
Toast.makeText(context, "Не удалось открыть ссылку", Toast.LENGTH_SHORT).show()
|
||
}
|
||
}
|
||
```
|
||
|
||
- [ ] **Шаг 3: Компиляция**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:compileSideloadDebugKotlin -q 2>&1 | tail -10; echo done
|
||
```
|
||
Ожидаемо: без ошибок (поведение существующих сервисов не изменилось).
|
||
|
||
- [ ] **Шаг 4: Коммит**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git add app/src/main/java/com/radiola/domain/model/DeeplinkService.kt app/src/main/java/com/radiola/deeplink/DeeplinkNavigator.kt
|
||
git commit -m "feat(deeplink): поддержка прямого открытия в пакете стороннего сервиса"
|
||
```
|
||
|
||
---
|
||
|
||
### Задача 11: Добавить SOVA (пакет/схему добыть с телефона) + фильтр в store
|
||
|
||
**Files:**
|
||
- Modify `app/src/main/java/com/radiola/domain/model/DeeplinkService.kt`
|
||
- Modify `app/src/main/java/com/radiola/ui/player/PlayerBottomSheet.kt` (фильтр сервисов)
|
||
- Modify `app/src/main/java/com/radiola/ui/settings/SettingsScreen.kt` (фильтр сервисов)
|
||
|
||
**ЗАВИСИМОСТЬ:** нужен телефон с установленной SOVA по adb. Попросить у
|
||
пользователя полный `IP:порт` из «Беспроводная отладка».
|
||
|
||
- [ ] **Шаг 1: Подключить телефон и найти пакет SOVA**
|
||
|
||
```bash
|
||
export PATH="$PATH:/c/Users/nk/AppData/Local/Android/Sdk/platform-tools"
|
||
adb connect <IP:порт>
|
||
adb shell pm list packages -3 | sort
|
||
```
|
||
Определить пакет SOVA (как мод VK 6.12 — вероятно `com.vkontakte.android` или
|
||
вариант вроде `com.vk.sova`). Записать точное значение как `SOVA_PACKAGE`.
|
||
|
||
- [ ] **Шаг 2: Узнать, какой URL/схему SOVA перехватывает**
|
||
|
||
Дамп intent-фильтров пакета:
|
||
```bash
|
||
adb shell dumpsys package <SOVA_PACKAGE> | grep -iA3 "android.intent.action.VIEW" | grep -iE "scheme|host|vk" | head -30
|
||
```
|
||
Определить рабочий шаблон поиска. Кандидаты (проверить на устройстве в шаге 4):
|
||
- `https://vk.com/audio?q=%s`
|
||
- `https://vk.com/search?c[q]=%s&c[section]=audio`
|
||
Выбрать `SOVA_SEARCH_URL` — тот, что открывает поиск музыки В приложении.
|
||
|
||
- [ ] **Шаг 3: Добавить запись SOVA в DeeplinkService**
|
||
|
||
В `DeeplinkService.kt` добавить запись последней в enum (перед `;`), подставив
|
||
значения из шагов 1-2:
|
||
```kotlin
|
||
SOVA("sova", "SOVA", "<SOVA_SEARCH_URL>", packageName = "<SOVA_PACKAGE>");
|
||
```
|
||
(Запятую после DEEZER поставить, `;` перенести на строку SOVA.)
|
||
|
||
- [ ] **Шаг 4: Проверить на устройстве, что открывает поиск в SOVA**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:assembleSideloadDebug -q 2>&1 | tail -5; echo built
|
||
adb install -r app/build/outputs/apk/sideload/debug/app-sideload-debug.apk
|
||
```
|
||
Вручную: включить станцию с треком → плеер → кнопка SOVA → убедиться, что
|
||
открылся поиск трека В SOVA (не главный экран). Если открывается не то — вернуться
|
||
к шагу 2, подобрать другой `SOVA_SEARCH_URL`.
|
||
|
||
- [ ] **Шаг 5: Отфильтровать SOVA из store-сборки**
|
||
|
||
SOVA не должна показываться в store. В местах, где строится список сервисов,
|
||
исключить SOVA при `!SHOW_DEV_TOOLS`.
|
||
|
||
В `SettingsScreen.kt` — секция «МУЗЫКАЛЬНЫЕ СЕРВИСЫ», заменить
|
||
`DeeplinkService.entries.forEachIndexed { index, service ->` на проход по
|
||
отфильтрованному списку. Перед циклом добавить:
|
||
```kotlin
|
||
val services = DeeplinkService.entries.filter {
|
||
com.radiola.BuildConfig.SHOW_DEV_TOOLS || it != DeeplinkService.SOVA
|
||
}
|
||
```
|
||
и использовать `services.forEachIndexed { index, service ->` и
|
||
`services.size - 1` в условии разделителя.
|
||
|
||
В `PlayerBottomSheet.kt` — `servicesSection` использует `enabledServices` (из
|
||
настроек). Поскольку в store SOVA нельзя включить (её нет в списке настроек),
|
||
дополнительно подстраховаться: там, где формируется `enabledServices` во
|
||
`PlayerViewModel` (фильтр `DeeplinkService.entries.filter { it.serviceId in ids }`),
|
||
добавить тот же флаг. Найти место:
|
||
```bash
|
||
grep -rn "DeeplinkService.entries.filter" app/src/main/java/com/radiola/ui/player/PlayerViewModel.kt
|
||
```
|
||
и заменить на:
|
||
```kotlin
|
||
_enabledServices.value = DeeplinkService.entries.filter {
|
||
it.serviceId in ids &&
|
||
(com.radiola.BuildConfig.SHOW_DEV_TOOLS || it != DeeplinkService.SOVA)
|
||
}
|
||
```
|
||
|
||
- [ ] **Шаг 6: Проверить оба флейвора**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew :app:compileStoreDebugKotlin :app:compileSideloadDebugKotlin -q 2>&1 | tail -10; echo done
|
||
```
|
||
Ожидаемо: без ошибок. (Ручная проверка: в store-сборке SOVA нет в настройках;
|
||
в sideload — есть.)
|
||
|
||
- [ ] **Шаг 7: Коммит**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git add app/src/main/java/com/radiola/domain/model/DeeplinkService.kt app/src/main/java/com/radiola/ui/settings/SettingsScreen.kt app/src/main/java/com/radiola/ui/player/PlayerViewModel.kt
|
||
git commit -m "feat(deeplink): кнопка поиска в SOVA (только sideload)"
|
||
```
|
||
|
||
---
|
||
|
||
## ФАЗА 5 — Финальная сборка, проверка, релиз sideload
|
||
|
||
### Задача 12: Поднять версию и собрать оба release-флейвора
|
||
|
||
**Files:** Modify `app/build.gradle.kts` (versionCode/Name).
|
||
|
||
- [ ] **Шаг 1: Поднять версию**
|
||
|
||
В `app/build.gradle.kts`: `versionCode = 6` → `7`, `versionName = "1.5"` → `"1.6"`.
|
||
|
||
- [ ] **Шаг 2: Чистая сборка обоих release-флейворов**
|
||
|
||
```bash
|
||
cd C:/radiOLA && ./gradlew clean :app:assembleStoreRelease :app:assembleSideloadRelease -q 2>&1 | tail -12; echo done
|
||
ls -la app/build/outputs/apk/store/release/ app/build/outputs/apk/sideload/release/
|
||
```
|
||
Ожидаемо: оба APK собраны и подписаны release-ключом.
|
||
|
||
- [ ] **Шаг 3: Проверить критерии (разрешения + BuildConfig)**
|
||
|
||
```bash
|
||
AAPT="$ANDROID_HOME/build-tools/34.0.0/aapt"
|
||
echo "=== store: НЕТ REQUEST_INSTALL_PACKAGES ==="
|
||
"$AAPT" dump permissions app/build/outputs/apk/store/release/app-store-release.apk | grep -i INSTALL_PACKAGES || echo "OK — нет"
|
||
echo "=== store BuildConfig ==="
|
||
grep -E "ENABLE_SELF_UPDATE|SHOW_DEV_TOOLS" app/build/generated/source/buildConfig/store/release/com/radiola/BuildConfig.java
|
||
```
|
||
Ожидаемо: store — нет INSTALL_PACKAGES, `ENABLE_SELF_UPDATE=false`, `SHOW_DEV_TOOLS=false`.
|
||
|
||
- [ ] **Шаг 4: Коммит**
|
||
|
||
```bash
|
||
cd C:/radiOLA
|
||
git add app/build.gradle.kts
|
||
git commit -m "chore(app): bump версии до 7 / 1.6 (RuStore-релиз)"
|
||
git push
|
||
```
|
||
|
||
---
|
||
|
||
### Задача 13: Выпустить sideload-сборку через авто-обновление
|
||
|
||
(Чтобы текущие sideload-пользователи получили https-версию. Процесс — см.
|
||
память radiola-autoupdate: clean-сборка обязательна.)
|
||
|
||
- [ ] **Шаг 1: SHA256 sideload-release APK**
|
||
|
||
```bash
|
||
sha256sum app/build/outputs/apk/sideload/release/app-sideload-release.apk
|
||
```
|
||
Записать sha.
|
||
|
||
- [ ] **Шаг 2: Залить APK и обновить манифест версии**
|
||
|
||
```bash
|
||
scp app/build/outputs/apk/sideload/release/app-sideload-release.apk ru-server:/opt/radiola/appdist/downloads/radiola-latest.apk
|
||
ssh ru-server 'cd /opt/radiola/appdist && sha256sum downloads/radiola-latest.apk'
|
||
```
|
||
Сверить sha с шагом 1. Затем обновить `/opt/radiola/appdist/app-version.json`:
|
||
`version_code:7`, `version_name:"1.6"`, новый `sha256`, `download_url` (уже https),
|
||
`notes` про переезд на https / новые возможности.
|
||
|
||
- [ ] **Шаг 3: Проверить манифест по https**
|
||
|
||
```bash
|
||
curl -s https://api.radiola.nexaweb.su/app-version
|
||
```
|
||
Ожидаемо: `version_code:7`, sha совпадает с залитым APK.
|
||
|
||
---
|
||
|
||
### Задача 14: Действия пользователя в консоли RuStore
|
||
|
||
(Не код. Сопроводить пользователя; отметить выполнение.)
|
||
|
||
- [ ] Создать аккаунт разработчика RuStore.
|
||
- [ ] Загрузить `app/build/outputs/apk/store/release/app-store-release.apk`.
|
||
- [ ] Категория «Музыка и аудио», возрастной рейтинг 12+.
|
||
- [ ] Скриншоты, иконка 512×512, описание.
|
||
- [ ] Ссылка на политику: `https://api.radiola.nexaweb.su/privacy`.
|
||
- [ ] Заметка модератору: пояснить `USE_EXACT_ALARM` (будильник с радио) и
|
||
`REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` (фоновое воспроизведение в машине).
|
||
|
||
---
|
||
|
||
## Критерии готовности (проверяются по завершении)
|
||
1. `:app:assembleStoreRelease` — подписанный APK без `REQUEST_INSTALL_PACKAGES`, флаги false.
|
||
2. `:app:assembleSideloadRelease` — апдейтер на месте, SOVA и тестер присутствуют.
|
||
3. `https://api.radiola.nexaweb.su/app-version` — валидный TLS, version_code 7.
|
||
4. store-сборка работает против https-API (станции, now-playing, авторизация, Shazam).
|
||
5. `https://api.radiola.nexaweb.su/privacy` открывается.
|
||
6. Секреты (keystore, пароли) не в git (`git status` чист).
|
||
7. store: нет секции «Тестирование станций» и кнопки SOVA; sideload: есть.
|
||
8. Тумблера «Запись эфира» нет; запись эфира работает (кнопка плеера + вкладка).
|