cocos2dx[3.2](13)——全平台开发环境配置教程

转自：http://blog.sina.com.cn/s/blog_732d16630101g445.html

---

一、通用准备工作

1、安装Cocos2d-x 3.2。
    在Cocos的主页上：http://cocos2d-x.org/
    这个不用解释了。下载后解压缩就行。

2、安装Eclipse与Android SDK。
    这个在Mac上或是PC上开发都是可以通用的。
    Eclipse在官网：http://www.eclipse.org/
    Android SDK在Android开发者中心：http://developer.android.com
    Eclipse是开发Android需要用到的IDE。这是个很牛X的IDE，有许多插件让他变得三头六臂。要开发Android的程序，需要下载相关的插件，但如果每个插件要自己配置，会是很蛋痛的事情。如果是新手，推荐使用：ADT Bundle。这是Eclipse+Android SDK的合体，所有的项目都已经帮你配置好了。

3、安装JDK：
    Eclipse需要Java环境才能运行。如果事先没有安装Java环境，则会报错。
    解决方案安装jdk：http://www.oracle.com/technetwork/java/javase/downloads/index.html
    一般来说安装之后会自动配置好环境变量。如果还没有解决问题，请查找网络上关于JDK安装的攻略。很多的。

4、安装CDT插件
    地址：http://www.eclipse.org/cdt/downloads.php
    这是个Eclipse的插件，用来支持Eclipse中C/C++语言的开发。从Eclipse的官网下载，下载之后，将features和plusins这两个文件夹里面的内容复制到Ecplise安装目录下对应的文件夹之后就可以了。

5、安装NDK
    地址：http://developer.android.com/tools/sdk/ndk/index.html
    这是进行C/C++与Java混合编译的必要工具。记下下载之后解压到的目录，因为到之后的安装中会用到。

6、安装ANT
    地址：http://ant.apache.org/
    这个是用来干什么的我至今还不明白。但据说Cocos的Android开发需要用到它，其它的攻略上都说需要，所以下载下来安装好吧。



二、PC环境下配置过程

1、安装VS2012。
    地址：网上很多，在官方下载也行。
    最好是2012，我曾经试过2010，2013，都会出这样那样的问题。所以，2012！

2、安装python 2.7.6
    地址：https://www.python.org/download/releases/2.7.6/
    因为Cocos2d-x的安装程序是用phthon写的，所以需要这个软件。不要下载python3.0以上的版本，否则运行会出错。如果是Mac，那么天生就自带了。

3、进行开发环境配置
    以上的工作完成之后，就可以进行配置了。启动Windows的命令行（CMD）工具。进入Cocos2d-x 3.2的安装目录，执行： 

        python setup.py
    Cocos2d-x 3.2版本使用这个setup.py来安装，十分方便。执行之后会让你配置上面准备工作中所安装的：ANT、NDK、SDK等目录，把安装到哪儿去了填写进入就行。

4、建立自己的项目
    用setup.py配置好Cocos2d-x的环境之后，你的命令行中就会多如“cocos”的命令，新建项目将使用这个命令进行。

    示例：
        cocos new hello（项目名称）-p com.hello（包名字）-l cpp（项目类型） -d E:\MyCocos\cocos2d（目录）
    新建的项目会把所有的源文件和库都拷到你的项目目录中。所以新建的项目文件会很大，有许多人怀疑这个的必要性，不过到你之后的开发中就会知道这种配置方法是对的了。

    项目建立好之后，就可以开发了：

    A、进行VS2012的开发。
    找到你的项目目录下的：proj.win32，打开里面的解决方案就行。剩下的就是你的任务了。一般来说，直接就可以运行。
    B、进行Android的开发。
    使用Eclipse中的项目导入，导入proj.android中的项目方案。导入之后，因为SDK的问题，一般无法启动，关于这个问题，以及其它的问题，请参见（四、其它问题解决方案）


三、MAC环境下配置过程

1、注册苹果开发者账号。
    地址：http://developer.apple.com/iphone/index.action
    如果不使用真机，使用模拟器调试，那么有开发者账号应该就足够了。
    如果要使用真机调试，需要购买IOS开发者会员，688RMB一年。我看到之前的攻略说要99美元，但是看现在的页面的的提示，应该只要有网银就可以支付了。网上的攻略写得非常复杂，说要下载证书什么什么的，现在统统都不需要了，XCode全部为您代劳了，只要照提示一路点同意就行。

