Quick-Cocos2d-x初學者遊戲教程（一）--------------------Quick的一些基礎知識

本文轉自Quick-Cocos2d-x初學者遊戲教程（一）

 

前言

雖然以前已經寫過了不少 Cocos2d-x 相關的教程和文檔，但本次倒是我第一次接觸 Quick，第一次接觸 Lua，因此這次的教程本人將站在一個初學者的角度（看到這裏是否是想白眼我了，哈哈，別切啊！儘管第一次，但我身邊但是有不少 Quick 大神的，廖大大也在旁邊辦公室，沒準撒個嬌大神就把他知道的所有要點傾囊相授了啦!），全方位的解析 Quick 的學習過程，並同你們一塊兒學習如何利用 Quick-Cocos2d-x 開發一款屬於本身的遊戲，包教包會的哦。

好了，那麼下面咱們就開始進入正題吧。

Quick-Coco2d-x是什麼？

首先，想了解 Quick-Coco2d-x 就必須先知道 Cocos2d-x 是什麼，不過我想關於 Cocos2d-x 的介紹這裏就不用我來廢話了吧，畢竟這麼牛的遊戲引擎仍是應該很點名氣的吧！

其次，因爲 Cocos2d-x 中使用的是 C++ 語言，而 C++ 又對開發人員要求較高，因此逐漸地，開發者們開始將 Cocos2d-x 的 C++ 接口轉成了 Lua 接口，從而衍生出了 Cocos2d-lua 的版本。而 Quick（Quick-Coco2d-x）是 Cocos2d-lua 的一個豪華加強和擴展版本，它重寫了支持代碼、解決了內存泄露和只能使用全局函數作回調等等問題。Quick 能讓開發者使用 Lua 這種簡單易懂的腳本語言來編寫遊戲，並大大提升了開發效率。如今廖大大的 Quick 團隊也已接手了 Cocos2d-lua 的開發和維護工做，因此將來 Quick 和 Cocos2d-lua 將有望徹底合併起來。

本次教程所用 Quick-Coco2d-x 版本爲 v3.3 Final，你們可在Cocos引擎中文官網中找到對應的下載地址並安裝該程序。

注意：不要把 Quick 安裝到根目錄，或者帶有空格或中文的路徑中。另外，Quick-Cocos2d-x 須要 Python 的支持，因此請自行檢測你的電腦是否裝有Python，方法是在終端中輸入 python 命令行，如未安裝請先下載安裝2.x版本的 Python。

Quick 安裝完成後，在它的根目錄下能夠找到有兩個名爲setup_mac.sh、setup_win.bat的批處理腳本，它們分別是搭建Mac和 Windows開發環境的腳本，根據本身系統的須要運行相應的腳步，就能夠自動爲你完成 Quick 環境的配置。在此以後，咱們就能夠雙擊安裝目錄下的 player3 圖標（Windows 下桌面上會生成 player 的快捷鍵），啓動 Quick 自帶的模擬器了。在該模擬器界面中，咱們能夠建立、打開、運行項目，同時還能查看不少 Quick 自帶的示例項目。

關於 Quick 更多的使用說明可參考安裝目錄下的 README 文件。

Quick-Coco2d-x開發工具

通常狀況下，咱們一般都會採用Cocos Code IDE做爲開發工具來快速開發遊戲，這裏Cocos Code IDE是一個基於 Eclipse 的跨平臺 IDE，專門爲 Cocos2d-x Lua & JavaScript 開發人員準備，經過 IDE 你能夠方便的建立遊戲工程、編寫而且支持在不一樣平臺上調試代碼、實時查看代碼被改變後的效果，最終直接發佈成一個可上架的安裝包。

然而，最近學習Quick的時候聽同事和不少用戶反饋說：Quick-Coco2d-x v3.3 Final這個版本在Cocos Code IDE上還存在一些Bug，而且執行效率也相對較慢。因此在大神的推薦下，本教程咱們就不選用Cocos Code IDE做爲開發工具了，而是使用另外一種高效的方法來完成該跑酷遊戲的開發——Sublime + QuickXDev。

固然若是你非要用Cocos Code IDE仍是能夠的，其安裝和使用說明可參考：Cocos Code IDE + Quick-Cocos2d-x 快速開發遊戲一文。

開發工具的安裝配置

Sublime Text 是一個具備漂亮的用戶界面和強大的功能的代碼編輯器，也是HTML和散文先進的文本編輯器，它的不少功能都依賴於其強大的插件系統。Sublime Text支持Lua語言，但它自己不具備像代碼提示這樣的功能，因此要想用Sublime Text快速的開發Quick-Coco2d-x程序，咱們就必須安裝強大的QuickXDev插件。

Sublime Text的下載地址爲：http://www.sublimetext.com/，下載後直接安裝便可。

QuickXDev的下載地址爲：http://git.oschina.net/lonewolf/QuickXDev，將它下載解壓以後重命名爲QuickXDev，而後把該QuickXDev文件夾放入到Sublime Text的Packages目錄下（可經過Sublime Text->Preferences->Browse Packages打開）。

接着依次打開Preferences->Package Settings->QuickXDev->Settings–Default，以下圖所示：

複製該處的內容到Preferences->Package Settings->QuickXDev->Settings–User（此時User是空白的）中，同時在 「quick_cocos2dx_root」 項的後面設置Quick-Coco2d-x的安裝路徑，以下圖所示：

設置完成後，User的內容將會覆蓋Default下的設置。
注意：以上路徑應爲你本身的安裝路徑，若是是Windows系統，則該處的路徑形如：

