使用 ZeroBrane Studio 和 Eclipse LDT 断点调试 quick-cocos2d-x

使用 ZeroBrane Studio 和 Eclipse LDT 断点调试 quick-cocos2d-x

quick-cocos2d-x 是个基于 cocos2d-x 的 Lua Binding 加强版。本文介绍在quick-cocos2d-x中进行断点调试的方法。

为了便于阅读和减少废话，本文有如下假设：

1. 读者阅读过 quick-x-player 使用说明 和 初窥 Quick-cocos2d-x ;
2. 读者了解 quick-cocos2d-x 项目的文件夹结构；
3. 读者安装了 ZeroBrane Studio 0.39 或/和 Eclipse LDT 1.0；
4. 本文基于 quick-cocos2d-x 提供的 coinflip sample 进行调试。

提纲如下：

1. 在 ZeroBrane Studio 中进行断点调试
2. 在 Eclipse LDT 中进行断点调试
   

一、 在ZeroBrane Studio中进行断点调试

ZeroBrane Studio是一个用Lua写成的跨平台Lua IDE。界面使用 wxLua 实现。

1. 调试模块

ZeroBrane Studio 使用 modbdebug 模块（位于 [ZeroBrane]/lualibs/mobdebug/mobdebug.lua） 实现调试支持。为了让项目找到这个模块，我采用最简单的方法，将该模块复制进入 coinflip 的 scripts 文件夹。

若不希望这样粗暴，可采用另外两种方法，参考： Remote debugging

2. require mobdebug

在 coinflip/scripts/main.lua 的第一行加入下面的代码，让项目启动调试支持。

^? View Code LUA

1	require("mobdebug").start()

3. 启动调试服务器

在 ZeroBrane Studio 中选择 Project->Start Debugger Server 命令。如果该命令是灰色的，说明调试服务器已经启动了。

4. 加断点

编辑 game.lua 文件，在32行 game.enterChooseLevelScene() 处选择 Project -> Toggle BreakPoint加入断点。

5. 启动 quick-player

在 quick-player 中启动 coinflip 项目，ZeroBrane Studio 会自动停在 main.lua 中。按 Project -> Continue 继续运行，游戏界面出现。

单击游戏中的 “Start” 按钮，调试停止在 game.lua 中的断点处。如下图所示：

查看大图

6. 进入源码调试

若要进入框架内部调试，可以取消 main.lua 中的CCLuaLoadChunksFromZip("res/framework_precompiled.zip") 调用，然后将 [quick-cocos2d-x]/framework 复制的 coinflip/scripts/ 文件夹，这样在调试的时候，就可以进入框架内部了。如下图所示：

查看大图

二、 在Eclipse LDT 中进行断点调试

LDT(Lua Development Tools)是一个 Eclipse 插件，支持Lua语言的编写和调试。

1. 调试模块

LDT 使用 另一个调试模块来实现调试支持。LDT可以自动生成这个模块。

单击 Run -> Debug Configurations 菜单，新建一个 Lua Attach to Application 配置，点击其中的Lua Debugger Client 将模块输出到 coinclip 的 scripts 文件夹，默认文件名为 debugger.lua 。

查看大图

2. require debugger

在 coinflip/scripts/main.lua 的第一行加入下面的代码，让项目启动调试支持。

^? View Code LUA

1	require("debugger")("127.0.0.1", 10000, "luaidekey")

这里的 luaidekey 是调试过程中IDE用来保持会话的键名，与上面 Debug Configurations 配置界面中的 IDE Key 相同。

3. 启动调试服务器

单击 Run -> Debug Configurations 菜单，选择刚才新建的配置，单击 Debug 按钮。

4. 加断点

编辑 game.lua 文件，在32行 game.enterChooseLevelScene() 处加入断点。

5. 启动 quick-player

在 quick-player 中启动 coinflip 项目，单击游戏中的 “Start” 按钮，调试停止在 game.lua 中的断点处。如下图所示：

若要进入 framework 源码内部调试，见上方的 6. 进入源码内部调试 。

关于LDT更详细的调试信息，可以阅读 Debugging a Lua program 。