Cocos2d-x学习笔记(一) —— 详细的环境搭建问题总结

这是我第一次写博客，也是我刚开始学习cocos2d-x，就是想把自己在学习中遇到的一些问题和困难跟大家交流沟通一下，以免新手在重复遇到同样让人纠结的问题，可以少走很多的弯路。以后我也会陆续的把自己学习到的东西跟大家一起分享和交流。希望大家多多支持。

1.1win32开发环境配置

1.1.1 Visual Studio 2008

安装VisualStudio2008，默认安装即可，如果是自定义安装，VisualC++组件应选中。

1.1.2 cocos2d-x

1. 下载cocos2d-x引擎最新版

官方下载地址为：http://code.google.com/p/cocos2d-x/downloads/list

(当前使用版本为cocos2d-2.0-rc2-x-2.0.1.zip)

2．将cocos2d-2.0-rc2-x-2.0.1.zip解压缩至硬盘任意目录下。

3. 如果想查看引擎源代码，可以在.\cocos2dx\proj.win32目录下找到代码配置文件。

1.1.3 （可选）Visual Assist X

用来提高VisualStudio2008的工作效率, 可以安装此工具。

安装支持VS2008版本的任意一版，无需配置。本软件是收费软件，需要注册。

技巧：如果不想让VAX对注释中的拼写进行校正（即去掉单词下面的波浪线提示），可以选择Visual Assist X Option， 进行如下配置：

1.1.4（可选）doxygen

安装工具 doxygen1.7.6.1 Win32版本(本例用, 本工具为开源软件)

下载地址为：http://www.onlinedown.net/soft/117010.htm

运行 doxygen, 选择 file->open

找到 "D:\Work7\cocos2d-1.0.1-x-0.10.0\doxygen\" 目录下的doxygen.cocos2d-x文件, 并打开

(此文件为cocos2d-x代码的 doxygen 配置文档)



然后选择 run 选项卡, 点击 rundoxygen 按钮开始生成.

生成完成后, 在 "D:\Work7\cocos2d-1.0.1-x-0.10.0\doxygen\" 目录下, 可以看到帮助文件夹

通过修改doxygen的一些设置, 可以很方便的生成各种标准的帮助文档.

1.2 测试helloworld

打开cocos2d-x引擎安装目录下的cocos2d-x.win32.vc2008.sln



右键点击“helloworld”设置为“设为启动项目”

-》生成

-》调试-启动新实例，如图所示

1.3 如何添加新项目

1.3.1 安装应用程序向导

点击运行install-templates-msvc.bat,cocos2d-x应用程序就会自动安装到vs环境下，当安装不成功，出现如下图所示的情况时：　　


原因：
系统安装Dreamwear、UltraEdit、EditPlus后修改了.js文件的默认打开方式。当想直接执行js脚本时就会出现此错误。

解决办法：
开始-》运行中输入regedit打开注册表编辑器，定位[HKEY_CLASSES_ROOT\.js]这一项，双击默认值将其改为“JSFile”即可。如下图所示：

1.3.2 建立新项目

当安装成功时，右键单击解决方案-》添加-》新项目-》cocos2d-win32 applivation



注意：目录层级关系，缺省情况下，应该设置在cocos2d引擎安装目录下，否则在编译链接时会找不到头文件



这个选项是用来使用物理引擎的，可以看情况勾选。



然后按照之前的步骤编译运行即可，运行效果如上一部分的图

1.4 常见问题总汇

1. 错误:

"error PRJ0019: 某个工具从以下位置返回了错误代码"(及类似错误)

"引用了一个%$#$#@.."

处理:

include 设置有误.

dll没有放在正确位置

2. 错误:

"LNK1000: Internal error during IncrBuildImage"

"....上一个增量链接没有生成它；正在执行完全链接..."

处理:

这是微软的一个漏洞, 下载KB948127补丁, 安装即可.

如果不能正常安装, 也可以把VS9中的增量编译关掉:

项目名处点右键, 依次选择->属性->配置属性->链接器->常规->启用增量链接(否)

以后再遇上此类问题, 可以尝试再次编译或者清理后重新生成.

3. 错误:

"....error LNK2019: 无法解析的外部符号...."

处理:

lib没有添加依赖

工程 点右键->属性->配置属性->链接器->输入附加依赖项 填入以下lib文件

libcocos2d.lib libgles_cm.lib libBox2d.lib libchipmunk.lib libcurl_imp.lib libCocosDenshion.lib

libjpeg.lib libpng.lib liblua.lib libxml2.lib libEGL.lib libzlib.lib libzlib.lib libiconv.lib

pthreadVCE2.lib

(根据实际使用情况填写)

4.错误

提示找不到头文件

处理：右键单击解决方案-》属性，在调试源文件中添加我们需要的头文件。