Mac下搭建quick cocos2d-x编译环境

前言

虽然之前已经写过了很多 Cocos2d-x 相关的教程和文档,但本次却是我第一次接触 Quick,第一次接触 Lua,所以此次的教程本人将站在一个初学者的角度(看到这里是不是想白眼我了,哈哈,别切啊!尽管第一次,但我身边可是有很多 Quick 大神的,廖大大也在旁边办公室,没准撒个娇大神就把他知道的全部要点倾囊相授了啦!),全方位的解析 Quick 的学习过程,并同大家一起学习如何利用 Quick-Cocos2d-x 开发一款属于自己的游戏,包教包会的哦。

好了,那么下面我们就开始进入正题吧。

Quick-Coco2d-x是什么?

首先,想了解 Quick-Coco2d-x 就必须先知道 Cocos2d-x 是什么,不过我想关于 Cocos2d-x 的介绍这里就不用我来废话了吧,毕竟这么牛的游戏引擎还是应该很点名气的吧!

其次,由于 Cocos2d-x 中使用的是 C++ 语言,而 C++ 又对开发人员要求较高,所以逐渐地,开发者们开始将 Cocos2d-x 的 C++ 接口转成了 Lua 接口,从而衍生出了 Cocos2d-lua 的版本。而 Quick(Quick-Coco2d-x)是 Cocos2d-lua 的一个豪华增强和扩展版本,它重写了支持代码、解决了内存泄露和只能使用全局函数做回调等等问题。Quick 能让开发者使用 Lua 这种简单易懂的脚本语言来编写游戏,并大大提高了开发效率。现在廖大大的 Quick 团队也已接手了 Cocos2d-lua 的开发和维护工作,所以未来 Quick 和 Cocos2d-lua 将有望完全合并起来。

本次教程所用 Quick-Coco2d-x 版本为 v3.3 Final,大家可在Cocos引擎中文官网中找到对应的下载地址并安装该程序。

注意:不要把 Quick 安装到根目录,或者带有空格或中文的路径中。另外,Quick-Cocos2d-x 需要 Python 的支持,所以请自行检测你的电脑是否装有Python,方法是在终端中输入 python 命令行,如未安装请先下载安装2.x版本的 Python。

Quick 安装完成后,在它的根目录下可以找到有两个名为setup_mac.sh、setup_win.bat的批处理脚本,它们分别是搭建Mac和Windows开发环境的脚本,根据自己系统的需要运行相应的脚步,就可以自动为你完成 Quick 环境的配置。在此之后,我们就可以双击安装目录下的 player3 图标(Windows 下桌面上会生成 player 的快捷键),启动 Quick 自带的模拟器了。在该模拟器界面中,我们可以创建、打开、运行项目,同时还能查看很多 Quick 自带的示例项目。

关于 Quick 更多的使用说明可参考安装目录下的 README 文件。

Quick-Coco2d-x开发工具

一般情况下,我们通常都会采用Cocos Code IDE作为开发工具来快速开发游戏,这里Cocos Code IDE是一个基于 Eclipse 的跨平台 IDE,专门为 Cocos2d-x Lua & JavaScript 开发人员准备,通过 IDE 你可以方便的创建游戏工程、编写并且支持在不同平台上调试代码、实时查看代码被改变后的效果,最终直接发布成一个可上架的安装包。

然而,最近学习Quick的时候听同事和很多用户反馈说:Quick-Coco2d-x v3.3 Final这个版本在Cocos Code IDE上还存在一些Bug,并且执行效率也相对较慢。所以在大神的推荐下,本教程我们就不选用Cocos Code IDE作为开发工具了,而是使用另一种高效的方法来完成该跑酷游戏的开发——Sublime + QuickXDev。

当然如果你非要用Cocos Code IDE还是可以的,其安装和使用说明可参考:Cocos Code IDE + Quick-Cocos2d-x 快速开发游戏一文。

开发工具的安装配置

Sublime Text 是一个具有漂亮的用户界面和强大的功能的代码编辑器,也是HTML和散文先进的文本编辑器,它的很多功能都依赖于其强大的插件系统。Sublime Text支持Lua语言,但它本身不具有像代码提示这样的功能,所以要想用Sublime Text快速的开发Quick-Coco2d-x程序,我们就必须安装强大的QuickXDev插件。

