创建一个Cocos2d-x 空项目

一、实验背景

cocos2d-x已经发展的相对完善了，从项目的创建、编译、运行到最后的打包都有相应的便捷工具，开发者只需要关注自己的游戏逻辑代码即可，这一点很赞，可是傻瓜式的编程，让我至今还只停留在使用vs建个空项目做个小demo的阶段，我根本不知道cocos2d-x项目究竟是如何组织的，那些项目与项目之间的关系，那些库文件的引用，那些属性的配置，那些路径设置，那些宏定义究竟是在哪里，为什么会出现两个窗口，一大片属性究竟是什么意思，，所以很有必要研究一下。现在把实验过程同大家交流一下，有什么说的片面或不对的地方，欢迎大家提出，一同进步。

二、实验目标

1.使用vs从一个空项目配置成为一个可以运行cocos2d-x官方lua demo的项目。

2.学习vs项目属性配置相关知识。

三、实验条件

Virtual studio 2013 update3 、cocos2d-x-3.2 Jul.17 2014(将其解压在桌面上，安装配置好cocos2d-X)

四、实验步骤与注意事项

1.使用vs在桌面上创建一个win32控制台应用程序的空项目，我这就叫test，按照下图二的目录结构进行创建，其中文件（ 包括资源文件）都是从引擎根目录下找到并复制到项目中的，这里的cpps就是所谓的“自己编写的cpp代码”。

(1)默认vs的空项目的解决方案和项目名称相同，一个解决方案可以包含多个项目，一个解决方案对应一个程序，test项目默认为核心，其他项目为其服务，生成lib和dll。头文件、源文件、资源文件三个是文件筛选器，相当于逻辑目录，只是便于管理文件，与文件的物理路径无关，我习惯将其对应起来。外部依赖项不由自己控制，包含外部库的头文件。上图三四是我配置完成后的项目，包含cpps(自定义cpp逻辑代码)，luas(自定义的lua逻辑代码)，res(程序的资源文件)。

(2).sdf是一个数据库文件，编译时自动生成，存放工程信息，与代码提示相关。.sln文件是解决方案文件，保存的是解决方案信息，是一个解决方案中不同项目之间的关系文件。

2.项目-》属性管理器，右键Debug|win32，添加现有属性表，从cocos2d-x引擎根目录(以下称$(ENGIneRoot))下找到 $(ENGIneRoot)\cocos\2d\

cocos2d_headers.props和cocos2dx.props两个文件添加。

3.回到解决方案管理器，右键test->属性，c/c++->常规->附加包含目录，添加上如下目录

$(ENGIneRoot)cocos\scripTing\lua-bindings\auto
$(ENGIneRoot)cocos\scripTing\lua-bindings\manual
$(ENGIneRoot)cocos\audio\include
$(ENGIneRoot)external\lua\lua
$(ENGIneRoot)external\lua\tolua
$(ENGIneRoot)external\chipmunk\include\chipmunk

(1)附加包含目录：其实就是“自己编写的cpp代码”需要查找头文件和原文件的位置。

(2)$(ENGIneRoot)是在cocos2d_headers.props和cocos2dx.props中定义的

4.预处理器，这一步是定义cocos2dx中类似平台_WINDOWS这样的代码（我说我为什么有的时候不明白这个究竟是从哪定义到的，这里恍然大悟）

懒死，复制吧，嘿嘿

WIN32
_WINDOWS
StriCT
_CRT_SECURE_NO_WARNINGS
_SCL_SECURE_NO_WARNINGS_DEBUG
COCOS2D_DEBUG=1

5.附件库目录

