​

Ziva на встроенных системах

​

Базовая конфигурация

func init() {
    ziva.SetDefaultLanguage("ru")
    ziva.AutoConfigure()
    ziva.EnableEmbeddedMode()
    ziva.EnableASCIIMode() // если терминал не поддерживает Unicode
}

​

Переменные окружения

export ZIVA_MEMORY_PRESSURE_THRESHOLD=48M
export ZIVA_MAX_COMPLETED_TASKS=5
export ZIVA_LANG=ru

• ZIVA_MEMORY_PRESSURE_THRESHOLD — порог, при котором очередь начнёт освобождать память.
• ZIVA_MAX_COMPLETED_TASKS — сколько завершённых задач хранить в истории.
• ZIVA_LANG — принудительный язык интерфейса.

​

Минималистичный вывод

queue := ziva.NewQueue("Конфигурация роутера")
queue.
  WithAppName("RouterSetup").
  WithOutSummary().
  WithOutResultLine().
  WithTasksNumbered(false, "")

​

Работа с таймаутами

confirm := ziva.NewYesNoTask("Подтверждение", "Перезапустить сервис?").
    WithDefaultNoAndTimeout(10 * time.Second)

​

ASCII и шрифты

1. Включите EnableASCIIMode().
2. Настройте локаль и шрифты (см. раздел «Установка»).
3. Избегайте символов псевдографики в собственных сообщениях.

​

Логи и диагностика

• Для долговременных логов используйте отдельный файл/удалённый syslog. Не выводите большие дампы в интерфейс Ziva.
• Добавьте FuncTask, который проверяет доступность внешних ресурсов (например, сеть) перед запуском основной процедуры.

testConnection := ziva.NewFuncTask("Проверка сети", checkWAN,
    ziva.WithStopOnError(true),
)

​

Рекомендации

• Не перегружайте очередь. 4–6 задач в одном сценарии — оптимальный баланс для маленьких экранов.
• Сохраняйте состояние. После queue.Run() сохраняйте результаты в конфигурационных файлах, чтобы устройство могло работать автономно.
• Используйте предустановленные цвета. Встроенный режим подбирает безопасные оттенки для низкоскоростных терминалов.
• Проверяйте ширину экрана. Ограничьте viewport (WithViewport) и держите описания короткими.

​

Дополнительно

• Цветовые схемы
• Функции автоконфигурации