Libgdx Developer's Guide(Libgdx開發者手冊)-3(執行示例與測試)
Libgdx帶有一堆小的測試例子和許多示例遊戲 。想要執行並簡單分析這些例子,必須直接使用libgdx原始碼。
開始前請確保安裝了所有的 前置要求 。執行這些例子不需要 C/C++ 跨平臺編譯或者使用libgdx的Java原始碼。
獲取原始碼
要獲取原始碼和所有平臺的本地庫檔案,執行以下命令列。當然也可以通過Git GUI進行clone:(譯者提示:不願意使用git命令的,其實可以在git頁面選擇下載libgdx的原始碼zip包)
git clone git://github.com/libgdx/libgdx.git cd libgdx ant -f fetch.xml
這會從git倉庫提取所有原始碼,然後通過Ant指令碼fetch.xml從構建伺服器下載本地檔案。為了減少檔案大小,Git倉庫是不包含這些本地庫的,因此需要執行這兩步。
為了保持程式碼是最新的,你可以隨時在libgdx目錄下執行以下步驟:
git pull ant -f fetch.xml
這樣會從Git倉庫提取最新的更新,並從構建伺服器下載最新的本地庫檔案。
一旦你有了原始碼和本地庫檔案,就可以開啟Eclipse並匯入所有的工程:
- File -> Import
- 選擇General -> Existing Projects into Workspace
- 瀏覽 libgdx 上當並確保選中所有工程
- 點選完成
Eclipse 現在匯入了libgdx目錄中的所有工程。第一次匯入往往能發現到處都是錯誤。不用害怕,只是Eclipse的問題。按照以下方法解決這些問題:
- 到Project -> Clean
- 確保選中所有專案並點選OK
- 在包檢視中選擇所有專案,然後點選 F5 重新整理
- 還有一些問題是關於GWT的。在Problems檢視,右鍵每個入口 "The web.xml file does not exist", 選擇 Quick Fix 並點選OK
現在可以開始測試和執行示例遊戲了。
執行示例和測試
測試示例包含在 gdx-tests 工程中。這個工程只包含原始碼。為了真正在桌面執行測試,必須執行 LwjglTestStarter 類,該類包含在 gdx-tests-lwjgl工程中。要在Android上執行該示例,只需簡單地在模擬器或者連線的裝置中啟動 gdx-tests-android 專案! 要在瀏覽器執行測試需要啟動 gdx-tests-gwt 專案。
執行示例測試的方法是一樣的。每個示例遊戲包含3到4個專案,主工程,桌面工程(通過和主工程一樣),android工程和HTML5工程。
測試與示例都可以按照下面步驟啟動
- 右鍵上面提到的其中一個專案
- 選擇Run As -> Java Application 以執行桌面工程. 在隨後的對話方塊中選擇 LwjglTestStarter
- 選擇Run As -> Android Application 以執行Android工程. 這會啟動模擬器或釋出測試工程到已連線的Android裝置。
- 選擇Run As -> Web Application 以執行 html5 工程. 這會開啟一個新的檢視,點擊出現的URL。可能會提示你為瀏覽器選擇安裝GWT外掛(提示: 使用Chrome)。注意應用是以開發模式執行,這意味著應用會非常慢。為了全速執行,你必須編譯html專案,併發布至web伺服器。
For a more in-depth description of the project setup as well as how to run and debug a libgdx project seeProjectSetupNew