第一个Cocos2d-x Lua游戏

我们的编写的第一个Cocos2d-x Lua程序，命名为HelloLua，从该工程开始学习其它的内容。
创建工程
我们创建Cocos2d-x Lua工程可以通过Cocos2d-x提供的命令工具cocos实现，但这种方式不能与Cocos Code IDE集成开发工具很好地集成，不便于程序编写和调试。由于Cocos Code IDE工具是Cocos2d-x开发的专门为Cocos2d-JS和Cocos2d-x Lua开发设计的，因此使用Cocos Code IDE工具很方便创建Cocos2d-x Lua工程。
首先我们需要在Cocos Code IDE工具中先配置Lua框架，打开Cocos Code IDE工具，选择菜单Window→Preferences，弹出对话框如图所示，选择Cocos→Lua在右边的Lua Frameworks中选择<Cocos2d-x引擎目录>。

配置Lua框架

Lua框架配置不需要每次都进行，只是在最开始的配置一下，但创建工程的时候，Cocos Code IDE工具会从这个Lua框架目录中创建工程文件。
接下来我们就可以创建Lua工程了，选择菜单File→New→Project，如下图所示，弹出项目类型选择对话框。

项目类型选择对话框

我们选中Cocos Lua Project，然后点击Next按钮，弹出如下图所示的对话框。我们在Project Name项目中输入工程名称，Create Project in Workspace是在Workspace目录中创建工程，我们需要选中该项目，Create From Existing Resource项目选中可以让我们从已经存在的工程创建，现在我们不需要选中该项目。
选择完成点击Next按钮进入到如图所示配置运行环境对话框，在该对话框中我们可以配置项目运行时信息。Orientation项目是配置模拟器的朝向，其中landscape是横屏显示，portriat是竖屏显。Desktop Runtime Settings中的Title是设置模拟器的标题，Desktop Windows initialize Size是设置模拟器的大小。Add Native Codes是设置添加本地代码到工程，在本来中我们不需要添加本地代码。最后点击Finish按钮完成创建操作，创建好工程之后，如后图所示。

新建项目对话框

配置运行环境对话框

创建工程成功界面

Cocos Code IDE中运行
创建好工程后我们可以测试一下，在左边的工程导航面板中选中HelloLua工程，右键菜单中选择Run As→Cocos luainding运行我们刚刚创建的工程，运行结果如下图所示。

运行工程界面

我们主要编写的程序代码是在src目录下，在本例中Lua 文件负责处理主要的场景界面逻辑。如果我们想调试程序，可以设置断点，如下图所示，点击行号之前的位置，设置断点。

设置断点

调试运行过程，右键菜单中选择Debug As→Cocos Luabinding菜单。如下图所示，程序运行到第31行挂起，并进入调试视图，在调试视图中我们可以查看程序运行的堆栈、变量、断点、计算表达式和单步执行程序等操作。

运行到断点挂起

工程文件结构
我们创建的HelloLua工程已经能够运行起来了，下面我们介绍一下HelloLua工程中的文件结构，我们使用Cocos Code IDE打开HelloLua工程，左侧的导航面板如下图所示。

HelloLua工程中的文件结构

在上图所示导航面板中，res文件夹存放资源文件的，src文件夹是主要的程序代码main.lua和GameScene.lua，其中main.lua是程序入口文件，Cocos2d-x会在底层绑定该文件，并且启动和运行它。GameScene.lua中实现了游戏场景。

代码解释
HelloLua工程中主要有两文件下面我们详细解释一下它们内部的代码：

1、main.lua文件
main.lua是程序入口文件代码如下：

r

[html] view plaincopy

  1. equire "Cocos2d"                                                        ①
  2. -- cclog
  3. local cclog = function(...)                                                 ②
  4. print(string.format(...))                                               ③
  5. end
  6. -- for CCLuaEngine traceback
  7. function __G__TRACKBACK__(msg)                                      ④
  8. cclog("----------------------------------------")
  9. cclog("LUA ERROR: " .. tostring(msg) .. "\n")
  10. cclog(debug.traceback())
  11. cclog("----------------------------------------")
  12. return msg
  13. end
  14. local function main()                                                       ⑤
  15. collectgarbage("collect")                                               ⑥
  16. -- avoid memory leak
  17. collectgarbage("setpause", 100)                                     ⑦
  18. collectgarbage("setstepmul", 5000)                                      ⑧
  19. cc.FileUtils:getInstance():addSearchPath("src")
  20. cc.FileUtils:getInstance():addSearchPath("res")
  21. cc.Director:getInstance():getOpenGLView():setDesignResolutionSize(480, 320, 0)
  22. --create scene
  23. local scene = require("GameScene")                                      ⑨
  24. local gameScene = scene.create()                                        ⑩
  25. gameScene:playBgMusic()
  26. if cc.Director:getInstance():getRunningScene() then                         ?
  27. cc.Director:getInstance():replaceScene(gameScene)
  28. else
  29. cc.Director:getInstance():runWithScene(gameScene)
  30. end
  31. end
  32. local status, msg = xpcall(main, __G__TRACKBACK__)                          ?
  33. if not status then
  34. error(msg)
  35. end

