cocos2dx 3.x android 环境搭建
Cocos2d-x 3.0 发布已有一段时间,作为初学者,我曾觉得 Cocos2d-x 不太友好。每个较大版本变动,项目创建方式都会有较大差异。不过平心而论,从 3.0 RC 版本开始,环境搭建、项目创建和编译方式变得更加人性化。
下面,我们将逐步搭建 Cocos2d-x 的开发环境。
1. 安装 Python 环境
Cocos2d-x 的许多工具需要使用 Python,因此我们需先安装 Python 环境。
Python 下载
点击此处下载 Python,注意要下载 Python 2.X 版本。我曾误下载 3.x 版本,安装后发现 Cocos2d-x 提供的 Python 脚本运行报错,卸载后重新安装了 Python 2.X 版本。
Python 安装与环境变量配置
安装 Python 时,使用默认安装方式即可。安装完成后,需要配置环境变量:
- 在“我的电脑”(右键) -> “属性” -> “高级系统设置” -> “高级”选项卡 -> “环境变量” -> “系统变量”中找到
Path变量。 - 在其值中增加指向 Python 的环境变量,格式为
[Python 安装路径];。例如,若安装在 C 盘,环境变量新增为C:\Python27;。
配置完毕后,需注销并重新登录系统,环境变量才会生效。
2. 下载并配置 Cocos2d-x
下载 Cocos2d-x
截至目前,Cocos2d-x 已更新到 3.0rc2 版本,可从 Cocos2d-x 官网 下载。
配置环境变量
下载完成后,将文件解压缩到磁盘上,打开 Cocos2d-x 文件夹,找到 setup.py 文件并运行。由于此时不配置 Android 环境,只需一直回车,这段 Python 脚本会帮助我们设置 Cocos2d-x 运行所需的环境变量。之后,再次注销并重新登录系统。
检查开发环境
配置完成后,打开 CMD 运行 cocos 命令:
- 一是检查整个开发环境是否搭建成功。
- 二是熟悉命令行。若设置无误,会出现相应界面。
在该界面中,我们可以看到 cocos.py 脚本可执行 4 个命令,每个命令的作用已清晰说明。
创建项目
使用 new 命令创建项目。例如,创建一个名为 simple 的项目,可使用以下命令:
cocos new -p com.game.simple -l cpp -d e:\ simple
运行此命令后,会在 E 盘根目录下生成一个名为 simple 的文件夹,其中包含我们的项目。
项目调试
此时,我们可以使用 VS2012 打开 proj.win32 中的 SLN 项目文件,进行编码和调试工作。
若要运行刚刚由模板生成的项目,需使用 cocos run 命令,格式为 cocos run -p [平台]。例如,cocos run -p win32 表示在 win32 平台运行。执行此命令时,需注意执行命令的目录必须是游戏项目的根目录,若不在根目录,需使用 -s 指定游戏根目录的位置。
在 CMD 中执行 cocos run -p win32 -s e:\simple,若编译过程无错误,编译完成后会打开 HelloWorld 示例。
至此,WIN32 环境的搭建、调试和发布工作全部完成。接下来,我们将配置 Android 环境。
3. 配置 Android 环境
准备工作
Android 编译环境需要用到 Android SDK、Android NDK、Ant 与 JDK。
其中,除 JDK 需要安装外,其他均为绿色版,直接解压即可。将 SDK、NDK 和 ANT 解压缩到同一个文件夹中,并将 SDK 文件夹名改为 ADT,NDK 文件夹名保持 NDK,ANT 文件夹名改为 ANT,方便后续使用。例如,我将解压后的文件都放在了 e:\Android 文件夹下。
配置 JDK 环境变量
JDK 安装完成后,需手动配置环境变量:
- 在系统变量里新建
JAVA_HOME变量,变量值为 JDK 的安装路径,如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并回车。若能正常打印用法说明,则配置成功。
环境变量解析
JAVA_HOME:JDK 的安装路径。classpath:Java 加载类路径,只有类在classpath中,Java 命令才能识别,路径前的.表示当前路径。path:使系统在任何路径下都可以识别java和javac命令。
配置 ANT 环境变量
将 [ANT 目录]\bin 文件夹添加到 path 中。
关联 SDK、NDK 和 ANT
至此,准备工作完成。接下来运行 setup.py 关联 SDK、NDK 和 ANT:
- 输入 NDK 和 SDK 的路径,其中 NDK 指向根目录即可,而 SDK 需要指向
adt中的sdk目录。 - 由
setup.py添加这两个环境变量后,会要求输入 Ant 的路径,这里需指向ant中的bin文件夹。
配置完成后,记得注销并重新登录系统,使环境变量生效。重新运行 setup.py 确认所有配置是否正确。
编译 APK 文件
配置无误后,可在项目目录下使用 cocos compile -p android 方式编译 APK 文件。注意,在打包 APK 之前,需要修改 proj.android/jni 文件夹下的 Android.mk 文件,添加自己新增的 CPP 文件。
编译好的 APK 文件位于 [项目文件夹]\bin\debug\android\ 文件夹下。