cocos2dx 3.x android 环境搭建

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

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 安装完成后,需手动配置环境变量:

  1. 在系统变量里新建 JAVA_HOME 变量,变量值为 JDK 的安装路径,如 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 并回车。若能正常打印用法说明,则配置成功。

环境变量解析

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

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

作者信息

boke

boke

共发布了 3994 篇文章