Cocos2d-x 3.x 全平台(Android,iOS)新手开发配置教程攻略

本身写的博客：http://blog.sina.com.cn/s/blog_732d16630101g445.html

之前只作过网页游戏（《古今东西》，www.ooplay.net），游戏也曾经开发过Android的手机版本，但本身写的引擎，固然也不能跨平台。所谓“工欲善其事，必先利其器”，使用成熟的引擎固然要锐利得多，因此果断投入了Cocos2d-x的阵营。我捣鼓了几天，才把平台上的东西配置好，如今买的书和网上的攻略大都是介绍2.x的，对于布置3.0开发平台的内容几乎都是网上的，但都是这里一点，那里一点。

因此我把本身的捣鼓经历记录下来，但愿对你们有所帮助。由于这篇文章是面对新手的。因此有些地方会啰嗦一些。请勿见怪。由于本人也是新手，若是教程中有错误，欢迎指正。若是在配置开发平台时还遇到问题，请在评论中留言，我会尽力解答。

我使用的环境是本身的PC（Win7）+HTC G18。还有从朋友那里借来的MacBook Air+Mini iPad。

1、通用准备工做

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

二、安装Eclipse与AndroidSDK。
这个在Mac上或是PC上开发都是能够通用的。
Eclipse在官网：http://www.eclipse.org/
Android SDK在Android开发者中心：http://developer.android.com
Eclipse是开发Android须要用到的IDE。这是个很牛X的IDE，有许多插件让他变得三头六臂。要开发Android的程序，须要下载相关的插件，但若是每一个插件要本身配置，会是很蛋痛的事情。若是是新手，推荐使用：ADTBundle。这是Eclipse+Android SDK的合体，全部的项目都已经帮你配置好了。

三、安装JDK：
Eclipse须要Java环境才能运行。若是事先没有安装Java环境，则会报错。
解决方案安装jdk：http://www.oracle.com/technetwork/java/javase/downloads/index.html
通常来讲安装以后会自动配置好环境变量。若是尚未解决问题，请查找网络上关于JDK安装的攻略。不少的。

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

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

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



2、PC环境下配置过程

一、安装VS2012。
地址：网上不少，在官方下载也行。
最好是2012，我曾经试过2010，2013，都会出这样那样的问题。因此，2012！

二、安装python2.7.6
地址：https://www.python.org/download/releases/2.7.6/
由于Cocos2d-x的安装程序是用phthon写的，因此须要这个软件。不要下载python3.0以上的版本，不然运行会出错。若是是Mac，那么天生就自带了。

三、进行开发环境配置
以上的工做完成以后，就能够进行配置了。启动Windows的命令行（CMD）工具。进入Cocos2d-x3.1的安装目录，执行：
python setup.py
Cocos2d-x3.1版本使用这个setup.py来安装，十分方便。执行以后会让你配置上面准备工做中所安装的：ANT、NDK、SDK等目录，把安装到哪儿去了填写进入就行。

四、创建本身的项目
用setup.py配置好Cocos2d-x的环境以后，你的命令行中就会多如“cocos”的命令，新建项目将使用这个命令进行。示例：
cocos new hello（项目名称）-p com.hello（包名字）-l cpp（项目类型） -dE:\MyCocos\cocos2d（目录）
新建的项目会把全部的源文件和库都拷到你的项目目录中。因此新建的项目文件会很大，有许多人怀疑这个的必要性，不过到你以后的开发中就会知道这种配置方法是对的了。

项目创建好以后，就能够开发了：

A、进行VS2012的开发。
找到你的项目目录下的：proj.win32，打开里面的解决方案就行。剩下的就是你的任务了。通常来讲，直接就能够运行。

B、进行Android的开发。
使用Eclipse中的项目导入，导入proj.android中的项目方案。导入以后，由于SDK的问题，通常没法启动，关于这个问题，以及其它的问题，请参见（4、其它问题解决方案）


3、MAC环境下配置过程

一、注册苹果开发者帐号。
地址：http://developer.apple.com/iphone/index.action
若是不使用真机，使用模拟器调试，那么有开发者帐号应该就足够了。
若是要使用真机调试，须要购买IOS开发者会员，688RMB一年。我看到以前的攻略说要99美圆，可是看如今的页面的的提示，应该只要有网银就能够支付了。网上的攻略写得很是复杂，说要下载证书什么什么的，如今通通都不须要了，XCode所有为您代劳了，只要照提示一路点赞成就行。

一、安装XCode
在你的开发者首页下面就有XCode的下载。经过App Store下载安装便可。
请使用最新的XCode（须要OS X 10.8以上系统支持），并使用App Store安装。个人MacBookAir从朋友那里拿来时仍是10.7，由于下载老是中断，多次不成功，因此用XCode 4.6，但好像不经过AppStore安装会出这样那样的问题。因此强烈推荐使用最新的版本。

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

四、创建项目文件
也与PC的项目同样。使用命令行创建。
若是你像我同样用两个平台（PC与MAC）开发，能够共享同一个项目目录。个人项目文件是放在PC上的，MAC经过共享访问项目文件。

项目创建好以后就能够开发了。MAC下的配置相对简单，使用XCode打开项目目录下的proj.ios_mac下的项目配置文件就行。以后基本不会出错的。



4、其它问题解决方案

Eclipse与Android相关：

问题：SDK错误
由于Cocos2d-x的模版默认是使用Android 2.3.3（API-10)，若是新安装的ADT Bundle或AndroidSDK，是API-19，则会出现错误，解决方案是经过Android SDK中的管理工具（SDK Manager）下载Android2.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
没法打开包括文件。
一、解决方案中，添加“现有项目”--> libExtensions 具体目录： ..\cocos2d\extensions\proj.win32\libExtensions.vcxproj
二、项目中添加引用-->libExtensions
三、经过：属性->C/C++->附加包含目录。附加包含目录：$(EngineRoot)
若是你使用其它的文件，解决方案是同样的。一、增长项目的引用。二、附加头文件的包含目录。


XCode相关：

问题：Contacting Your Reference
由于我最初注册的AppleID和开发者帐号的名字不同，因此支付了开发者会员以后，没法验证经过。出现这个提示。解决的办法是联系苹果开发者客服：400 6701855。客服会帮你确认身份，解决这个问题。


其它攻略文章：
若是有不清楚的地方，能够参考如下攻略文章，基本上我也是靠这些文章来解决问题的：
如何联机调试和发布iOS程序
Eclipse 运行 cocos2d-x-3 项目终极方案
Cocos2d-x 3.0正式版及android环境搭建详细教程
Cocos2d-x 3.0rc，又一种建立项目方式
引用extension时（包括发布到Android平台）遇到的问题
[url=hthttp://logger.iteye.com/blog/911977]android中The connection to adb isdown，问题和解决[/url]