Sublime Text的下载地址为:http://www.sublimetext.com/,下载后直接安装即可。

QuickXDev的下载地址为:http://git.oschina.net/lonewolf/QuickXDev,将它下载解压之后重命名为QuickXDev,然后把该QuickXDev文件夹放入到Sublime Text的Packages目录下(可通过Sublime Text->Preferences->Browse Packages打开)。

接着依次打开Preferences->Package Settings->QuickXDev->Settings–Default,如下图所示:

复制该处的内容到Preferences->Package Settings->QuickXDev->Settings–User(此时User是空白的)中,同时在 “quick_cocos2dx_root” 项的后面设置Quick-Coco2d-x的安装路径,如下图所示:

设置完成后,User的内容将会覆盖Default下的设置。  
注意:以上路径应为你自己的安装路径,如果是Windows系统,则该处的路径形如:

1."quick_cocos2dx_root":"D:\\Quick\\quick-3.3"

新建项目

开发工具准备就绪以后,下面我们就可以开始创建我们的项目了.

首先启动 Quick 下的 player3,在这儿的示例标签下你可以看到很多Quick自带的示例,对于初学者来说,看看这些示例的使用方法会对我们学习Quick有很大的帮助,它也是快速学习Quick极好的教材。其界面如下图所示:

接着我们来新建一个项目,点击界面上的“新建项目”,player会自动切换到新建项目的界面。

设置好新建项目的存放路径,包名,屏幕方向,以及是否复制C++源码等选项后,我们就可以点击右下角的 “Create Project” 按钮创建项目了。这里需要注意的是,如果你的项目不涉及到 C++ 部分,那么可以取消“Copy Source Files”项的勾选,这样可以加快项目的创建速度。

点击 Create Project 按钮后,你会发现右下角的 “Create Project” 按钮变成了“Open..”,同时还会出现一个显示创建项目结果的终端窗口。待终端窗口显示创建完成时,我们就可以点击“Open..”打开项目了。

一个默认创建好的项目其实就是个程序员最熟悉的“Hello World”程序,然后后面我们就可以以这个“Hello World”程序为基础来编写自己的游戏。

每个新建的Quick程序都带了一个控制台窗口,如下图所示。这个控制台窗口是player的输出窗口,它包括了你打印的日志以及崩溃日志,当你的程序报错时,它的输出日志将是很好的检验凭证。

项目目录分析

为了更快更好的学习Quick程序开发,了解其项目结构是很有必要的,所以下面我们就来依次看看引擎和新建项目的目录结构。

引擎目录结构分析

打开 Quick 安装目录,其结构如下图所示:

  • build:该目录是 Cocos2d-x 的项目存放目录。
  • cocos: 改文件夹中包含了大部分引擎的库文件,其中包括:2d、3d、声音、基础库、数学库、物理库等等一系列相关的类文件。
  • docs:该文件夹下包含了引擎的API文档、发布文档(最新版本更改介绍,运行环境要求,编译环境要求及如何运行测试用例的相关命令)、Cocos编程规范等等文档。我们可以通过它查看引擎的代码API,以及最新版本更改介绍,quick运行环境要求,编译环境要求及如何运行测试用例的相关命令。里面的文件多是html和md格式的。
  • extensions: 其中主要是GUI扩展库.
  • external中包含物理引擎第三方库,Box2D和chipmunk;数据库第三方库,sqlite3;网络第三方库,webp,websockets;以及一些其他第三方库,像编码转换库、数据格式库等等。
  • licenses里面包含了引擎中用到的各种许可证文件。LICENSE_SpiderMonkey,spider引擎中用到的SpiderMonkey-JS运行环境,需要此许可证,该许可证适用于MPL/GPL/LGPL几种许可证LICENSE_chipmunk,LICENSE_JS,LICENSE_lua等等。引擎在这些许可证下可以对相应的源代码进行任意拷贝和修改。
  • quick:这个是Quick引擎代码。其中包含了创建各个平台新工程的批处理工具,Quick框架的核心目录,2dx和一些其他依赖的c++文件,模版工程,Quick所带的例子等等Quick的核心文件。
  • README.html/README.md:Quick的使用指南,关于Quick的安装、使用、创建等等信息都可以出这里获取,它其实相当于docs内文件的目录。
  • setup_mac.sh: 搭建Mac开发环境的脚本。
  • setup_win.bat: 搭建Windows开发环境的脚本。
  • tools:Quick用做luabinding的工具,可用来导出自定义的C++类。
  • version:版本标示。

