This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English

调试游戏逻辑

Defold 内置集成式 Lua 调试器及检视工具. 加上内置的分析工具构成强大工具集帮你快速找到逻辑错误和性能问题.

打印输出与可视调试

Defold 最基础的调试功能是控制台打印输出. 使用 print() 或 pprint() 来检查变量值或者逻辑流程. 如果有个游戏对象不正常, 只需要将包含调试代码的脚本组件拖上去就行了. 打印输出函数会把信息发送到编辑器的 控制台 与游戏日志中.

更进一步来说, 引擎有绘制调试信息的功能, 可以显示文字和画线. 用此功能需要向 @render 接口发送消息:

-- 把变量 "my_val" 画在屏幕上
msg.post("@render:", "draw_text", { text = "My value: " .. my_val, position = vmath.vector3(200, 200, 0) })

-- 画出带颜色的文字
local color_green = vmath.vector4(0, 1, 0, 1)
msg.post("@render:", "draw_debug_text", { text = "Custom color", position = vmath.vector3(200, 180, 0), color = color_green })

-- 在主角和敌人之间画一条线
local start_p = go.get_position("player")
local end_p = go.get_position("enemy")
local color_red = vmath.vector4(1, 0, 0, 1)
msg.post("@render:", "draw_line", { start_point = start_p, end_point = end_p, color = color_red })

调试绘制与普通的渲染处于同一个渲染管线之上.

"draw_line" 实际是是使用渲染脚本的 render.draw_debug3d() 函数进行绘制的.
"draw_text" 使用的是 /builtins/fonts/debug/always_on_top.font 字体和 /builtins/fonts/debug/always_on_top_font.material 材质.
"draw_debug_text" 与 "draw_text" 类似, 只是可以自定义文字颜色.

注意一般调试信息都需要实时更新所以把它们放在 update() 函数中是个好主意.

Running the debugger

一种办法是通过 Debug ▸ Run with Debugger 运行游戏并且自动接入调试器, 另一种是通过 Debug ▸ Attach Debugger 把调试器接入正在运行中的游戏上.

overview

调试器接入后, 就可以使用控制台上的调试控制按钮, 或者使用 Debug 菜单了:

Break: 立即断下游戏. 游戏于此点暂停. 此时可以观察游戏状态, 逐步运行, 或者运行到下一个断点. 断点会在代码编辑器上标识出来:
Continue: 继续运行游戏. 直到按下暂停键或者遇到断点. 如果遇到断点停下, 运行点会在代码编辑器的断点标识之上标识出来:
Stop: 停止调试. 立即停止调试, 断开调试器, 关闭游戏.
Step Over: 步越. 步进时如果运行到某个 Lua 函数, 步越 不会进入这个函数 而是执行它然后停在函数下一行上. 图中, 如果用户按下 “step over”, 调试器会执行代码直至调用 nextspawn() 函数下面的 end 位置处: