Merge pull request #19 from Live2D/develop

Update to Cubism 5 SDK for Java R5

Author: itoh-at-live2d-com

CHANGELOG.md

@@ -5,11 +5,35 @@ 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] - 2026-06-04
+
+### Changed
+
+* Migrate system bar hiding in `MainActivity` and `MainActivityMinimum` classes from deprecated `setSystemUiVisibility()` to `WindowInsetsControllerCompat`.
+* Reorganize lifecycle methods in the `LAppDelegate` and `LAppMinimumDelegate` classes to reliably reconstruct rendering resources on GL surface recreation.
+* Change motion calculation order in `LAppModel` and `LAppMinimumModel` classes to be performed by `CubismUpdateScheduler` class with per-feature Updaters.
+* Change `LAppModel` and `LAppMinimumModel` classes to configure parameter IDs and settings for target tracking via `CubismLook` class.
+* Change `LAppWavFileHandler` class to implement the `IParameterProvider` interface.
+
+### Fixed
+
+* Fix collision detection misalignment in split-screen mode.
+* Fix app state reset when entering split-screen mode.
+* Fix the model being clipped by system bars in the Minimum sample app on Android 15 or later.
+* Fix an issue in the Android sample where shaders were rebuilt every time the app returned to the foreground.
+* Unify remaining uses of `OffscreenSurface` in comments to `RenderTarget`.
+* Fix missing resource release in `close()` method of the `LAppView` and `LAppMinimumView` classes.
+* Fix incorrect debug log output when tapping the body hit area of the model.
+* Fix the bug where Y-axis coordinate transform methods incorrectly used X-axis methods in the `LAppView` and `LAppMinimumView` classes.
+* Fix an issue where `PREMULTIPLIED_ALPHA_ENABLE` flag was not applied to texture loading in the `LAppTextureManager` and `LAppMinimumTextureManager` classes.
+* Fix an issue where `PREMULTIPLIED_ALPHA_ENABLE` flag was not referenced for renderer premultiplied alpha setting in the `LAppMinimumModel` class.
+
+
 ## [5-r.5-beta.1.1] - 2026-02-19
 
 ### Fixed
 
-* Fix some problems related to rendering and clipping mask. 
+* Fix some problems related to rendering and clipping mask.
   * See `CHANGELOG.md` in Framework.
 
 
@@ -230,6 +254,7 @@ Also adjust the return value of the getSpriteAlpha function.
 * New released!
 
 
