Сервис логирования предназначен для вывода отладочных, информационных и других типов сообщений в системный лог устройства. Логирование осуществляется через вспомогательный класс FGX.Log.TfgLog.
Каждое сообщение, отправляемое в лог, имеет свой уровень.
Доступно 5 уровней логирования (отсортированы по значимости):
TfgLogLevel.Debug- отладочное сообщение.TfgLogLevel.Info- информационное сообщение, предназначено для информирования о протекающих процессах в вашем приложении.TfgLogLevel.Warning- предупреждение о потенциальной ошибке.TfgLogLevel.Error- ошибка, которая не приводит к прекращению работы приложения, однако, может являться причиной последующих фатальных ошибок.TfgLogLevel.Fatal- фатальная ошибка, приводящая к остановке работы приложения.
Для каждого уровня доступен отдельный метод:
TfgLog.Debug('Соединение с сервером установлено.');
Для удобства логирования значений существуют перегруженные версии методов со встроенной функцией "Format":
if Control.RefCount > 1 then
TfgLog.Warning('Удаляется контрол [%s:%s] по окончании анимации, однако не все ссылки на контрол сброшены ' +
'разработчиком. Убедитесь, что вы удалили все ссылки на контрол сразу после вызова анимации с ' +
'опцией ReleaseOnFinish.', [Control.Name, Control.ClassName]);
Фильтрация логов
Зачастую при разработке вашего приложения вы можете использовать большое количество отладочных сообщений. Однако, для релиза эти сообщения не нужны. Для фильтрации логов существует свойство MinimumLevel, позволяющее отсечь сообщения с уровнем ниже указанного в этом свойстве.
Настройки по умолчанию:
- для "Debug" конфигурации, в лог попадают сообщения всех уровней
- для "Release" конфигурации, в лог попадают сообщения всех уровней, кроме отладочных
Вы всегда можете изменить эти параметры при помощи свойства MinimumLevel.
Чтение логов
Чтение системных логов с Android устройства:
- через командную утилиту "logcat": https://developer.android.com/studio/command-line/logcat
- через "Android Studio": https://developer.android.com/studio/debug/am-logcat.html