本文为cocos2d-x 3.x 全平台(Android,iOS)新手开发配置教程攻略，希望对大家有所帮助。由于这篇文章是面对新手的。所以有些地方会啰嗦一些，请勿见怪。假设教程中有错误，欢迎指正。假设在配置开发平台时还遇到问题，欢迎大家讨论。
本文所使用的环境是PC（Win7），HTC G18，MacBook Air 以及 Mini iPad。
一、通用准备工作
1、安装cocos2d-x 3.1
在Cocos2d官网上下载Cocos2d-x 3.1引擎。下载后解压缩。
2、安装Eclipse与Android SDK
这个在Mac上或是PC上开发都是能够通用的。
Eclipse 在其官网下载（官网地址）。
Android SDK 在Android开发人员中心下载（地址）。
Eclipse是开发Android须要用到的IDE。
这是个非常牛的IDE，有很多插件让他变得三头六臂。要开发Android的程序，须要下载相关的插件。但假设每一个插件要自己配置，会是非常蛋痛的事情。
假设是新手，推荐使用：ADT Bundle。
这是Eclipse+Android SDK的合体，全部的项目都已经帮你配置好了。
3、安装JDK
Eclipse须要Java环境才干执行。假设事先没有安装Java环境。则会报错。
解决方式安装jdk（下载地址）。
一般来说安装之后会自己主动配置好环境变量。假设还没有解决这个问题，请查找网络上关于安装JDK的攻略。非常多的。
4、安装CDT插件（下载地址）
这是个Eclipse的插件。用来支持Eclipse中C/C++语言的开发。
从Eclipse的官网下载。下载之后，将features和plusins这两个目录里面的内容拷贝到Ecplise安装目录下相应的目录之后就能够了。
5、安装NDK （下载地址）
这是进行C/C++与Java混合编译的必要工具。
记下下载之后解压到的文件夹，由于到之后的安装中会用到。
6、安装ANT（下载地址）
Cocos的Android开发须要用到它。所下面载下来安装好吧。
二、PC环境下配置过程
1、安装VS2012 （官方地址）
网上还有非常多其它下载地址。
最好是2012，我以前试过2010。2013。都会出这样那样的问题。所以。2012！
2、安装python 2.7.6（下载地址）
由于Cocos2d-x的安装程序是用phthon写的。所以须要这个软件。不要下载python3.0以上的版本号，否则执行会出错。假设是Mac，那么天生就自带了。
3、进行开发环境配置
以上的工作完毕之后，就能够进行配置了。启动Windows的命令行（CMD）工具。进入Cocos2d-x 3.1的安装文件夹，运行：
|
1
2
3
4
5
6
7
|
<ol
class="dp-c"> <li
class="alt"> <span><span>python setup.py </span></span>
</li></ol> |
Cocos2d-x 3.1版本号使用这个setup.py来安装。十分方便。运行之后会让你配置上面准备工作中所安装的：ANT、NDK、SDK等文件夹。把安装到哪儿去了填写进入即可。
4、建立自己的项目
用setup.py配置好Cocos2d-x的环境之后，你的命令行中就会多如“cocos”的命令。新建项目将使用这个命令进行。
演示样例：
|
1
2
3
4
5
6
7
|
<ol
class="dp-c"> <li
class="alt"> <span><span>cocos </span><span
class="keyword">new</span><span> hello（项目名称）-p com.hello（包名字）-l cpp（项目类型） -d E:MyCocoscocos2d（文件夹） </span></span>
</li></ol> |
新建的项目会把全部的源文件和库都拷到你的项目文件夹中。所以新建的项目文件会非常大，有很多人怀疑这个的必要性，只是到你之后的开发中就会知道这样的配置方法是对的了。
项目建立好之后。就能够开发了：
A、进行VS2012的开发。
找到你的项目文件夹下的：proj.win32，打开里面的解决方式即可。
剩下的就是你的任务了。一般来说。直接就能够执行。
B、进行Android的开发。
使用Eclipse中的项目导入，导入proj.android中的项目方案。导入之后，由于SDK的问题，一般无法启动，关于这个问题，以及其他的问题，请參见（四、其他问题解决方式）。
三、MAC环境下配置过程
1、注冊苹果开发人员账号（注冊地址）
假设不使用真机，使用模拟器调试。那么有开发人员账号应该就足够了。
假设要使用真机调试，须要购买IOS开发人员会员。688RMB一年。
我看到之前的攻略说要99美元，可是看如今的页面的的提示，应该仅仅要有网银就能够支付了。网上的攻略写得很复杂。说要下载证书什么什么的。如今统统都不须要了，XCode所有为您代劳了，仅仅要照提示一路点允许即可。
2、安装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须要再加上一句：
|
1
2
3
4
5
6
7
|
<ol
class="dp-c"> <li
class="alt"> <span><span>source /Users/yourname/.bash_profile </span></span>
</li></ol> |
这是用来刷新配置文件的。
4、建立项目文件
使用命令行建立。
假设你像我一样用两个平台（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 详细文件夹： ..cocos2dextensionsproj.win32libExtensions.vcxproj
2、项目中加入引用-->libExtensions
3、通过：属性->C/C++->附加包括文件夹。附加包括文件夹：$(EngineRoot)
假设你使用其他的文件。解决方式是一样的。1、添加项目的引用。2、附加头文件的包括文件夹。
XCode相关：
问题：Contacting Your Reference
由于我最初注冊的Apple ID和开发人员账号的名字不一样，所以支付了开发人员会员之后。无法验证通过。出现这个提示。
解决的办法是联系苹果开发人员客服：400 670 1855。客服会帮你确认身份，解决问题。