Skip to content

Latest commit

 

History

History
115 lines (69 loc) · 5.3 KB

README.ja.md

File metadata and controls

115 lines (69 loc) · 5.3 KB

English / 日本語


Cubism Java Samples

Live2D Cubism Editor で出力したモデルを表示するアプリケーションのサンプル実装です。 Cubism Java Framework および Live2D Cubism Core Javaと組み合わせて使用します。

ライセンス

本 SDK を使用する前にライセンスをご確認ください。

Cubism 5新機能や過去バージョンとの互換性について

本 SDK はCubism 5に対応した製品です。 Cubism 5 Editorに搭載された新機能のSDK対応については こちらをご確認ください。 過去バージョンのCubism SDKとの互換性については こちらをご確認ください。

ディレクトリ構成

.
├─ Core             # Live2D Cubism Core Javaが含まれるディレクトリ
├─ Framework        # レンダリングやアニメーション機能などのソースコードが含まれるディレクトリ
└─ Sample/src
  ├─ full           # フルバージョンのサンプルアプリ
  ├─ main           # full, minimumに共通するコード
     └─ assets      # モデルのファイルや画像などのリソースが含まれるディレクトリ
  └─ minimum        # 機能を減らしシンプルにしたサンプルアプリ

Cubism Java Framework

モデルを表示、操作するための各種機能を提供します。

Cubism Java Framework は、当リポジトリのサブモジュールとして含まれています。 当リポジトリをクローンした後、サブモジュールのクローンを実行することでファイルが追加されます。

Live2D Cubism Core for Java

モデルをロードするためのライブラリです。 当リポジトリには Live2D Cubism Core for Java は同梱されていません。

ダウンロードするにはこちらのページを参照ください。 ダウンロードした Zip ファイルの中身を当リポジトリの Core ディレクトリにコピーし、プログラムにリンクさせてください。

ビルド方法

本サンプルではビルドツールにGradleを採用しています。任意のIDEで開いた後プロジェクト全体のビルドを実行してください。

Android Studioでプロジェクトを開きビルドすることを推奨します。それ以外のIDEではlocal.propertiesファイルが生成されないため自分で作成する必要があります。

SDKマニュアル

Cubism SDK Manual

変更履歴

Samples : CHANGELOG.md

Framework : CHANGELOG.md

Core : CHANGELOG.md

開発環境

開発ツール バージョン
Android Studio Ladybug 2024.2.1 Patch 2
Gradle 8.2
Gradle JDK 17.0.12
Android SDK 34.0.0

動作確認環境

Java

本サンプルアプリケーションはJava SE 7以上のJavaバージョンで動作します。

Android

バージョン デバイス エミュレーター
14 Pixel 7a
5.0 Pixel 7a

本サンプルアプリケーションはAndroid API 21以上のAndroidバージョンで動作します。

プロジェクトへの貢献

プロジェクトに貢献する方法はたくさんあります。バグのログの記録、このGitHubでのプルリクエストの送信、Live2Dコミュニティでの問題の報告と提案の作成です。

フォークとプルリクエスト

修正、改善、さらには新機能をもたらすかどうかにかかわらず、プルリクエストに感謝します。メインリポジトリを可能な限りクリーンに保つために、必要に応じて個人用フォークと機能ブランチを作成してください。

バグ

Live2Dコミュニティでは、問題のレポートと機能リクエストを定期的にチェックしています。バグレポートを提出する前に、Live2Dコミュニティで検索して、問題のレポートまたは機能リクエストがすでに投稿されているかどうかを確認してください。問題がすでに存在する場合は、関連するコメントを追記してください。

提案

SDKの将来についてのフィードバックにも関心があります。Live2Dコミュニティで提案や機能のリクエストを送信できます。このプロセスをより効果的にするために、それらをより明確に定義するのに役立つより多くの情報を含めるようお願いしています。

フォーラム

ユーザー同士でCubism SDKの活用方法の提案や質問をしたい場合は、是非フォーラムをご活用ください。