Switching libGDX Versions

  • Release builds: these are considered stable. You can see the available release versions on Maven Central.
  • Nightly builds: also known as SNAPSHOT builds in Maven lingo. These are cutting edge versions of libGDX that are built on every change to the source repository. Snapshot builds also have a version number of the form x.y.z-SNAPSHOT, e.g. 1.0.1-SNAPSHOT. You can find the latest SNAPSHOT version string .

Your Gradle based project makes it very easy to switch between releases and nightly builds. Open up the file in the root of your project, and locate the following line:

The version you see may be higher than 1.5.2 already. Once you’ve located that string, you can simply change it to the latest release (or an older release) or to the current SNAPSHOT version. You may also have to update other modules in that same section of the build.gradle file, based on the versions listing. Once edited, save the build.gradle file. For a much easier way to update your dependencies (automatically find the newest version of each), see

  • Eclipse: Select all your projects in the package explorer, right click, then click Gradle -> Refresh All. This will download the libGDX version you specified in build.gradle and wire up the JAR files with your projects correctly.
  • Netbeans: in the “Projects” view, right-click the top-most project node and select “Reload Project”. All sub-projects will also be reloaded with the new files.
  • Command Line: invoking any of the tasks will usually check for changes in dependency versions and redownload anything that changed.

You need to replace additional files for some releases. They are listed here:

Update to release 1.9.12

  • HTML: You can delete the soundmanager files for HTML Project and the references in index.html
  • HTML: You should update code in HTMLLauncher according to setup template

Update to release 1.9.6

  • Replace soundmanager files for HTML project, otherwise Web Application might not start. See #2246

Essentially, the gradle wrapper (./gradlew) is pretty standard for gradle projects. You don’t have to use it and can use a system gradle installation. But basically, it’s a very lightweight wrapper which will download the version of gradle you want into the project dir. This means that anyone can just clone your code, run ./gradlew and it will automatically download said version of gradle. No need for complex setup, etc.

Or if you want to specify a Gradle distribution by URL(find official distributions ):

To upgrade your gradle wrapper.

Gradle Versions Plugin And Updating Your Dependencies

For more info, see: