Cocos2d-x 开发环境搭建

闲话：9月没写博客，唉~ 假期归来，快快更新一篇。

吐槽：在QQ群里经常看见有人问 Cocos2d-x的开发环境如何搭建，此时我就在想怎么不去官网找呢，引擎从哪下的，文档就在哪。后来我去官网看了看，发现Cocos2d-x的官网组织好混乱，想找到官方写的教程，要费一番功夫。而且官网经常抽风，不是打开的慢就是无法打开，至今用百度搜索Cocos2d，找到官网地址也是不易，就有一个英文版的还是比较稳定。先前在官网发现一个官方写的新手教程，我就添加到书签了，后来不知为何，这个书签存的网址也不在了~

开篇：本篇依据官网上的两篇教程，加上我的亲自试验作为补充说明，组成一篇基础的开发环境搭建。

开发环境及需要的软件：

1. win10 64位 
2. Android
3. NDK android-ndk-r9d
4. Visual Studio 2013
5. Cocos2d-x 3.8.1
6. JDK jdk1.8.0_31
   
7. Python 2.7.6
8. Ant apache-ant-1.8.2
9. git

请事先下载需要的软件并安装，比如 Python, JDK等，像 NDK，Ant 都不需安装，解压即可。

官网教程地址一：

如何在Windows 7平台搭建Android Cocos2d-x3.2alpha0开发环境  P.S.最近看了下这个官网教程也消失了 ->_-> 先留个链接在这吧

官网的这篇教程用的是 win7 系统，引擎版本是 3.2alpha0，目前来说还是可以参考使用的，里面写的需要下载的软件以及运行的命令基本一样。在win10系统，引擎版本3.8.1下还基本可以使用，不同的地方在博客下面会有指出。 可以根据官网这篇教程来下载需要的软件以及配置环境变量。

一：Win32

配置环境最简单一个就是 Win32，下载引擎后，解压后直接用 Visual Studio 2012/2013 打开编译即可。3.8.1版本的引擎基本和3.2的一样。下面简单介绍一下。

1.下载引擎

3.8.1引擎下载地址 http://www.cocos.com/download/# 选择 Cocos2d-x 下载。下载完后，解压引擎。我一般都是直接解压到一个盘的根目录。

P.S.最近看了下官网的所有下载链接都失效了，全是404 ->_->

1.1在官网如同倒闭的情况下，如何下载引擎

cocos2d-x的官网太烂了！！！

现在如果想下载各版本引擎的话可以去 cocos2d-x 的官方 github。

官方 github  地址： 

https://github.com/cocos2d/cocos2d-x.git

操作步骤：

(1) 使用 git clone 命令，先将远程仓库clone 到本地。

git clone https://github.com/cocos2d/cocos2d-x.git

git clone 执行成功后，本地还是没有工程，但是命令界面会列出cocos2d-x的所有版本。

(2)使用 git checkout 命令下载你想要的工程。比如你想要 2.2.6 版本，那么命令如下：

git checkout cocos2d-x-2.2.6

执行成功后就会把 2.2.6 版本的引擎下载到本地。

2.使用 Visual Studio 打开引擎工程

解压后的引擎目录如下

然后打开 build 文件夹，运行 cocos2d-win32.sln。

解决方案在VS中打开后目录如下

想简单点完成的就鼠标右键选中 cpp-empty-test，将其设置为启动工程，然后直接 F5 开始编译，编译成功后就会运行那个 HelloWorld，此时你的 win32 环境就搞定了，so easy！其实也没有配置什么，此时如果想写 C++ 代码了，就可以开动了。如果此阶段想了解更多就可以运行那个 cpp-tests 工程，里面全是引擎写好的的例子，引擎里有什么不会用的就可以来这个 tests 里找找，看看就知道是如何使用的了。

二：Android

此段会使用python脚本创建一个新的Cocos2d-x工程，其中不仅包括Android还有win32,IOS等。

根据上面的官网教程一，此时应该已经创建了几个环境变量，包括 ANDROID_SDK,NDK_ROOT，但是我们还差几个环境变量。

1.配置环境变量

新建几个环境变量。下面贴出的环境变量地址是我本机的目录地址，我基本上都是放在E盘根目录的，请根据自己软件的目录地址做相应修改！！！

1. ANDROID_SDK_ROOT = e:\android-develop-sdk2.0\android-sdk-windows 注意：把上面创建的 ANDROID_SDK名修改为 ANDROID_SDK_ROOT
2. ANT_ROOT = e:\apache-ant-1.8.2\bin
3. COCOS_CONSOLE_ROOT = E:\cocos2d-x-3.2\tools\cocos2d-console\bin
   
