Software:libGDX

From HandWiki
Short description: Game-development Java framework

libGDX
LibGDX logo.svg
Original author(s)Mario Zechner
Initial release20 April 2014; 10 years ago (2014-04-20)[1]
Stable release
1.12.0 / 2 July 2023; 12 months ago (2023-07-02)
Written inJava, C, C++
Operating systemWindows, Linux, Mac OS X, Android, BlackBerry OS, iOS, Java Applet, JavaScript/WebGL[2]
PlatformJava platform
LicenseApache License 2.0[2]
Websitehttps://libgdx.com

libGDX is a free and open-source[3] game-development application framework[2] written in the Java programming language with some C and C++ components for performance dependent code.[4] It allows for the development of desktop and mobile games by using the same code base.[5] It is cross-platform, supporting Windows, Linux, Mac OS X, Android, iOS, BlackBerry and web browsers with WebGL support.[2][6]

History

In the middle of 2009 Mario Zechner, the creator of libGDX, wanted to write Android games and started developing a framework called AFX (Android Effects) for this. When he found that deploying the changes from Desktop to Android device was cumbersome, he modified AFX to work on the Desktop as well, making it easier to test programs. This was the first step toward the game framework later known as libGDX.[1]

In March 2010 Zechner decided to open-source AFX, hosting it on Google Code under the GNU Lesser General Public License (LGPL). However, at the time he stated that "It's not the intention of the framework to be used for creating desktop games anyway", intending the framework to primarily target Android. In April, it got its first contributor.[1][7]

When Zechner created a Box2D JNI wrapper, this attracted more users and contributors because physics games were popular at the time.[better source needed] Many of the issues with Android were resolved because of this.[1]

Because many users suggested switching to a different license due to LGPL not being suitable for Android, libGDX changed its license to the Apache License 2.0 in July 2010, making it possible to use the framework in closed-source commercial games.[1][8] The same month its phpBB forum was launched.[1][9]

Due to issues with Java Sound the audio desktop implementation switched to OpenAL in January 2011.[1][10] Development of a small image manipulation library called Gdx2D was finished as well, which depends on the open source STB library.[1][11]

The rest of 2011 was spent adding a UI library[12] and working on the basics of a 3D API.[1]

At the start of 2012 Zechner created a small helper library called gdx-jnigen for easing the development of JNI bindings.[1][13] This made it possible for the gdx-audio[14] and gdx-freetype[15] extensions to be developed over the following months.[1]

Inspired by Google's PlayN cross-platform game development framework that used Google Web Toolkit (GWT) to compile Java to JavaScript code, Zechner wrote an HTML/JavaScript backend over the course of several weeks, which allowed libGDX applications to be run in any browser with WebGL support.[1] After Google abandoned PlayN, it was maintained by Michael Bayne, who added iOS support to it. libGDX used parts of this work for its own MonoTouch-based backend.[1][16][17]

In August 2012 the project switched its version control system from Subversion to Git, moving from Google Code to GitHub. However, the issue tracker and wiki remained on Google Code for another year. The main build system was also changed to Maven, making it easier for developers with different IDEs to work together.[1][18][19]

Because of issues with the MonoTouch iOS backend Niklas Thernig wrote a RoboVM backend for libGDX in March 2013, which was integrated into the project in September.[1][20][21] From March to May 2013 a new 3D API was developed as well and integrated into the library.[1][22][23]

In June 2013 the project's website was redone, now featuring a gallery where users can submit their games created with libGDX.[1][24] (As of January 2016) more than 3000 games have been submitted.[25]

After the source code migration to GitHub the year before, in September 2013 the issue tracker and wiki were also moved there from Google Code.[1][26] The same month the build and dependency management system was switched from Maven to Gradle.[1][27]

After a cleanup phase in the first months of 2014 libGDX version 1.0 was released on 20 April, more than four years after the start of the project.[1]

In 2014 libGDX was one of the annual Duke's Choice Award winners, being chosen for its focus on platform-independence.[28][29]

From a diverse team of open source enthusiasts comes libGDX, a cross-platform game development framework that allows programmers to write, test, and debug Java games on a desktop PC running Windows, Linux, or Mac OS X and deploy that same code to Android, iOS and WebGL-enabled browsers—something not widely available right now. The goal of libGDX, says creator Mario Zechner, "is to fulfill the 'write once, run anywhere' promise of the Java platform specifically for game development."

