Windwos10+VS2017+Python 2.7.14+cocos2d-x 4.0开发环境搭建

一、关于Cocos2d-x

Cocos2d-x 是一套成熟的开源跨平台游戏开发框架。引擎提供了图形渲染、GUI、音频、网络、物理、用户输入等丰富的功能， 被广泛应用于游戏开发及交互式应用的构建。其核心采用 C++ 编写，支持使用 C++、Lua 或 JavaScript 进行开发。

很早之前写过一篇博客：Win7环境下VS2010配置Cocos2d-x-2.1.4最新版本的开发环境(亲测)，当时使用的Win7系统，Visual Studio开发版本是2010，Cocos2d-x对应的版本是2.1.4，到现在Cocos2d-x已经更新到4.0了，其Cocos2d-x官网的Cocos2d-x 4.0的下载地址为：http://cocos2d-x.org/filedown/cocos2d-x-v4.0

download Cocos2d-x

二、编译安装Coco2d-x 4.0的准备工作

关于Coco2d-x 4.0在各个平台下的搭建的Python、CMake的版本，可以参考官方的说明，如下图所示：

Coco2d-x 4.0的环境搭建

从上图可以看出，Windows系统下搭建Coco2d-x 4.0开发环境推荐的配置是：

• Windows 7+
• VS 2017+
• CMake 3.1+
• Python 2.7.5+, P建议 ython 2,7.10, 而不是 Python 3+__
  下面是官方的V4.0版本的升级指南说明：
  
  V4升级指南
  
  在Windows下可以使用cocos或者CMake运行项目，下面是官方的Cocos2d-x 4.0的CMake Guide
  
  CMake Guide 1
  
  在Linux、Windows等平台下使用CMake很简单，我们可以使用VS2017提供的CMake命令行工具编译生成对应的VS项目，命令如下图所示：

cd cocos2d-x
mkdir win32-build && cd win32-build
cmake .. -G"Visual Studio 15 2017" -Tv141

Execute cmake --build .to compile, or open Cocos2d-x.sln in Explorer to use the generated project.

CMake Guide

安装VS2017、cmake 3.11.1，Python 2.7.14

本次使用的系统为Windows10操作系统，使用VS2017，Cmake的版本为： 3.11.1，python版本为：2.7.14

Python和cmake的版本信息

1、下载安装Python2.7.14

首先去Python官网下载Python2.7版本，目前Coco2d-x 4.0不支持Python 3.x的版本，

Python 2.7.18

Python 2.7.18的下载地址为：https://www.python.org/downloads/release/python-2718/，2020年4月20号最新发布的2.7版本，目前Python 3的最新版本是3.8.5，注意由于Cocos2d-x目前只支持Python 2，不支持Python 3，所以我们直接下载Python 2.7.18

Python 2.7.18

由于我的系统处理器是AMD的，我直接下载上面的Windows x86-64 MSI installer，同时包含有X86和X64的32位和64位版本的Python，当然也可以直接下载Windows x86 MSI installer，我之前安装的是Python 2.7.14,，安装目录如下图所示：

Python 2.7.14

下载python-2.7.18.amd64.msi或者python-2.7.18.msi后安装到对应的目录下，然后将python.exe所在目录（也就是python安装路径）例如C:\Python27添加至Windows10系统的环境变量中去。

在这里插入图片描述

添加python环境变量

接着[WIN+R]打开cmd命令窗口，在其中输入python --version命令查看python的版本信息

查看python版本信息

如果成功打印出python的版本信息则证明python2.7.x安装成功并且配置好了python2.7.x的环境变量了。

2、下载并安装cmake

去CMake官网下载，安装的时候注意这一步，选择加到环境变量里：

cmake 3.17.0安装

然后再cmd窗口看一下版本，是否安装成功：

cmake 3.11.0

3、安装VS2017

Cocos2d-x 4.0需要Visual Studio 2015之后的版本，我目前使用的是VS2017开发工具，这个自己去微软官网下载。
vs2017官方下载地址为：https://docs.microsoft.com/en-us/visualstudio/releasenotes/vs2017-relnotes

VS2017

4. 下载Coco2d-x 4.0源代码

去Cocos2d-x官网下载稳定版的Coco2d-x 4.0源代码,其下载地址为：http://cocos2d-x.org/filedown/cocos2d-x-v4.0
下载好cocos2d-x-4.0.zip之后将其解压到系统盘下的某个目录下，比如：E:\SoftDevelop\CPlus\Cocos2d_x_Games
解压后的coco2d-x-4.0的源码目录结构如下图所示：

