Quick-Cocos2d-x初学者游戏教程（三） ---------------------------- 解析quick新建项目的代码文件

Quick-Cocos2d-x初学者游戏教程（三）

 

2、main.lua

在src目录下，除了 config.lua 文件外，还有一个 main.lua 文件，这个 main.lua 是 Quick 项目的通用入口文件，它类似于 Cocos2d-x 中的 AppDelegate.h/cpp 文件，同时也类似于一般 Windows 工程中的 main 文件。

打开 main.lua 文件，其内容如下所示：

1
2
3
4
5
6
7
8
9
10
function __G__TRACKBACK__(errorMessage)
    print("----------------------------------------")
    print("LUA ERROR: " .. tostring(errorMessage) .. "\n")
    print(debug.traceback("", 2))
    print("----------------------------------------")
end
 
package.path = package.path .. ";src/"
cc.FileUtils:getInstance():setPopupNotify(false)
require("app.MyApp").new():run()

每个新项目的 main.lua 文件内容都是一样的，一般情况下，我们不需要改动它。
我们只需要知道，main 文件的最后一行代码中通过载入的 app.MyApp 模块创建了一个 MyApp 实例，并且还调用执行了该 MyApp 实例的 run 方法。这行代码将启动并执行 MyApp 脚本。从此处我们也可以看出，main.lua 文件是应用程序 lua 脚本的启动文件。

require 方法表示引入一个文件，使用 require 方法加载文件的过程会检查文件的 lua 语法，同时会完成被加载文件内部变量的初始化。

3、MyApp.lua

main.lua 文件启动执行 MyApp 脚本后，接下来我们就来看看“src/app”目录下的 MyApp.lua 文件，该文件将启动游戏场景，其代码段如下所示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
-- 1
require("config")
require("cocos.init")
require("framework.init")
 
-- 2
local MyApp = class("MyApp", cc.mvc.AppBase)
 
-- 3
function MyApp:ctor()
    MyApp.super.ctor(self)
end
 
-- 4
function MyApp:run()
    cc.FileUtils:getInstance():addSearchPath("res/")
    cc.Director:getInstance():setContentScaleFactor( 640/CONFIG_SCREEN_HEIGHT )
    self:enterScene("MainScene")
end
 
return MyApp

我们依次来看以上各代码行的含义：

  1. 使用 require 方法载入配置、cocos 以及 Quick 框架。这些是每个 Quick 程序都必须要加载的。
  2. 使用 class 函数定义一个 MyApp 类。
    class 方法本身是 Quick 框架中定义的一个用于创建自定义 lua 类的函数，该函数可在 Quick 引擎的 “quick/framework/functions.lua” 文件中找到。当然，如果你听了我的话，在 Sublime 下安装了 QuickDev 插件，那么你也可以在 class 字符上单击右键，跳转到它的定义（Goto Definition），这样也能找到它。
    p1
    在 “functions.lua” 中，function class(classname, super)函数有两个参数，其中 classname 表示的是类名，super 表示的是父类或者创建对象实例的函数。当 super 传入的参数是前者时，将会以传入的对象为父类派生新类，如本处；当传入的参数为后者时，会以传入的函数作为构造函数创建新类，如稍后要讲解的 MainScene 类。
    从本段代码中我们可以看到，MyApp 这个类是从 cc.mvc.AppBase 中继承而来的，而 AppBase 是 Quick 中自带的一个 MVC（面向对象的一种设计模式）的应用程序基础类，这个类为我们的应用程序提供了一些逻辑控制上的功能，比如进入场景，切换场景等等。
  3. MyApp 的ctor()函数相当于 C++ 中的构造（constructor）函数，以及init()函数。所以我们一般会在ctor()函数中初始化我们的游戏数据和信息，每当调用 XXClass.new() 创建对象实例时，也会自动执行ctor()函数。
    另外，在子类的ctor函数中必须手动调用父类的构造函数，这样才等保证子类能“继承”父类的属性和方法，正如上段代码所示。其中 XXClass.super 可以访问指定 XXClass 类的父类。
  4. 在 MyApp 的 run 方法中，这里做了三件事：
    • 首先，通过 addSearchPath 方法设置资源搜索路径。这也是为什么资源一定要放在“res”目录下的原因。
    • 然后，通过 setContentScaleFactor 方法设置资源缩放因子，这行代码是我们在上章进行分辨率适配时自己添加的。
    • 最后，因为 MyApp 类继承于 AppBase 类，因此自然地，MyApp 也同父类一样，具备了些许逻辑控制的功能。所以在 run 方法的最后，程序调用 enterScene 函数进入到名为 “MainScene” 的游戏场景。
      当然我们也可以在 enterScene 函数中设置场景切换的动画，不过为了加深大家对场景切换的印象，我们还是留到后面使用的时候再做详细的讲解。

      注意：游戏场景默认必须放在 “src/app/scenes” 目录下，放到其他目录下是不能找到的。

