GDXリフトオフ
1.13.0.0
libGDX Gradle プロジェクトのセットアップ ツール。
プロジェクトを生成するには、最新のアプリケーションjarダウンロードして実行するか (通常はダブルクリックで実行できます)、次のコマンドを手動で実行します ( VERSION適切に置き換えます)。
java -jar gdx-liftoff-VERSION.jar
Java 17 以降でビルドする必要があります。 Gradle の現在のバージョンと現在の Android ツールでは、インストールされている JDK がバージョン 17 以降である必要があります。どのプラットフォームを対象とするかに関係なく、Gradle 8.10 以降にはバージョン 17 以上の JDK が必要です。 JDK バージョン 17 以降のいずれかを使用してビルドしながら、他のリリース (通常は 8 まで) をターゲットにすることもできます。現在、Java のすべての安定したターゲット リリース 8 から 23 がここで動作します。 Gradle 8.10.2 は、すぐに Java 23 で動作するため (リリースされたばかりですが)、Gradle 8.10.2 を使用します。
何か問題がある場合は、「トラブルシューティング ガイド」をお試しください。
元のgdx-setupのほとんどの機能に加えて、 gdx-liftoffツールは以下を提供します。
プロジェクトテンプレート。さまざまな libGDX 機能を強調した多数のプロジェクト スケルトンから 1 つを選択できます。
瞬時の入力検証。プロジェクト データは、入力時に検証されます。
他の JVM 言語もサポートされています。 Kotlin や Scala など、プロジェクトに追加の言語を選択できます。標準ライブラリ、Gradle プラグイン、および適切なソース フォルダーが含まれます。
カスタマイズ。アプリケーションで使用されるソフトウェアのバージョンをより詳細に制御できるようになります。
サードパーティの拡張機能が追加されました。これらのバージョンは Maven Central または JitPack から取得されるため、プロジェクトは常に最新の状態で生成されます。
扱いにくい拡張機能の自動構成。 Artemis-ODB、Lombok、またはその他のいくつかのライブラリのセットアップに問題がある場合は、Liftoff が追加の作業を行うため、セットアップする必要はありません。
環境設定のサポート。アプリケーションの基本データは保存されるため、プロジェクトを生成するたびにデータを入力する必要はありません。
オプションの Gradle ランナー。オプションで、プロジェクト生成後に Gradle タスクを実行できます。プロジェクトを作成するために Gradle を実行する必要はありません。
すべての libGDX バックエンドをサポートします。 LWJGL2、LWJGL3、ヘッドレス バックエンドが必要ですか? Liftoff には、あらゆる公式プラットフォームとその他の特別なモジュールを追加するためのシンプルなチェックボックスが用意されています。
便利な機能。 JetBrains Toolbox をお持ちの場合は、生成したばかりのプロジェクトを 1 クリックで IDEA で開くことができます (Toolbox で「Generate Shell Scripts」を設定する必要があります)。 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 でより迅速に開くことができます (手動でインストールした IDEA を使用することもできますが、おそらく JetBrains Toolbox を使用します)。
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 { }内のブロックは意味しません。多くの場合、依存関係ブロックが 2 つあり、通常は最後のブロックが必要になります。 Liftoff で選択されたテンプレートは、これを自動的に処理します。
アプリケーションの詳しい使い方や仕組みについては、ご利用ガイドをご覧ください。プロジェクトに貢献したい場合は、アーキテクチャに関するドキュメントが役に立つかもしれません。
プル リクエストを送信するときは、 ktlintFormat Gradle タスクを使用してアプリケーションをフォーマットしてください。
プロジェクトはczyzby/gdx-setupリポジトリからフォークされました。 @czyzby と @kotcrab は、元のアプリケーションと、それが依存するライブラリのセット (それぞれgdx-lmlとVisUI ) を作成しました。それ以来、プロジェクトは @tommyettinger によって維持されています。ありがたいことに、czyzby が戻ってきて、さまざまな改善を加えてくれました。本当に感謝しています。また、現在 gdx-lml を保守している @metaphore にも感謝します (これは使用されており、今後も使用される可能性があります)。
@raeleus は、scene2d.ui のパーティクル パーク スキンを作成しました。これは、新しいプロジェクトに追加されるデフォルトのスキンとなるように調整されました ( [UI アセットの生成]オプションが選択されている場合)。 「Accademia di Belle Arti di Urbino とビジュアル デザイン修士課程の学生」は、スキンで使用されるTitillium Webフォントを作成しました (SIL OFL ライセンスに基づいて)。そうそう、彼はバージョン 1.12.1.10 から、リリースのほぼ全体など、他のこともいくつか行いました。ユーザー エクスペリエンスを全面的に見直してくれた raeleus に多大な感謝を申し上げます。
プロジェクトの他の貢献者には、@Mr00Anderson、@lyze237、@metaphore (再び!)、および @payne911 が含まれます。コードに直接貢献していない人々も、macOS や iOS などのプラットフォームでのテストに時間を費やして大いに助けてくれています。 @JojoIce は、iOS に関して変化をもたらした数人の人物のうちの 1 人です。そしてもちろん、早期に部分的に動作するリリースを我慢してくれたすべてのアーリーアダプターに多大な感謝を送ります。
Android プロジェクトに使用されるランダム化されたアイコンは、OpenMoji プロジェクトからのものです。これらのアイコンをあまり壊れていない形式で使用したい場合は、libGDX からこれらの絵文字に簡単にアクセスできる openmoji-atlas があります。
Liftoff が依存するさまざまなライブラリやツールを作成した皆さんにも感謝します。 Graal Native Image を担当する大規模なチームから、ほぼ 1 人のチームによる Construo まで、Liftoff の最高の機能のいくつかは Liftoff コードにはまったく含まれていません。
頑張ってください。素晴らしいものを作っていただけることを願っています。
