LoggerSystem (Unity)

Namespace: Vortex.Unity.LoggerSystem Сборка: ru.vortex.unity.logger Платформа: Unity 2021.3+

---

Назначение

Unity-драйвер для Log. Маршрутизирует LogData в Debug.Log / Debug.LogWarning / Debug.LogError с форматированием [source] message.

Возможности:

• Автоматическая регистрация драйвера (runtime и editor)
• Маппинг LogLevel → Debug.Log*
• Форматирование с именем источника в квадратных скобках

Вне ответственности:

• Определение уровней логирования — Core
• API логирования — Core (Log.Print)

---

Зависимости

---

Архитектура

LogDriver : IDriver (partial)
  ├── [RuntimeInitializeOnLoadMethod] Run()     ← runtime-регистрация
  ├── Print(LogData)                             ← маппинг LogLevel → Debug.Log*
  ├── Init() / Destroy()                         ← ISystemDriver lifecycle
  └── (Editor partial)
       └── [InitializeOnLoad] static LogDriver() ← editor-регистрация

Регистрация

Editor-расширение выводит подтверждающее сообщение Warning при подключении.

Маппинг уровней

Формат вывода

[SourceName] Message text

Source обрабатывается: если string — используется напрямую, иначе — Source.GetType().Name, при null — "Unknown" (log.Source as string ?? log.Source?.GetType().Name ?? "Unknown").

---

Контракт

Вход

• LogData от ядра через IDriver.Print()

Выход

• Сообщение в Unity Console с соответствующим уровнем

Ограничения

---

Использование

Драйвер регистрируется автоматически. Дополнительная настройка не требуется.

// Вызов из любого места проекта
Log.Print(LogLevel.Common, "Player spawned", this);
Log.Print(LogLevel.Error, "Save file corrupted", "SaveSystem");

Результат в Unity Console:

[PlayerController] Player spawned
[SaveSystem] Save file corrupted    (красный)

---

Граничные случаи