下一步是创建一个新的行用程序。以往,你必须在Eclipse中创建好几个项目,一个用于共享游戏代码,另外一个作为桌面端启动器,剩下的是Android, iOS, 和HTML5/GWT启动器,此外,这些项目必须要进行配置并通过特定的方式来联系在一起,这是一个花费时间的任务并对于没有经验的用户或多或少会出现的问题。
幸运的是,libGDX提供了生成预配置项目的工具,新创建的项目可以直接导入到Eclipse。在这里官方提供了两种创建libGDX项目的工具,最新的版本使用Gradle,旧版本的创建工具由Aurelien Ribon编写,首先,我们将学习如何通过旧版本创建项目,然后再学习新版本
使用旧的创建工具
旧的项目创建工具是一个名为gdx-setup-ui.jar可执行的JAR文件
步骤1
你可以从https://github.com/libgdx/libgdx-old-setup-ui下载旧版本创建工具,如下图
步骤2
双击gdx-setup-ui.jar运行,程序启动后,点击Create按钮
步骤3
在下一个窗口,你将看到盒子左边有一个名为CONFIGURATION的区域,你可以从这里配置你要创建的项目
在Name字段后输入demo,它为你的项目指定了一个共同的名称,每个启动器将在其后添加各自的后缀,如 -desktop,-android , 或 -html ,在窗口的右边的OVERVIEW区域将会出现一个预览结果。
Package字段用来定义你的Java包的名称,这需要一个唯一并小写的标识符,通常是你的逆向域名,你不必拥有一个真实的域名,这样做的目的只是为了解决Java应用命名空间冲突的问题,对于Android这是非常重要的,因为如果两个独立应用的包相同,那就意味着,已安装的应用将会被另一正在安装的应用覆盖,这里的演示程序,现在使用 com.packtpub.libgdx.demo 作为包名
Game class字段用来指定共享代码项目中主类的名称,输入MyDemo作为游戏类名。
Destination字段用来指定目标文件夹,所有生成的项目将会保存在这里,点击旁边的蓝色文件夹按钮设置目标文件夹为 C:\libgdx\
另外一个叫做LIBRARY SELECTION的区域,显示了所需要的库的状态,如果有任何项目中列出红色,这意它需要在创建前被修复,您将看到libGDX被列在红色的项目中,点击旁边蓝色的文件夹按钮 :
步骤4
然后,选择下载的文件libgdx-1.2.0.zip,并点击Open,如下 :
步骤5
现在LibGDX标签的文本颜色应该从红色变成绿色了,点击Open the generation screen继续 :
步骤6
下一步,点击Launch! 生成所有的项目,如下图 :
步骤7
一切就绪!你现在可以将已生成的项目导入到Eclipse的工作空间,为此,选择File菜单中的Import选项
步骤8
在Import对话框中,展开General分类,选择Existing Projects into Workspace,然后点击Next按钮,如下图 :
步骤9
点击多选按钮Select root directory并在输入框中输入 C:\libgdx,这是你所有已生成项目的所在目录,确保目录正确无误后按下Enter键,Eclipse将扫描该目录并列出所有的项目,选中所有复选框并点击Finish按钮,如下图 :
步骤10
Eclipse将会自动创建(编译)四个被导入的项目,可能会出失败。手动导入项目后有两个问题需要被解决,第一个错误会直接在Eclipse的Console窗口中打印出来,提示不能解决目标Android版本为15,如下图 :
你必须打开demo-android项目的项目属性。首先,在左边的资源管理器中选中该项目,然后,选中菜单栏中的Project菜单中的Properties选项,如下图 :
步骤11
窗口的标题为Properties for demo-android。如果不是这样,关闭窗口并确认已经选中当前项目并重试上一步,然后,选择左边侧栏中Android,你将会看到一个可用系统的列表,选择Android2.2,API版本为8,点击OK按钮 :
步骤12
此时,Eclipse将识别到变化并并成功创建Android项目。
第二个问题需要你点击Problems标签,展开Errors列表并在报错项(错误信息为The GWT SDK JAR gwt-servlet.jar is missing in the WEB-INF/lib directory.)上右击,选择快速修复,如下图 :
步骤13
在Quick Fix对话框中,选择Synchronize <WAR>/WEB-INF/lib with SDK
libraries作为理想修复并点击Finish按钮,如下 :
现在两个问题已经被修复,这意味着现在所有项目都被成功创建并编译。
【注意】使用gdx-setup-ui创建一个项目,看起来可能有点困难,实际上它是非常简单的。本书中,我们将使用该工具创建我们的第一个游戏项目,在之后的第14章(Bullet Physics)中,我们将使用基于Gradle的项目创建工具进行项目创建,从而掌握这两种技术。
使用基于Gradle的构建工具
第一个游戏项目,我们将使用旧版本的创建工具,然而,在本节我们将会了解新版本创建工具的工作原理,以便我们在以后的章节使用。
你可以从http://libgdx.badlogicgames.com/download.html下载gdx-setup.jar文件,点击Download Setup App开始下载,如下图 :
然而,我们已下载的 libgdx-1.2.0.zip中包含gdx-setup.jar,因此,我们可以直接提取出gdx-setup,并运行该工具,如下图 :
Name, Package, Game Class, 和Destination字段与旧版本含义相同
Android SDK字段用来指定你的Android SDK所在路径,点击Browse按钮并将其设置为Android SDK的文件夹,这里为 C:\Program Files\Android\android-sdk
在Libgdx Version的下拉列表里,我们选择Release 1.2.0。在下边Sub Projects中,你可以选择你要发布的目标平台,这里,我们选择所有的平台,即Desktop,Android,ios和Html。
最后,你可为你的项目添加一些拓展功能(如box2d,, physics bullet等),有的功能可能无法在所有平台上工作,在本例中,我们不需要任何拓展,因此忽略该部分。
【注意】在创建项目的时候,你必须添加新的目标平台或手动拓展,对于手动添加依赖,可以参考https://github.com/libgdx/libgdx/wiki/Dependency-management-with-Gradle。
现在,点击Advanced按钮,选中Eclipse,然后点击Save,如下图 :
现在我们已经完成了所有设置,点击Generate
【注意】gdx-setup 将会提示你下载并安装最版本的SDK和构建工具,忽略即可。本书使用的SDK版本为19,构建工具版本为19.0.3
创建项目需要下载一些相关的库,这可能要花费一点时间,请确保网络通畅,最终,它将会显示 BUILD SUCCESSFUL ,如下图 :
这意味着您现在可以将项目导入到您的IDE,运行,调试并打包!一切就绪!你现在可以到Eclipse导入项目到你的工作空间。
可以遵循以上步骤7 到步骤9,将项目导入到Eclipse中,然而,为了访问Gradle插件的特点,你导入的方式与之前完全不同,选择File菜单的Import选项,在Import对话框中,展开Gradle并选择Gradle Project ,如下图 :
在新的Import Gradle Project窗口中,点击Browse并选择你创建的demo项目,这里为 C:\libgdx . 然后点击Build Model按钮,如下图 :
创建项目需要花费一点时间,之后,选择所有的项目并点击Finish,如下图 :
在导入成功后,更改Android API的版本为8,可参考以上步骤10和步骤11
【完】
【译者注】
• 博主在学习本书时,所有的项目都是通过基于Gradle的构建枸工具创建的,在这里也推荐大家使用新版本的构建工具创建项目
• 在第一次使用新版本构建工具创建项目的时候,需要下载一些必要的库,请科学上网后再进行操作,否则可能导致创建失败
• 在使用Eclipse第一次导入新版构建工具所创建的项目时,Gradle插件可能会进行更新,请科学上网后再进行操作,否则可能导致导入失败
• 本书使用的Android API版本为8,在实际开发中尽可能使用较高版本的API
暂无关于此日志的评论。