cocos2dx 3.0如何搭建开发环境

2015年02月08日 14:11 0 点赞 0 评论 更新于 2025-11-21 16:07

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_SDKAndroid_NDKAntJDK

  • 下载相关工具
  • Android_SDK下载
  • Android_NDK下载
  • Android_JDK下载
  • Ant下载
  • 解压与安装:除了JDK需要安装,其他工具都是绿色版,直接解压即可。将SDK、NDK和ANT解压缩到同一个文件夹中,并修改SDK的文件夹名为ADT,NDK的文件夹名为NDK,ANT的文件夹名为ANT,方便以后使用。例如,解压后文件都放在了e:\Android文件夹下。

5.2 配置JDK环境变量

JDK安装完成后,需要手动配置环境变量:

  1. 在系统变量里新建JAVA_HOME变量,变量值为C:\Program Files\Java\jdk1.6.0_14(需根据自己的安装路径填写)。
  2. 新建classpath变量,变量值为.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar(注意前面的.不要忘记)。
  3. path变量(已存在,不用新建)中添加变量值%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin(注意变量值之间用;隔开)。
  4. 重新注销系统并重新登录后,在“开始” -> “运行”中输入“javac”,按“Enter”键。如果能正常打印用法说明,则配置成功。

5.3 环境变量解析

  • JAVA_HOME:指定JDK的安装路径。
  • classpath:Java加载类路径,只有类在classpath中,java命令才能识别。在路径前加.表示当前路径。
  • path:系统在任何路径下都可以识别javajavac命令。

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\文件夹下。

作者信息

boke

boke

共发布了 3994 篇文章