cocos2dx用什么开发环境

Cocos2D-x 2.0 以上版本支持跨 Win32、Android、iOS 三个平台。本文将详细介绍如何在这三个平台上搭建 Cocos2D-x 的开发环境。

一、Windows 开发环境配置

1. Visual Studio 安装

Cocos2D-x 支持的 Visual Studio 版本有 VS2008、VS2008 Express、VS2010 和 VS2012。本文选择 VS2010 作为开发环境，并搭配 Visual Assist X 使用。

2. Cocos2D-x 安装与配置

• 下载：从 Cocos2D-x 官网（http://www.cocos2d-x.org/ ）下载最新版本的 Cocos2D-x（如 cocos2d-2.1rc0-x-2.1.3）。
• 解压：将下载的文件解压到指定目录。
• 安装模板：双击运行目录下的 install-templates-msvc.bat 文件进行安装。
• 打开项目：双击对应开发工具的 sln 文件，对于 VS2010 而言，对应的是 cocos2d-win32.vc2010.sln 文件，打开文件的同时会启动相应的 VS 开发环境。
• 验证安装：编译运行自带的 HelloCpp 项目来验证 Cocos2D-x 的安装是否正确。右键单击选中 HelloCpp 项目，将其设置为启动项。单击 Build 按钮构建 Cocos2D-x 项目，也可以单击 Debug 按钮调试运行 HelloCpp 项目。

3. Cocos2D-x 工程目录

Cocos2D-x 每个版本的工程目录会有所不同，以 cocos2d-2.1rc0-x-2.1.3 为例，其工程目录主要包括以下 4 部分：

• project-common（公共部分）
• libBox2D：物理引擎 Box2D
• libchipmunk：物理引擎 Chipmunk
• libcocos2d：引擎核心
• libCocosDenshion：声音模块
• libExtensions：扩展模块
• project-cpp（C++ 测试工程）
• project-js（JavaScript 测试工程）
• project-lua（Lua 测试工程）

4. 新建项目及交叉编译

新建项目的过程与新建 VC 项目类似，不同之处在于选择 Cocos-2d-x 项目类型中的 Cocos2d-win32 Application。在工程向导中，可以选择使用的物理引擎、是否使用 Cocos Denshion 音乐模块、是否支持 Lua 脚本等，完成设置后编译运行即可。

二、Android 开发环境配置

Android 是 Google 推出的开源手机操作系统。早期，第三方应用主要使用 Java 语言开发，直到 2009 年 6 月，Google 发布了 NDK（Native Develop Kit，原生态本地开发包），支持开发者使用 C/C++ 语言开发 Android 应用程序。Android 的开发环境至少需要 Eclipse、Android SDK 和 NDK 来支持 C/C++ 应用开发。

1. Cocos2D-x 软件安装与配置

