博客

Quick-Cocos2d-X (一) 开发环境的搭建

  • Post author:
  • Post category:其他



Quick-cocos2d-x使用Lua作为脚本语言，因此，能够进行Lua代码编辑的环境，就可以作为Quick-cocos2d-x的开发环境




如果只是为了普通的代码编辑，那你使用任意一款文本编辑器即可，甚至是系统自带的




如果想代码高亮，自动补齐，跳转等，可以使用Vim,sublime text等编辑工具，喜欢Visual Studio和eclipse的朋友，也不用担心，这些都是可以的




下面给出一些参考连接，大家自行取用





使用VS插件在VS2012/2013上编辑和调试Quick-cocos2d-x的Lua代码






用 Eclipse LDT 调试 quick-cocos2d-x 游戏




quick-coco 论坛




sublime text

（对lua支持好 编译快）



前言
本来想写CSharper 学Cocos2dx系列的。但是最近在了解许多跨平台游戏开发框架后 最终决定使用Quick-cocos2d-x+lua进行第一个游戏项目的开发。经过一天多的折腾 终于把开发环境搭建出来了，下面我们步入正题


Quick-Cocos2d-X

什么是Quick-Cocos2d-X

Quick-Cocos2d-X 是针对Cocos2d-x lua版本豪华版封装，它在Cocos2d-x的luabinding基础上提供常用功能的封装 以及重写了部分组件，旨在降低开发者的学习曲线，使开发者不用去过多的了解Cocos2d-x C++底层实现

如何搭建Quick-Cocos2d-X开发环境



注意：Quick-Cocos2d-X需要Python的支持 请自行下载2.x的Python
首先我们要下载Quick-Cocos2d-X的最新版本，后文有提到。解压缩到磁盘上以后，我们来看下它的目录结构，如图所示：
其中的
Bin目录下存放着我们创建、编译、打包项目的一些脚本
Docs中存放的是各类Api 比官网的要完整很多
Lib中存放Cocos2d等各类库
Player 用来执行我们的quick项目的 模拟器 同事兼备调试功能
其它的就暂时不多说了，下面我们来看安装部分。


Mac：
直接把Setup_mac.sh拖到 “终端” 中 回车运行即可


Windows:
需要配置环境变量
在用户变量中增加 COCOS2DX_ROOT=%QUICK_COCOS2DX_ROOT%\lib\cocos2d-x
在系统变量中增加 PATH=%QUICK_COCOS2DX_ROOT%\bin\win32
然后直接运行Setup_win.bat

Quick-Cocos2d-X Player的使用



在完成上述配置并重启计算机后，就可以打开 player/对应平台工程 进行Player的编译了。Player本身其实是一个调试运行Quick项目的模拟器，并且默认情况下的Welcom界面可以提供我们一些常用功能，例如Samples，打开/创建项目等，其中Windows下的创建项目功能还未提供。
创建项目


Mac：
直接使用Player中的创建项目功能即可


Win：
到Quick-Cocos2d-X框架下的bin目录下 运行create_project.bat即可 其中需要两个参数 -p [packagename] -o [directory]
例如：create_project.bat -p com.manon.loki.QuickDemo -o

e:\MyProject

即可以在E:\MyProject的文件夹下创建一个叫QuickDemo的项目  这里会取PackageName的最后一段文本作为项目名称。 之后就可以编译运行了
在VS中 当前2.2.5版本的Quick模板创建的项目略有问题  获取不到ProjectDir 这个抽时间研究下，目前这是一个坑。。。所以我基本不用vs做开发


Sublime Text

什么是Sublime Text
Sublime Text是一个收费的文本编辑器，据说功能很强大，这里我们只关注它如何编辑lua脚本，以及智能提示Quick-Cocos2d-X的Api。
实现这个功能我们需要用到Package Control与QuickXDev插件 。
这里建议在官网下载最新版本的Sublim Text 因为官网虽然是收费版本，但是也跟那些所谓的破解版/中文汉化版没啥区别，不影响实际开发。

如何安装Package Control


安装Package Control方式有两种

方式1
通过Sublime Text控制台，使用官方提供的命令方式实现下载
Mac/Windows版本的命令行快捷键都是 ”