4、MainScene.lua

讲的这里，大家应该很清楚 main 文件执行 require("app.MyApp").new():run() 代码的过程了吧。所以，接下来请大家打开“src/app/scenes”目录下的 MainScene.lua 文件，我们接着来看它的结构。其代码如下图所示：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
local MainScene = class("MainScene", function()
    return display.newScene("MainScene")
end)
 
function MainScene:ctor()
    cc.ui.UILabel.new({
            UILabelType = 2, text = "Hello, World", size = 64})
        :align(display.CENTER, display.cx, display.cy)
        :addTo(self)
end
 
function MainScene:onEnter()
end
 
function MainScene:onExit()
end
 
return MainScene

在 MainScene.lua 这个文件中，第一行代码使用 class 函数创建了一个 MainScene 场景类，同前边创建 MyApp 类不同的是，这里我们的类不是从基础类继承而来，而是通过一个函数创建出来的。

这是因为 Scene 场景对象必须是一个 C++ 的对象，而 C++ 的对象是无法直接派生出 Lua 的类的，所以我们只有用一个函数把它创建出来，然后再为它添加相应的方法。

在创建场景的函数段里，display.newScene() 方法将创建了一个新场景，并返回该 Scene 场景对象。

这里的 display 是一个重要的概念，在 Quick 中，display 模块封装了绝大部分与显示有关的功能，并负责根据 config.lua 中定义的分辨率设定计算屏幕的设计分辨率。display 模块提供了众多的方法和属性，比如创建层（display.newLayer），创建精灵（display.newSprite），以及恢复暂停切换场景 等等。

总而言之，display 是个很值得我们细细探索的模块。关于它更多详情内容可参见Quick-Cocos2d-x的API文档。

下面我们例举一些 display 常用的属性：

  • display.widthInPixels, display.heightInPixels： 屏幕分辨率的宽、高
  • display.width, display.height： 设计分辨率的宽、高
  • display.cx, display.cy： 设计分辨率中央的 x、y 坐标
  • display.left, display.top, display.right, display.bottom： 设计分辨率四边的坐标
  • display.c_left, display.c_top, display.c_right, display.c_bottom： 当父对象在屏幕中央时，屏幕四边的坐标
  • display.contentScaleFactor： 设计分辨率到屏幕分辨率的缩放因子，不同于内容缩放因子。

结合 display 模块提供的常量，我们可以很方便的获取屏幕的某些与现实相关的属性，如位置和颜色等等。display 模块中关于位置的常量是初始化的时候程序就已经计算好的（不信你可以查看控制台窗口中的打印信息），它们根据分辨率的不同而不同。
p2

MainScene 的 ctor 函数中默认添加了一个 UI 标签，这个标签的作用是在屏幕正中间添加一个“Hello World”的文本，并显示到屏幕上。

其中 cc.ui 模块中封装了大量符合脚本风格的 Cocos2d-x 控件，包含 UILabel、UIImage、UISlider 等等。所以正如上述代码一样，我们可以通过调用cc.ui.UILabel.new()来实例化一个新的 UILabel 控件。其先有参数分别表示：

  • UILabelType：创建文本对象所使用的方式。
    1 表示使用位图字体创建文本显示对象，返回对象是 LabelBMFont。
    2 表示使用 TTF 字体创建文字显示对象，返回对象是 Label。
  • text：要显示的文本。
  • size：文字尺寸。

创建好 UILabel 后，通过调用 align 方法设置文本的锚点和显示位置。最后用 addTo 方法把文本添加到场景中。

至于 MainScene 的 onEnter 和 onExit 两个方法，清楚 Cocos2d-x 原理的的童鞋应该很容易理解。其中onEnter 方法是在进入场景的时候调用的，我们可以在这里做一些初始化的工作；而 onExit 方法是在退出场景的时候调用的，在这里我们可以释放资源，重置变量。

小结

到现在为止，我们就已经解析完 src 目录下所有的 lua 文件了，总的来说，这两章所解析的 lua 文件的关系和用途如下图所示：
p3

好了，上图把这两章讲解的废话都概括完了，我想应该够清楚明了的吧！！ O(∩_∩)O~，从下章开始，我们将正式开始类el游戏的开发。

posted @ 2015-09-10 00:26  silent-bobo  阅读(1396)  评论(0)  编辑  收藏  举报