• JDK：JDK（Java Development Kit）是 Java 开发工具，可点击这里下载。
• Eclipse：这是一款支持 Java 和 Android 开发的开源集成开发工具，建议下载 C++ 版 Eclipse，这样就无需安装 CDT 插件。Eclipse 是绿色版，解压后即可使用，可点击这里下载。
• ADT：ADT（Android Development Tools，Android 开发插件）是 Android 开发的 Eclipse 插件。使用 Eclipse 在线安装方式安装 ADT：启动 Eclipse，选择 Help -> Install New Software，在 Work with 栏中输入网址 http://dl-ssl.google.com/android/eclipse，单击 add 按钮提取安装包列表，选择全部（开发工具和 NDK 插件），单击 next -> next，选择 accept licenses，单击 finish 开始安装，安装过程可能较长，请耐心等待。
• CDT：CDT（C++ Development Tools，C++ 开发插件）是 C++ 开发的 Eclipse 插件。若直接安装的是 Eclipse 的 C++ 版本，则可跳过此步。下载地址为 http://wiki.eclipse.org/CDT/User/DownloadCDTLatest，下载压缩包后，选择 Help -> Install New Software，弹出相应界面后 Add 本地的 CDT 地址，即可完成安装。
• Android SDK：Android 开发工具，包括模拟器等。安装完 ADT 后，会弹出提示框让安装 Android SDK，按照提示操作即可。也可以手动下载，地址为 http://developer.android.com/sdk/index.html，下载完后解压到某个目录下，选择 Windows -> Preferences -> Android，在 SDK Location 中选择或输入 Android SDK 地址，单击 Apply -> OK，完成 Android SDK 配置。找到刚才解压的目录，双击启动 SDK Manager，选择安装 Android 的其它版本或相应工具。
• Android NDK：Android 原生态本地开发包，辅助 SDK 进行编译开发，支持 C/C++。手动下载 Android NDK，地址为 http://developer.android.com/tools/sdk/ndk/index.html。将 NDK 解压到某个目录下，选择 Windows -> Preferences -> Android -> NDK，在 NDK Location 中输入 NDK 的地址，单击 Apply -> OK，完成 Android NDK 配置。
• Cygwin：在 Windows 平台上运行的 UNIX 模拟环境，是 Cygnus Solutions 公司开发的自由软件。不过，Android NDK 从 r7 开始，编译时可省去 Cygwin。
• 编译并运行 HelloCpp 项目
• 加载项目：选择 File -> New -> Project，在弹出的对话框中选择 Android Project from Existing Code，选择项目路径 cocos2d-2.1rc0-x-2.1.3\samples\Cpp\HelloCpp\proj.android，点击 Finish 完成项目加载。右键单击项目 HelloCpp，选择 Properties -> Builder -> New，在弹出的对话框中单击 OK，在弹出的对话框中选择 Main 选项卡，然后分别单击 Browse File System 和 Browse Workspace，分别选择 ndk-build.cmd 和项目路径。
• 刷新配置：选择 Refresh 选项卡，勾选 Refresh resources upon completion，选择 Specific resources，单击 Specify Resources 弹出对话框，勾选 HelloCpp，单击 Finish -> OK。
• 设置环境变量：Cocos2D-x 2.0 以上版本还需要设置 NDK_MODULE_PATH 环境变量，填写 Cocos2D-x 库路径和第三方库路径，中间用分号分隔，规则同 Windows 环境变量。可以在上图配置中点击 Environment 选项卡，点击 New，在 Name 中输入 NDK_MODULE_PATH，在 Value 中输入 E:\android\cocos2d-2.1rc0-x-2.1.3;E:\android\cocos2d-2.1rc0-x-2.1.3\cocos2dx\platform\third_party\android\prebuilt，然后一路单击 OK。也可以编辑当前项目的 jni 文件夹下的 Application.mk 文件，在末尾添加上 NDK_MODULE_PATH:=E:\android\cocos2d-2.1rc0-x-2.1.3;E:\android\cocos2d-2.1rc0-x-2.1.3\cocos2dx\platform\third_party\android\prebuilt。需要注意的是，路径中不能含有空格符，Windows 用分号、Linux 用冒号做分隔符。
• 复制文件：将 NDK 目录 E:\android\android-ndk-r8e\sources\cxx-stl\gnu-libstdc++\4.7\libs\armeabi 下的 libgnustl_static.a 文件复制到项目文件夹下 E:\android\cocos2d-2.1rc0-x-2.1.3\samples\Cpp\HelloCpp\proj.android\obj\local\armeabi。之后右键项目选择 run as -> Android Application 运行，可能会出现如下 warning：Android NDK: WARNING: APP_PLATFORM android-14 is larger than android:minSdkV，可以忽略该警告，若觉得不爽，可打开 E:\android\android-ndk-r8e\build\core\add-application.mk，将第 128 行的 __ndk_warning 改为 __ndk_info，但这样做的后遗症是不再提示 warning。
• 编译项目：配置好后，选择 Project -> Clean，再选择 Project -> Build，开始编译项目，若控制台输出 Install : libhellocpp.so => libs/armeabi/libhellocpp.so，则表示编译成功。

需要注意的是，所有组件的安装，包括 cocos2d-x 最好都放在非中文且目录无空格的路径下，否则可能会出现类似 Android NDK: Please define the NDK_PROJECT_PATH variable to point to it 的错误。

2. Cocos2D-x 工程目录

Cocos2D-x 工程目录主要包括以下内容：

• src：工程目录下会有几个带有 src 的文件夹，分别包含各自的源文件，包括入口类 Activity、处理声音和加速度传感器的类等。
• gen：自动生成的 R.java 文件、BuildConfig.java 文件等。
• assets：资源文件。
• bin：APK 包文件等配置文件。
• jni：包括编译时使用的 MK 文件等。
• libs：库文件（.so 文件）。
• obj：目标文件，包括.so、.o 等文件。
• res：XML 等配置文件。

3. 新建项目及交叉编译

