Describe Android log retention and diagnostic output contracts
This commit is contained in:
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) {
|
||||
|
||||
+3
-1
@@ -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)
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in new issue
Block a user