Cocos2d-x 配置Android & cocos2d-x 开发环境

配置Android & cocos2d-x 开发环境

1. 配置Android开发环境

1.1 安装VS2010，Visual Assist_X，Cygwin，Java，带Android ADT的Eclipse，SDK，NDK

VS2010：微软开发的集成开发环境，也是cocos2d-x的C++主战场。

Visual Assist_X：这款神奇是VS2008必装的插件，智能提示，辅助功能，是VS的好基友。

Cygwin：windows平台上运行Linux的模拟环境，对于从Linux到Windows的应用程序移植，或者是使用GNU工具集在Windows上进行嵌入式开发都非常有用。可以通过在线安装，也可以离线进行安装，我们这里主要用来进行cocos2d-x跨平台（安卓）的交叉编译。

Java：Android支持的编程语言，也是安卓环境搭建的基础。主要麻烦的地方是环境变量的设置。

Eclipse：集成开发环境是用以android app，当然也可以进行C++的开发，只要你安装相应的组件即可。安装Android ADT就可以进行Android app的开发，这里选择直接使用谷歌提供的打包好Android ADT的Eclipse，就免去了ADT的安装等操作。安装完成后，通过SDK管理器下载相应SDK版本就可以了。

Android NDK：Android系统对外提供的基于C++接口的软件工具包，它集成了交叉编译器，只要修改相应的编译脚本文件就可以创建出so文件，且自动将其与Android app进行打包。

1、安装Java JDK

http://www.oracle.com/technetwork/java/javase/downloads/index.html

配置环境变量：
新建一个JAVA_HOME键，值设为JDK的安装目录。

打开PATH键，在末尾增加

 ;%JAVA_HOME%\bin

检测：

javac -version

2、安装Apache ANT Build System

下载并安装：
http://ant.apache.org/bindownload.cgi

设置环境变量：
增加ANT_HOME键，值为Apache ANT的安装目录。

在PATH末尾增加： ;%ANT_HOME%\bin

检测：

 ant -version

3、安装Android SDK和eclipse

http://developer.android.com/sdk/index.html

设置环境变量：

新增

 ANDROID_SDK_HOME键，值为Android SDK的安装目录。

在PATH末尾增加：

 ;%ANDROID_SDK_HOME%（SDK的根目录）

 ;%ANDROID_SDK_HOME%\tools（tools目录含有和平台无关的SDK的工具）

 tools;%ANDROID_SDK_HOME%\platform-tools（plateform-tools目录和平台有关的目录）

4、安装Cygwin：

Android NDK tools是一些UNIX-Like的命令，还有一些NDK组件是shell脚本。Cygwin是一个Windows下的UNIX—Like环境。

下载安装：

http://cygwin.com/install.html

1、选择“Install From Internet”

2、搜索“make”，找到GNU Make并选择

3、设置环境变量：
新增CYGWIN_HOME键，值为Cygwin的安装目录，在Path末尾增加;%CYGWIN_HOME%\bin

5、安装Android NDK

http://developer.android.com/tools/sdk/ndk/index.html

设置环境变量：

新增

 ANDROID_NDK_HOME键值为Android NDK安装目录，在PATH末尾增加;%ANDROID_NDK_HOME%

5、安装Eclipse

http://www.eclipse.org/downloads/

6、安装Android ADT：
在Eclipse里点击Help->Install New Software,Name输入Android ADT，Location输入https://dl-ssl.google.com/android/eclipse/，

Select All并安装。

1.2 Cygwin的安装

获取setup.exe安装引导程序：http://cygwin.com/install.html

Cygwin离线包下载地址：http://pan.baidu.com/share/link?shareid=561923288&uk=637953331

1）选择安装方式。这里推荐Install from Internet在线下载安装；

2）选择安装目录。比如D:\Cygwin，注意此目录是指Cygwin这个虚拟机的安装目录，不是下载文件暂存目录,也不是NDK的目录；

3）设置本地包暂存路径。暂存目录默认是放到setup.exe的同级目录下 我的是http%3a%2f%2fmirrors.163.com%2fcygwin%2f，可以备份下来；

4）选择Devel install和Shells install两项，缺一不可。