4. NDK_ROOT = e:\android-ndk-r9d
   

附加 JDK,Android 和 Python 的环境配置

JDK：

1. JAVA_HOME = C:\Java\jdk1.8.0_31
2. CLASS_PATH = .;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar
   
3. Path = ;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;  注意：Path 这段环境变量是把后面的地址添加到 Path 变量中，系统一般都会存在 Path环境变量。在Path中添加变量地址时记得用分号隔开，我这里已写了分号。

Android:

在 Path 中添加一段即可 Path = E:\android-develop-sdk2.0\android-sdk-windows\platform-tools;E:\android-develop-sdk2.0\android-sdk-windows\platforms;

Python:

在 Path 中添加一段即可 Path = d:\Python27;

再次说明，请根据自己的目录地址做修改，不要直接粘贴使用。

2.创建新工程

根据官网教程 

创建Cocos2d-x项目

可以创建一个新的 Cocos2d-x 项目。以我的命令举例：

创建成功后，新工程目录如下。proj.xx 下就是对应平台的的工程。我们目前只关注 proj.android。P.S.那个bin文件夹是后来生成的，下面会讲到，不要在意~

按照官网的教程步骤

生成Android项目文件

运行 proj.android 下的 build_native.py，来编译 C++ ，生成 so 文件。 如果双击运行build_native.py有问题的话请和运行 coco.py 一样，要在命令行下运行，也可以直接命令行下运行 build_native.py,不必写 python。

不同之处一

3.8.1版的引擎运行 build_native.py 后有一个地方和 3.2的不同，就是3.8.1下这个命令可以直接生成apk。运行命令结果界面如下。P.S.我把工程转移到 Cocos2dProject目录下了

看输出，会发现在新建工程的根目录下出现一个 bin 文件夹，生成的 apk 文件就会放到它的子目录中。如果把此 apk 安装到手机上，运行的就是一个 Cocos2d-x 的 HelloWorld 界面。

不同之处二

按教程的最后一步，将 proj.android 直接导入 eclipse 后就可以直接运行了，但是我试过 3.1， 3.2， 3.8.1的，走到此步骤后总是会出错。出错如下

错误信息为  Cocos2dxActivity cannot be resolved to a type

如果你进工程属性 Android 选项下会发现有个静态库没有引入。

(⊙o⊙)… 这里就很无语了，我已不明白当初写这个教程的人他是如何完成这个高难度动作的。而且教程还有个小错误（再次吐槽），截图如下

文字写的是选 “Existing Projects into Workspace”，截图却显示的是"Existing Android Code Into Workspace"，当然，目前针对这个工程来说，选这两个都一样。不过官网的文档都这样，实在让人汗颜。

好了，废话说话，开始说解决方案 ：

错误解决方案：

我还是推崇用 3.1 时代的导入静态库，网上有说复制源码的也可以的。这个错误就是因为当前的工程找不到引擎端的java代码了，我们把他引进来吧。

去你新建工程的此目录下，把 java 工程也导入到 eclipse 中。

这个工程是个静态库，引入此静态库即可。

然后工程无错误鸟，把手机插上电脑，跑起来，和先前装的apk一样。P.S.在3.2导入此静态库后，静态库因为缺少 res 文件夹也会报错，摔街啊，遇见此情况时，去你下载的引擎目录那把 res 拷过来即可。

到此，你已有了VS上的win32工程和eclipse上的Android工程。其实在2.X时代时，一直是在VS上写C++代码，eclipse上写Java代码，现在Cocos2d出了新的IDE了，就可以在一个IDE上写代码了。

3.12版引擎更新说明：

3.12 版本的引擎，在使用cocos命令创建完工程后，proj.android下不再有 build_native.py 脚本了，如果你从其他地方拷贝过来使用的话，会提示你使用 cocos 命令来编译。可以在工程根目录使用

cocos compile -p android

命令来编译android工程，运行成功后，会在工程根目录创建一个bin 文件夹，生成的debug apk 就在里面。

还有一点就是3.12版引擎编译c/c++使用的 ndk 版本是 r10c ,我试过 r9d, r10b, r12b都不能成功编译。

不得不说 cocos 发展越来越不规范了，新手入门的难度太大了。

官网上还有个教程是写如何运行引擎里的测试工程，但似啊，win32没有问题，Android却是问题多多，改天再瞅瞅~ 先把教程地址贴出来，有兴趣的可以看看~ 

P.S.感觉越来越坑了呢~

HOW TO RUN CPP-TESTS ON ANDROID

最后祝各位国庆玩的Happy! P.S.堵的也Happy