新项目目录结构分析

打开新建项目的目录,我们来分析下新建项目的目录结构,其结构如下图所示:

  • config.json: 项目信息配置文件。
  • debug.log: 项目日志,即打印控制台窗口输出的所有日志文件。
  • frameworks: 存放Cocos2d-x引擎核心代码及各个平台运行时资源。
  • res:存放项目资源的文件夹,也就是说,我们游戏开发中用到的所有图片、字体、音频等资源都放在这里。
  • runtime:存放预编译的运行时库。
  • src:项目源码所存放文件夹,即游戏中的所有的 .lua 文件都放在这里。

以上目录中 res 和 src 文件夹是比较最要的,开发中我们也只需要对这两个文件夹里的内容进行操作,就可以实现游戏的开发。

在新项目的src文件夹中,现在你是可以看到一些 .lua 文件的,这些就是我们工程的lua代码。接下来我们简单的介绍下src中各项的功能:

  • cocos: cocos引擎代码
  • framework: quick的核心部分,在Cocos2d-x基础上自己搭建的一套framework
  • config.lua: 工程配置文件,包括分辨率适配等信息
  • main.lua: 工程入口
  • app: 工程的界面等文件,存放我们的游戏代码
    • MyApp.lua: 游戏的第一个界面
    • scenes: 存放游戏各个场景代码的文件夹
      • MainScene: 游戏的第一个场景

在游戏开发中,需要修改和添加界面时,我们只需要在相应的文件夹中添加场景就可以了。

好了,这章就算讲完了,下一章我们将先讲解新建项目各个lua文件的代码结构和使用方法,并开始着手新游戏的开发。

本系列为Cocos引擎中文官网教程组编写,原创教程转载请注明出处。谢谢

一. 我知道在你的电脑中一定已经安装好了Xcode(没有自己下载去吧),打开Xcode,开启“偏好设置”对话框(commond + ,)。如果打开之后出现的是这样的一个对话框,那么直接安装commond line tools即可:

如果你是这样的....

说明你的OS X系统10.9以上的版本,那么如何安装commond line tools呢?那就更简单了。

进入终端,在命令行直接输入:

xcode-select --install

然后出现下图提示,选择安装即可:

二. 下载quick cocos2d-x 目前quick cocos2d-x稳定版本为 2.2.1,下载链接为:http://cn.quick-x.com/?page_id=198

三. 下载完成后将其解压到桌面,启动终端,输入:

touch ~/.bash_profile

open ~/.bash_profile -a TextEdit

回车确认,然后在新出现的对话框里输入:

export
ANDROID_NDK_ROOT=<PATH_TO>/android/android-ndk-r8e

export
ANDROID_SDK_ROOT=<PATH_TO>/android/android-sdk-macosx

export
QUICK_COCOS2DX_ROOT=<PATH_TO>/quick-cocos2d-x

export
COCOS2DX_ROOT=${QUICK_COCOS2DX_ROOT}/lib/cocos2d-x

export
ANDROID_HOME=${ANDROID_SDK_ROOT}

这里面包含了对Android环境变量的配置,没有安卓环境终端会提示:

-bash: PATH_TO: No such file or directory

不用担心,没有影响,如下图:

四.启动 Xcode,在“偏好设置”中添加 Source Trees:

其中Name和DisplayName是一样的。Path是quick cocos2d-x文件夹在你电脑中的路径,如果你不知道的话,教给你一个方法。打开终端,将quick cocos2d-x-rc的文件夹拖进去,终端中便会显示它的路径,然后复制粘贴即可。

上述操作完成后环境搭建便完成了,下面我们创建一个项目,打开终端:

输入:

1. cd Desktop (因为我的quick文件夹位于桌面)

2. cd quick-cocos2d-x-2.2.1-rc

3. cd bin

4. ./create_project.sh -o landscape com.Reventon.Game.testGame

-o是用来指定屏幕方向的,landscape为横屏,portrait为竖屏。testGame为项目的名称(不包含前面的.)

项目创建完成后,其路径位于: quick-cocos2d-x-2.2.1-rc/bin/testgame

打开proj.ios文件夹下的Xcode文件,运行项目即可看到HelloWorld.

时间: 2024-10-24 04:34:22

