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
中,將所有用戶可配置的lwjgl3
資訊保留/android/build.gradle
/gradle.properties
、 /core/build.gradle
、 /html/build.gradle
等。 ,因為您也可以建立一個依賴 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 程式碼中。
祝你好運,我們希望你做出一些偉大的事情!