chore(app): bump 9 / 1.8 (фикс восстановления потока после смены сети)

Причина «падений через 10-15 мин в машине»: при смене сети (Wi-Fi↔LTE) или долгом
обрыве поток рвался, а переподключение СДАВАЛОСЬ навсегда после 10 попыток (~100с),
и не было реакции на возврат сети → радио не оживало, foreground-сервис отваливался,
процесс убивала система (это выглядело как «падение», хотя крэша не было).

- scheduleReconnect больше не сдаётся: переподключается, пока пользователь хочет
  играть (флаг intendedToPlay; пауза/стоп его снимают).
- Добавлен ConnectivityManager.registerDefaultNetworkCallback: при возврате/смене
  сети мгновенно re-prepare потока, не дожидаясь бэк-оффа.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

.gitignore

@@ -34,3 +34,8 @@ keystore.properties
 # Логотип: промежуточные генерации (тяжёлые), ключ — вне репо
 design/logos/gen/
 design/logos/ref_*.png
+
+# Скрэтч-папка (картинки, HTML-эксперименты, мокапы RuStore) — не версионируем
+tempfiles/
+# ...кроме дизайн-файла Pencil — он остаётся под версией
+!tempfiles/radiOLA.pen

app/build.gradle.kts

@@ -23,8 +23,8 @@ android {
         applicationId = "com.radiola"
         minSdk = 26
         targetSdk = 34
-        versionCode = 7
+        versionCode = 9
-        versionName = "1.6"
+        versionName = "1.8"
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
         vectorDrawables {

app/src/main/java/com/radiola/MainActivity.kt

@@ -109,6 +109,19 @@ class MainActivity : ComponentActivity() {
                 val isRecording by playerViewModel.isRecording.collectAsState()
                 val isLoggedIn by tokenDataStore.isLoggedIn.collectAsState(initial = false)
 
+                // Возврат на передний план → мгновенно освежаем now-playing
+                // (фоновая заморозка ColorOS может останавливать опрос эфира).
+                val lifecycleOwner = androidx.compose.ui.platform.LocalLifecycleOwner.current
+                DisposableEffect(lifecycleOwner) {
+                    val obs = androidx.lifecycle.LifecycleEventObserver { _, event ->
+                        if (event == androidx.lifecycle.Lifecycle.Event.ON_RESUME) {
+                            playerViewModel.onAppForeground()
+                        }
+                    }
+                    lifecycleOwner.lifecycle.addObserver(obs)
+                    onDispose { lifecycleOwner.lifecycle.removeObserver(obs) }
+                }
+
                 // --- Авто-обновление: проверяем версию на старте, показываем диалог ---
                 var pendingUpdate by remember { mutableStateOf<com.radiola.update.VersionInfo?>(null) }
                 var updateState by remember { mutableStateOf(com.radiola.ui.update.UpdateState.IDLE) }
@@ -357,10 +370,11 @@ class MainActivity : ComponentActivity() {
 
     private fun maybeRequestBatteryExemption() {
         val pm = getSystemService(Context.POWER_SERVICE) as android.os.PowerManager
-        if (pm.isIgnoringBatteryOptimizations(packageName)) return
-        // Спрашиваем один раз на установку, чтобы не надоедать.
         val prefs = getSharedPreferences("radiola_prefs", MODE_PRIVATE)
-        if (prefs.getBoolean("battery_opt_asked", false)) return
+        // Спрашиваем один раз на установку, чтобы не надоедать.
+        if (!pm.isIgnoringBatteryOptimizations(packageName) &&
+            !prefs.getBoolean("battery_opt_asked", false)
+        ) {
             prefs.edit().putBoolean("battery_opt_asked", true).apply()
             runCatching {
                 startActivity(
@@ -371,4 +385,49 @@ class MainActivity : ComponentActivity() {
                 )
             }
         }
+        maybeGuideColorOsBackground()
+    }
+
+    /**
+     * ColorOS/OxygenOS (Oppo, OnePlus, Realme) агрессивно «схлопывают» приложение в
+     * фоне при выключённом экране — стандартного исключения из оптимизации батареи
+     * мало. Реально помогает галочка «Разрешить работу в фоновом режиме» в разделе
+     * «Использование батареи» приложения. Прямого API для неё нет, поэтому один раз
+     * показываем пояснение и открываем экран настроек приложения, чтобы юзер включил.
+     */
+    private fun maybeGuideColorOsBackground() {
+        val m = android.os.Build.MANUFACTURER.lowercase()
+        val isColorOs = m.contains("oppo") || m.contains("oneplus") || m.contains("realme")
+        if (!isColorOs) return
+        val prefs = getSharedPreferences("radiola_prefs", MODE_PRIVATE)
+        if (prefs.getBoolean("bg_activity_guided", false)) return
+        prefs.edit().putBoolean("bg_activity_guided", true).apply()
+        runCatching {
+            android.app.AlertDialog.Builder(this)
+                .setTitle("Фоновое воспроизведение")
+                .setMessage(
+                    "На вашем устройстве система может выгружать приложение при " +
+                        "выключённом экране, и радио прерывается.\n\n" +
+                        "Чтобы этого не происходило, откройте «Использование батареи» " +
+                        "и включите «Разрешить работу в фоновом режиме»."
+                )
+                .setPositiveButton("Открыть настройки") { _, _ -> openAppBatterySettings() }
+                .setNegativeButton("Позже", null)
+                .show()
+        }
+    }
+
+    /** Экран «Использование батареи» приложения; фолбэк — страница «О приложении». */
+    private fun openAppBatterySettings() {
+        val uri = android.net.Uri.parse("package:$packageName")
+        val candidates = listOf(
+            // На части ColorOS открывает прямо управление батареей приложения.
+            Intent("android.settings.APP_BATTERY_SETTINGS").apply { data = uri },
+            // Универсальный фолбэк — «О приложении», оттуда «Использование батареи».
+            Intent(android.provider.Settings.ACTION_APPLICATION_DETAILS_SETTINGS, uri)
+        )
+        for (intent in candidates) {
+            if (runCatching { startActivity(intent); true }.getOrDefault(false)) return
+        }
+    }
 }

app/src/main/java/com/radiola/service/PlayerController.kt

@@ -4,6 +4,8 @@ import android.content.Context
 import android.media.AudioDeviceCallback
 import android.media.AudioDeviceInfo
 import android.media.AudioManager
+import android.net.ConnectivityManager
+import android.net.Network
 import android.net.Uri
 import androidx.media3.common.AudioAttributes
 import androidx.media3.common.C
@@ -90,6 +92,31 @@ class PlayerController @Inject constructor(
     private var retryCount = 0
     private var reconnectJob: Job? = null
 
+    // Намерение играть: пользователь включил станцию и не ставил паузу/стоп.
+    // По нему решаем, переподключаться ли после обрыва — НЕ сдаёмся навсегда.
+    @Volatile private var intendedToPlay = false
+
+    // Слушатель сети: возврат/смена сети (Wi-Fi↔LTE в машине, выход из туннеля)
+    // мгновенно переподключает поток, не дожидаясь бэк-оффа. Главная причина, по
+    // которой радио раньше «не оживало» после смены сети.
+    private val connectivityManager =
+        context.getSystemService(ConnectivityManager::class.java)
+    private val networkCallback = object : ConnectivityManager.NetworkCallback() {
+        override fun onAvailable(network: Network) {
+            if (!intendedToPlay) return
+            // Колбэк — на системном потоке; ExoPlayer трогаем на main (timerScope).
+            timerScope.launch {
+                if (!exoPlayer.isPlaying) {
+                    retryCount = 0
+                    runCatching {
+                        exoPlayer.prepare()
+                        exoPlayer.playWhenReady = true
+                    }
+                }
+            }
+        }
+    }
+
     private companion object {
         const val FADE_MS = 20_000L // длительность плавного затухания в конце таймера
         const val CROSSFADE_MS = 90_000L // переход радио → звук для сна (внутри аутро)
@@ -212,7 +239,10 @@ class PlayerController @Inject constructor(
      */
     private fun scheduleReconnect() {
         reconnectJob?.cancel()
-        if (retryCount >= 10) return
+        // Пока пользователь хочет играть — пробуем переподключаться бесконечно
+        // (с бэк-оффом до 15с). Раньше сдавались навсегда после 10 попыток (~100с) →
+        // длинный туннель/смена сети глушили радио до ручного перезапуска.
+        if (!intendedToPlay) return
         val delayMs = (2_000L * (retryCount + 1)).coerceAtMost(15_000L)
         retryCount++
         reconnectJob = timerScope.launch {
@@ -244,6 +274,7 @@ class PlayerController @Inject constructor(
 
     init {
         audioManager.registerAudioDeviceCallback(audioDeviceCallback, null)
+        runCatching { connectivityManager?.registerDefaultNetworkCallback(networkCallback) }
     }
 
     fun play(url: String, stationPrefix: String, stationName: String, stationId: Int? = null) {
@@ -251,6 +282,7 @@ class PlayerController @Inject constructor(
         // Новая станция — сбрасываем переподключение предыдущего потока.
         reconnectJob?.cancel()
         retryCount = 0
+        intendedToPlay = true
         _currentStationId.value = stationId
         _icyTitle.value = null
         val mediaItem = MediaItem.Builder()
@@ -412,17 +444,19 @@ class PlayerController @Inject constructor(
     }
 
     fun pause() {
-        // Пауза пользователем — отменяем отложенное переподключение, иначе оно
+        // Пауза пользователем — больше не хотим играть, отменяем переподключение.
-        // позже само возобновит воспроизведение.
+        intendedToPlay = false
         reconnectJob?.cancel()
         exoPlayer.pause()
     }
 
     fun play() {
+        intendedToPlay = true
         exoPlayer.play()
     }
 
     fun stop() {
+        intendedToPlay = false
         reconnectJob?.cancel()
         exoPlayer.stop()
         _currentStationPrefix.value = null
@@ -432,6 +466,7 @@ class PlayerController @Inject constructor(
     fun release() {
         timerScope.cancel()
         audioManager.unregisterAudioDeviceCallback(audioDeviceCallback)
+        runCatching { connectivityManager?.unregisterNetworkCallback(networkCallback) }
         sleepSoundPlayer.stop()
         exoPlayer.release()
     }

app/src/main/java/com/radiola/ui/player/PlayerViewModel.kt

@@ -118,6 +118,20 @@ class PlayerViewModel @Inject constructor(
         viewModelScope.launch {
             settingsRepository.getPreferredBitrate().collect { preferredBitrate = it }
         }
+        // Восстановление сессии: если процесс/Activity пересоздались, а станция уже
+        // играет в фоновом сервисе (PlayerController помнит id) — заново привязываемся
+        // и запускаем опрос now-playing. Иначе мини-плеер/эфир «застывают».
+        viewModelScope.launch {
+            combine(playerController.currentStationId, _stations) { id, list ->
+                id?.let { sid -> list.firstOrNull { it.id == sid } }
+            }.collect { station ->
+                if (station != null && _currentStation.value == null) {
+                    _currentStation.value = station
+                    _playlist.value = _stations.value
+                    startNowPlaying(station)
+                }
+            }
+        }
         viewModelScope.launch {
             _currentTrack
                 .filterNotNull()
@@ -150,8 +164,20 @@ class PlayerViewModel @Inject constructor(
             playerController.play(url, station.prefix, station.name, station.id)
         }
         viewModelScope.launch { pushHistoryUseCase(station.id) }
+        startNowPlaying(station)
+    }
+
+    /**
+     * Запускает опрос now-playing для станции: мгновенный рефреш + цикл раз в 5с
+     * (пока играем) + сбор трека из API (приоритет) и ICY (фолбэк). Вынесено из
+     * play(), чтобы переиспользовать при восстановлении сессии (возврат из фона /
+     * пересоздание ViewModel) — иначе эфир «застывает» на последнем значении.
+     */
+    private fun startNowPlaying(station: Station) {
         nowPlayingJob?.cancel()
         nowPlayingJob = viewModelScope.launch {
+            // Сразу тянем свежий эфир — не ждём первые 5с цикла.
+            launch { nowPlayingRepository.refreshNowPlaying() }
             // Поллинг now-playing — ТОЛЬКО пока играем. collectLatest отменяет
             // внутренний цикл при паузе (иначе на паузе радио зря дёргали сеть
             // каждые 5с → батарея + лишняя нагрузка на бэкенд).
@@ -208,6 +234,17 @@ class PlayerViewModel @Inject constructor(
         }
     }
 
+    /**
+     * Возврат приложения на передний план: мгновенно освежаем эфир (чтобы юзер не
+     * видел залипший трек после фоновой заморозки) и, если опрос почему-то не идёт,
+     * перезапускаем его для текущей станции.
+     */
+    fun onAppForeground() {
+        val station = _currentStation.value ?: return
+        viewModelScope.launch { nowPlayingRepository.refreshNowPlaying() }
+        if (nowPlayingJob?.isActive != true) startNowPlaying(station)
+    }
+
     /** Стартовое качество станции с учётом предпочтения пользователя. */
     private fun pickInitialQuality(station: Station): StreamQuality? {
         val list = station.qualities

docs/rustore-listing.md

@@ -0,0 +1,83 @@
+# Карточка radiOLA для RuStore
+
+Дата: 2026-06-08. Черновик контента и ассетов для публикации в RuStore.
+Связано: [дизайн релиза](superpowers/specs/2026-06-08-rustore-release-design.md), раздел F.
+
+## Основное
+
+| Поле | Значение |
+|---|---|
+| Название в Консоли (внутреннее, не меняется) | `radiOLA` |
+| Название для пользователей | `radiOLA — радио онлайн` |
+| Тип приложения | Универсальное |
+| Тип монетизации | Бесплатное |
+| Категория | Музыка и аудио |
+| Возрастной рейтинг | 12+ (возможна ненормативная лирика в потоках) |
+| Политика конфиденциальности | `https://api.radiola.nexaweb.su/privacy` (⏳ захостить) |
+
+## Страны и регионы
+
+Россия, Беларусь, Казахстан, Кыргызстан, Армения (в каталоге есть белорусские
+станции — Unistar, Новое Радио BY).
+
+## Краткое описание
+
+```
+Онлайн-радио: сотни станций, тексты песен, распознавание треков, запись эфира
+```
+
+## Полное описание
+
+```
+radiOLA — удобный плеер интернет-радио с сотнями станций и умными функциями.
+
+• Сотни радиостанций — музыка, новости, разговорные
+• Что играет сейчас: трек, исполнитель и обложка в реальном времени
+• Чарты популярных треков на радио — что крутят чаще всего, с фильтром
+  по жанрам и периодам, трендами роста и графиком популярности
+• Тексты песен прямо во время эфира
+• Распознавание треков (даже без метаданных станции)
+• Быстрый поиск играющего трека в Яндекс Музыке, ВК Музыке, Spotify,
+  Apple Music, YouTube Music, BOOM, Tidal и Deezer — одним касанием
+• История прослушанного и распознанных песен
+• Запись эфира с перемоткой и тайм-кодами
+• Эквалайзер и улучшайзеры звука
+• Таймер сна и будильник с радио
+• Выбор качества потока, 8 цветовых тем
+• Фоновое воспроизведение, управление с локскрина
+```
+
+## Ассеты (готовы)
+
+Папка: `tempfiles/screensforRuStore/out/`
+
+| Файл | Назначение |
+|---|---|
+| `icon_512.png` | Иконка 512×512 (тема forest, композит ic_bg/ic_fg_forest) |
+| `rustore_1.png` | Каталог станций |
+| `rustore_2.png` | Плеер + поиск трека в сервисах |
+| `rustore_3.png` | Чарты |
+| `rustore_4.png` | Тексты песен |
+| `rustore_5.png` | Записи эфира |
+| `rustore_6.png` | Эквалайзер |
+| `rustore_7.png` | Таймер сна |
+| `rustore_8.png` | Будильник / настройки |
+
+Пересборка скриншотов: `tempfiles/screensforRuStore/gen.py` → `html/` → headless Chrome.
+
+## Заметка модератору
+
+- `SCHEDULE_EXACT_ALARM`/`USE_EXACT_ALARM` — будильник с радио (точное время срабатывания).
+- `REQUEST_IGNORE_BATTERY_OPTIMIZATIONS` — фоновое воспроизведение при выключенном
+  экране / в машине. Готовы убрать по требованию модерации.
+- Приложение-агрегатор: воспроизводит публичные интернет-радиопотоки третьих лиц.
+
+## Блокеры загрузки версии (из плана реализации)
+
+1. HTTPS-домен `api.radiola.nexaweb.su` (DNS + Caddy).
+2. Сервер: страница `/privacy`, https в `app-version.json`.
+3. Gradle: flavors `store`/`sideload` + signingConfig release.
+4. Манифест: `REQUEST_INSTALL_PACKAGES` → sideload.
+5. Код: gate апдейтера, baseUrl → https, чистка настроек, SOVA (sideload).
+6. Keystore (генерирует пользователь).
+7. Сборка `:app:assembleStoreRelease`.