如何搭建cocos2d-x v.2.2.3

本指南将详细介绍如何在Windows 7平台搭建Cocos2d-x Android开发环境。操作要求一台搭载Windows 7平台且安装了Visual Studio 2012/2013的电脑，同时建议拥有快速稳定的网络，因为在操作过程中需要下载许多软件包。

搭建开发环境所需工具

Visual Studio 2012/2013

由于Cocos2d-x - v3.x引擎不能用老版本的VS编译，所以需要下载安装Visual Studio 2012或2013。VS的安装过程相对简单，本教程不做详细讲解。

Cocos2d-x

本教程以Cocos2d-x 3.2alpha0版本为例，可从下载地址获取。

JAVA JDK

Android SDK

NDK

具体操作步骤

下载Cocos2d-x 3.2alpha0引擎

用户可登录Cocos2d-x官方网站下载最新版的Cocos2d-x。点击导航栏的“Download”（下载），会看到相应的下载页面。

本指南以目前最新版本的Cocos2d-x 3.2alpha0引擎为例。（注意：若想下载旧版的Cocos2d-x，可点击“looking for an old versoin?”链接。不过，强烈推荐使用最新版本的Cocos2d-x，新版引擎有很多新功能，且修复了旧版的诸多问题。）

右键单击“Download”链接，选择“save link as…”（将链接保存为…），然后将压缩文件保存至合适的位置，例如本机保存位置为 D:\Cocos2d-x\Cocos2d-x 3.2alpha0。（注意：请不要将Cocos2d-x文件夹放置在 c:\ 下，因为这可能会导致很多优先级别（privilege）相关的问题，可尝试将该文件夹放到其他盘，如 D:\ 及 E:\ 等。）

打开 D:\Cocos2d-x\Cocos2d-x 3.2alpha0\build 目录，双击“cocos2d-win32.vs2012.sln”文件，会自动启动Visual Studio 2012/2013。

此时，可将HelloCpp项目当作默认启动项目来编译，按 CTRL - F5 运行样本程序。若编译无错误且运行成功，将看到相应画面。

祝贺你！你已成功在Windows 7平台中运行Cocos2d-x引擎。接下来将介绍如何配置Android开发环境。

安装配置JAVA JDK

因为是针对Android开发，所以需要安装的第一个软件包是JDK。如果使用的是64位的Windows 7，应下载64 bit JDK for windows 64bit，下载地址。

下载完成后，双击exe文件安装JDK，注意最好不要将其安装在有空格或者中文的文件夹下，其他无限制，同时记下其安装路径，例如本机安装路径为：D:\Program Files\Java\jdk1.7.0_51\。

配置环境变量

• 新建环境变量：JAVA_HOME，值为：D:\Program Files\Java\jdk1.7.0
• 新建环境变量：CLASSPATH，值为：.;%JAVA_HOME%\lib;（注意：点号表示当前目录，不能省略）
• 在系统变量 Path 的值的前面加入以下内容：%JAVA_HOME%\bin;（注意:这里的分号不能省略）

至此，JDK安装完毕。单击“开始”—>“运行”—>输入：cmd 命令，在CMD窗口中输入：java -version，若出现相应界面，则表示安装成功。

安装配置Android SDK

点击进入该页面，下载ADT包，它能帮助快速开始开发应用程序。该包包括了必要的Android SDK组件和一个内置ADT(Android开发者工具)的Eclipse IDE版本，简化了Android应用程序开发。

下载Android SDK后解压，并将其放置于指定目录下，在 ..\adt-bundle-windows-x86_64-20131030\eclipse 文件夹中会有一个 eclipse.exe 程序，可在桌面上创建该程序的快捷方式。

现在双击桌面的快捷方式启动Eclipse，会出现一个即时对话框，要求设置默认工作区（workspace），选择“OK”接受默认设置即可。

配置环境变量

• 新建环境变量：ANDROID_SDK，值为：D:\TDDownload\android\adt-bundle-windows-x86_64-20131030\sdk\platforms\;D:\TDDownload\android\adt-bundle-windows-x86_64-20131030\sdk\tools\;D:\TDDownload\android\adt-bundle-windows-x86_64-20131030\sdk\platform-tools（D:\TDDownload\android 是SDK存放的位置）。
• 在系统变量 Path 的值的前面加入以下内容：%ANDROID_SDK%

单击“开始”—>“运行”—>输入：cmd 命令，在CMD窗口中输入：adb -h 检验是否安装成功。

在 ..\adt-bundle-windows-x86_64-20131030\sdk 目录下有两个可执行程序，“AVD Manager.exe”和“SDK Manager.exe”，可直接通过它们创建管理AVD和SDK。

安装NDK

安装完Android SDK之后，还需安装“Android NDK”软件包，用户可前往该地址下载。下载完成后，解压并将其放置到相应路径，例如本机路径为 D:\android-ndk-r9，设置另一个名为“NDK_ROOT”且指向存放路径的环境变量。

Android NDK包含 build、docs、samples、sources、GNUmakefile、ndk-build、ndk-gdb 及 readme 等内容。

创建Cocos2d-x项目

将刚才下载的 cocos2d-x - 3.2alpha0 压缩包解压到指定的文件夹里。

进入到目录 cocos2d-x-3.2alpha0/tools/cocos2d-console/bin/cocos.py，打开终端运行 cocos.py 脚本创建文件，命令如下：

python cocos.py new test -p com.coco2dx.org -l cpp -d ~/Desktop

参数说明

• test 为项目名称
• -p 后面接包名
• -l 后面接开发语言类型，有 cpp、lua、js 三种类型
• -d 后面接项目存放的目录

生成Android项目文件

在新建项目 test 中，执行 proj.android 下的 build_native.py 脚本进行编译。

导入Android项目

最后启动Eclipse并导入Android项目，操作步骤如下：

• 右键点击“Package Explorer”并选择“Import…”
• 当出现对话框时，选择“Exsiting Android project into workspace”（将现有Android项目导入工作区）

按照上述方法将项目导入到Eclipse中。将手机设置成调试模式并用USB线连接到电脑，在Eclipse中运行 test，即可在手机上看到已经运行的HelloWorld。