In April 2016 it was announced that libGDX would switch to Intel's Multi-OS Engine on the iOS backend after the discontinuation of RoboVM.[30][31] With the release of libGDX 1.9.3 on 16 May 2016 Multi-OS is provided as an alternative, while by default the library uses its own fork of the open source version of RoboVM.[32][33]

libGDX Jam

From 18 December 2015 to 18 January 2016 a libGDX game jam was organized together with RoboVM, itch.io and Robotality. From initially 180 theme suggestions "Life in space" was chosen as the jam's main theme, and 83 games were created over the course of the competition.[34][35]

Release versions

Version Release date
1.0 20 April 2014[1]
1.1 23 May 2014[36]
1.2 22 June 2014[37]
1.3 9 August 2014[38]
1.4 10 October 2014[39]
1.5 8 December 2014[40]
1.6 6 May 2015[41]
1.7 21 September 2015[42]
1.8 5 January 2016[43]
1.9 24 January 2016[44]
1.10 18 April 2021[45]
1.11 11 May 2022[46]
1.12 2 July 2023[47]

{{{2}}}

Architecture

libGDX allows the developer to write, test, and debug their application on their own desktop PC and use the same code on Android. It abstracts away the differences between a common Windows/Linux application and an Android application. The usual development cycle consists of staying on the desktop PC as much as possible while periodically verifying that the project still works on Android. Its main goal is to provide total compatibility between desktop and mobile devices, the main difference being speed and processing power.[5]

Backends

The library transparently uses platform-specific code through various backends to access the capabilities of the host platform. Most of the time the developer does not have to write platform-specific code, except for starter classes (also called launchers) that require different setup depending on the backend.[48]

  • On the desktop the Lightweight Java Game Library (LWJGL) is used. There is also an experimental JGLFW backend that is not being continued anymore.[citation needed][when?] In Version 1.8 a new LWJGL 3 backend was introduced, intended to replace the older LWJGL 2 backend.[49]
  • The HTML5 backend uses the Google Web Toolkit (GWT) for compiling the Java to JavaScript code, which is then run in a normal browser environment. libGDX provides several implementations of standard APIs that are not directly supported there, most notably reflection.[50][51][52]
  • The Android backend runs Java code compiled for Android with the Android SDK.[citation needed]
  • For iOS a custom fork of RoboVM is used to compile Java to native iOS instructions. Intel's Multi-OS Engine has been provided as an alternative since the discontinuation of RoboVM.[30][32]

Other JVM languages

While libGDX is written primarily in Java, the compiled bytecode is language-independent, allowing many other JVM languages to directly use the library. The documentation specifically states the interoperability with Ceylon, Clojure, Kotlin, Jython, JRuby and Scala.[53]

Extensions

Several official and third-party extensions exist that add additional functionality to the library.

gdxAI

An artificial intelligence (AI) framework that was split from the main library with version 1.4.1 in October 2014 and moved into its own repository. While it was initially made for libGDX, it can be used with other frameworks as well. The project focuses on AI useful for games, among them pathfinding, decision making and movement.[54][55]

gdx freetype

Can be used to render FreeType fonts at run time instead of using static bitmap images, which do not scale as well.[56]

Box2D

A wrapper for the Box2D physics library was introduced in 2010 and moved to an extension with the 1.0 release.[1][57]

packr

A helper tool that bundles a custom JRE with the application so end users do not have to have their own one installed.[58][59]

Notable games

  • Drag Racing: Streets
  • Ingress (before it was relaunched as Ingress Prime)
  • Slay the Spire[60]
  • Delver
  • HOPLITE
  • Deep Town
  • Sandship
  • Unciv
  • Mindustry
  • Space Haven
  • Pathway
  • Halfway
  • Riiablo
  • Mirage Realms
  • Raindancer
  • PokeMMO
  • Zombie Age 3
  • Epic Heroes War
  • Shattered Pixel Dungeon
  • Hair Dash
  • Antiyoy
  • Wildermyth[61]
  • Line-Of-Five
  • Labyrinthian

See also

