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
|
我们依次来看以上各代码行的含义：
- 使用 require 方法载入配置、cocos 以及 Quick 框架。这些是每个 Quick 程序都必须要加载的。
- 使用 class 函数定义一个 MyApp 类。
class 方法本身是 Quick 框架中定义的一个用于创建自定义 lua 类的函数，该函数可在 Quick 引擎的 “quick/framework/functions.lua” 文件中找到。当然，如果你听了我的话，在 Sublime 下安装了 QuickDev 插件，那么你也可以在 class 字符上单击右键，跳转到它的定义（Goto Definition），这样也能找到它。
在 “functions.lua” 中，function class(classname, super)函数有两个参数，其中classname表示的是类名，super表示的是父类或者创建对象实例的函数。当super传入的参数是前者时，将会以传入的对象为父类派生新类，如本处；当传入的参数为后者时，会以传入的函数作为构造函数创建新类，如稍后要讲解的 MainScene 类。
从本段代码中我们可以看到，MyApp 这个类是从 cc.mvc.AppBase 中继承而来的，而 AppBase 是 Quick 中自带的一个 MVC（面向对象的一种设计模式）的应用程序基础类，这个类为我们的应用程序提供了一些逻辑控制上的功能，比如进入场景，切换场景等等。 - MyApp 的ctor()函数相当于 C++ 中的构造（constructor）函数，以及init()函数。所以我们一般会在ctor()函数中初始化我们的游戏数据和信息，每当调用 XXClass.new() 创建对象实例时，也会自动执行ctor()函数。
另外，在子类的ctor函数中必须手动调用父类的构造函数，这样才等保证子类能“继承”父类的属性和方法，正如上段代码所示。其中 XXClass.super 可以访问指定 XXClass 类的父类。 - 在 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 模块中关于位置的常量是初始化的时候程序就已经计算好的（不信你可以查看控制台窗口中的打印信息），它们根据分辨率的不同而不同。 
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 文件的关系和用途如下图所示： 
好了，上图把这两章讲解的废话都概括完了，我想应该够清楚明了的吧！！ O(∩_∩)O~，从下章开始，我们将正式开始类el游戏的开发。