coco2d-x-4.0的目录结构

三、编译安装cocos2d-x 4.0

开始安装，进入cocos2d-x-4.0文件夹，运行setup.py。安装过程中会问你NDK和Android SDK的路径，如果没有，直接回车就行。
在Window10系统中进入coco2d-x 4.0所在目录E:\SoftDevelop\CPlus\Cocos2d_x_Games\cocos2d-x-4.0，按住Shift+鼠标右键，选择【在此处打开PowerShell窗口(S)】

PowerShell窗口

再执行如下命令运行根目录下的setup.py脚本

python setup.py

python setup.py

python setup.py 2

重新打开一个命令行CMD窗口，输入cocos --version查看cocos2d-x的版本信息，如下图所示：

查看coco2d-x的版本信息

这中间会问你是否同意发送数据，以便帮助Cocos成长，选是选否都可以。

接下来，创建一个自己项目HelloWorld。

四、创建HelloWorld项目

使用cocos new HelloWorld -l cpp -d 项目所在目录创建一个HelloWorld项目

cocos new HelloWorld -l cpp -d E:\SoftDevelop\CPlus\Cocos2d_x_Games

cocos new后面的HelloWorld是项目名，-l 指定语言（cpp，lua，js），-d是项目存放的路径。还可以用-p指定工程的包名。详细可以看cocos new --help。

cocos new --help

copy

执行完了后，可以看到HelloWorld文件夹内容是这样：

HelloWorld文件夹

之后就是启动这个HelloWorld看效果了。不过，当你进到proj.win32里面，是没有VS的工程文件的。这里跟很多博客和书介绍的用VisualStudio启动，是不一样的。cocos2d-x 4.0是需要你先手动编译一下的，按照官方的顺序来，进入到HelloWorld文件夹，建立一个build文件夹。下面是官方给的编译命令：

$ cd NEW_PROJECTS_DIR/HelloWorld
$ mkdir build
$ cd build
$ cocos run --proj-dir .. -p [mac|windows|android|linux|ios]

上面一步说白了就是进入到HelloWorld项目所在目录，然后在HelloWorld目录下创建一个build目录用于存放cmake编译的一些中间文件比如Makefile等文件，其中-p指定所使用的目标平台比如linux、windows、mac等，-m MODE参数可以指定运行的模式时debug还是release，默认时debug，--proj-dir PROJ_DIR指定目标平台路径。注意：使用cocos run --proj-dir .. -p win32或者cocos run --proj-dir .. -p win32 -m debug使用的是debug模式，若需要编译生成win32的release模式，则可将-m参数指定为release，使用cocos run --proj-dir .. -p win32 -m release命令。

CMakeLists.txt

可以通cocos run --help查看cocos run命令的一些参数，如下图所示：

cocos run --help

cocos run --proj-dir .. -p [mac|windows|android|linux|ios]

cocos run

接下来就是时间稍微有点长的cmake编译过程了，其中会调用C:\Program Files (x86)\Microsoft Visual Studio\2017\Professional\VC\Tools\MSVC\14.16.27023\bin\HostX86\x86\CL.exe的CL.exe命令工具：

cmake编译过程图1

cmake编译过程图2

运行结果

到这里我们的项目工程就做好了，工程生成在WorldWorld中win32-build中，如下图所示：

win32-build目录

另外，可以在HelloWorld\win32-build\bin\HelloWorld\Debug目录下找到编译生成的HelloWorld.exe可执行文件，里面还有一些相关的dll动态库文件。双击运行HelloWorld.exe即可运行项目。

在这里插入图片描述

双击执行HelloWorld.sln，在VS2017中启动工程。然后在HelloWorld上右键->设为启动项目，如下图。Ctrl+F5运行程序。

设为启动项目

运行结果

至此，Window10系统下使用VS2017搭建cocos2d-x 4.0开发环境搭建完成。

五、参考资料

• Cocos2d-x 4.0在各个平台的环境搭建方法
• Cocos2d-x 4.0升级指南
• CMake Guide for Cocos2d-x 4.0
• cocos2d-x 4.0 学习之路（二）环境搭建 Windows版
• cocos-2dx 4.0 win10 环境搭建血泪史
• Cocos2d-x-4.0在VS2019环境下的环境搭建（官方下载的cocos2dx压缩包）
• https://cocos2d-x.org
• https://cocos2d-x.org/download
• cocos2d-x 4.0 学习之路（三）运行cocos4.0自带的Demo程序
• Cocos 资料大全
• cocos2d-x 4.0 学习之路（五）第一个小游戏--忍者来袭