Ctrl+`

”

//


从菜单 View – Show Console 或者 ctrl + ~ 快捷键，调出 console。将以下 Python 代码粘贴进去并 enter 执行，不出意外即完成安装。以下提供 ST3 和 ST2 的安装代码：




Sublime Text 3：


import urllib.request,os; pf = ‘Package Control.sublime-package’; ipp = sublime.installed_packages_path(); urllib.request.install_opener( urllib.request.build_opener( urllib.request.ProxyHandler()) ); open(os.path.join(ipp, pf), ‘wb’).write(urllib.request.urlopen( ‘http://sublime.wbond.net/’ + pf.replace(‘ ‘,’%20’)).read())




Sublime Text 2：


import urllib2,os; pf=’Package Control.sublime-package’; ipp =

sublime.installed_packages_path(); os.makedirs( ipp ) if not os.path.exists(ipp)

else None; urllib2.install_opener( urllib2.build_opener( urllib2.ProxyHandler(

))); open( os.path.join( ipp, pf), ‘wb’ ).write( urllib2.urlopen(

‘http://sublime.wbond.net/’ +pf.replace( ‘ ‘,’%20’ )).read()); print( ‘Please

restart Sublime Text to finish installation’)


//

方式2
直接下载插件到本地。
然后使用Preferences->Browse Packages打开插件所在目录
把插件拷贝进去解压缩即可

如何安装QuickXDev


下载和当前使用quick版本相同的quickxdev安装（解压到packages 重命名文件夹为QuickXDev） 然后 PackControl的自动更新设置(control.sublime-settings)


“auto_upgrade”: true,  设置为false


QuickXDev更新至3.2rc1




通过Package Control安装QuickXDev
Preferences->Package Control 在控制台中输入Install Package
然后回出现如下控制台
输入QucikXDev回车即可进行插件安装,大概几秒钟后安装完毕
安装完QuickXDev之后还需要进行配置
在Preferences->Package Settings->QuickXDev中选择Settings User
大概设置是这样的
{


// must set the path




“quick_cocos2dx_root”: “你的Quick-Cocos2d-X目录”,

//在Sublime Text 2目录下搜下 quick_cocos2dx_root 发现这个路径是用来找player的（在quickx.py文件中） 如



果出现

player no exists 可能是由于quick cocos2dx版本和quickdev不兼容 手动改下路径就好了 –最好的办法是搜

player no exists








// lua template attributes




“date_format”: “%Y-%m-%d %H:%M:%S”,




// i.e. peter or peter (peter@gmail.com)




“author”: “填自己喜欢的”,




// compile_scripts encrypt key,no encrypt when empty




“compile_scripts_key”: “”




}

在保存后 QuickXDev就可以生效了

QuickXDev提供的主要功能



三、主要功能。







1、

quick-cocos2d-x api代码提示

，包含framework和cocos2dx tolua部分。


2、

跳转到定义处

。


1)支持framework中的所有类、方法和属性，如display.newScene。


2)支持cocos2dx tolua中的类和方法和define和enum，如CCMoveTo、CCMoveTo:create。


这样我们就可以使用Sublime Text进行lua脚本的编写及调试了  亲测比VS好用许多。附截图一张。另外Quick-Cocos2d-X除了自身的Api，还支持Cocos2d-x的lua Api。所以Quick没有提供的Api我们需要去Cocos2dx官网去查找

资源区
Sublim Text        下载

http://www.sublimetext.com/
Package Control  下载

https://sublime.wbond.net/






一、常用的插件





1、Package Control


各个包的安装与管理，非常方便，几乎每个开发者都会用到。


2、SublimeLinter


一个支持lint语法的插件，可以高亮linter认为有错误的代码行，也支持高亮一些特别的注释，比如“TODO”，这样就可以被快速定位。


3、BracketHighlighter


类似于代码匹配，可以匹配括号，引号等符号内的范围。用于显示对应所在的位置。


4、Function Name Display


在状态栏中显示当前行所在的方法名称。


5、Status Bar Extension


在状态栏显示当前文件编码及系统类型。


6、IndentGuides


代码函数或标签起点与终点提示。

1、ConvertToUTF8　　支持UTF-8编码的插件

2、Bracket Highlighter　　用于匹配括号，引号和html标签。对于很长的代码很有用。安装好之后，不需要设置插件会自动生效

3、DocBlockr　　DocBlockr可以自动生成PHPDoc风格的注释。它支持的语言有Javascript, PHP, ActionScript, CoffeeScript, Java, Objective C, C, C++

4、Emmet(Zen Coding)　　快速生成HTML代码段的插件，强大到无与伦比，不知道的请自行google

5、SideBar Enhancements　　这个插件改进了侧边栏，增加了许多功能

6、Themr　　主题管理，切换主题的时候，不用自己修改配置文件了，用这个可以方便的切换主题


AndyEdits  跳回      Alignment“=”对齐