【Cocos2D-X学习笔记】Mac系统下Android平台环境搭建

在Mac下开发Android平台Cocos2D-X应用，需要准备如下软件、环境：

1、JDK，JAVA开发环境；

2、Android SDK、NDK，要开发Android应用，必须要有这个，NDK主要用来进行交叉编译；

3、Cocos2D-X引擎文件；

4、IDE，Cocos2D-X部分的逻辑用Xcode，进行Android调试及第三方jar包集成时可以使用Eclipse、IntelliJ IDEA、Android Studio等，本文主要介绍Eclipse。

所需软件下载地址：

1、JDK

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

2、Android SDK

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

选择Download For Other Platforms，在SDK Tools Only表格中，下载对应系统的压缩包

3、Cocos2D-X引擎源文件

http://www.cocos2d-x.org

4、Eclipse

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

下载Eclipse IDE for Java EE Developers的对应系统压缩包

5、Android NDK

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

下载对应系统的压缩包即可

具体步骤：

一、JAVA开发环境：

直接安装下载好的安装包，完成后，打开终端，输入 java -version，查看对应的版本号，如果与所下载的版本号一致，则表示安装成功。

这里可能需要配置一下环境变量。终端中运行

sudo chmod +w /etc/profile

sudo vim /etc/profile

vim 的简单用法：

打开文件后，按 i，切换到插入编辑模式，此时可以输入内容，完成后按esc，然后输入 :wq，保存并退出，注：有冒号~~

下面黑色背景的绿色文字是可以复制粘贴的，我是直接从终端中copy出来，才会出现这种颜色。

修改或添加里面的JAVA_HOME，改为新安装的JDK的位置，笔者的环境配置如下

JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_45.jdk/Contents/Home

export JAVA_HOME

修改后保存退出，重新执行java -version，可显示新版本的版本号。

二、Cocos2D-X引擎配置

其实，不需要配置，只要将压缩包解压到你想保存的目录即可

三、Android SDK及NDK

同上，将压缩包解压至要保存的文件夹。

四、环境变量配置

这一步主要是为了方便在终端中调试

终端输入 vim ~/.bash_profile，添加

export PATH=${PATH}:[YOUR_PATH]/android-sdk-macosx/tools

export PATH=${PATH}:[YOUR_PATH]/android-sdk-macosx/platform-tools

export COCOS2DX_ROOT=[YOUR_PATH]/Cocos2D-X_2.2.1

export NDK_ROOT=[YOUR_PATH]/android-ndk-r9c

export ANDROID_NDK_ROOT=[YOUR_PATH]/android-ndk-r9c

export ANDROID_SDK_ROOT=[YOUR_PATH]/android-sdk-macosx

export PATH=$ANDROID_NDK_ROOT:$PATH

export PATH=$ANDROID_SDK_ROOT:$PATH

export PATH=${PATH}:/System/Library/Frameworks/JavaVM.framework/Headers

export PATH=$NDK_ROOT:$PATH

保存后退出，终端输入android -h，出现帮助信息则表示配置正确

五、Eclipse中安装插件

解压Eclipse压缩包到目标目录，初次运行，可能会提示安装一些插件，根据提示安装即可。

犹豫需要在下载Android ADT工具，需要修改hosts

终端输入 vim /etc/hosts，添加

#Google Services START

203.208.46.200  dl.google.com

203.208.46.200  dl.l.google.com

203.208.46.200  dl-ssl.google.com

保存，退出。

在Eclipse中，Help -> Install new Software，点击Work With邮编的Add按钮，Name输入ADT（其实输入什么都行），Location中输入

https://dl-ssl.google.com/android/eclipse/

点击OK。

过一会窗口中会显示如下内容

全部勾选，next，next，然后选择同意，finish，等待下载安装。下载完成后会出现提示框，点OK即可，完成后会提示是否重启Eclipse，如果不安装其他插件，就重启一下吧。

这里还有一些其他的插件，根据需要自行安装吧

