開發工具准備就緒以后,下面我們就可以開始創建我們的項目了.
首先啟動 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:版本標示。
新項目目錄結構分析
打開新建項目的目錄,我們來分析下新建項目的目錄結構,其結構如下圖所示:
- onfig.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文件的代碼結構和使用方法,並開始着手新游戲的開發。
本系列為Cocos引擎中文官網教程組編寫,原創教程轉載請注明出處。謝謝