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

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 游戏
在 Mac
下设置开发环境xcode

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
https://github.com/leitwolf/QuickXDev

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官网去查找



资源区

Quick-Cocos2d-X 下载 http://cn.cocos2d-x.org/download/
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“=”对齐