上述代码第①行require是在加载Cocos2d模块，并且可以避免重复加载。第②行代码是声明cclog函数，该函数的作用是输出日志信息。第③行代码print(string.format(...))是输出函数。
第④行代码是声明__G__TRACKBACK__(msg)函数，在程序出错的时候由第?行的xpcall调用，并输出堆栈信息。下面是日志输出的堆栈信息：

[html] view plaincopy

  1. [LUA-print] stack traceback:
  2. [string ".\src/main.lua"]:13: in function ‘__index‘
  3. [string ".\GameScene.lua"]:52: in function <[string ".\GameScene.lua"]:49>
  4. [LUA-print] ----------------------------------------

第⑤行代码是main()函数，它是由第?行的xpcall函数调用。第⑥行代码collectgarbage("collect")中的collectgarbage是垃圾收集器的通用接口函数，用于操作垃圾收集器，其它的定义如下：
collectgrabage(opt [, arg])  
其中的 opt参数是操作方法标志，标志包括如下：
collect : 执行一次全垃圾收集周期，见代码第⑥行。 
stop : 停止垃圾收集器。
restart : 重启垃圾收集器。
count : 返回当前Lua中使用的内存数量，单位KB。
step : 单步执行一个垃圾收集，步长中的size属性是由参数arg指定，如果完成一次收集周期，将返回true。
setpause: 设置arg/100的值作为垃圾收集暂停时长，见代码第⑦行。
setstepmul: 设置arg/100的值，作为步长的增幅，即“新步长” = “旧步长” * (arg/100)，见代码第⑧行。

上述代码第⑨行local scene = require("GameScene") 加载GameScene模块，返回值是table类型全局变量。第⑩行代码local gameScene = scene.create()从通过静态create()函数创建GameScene场景。
代码第?行cc.Director:getInstance():getRunningScene()是判断是否有一个场景正在运行，如果有场景运行则通过cc.Director:getInstance():replaceScene(gameScene)语句使用gameScene场景替换当前场景，否则通过cc.Director:getInstance():runWithScene(gameScene)语句运行gameScene场景，无论是replaceScene还是runWithScene函数游戏都会是进入到gameScene场景。
代码第?行local status, msg = xpcall(main, __G__TRACKBACK__)中的xpcall函数是Lua提供，用于调用其它函数，并且可以捕获到错误，xpcall函数的定义如下：
xpcall (f, err)
其中f参数是要调用的函数，err是捕获道错误时候调用的函数。返回值status是错误状态和msg是错误消息。
事实上第?行代码local status, msg = xpcall(main, __G__TRACKBACK__)才是程序的入口。由它调用main()函数，如图3-19所示调用堆栈中，能够看出它们的调用顺序。

调用堆栈

2、GameScene.lua文件
GameScene.lua负责创建游戏主场景，我们看到的图3-15所示的场景就是在GameScene.lua中实现的，GameScene.lua主要代码如下： 
r

