Merge pull request #17 from Live2D/develop

Update to Cubism 5 SDK for Java R5 beta1

Author: itoh-at-live2d-com

CHANGELOG.md

@@ -5,6 +5,29 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 
+## [5-r.5-beta.1] - 2026-01-29
+
+### Added
+
+* Add `Ren` model.
+* Add support for Blend mode and Offscreen drawing.
+  * Adapt to Framework API changes that require `CubismRendererAndroid.create()` to take window dimensions as parameters.
+* Add support for rendering portrait and landscape displays on Android.
+
+### Changed
+
+* Adapt to the Cubism SDK Framework's refactoring of hard-coded shaders into separate files.
+  * Add a class that implements the `ICubismLoadFileFunction` interface to handle file loading.
+* Change the compile and target SDK version of Android OS to 16.0 (API 36).
+  * Upgrade the version of Android Gradle Plugin from 8.6.1 to 8.9.1.
+  * Upgrade the version of Gradle from 8.7 to 8.11.1.
+
+### Fixed
+
+* Fix background image distortion when window size is changed.
+* Fix an issue in the Android sample where the model display would reset after performing certain operations.
+
+
 ## [5-r.4.1] - 2025-07-17
 
 ### Changed
@@ -199,6 +222,7 @@ Also adjust the return value of the getSpriteAlpha function.
 * New released!
 
 
+[5-r.5-beta.1]: https://github.com/Live2D/CubismJavaSamples/compare/5-r.4.1...5-r.5-beta.1
 [5-r.4.1]: https://github.com/Live2D/CubismJavaSamples/compare/5-r.4...5-r.4.1
 [5-r.4]: https://github.com/Live2D/CubismJavaSamples/compare/5-r.3...5-r.4
 [5-r.3]: https://github.com/Live2D/CubismJavaSamples/compare/5-r.2...5-r.3

Core/CHANGELOG.md

@@ -5,6 +5,50 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 
+## 2026-01-29
+
+### Added
+
+* Add Arm64 static library for iphonesimulator.
+
+
+## 2026-01-08
+
+### Changed
+
+* Upgrade Core version to 06.00.0001.
+
+### Fixed
+
+* Fix offscreen opacity calculation.
+
+
+## 2025-10-30
+
+### Removed
+
+* [Native] Remove Visual Studio 2015 (MSVC 140) static library.
+
+
+## 2025-10-14
+
+### Added
+
+* Add `csmGetMocVersion(mocBytes: ArrayBuffer)` with simplified arguments from `csmGetMocVersion(moc: Moc, mocBytes: ArrayBuffer)`. 
+  * The previous version `csmGetMocVersion(moc: Moc, mocBytes: ArrayBuffer)` is now deprecated and is planned to be removed in the future.
+
+
+## 2025-08-26
+
+### Added
+
+* Enhanced model rendering features have been added.
+
+### Changed
+
+* Upgrade Core version to 06.00.0000.
+
+
 ## 2025-07-17
 
 ### Changed
@@ -27,6 +71,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 * Fix `csmGetParameterKeyCounts()` and `csmGetParameterKeyValues()` symbols in the DLL.
 
+### Changed
+
+* Upgrade Core version to 05.01.0000.
+
 
 ## 2024-12-19
 

Framework

@@ -52,11 +52,12 @@ Sample/src/main/assets/Hiyori
 Sample/src/main/assets/Mao
 Sample/src/main/assets/Mark
 Sample/src/main/assets/Natori
