https://github.com/czyzby/gdx-setup
:octocat: Alternative gdx-setup application - create your LibGDX projects with ease!
https://github.com/czyzby/gdx-setup
gdx-setup kotlin libgdx
Last synced: 5 months ago
JSON representation
:octocat: Alternative gdx-setup application - create your LibGDX projects with ease!
- Host: GitHub
- URL: https://github.com/czyzby/gdx-setup
- Owner: czyzby
- License: unlicense
- Archived: true
- Created: 2016-05-04T14:08:35.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2021-03-21T15:03:27.000Z (about 5 years ago)
- Last Synced: 2024-06-19T03:02:49.401Z (almost 2 years ago)
- Topics: gdx-setup, kotlin, libgdx
- Language: Kotlin
- Homepage: https://github.com/czyzby/gdx-setup/releases
- Size: 2.08 MB
- Stars: 126
- Watchers: 19
- Forks: 14
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
```
```
# Disclaimer
This project is no longer maintained. Please use the official LibGDX setup tool or the [gdx-liftoff](https://github.com/tommyettinger/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 in `android` 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 puts `assets` 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 to `settings.gradle` and create its directory.
### Running the application
Stable application versions are uploaded to the [releases section](https://github.com/czyzby/gdx-setup/releases).
*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
```