1	"quick_cocos2dx_root" : "D:\\Quick\\quick-3.3"

新建項目

開發工具準備就緒之後，下面咱們就能夠開始建立咱們的項目了.

首先啓動 Quick 下的 player3，在這兒的示例標籤下你能夠看到不少Quick自帶的示例，對於初學者來講，看看這些示例的使用方法會對咱們學習Quick有很大的幫助，它也是快速學習Quick極好的教材。其界面以下圖所示：

接着咱們來新建一個項目，點擊界面上的「新建項目」，player會自動切換到新建項目的界面。

設置好新建項目的存放路徑，包名，屏幕方向，以及是否複製C++源碼等選項後，咱們就能夠點擊右下角的 「Create Project」 按鈕建立項目了。這裏須要注意的是，若是你的項目不涉及到 C++ 部分，那麼能夠取消「Copy Source Files」項的勾選，這樣能夠加快項目的建立速度。

點擊 Create Project 按鈕後，你會發現右下角的 「Create Project」 按鈕變成了「Open..」，同時還會出現一個顯示建立項目結果的終端窗口。待終端窗口顯示建立完成時，咱們就能夠點擊「Open..」打開項目了。

一個默認建立好的項目其實就是個程序員最熟悉的「Hello World」程序，而後後面咱們就能夠以這個「Hello World」程序爲基礎來編寫本身的遊戲。

每一個新建的Quick程序都帶了一個控制檯窗口，以下圖所示。這個控制檯窗口是player的輸出窗口，它包括了你打印的日誌以及崩潰日誌，當你的程序報錯時，它的輸出日誌將是很好的檢驗憑證。

項目目錄分析

爲了更快更好的學習Quick程序開發，瞭解其項目結構是頗有必要的，因此下面咱們就來依次看看引擎和新建項目的目錄結構。

引擎目錄結構分析

打開 Quick 安裝目錄，其結構以下圖所示：

• build：該目錄是 Cocos2d-x 的項目存放目錄。
• cocos: 改文件夾中包含了大部分引擎的庫文件，其中包括：2d、3d、聲音、基礎庫、數學庫、物理庫等等一系列相關的類文件。
• docs：該文件夾下包含了引擎的API文檔、發佈文檔（最新版本更改介紹，運行環境要求，編譯環境要求及如何運行測試用例的相關命令）、 Cocos編程規範等等文檔。咱們能夠經過它查看引擎的代碼API，以及最新版本更改介紹，quick運行環境要求，編譯環境要求及如何運行測試用例的相 關命令。裏面的文件可能是html和md格式的。
• extensions: 其中主要是GUI擴展庫.
• external中包含物理引擎第三方庫，Box2D和chipmunk；數據庫第三方庫，sqlite3；網絡第三方庫，webp,websockets；以及一些其餘第三方庫，像編碼轉換庫、數據格式庫等等。
• licenses裏面包含了引擎中用到的各類許可證文件。LICENSE_SpiderMonkey，spider引擎中用到的 SpiderMonkey-JS運行環境，須要此許可證，該許可證適用於MPL/GPL/LGPL幾種許可證 LICENSE_chipmunk，LICENSE_JS，LICENSE_lua等等。引擎在這些許可證下能夠對相應的源代碼進行任意拷貝和修改。
• quick：這個是Quick引擎代碼。其中包含了建立各個平臺新工程的批處理工具，Quick框架的核心目錄，2dx和一些其餘依賴的c++文件，模版工程，Quick所帶的例子等等Quick的核心文件。
• README.html／README.md：Quick的使用指南，關於Quick的安裝、使用、建立等等信息均可以出這裏獲取，它其實至關於docs內文件的目錄。
• setup_mac.sh: 搭建Mac開發環境的腳本。
• setup_win.bat: 搭建Windows開發環境的腳本。
• tools：Quick用作luabinding的工具，可用來導出自定義的C++類。
• version：版本標示。

新項目目錄結構分析

打開新建項目的目錄，咱們來分析下新建項目的目錄結構，其結構以下圖所示：

• config.json: 項目信息配置文件。
• debug.log: 項目日誌，即打印控制檯窗口輸出的全部日誌文件。
• frameworks: 存放Cocos2d-x引擎核心代碼及各個平臺運行時資源。
• res：存放項目資源的文件夾，也就是說，咱們遊戲開發中用到的全部圖片、字體、音頻等資源都放在這裏。
• runtime：存放預編譯的運行時庫。
• src：項目源碼所存放文件夾，即遊戲中的全部的 .lua 文件都放在這裏。

以上目錄中 res 和 src 文件夾是比較最要的，開發中咱們也只須要對這兩個文件夾裏的內容進行操做，就能夠實現遊戲的開發。

在新項目的src文件夾中，如今你是能夠看到一些 .lua 文件的，這些就是咱們工程的lua代碼。接下來咱們簡單的介紹下src中各項的功能：

• cocos: cocos引擎代碼
• framework: quick的核心部分，在Cocos2d-x基礎上本身搭建的一套framework
• config.lua: 工程配置文件，包括分辨率適配等信息
• main.lua: 工程入口
• app: 工程的界面等文件，存放咱們的遊戲代碼
  • MyApp.lua: 遊戲的第一個界面
  • scenes: 存放遊戲各個場景代碼的文件夾
    • MainScene: 遊戲的第一個場景

在遊戲開發中，須要修改和添加界面時，咱們只須要在相應的文件夾中添加場景就能夠了。

好了，這章就算講完了，下一章咱們將先講解新建項目各個lua文件的代碼結構和使用方法，並開始着手新遊戲的開發。