+Sample/src/main/assets/Ren
 Sample/src/main/assets/Rice
 Sample/src/main/assets/Wanko
 ```
 
-If you use these models, you must agree to the terms of a contract set [here](https://docs.live2d.com/cubism-editor-manual/sample-model/) for each model.
+If you use these models, you must agree to the terms of a contract set [here](https://www.live2d.com/eula/live2d-sample-model-terms_en.html) for each model.
 
 
 ---

LICENSE.md

@@ -12,11 +12,11 @@ Cubism Java Framework および Live2D Cubism Core Javaと組み合わせて使
 本 SDK を使用する前に[ライセンス](LICENSE.md)をご確認ください。
 
 
-## Cubism 5新機能や過去バージョンとの互換性について
+## Cubism 5.3新機能や過去バージョンとの互換性について
 
-本 SDK はCubism 5に対応した製品です。
-Cubism 5 Editorに搭載された新機能のSDK対応については [こちら](https://docs.live2d.com/cubism-sdk-manual/cubism-5-new-functions/)をご確認ください。
-過去バージョンのCubism SDKとの互換性については [こちら](https://docs.live2d.com/cubism-sdk-manual/compatibility-with-cubism-5/)をご確認ください。
+本 SDK はCubism 5.3に対応した製品です。
+Cubism 5.3 Editorに搭載された新機能のSDK対応については [こちら](https://docs.live2d.com/cubism-sdk-manual/cubism-5-3-new-functions/)をご確認ください。  
+過去バージョンのCubism SDKとの互換性については [こちら](https://docs.live2d.com/cubism-sdk-manual/compatibility-with-cubism-5-3/)をご確認ください。
 
 
 ## ディレクトリ構成
@@ -71,11 +71,11 @@ Core : [CHANGELOG.md](Core/CHANGELOG.md)
 
 | 開発ツール          | バージョン            |
 |----------------|------------------|
-| Android Studio | Narwhal 2025.1.1 Patch 1 |
-| Gradle | 8.7 |
-| Android Gradle Plugin | 8.6.1 |
+| Android Studio | Otter 3 Feature Drop 2025.2.3 |
+| Gradle | 8.11.1 |
+| Android Gradle Plugin | 8.9.1 |
 | Gradle JDK | 21.0.7 |
-| Android SDK | 35.0.0 |
+| Android SDK | 36.0.0 |
 
 ## 動作確認環境
 
@@ -88,7 +88,7 @@ Core : [CHANGELOG.md](Core/CHANGELOG.md)
 | バージョン | デバイス     | エミュレーター | 16KBページサイズ *1 |
 |-------|----------|:-------:|:-------:|
 | 16    | Pixel 9  |         |    ✔︎    |
-| 15    | Pixel 7a |         |  |
+| 16    | Pixel 7a |         |  |
 | 5.0   | Pixel 7a |    ✔    |  |
 
 本サンプルアプリケーションは**Android API 21**以上のAndroidバージョンで動作します。

README.ja.md

@@ -13,11 +13,11 @@ It is used in conjunction with Cubism Java Framework and Live2D Cubism Core Java
 Please check the [license](LICENSE.md) before using this SDK.
 
 
-## Compatibility with Cubism 5 new features and previous Cubism SDK versions
+## Compatibility with Cubism 5.3 new features and previous Cubism SDK versions
 
-This SDK is compatible with Cubism 5.
-For SDK compatibility with new features in Cubism 5 Editor, please refer to [here](https://docs.live2d.com/en/cubism-sdk-manual/cubism-5-new-functions/).
-For compatibility with previous versions of Cubism SDK, please refer to [here](https://docs.live2d.com/en/cubism-sdk-manual/compatibility-with-cubism-5/).
+This SDK is compatible with Cubism 5.3.
+For SDK compatibility with new features in Cubism 5.3 Editor, please refer to [here](https://docs.live2d.com/en/cubism-sdk-manual/cubism-5-3-new-functions/).  
+For compatibility with previous versions of Cubism SDK, please refer to [here](https://docs.live2d.com/en/cubism-sdk-manual/compatibility-with-cubism-5-3/).
 
 
 ## Directory structure
@@ -71,11 +71,11 @@ Core : [CHANGELOG.md](Core/CHANGELOG.md)
 
 | Development Tools | Version |
 |-------------------|--|
-| Android Studio | Narwhal 2025.1.1 Patch 1 |
-| Gradle | 8.7 |
-| Android Gradle Plugin | 8.6.1 |
+| Android Studio | Otter 3 Feature Drop 2025.2.3 |
+| Gradle | 8.11.1 |
+| Android Gradle Plugin | 8.9.1 |
 | Gradle JDK | 21.0.7 |
-| Android SDK | 35.0.0 |
+| Android SDK | 36.0.0 |
 
 ## Operation environment
 
@@ -88,7 +88,7 @@ This sample application runs with **Java SE 7** or higher Java versions.
 | Version | Device   | Emulator | 16KB page sizes *1 |
 |---------|----------|:--------:|:--------:|
 | 16      | Pixel 9  |          |     ✔︎    |
-| 15      | Pixel 7a |          |          |
+| 16      | Pixel 7a |          |          |
 | 5.0     | Pixel 7a |    ✔     |          |
 
 This sample application runs with **Android API 21** or higher Android versions.

README.md

@@ -15,7 +15,7 @@
     <activity
       android:name=".full.MainActivity"
       android:configChanges="orientation|screenSize"
-      android:screenOrientation="sensorLandscape"
+      android:screenOrientation="fullUser"
       android:exported="true">
       <intent-filter>
         <action android:name="android.intent.action.MAIN"/>

Sample/src/full/AndroidManifest.xml

@@ -48,9 +48,7 @@ public void onStart(Activity activity) {
         LAppPal.updateTime();
     }
 
-    public void onPause() {
-        currentModel = LAppLive2DManager.getInstance().getCurrentModel();
-    }
+    public void onPause() {}
 
     public void onStop() {
         if (view != null) {
@@ -89,9 +87,13 @@ public void onSurfaceChanged(int width, int height) {
         view.initialize();
         view.initializeSprite();
 
+        // オフスクリーンのサイズ変更
+        LAppLive2DManager.getInstance().setRenderTargetSize(width, height);
+
         // load models
-        if (LAppLive2DManager.getInstance().getCurrentModel() != currentModel) {
-            LAppLive2DManager.getInstance().changeScene(currentModel);
+        LAppLive2DManager manager = LAppLive2DManager.getInstance();
+        if (manager.getModelNum() == 0) {
+            manager.changeScene(sceneIndex);
         }
 
         isActive = true;
@@ -159,6 +161,24 @@ public LAppView getView() {
         return view;
     }
 
+    /**
+     * シーンインデックスを設定する。
+     *
+     * @param index シーンインデックス
+     */
+    public void setSceneIndex(int index) {
+        sceneIndex = index;
+    }
+
+    /**
+     * シーンインデックスを取得する。
+     *
+     * @return シーンインデックス
+     */
+    public int getSceneIndex() {
+        return sceneIndex;
+    }
+
     public int getWindowWidth() {
         return windowWidth;
     }
@@ -170,11 +190,12 @@ public int getWindowHeight() {
     private static LAppDelegate s_instance;
 
     private LAppDelegate() {
-        currentModel = 0;
+        sceneIndex = 0;
 
         // Set up Cubism SDK framework.
         cubismOption.logFunction = new LAppPal.PrintLogFunction();
         cubismOption.loggingLevel = LAppDefine.cubismLoggingLevel;
+        cubismOption.loadFileFunction = new LAppPal.LoadFileFunction();
 
         CubismFramework.cleanUp();
         CubismFramework.startUp(cubismOption);
@@ -193,7 +214,7 @@ private LAppDelegate() {
     /**
      * モデルシーンインデックス
      */
-    private int currentModel;
+    private int sceneIndex;
 
     /**
      * クリックしているか