Awesome
Disclaimer
This project is no longer maintained. Please use the official LibGDX setup tool or the gdx-liftoff application instead, which is an updated fork of this project.
gdx-setup
This project was meant to be a replacement for the official gdx-setup
application.
Additionally to supporting most official gdx-setup
features, you might want to consider switching because of:
- Project templates. You can choose the initial generated sources of the project - you're no longer forced to use
ApplicationAdapter
and BadLogic logo. (No offence, guys!) - Input validation. Your project data is validated as you type it in.
- Other JVM languages support. You can choose additional languages for your project - their runtime libraries, Gradle plugins and source folders will be included.
- Assets folder is now in the root directory and is properly linked by all projects. No more missing resources for the desktop project.
- Much more settings. You have more control over the versions of software used by your application.
- More third-party extensions. Much, much more.
- Preferences, favorites. Basic data of your application is saved, so you don't have to fill it each time you generate a project. File chooser allows you to add your "favorite" workspace folders.
- Internationalization. The application can be translated to different languages. It's currently available in English and Polish.
- Gradle wrapper and running Gradle tasks after generation is entirely optional. This can significantly speed up the generation process and limit the project size if you'd prefer to use a globally installed Gradle application.
- There are no major structural differences between any generated projects, regardless of the platforms
you initially used. Official
gdx-setup
puts assets inandroid
or - if Android platform is not supported -core
folders. If you don't start with the Android platform, adding it to an existing project would require a lot of moving around and modifying Gradle scripts. Usually you'd be better off just generating a new project and moving the code. On contrary, this application putsassets
in the root folder - adding a new platform to an existing application never requires you to modify any of the other platforms, you just have to add the new project tosettings.gradle
and create its directory.
Running the application
Stable application versions are uploaded to the releases section.
Pro tip: check the Generate skin assets
option in Advanced
tab and Desktop
in Platforms
tab.
Enter pack desktop:run --daemon
Gradle tasks in Advanced
tab. Delete project directory with the trash icon
after each run. Now you can easily test all project templates one by one. Find the one that suits you best.
Running from sources
git clone https://github.com/czyzby/gdx-setup.git
cd gdx-setup
gradle run