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

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

另外其他版本的Cocos2d-x 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_ROOTANDROID_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改成:macandroidlinuxios

  5. 最终效果如下:
    在这里插入图片描述

5. 使用VS调试HelloWorld工程

  1. 请确保您已阅读并执行本文的《4. 编译并运行HelloWorld工程
  2. 进入项目根目录下的win32-build目录中,双击并运行HelloWorld.sln
    在这里插入图片描述
  3. 鼠标右键单击HelloWorld项,然后鼠标左键单击设为启动项目,最后点击本地Windows调试器
    在这里插入图片描述
  4. 最终效果如下:
    在这里插入图片描述
©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页