diff --git a/Guide.md b/Guide.md index 70aacfcc..6147b9e9 100644 --- a/Guide.md +++ b/Guide.md @@ -6,8 +6,8 @@ initially configured your project, and it is very far behind the times on its de The official setup may transition to a web-based tool soon, but any user of the Internet can recall times when formerly-reliable services went offline or had outages. This project provides another alternative setup tool based on [SquidSetup](https://github.com/tommyettinger/SquidSetup), but removing the close ties to the SquidLib libraries to make it more general-use. Using SquidSetup's -code, which is built on czyzby's code, gives us working projects that use Gradle 7.3.2, ahead of 6.7.1 for the official setup and 4.0.2 for czyzby's gdx-setup. -The current Gradle version is 7.3.2 at the time of writing, and since gdx-liftoff 1.10.0.9, new projects use that 7.3.2 version. +code, which is built on czyzby's code, gives us working projects that use Gradle 7.3.3, ahead of 6.7.1 for the official setup and 4.0.2 for czyzby's gdx-setup. +The current Gradle version is 7.3.3 at the time of writing, and since gdx-liftoff 1.10.0.9, new projects use that 7.3.3 version. This allows new projects to "just work" on machines where Java 8 through 17 could be the default, and the moderate amount of configuration changes needed for Gradle 7.x are all handled by gdx-liftoff. Thanks to the Gretty plugin's latest release, Gradle 7.x now works well with the HTML platform, without additional quirky configuration (earlier versions of Liftoff needed that). @@ -33,10 +33,12 @@ The current version of gdx-liftoff uses LWJGL3 internally; 1.9.10.5 used LWJGL2 more compatibility issues with LWJGL2, maybe since it hasn't been updated in 5+ years, than with LWJGL3. This perhaps validates the decision to default to LWJGL3 for new projects generated by gdx-liftoff. -This project rapidly updated to Gradle 7.3.2 when it was released because this Gradle version contains mitigations for -the so-called "log4shell" vulnerability in log4j. Since that vulnerability is extremely serious, any kind of mitigation -is a good thing to have, especially for new projects. It is doubtful that gdx-liftoff itself would be affected by a -log4j-related issue, but the projects it creates should be as up-to-date and secure as we can get. +This project rapidly updated to Gradle 7.3.2 and then 7.3.3 when they were released because this Gradle version contains +mitigations for the so-called "log4shell" vulnerability in log4j. Since that vulnerability is extremely serious, any +kind of mitigation is a good thing to have, especially for new projects. It is doubtful that gdx-liftoff itself would be +affected by a log4j-related issue, but the projects it creates should be as up-to-date and secure as we can get. New +projects as of 1.10.0.10 include a section of dependency constraints recommended by the Gradle team to block transitive +dependencies on vulnerable log4j versions. ## Usage @@ -89,8 +91,8 @@ log4j-related issue, but the projects it creates should be as up-to-date and sec libGDX 1.10.0 to improve behavior on iOS, and gdx-liftoff may need to apply some changes to template code for iOS projects to work more cleanly with libGDX 1.10.0 . - Android should only be checked if you've set up your computer for Android development. Since gdx-liftoff uses - Gradle 7.3.2, having an Android project present shouldn't interfere with other platforms or IDE integration, as - long as your IDE supports Gradle 7.3.2 (current Android Studio and IDEA both support it). + Gradle 7.3.3, having an Android project present shouldn't interfere with other platforms or IDE integration, as + long as your IDE supports Gradle 7.3.3 (current Android Studio and IDEA both support it). - **You must set your project's JDK to a version 11 or higher** to use Android, due to a new requirement of the Android Gradle Plugin used by Android Studio and IDEA. JDK 11 is the most versatile option right now, because it can be used with gdx-setup projects and Android projects. JDK 17 works, but since it requires Gradle 7.3 or @@ -182,7 +184,7 @@ see [libGDX's documentation](https://libgdx.badlogicgames.com/documentation/gett - If you had the GWT option checked in the setup and have a non-empty template, you can go through the slightly slow, but simple, build for GWT, probably using the `superDev` task for the `gwt` module, or also possibly the `dist` task in that module. - - GWT builds have gotten much faster with Gradle 7.3.2 (since Gradle 6, really) and some adjustments to + - GWT builds have gotten much faster with Gradle 7.3.3 (since Gradle 6, really) and some adjustments to configuration, so if you were avoiding GWT builds because of slow compile times, you might want to try again. - If you had the iOS option checked in the setup, you're running Mac OS X, and you have followed all the steps for iOS development with libGDX, maybe you can run @@ -202,7 +204,7 @@ see [libGDX's documentation](https://libgdx.badlogicgames.com/documentation/gett Gradle has some quirks. Here's some notes on things you might encounter during upgrades from other projects or older versions. - - All builds currently use Gradle 7.3.2 with the "api/implementation/compile fiasco" resolved. Adding dependencies + - All builds currently use Gradle 7.3.3 with the "api/implementation/compile fiasco" resolved. Adding dependencies will use the `api` keyword instead of the `compile` keyword it used in earlier versions. All modules use the `java-library` plugin, which enables the `api` keyword for dependencies. - You can use the `implementation` keyword for dependencies in any module except `core`; this is supposed to diff --git a/build.gradle b/build.gradle index b6e364e0..e0773621 100644 --- a/build.gradle +++ b/build.gradle @@ -26,7 +26,7 @@ buildscript { } } -version = "1.10.0.10-SNAPSHOT" +version = "1.10.0.10" mainClassName = 'gdx.liftoff.MainKt' sourceCompatibility = JavaVersion.VERSION_1_8 diff --git a/src/main/kotlin/gdx/liftoff/config/Configuration.kt b/src/main/kotlin/gdx/liftoff/config/Configuration.kt index 3cfaa434..35acadcf 100644 --- a/src/main/kotlin/gdx/liftoff/config/Configuration.kt +++ b/src/main/kotlin/gdx/liftoff/config/Configuration.kt @@ -39,7 +39,7 @@ import gdx.liftoff.views.widgets.ScrollableTextArea @Suppress("unused") // Fields accessed via reflection. class Configuration { companion object { - const val VERSION = "1.10.0.10-SNAPSHOT" + const val VERSION = "1.10.0.10" const val WIDTH = 600 const val HEIGHT = 700 const val PREFERENCES_PATH = "gdx-liftoff-prefs" diff --git a/version.txt b/version.txt index 8ce8d5b3..95b64437 100644 --- a/version.txt +++ b/version.txt @@ -1 +1 @@ -1.10.0.9 +1.10.0.10