+[5-r.5]: https://github.com/Live2D/CubismJavaSamples/compare/5-r.5-beta.1.1...5-r.5
 [5-r.5-beta.1.1]: https://github.com/Live2D/CubismJavaSamples/compare/5-r.5-beta.1...5-r.5-beta.1.1
 [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

Framework

@@ -71,11 +71,11 @@ Core : [CHANGELOG.md](Core/CHANGELOG.md)
 
 | 開発ツール          | バージョン            |
 |----------------|------------------|
-| Android Studio | Panda 1 2025.3.1 Patch 1 |
+| Android Studio | Panda 4 2025.3.4 Patch 1 |
 | Gradle | 8.11.1 |
 | Android Gradle Plugin | 8.9.1 |
 | Gradle JDK | 21.0.7 |
-| Android SDK | 36.0.0 |
+| Android SDK Platform | 36.0 |
 
 ## 動作確認環境
 
@@ -85,11 +85,12 @@ Core : [CHANGELOG.md](Core/CHANGELOG.md)
 
 ### Android
 
-| バージョン | デバイス     | エミュレーター | 16KBページサイズ *1 |
-|-------|----------|:-------:|:-------:|
-| 16    | Pixel 9  |         |    ✔︎    |
-| 16    | Pixel 7a |         |  |
-| 5.0   | Pixel 7a |    ✔    |  |
+| API レベル | デバイス     | 16KBページサイズ *1 |
+|---------|----------|:-------------:|
+| 36      | Pixel 9  |      ✔︎       |
+| 36      | Pixel 7a |               |
+
+※ エミュレーターは API 21 / 36 で動作確認済み
 
 本サンプルアプリケーションは**Android API 21**以上のAndroidバージョンで動作します。
 *1 開発者向けオプションを使用して有効にした環境となります

README.ja.md

@@ -71,11 +71,11 @@ Core : [CHANGELOG.md](Core/CHANGELOG.md)
 
 | Development Tools | Version |
 |-------------------|--|
-| Android Studio | Panda 1 2025.3.1 Patch 1 |
+| Android Studio | Panda 4 2025.3.4 Patch 1 |
 | Gradle | 8.11.1 |
 | Android Gradle Plugin | 8.9.1 |
 | Gradle JDK | 21.0.7 |
-| Android SDK | 36.0.0 |
+| Android SDK Platform | 36.0 |
 
 ## Operation environment
 
@@ -85,11 +85,12 @@ This sample application runs with **Java SE 7** or higher Java versions.
 
 ### Android
 
-| Version | Device   | Emulator | 16KB page sizes *1 |
-|---------|----------|:--------:|:--------:|
-| 16      | Pixel 9  |          |     ✔︎    |
-| 16      | Pixel 7a |          |          |
-| 5.0     | Pixel 7a |    ✔     |          |
+| API Level | Device   | 16KB page sizes *1 |
+|-----------|----------|:------------------:|
+| 36        | Pixel 9  |         ✔︎         |
+| 36        | Pixel 7a |                    |
+
+Note: The emulator has been tested with API 21 / 36.
 
 This sample application runs with **Android API 21** or higher Android versions.
 *1 This environment has been enabled using developer options.

README.md

@@ -14,7 +14,7 @@
     android:theme="@android:style/Theme.NoTitleBar">
     <activity
       android:name=".full.MainActivity"
-      android:configChanges="orientation|screenSize"
+      android:configChanges="orientation|screenSize|screenLayout|smallestScreenSize"
       android:screenOrientation="fullUser"
       android:exported="true">
       <intent-filter>

Sample/src/full/AndroidManifest.xml

@@ -12,6 +12,7 @@
 import android.os.Build;
 import com.live2d.demo.LAppDefine;
 import com.live2d.sdk.cubism.framework.CubismFramework;
+import com.live2d.sdk.cubism.framework.rendering.android.CubismShaderAndroid;
 
 import static android.opengl.GLES20.*;
 
@@ -40,27 +41,23 @@ public void deactivateApp() {
     }
 
     public void onStart(Activity activity) {
-        textureManager = new LAppTextureManager();
-        view = new LAppView();
-
         this.activity = activity;
-
-        LAppPal.updateTime();
+        isActive = true;
     }
 
     public void onPause() {}
 
-    public void onStop() {
+    public void onStop() {}
+
+    public void onDestroy() {
         if (view != null) {
             view.close();
         }
         textureManager = null;
 
         LAppLive2DManager.releaseInstance();
         CubismFramework.dispose();
-    }
 
-    public void onDestroy() {
         releaseInstance();
     }
 
@@ -73,8 +70,33 @@ public void onSurfaceCreated() {
         GLES20.glEnable(GLES20.GL_BLEND);
         GLES20.glBlendFunc(GL_ONE, GL_ONE_MINUS_SRC_ALPHA);
 
-        // Initialize Cubism SDK framework
-        CubismFramework.initialize();
+        if (textureManager == null) {
+            textureManager = new LAppTextureManager();
+        } else {
+            // 無効になっているテクスチャ情報を破棄
+            textureManager.releaseInvalidTextures();
+        }
+
+        if (view != null) {
+            view.close();
+        }
+        view = new LAppView();
+
+        LAppPal.updateTime();
+
+        if (!CubismFramework.isInitialized()) {
+            CubismFramework.initialize();
+        }
+
+        // 無効になっているOpenGLリソースを破棄
+        CubismShaderAndroid.getInstance().releaseInvalidShaderProgram();
+        // シェーダコードを再読み込みするためにインスタンスを破棄しておく
+        CubismShaderAndroid.deleteInstance();
+
+        LAppLive2DManager live2DManager = LAppLive2DManager.getInstance();
+        for (int i = 0; i < live2DManager.getModelNum(); i++) {
+            live2DManager.getModel(i).reloadRenderer();
+        }
     }
 
     public void onSurfaceChanged(int width, int height) {
@@ -89,14 +111,6 @@ public void onSurfaceChanged(int width, int height) {
 
         // オフスクリーンのサイズ変更
         LAppLive2DManager.getInstance().setRenderTargetSize(width, height);
-
-        // load models
-        LAppLive2DManager manager = LAppLive2DManager.getInstance();
-        if (manager.getModelNum() == 0) {
-            manager.changeScene(sceneIndex);
-        }
-
-        isActive = true;
     }
 
     public void run() {

Sample/src/full/java/com/live2d/demo/full/LAppDelegate.java

@@ -186,7 +186,7 @@ public void onTap(float x, float y) {
             // 体をタップした場合ランダムモーションを開始する
             else if (model.hitTest(HitAreaName.BODY.getId(), adjustedX, adjustedY)) {
                 if (DEBUG_LOG_ENABLE) {
-                    LAppPal.printLog("hit area: " + HitAreaName.HEAD.getId());
+                    LAppPal.printLog("hit area: " + HitAreaName.BODY.getId());
                 }
 
                 model.startRandomMotion(MotionGroup.TAP_BODY.getId(), Priority.NORMAL.getPriority(), finishedMotion, beganMotion);