References

  1. 1.00 1.01 1.02 1.03 1.04 1.05 1.06 1.07 1.08 1.09 1.10 1.11 1.12 1.13 1.14 1.15 1.16 1.17 1.18 1.19 1.20 1.21 Zechner, Mario (20 April 2014). "libGDX 1.0 released". http://www.badlogicgames.com/wordpress/?p=3412. 
  2. 2.0 2.1 2.2 2.3 "Goals and Features". https://libgdx.badlogicgames.com/features.html. 
  3. "Official website". https://libgdx.badlogicgames.com/. 
  4. "mobilegameengines.com/game_engines/32-libgdx". http://mobilegameengines.com/game_engines/32-libgdx. 
  5. 5.0 5.1 "Home - libGDX". https://libgdx.com/wiki/. 
  6. "libgdx/README.md at master". https://github.com/libgdx/libgdx/blob/master/README.md. 
  7. Zechner, Mario (6 March 2010). "The Future...". http://www.badlogicgames.com/wordpress/?p=267. 
  8. Zechner, Mario (13 July 2010). "libgdx changes its license". http://www.badlogicgames.com/wordpress/?p=777. 
  9. Zechner, Mario (10 July 2010). "Forums!". http://www.badlogicgames.com/wordpress/?p=768. 
  10. Zechner, Mario (21 January 2011). "OpenAL & Natives Loading in Libgdx". http://www.badlogicgames.com/wordpress/?p=1502. 
  11. Zechner, Mario (26 January 2011). "Gdx2D and Super Jumper". http://www.badlogicgames.com/wordpress/?p=1506. 
  12. Zechner, Mario (25 June 2011). "UI Fun on Android with libgdx". http://www.badlogicgames.com/wordpress/?p=2050. 
  13. Zechner, Mario (3 January 2012). "gdx-jnigen: a stupid idea that might just work". http://www.badlogicgames.com/wordpress/?p=2254. 
  14. Zechner, Mario (8 January 2012). "gdx-audio". http://www.badlogicgames.com/wordpress/?p=2269. 
  15. Zechner, Mario (6 March 2012). "Create BitmapsFonts on the fly with gdx-freetype". http://www.badlogicgames.com/wordpress/?p=2300. 
  16. Zechner, Mario (8 June 2012). "Libgdx on iOS, days 1–2". http://www.badlogicgames.com/wordpress/?p=2450. 
  17. Zechner, Mario (13 June 2012). "Libgdx on iOS, day 5". http://www.badlogicgames.com/wordpress/?p=2459. 
  18. Zechner, Mario (8 August 2012). "Git & Maven". http://www.badlogicgames.com/wordpress/?p=2551. 
  19. Zechner, Mario (10 August 2012). "Libgdx is now on Github (sorta)". http://www.badlogicgames.com/wordpress/?p=2560. 
  20. Zechner, Mario (9 March 2013). "Early stage RoboVM libgdx backend". http://www.badlogicgames.com/wordpress/?p=2948. 
  21. Zechner, Mario (10 September 2013). "RoboVM backend in libgdx nightlies and first performance figures!". http://www.badlogicgames.com/wordpress/?p=3161. 
  22. Zechner, Mario (28 March 2013). "Brace yourselfs, new 3D API incoming". http://www.badlogicgames.com/wordpress/?p=2967. 
  23. Zechner, Mario (20 May 2013). "New 3D API in master". http://www.badlogicgames.com/wordpress/?p=3034. 
  24. Zechner, Mario (29 June 2013). "New libgdx site live!". http://www.badlogicgames.com/wordpress/?p=3093. 
  25. "Gallery". https://libgdx.badlogicgames.com/gallery.html. 
  26. Zechner, Mario (14 September 2013). "The great libgdx Issue Tracker & Wiki Github Migration". http://www.badlogicgames.com/wordpress/?p=3169. 
  27. Zechner, Mario (22 September 2013). "Welcome your new overlord: Gradle". http://www.badlogicgames.com/wordpress/?p=3198. 
  28. Kvitkar, Caroline (28 September 2014). "2014 Duke's Choice Award Winners". https://blogs.oracle.com/java/entry/2014_duke_s_choice_award. "Programmers can use this cross-platform game development framework to write, test, and debug Java games." 
  29. Zechner, Mario (29 September 2014). "libgdx wins Duke's Choice Award". http://www.badlogicgames.com/wordpress/?p=3527. 
  30. 30.0 30.1 Zechner, Mario (15 April 2016). "RoboVM is no more, what now?". http://www.badlogicgames.com/wordpress/?p=3925. 
  31. Müller, Henric (15 April 2016). "RoboVM Winding Down". https://robovm.com/robovm-winding-down/. 
  32. 32.0 32.1 Zechner, Mario (16 May 2016). "libGDX 1.9.3 released – New iOS backends". http://www.badlogicgames.com/wordpress/. 
  33. "MobiDevelop's RoboVM fork". http://robovm.mobidevelop.com. 
  34. Zechner, Mario (22 November 2015). "libGDX Jam is on! – Theme Voting Round #1". http://www.badlogicgames.com/wordpress/?p=3789. 
  35. Zechner, Mario (6 February 2016). "libGDX Jam – And the winner is…". http://www.badlogicgames.com/wordpress/?p=3904. 
  36. Zechner, Mario (23 May 2014). "libGDX 1.1.0 released". http://www.badlogicgames.com/wordpress/?p=3451. 
  37. Zechner, Mario (22 June 2014). "libGDX 1.2.0 released". http://www.badlogicgames.com/wordpress/?p=3461. 
  38. Zechner, Mario (9 August 2014). "libGDX 1.3.0 released". http://www.badlogicgames.com/wordpress/?p=3484. 
  39. Zechner, Mario (10 October 2014). "libGDX 1.4.1 released". http://www.badlogicgames.com/wordpress/?p=3533. 
  40. Zechner, Mario (8 December 2014). "libGDX 1.5.0 released". http://www.badlogicgames.com/wordpress/?p=3617. 
  41. Zechner, Mario (6 May 2015). "libGDX 1.6.0 released". http://www.badlogicgames.com/wordpress/?p=3682. 
  42. Zechner, Mario (21 September 2015). "libGDX 1.7.0 released". http://www.badlogicgames.com/wordpress/?p=3758. 
  43. Zechner, Mario (5 January 2016). "libGDX 1.8.0 released". http://www.badlogicgames.com/wordpress/?p=3870. 
  44. Zechner, Mario (24 January 2016). "libGDX 1.9.0 released". http://www.badlogicgames.com/wordpress/?p=3892. 
  45. damios (18 April 2021). "libGDX 1.10.0". https://libgdx.com/news/2021/04/gdx-1-10. 
  46. damios (11 May 2022). "libGDX 1.11.0". https://libgdx.com/news/2022/05/gdx-1-11. 
  47. damios (2 July 2023). "libGDX 1.12.0". https://libgdx.com/news/2023/07/gdx-1-12. 
  48. "Starter classes & configuration - libGDX". https://libgdx.com/wiki/app/starter-classes-and-configuration. 
  49. Zechner, Mario (5 January 2016). "libGDX 1.8.0". http://www.badlogicgames.com/wordpress/?p=3870. 
  50. Zechner, Mario (12 March 2012). "Libgdx goes HTML5". http://www.badlogicgames.com/wordpress/?p=2308. 
  51. Zechner, Mario (19 January 2013). "Reflection in libgdx's GWT backend". http://www.badlogicgames.com/wordpress/?p=2764. 
  52. Zechner, Mario (17 June 2013). "Reflection API with GWT support!". http://www.badlogicgames.com/wordpress/?p=3090. 
  53. "Using libgdx with other jvm languages". https://libgdx.com/wiki/jvm-langs/using-libgdx-with-other-jvm-languages. 
  54. "gdx-ai/README.md". 12 October 2015. https://github.com/libgdx/gdx-ai/blob/master/README.md. 
  55. "Artificial Intelligence". https://libgdx.com/wiki/extensions/artificial-intelligence. 
  56. "Gdx freetype". https://libgdx.com/wiki/extensions/gdx-freetype. 
  57. "Box2d". https://libgdx.com/wiki/extensions/physics/box2d. 
  58. "libgdx/packr: Packages your JAR, assets and a JVM for distribution on Windows, Linux and Mac OS X". https://github.com/libgdx/packr. 
  59. Zechner, Mario (4 May 2014). "Packr – pack your libGDX app for Windows, Linux, Mac OS X". http://www.badlogicgames.com/wordpress/?p=3428. 
  60. Couture, Joel (22 January 2020). "Road to the IGF: Mega Crit Games' Slay the Spire" (in en). https://www.gamasutra.com/view/news/356873/Road_to_the_IGF_Mega_Crit_Games_Slay_the_Spire.php. 
  61. "Patch notes - Wildermyth Wiki" (in en). https://wildermyth.com/wiki/Patch_notes. 

External links