GDX 이륙
1.13.0.0
libGDX Gradle 프로젝트용 설정 도구입니다.
프로젝트를 생성하려면 최신 애플리케이션 jar 다운로드하여 실행하거나(보통 두 번 클릭하면 됨) 다음 명령을 수동으로 실행합니다( VERSION 적절하게 교체).
자바 -jar gdx-liftoff-VERSION.jar
Java 17 이상으로 빌드해야 합니다! Gradle의 현재 버전과 현재 Android 도구를 사용하려면 이제 설치된 JDK가 버전 17 이상이어야 합니다. 어떤 플랫폼을 대상으로 하든 Gradle 8.10 이상에는 버전 17 이상의 JDK가 필요합니다! JDK 버전 17 이상을 사용하여 빌드하는 동안 일반적으로 8만큼 낮은 다른 릴리스를 대상으로 할 수 있습니다. 이제 8부터 23까지의 모든 안정적인 Java 대상 릴리스가 여기에서 작동합니다. 우리는 Gradle 8.10.2를 사용합니다. Java 23과 함께 기본적으로 작동하기 때문입니다(방금 출시되었음에도 불구하고!).
문제가 있는 경우 '문제 해결 가이드'를 시도해 보세요.
원래 gdx-setup 의 대부분 기능 외에도 gdx-liftoff 도구는 다음을 제공합니다.
프로젝트 템플릿. 다양한 libGDX 기능을 강조하는 많은 프로젝트 뼈대 중 하나를 선택할 수 있습니다.
즉각적인 입력 검증. 프로젝트 데이터는 입력과 동시에 검증됩니다.
기타 JVM 언어 지원. Kotlin 또는 Scala와 같은 프로젝트에 대한 추가 언어를 선택할 수 있습니다. 표준 라이브러리, Gradle 플러그인 및 적절한 소스 폴더가 포함됩니다.
맞춤화. 애플리케이션에서 사용되는 소프트웨어 버전을 더 효과적으로 제어할 수 있습니다.
더 많은 타사 확장 기능. 해당 버전은 Maven Central 또는 JitPack에서 가져오므로 프로젝트는 항상 최신 상태로 생성됩니다.
까다로운 확장을 위한 자동 구성. Artemis-ODB, Lombok 또는 기타 여러 라이브러리를 설정하는 데 문제가 있는 경우 Liftoff가 추가 작업을 수행하므로 그럴 필요가 없습니다.
환경설정이 지원됩니다. 애플리케이션의 기본 데이터는 저장되므로 프로젝트를 생성할 때마다 입력할 필요가 없습니다.
선택적 Gradle 실행기. 프로젝트 생성 후 선택적으로 Gradle 작업을 실행할 수 있습니다. 프로젝트를 생성하기 위해 Gradle을 실행할 필요는 없습니다.
모든 libGDX 백엔드를 지원합니다. LWJGL2, LWJGL3 및/또는 헤드리스 백엔드가 필요합니까? Liftoff는 모든 공식 플랫폼과 일부 특수 모듈을 추가할 수 있는 간단한 확인란을 제공합니다.
편의 기능. JetBrains Toolbox가 있는 경우 클릭 한 번으로 IDEA에서 방금 생성한 프로젝트를 열 수 있습니다(Toolbox에 설정된 "쉘 스크립트 생성" 필요). Eclipse를 사용하는 경우 Gradle 프로젝트를 정상적으로 가져올 수 있습니다.
최신. 이 프로젝트는 Gradle이나 libGDX 자체와 같은 주요 외부 구성 요소가 출시된 후 빠르게 업데이트되는 것을 자랑스럽게 생각합니다.
더 많은 백엔드가 지원됩니다. 헤드리스 백엔드는 오랫동안 libGDX의 일부였지만 gdx-setup에서는 쉽게 액세스할 수 없었습니다. 여기 체크박스가 있습니다. 브라우저 기반 애플리케이션용 GWT의 대안으로 점점 더 인기를 얻고 있는 TeaVM도 여기에 있으며 Java뿐만 아니라 Kotlin 및 기타 JVM 언어에서도 작동합니다.
즉시 사용 가능한 기본 실행 파일을 빌드하세요. Construo 플러그인을 사용하면 프로젝트의 JAR로 JDK를 어셈블하고 기본 Win64 .exe, MacOS(x64 또는 AARCH64) .app 또는 Linux x64 실행 파일로 시작할 수 있습니다. Graal Native Image에 대한 구성도 포함되어 있지만 즉시 "작동"할 가능성은 낮습니다.
영상을 좋아하시는 분들을 위해 @raeleus가 이 튜토리얼 영상을 제작했습니다.
텍스트를 읽고 싶다면 여기로 가세요...
Gdx-Liftoff는 비교적 간단한 GUI 애플리케이션입니다.
프로젝트 이름/패키지/메인 클래스 이름을 입력하세요.
프로젝트 옵션을 클릭합니다.
원하는 옵션(추가 플랫폼, 비Java 언어, 공식 확장 및/또는 템플릿)을 선택하세요.
다음을 클릭하세요.
추가하려는 타사 확장 프로그램을 선택합니다.
다음을 클릭하세요.
프로젝트 경로를 입력하고 선택적으로 Java 버전을 변경합니다(예: 더 나은 iOS 지원을 위해 8로).
생성을 클릭하고 마법이 일어나도록 하세요.
그런 다음 지정한 경로에서 프로젝트를 열거나 Liftoff에서 볼 수 있는 방식으로 설치된 경우 IDEA에서 더 빠르게 열 수 있습니다(대개는 JetBrains Toolbox를 사용하지만 수동으로 설치된 IDEA도 사용할 수 있음).
Kotlin을 사용하려면 Kotlin 템플릿(예: Kotlin Logo )을 사용하는 것이 좋습니다. 설명에 "Kotlin 런처"를 사용한다고 언급되어 있습니다. KTX 라이브러리는 모두 타사 확장으로 사용할 수 있습니다. Kotlin 프로젝트에는 필수 사항은 아니지만 도움이 될 수 있습니다. KTX 및 기타 Kotlin 기반 라이브러리에는 Kotlin을 활성화해야 합니다. 현재 여기에서 생성된 프로젝트는 기본적으로 Kotlin 2.0.21을 사용하므로 이전 1.9.x 릴리스와 일부 비호환성이 있을 수 있습니다. 대신 Kotlin을 옵션으로 선택하면 언어 대화 상자에서 버전을 최신 1.9.x 릴리스(현재 1.9.25)로 설정할 수 있습니다. 그러나 2.x 시리즈 릴리스에서는 여러 가지 뛰어난 개선이 이루어졌다고 주장하며 대부분의 라이브러리는 호환에 매우 가깝거나 이미 호환되는 것으로 보입니다. Liftoff 자체는 Kotlin 2.x와 상당한 Java 코드(Java 8과 호환 가능)를 사용하여 구축되었습니다.
Liftoff 프로젝트에서는 gdx-setup 프로젝트와 비교하여 일부 항목이 다르게 구성되어 있습니다. gdx-setup이 android 또는 html 과 같은 하위 프로젝트를 포함하여 거의 모든 구성을 /build.gradle (프로젝트 루트에 있음)에 저장하는 반면, Liftoff는 루트 build.gradle 에 공유 구성만 배치하고 사용자가 구성할 수 있는 모든 버전 정보를 /gradle.properties 에 유지합니다. /gradle.properties , 프로젝트별 구성을 /core/build.gradle , /android/build.gradle , /html/build.gradle 등으로 이동합니다. 또한 Liftoff는 LWJGL3 lwjgl3 에 의존하는 프로젝트를 호출합니다. LWJGL2에 의존하는 프로젝트이며 이름은 lwjgl2 입니다. "데스크탑" 모듈(gdx-setup이 LWJGL3을 호출함)에 대한 참조를 lwjgl3 으로 변경해야 할 수도 있습니다. 왜냐하면 이것이 사용하게 될 가능성이 가장 높은 데스크탑 모듈이기 때문입니다.
build.gradle 파일에 종속성을 추가하는 경우 루트의 /build.gradle 이 아닌 /core/build.gradle 에 종속성을 추가해야 할 수 있습니다. 일부 종속성은 /lwjgl3/build.gradle , /html/build.gradle 등에 부분을 추가해야 할 수도 있습니다. 라이브러리에서 종속성 섹션에 줄을 추가하라고 하면 거의 항상 dependencies { } 내부의 블록을 의미하지만 buildscript { } 내부의 블록 은 의미하지 않습니다 . 두 개의 종속성 블록이 있는 경우가 많으며 일반적으로 마지막 블록을 원합니다. Liftoff에서 선택한 템플릿은 이를 자동으로 처리합니다.
애플리케이션 사용 방법 및 작동 방식에 대한 자세한 내용은 사용 가이드를 참조하세요. 프로젝트에 기여하고 싶다면 아키텍처 문서가 도움이 될 수 있습니다.
풀 요청을 제출할 때 ktlintFormat Gradle 작업으로 애플리케이션 형식을 지정하세요.
프로젝트가 czyzby/gdx-setup 저장소에서 분기되었습니다. @czyzby와 @kotcrab은 원본 애플리케이션과 이에 의존하는 라이브러리 세트(각각 gdx-lml 및 VisUI )를 만들었습니다. 그 이후로 프로젝트는 @tommyettinger에 의해 유지 관리됩니다. 다행히도 czyzby가 돌아와서 다양한 개선을 이루었습니다. 정말 감사드립니다! 현재 gdx-lml을 유지 관리하는 @metaphore에게도 감사드립니다(이것이 사용되었고 앞으로도 계속 사용될 수 있습니다).
@raeleus는 scene2d.ui용 Particle Park 스킨을 만들었습니다. 이 스킨은 새 프로젝트에 추가된 기본 스킨으로 조정되었습니다( "UI 자산 생성" 옵션이 선택된 경우). "Accademia di Belle Arti di Urbino와 시각 디자인 석사 과정 학생"은 스킨이 사용하는 Titillium 웹 글꼴을 만들었습니다(SIL OFL 라이선스에 따라). 아, 그리고 그는 버전 1.12.1.10부터 거의 전체 릴리스 와 같은 다른 작업도 수행했습니다. 사용자 경험을 완벽하게 점검한 raeleus에게 큰 감사를 드립니다!
다른 프로젝트 참여자로는 @Mr00Anderson, @lyze237, @metaphore(역시!) 및 @payne911이 있습니다. 코드에 직접 기여하지 않은 사람들도 macOS 및 iOS와 같은 플랫폼에서 테스트하는 데 시간을 투자하여 여전히 많은 도움을 받았습니다. @JojoIce는 iOS에 변화를 가져온 여러 사람 중 한 명입니다. 물론, 부분적으로 작동하는 릴리스를 초기에 참아준 모든 얼리 어답터들에게도 많은 감사를 드립니다!
Android 프로젝트에 잘려서 사용되는 무작위 아이콘은 OpenMoji 프로젝트에서 가져온 것입니다. 이러한 아이콘을 덜 복잡한 형식으로 사용하려면 libGDX에서 이러한 이모티콘에 편리하게 액세스할 수 있는 openmoji-atlas가 있습니다.
Liftoff가 의존하는 다양한 라이브러리와 도구를 만든 모든 분들께도 감사드립니다. Graal Native Image를 담당하는 대규모 팀부터 거의 한 팀으로 이루어진 Construo에 이르기까지 Liftoff의 최고의 기능 중 일부는 Liftoff 코드에 전혀 없습니다.
행운을 빕니다. 멋진 일을 해보시길 바랍니다!
