libGDX Gradle 项目的设置工具。
要生成项目,请下载最新的应用程序jar
并运行它(通常双击即可),或手动运行以下命令(适当替换VERSION
):
java -jar gdx-liftoff-VERSION.jar
您必须使用 Java 17 或更高版本进行构建! Gradle 的当前版本以及当前的 Android 工具现在要求您安装的 JDK 版本为 17 或更高版本。无论您的目标平台是什么,Gradle 8.10 及更高版本都需要版本至少为 17 的 JDK!在使用任何 JDK 版本 17 及更高版本进行构建时,您仍然可以针对其他版本(通常低至 8)。 Java 8 到 23 的所有稳定目标版本现在都可以在这里工作。我们使用 Gradle 8.10.2,因为它可以与 Java 23 一起开箱即用(即使它刚刚发布!)。
如果您遇到任何问题,可以尝试我们的“故障排除指南”。
除了原始gdx-setup
的大部分功能外, gdx-liftoff
工具还提供:
项目模板。您可以选择突出显示各种 libGDX 功能的众多项目框架之一。
即时输入验证。您的项目数据在您输入时就会得到验证。
其他 JVM 语言支持。您可以为您的项目选择其他语言,例如 Kotlin 或 Scala。他们的标准库、Gradle 插件和适当的源文件夹将包含在内。
定制。您可以更好地控制应用程序所使用的软件版本。
更多第三方扩展。它们的版本是从 Maven Central 或 JitPack 获取的,因此您的项目始终生成最新的。
自动配置棘手的扩展。如果您在设置 Artemis-ODB、Lombok 或其他几个库时遇到问题,Liftoff 会做一些额外的工作,因此您不必这样做。
偏好设置支持。保存了您的应用程序的基本数据,因此您不必每次生成项目时都填写它。
可选的 Gradle 运行器。您可以选择在项目生成后执行 Gradle 任务。 Gradle 不必运行即可创建项目。
支持所有 libGDX 后端。您是否需要 LWJGL2、LWJGL3 和/或 Headless 后端? Liftoff 提供了简单的复选框来添加任何和所有官方平台,以及一些特殊的其他模块。
方便的特点。如果你有JetBrains Toolbox,则可以在IDEA中一键打开刚刚生成的项目(需要在Toolbox中设置“生成Shell脚本”)。如果您使用Eclipse,仍然可以正常导入Gradle项目。
最新。该项目以其在 Gradle 或 libGDX 本身等主要外部组件发布后快速更新而自豪。
支持更多后端。无头后端长期以来一直是 libGDX 的一部分,但在 gdx-setup 中不容易访问;这里是一个复选框。 TeaVM 是一种越来越流行的基于浏览器应用程序的 GWT 替代品,它也可以与 Kotlin 和其他 JVM 语言以及 Java 一起使用。
构建开箱即用的本机可执行文件。 Construo 插件允许您使用项目的 JAR 组装 JDK,并使用本机 Win64 .exe、MacOS(x64 或 AARCH64).app 或 Linux x64 可执行文件启动它。 Graal Native Image 的配置也包含在内,尽管这不太可能立即“正常工作”。
对于喜欢视频的人,@raeleus 制作了这个教程视频。
如果您更喜欢阅读文字,那么您可以...
Gdx-Liftoff 是一个相对简单的 GUI 应用程序。
输入项目名称/包/主类名称。
单击项目选项。
选择您想要的选项(其他平台、非 Java 语言、官方扩展和/或模板)。
单击“下一步”。
选择您要添加的任何第三方扩展。
单击“下一步”。
输入项目路径并可选择更改 Java 版本(例如更改为 8 以获得更好的 iOS 支持)。
单击“生成”,让奇迹发生。
之后,您可以在指定的路径中打开项目,或者在 IDEA 中更快地打开它(如果已安装),Liftoff 可以看到它(最有可能使用 JetBrains Toolbox,但也可以使用手动安装的 IDEA)。
如果你想使用 Kotlin,推荐使用 Kotlin 模板(例如Kotlin Logo
);这些提到他们在描述中使用“Kotlin 启动器”。 KTX 库均可作为第三方扩展使用;这些对于 Kotlin 项目来说不是必需的,但它们可能会有所帮助。 KTX 和其他基于 Kotlin 的库需要启用 Kotlin。目前,此处生成的项目默认使用 Kotlin 2.0.21,这可能与早期的 1.9.x 版本存在一些不兼容性。当您选择 Kotlin 作为选项时,您可以在“语言”对话框中将版本设置为最新的 1.9.x 版本(当前为 1.9.25)。然而,2.x 系列版本声称有许多不错的改进,并且大多数库似乎要么非常接近兼容,要么已经兼容。 Liftoff 本身是使用 Kotlin 2.x 以及大量 Java 代码(与 Java 8 兼容)构建的。
与 gdx-setup 项目相比,Liftoff 项目中的某些内容的结构有所不同。 gdx-setup 将几乎所有配置放在/build.gradle
(在项目根目录中)中,包括android
或html
等子项目,Liftoff 仅将共享配置放在根目录build.gradle
中,将所有用户可配置的版本信息保留在/gradle.properties
中/gradle.properties
,并将每个项目的配置移动到/core/build.gradle
、 /android/build.gradle
、 /html/build.gradle
等。 Liftoff 还调用依赖于 LWJGL3 lwjgl3
的项目,因为您还可以创建一个依赖于 LWJGL2 的项目,称为lwjgl2
。您可能需要将对“桌面”模块的引用(因为 gdx-setup 调用 LWJGL3)更改为lwjgl3
,因为这是您最有可能使用的桌面模块。
如果要将依赖项添加到 build.gradle 文件,则可能需要将它们添加到根目录中的/core/build.gradle
而不是/build.gradle
。某些依赖项可能还需要将部分添加到/lwjgl3/build.gradle
、 /html/build.gradle
等。如果一个库说要向依赖项部分添加行,那几乎总是意味着dependencies { }
内的块,而不是buildscript { }
内的块。通常有两个依赖项块,并且您通常需要最后一个。在 Liftoff 中选择的模板会自动处理此问题。
有关如何使用该应用程序及其工作原理的更多详细信息,请参阅使用指南。如果您想为该项目做出贡献,您可能会发现架构文档很有帮助。
提交拉取请求时,请使用ktlintFormat
Gradle 任务格式化应用程序。
该项目是从czyzby/gdx-setup
存储库中分叉出来的。 @czyzby 和 @kotcrab 创建了原始应用程序,以及它所依赖的一组库(分别是gdx-lml
和VisUI
)。从那时起,该项目由@tommyettinger 维护。非常感谢,czyzby 回来了并做了很多改进,非常感谢!还要感谢@metaphore,他现在维护着 gdx-lml (它曾经使用过并且可能仍然使用)。
@raeleus 为 scene2d.ui 创建了粒子公园皮肤,该皮肤被改编为添加到新项目的默认皮肤(如果选择了“生成 UI 资源”选项)。 “Accademia di Belle Arti di Urbino 和视觉设计硕士课程的学生”创建了皮肤使用的Titillium Web字体(在 SIL OFL 许可下)。哦,是的,他从 1.12.1.10 版本开始做了一些其他的事情,比如几乎整个版本。非常感谢 raeleus 对用户体验的彻底改造!
其他项目贡献者包括@Mr00Anderson、@lyze237、@metaphore(再次!)和@payne911。那些没有直接贡献代码的人仍然通过花时间在 macOS 和 iOS 等平台上进行测试而提供了很多帮助; @JojoIce 是为 iOS 做出贡献的几位人士之一。当然,非常感谢所有早期采用者在早期就容忍了任何部分工作的版本!
Android 项目中使用的随机图标来自 OpenMoji 项目。如果您想以较少损坏的格式使用这些图标,可以使用 openmoji-atlas 方便地从 libGDX 访问这些表情符号。
还要感谢所有制作 Liftoff 所依赖的各种库和工具的人。从负责 Graal Native Image 的庞大团队,到几乎由一个团队组成的 Construo,Liftoff 的一些最佳功能根本不在 Liftoff 代码中。
祝你好运,我们希望你做出一些伟大的事情!