【cocos2d】从 cocos2d-x 到 quick

约定不等于承诺〃 2022-06-08 13:59 253阅读 0赞

### 安装 quick ###

quick 是对 cocos2d-x lua 版本的一次再次封装，cocos2d-x 中的东西到了 quick 上面基本都能用。这篇文章主要讲从 cocos2d-x 转到 quick 需要注意的一些东西。

首先，下载安装 quick

下载地址  
[https://github.com/u0u0/Quick-Cocos2dx-Community][https_github.com_u0u0_Quick-Cocos2dx-Community]

目前最新版本是 quick3.7，这个版本是一次大更新，把很多模块都移除掉了，进行了一次简化。主要的目录结构

windows 下双击 setup\_win.bat 就可以完成安装，主要是添加环境变量和创建 player.exe 桌面快捷方式。

### 创建项目 ###

打开 player.exe，点击新建项目，设置项目路径和包名即可

![创建项目][SouthEast]

项目的目录结构

|-project
        |-frameworks
        |-res
        |-src

可以看到目录结构非常简单，res 保存资源，src 保存代码。运行游戏需要 player.exe，打开 player，选中我们的项目，然后点击打开项目就可以运行了。这种方式不仅麻烦，而且不能调试。

### 调试项目 ###

我们可以使用 visual studio code，sublime text 等主流编辑器来写代码，然后打开 player.exe 运行我们的游戏。一种比较好的方式是使用 visual studio+babelua，既能够使用 IDE 直接运行，还可以断点调试，而且有代码提示功能。

下载安装完 babelua 插件后，点击 lua–>new lua project

然后设置源代码路径，lua 解释器路径，lua 工作目录和运行参数

*  lua scripts folder 是我们项目的源代码路径，一般是 %PROJECT%\\src
 *  lua exe path 设置成 player.exe 的路径，一般是 %QUICK\_ROOT%\\quick\\player\\win32\\player.exe
 *  working path 是 lua exe 的工作目录，设置完 lua exe path 后会自动填充 working path
 *  command line 设置运行参数，-workdir 设置项目的工作目录，-file 设置启动文件，一般是 main.lua

设置完成后保存解决方案，按 F5 就可以直接运行游戏，还可以断点调试。

### quick 项目框架 ###

接下来我们使用断点调试来看看我们的游戏从哪里开始执行，如何进到场景以及场景的结构和调用方式。

首先，游戏从 main.lua 开始执行

require("app.MyApp").new():run()

这里创建一个 Application 实例然后调用 run 函数开始执行

local AppBase = require("framework.AppBase")
    local MyApp = class("MyApp", AppBase)
    
    function MyApp:ctor()
        MyApp.super.ctor(self)
    end
    
    function MyApp:run()
        cc.FileUtils:getInstance():addSearchPath("res/")
        self:enterScene("MainScene")
    end
    
    return MyApp

MyApp 继承自 AppBase，AppBase 在 framework 中定义；这里使用到 class 关键字，这是原生 lua 没有的，class 函数在 framework/function.lua 中定义，这个文件提供了一组函数，用于扩展 lua 标准库。class 封装一个类的实现，其创建的类默认有一个 new 方法，在 new 方法中创建一个实例并给实例添加一个 ctor 方法，完成实例的初始化工作。new 方法相当于类的工厂方法，而 ctor 则是构造方法。所以 `require("app.MyApp").new():run()` 的执行过程如下  
\* 执行 MyApp 的 new 方法，创建一个实例 MyApp  
\* 执行 MyApp 的 ctor，再调用 AppBase 的 ctor 方法，完成 MyApp 的初始化工作  
\* 执行 MyApp 的 run 方法

在 MyApp 的 run 方法中调用 enterScene 方法，开始加载第一个场景。enterScene 方法在 AppBase 中定义

function AppBase:enterScene(sceneName, transitionType, time, more, ...)
        local scenePackageName = "app.scenes." .. sceneName
        local sceneClass = require(scenePackageName)
        local scene = sceneClass.new(...)
        display.replaceScene(scene, transitionType, time, more)
    end

先根据场景名 require 相应的 lua 文件，然后调用 new 方法创建一个场景实例，new 方法会调用场景类的构造方法 ctor，完成初始化工作。创建完场景后调用 display.replaceScene 来替换当前运行的场景。

一个场景的 ctor 方法在什么时候调用？使用 new 创建场景实例的时候。  
什么时候创建场景实例？使用 enterScene 切换场景的时候。  
从哪里调用 enterScene？在 MyApp(AppBase) 中。

所以在一个场景中切换场景的写法是

app:enterScene("GameScene");

app 是一个全局变量，它的值在 AppBase.ctor 中初始化。

分析完 AppBase 和 MyApp 类，我们再来分析下场景类的写法

local MainScene = class("MainScene", function()
        return display.newScene("MainScene")
    end )

同样使用 class 方法来定义一个类，要使这个类是一个场景类，则必须让它继承 cc.scene；这里使用 `display.newScene()` 创建一个类作为场景的父类

function display.newScene(name)
        local scene = cc.Scene:create()
        scene.name = name or "<unknown-scene>"
        scene:setNodeEventEnabled(true)
        return scene
    end

默认场景类会有 ctor，onEnter 和 onExit 三个函数

function MainScene:ctor() end function MainScene:onEnter() end function MainScene:onExit() end

ctor 讲过了，调用 new 方法创建一个场景实例时会调用。onEnter 和 onExit 是结点事件，在 framework/NodeEx.lua 中定义

function Node:setNodeEventEnabled(enabled)
        if enabled then
            local listener = function(event)
                local name = event.name
                if name == "enter" then
                    self:onEnter()
                elseif name == "exit" then
                    self:onExit()
                elseif name == "enterTransitionFinish" then
                    self:onEnterTransitionFinish()
                elseif name == "exitTransitionStart" then
                    self:onExitTransitionStart()
                elseif name == "cleanup" then
                    self:onCleanup()
                end
            end
            self:addNodeEventListener(c.NODE_EVENT, listener)
        else
            self:removeNodeEventListener(c.NODE_EVENT)
        end
        return self
    end

进入场景时会调用 onEnter 方法，离开场景时会调用 onExit 方法。

[https_github.com_u0u0_Quick-Cocos2dx-Community]: https://github.com/u0u0/Quick-Cocos2dx-Community
[SouthEast]: /images/20220608/33f2a40b27484332988a01da2f1fef7f.png