[html] view plaincopy

  1. equire "Cocos2d"
  2. require "Cocos2dConstants"
  3. --声明GameScene类
  4. local GameScene = class("GameScene",function()                              ①
  5. return cc.Scene:create()
  6. end)
  7. --静态创建函数
  8. function GameScene.create()                                             ②
  9. local scene = GameScene.new()                                       ③
  10. scene:addChild(scene:createLayerFarm())                                 ④
  11. scene:addChild(scene:createLayerMenu())                                 ⑤
  12. return scene
  13. end
  14. --构造函数
  15. function GameScene:ctor()                                               ⑥
  16. self.visibleSize = cc.Director:getInstance():getVisibleSize()
  17. self.origin = cc.Director:getInstance():getVisibleOrigin()
  18. self.schedulerID = nil
  19. end
  20. --播放背景音乐
  21. function GameScene:playBgMusic()
  22. local bgMusicPath = cc.FileUtils:getInstance():fullPathForFilename("background.mp3")
  23. cc.SimpleAudioEngine:getInstance():playMusic(bgMusicPath, true)
  24. local effectPath = cc.FileUtils:getInstance():fullPathForFilename("effect1.wav")
  25. cc.SimpleAudioEngine:getInstance():preloadEffect(effectPath)
  26. end
  27. --创建Dog精灵
  28. function GameScene:creatDog()                                           ⑦
  29. … …
  30. local spriteDog = cc.Sprite:createWithSpriteFrame(frame0)
  31. … …
  32. return spriteDog
  33. end
  34. -- create farm 创建农场层
  35. function GameScene:createLayerFarm()                                        ⑧
  36. local layerFarm = cc.Layer:create()                                     ⑨
  37. … …
  38. return layerFarm
  39. end
  40. -- create menu 创建菜单层
  41. function GameScene:createLayerMenu()                                        ⑩
  42. local layerMenu = cc.Layer:create()
  43. … …
  44. return layerMenu
  45. end
  46. return GameScene

?
我们在GameScene.lua中创建GameScene场景，并在场景中添加了农场层和菜单层。第①行代码是声明GameScene场景类，class("GameScene",function(){…})函数是由Cocos2d-x Lua引擎提供的，可以通过Lua创建创建对象。class函数定义如下：
class(classname, super) 
其中参数classname是函数名，它是字符串类型，super是调用父类构造函数。
第②行代码声明GameScene.create()静态函数，在main.lua中通过scene.create()语句调用。第③行代码local scene = GameScene.new()是创建GameScene创建对象，new()函数会调用第⑥行的GameScene:ctor()函数，ctor()是构造函数，用来初始化GameScene场景对象。第④行代码是调用GameScene场景对象的createLayerFarm()函数创建农场层（见代码第⑧行）。第⑤行代码是调用GameScene场景对象的createLayerMenu()函数创建菜单层（见代码第⑩行）。
代码第⑦行函数是创建Dog精灵，使用cc.Sprite:createWithSpriteFrame(frame0)语句创建精灵对象，我们将在后面详细介绍。
在创建农场层函数createLayerFarm()中的⑨行local layerFarm = cc.Layer:create()是创建层对象，我们将在后面详细介绍。

第?行代码返回GameScene变量，它是table类型，它是在main()函数中调用local scene = require("GameScene")语句时候返回的。

更多内容请关注最新Cocos图书《Cocos2d-x实战：JS卷——Cocos2d-JS开发》

本书交流讨论网站：http://www.cocoagame.net

欢迎加入Cocos2d-x技术讨论群：257760386

更多精彩视频课程请关注智捷课堂Cocos课程：http://v.51work6.com

智捷课堂现推出Cocos会员，敬请关注：http://v.51work6.com/courseInfoRedirect.do?action=netDetialInfo&courseId=844465&amp;categoryId=0

《Cocos2d-x实战 JS卷》现已上线，各大商店均已开售：

京东：http://item.jd.com/11659698.html

欢迎关注智捷iOS课堂微信公共平台，了解最新技术文章、图书、教程信息

时间： 2024-10-09 06:20:59

第一个Cocos2d-x Lua游戏的相关文章

最近发现一个有意思的lua游戏引擎，名字叫love2d

Hi there! LÖVE is an *awesome* framework you can use to make 2D games in Lua. It's free, open-source, and works on Windows, Mac OS X, Linux, Android and iOS. Open Source LÖVE is licensed under the liberal zlib/libpng license. This means that: It cost

（转）Cocos 2d-X Lua 游戏添加苹果内购(二) OC和Lua交互代码详解

这是第二篇 Cocos 2d-X Lua 游戏添加苹果内购(一) 图文详解准备流程 这是前面的第一篇,详细的说明了怎样添加内购项目以及填写银行信息提交以及沙盒测试员的添加使用以及需要我们注意的东西,结果,被移除首页了!前面第一篇的内容是这篇的基础,前面那些不弄好,下面的商品信息你是请求不到的,这点需要大家特别注意...有需要前面提到的内容的孩子可以点击链接进去自己看看!! 这篇就具体的总结我们Lua和OC交互的内容以及内购具体的代码以及结果的测试说明: 内购部分OC的代码实现 先自己总结一下整个

Cocos2d-X开发一个简单的小游戏

