Ru/Dota 2 Workshop Tools/Scripting/Debugging Lua scripts

From Valve Developer Community
Jump to navigation Jump to search

Начало

Отладчик Lua использует сборку Eclipse LDT.

Настройка отладки содержит следующие шаги:

  • Установка Eclipse LDT
  • Создание и настройка нового проекта
  • Настройка новой конфигурации отладчика
  • Открытие окна отладки
  • Подлкючение отладчика Eclipse LDT к игре

Установка Eclipse LDT

  • Скачайте Eclipse LDT со страницы: https://eclipse.org/ldt/.
  • Распакуйте содержимое архива в папку.
  • Из распакованной папки запустите исполняемый файл LuaDevelopmentTools.exe. Выберете папку для workspace(рабочее пространство), где Eclipse LDT будет хранить информацию о проектах.

Настройка нового проекта LDT

  • Нажмите File->New->Lua Project, чтобы открыть меню создания нового проекта
  • Задайте имя проекта
  • Во вкладке Contents, выберете "Create project at existing location...," и выберете директорию вашей карты dota2, например \Steam\steamapps\common\dota 2 beta\game\dota_addons\holdout_example_1.

Luanewproj.png

  • Нажмите Next. Eclipse LDT просканирует содержимое директории, это может занять некоторое время. Когда сканирование завершится, игнорируйте предупреждение "Your project has no source folder defined," и нажмите Finish.
  • Теперь в Script Explorerе можно открывать lua скрипты и ставить точки останова, два раза щелкнув на поле строки кода.

Breakpoint.png

  • Также рекомендуется включить показ номеров строк. Для этого нажмите Window->Preferences->General->Editors->Text Editors->Поставить галочку на строке Show line numbers.

Настройка конфигурации отладки для проекта LDT

  • Нажмите Run->Debug Configurations, чтобы открыть диалог конфигурации Debug Configurations
  • Выберете "Lua Attach to Application"
  • Нажмите "New launch configuration"

Luanewcfg.png

  • Задайте новое имя конфигурации
  • Установите "IDE key" на "server", или "client", чтобы запускать скрипт на сервере или клиенте, соответственно.
  • Установите в Timeout(s) большое значение.
  • Нажмите "Apply". Закройте диалог конфигурации Debug Configurations.

Luadebugcfg.png

Открытие режима отладки в LDT

Чтобы открыть режим отладки нажмите Window->Perspective->Open Perspective->Debug, либо щелкните на кнопку Debug в правом верхнем углу. Debug perspective.png

Подключение отладчика LDT к игре

  • Запустите игру и дождитесь запуска frame loop. Встроенный отладчик запускается только в течение frame loop, отладчик LDT может не дождаться ответа от встроенного отладчика игры, если это займет много времени.(поэтому и ставим большое значение time out в настройках)
  • Click the drop-down arrow next to the bug icon and select Debug Configurations.

Luastartdbg.png

  • In the Debug Configurations dialog, select the configuration you just created, and hit Debug. Recently used configurations appear in the bug icon drop-down, for quick access.
  • In VConsole2, type "script_attach_debugger" to debug the server VM, or "cl_script_attach_debugger" to debug the client VM. Note that for this to work, the Debug Configuration selected must have the IDE key set to "server" and "client" respectively.

Using the LDT debugging UI

LDT user guide - Debugging a Lua program