V3.8.8

[star-e]

Merge v3.8.7 into v3.8.8

Changelog

---

Continuous Integration

This pull request:

• needs automatic test cases check.

  Manual trigger with @cocos-robot run test cases afterward.

• does not change any runtime related code or build configuration

  If any reviewer thinks the CI checks are needed, please uncheck this option, then close and reopen the issue.

---

Compatibility Check

This pull request:

• changes public API, and have ensured backward compatibility with deprecated features.
• affects platform compatibility, e.g. system version, browser version, platform sdk version, platform toolchain, language version, hardware compatibility etc.
• affects file structure of the build package or build configuration which requires user project upgrade.
• introduces breaking changes, please list all changes, affected features and the scope of violation.

[github-actions]

Code Size Check Report

Wechat (WASM)	Before	After	Diff
2D Empty (legacy pipeline)	1005977 bytes	1006670 bytes	⚠️ +693 bytes
2D All (legacy pipeline)	2671067 bytes	2671992 bytes	⚠️ +925 bytes
2D All (new pipeline)	2760519 bytes	2760900 bytes	⚠️ +381 bytes
(2D + 3D) All	10016823 bytes	10017234 bytes	⚠️ +411 bytes

Web (WASM + ASMJS)	Before	After	Diff
(2D + 3D) All	16838444 bytes	16838757 bytes	⚠️ +313 bytes

Interface Check Report

! WARNING this pull request has changed these public interfaces:

@@ -53543,8 +53543,15 @@
              * @zh 用户自定材质。
              */
             get customMaterial(): Material | null;
             set customMaterial(val: Material | null);
+            /**
+             * @deprecated Since v3.8.7, it will be removed in the future.
+             * We are deprecating the `customMaterialInstance` field because it leads to shared material state across all slots,
+             * causing unexpected behavior (like the last blendMode change affecting all slots).
+             * Workaround:
+             *    Switch to customMaterial. Whenever its value is modified, immediately call updateMaterial at the exact point of change.
+             */
             get customMaterialInstance(): renderer.MaterialInstance | null;
             __preload(): void;
             /**
              * @en Gets the animation state object.