Mac下搭建quick cocos2d-x编译环境的相关文章

Mac下搭建Python3+PyQt5的开发环境

可以下载源码自己编译,也可以直接通过pip3直接安装. 因为Mac系统默认是安装Python2的,需要首先安装Python3,具体的步骤如下. 1. 安装Xcode.这个没什么好说的,Mac上开发大多离不开这个,打开AppStore下载安装即可. 2. 安裝 Homebrew 在Terminal中执行 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)&

mac下 搭建Cordova+ionic+AngularJs开发环境

一.下载安装node.js 二.安装cordova和ionic sudo npm install -g cordova ionic 三.创建项目 ionic start ionApp blank 四.打包 $ ionic platform add ios

在mac下搭建java开发环境

刚刚从windows系统转到使用mac系统,感觉不是特别熟悉,需要一定的适应时间.下面简单介绍一下mac下搭建基本的java开发环境. 1.安装jdk 安装jdk1.7后,发现不需要进行环境变量配置,直接在terminal中就能使用java和javac命令了.jdk所在目录为: /Library/Java/JavaVirtualMachines 2.安装maven 解压maven包,然后配置maven环境变量 配置变了过程如下: 1.使用touch命令在-目录(用户目录)下创建.bash_pro

Mac下搭建php开发环境[翻译]

原英文链接:http://www.codeweblog.com/mac-os-x-to-configure-apache-php-mysql/ Mac OS X 内置了Apache 和 PHP,这样使用起来非常方便.本文以Mac OS X 10.6.3为例.主要内容包括: 启动Apache 运行PHP 安装MySQL 使用phpMyAdmin 配置PHP的MCrypt扩展库 设置虚拟主机 启动Apache 有两种方法: 打开"系统设置偏好(System Preferences)" -&

MAC下搭建PHP/LNMP环境

MAC下搭建PHP/LNMP环境 由于Mac自带的PHP不支持PHP扩展.Mac自带apache不能优雅的install/remove.Mac自带的PHP版本比较陈旧.首先要做的就是升级PHP版本 工欲善其事必先利其器,安装Homebrew what?homebrew是OS X 不可或缺的套件管理器,类似于ubuntu下apt-get,Red hat的yum.传送门 : Homebrew安装简单 /usr/bin/ruby -e "$(curl -fsSL https://raw.githubu

mac 下搭建 Android 开发环境

因工作需要,要在mac 下搭建 Android 开发环境.谷歌.度娘了好久,没有找个一个完整又系统的方法,很是苦恼.最终,皇天不负有心人,找到了下面这篇文档,特此记录.也为有这方面需求的朋友提供个方便. 首先我们需要知道开发安卓的环境由以下几个组件组成:Java虚拟机JDK.Eclipse.Eclipse插件ADT(Android Developer Tool)和Android开发包SDK.下面就和大家一起学习如何来快速的,适合新手的搭建方式吧! 方法/步骤 因为系统自带jdk,所以就不用在下载

MAC下搭建appium UI自动化环境

参考资料:http://qa.blog.163.com/blog/static/190147002201510161119832/ 一.系统要求: Mac OS X 10.7 或者更高,推荐最新系统 XCode >= 4.6.3,推荐最新系统 Apple Developer Tools (iPhone simulator SDK, command line tools) 二.下载Xcode: 在APPStore自行下载变可 ***在安装XCode7的时候,一定要注意当前OS X的版本是否>=1

mac下搭建cordova开发环境

Apache Cordova 原名叫PhoneGap.是一个用基于HTML,CSS和JavaScript的,创建移动跨平台移动应用程序的快速开发平台.PhoneGap最初由Nitobi开发,2011年10月4日Nitobi被Adobe收购,而PhoneGap项目也被贡献给Apache软件基金会,并改名为Apache Cordova. mac下搭建cordova环境步骤: 1,在Apache的Cordova网点下载Cordova开发包 下载地址:http://cordova.apache.org/

Mac下安装LNMP(Nginx+PHP5.6)环境

Mac下安装LNMP(Nginx+PHP5.6)环境 安装Homebrew 最近工作环境切换到Mac,所以以OS X Yosemite(10.10.1)为例,记录一下从零开始安装Mac下LNMP环境的过程 确保系统已经安装xcode,然后使用一行命令安装依赖管理工具Homebrew ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" 之后就可以使用 brew