Describe Android log retention and diagnostic output contracts

This commit is contained in:
evgeny committed 2026-10-28 12:28:28 +01:00
1 parent 4da2f321d6
commit 959e91ad4e
3 files changed
+18 -3

No files matched your search

@@ -35,7 +35,7 @@ internal class LogHistory(private val capacity: Int) {
}
/** Общий буфер последних 100000 строк Kotlin/JNI; состояние переживает Activity, при завершении процесса теряется.
* addLog потокобезопасен и пишет в logcat с указанной важностью, без native-фильтра категорий/доставки в файл или UDP.
* addLog потокобезопасен: TRACE..ERROR сохраняют важность logcat, прочие level идут как DEBUG; native-фильтр/файл/UDP не используются.
* revision — объединяемое уведомление для чтения снимка getRecent(), поэтому задержка UI не теряет строки в очереди событий.
*/
object LogManager {
@@ -69,7 +69,7 @@ object LogManager {
return history.getRecent(count)
}
/** JNI передаёт bridge-уровни 0=TRACE..4=ERROR, уже преобразованные из DEBUG_LEVEL_* и прошедшие native-фильтр.
/** JNI передаёт bridge-уровни 0=TRACE..4=ERROR; DEBUG_* преобразуются и фильтруются в C, собственные bridge-логи могут обходить фильтр.
* Неизвестный уровень записывается предупреждением с исходным значением; null category/message заменяются пустыми строками. */
fun onNativeLog(level: Int, category: String?, message: String?) {
val lvl = when (level) {
@@ -20,7 +20,9 @@ import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import androidx.compose.ui.unit.sp
/* Градиент привязан ко всей ширине: низкая нагрузка зелёная, полная доходит до красного. */
/** Индикатор 60×24 dp: percent ограничивается 0..100 и используется для заполнения, подписи и accessibility.
* Градиент привязан ко всей ширине: низкая нагрузка зелёная, полная доходит до красного.
* Компонент только отображает переданное значение; CPU измеряет владелец состояния. */
@Composable
fun CpuLoadIndicator(percent: Int, modifier: Modifier = Modifier) {
val value = percent.coerceIn(0, 100)
+13
View File
@@ -198,6 +198,19 @@ DEBUG_* фильтруются общими уровнями/категория
Target — числовой IPv4; attach/detach таймера выполняет uasync worker при каждом запуске/рестарте.
Ошибки самого UDP-логгера идут в отдельный utun-udplog, минуя debug hook.
LogManager хранит последние 100000 строк в памяти процесса, в порядке приёма.
Прямой Kotlin addLog сохраняет важность logcat, но не проходит native-фильтр
и не доставляет строку в native-файл/UDP. videoDebug/videoTrace проходят общий
video-фильтр через JNI. JNI callback получает уровни bridge 0=TRACE..4=ERROR,
а не числовые DEBUG_LEVEL_*; неизвестный уровень фиксируется предупреждением.
Экран логов показывает последние 10000 строк истории, обновляя снимок не чаще
кадра. StateFlow передаёт объединяемую ревизию, строки читаются из общей истории:
задержка UI и открытие экрана после последнего сообщения не теряют строки
в отдельной очереди событий. Лимиты истории/экрана всё равно вытесняют старые строки.
Фильтр выбирает точный уровень; пауза отключает только прокрутку, сбор продолжается.
Автопрокрутка следует последней видимой строке после фильтрации и возобновления.
## Linux headless и проверки
Каталог `headless/` — отдельный каркас: headless_main запускает select-loop и JSON-line