在本教程中,您将了解到如何使用 3.0 版或更高版本 Cocos2d-x 框架在 Windows* 开发环境中创建简单的游戏,以及如何实施编译以便它在 Windows 和 Android* 上运行。
Cocos2d-x 是什么?
Cocos2d-x 是一种跨平台的游戏(及互动书本等其他图形应用)框架,基于 iOS* cocos2d,但使用 C++、JavaScript* 或 Lua*,而非 Objective-C*。
该框架的一个优势在于支持创建可部署于不同平台(Android、iOS、Win32、Windows* Phone、Mac*、Linux* 等)上的游戏,有助于保持相同的代码库,只需针对每种平台进行特定的调整。
Cocos2d-x Console
Cocos2d-console 配置在 3.0 版本中。它是一种命令行工具,提供了一些管理 Cocos2d-x 或 Cocos2d-JS 项目的功能,如创建、执行、构建、调试等。
创建您的第一款游戏
1 - 下载最新版框架,并在您的开发环境中对它进行解压。本教程使用了 3.3rc0 版,且框架解压至桌面 (C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0)。
图 1。Cocos2d-x 3.3 RC0 版目录结构
2 – 如欲在 cocos2d-x 中创建新项目,请使用框架文件夹中的 setup.py(一种 Python* 脚本)配置所有的环境变量,以针对 Win32 和 Android 平台进行构建。在执行 setup.py 之前,您将需要下载、安装和配置以下项:
如果您未安装 Python Runtime,请访问下列网址下载 2.7.6 版:http://www.python.org/download/
图 2。setup.py 位置
3 - 打开命令提示符 (cmd.exe) 并执行下列命令:
- 导航至脚本文件夹(框架文件夹):
cd C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0
- 运行脚本 setup.py:
python setup.py(或仅 setup.py)
注意:如欲运行命令提示符中的 Python 命令,请将安装有 Python 的文件夹添加至环境变量路径。
- 该脚本将会请求 Android SDK、Android NDK 和 ANT 的安装路径。
- Android NDK 文件夹路径:
图 3。Cocos2d-console 请求 NDK 文件夹路径
- Android SDK 文件夹路径:
图 4。Cocos2d-console 请求 SDK 文件夹路径
- Apache ANT bin 文件夹路径:
图 5。Cocos2d-console 请求 ANT bin 文件夹路径
包含请求的路径之后,重新打开命令提示符 (cmd.exe)。该操作需要使用 cocos2d-console 命令。
4 – 键入 cmd.exe 访问命令提示符(cocos2d-console 命令只可通过此处发布)并再次打开框架文件夹:
cd C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0
在下一步,我们将创建新的 Cocos2d-x 项目:
cocos new MyGame –p com.Project.MyGame –l cpp –d Project
图 6。已创建的 Cocos2d-x 项目
下面简要解释一下相关参数:
- new:创建新项目,必须紧跟项目名称(如 MyGame)
- -p:定义包名称
- -l:选择编程语言,值可以是 cpp 或 lua
- -d:框架将要创建项目结构的目录
如果各项操作进展顺利,您的项目将在框架被提取的目录中的项目文件夹中被创建。
图 7。MyGame 目录结构
所创建的项目包含游戏(类别))的基础代码、资源(图像和音频等)以及每个框架所支持平台的一个项目。
构建 Android* 应用
要求:
- 您需要配置所有的环境变量,以构建 Android 应用游戏(Android SDK、Android NDK 和 ANT)。若您还未完成此步骤,请参见本文中“创建您的首款游戏”部分。
- 安装的 Java 开发套件 (JDK)
注:Cocos2d-console 使用 javac 命令针对 Android 进行构建,因为有必要添加 JAVA_HOME 环境变量 (JDK 路径)。
1 – 我们将针对一种以上的架构对我们的游戏进行编译,因为框架不会默认针对 x86 和 armeabi-v7a 进行编译。编辑 Application.mk 文件,它位于:
C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0\Project\MyGame\proj.android\jni
图 8。Application.mk 位置
2 – 将下行添加至该文件:
APP_ABI := armeabi armeabi-v7a x86
图 9。添加了 APP_ABI 行之后的 Application.mk
既然已添加好我们的目标架构,那让我们编译游戏吧!
3 – 使用命令提示符,找到框架文件夹:
cd C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0
4 – 执行以下命令以针对 Android 编译并运行游戏。
cocos run –s Project\MyGame –p android
图 10。执行命令以针对 Android* 编译并运行游戏
- run:编译并运行项目
- -s:项目文件夹的路径
- -p:选中的平台
注:若只进行编译,请输入:cocos compile –s Project\MyGame –p android
若一切正常,该 cocos2d-console 命令将使用 adb(若配置在环境变量中)将 APK 文件安装进所连接的设备或初始化模拟器中。若它们不可用,则该命令会等待直至设备和模拟器可用,如下图所示:
图 11。命令等待设备和初始化模拟器
若您已初始化了模拟器或连接了设备,那么将会出现该屏幕:
图 12。Android* 平台上的游戏屏幕
构建 Win32 应用(针对 Windows* 7 或 Windows* 8 桌面模式)
您将需要 Visual Studio* 2012或更高版本进行构建。
1 – 使用命令提示符 (cmd.exe),找到提取了框架的文件夹:
cd C:\Users\intel-user\Desktop\cocos2d-x-3.3rc0
2 – 执行以下命令以在 Windows 上编译并运行游戏:
cocos run –s Project\MyGame –p win32
图 13。执行命令以在 Windows 上编译并运行游戏
下面简要解释一下相关参数:
- run:编译并运行所选定的项目
- -s:项目文件夹的路径
- -p:选中的平台
注:如只进行编译,使用“编译”而非“运行”,如下所示:
cocos compile –s Project\MyGame –p win32
执行完运行命令,若一切正常您将会看到以下屏幕:
图 14。Windows* 平台中的游戏屏幕
可以使用 Visual Studio 来编译并运行游戏项目:
1 – 在项目目录中,用 Visual Studio 打开 MyGame.sln文件,该文件在 “proj.win32” 文件夹中。
图 15。Win32 项目目录结构
2 – 要编译项目,请按 F6 (或 Build menu -> Build Solution)并按 F5 执行它(或 Debug menu -> Start Debugging)。在构建和执行完毕后,您会于 console 步骤之后看到相同的屏幕显示。
图 16。在 Visual Studio* 中打开了 Win32 项目
现在您了解如何针对 Android(x86 和 ARM*)、Windows 7 和 Windows 8 (桌面模式)创建和编译游戏!
参考文献
Cocos2d-x 框架的源代码根据 MIT 许可证进行了授权,如欲了解相关信息请点击此处。
Cocos2d-x 及其文档:http://www.cocos2d-x.org/
cocos2d-console:http://www.cocos2d-x.org/wiki/Cocos2d-console
注
此时,Cocos2d-x 3.3 的发行版本在项目创建时会出现问题,不支持用户创建项目(详情请点击此处)。该问题已在最新的预发布版本中得到了解决,但该解决方法还未用于 Cocos2d-x 的最新发布版本中。