5）运行安装目录(D:\Cygwin)下的“Cygwin.bat”,输入：“cygcheck -c cygwin”命令，会打印出当前Cygwin的版本和运行状态，如果status是ok的话，则cygwin运行正常。输入：“make –v”和，“gcc –v”命令如果检测成功，会有make和gcc相关版本信息打印出来。

6）设置Cygwin环境变量：

7）运行Cygwin命令行，可以直接使用$ndk环境变量，不用每次都手动输入目录

8）编辑D:\cygwin64\home\HZH下的.bash_profile，在尾部加上：

<span style="font-family:Microsoft YaHei;font-size:14px;">NDK_ROOT=/cygdrive/d/Android/android-ndk64-r10-windows-x86_64/android-ndk-r10export NDK_ROOTCOCOS2DX_ROOT=/cygdrive/d/cocos2d-x-2.2.5export COCOS2DX_ROOT</span>

1.3 使用NDK编译程序

1.3.1 编译前，记得配置NDK的环境变量：

1.3.2 编译NDK提供的sample程序native-audio

1）运行Cygwin，输入“cd $ndk/samplesnative-audio/”，进入到“native-audio”工程目录。

2）输入“$ndk/ndk-build”编译。ndk-build是调用ndk的编译程序。

3）用ls命令查看libs/armeabi/下是否生成了so文件，有libnative-audio.so说明ndk运行正常。

4）导入NDK的native-audio示例到Eclipse中

在Eclipse中新建一个Android工程Native-audio。

在Create Android Project时勾选“Create project from existing source”，Location中填native-audio的地址。

5）直接以Android Aplication运行com.example.native-audio.Native-audio项目。要先有.so文件才能运行起来。

1.4 在Eclipse中集成C/C++开发环境CDT

CDT插件可以在一个工程中同时开发基于C/C++的Native代码和基于Java的代码，加上Sequoyah插件可以一次编译两部分代码。

下载地址：http://www.eclipse.org/cdt/downloads.php. 不同eclipse版本要下载对应的包，否则安装不了。

安装：Eclipse -> Help -> Install New Software，点击add。

Name：CDT_版本

Location：点击Archive，定位到下载的CDT离线安装包。

2. 配置Cocos2d-x开发环境

2.1 下载Cocos2d-x开发包

传送门：http://www.cocos2d-x.org/download，下载完解压即可，运行build-win32.bat进行编译。

2.2 使用VS模板

点击cocos2d-win32.vc2010.sln，则在VS2010中可以看到coco2d-x给我们示范的模板。选中某个工程，右键点击“设为启动项目”，编译即可。

这里如果出现了“LINK : fatal error LNK1123: 转换到 COFF 期间失败: 文件无效或损坏”这个问题，有两种解决方法：

1）项目-->项目属性-->配置属性-->连接器-->清单文件-->嵌入清单 中的“是”改为“否”

2）将\Microsoft Visual Studio 10.0\vc\bin\cvtres.exe删掉。因为安装Microsoft Visual Studio 10.0，会在我们的电脑上出现两个cvtres.exe。一个在C:\Windows\Microsoft.NET\Framework\v4.0.30319\cvtres.exe，另一个安装VS的软件目录。而系统变量里将两个都引用了，编译的时候，不知道用哪个了，导致出错。

2.3 Python创建HelloWorld项目

2.3.1 安装python

这里使用的是2.7.5版本，传送门：http://www.python.org/download/releases/2.7.5/， Windows X86 msi installer。不同的python版本可能会导致后面运行出错。所以建议使用此版本。

2.3.2 设置环境变量

这样就可以在cmd中键入python，进入python编译器了~

2.3.3 创建项目

进入cocos2d-x-2.2.5\tools\project-creator目录，可以在Cygwin下执行：

python create_project.py -project Helloworld -package com.hzh.Helloworld -language cpp

运行proj.win32下的Helloworld.sln，并在VS2010下编译生成，即可看到如下工程

2.4 导入Eclispe,生成apk

2.4.1 将proj.win32里面的.h以及.cpp文件拷贝到Classes中（如果以后修改那些.cpp文件或.h文件需要继续从proj.win32拷贝到Classes中覆盖掉之前的文件再生成新的android工程）

2.4.2 进入proj.android，在build_native.sh文件的#options下加:

