Cocos2d-x是跨平台的2D游戏开发框架。
注意:必须用VS才能编译。
1 环境
1.1 Python 2.7
注意:必须下载Python2.7,3.x不行。
Python2.7下载地址,需要勾选Add python.exe to Path, 否则需要在系统环境变量Path添加Python27和Python27\scripts路径。
在win+R -> cmd使用python --version命令检查。
1.2 MinGW-w64
这个之前已经装过了,这里不讲了。
1.3 CMake
CMake下载地址,选Windows x64 Installer。
在win+R -> cmd使用cmake --version检查。
1.4 Cocos2d-x
Cocos2d-x下载地址,下载源码,解压。
在解压后的文件夹项目根目录中,Shift+鼠标右键 -> 在此处打开终端。
python setup.py提示输入NDK/Android SDK路径,直接回车跳过;提示“Add to PATH”,输入y回车;重启终端。
在win+R -> cmd使用cocos --version命令检查。
后续在命令行使用cocos命令都从这里打开终端。
1.5 VS Code
在VS Code装插件,关闭VS Code。
(1)C/C++
(2)CMake Tools
(3)CodeLLDB
创建项目
cocos new 项目名 -l cpp -d 存放路径cocos new CardsGame-lcpp-dF:\workspace用VS Code打开该项目的文件夹,将CMake Tools添加到工具栏。
选择GCC编译器,Debug模式,如下图左下角状态栏。
在当前页面按快捷键Ctrl+Shift+p,输入C/C++: Edit Configurations (UI),在当前项目自动生成.vscode\c_cpp_properties.json文件。
1.6 VS2017
注意:只能下载2013、2015、2017
VS下载地址,只选“使用C++的桌面开发”并勾选左侧SDK即可。
2 编译
双击项目解决方案.\proj.win32\CardsGame.sln,用VS打开。一个解决方案包含四个项目,除了目标项目CardsGame,还包括lib开头的三个项目,这四个项目均需要右键 -> 属性,检查SDK版本。
如下图,Windows SDK版本如果是8开头,要改为安装VS时勾选的以8开头的SDK版本,我这里是8.1;如果是10开头,要改为安装VS时勾选的以10开头的SDK版本,我这里是10.0.19041.0,原来默认的是10.0.17134.0。
四个项目都设置好后,关闭VS。
具体而言,四个项目是父子关系,缺一不可
libSpine(骨骼动画库):做游戏任务动画、骨骼动画用的第三方库。
librecast(网络/通信库):游戏联网、消息发送、网络同步用的第三方库。
libcocos2d(核心引擎):整个Cocos2d-x引擎,画面、图片、声音等。
CardsGame:生成最终的.exe游戏文件。
在项目根目录文件夹打开终端,使用cocos命令编译。
cocos run-pwin323 开发
项目结构如下:
CardsGame/ ├── Classes/ ✅ 【这里放:所有 .h 和 .cpp】 │ ├── AppDelegate.h │ ├── AppDelegate.cpp │ ├── MainScene.h │ ├── MainScene.cpp │ ├── xxx.h │ └── xxx.cpp │ ├── Resources/ ✅ 【这里放:图片、音效、字体】 │ └── proj.win32/ ✅ VS 工程文件夹然后在VS里打开解决方案,在解决方案资源管理器中,右键src -> 添加 -> 现有项,将所有.cpp和.h都添加进来。
在VS菜单栏中找到全部保存,即可使用cocos命令编译。之后每次修改后都要检查VS是否同步。
4 调试
点左侧Run and Debug,创建launch.json文件。
在弹出的选择框选择Windows调试器。
把program改成自己项目里.exe程序的路径,例如:
"program": "F:/workspace/CardsGame/bin/debug/win32/CardsGame.exe",在需要调试的代码行打断点,然后F5即可运行。
5 导出
右键项目 -> 属性, 左侧C/C++ -> 代码生成,将运行库改成多线程(/MT)。
在VS顶部工具栏,切换模式为Release。
右键项目 -> 生成,会在项目目录的proj.win32下生成一个Release.win32文件夹,压缩该文件夹。
其他人拿到压缩包后,可能会提示缺少某些.dll文件,我在自己电脑的"C:\Windows\SysWOW64"下找到相应的文件复制进去的。(游戏是win32需要从SysWOW64找,游戏是64位需要从system32下找)
*参考来源
Win10+Python2.7.14+cocos2d-x-3.17.2+VS2017环境搭建
VsCode开发Cocos-lua,配置指南哦VsCode开发Cocos-lua,配置指南哦
完整教程:Cursor/VSCode/VS2017 搭建Cocos2d-x环境,并进行正常的调试和运行(简单明了)