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

faybull

已于 2023-04-11 14:40:29 修改

阅读量1.9k

点赞数 10

文章标签： cocos2d

于 2021-03-30 15:36:28 首次发布

本文链接：https://blog.csdn.net/faybull/article/details/113940969

版权

索引目录

前言

前言

Cocos2d-x 是一款开源的跨平台游戏引擎，使用者可以使用C++、lua、Js语言进行游戏开发。Cocos2d-x多用于安卓以及iOS平台的2d手游开发，在3.0版本以后加入了对3d图形开发功能的支持。如今框架开发商已经将工作重心放在新的产品Cocos Creator的研发改进上，有兴趣各位可以了解一下。
与当今市场上流行的虚幻4引擎相比，Cocos2d-x的优点是轻量级，仅需下载相应的压缩包解压后稍加操作便可使用，其间当然还得配置相关的环境变量。另一个个人所在意的点是Cocos2d-x支持C++语言开发，这是另一款流行引擎Unity（支持C#）所不能的。
（当然，个人仅仅是出于熟悉C++语言的目的尝试了解Cocos2d-x，如果你是对编程并不了解的游戏开发学习者，还是推荐面面俱到的Unity引擎进行入门学习。）
这是一篇用于介绍Windows10环境下，cocos2d-x 3.0以后版本的搭建与工程创建的文章，对cocos2d-x具体使用以及原理将不做阐述。因为写这篇文章时已经离最初完成配置搭建时很久了，很多当时的过程截图也就无法给出，望见谅

安装流程

cocos2d-x的下载安装并不复杂，只是需要下载相应的开发包。虽然如今cocos开发商的研发重心已经转移到自家新产品上，但在Cocos产品的官网上仍能找到cocos2d的源码下载链接。
具体的下载安装流程将分为以下几个方面介绍：

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

1.NDK、SDK与ANT

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

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

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

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

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

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

SDK：ANDROID_SDK_ROOT
NDK：NDK_ROOT
ANT：ANT_ROOT

当然也应该可以通过修改下载文件根目录下的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.python相关

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

在下面的博文下记录了如果配置多版本python的环境变量
python2和python3共存以及pip共存.

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

3.下载cocos2d

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

高版本cocos2d-x
可以选择直接下载3.17也就是最新版本的cocos2d，我使用的是VS2019社区版，在使用前可以在VS上选择下载适配cocos的C++配置，VS2019的扩展中有此项的支持。
低版本的cocos2d-x
可以在github上找到需要的cocos2dx旧版本，这里下载的源文件会缺少部分第三方文件，你可以挨个查找目录，找到第三方文件的下载链接，手动补全；也可以在直接下载cocos2d-x源码并解压后，运行根目录下的download-deps.py文件，这样会自动帮你补全运行时缺少的文件。

cocos2d环境变量配置

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

完成环境变量配置后，进入源文件根目录下的build文件夹，打开工程，会出现用于测试的cocos项目，调试运行（第一次时间可能很长）就会出现如下画面：
在这里插入图片描述
可以诶个点击里面的项目查看cocos2d的相关功能是否能正常运行，也可以阅读背后的源码，学习cocos2d大部分控件的使用。这里的启动项目仅仅是用于测试以及供使用者学习cocos特性，不推荐直接修改这里面的文件，后续新建工程会用到这里的源码、模板。

新建cocos2dx工程

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

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

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

如此会自动复制源码至工程指定目录并替换相应的文件名，打开工程目录，找到win32，打开里面的解决方案。
新工程根目录
会在你自定义工程名的项目下找到如下的几个文件，其中helloworldscene文件是启动场景的定义，appdelegate文件中则有一些控制参数（如窗口大小、帧率显示等）
在这里插入图片描述
调试运行（第一次时间可能很长）就会出现如下的画面：