Debugger Setup/ru

Настройка IDE

edit

Обновление со старой версии IDE

edit

Старые версии Lazarus предоставляли только бэкенд GdbMI. Настоятельно рекомендуется перейти на Fp-Debugger или LLDB+FpDebug в соответствии с указаниями для вашей операционной системы ниже.

Обратите внимание, что многие другие страницы вики могут быть устаревшими и по-прежнему ссылаться только на GDB.

Выбор правильного бэкенда отладчика

edit

IDE Lazarus предоставляет несколько отладчиков (бэкендов). На странице Статус бэкендов отладчика приведён общий обзор.

В списке ниже указано, какой бэкенд рекомендуется для вашей среды.

Операционная система Аппаратное обеспечение Рекомендуемый бэкенд отладчика Рекомендуемая отладочная информация Примечания
Windows 32/64 бит Intel/AMD i386 или x86_64 Fp-Debugger DWARF-3 Включает кросс-отладку 32-битного приложения на 64-битной системе
Windows 32 бит Кросс 64 бит Intel/AMD x86_64 GdbMi DWARF-2 с наборами Только кросс-отладка 64-битного приложения на 32-битной системе
Windows ARM / AArch64 / прочие GdbMi DWARF-2 с наборами Можно также попробовать «GdbMI+FpDebug»
Linux Intel/AMD i386 или x86_64 Fp-Debugger DWARF-3 Если RTL или пакеты содержат отладочную информацию, убедитесь, что она точно совпадает с типом, используемым в проекте
Linux ARM / AArch64 / прочие GdbMi DWARF-2 с наборами Можно также попробовать «GdbMI+FpDebug»
Mac Intel/AMD x86_64 AArch64 (например, M1) LLDB+FpDebug DWARF-3
Встраиваемые AVR Пакет FpDebug-avr DWARF-2 или 3 Требуется gdb-сервер
Удалённая отладка Любое, поддерживаемое GDB Gdb-Server DWARF-2 с наборами Отладка на другом ПК или виртуальной машине
Прочие Любое, поддерживаемое GDB GdbMi DWARF-2 с наборами
Любая ОС Отладка с перенаправлением STDIN/STDOUT (через «Параметры запуска», командная строка: >file < file) Любое, поддерживаемое GDB GdbMi DWARF-2 с наборами

Настройка бэкенда отладчика для IDE

edit

Следующие настройки выполняются один раз после установки Lazarus. Зачастую они уже заданы по умолчанию.

Настройки находятся по пути

Сервис > Параметры > Отладчик > Бэкенд отладчика

На изображении показано, где найти диалог настроек. На Mac диалог расположен в разделе «Настройки»

  • Выберите нужный бэкенд в верхней части страницы
  • Для Fp-Debugger указание пути не требуется.
  • Если вы используете отладчик на основе LLDB или Gdb(MI), необходимо указать путь к исполняемому файлу gdb или lldb в поле «Тип и путь отладчика»
    • В системах Linux/Unix/Mac это может быть что-то вроде «/usr/bin/gdb» или «/usr/bin/lldb»
    • В Windows файл должен находиться в папке «mingw\bin\» в каталоге, где установлен Lazarus.
  • На странице Статус бэкендов отладчика представлен список всех бэкендов с подробными сведениями о дополнительных настройках.
    • Для отладчика GdbMI в Lazarus 2.0 и выше включите параметр «FixIncorrectStepOver» в сетке свойств.

Бэкенд также можно задать в конфигурации конкретного проекта. Подробнее см. IDE_Window:_Project_Options_-_Debugger_Backend

Параметры проекта

edit

Для отладки проекта необходимо указать IDE компилировать его особым образом, предоставляя дополнительную информацию, необходимую отладчику.

Необходимые настройки выполняются в диалоге «Параметры проекта»:

  • Обратите внимание: это значительно увеличит размер исполняемого файла (См. FAQ). Если вы хотите собрать релизную версию программы, эти настройки следует отключить (см. также Режимы сборки)

  • Необходимо включить «Генерировать отладочную информацию для GDB»
  • Необходимо включить «Запуск использует отладчик (отключить для релизного режима)»
  • Рекомендуется установить «Тип отладочной информации» согласно рекомендациям для вашего ПК. Для сравнения различных версий DWARF см. Сравнение версий DWARF
    • Если указан неподдерживаемый тип, IDE предложит выбрать корректный параметр при попытке запустить отладчик.
    • Автоматически: Выбор остаётся за fpc. Не совместимо со всеми бэкендами.
    • Stabs: Устаревший формат. Поддерживается только GDB (возможно, LLDB без FpDebug). Использовать не рекомендуется.
    • Dwarf 2: Минимальная настройка. Не позволяет отображать значения типа «set of». Проблемы с определением PChar и AnsiString. Использовать не рекомендуется.
    • Dwarf 2 с наборами: Оптимизировано для GDB. Проблемы с определением PChar и AnsiString.
    • Dwarf 3: Наилучший вариант для FpDebug.
    • Ни один из вариантов в настоящее время не поддерживает отображение «property» с функцией-геттером.

  • Не следует включать «Использовать внешние отладочные символы»
    (рекомендация — не использовать этот параметр)
  • Нельзя включать «Удалить символы из исполняемого файла»

Можно использовать «Режимы сборки». Кнопка «...» открывает диалог для создания режимов «release» и «debug». В этом случае всё равно следует проверить значение «Тип отладочной информации».

  • Используйте оптимизацию «Уровень 0» («Уровень 1» допустим, но в некоторых случаях может вызывать проблемы)
    • Не используйте «Link Smart»

Версия GDB / LLDB

edit

GDB 7.5 требует Lazarus 1.4 или выше.

GDB 7.7.1, по всей видимости, хорошо работает с Lazarus 1.2.4.

На macOS: lldb входит в состав инструментов разработчика Apple.

См. также

edit