cocos2dx v3.4 mac安装教程

本文是Cocos2d-x 3.x全平台（Android、iOS）新手开发配置教程攻略，旨在为新手提供帮助。由于面向新手，部分内容可能会较为详细，若有错误欢迎指正，在配置开发平台时遇到问题也欢迎大家一起讨论。

一、通用准备工作

1. 安装Cocos2d-x 3.1

从Cocos2d官网下载Cocos2d-x 3.1引擎，下载完成后进行解压缩。

2. 安装Eclipse与Android SDK

此步骤在Mac或PC上开发均可通用。

• Eclipse：可从其官网（官网地址）下载。
• Android SDK：在Android开发者中心（地址）下载。

Eclipse是开发Android所需的IDE，它功能强大且有众多插件。对于新手，推荐使用ADT Bundle，它是Eclipse与Android SDK的组合，所有项目都已配置好，避免了手动配置插件的繁琐。

3. 安装JDK

Eclipse运行需要Java环境，若未事先安装Java环境则会报错。解决方案是安装JDK（下载地址），一般安装后会自动配置好环境变量，若问题仍未解决，可在网络上查找JDK安装攻略。

4. 安装CDT插件（下载地址）

CDT插件用于支持Eclipse中C/C++语言的开发。从Eclipse官网下载后，将features和plugins这两个文件夹里的内容复制到Eclipse安装目录下对应的文件夹即可。

5. 安装NDK（下载地址）

NDK是进行C/C++与Java混合编译的必要工具，下载解压后，需记下解压目录，后续安装会用到。

6. 安装ANT（下载地址）

Cocos的Android开发需要用到ANT，下载并安装即可。

二、PC环境下配置过程

1. 安装VS2012（官方地址）

建议安装VS2012版本，尝试过VS2010和VS2013可能会出现各种问题。网上有很多VS2012的下载地址。

2. 安装Python 2.7.6（下载地址）

Cocos2d-x的安装程序使用Python编写，因此需要安装Python 2.7.6，注意不要下载Python 3.0以上的版本，否则运行会出错。若使用Mac，系统会自带Python。

3. 进行开发环境配置

完成上述准备工作后，启动Windows的命令行（CMD）工具，进入Cocos2d-x 3.1的安装目录，执行以下命令：

python setup.py

Cocos2d-x 3.1版本使用setup.py进行安装，执行后会提示配置ANT、NDK、SDK等目录，将其安装路径填写即可。

4. 建立自己的项目

使用setup.py配置好Cocos2d-x环境后，命令行中会出现“cocos”命令，可使用该命令新建项目，示例如下：

cocos new hello -p com.hello -l cpp -d E:\\MyCocos\\cocos2d

其中，“hello”为项目名称，“com.hello”为包名，“cpp”为项目类型，“E:\MyCocos\cocos2d”为项目目录。新建项目会将所有源文件和库复制到项目目录中，文件较大，但在后续开发中这种配置方式是合理的。

项目建立好后即可进行开发：

• 进行VS2012的开发：找到项目目录下的proj.win32文件夹，打开其中的解决方案，一般可直接运行。
• 进行Android的开发：使用Eclipse中的项目导入功能，导入proj.android中的项目方案。导入后可能因SDK问题无法启动，相关问题及解决方案可参见“四、其它问题解决方案”。

三、MAC环境下配置过程

1. 注册苹果开发者账号（注册地址）

若使用模拟器调试，有开发者账号即可；若要使用真机调试，需购买IOS开发者会员，费用为688元/年。现在注册流程简化，XCode会自动处理证书等问题，只需按提示操作即可。

2. 安装XCode

在开发者首页可下载XCode，建议通过App Store下载安装最新版本（需要OS X 10.8以上系统支持）。若使用旧版本可能会出现问题。

3. 进行开发者环境配置

与PC配置类似，打开MAC的终端程序，执行setup.py配置各种SDK的路径。此外，还需执行以下命令刷新配置文件：

source /Users/yourname/.bash_profile

4. 建立项目文件

使用命令行建立项目。若同时使用PC和MAC两个平台开发，可共享项目目录，如将项目文件放在PC上，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
  

  同样，相关路径已在Android.mk中添加，使用时取消注释即可。

• The import org.cocos2dx.lib cannot be resolved：无法找到指定的库文件，解决方法是增加路径引用：Project Properties -> Java Build Path -> Source，然后链接“项目目录/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)。

若使用其他文件，解决方法类似，即增加项目引用和附加头文件的包含目录。

XCode相关

• Contacting Your Reference：若最初注册的Apple ID和开发者账号名字不同，支付开发者会员后可能无法验证通过。解决办法是联系苹果开发者客服：400 670 1855，客服会协助确认身份并解决问题。