cocos2dx 3.0如何搭建开发环境
cocos2d-x 3.0发布已有一段时间,对于很多初学者而言,cocos2d-x的版本变动带来了不少困扰。每个较大的版本更新,项目创建方式都会有所不同,且变动幅度较大。不过平心而论,从3.0 RC版本开始,环境搭建、项目创建和编译的方式变得更加人性化了。
现在,我们进入正题,逐步搭建cocos2dx的开发环境。
1. 安装Python环境
cocos2d-x的很多工具都需要使用Python,因此我们首先要安装Python环境。
- 下载Python:点击这里 下载Python 2.X版本。曾经有开发者误下载了3.x版本,安装后发现cocos2d-x提供的Python脚本运行报错,卸载后重新安装了Python 2.X版本才正常。
- 安装Python:安装时使用默认安装方式即可。安装完成后,需要配置环境变量。具体操作如下:在“我的电脑”(右键) -> “属性” -> “高级系统设置” -> “高级”选项卡 -> “环境变量” -> “系统变量”中找到
Path变量,并在其值中增加指向Python的环境变量,格式为[Python安装路径];。例如,若安装在C盘,环境变量可新增为C:\Python27;。 - 生效环境变量:配置完毕后,注销并重新登录系统,环境变量才会生效。
2. 下载并配置cocos2d-x
- 下载cocos2d-x:截至目前,cocos2d-x已更新到3.0 rc2版本,可从 cocos2d-x官网 下载。
- 解压并配置:下载完成后,将其解压缩到磁盘上。打开cocos2d-x文件夹,找到
setup.py文件并运行,会弹出控制台。由于暂时不配置Android环境,只需一直回车即可。此时,这段Python脚本会帮助我们设置cocos2d-x运行所需的环境变量。设置完成后,再次注销并重新登录系统。 - 检查环境搭建:配置完成后,打开CMD,运行
cocos命令。一方面检查整个开发环境是否搭建成功,另一方面可以熟悉下命令行。如果设置没问题,会出现相应界面,我们可以看到cocos.py脚本可以执行4个命令,每个命令的作用都有清晰说明。
3. 创建项目
使用new命令创建项目。例如,要创建一个名为simple的项目,可以使用以下命令:
cocos new -p com.game.simple -l cpp -d e:\ simple
运行该命令后,会在E盘根目录下生成一个名为simple的文件夹,其中存放着我们的项目。
此时,我们就可以用VS2012打开proj.win32中的SLN项目文件,进行编码和调试工作。
4. 运行项目
如果要运行刚刚由模板生成的项目,需要使用cocos run命令,格式为cocos run -p [平台]。例如,cocos run -p win32表示在win32平台运行。执行该命令时,需要注意执行命令的目录必须是游戏项目的根目录,如果不在根目录,需要使用-s指定游戏根目录的位置。例如,在cmd中执行cocos run -p win32 -s e:\simple,如果编译过程中没有错误,编译完成后会打开HelloWorld的DEMO。
至此,WIN32中的环境搭建以及调试发布就全部完成了,下面我们来看Android部分。
5. Android环境搭建
5.1 准备工作
Android的编译环境在3.0 RC里有了很大改进,部署和编译方式比之前方便了很多。Android编译环境需要用到Android_SDK、Android_NDK、Ant与JDK。
- 下载相关工具:
- Android_SDK下载
- Android_NDK下载
- Android_JDK下载
- Ant下载
- 解压与安装:除了JDK需要安装,其他工具都是绿色版,直接解压即可。将SDK、NDK和ANT解压缩到同一个文件夹中,并修改SDK的文件夹名为
ADT,NDK的文件夹名为NDK,ANT的文件夹名为ANT,方便以后使用。例如,解压后文件都放在了e:\Android文件夹下。
5.2 配置JDK环境变量
JDK安装完成后,需要手动配置环境变量:
- 在系统变量里新建
JAVA_HOME变量,变量值为C:\Program Files\Java\jdk1.6.0_14(需根据自己的安装路径填写)。 - 新建
classpath变量,变量值为.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar(注意前面的.不要忘记)。 - 在
path变量(已存在,不用新建)中添加变量值%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin(注意变量值之间用;隔开)。 - 重新注销系统并重新登录后,在“开始” -> “运行”中输入“javac”,按“Enter”键。如果能正常打印用法说明,则配置成功。
5.3 环境变量解析
- JAVA_HOME:指定JDK的安装路径。
- classpath:Java加载类路径,只有类在
classpath中,java命令才能识别。在路径前加.表示当前路径。 - path:系统在任何路径下都可以识别
java、javac命令。
5.4 配置ANT环境变量
将[ANT目录]\bin文件夹添加到path中。
5.5 关联SDK、NDK和ANT
至此,准备工作完成。下面运行setup.py关联SDK、NDK和ANT。运行时,需要输入NDK和SDK的路径,其中NDK指向根目录即可,而SDK需要指向adt中的sdk目录。由setup.py添加这两个环境变量后,会要求输入Ant的路径,这里需要指向ant中的bin文件夹。
基本环境搭建完成后,记得注销并重新登录使环境变量生效。重新运行setup.py确认所有配置是否正确。
5.6 编译APK文件
配置正确后,就可以在项目目录下使用cocos compile -p android方式编译APK文件。注意,在打包APK之前,需要修改proj.android/jni文件夹下的Android.mk文件,添加自己新增的CPP文件。编译好的APK文件位于[项目文件夹]\bin\debug\android\文件夹下。