新建项目需要用到 Cygwin，具体步骤如下：

• 安装 Cygwin：从官网上下载并安装，下载地址需补充。
• 修改配置文件：修改 Cocos2D-x 目录下的 create-android-project.bat 文件中 Cygwin、Android SDK 和 Android NDK 目录的位置。
• 创建项目：双击执行 create-android-project.bat 文件，在命令行模式下输入项目路径和名称、SDK 版本等，选择 target id。
• 编译运行：编译运行项目，就能在 E:\android\cocos2d-2.1rc0-x-2.1.3\samples\Cpp\HelloCpp\proj.android\bin 目录下看到 HelloCpp.apk 包。

三、iOS 开发环境配置

iOS 是苹果公司开发的手持设备操作系统，最早于 2007 年 1 月 9 日在 Macworld 大会上发布，最初是为 iPhone 设计的，后来陆续支持 iPod Touch、iPad 以及 Apple TV 等苹果移动设备。iOS 以 Darwin 为基础，属于类 UNIX 系统，原名为 iPhone OS，2010 年 6 月 7 日在 WWDC 大会上改名为 iOS。

Xcode 是苹果公司向开发人员提供的集成开发环境，类似于微软的 VS，用于开发 Mac OS 应用程序。iOS SDK 是 iOS 系统的开发工具，只要安装了 Mac OS X Snow Leopard 10.6.2 以上版本的 Mac OS 操作系统，即可安装 iOS SDK，可以使用 iPhone 模拟器进行调试或者使用真机进行调试。

在 iOS 上开发基于 Cocos2D-x 的应用程序也需要使用 Xcode，可点击这里下载安装文件，下载前需要注册苹果开发者。如果链接不好使，也可以点击这里下载，下载后通过共享文件的方式将安装文件上传到虚拟机上（如何共享可参看《iOS 之 PC 与 MAC 虚拟机之间的文件传输》），双击 DMG 文件进行安装即可。

1. Cocos2D-x 安装与配置

• 解压运行：将 Cocos2D-x 压缩包解压到某个目录下，即可运行 HelloWorld 项目。
• 打开项目：双击 sample/Cpp/HelloCpp/proj.ios 目录下的 iOS 工程文件（HelloCpp.xcodeproj），用 Xcode 打开 HelloWorld 项目，单击 Run 即可在 iPhone 模拟器和 iPad 模拟器上运行。
• 安装模板：在 Mac 系统上安装 Cocos2D-x 模板。单击 Finder -> 前往 -> 实用工具 -> 终端以启动终端，切换到 Cocos2D-x 解压目录，输入命令 sudo ./install-templates-xcode.sh 进行安装。

2. Cocos2D-x 工程目录

Cocos2D-x 工程目录主要包括：

• Classes：Cocos2D-x 游戏逻辑类，即我们编写的类文件。
• Frameworks：引擎所使用的框架部分。
• ios：iOS 平台相关专用类。
• Products：编译生成的包文件。
• Resources：资源文件夹。

3. 新建项目及交叉编译

• 选择项目类型：选择 File -> New -> Project，弹出工程设置向导对话框，选择 cocos2d-x，选择框架类型 cocos2dx，点击 next。
• 输入项目信息：输入产品名称 world，Company Identifier（mancini），点击 next。
• 选择工程目录：选择工程目录，点击 create 创建工程，默认工程目录在桌面上。
• 编译运行：选择相应的模拟器，点击 run 编译运行项目。

四、用 Doxygen 生成 Cocos2D-x 文档

Doxygen 是一种开源跨平台的工具，其功能是从源码中抽取类、方法、成员的注释，形成一个和源码配套的 API 帮助文档。Doxygen 支持 C、C++、Java、Objective-C 等语言。Cocos2D-x 代码依照其规则，并且提供了 doxygen.cocos2d-x 文件，这是 Cocos2D-x 代码的 Doxygen 配置文档，可以通过这个文件生成 Cocos2D-x 文档。

点击这里下载 Doxygen，根据需求选择版本下载，这里以 Windows 安装版为例。安装完成后，启动 Doxygen，选择 File -> Open 打开 Cocos2D-x 目录下的 doxygen 目录下的 doxygen.cocos2d-x 文件，选择 Run 选项卡，单击 Run doxygen 运行并生成文档，Cocos2D-x\doxygen\html 目录下的 index.html 文件即为 Cocos2D-x 文档。