Win10环境下cocos2d-x 3.x 版本的搭建与使用

索引目录

前言

-x 是一款开源的跨平台游戏引擎，使用者可以使用C++、lua、Js语言进行游戏开发。-x多用于安卓以及iOS平台的2d手游开发，在3.0版本以后加入了对3d图形开发功能的支持。如今框架开发商已经将工作重心放在新的产品Cocos 的研发改进上，有兴趣各位可以了解一下。

与当今市场上流行的虚幻4引擎相比，-x的优点是轻量级，仅需下载相应的压缩包解压后稍加操作便可使用，其间当然还得配置相关的环境变量。另一个个人所在意的点是-x支持C++语言开发，这是另一款流行引擎Unity（支持C#）所不能的。

（当然，个人仅仅是出于熟悉C++语言的目的尝试了解-x，如果你是对编程并不了解的游戏开发学习者，还是推荐面面俱到的Unity引擎进行入门学习。）

这是一篇用于介绍环境下，-x 3.0以后版本的搭建与工程创建的文章，对-x具体使用以及原理将不做阐述。因为写这篇文章时已经离最初完成配置搭建时很久了，很多当时的过程截图也就无法给出，望见谅

安装流程

-x的下载安装并不复杂，只是需要下载相应的开发包。虽然如今cocos开发商的研发重心已经转移到自家新产品上，但在Cocos产品的官网上仍能找到的源码下载链接。

具体的下载安装流程将分为以下几个方面介绍：

下载前准备1 ，移动应用开发包——ANT、NDK与SDK；下载前准备2 ，安装以及多版本环境变量配置1；下载不同版本的，以及源码补全；环境变量配置；创建工程； 1.NDK、SDK与ANT

虽然也可以用于、Mac等桌面系统下的图形开发，但主要还是用于开发以及iOS端的手游。在安装过程中需要获取SDK、NDK以及ANT这几个安卓移动应用开发工具包的目录地址，当然也可以选择跳过相关步骤。

如果你对安卓开发已经有一定的经验，可以忽略此步，仅需注意是否安装了适配C/C++的NDK，并记住个人安装的工具包的所在目录地址。

SDK是用于安卓的软件开发工具包，使用了Java所以需要在使用前安装合适版本的JDK，如果你想专注于安卓平台的游戏开发，可以说JDK、SDK这两个工具包必不可少。

Ant,是一个将软件编译、测试、部署等步骤联系在一起加以自动化的一个工具，大多用于Java环境中的软件开发。

而NDK则提供安卓应用对C/C++语言的使用支持。

在网上对于这几个工具包的安装都有详细说明，这里不再赘述。值得注意的是，在命名环境变量名时，只有按以下方式命名时才会在安装时自动读取文件目录，否则需要自己手动输入目录地址：

SDK：

NDK：

ANT：

当然也应该可以通过修改下载文件根目录下的setup.py文件让cocos自动读取你定义的环境变量：

#3.1版本 根目录下setup.py文件中对环境变量名的默认定义，不同版本中或许会有差异，但整体类似
COCOS_CONSOLE_ROOT = 'COCOS_CONSOLE_ROOT'
NDK_ROOT = 'NDK_ROOT'
ANDROID_SDK_ROOT = 'ANDROID_SDK_ROOT'
ANT_ROOT = 'ANT_ROOT'

2.相关

最初的是基于写成的，在后续的安装中也使用到了文件进行环境变量的配置等工作，所以在安装前我们还需下载安装，并配置环境变量。头疼的是目前的的所有版本仅仅支持 2.x版本，而目前 2.x已经停止更新，也难免各位不会使用到.x的版本，所以我们还需同时配置 2.x和3.x两个版本的环境变量，并加以区别以确保能同时起效。

在下面的博文下记录了如果配置多版本的环境变量

和共存以及pip共存.

在后续使用时需要注意，确保调用的是2.X版本的

3.下载

进入cocos的官网，选择需要版本下载，目前可以直接在cocos官网上下载到的好像只有3.13以后的版本，但高版本-x在低版本的VS上编译运行时可能碰到未知错误（3.0版本以后只在上做了完整的功能验证），需要在上下载-x的旧版本。

环境变量配置

-x源码解压后根目录下的setup.py文件会自动配置运行所需的环境变量，你仅需要打开命令行，进入文件目录，运行setup.py即可。过程中会自动检测本地的环境变量，找到SDK、ANT、NDK的目录，没有自动检测到的话你可以根据提示手动输入目录地址，当然你也可以先行跳过此步骤。

运行完成后，在个人的环境变量配置中会出现自动添加的cocos环境变量

完成环境变量配置后，进入源文件根目录下的build文件夹，打开工程，会出现用于测试的cocos项目，调试运行（第一次时间可能很长）就会出现如下画面：

可以诶个点击里面的项目查看的相关功能是否能正常运行，也可以阅读背后的源码，学习大部分控件的使用。这里的启动项目仅仅是用于测试以及供使用者学习cocos特性，不推荐直接修改这里面的文件，后续新建工程会用到这里的源码、模板。

新建工程

在3.0之前的旧版本新建工程时会有用户界面进行提示，相应的教程里或许会有说明。在3.0版本以后只能使用cocos指令进行新建工程的步骤，在官方的说明文档里有指令的相关说明。cocos指令使用示例如下：

cocos new 工程名 -p com.(自命名).(自命名) -l (使用的开发语言cpp/js/lua) -d 存放工程的目录

可能存在cocos指令报错的问题，因为你可能将.7版本的解释器命名为了.exe，导致执行脚本时使用了错误版本的解释器或者没有找到解释器。你需要找到源码根目录下\tools\-\bin文件夹下面的cocos.bat，当你使用cocos指令时实际上执行的是这段批处理脚本，里面是使用指令调用相应的文件。将里面的指令换成你机子中.x版本对应的指令名称，就可以正常运行cocos指令。

如此会自动复制源码至工程指定目录并替换相应的文件名，打开工程目录，找到win32，打开里面的解决方案。

会在你自定义工程名的项目下找到如下的几个文件，其中文件是启动场景的定义，文件中则有一些控制参数（如窗口大小、帧率显示等）

调试运行（第一次时间可能很长）就会出现如下的画面：

以上，-x搭建完毕

后话

上述内容省略了调试过程中可能碰到的错误，主要是个人针对不同版本的VS使用了不同版本的-x，在调试过程中基本没有碰到调试错误。如果你在调试时碰到的错误过多，考虑更换cocos版本或者更换VS版本或许是个不错的解决方案。（当然熟知语言特性，能挨个更改错误的话也是极好的）

第一次写这样一篇博文，并且距离当初实践操作时已经很久，必然有许多的错误、句意表达问题。如果有不对的地方，望见谅并请留言指正，万分感谢。

最后，希望这篇文章的内容能对你有所帮助。

py多版本环境变量 ↩︎