NDK_ROOT=/cygdrive/d/Android/android-ndk64-r10-windows-x86_64/android-ndk-r10
COCOS2DX_ROOT=/cygdrive/d/cocos2d-x-2.2.2/cocos2d-x-2.2.2
GAME_ROOT=$COCOS2DX_ROOT/projects/Helloworld
GAME_ANDROID_ROOT=$GAME_ROOT/proj.android
RESOURCE_ROOT=$GAME_ROOT/Resource

2.4.3 修改下jni目录下的Android.mk,Application.mk文件，否则会因为找不到关键文件出现编译错误。Android.mk文件中需要添加：

$(call import-add-path,D:/cocos2d-x-2.2.2/cocos2d-x-2.2.2)
$(call import-add-path,D:/cocos2d-x-2.2.2/cocos2d-x-2.2.2/cocos2dx/platform/third_party/android/prebuilt)

2.4.4 Application.mk文件则需要添加cpu类型：

APP_ABI := armeabi armeabi-v7a

2.4.5 NDK工具编译so:

打开cygwin，然后进入目录Helloworld/proj.android/，执行./build_native.sh

2.4.6 eclipse打开工程编译生成apk

选择Exiting Android Code Into Workspace创建Helloworld项目。这时要将D:\cocos2d-x-2.2.5\cocos2dx\platform\android\java\src上的org文件夹拷贝到D:\cocos2d-x-2.2.5\projects\Helloworld\proj.android\src上，否则会编译不通过。

如果成功，将会在D:\cocos2d-x-2.2.5\projects\Helloworld\proj.android\bin中产生Helloworld.apk文件。

大功告成！

附：Cocos2d-x相关的博客以及官网信息

1、CSDN博主无幻的博客：http://blog.csdn.net/akof1314/article/category/1175224

2、CSDN博主bill_man小满的专栏：

(1)cocos2d-x游戏实例：http://blog.csdn.net/column/details/cocos2d-x-game.html

笔者通过自学cocos2d-x自己写的一些游戏实例，并进行讲解，也是cocos2d-x入门的进阶篇

(2)cocos2d-x入门：http://blog.csdn.net/column/details/cocos2d-x-study.html

cocos2d-x入门学习笔记，主要介绍cocos2d-x的基本结构，并且介绍引擎自带的示例

3、CSDN博主Cocos2der的专栏：http://blog.csdn.net/yanghuiliu?viewmode=contents

cocos2d-x游戏开发：使用cocos2d-x开源引擎开发Iphone游戏。 Cocos2D是iPhone开发中一个非常有用的库，它可以让你在创建自己的iPhone游戏时节省很多的时间。它具有很多的功能，比如sprite(精灵)扶持，非常酷的图形效果，动画效果，物理库，音频引擎等等。

4、CSDN博主fylz1125的博客：http://blog.csdn.net/column/details/lerry.html

5、CSDN博主红孩儿的博客：http://blog.csdn.net/honghaier/article/category/1217322

6、博客园博主子龙山人的博客：http://www.cnblogs.com/zilongshanren/tag/cocos2d-x/

子龙山人还有很多关于Coco2d的博文：http://www.cnblogs.com/zilongshanren/tag/cocos2d/

7、官网wiki：http://www.cocos2d-x.org/projects/cocos2d-x/wiki

8、Cocos2d-x的2.1.2版本之后创建新项目的方法：http://cocos2d-x.org/projects/cocos2d-x/wiki/How_to_create_a_multi-platform_project_in_one_command_line

9、Cocos2d-x 2.1.2以前，旧版本的Win32创建工程配置方法：http://blog.csdn.net/ccf19881030/article/details/9204801

10、Cocos2d-x 2.1.4在线参考手册：http://www.cocos2d-x.org/reference/native-cpp/index.html

11、Setting Up Cocos2d-x Android Development on Win7：http://zilongshanren.com/blog/2013/10/26/seting-up-cocos2d-x-android-development-on-win7/

12、触控科技Cocos2d-x开发团队提供的中文用户手册：https://github.com/chukong/cocos-docs/blob/master/catalog/zh.md

13、《Cocos2D权威指南》一书的随书源代码：https://github.com/ccf19881030/Cocos2DBookSource

14、How To Make A Simple iPhone Game with Cocos2D 2.X Tutorial：http://www.raywenderlich.com/25806/harder-monsters-and-more-levels-how-to-make-a-simple-iphone-game-with-cocos2d-2-x-part-3