支持调试的环境
在 Windows 上你可以调试Windows和Android游戏,在 Mac 上你可以调试Mac、iOS和Android游戏。我们以 Mac 作为开发环境来演示 Code IDE 的使用,Windows上的流程和这里所介绍的几乎一样,不再赘述。
先决条件
如果你还没有安装Cocos Code IDE,请参考《如何安装和设置Cocos Code IDE》
IDE配置
基础设置
打开工具的 Preferences 页,切换到 Cocos/Lua 子页面,选择你刚刚下载的 Cocos2d-x 3.x 作为 Lua Framework。
额外设置
假设你发现我们提供给你的预编译的Android runtime不能满足你的要求,你就需要重新定制,那么你就需要提供给 IDE 几个 Android 编译需要用到的工具。这可以通过打开 Preferences/Cocos 页面进行配置。
运行、测试游戏
1. 新建一个名为 CocosLuaGame 的 Cocos Lua 工程
2. 点击工具栏上的Debug按钮
3. 默认情况下脚本会运行在我们提供的 Mac 版本预编译 runtime 上。为了简单起见,我们不对默认值进行任何改动。如果你想要在其他我们支持的目标平台上调试程序,可参考下文的“在其它目标平台上调试”
如何调试
断点支持
-
可以在 Lua 脚本文件中增加断点
-
当断点被触发时选择 "Yes" 打开 Debug Perspective 透视图,可以看到很多与调试相关的视图,调用栈、变量和断点等等
-
支持 Step over, Step into, Step out 等调试方式
代码热更新
对 spriteDog 的移动路线很不爽?tick() 函数是控制每一帧 spriteDog 位置的。
1
2
3
4
5
6
7
8
9
10
11
12
|
-- moving dog at every frame
local function tick()
if
spriteDog.isPaused then
return
end
local x, y = spriteDog:getPosition()
if
x > origin.x + visibleSize.width then
x = origin.x
else
x = x + 1
end
spriteDog:setPositionX(x)
end
|
修改这个函数的实现,比如将 x = x + 1 修改为 x = x + 10,之后保存。 你会发现,在没有重启 runtime 的情况下 spriteDog 的移动速度改变了
在其他目标平台上调试
1. 通过工具栏上的打开 Debug Configurations 打开 Debug Configurations 页面
2. 在页面的左侧,选择之前我们为你创建的名为CocosLuaGame的configuration
在 iOS Simulator 上调试
-
选择 iOS Simulator 单选项
-
选择正确的 runtime app
-
点击 Debug 按钮,预编译的 runtime 会被自动安装到模拟器中
在iOS设备上调试
-
首先,你需要一个 runtime IPA, 从 1.0.0-rc1 版本开始,你可以通过 Code IDE 自己编译一个,然后安装IPA到设备中
-
在 iOS 设备上启动 runtime
-
在 "Debug Configuration" 界面选择 Remote Debug 单选项
-
platform 选择 "iOS"
-
将设备的 ip 地址填写在 Device IP 上并在Host IP上选择 mac 机器使用的 ip 地址, 请确保设备ip和mac机器的ip能相互访问
-
最后点击Debug按钮
在 Android 设备上使用 ADB 模式调试
-
在 "Debug Configuration" 界面选择 Android ADB Mode 单选项
-
选择正确的 runtime apk
-
点击Debug按钮
-
IDE 会自动安装配置中的 runtime apk 到你的连接设备上并启动runtime开始调试
在Android设备上使用网络模式调试
-
手动安装 runtime 到你的设备上,它被存放在 CocosLuaGame/runtime/android 目录中
-
手动启动 runtime,停留在 waiting 页面
-
在 "Debug Configuration" 界面选择 Remote Debug 单选项
-
platform 选择 "Android"
-
将设备的 ip 地址填写在 Device IP 上并在Host IP上选择 mac 机器使用的 ip 地址, 请确保设备ip和mac机器的ip能相互访问
-
点击Debug按钮
如何调试 C++ 代码
从 1.0.0-rc1 版本开始,支持使用 XCode/Visual Studio 调试 C++ 代码的同时使用 Cocos Code IDE 调试 C++ 代码。
以调试 Mac 为例:
-
如果你还没有 C++ 代码,那么需要先添加(右击工程,Cocos Tools->Add Native Codes Support...)
-
使用 XCode 打开 frameworks/runtime-src/proj.ios_mac 工程,并启动调试
-
回到 Cocos Code IDE,打开 "Debug Configuration" 页面,选择 Remote Debug 单选项
-
platfrom 选择 “Mac”
-
Target IP 填写 "127.0.0.1"
-
Host IP 选择 "127.0.0.1"
-
点击Debug按钮