SVN - http://subclipse.tigris.org/update_1.10.x

Themes - http://eclipse-color-theme.github.com/update

六、配置Android SDK

重启Eclipse后，会提示配置Android SDK的位置，根据提示找到目录即可。

然后会出现错误提示，platform-tools 未找到之类的，这里有两种配置方法：

1、点击open SDK manager按钮（具体文字记不清了），会出现

2、如果之前的环境变量配置正确，在终端输入android，也会出现上面的窗口。

然后下载对应Android系统版本的工具，其中每个版本中的 SDK Platform是必不可少的。

最上面的Tools一栏中，安装最新的版本，如果有新版，会有升级的提示。相同名称的工具只需要安装最新版即可。

选择好之后，点击Install packages，根据提示操作，然后就是等待~

然后再Eclipse的偏好设置中，展开Android，有一个NDK的项目，在这里添加NDK的目录位置。

完成后重新进入Eclipse，应该没有错误提示了。

七、Cocos2D-X示例工程编译。

新的Cocos2D-X引擎建立工程时跟以前有一些差别，是通过一条python命令直接建立一个跨平台的工程文件夹，具体过程如下。

终端中进入引擎根目录下的tools/project-creator目录中，执行

python create_project.py

会看到如下提示：

Usage: create_project.py -project PROJECT_NAME -package PACKAGE_NAME -language PROGRAMING_LANGUAGE

Options:

  -project   PROJECT_NAME          Project name, for example: MyGame

  -package   PACKAGE_NAME          Package name, for example: com.MyCompany.MyAwesomeGame

  -language  PROGRAMING_LANGUAGE   Major programing lanauge you want to used, should be [cpp | lua | javascript]

Sample 1: ./create_project.py -project MyGame -package com.MyCompany.AwesomeGame

Sample 2: ./create_project.py -project MyGame -package com.MyCompany.AwesomeGame -language javascript

说明这个命令需要三个参数，分别是项目名、包名、使用的语言，都有具体的说明。

现在我要建立一个Test工程，那就执行下面的命令

python create_project.py -project Test -package com.example.test -language cpp

然后出现

proj.ios : Done!

proj.android : Done!

proj.win32 : Done!

proj.winrt : Done!

proj.wp8 : Done!

proj.mac : Done!

proj.blackberry : Done!

proj.linux : Done!

proj.marmalade : Done!

New project has been created in this path: /Users/dusongze/Software/Cocos2D-X_2.2.1/projects/Test

Have Fun!

表示建立成功。

建立好的项目工程位于引擎根目录中的projects文件夹下，其目录结构如图

其中Classes文件夹下保存的是应用的c++文件，是整个游戏/应用的程序逻辑部分，Resources文件夹则是资源文件，也是公用的，这样就不用把cpp文件拷贝到每个平台的工程中了，只需要引用即可。

下面来看看引擎的示例工程：

在引擎目录中的samples/Cpp/HelloCpp中，打开proj.ios文件夹中的xcode工程文件，选择模拟器调试，然后点RUN，即可在ios模拟器中运行、调试cocos2d-x工程。主题逻辑开发过程和其他ios应用类似，唯独不同的是要使用c++语言。

在终端中进入到HelloCpp中的proj.android目录，执行./build_native.sh，漫长编译后，如果没有错误，即可在Eclipse中导入工程，在Android真机上调试运行了。

在Eclipse中，点击File，点击Import，选择proj.android文件夹。导入后会发现有错误，这是因为基础的库还没有导入。

将引擎根目录中的cocos2dx/platform/android/java文件夹导入，

这个就是引擎的基本库，所有的Cocos2D-X应用都需要这个才能编译运行在Android真机上。

右键点击HelloCpp项目，选择最下面的属性，检查Library是否正确导入

没有问题后，右键点击HelloCpp，Run As，Android Application，在真机上运行调试。

如果能正常运行，则本次开发环境配置成功。

第一次写博客，有很多不足的地方，希望大家多多指点，谢谢。

文章中又任何错误，请大家留言指出