学了这么久Cocos2d-X,今天终于可以做出一个简单的小游戏了,游戏非常简单,通过菜单项控制精灵运动 在做游戏前,先学一个新概念 调度器(scheduler): Cocos2d-x调度器为游戏提供定时事件和定时调用服务.所有Node对象都知道如何调度和取消调度事件,使用调度器有几个好处: 每当Node不再可见或已从场景中移除时,调度器会停止. Cocos2d-x暂停时,调度器也会停止.当Cocos2d-x重新开始时,调度器也会自动继续启动. Cocos2d-x封装了一个供各种不同平台使用的调度

第一个cocos2d程序

简介 我们这个专题要学习的是一款iOS平台的2D游戏引擎cocos2d,严格来说叫做cocos2d-iphone,因为cocos2d有很多个版本,我们学习的是iphone版本的.既然是个游戏引擎,那么它肯定是为了方便游戏开发而设计的.使用了cocos2d,你可以编写极少量的代码就做出非常cool的游戏,节省你的开发周期.当然,要想出一个大作,还必须下苦工.在iOS平台的游戏引擎还不止cocos2d一个,不过cocos2d还是比较受欢迎的,AppStore上已经有超过100个游戏是基于cocos2

Cocos2d-x Lua游戏开发之Lua oo 的实现

一些面向对象的语言中提供了类的概念,作为创建对象的模版.在这些 语言里面.对象是类的实例,lua通过table也可以实现类的使用. --建立父类Animal Animal = { size,--动物大小 成员变量声明,不赋值为nil age,--动物年龄 color = "yellow",--动物颜色 sex,--动物性别,这个可以有?? new = function ( self,object ) object = object or {}--判断object是否为空,nil就会创建

【Cocos2D研究院之游戏开发】

http://www.xuanyusong.com/archives/category/ios/cocos2d_game 分类目录归档:[Cocos2D研究院之游戏开发] 201211-19 Cocos2D研究院之打开全新ViewController与返回(八) 雨松MOMO [Cocos2D研究院之游戏开发] 围观5745次 17条评论          之前cocos2d的文章都是由魏凯同学维护,从今天开始我也会抽时间写点cocos2d的文章.最近在研究如何将IOS游戏与软件结合起来.通常游

cocos2d横版游戏之摇杆控制

以上是一个控制摇杆,分为一个底座和摇杆小圈圈,我们的目的是通过算出摇杆小圈跟底座中心的偏移来控制任务的走向,我们计算出一个偏移量来,然后在场景update(foat dt)...每一帧的位置上加上这个偏移量,不停的播放行走动画(当然人物的朝向要对),就可以达到控制任务行走的效果了,这一点你可能一下子就会想到高中学过的向量的加减处理了......坐标象限....之类的. void DirectionControlButton::controlTargetMove(CCTouch *pTouch){

lua游戏开发实践指南学习笔记1

本文是根据lua游戏开发实践指南做的一些学习笔记,仅用于继续自己学习的一些知识. Lua基础 1.  语言定义: 在lua语言中,标识符有很大的灵活性(变量和函数名),不过用户不呢个以数字作为起始符,也要避免下划线(_)接大写字母,因为这种格式为lua自身保留如_Start. 建议用户使用如下格式和命名规则来定义变量.常量和函数名: ①  常量用全大写和下划线,例如:MY_CONSTANT ②  变量第一个字母小写,例如:myVariable ③  全角变量第一个字母用小写g表示,例如:gMyG

lua游戏开发实践指南学习笔记2

深入学习Lua 本人学习lua游戏开发实践指南的学习笔记,主要记录书中的一些知识点. 1.  函数 函数是划分游戏脚本功能的主要工具,它是通过标识符(事实上是一个变量)调用的lua代码块,可以执行某种处理.返回值,或者二者都有. 简单的函数定义如下: Function Wow() print(" ") print(Wow ,that wasaawesome:) print(" ") end 函数定义以function关键字开始,后面是函数名称,然后是传递给函数的参数

Lua游戏逆向及破解方法介绍

Lua游戏逆向及破解方法介绍 背景介绍 随着手游的发展,越来越多的Cocos-lua端游开发者转移到手游平台.Lua脚本编写逻辑的手游也是越来越多,如梦幻西游.刀塔传奇.开心消消乐.游龙英雄.奇迹暖暖.疾风猎人.万万没想到等手游.随着Lua手游的增加,其安全性更值得关注,在此归纳一些常用的分析方法,同时介绍一些辅助工具. 识别Lua游戏 Android平台的apk包可以直接解压,找到./lib目录下的so逻辑模块,一个个分析其so,寻找是否内嵌lua引擎(一般情况下,最大的so最有可能内嵌lua