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