Desktop/Android/iOS/HTML5 Java game development framework

Release Builds

Every so often we create a release with a version number (e.g. 0.9.7). These releases follow the implementation of new features as well as fixing a certain amount of bugs.

Latest Release

Nightly Builds

We build a new nightly release every time something in the source repository changed. You can use the nightlies if you want cutting edge features or if there were bug fixes you are waiting for. We consider our nightlies to be rather stable. In fact, release builds are nothing more than snapshotted nightlies.

Latest Nightly Build

Source Code

Libgdx can be found on Github. If you found a bug please use the issue tracker on Google Code. If you have a pull-request for us, file an issue on Google Code with a link to the pull-request on Github.

Git

Contents of a Release/Nightly

Each release/nightly contains a bunch of jar files that are necessary for a multi-platform libgdx project. Here's a dump of the directory structure with some explanations. The Gdx Setup UI takes care of managing your dependencies. If you want to setup things manually, here's a guide.

docs                             - offline Javadocs

extensions                       - jar files and native libraries for extensions

sources                          - source jars for core and backends for IDE integration
ios                              - contains IKVM, iOS libgdx binaries and MonoTouch Java bindings
armeabi                          - native libraries for Android (arm6), copy to $ANDROID_PROJECT/libs/
armeabi-v7a                      - native libraries for Android (arm7), copy to $ANDROID_PROJECT/libs/
gdx-backend-android.jar          - Android backend jar
gdx-backend-gwt.jar              - GWT backend jar
gdx-backend-lwjgl-natives.jar    - Lwjgl backend natives jar
gdx-backend-lwjgl.jar            - Lwjgl backend jar
gdx-openal.jar                   - desktop audio backend jar for Jogl & Lwjgl backend
gdx-natives.jar                  - Gdx core desktop natives jar
gdx.jar                          - Gdx core jar
gdx-setup-ui.jar                 - Gdx Setup UI, run this to generate new projects!

Libgdx consists of the core, backends and extensions. The core contains the platform agnostic code for all the libgdx APIs. The backends contain the platform specific code upon which the core relies, e.g. OpenGL wrappers. Extensions are optional, most games do not need them.

Dependencies

A standard libgdx game with a standard project setup (core, desktop, Android and html5 project) would have the following dependencies:

  • core: gdx.jar, gdx-sources.jar (for Javadocs)
  • desktop: core, gdx.jar, gdx-backend-lwjgl.jar, gdx-backend-lwjgl-natives.jar, gdx-backend-lwjgl-sources.jar
  • android: core, gdx.jar, gdx-backend-android.jar, gdx-backend-android-sources.jar. Additionally, the armeabi and armeabi-v7a folders have to be copied to the Android projects libs/ folder.
  • html5: core, gdx.jar, gdx-sources.jar (necessary for GWT to work!), gdx-backend-gwt.jar, gdx-backend-gwt-sources.jar