Cocos2d-x 4.0 HelloWorld工程的创建和调试（以Windows为例，其他系统也可参考）

按

本文仅介绍如何在Windows平台下进行开发，如需打包到安卓，请参考：Cocos2d-x多版本安卓打包配置

另外其他版本的Cocos2d-x HelloWorld可以参考：

• Cocos2d-x 3.17.2 HelloWorld

1. 准备工作

1. 安装并运行Windows
   本文以Win10为例

2. 下载并解压Cocos2d-x v4.0（下载页）
   解压时最好将其放在某个盘的根目录下，如果放在某个文件夹里，则所在的文件夹路径最好不要包含中文字符或空格
   

3. 安装Python2

4. 下载并安装Visual Studio2017（实测VS2019暂时不行）
   工作负载应至少选择使用C++的桌面开发
   

5. 下载并安装Cmake
   
   安装的时候注意这一步，选择加到环境变量里：
   
   最后可以在cmd中运行cmake -version看一下版本，以确定是否安装成功：
   

2. 安装Cocos2d-x 4.0

1. 进入Cocos2d-x-4.0的解压目录，然后在按着Shift键的同时用鼠标右键单击空白处，再点击在此处打开PowerShell窗口
   
2. 先输入Python并回车，看一下是不是已经装好了Python2.x
   
3. 输入

   python .\setup.py
   

   以进行安装Cocos2d-x-4.0，安装时会提示让输入NDK_ROOT和ANDROID_SDK_ROOT的路径，这是打包到安卓平台要用的，暂时我们可以先不设置。
   后续如需打包到安卓，请参考：Cocos2d-x多版本安卓打包配置，以Cocos 3.17.1为主讲（含所有与相应的引擎及配套的工具云盘下载链接，你想要的，一应俱全。）
   
4. 安装完成之后可以重启一下终端（CMD或PowerShell）或电脑（Windows）

   Please restart the terminal or restart computer to make added system variables take effect
   

3. 创建HelloWorld工程

1. 进入自己想要用于存放Cocos2d-x-4.0工程的目录，然后在按着Shift键的同时用鼠标右键单击空白处，再点击在此处打开PowerShell窗口
   

2. 先运行

   cocos -h
   

   （首次运行还需要再输入Y并回车）
   
   查看一下帮助：

   F:\GP\cocos2d-x-4.0\tools\cocos2d-console\bin\/cocos.py 2.3 - cocos console: cocos2d-x 的命令行工具集。
   
   可用的命令：
           run              在设备或者模拟器上编译，部署和运行工程。
           luacompile       对 lua 文件进行加密和编译为字节码的处理。
           deploy           编译并在设备或模拟器上部署工程。
           compile          编译并打包工程。
           gen-simulator    生成 Cocos 模拟器。
           new              创建一个新的工程。
           jscompile        对 js 文件进行加密和压缩处理。
   
   可用的参数：
           -h, --help                      显示帮助信息。
           -v, --version                   显示命令行工具的版本号。
           --ol ['en', 'zh', 'zh_tr']      指定输出信息的语言。
           --agreement ['y', 'n']          使用指定的值来同意或拒绝协议。
   
   示例：
           cocos new --help
           cocos run --help
   

3. 再运行：

   cocos -h
   

   
   查看一下如何创建工程的帮助：

   PS F:\CP> cocos new -h
   usage: cocos new [-h] [-p PACKAGE_NAME] [-d DIRECTORY] [-t TEMPLATE_NAME]
                    [--ios-bundleid IOS_BUNDLEID] [--mac-bundleid MAC_BUNDLEID]
                    [-e ENGINE_PATH] [--portrait] -l {cpp,lua,js}
                    [PROJECT_NAME]
   
   创建一个新的工程。
   
   positional arguments:
     PROJECT_NAME          设置工程名称。
   
   optional arguments:
     -h, --help            show this help message and exit
     -p PACKAGE_NAME, --package PACKAGE_NAME
                           设置工程的包名。
     -d DIRECTORY, --directory DIRECTORY
                           设置工程存放路径。
     -t TEMPLATE_NAME, --template TEMPLATE_NAME
                           设置使用的模板名称。
     --ios-bundleid IOS_BUNDLEID
                           设置工程的 iOS Bundle ID。
     --mac-bundleid MAC_BUNDLEID
                           设置工程的 Mac Bundle ID。
     -e ENGINE_PATH, --engine-path ENGINE_PATH
                           设置引擎路径。
     --portrait            设置工程为竖屏。
     -l {cpp,lua,js}, --language {cpp,lua,js}
                           设置工程使用的编程语言，可选值：[cpp | lua | js]
   

4. 下面我们创建一个HelloWorld工程

   cocos new HelloWorld -p top.coco56.HelloWorld -l cpp -d F:\CP
   

   • -p 用于指定包名，包名通常为域名的反相，如这里的top.coco56.HelloWorld
   • -l 用于指定开发语言，cpp代表C++
   • -d 用于指定工程存放的目录，如这里的F:\CP

   

   当然我们也可以不指定工程的存放路径，默认保存在当前终端（CMD或PowerShell）的工作目录

   cocos new HelloWorld2 -p top.coco56.HelloWorld2 -l cpp
   

   
   

4. 编译并运行HelloWorld工程

1. 在4.0中，当你进到proj.win32目录里面，是没有VS的工程文件的。这是和之前的老版本不一样的。4.0是需要你先手动编译一下的，然后VS的工程在win32-build目录中
   
   

2. 我们先来查看一下编译并运行的帮助：

   cocos run -h
   

   

   PS F:\CP> cocos run -h
   usage: cocos run [-h] [-s SRC_DIR] [-q] [-p PLATFORM] [--list-platforms]
                    [--proj-dir PROJ_DIR] [-m MODE] [-b BROWSER] [--param PARAM]
                    [--port [SERVER_PORT]] [--host [SERVER_HOST]] [--no-console]
                    [--working-dir WORKING_DIR] [-sdk [USE_SDK]]
   
   在设备或者模拟器上编译，部署和运行工程。
   
   optional arguments:
     -h, --help            show this help message and exit
     -s SRC_DIR, --src SRC_DIR
                           指定工程路径。
     -q, --quiet           较少的输出。
     -p PLATFORM, --platform PLATFORM
                           指定目标平台。
     --list-platforms      List available platforms
     --proj-dir PROJ_DIR   指定目标平台路径。
     -m MODE, --mode MODE  设置运行模式，可选值为 debug/release，默认值为 debug。
   
   web 工程可用参数:
     -b BROWSER, --browser BROWSER
                           设置指定浏览器打开 url。如果未指定使用系统默认浏览器。
     --param PARAM         在设置指定浏览器打开后，添加上特殊参数。
     --port [SERVER_PORT]  设置本地服务器的端口，默认值为 8000
     --host [SERVER_HOST]  设置本地服务器的主机地址，默认值为 127.0.0.1
     --no-console          关闭 Windows，Mac 和 Linux
                           下的模拟器控制台窗口（传入命令行参数 '-console no'
                           给模拟器）。
     --working-dir WORKING_DIR
                           指定 Windows，Mac 和 Linux
                           下模拟器运行的工作目录（传入命令行参数 '-workdir
                           "<path>"' 给模拟器）。
   
   ios 工程可用参数:
     -sdk [USE_SDK]        设置 iOS 使用的 SDK，如 iphoneos。默认是
                           iphonesimulator
   

3. 使用Windows资源管理器打开HelloWorld工程所在的文件夹，然后在按着Shift键的同时用鼠标右键单击空白处，再点击在此处打开PowerShell窗口
   

4. 运行

   cocos run -p win32
   

   其他平台可以将win32改成：mac、android、linux、ios

5. 最终效果如下：
   

5. 使用VS调试HelloWorld工程

1. 请确保您已阅读并执行本文的《4. 编译并运行HelloWorld工程》
2. 进入项目根目录下的win32-build目录中，双击并运行HelloWorld.sln
   
3. 鼠标右键单击HelloWorld项，然后鼠标左键单击设为启动项目，最后点击本地Windows调试器
   
4. 最终效果如下：