1、安装XCode
    在你的开发者首页下面就有XCode的下载。通过App Store下载安装即可。
    请使用最新的XCode（需要OS X 10.8以上系统支持），并使用App Store安装。我的MacBook Air从朋友那里拿来时还是10.7，因为下载总是中断，屡次不成功，所以用XCode 4.6，但好像不通过App Store安装会出这样那样的问题。所以强烈推荐使用最新的版本。

3、进行开发者环境配置。
    与PC的配置一样，打开MAC的终端程序，执行setup.py，配置好各种SDK的路径就行。但MAC需要再加上一句：
        source /Users/yourname/.bash_profile
    这是用来刷新配置文件的。

4、建立项目文件
    也与PC的项目一样。使用命令行建立。
    如果你像我一样用两个平台（PC与MAC）开发，可以共享同一个项目目录。我的项目文件是放在PC上的，MAC通过共享访问项目文件。
    项目建立好之后就可以开发了。MAC下的配置相对简单，使用XCode打开项目目录下的proj.ios_mac下的项目配置文件就行。之后基本不会出错的。



四、其它问题解决方案

Eclipse与Android相关：

问题：SDK错误
    因为Cocos2d-x的模版默认是使用Android 2.3.3（API-10)，如果新安装的ADT Bundle或Android SDK，是API-19，则会出现错误，解决方案是通过Android SDK中的管理工具（SDK Manager）下载Android 2.3.3的SDK。

问题：Project 'XXX' is missing required source folder: 'gen'
    这个问题就是上面的SDK错误导致的。

问题：undefined reference to 'cocos2d::network::HttpClient::getInstance()'
    我是使用网络库(network)的时候出现这个错误的。如果你使用其它库，解决方案是一样的。原因是缺少库的引用。解决方案是在Android.mk里面增加：
        LOCAL_WHOLE_STATIC_LIBRARIES += cocos_network_static
    Cocos2d-x的开发者已经在Android.mk里面加上了很多这种路径，平时是注释掉的。您要使用时把这些增加上去就行。

问题：fatal error: cocos-ext.h: No such file or directory
    问题分析：缺少头文件路径的引用
    需要在：Android.mk里面增加
        LOCAL_C_INCLUDES += $(LOCAL_PATH)/../../cocos2d/extensions
    Cocos2d-x的开发者已经在Android.mk里面加上了很多这种路径，平时是注释掉的。您要使用时把这些增加上去就行。

问题：The import org.cocos2dx.lib cannot be resolved。
    无法找到指定的库文件。解决的方案是增加路径的引用：Project Properties -> Java Build Path -> Source and then linking “项目目录/cocos/platform/android/java/src”


VS2012相关：

问题：“extensions/ExtensionMacros.h”: No such file or directory
无法打开包括文件。
    1、解决方案中，添加“现有项目”--> libExtensions  具体目录：

        ..\cocos2d\extensions\proj.win32\libExtensions.vcxproj
    2、项目中添加引用-->libExtensions
    3、通过：属性->C/C++->附加包含目录。附加包含目录：$(EngineRoot)
    如果你使用其它的文件，解决方案是一样的。1、增加项目的引用。2、附加头文件的包含目录。

问题：MSB8004 warning

    来源：http://www.cnblogs.com/zhfuliang/p/3248828.html

    1>C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\Microsoft.CppBuild.targets(298,5): warning MSB8004: Intermediate Directory does not end with a trailing slash. This build instance will add the slash as it is required to allow proper evaluation of the Intermediate Directory.

    1>C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\Microsoft.CppBuild.targets(299,5): warning MSB8004: Output Directory does not end with a trailing slash. This build instance will add the slash as it is required to allow proper evaluation of the Output Directory.

    解决方法：

        在输出目录后面增加反斜杠，修改为如下：

        项目属性->常规->输出目录: Debug\

        项目属性->常规->中间目录：Debug\

XCode相关：

问题：Contacting Your Reference
    因为我最初注册的Apple ID和开发者账号的名字不一样，所以支付了开发者会员之后，无法验证通过。出现这个提示。解决的办法是联系苹果开发者客服：400 670 1855。客服会帮你确认身份，解决这个问题。


其它攻略文章：
    如果有不清楚的地方，可以参考以下攻略文章，基本上我也是靠这些文章来解决问题的：
    如何联机调试和发布iOS程序
    Eclipse 运行 cocos2d-x-3 项目终极方案
    Cocos2d-x 3.0正式版及android环境搭建详细教程
    Cocos2d-x 3.0rc，又一种创建项目方式
    引用extension时（包括发布到Android平台）遇到的问题
    android中The connection to adb is down，问题和解决