$(ENGIneRoot)external\lua\luajit\include\;$(ENGIneRoot)external\lua\luasocket\;$(ENGIneRoot)external\lua\tolua\;$(ENGIneRoot)external\xxtea\;$(ENGIneRoot)cocos\scripTing\lua-bindings\;$(ENGIneRoot)external\ConvertUTF\;$(ENGIneRoot)external\edtaa3func\;$(ENGIneRoot)external\Tinyxml2\;$(ENGIneRoot)external\unzip\;$(ENGIneRoot)external\xxhash\;$(ENGIneRoot)3d\;$(ENGIneRoot)base\;$(ENGIneRoot);$(ENGIneRoot)deprecated\;$(ENGIneRoot)math\;$(ENGIneRoot)physics\;$(ENGIneRoot)platform\;$(ENGIneRoot)renderer\;$(ENGIneRoot)2d\;$(ENGIneRoot)cocos\audio\include\;$(ENGIneRoot)cocos\audio\win32\;$(ENGIneRoot)cocos\editor-support\cocosbuilder\;$(ENGIneRoot)external\json\;$(ENGIneRoot)external\json\internal\;$(ENGIneRoot)cocos\editor-support\cocostudioActionTimeline\;$(ENGIneRoot)cocos\editor-support\;$(ENGIneRoot)cocos\editor-support\spine\;$(ENGIneRoot)cocos;etwork\;$(ENGIneRoot)cocos\storage\local-storage\;$(ENGIneRoot)cocos\ui\;$(OutDir);%(AdditionalLibraryDirectories)

(1)这个是我从$(ENGIneRoot)中复制的。

(2)附加库目录->添加第三方库需要查找的目录，这一步之后， 外部依赖项就自动添加了，打开来看会发现里边有好多.h,以后使用#include "*****.h"就无忧了。

6.附加依赖项

(1)附加依赖项，就是所谓的库文件了lib，静态库文件，其实有了他们，就相当于是有了第五步中的.h们对应的.cpp们（我是这么理解的），到时候“写入”(我这不懂，姑且这么叫吧)到exe中。

(2).dll是动态链接库，是在运行时才能加载的，不会被写入最终文件.exe中。所以经常见到绿色软件.exe外部有他们。

7.两个小窗口（这里还在研究中，不知道这里对应那块代码，这样设置就对了）

8.预生成事件

(1)生成事件分为三种，预先生成事件=》编译之前执行的事件；预连接事件=》链接之前的事件；后期生成事件=》编译之后的事件

(2)这里用到的是命令行代码，我主要是复制了一些文件

//预先生成事件
if not exist $(PorjectDir) mkdir $(ProjectDir)
xcopy "$(ENGIneRoot)cocos\scripTing\lua-bindings\script\*.lua" "$(ProjectDir)" /e /y

//预连接事件
if not exist $(OutDir) mkdir $(OutDir) xcopy "$(ENGIneRoot)build\$(Configuration).win32\*.lib" "$(OutDir)" /e /y xcopy "$(ENGIneRoot)build\$(Configuration).win32\*.dll" "$(OutDir)" /e /y //后期生成事件 if not exist $(OutDir) mkdir $(OutDir)
if not exist $(OutDir)res\ mkdir $(OutDir)res\
if not exist $(OutDir)luas\ mkdir $(OutDir)luas\
xcopy "$(ProjectDir)*.lua" "$(OutDir)" /e /y xcopy "$(ProjectDir)*.dll" "$(OutDir)" /e /y xcopy "$(ProjectDir)res\*" "$(OutDir)\res" /e /y xcopy "$(ProjectDir)luas\*" "$(OutDir)\luas\" /e /y

从根目录复制已经编译好的动态和静态库到这个空项目工程中

(3)$(OutDir) ===》C:\Users\username\Desktop\test1\Debug,最后的生成目录，完成后可以单独拷贝出来运行。

(4)$(Configuration)，因debug版本和Release版本而异

(5)$(PorjectDir),Debug工程目录，调试目录，工作目录

9.可以先编译一次，然后将

在生成中使用设置为否，以免每次都复制这么多文件(如果没有什么变化的话，这一步可以手动进行复制)。

10.看看效果吧

11.完成了。