Cocos Creator 3.8.8 更新说明

 

 

引擎更新 (Engine)

新功能

Cocos Creator 3.8.7 更新说明

引擎

 

新功能

• 2D 渲染排序。PR PR

Sorting Layer 复用 3D 渲染层定义面板，可以在“项目设置”->“Sorting Layers” 中配置 Sorting Layer 列表，Sorting Layer 的优先级比 Sorting Order 更高。Sorting Order 为整型，默认为 0，值范围 -32768~32767。Layer 相同，Sorting Order 值越低，越先渲染。

注意：2D 渲染队列中遇到 Mask 渲染器会立即执行当前 2D 渲染队列中的所有渲染器。

• 添加 Global Uniform 支持。PR PR PR PR
• 添加模块条件控制功能。PR
• 为左下角 Profile 面板添加半透背景。PR
• 为新管线添加 Global Uniform 的设置接口。PR
• 添加 Tween.bindNodeState(v: boolean) 接口，用于控制 Tween 的 pause/resume/stop 状态是否自动关联到 Node active/inactive/destroy 状态，默认关联，传入 false 可禁用关联。PR
• 添加 AnimationManager 的 animationStates 获取器: PR
• 添加 Profiler.setBackgroundColor API: PR
• 添加 Profiler.setFontColor API: PR
• 构建时可以选择合并 AnimationClip 文件, 减少文件数量, 提升加载速度: PR

• JSVM 支持通过浏览器进行调试: PR

• 新增2D管线自定义功能（实验性质）：PR PR PR

• 新增Global uniform功能：PR PR

• 新增mipmap filter Bloom效果：PR PR

• spine attachment支持多region：PR

• 在组件菜单中新增地形组件: PR

• OpenHarmony 鼠标键盘适配: PR

• 允许在 ark 平台使用 postMessage 和 postSyncMessage：PR

• 【Breaking change】bloom添加了intensity参数。3.8.4~3.8.6 升级上来的用户需要将参数从2.3设置回1.0
• 使用 `PROP_ENABLE_COMPRESS_SO` 控制 Android 构建输出中是否压缩动态库：PR

优化

• 同步 Spine 仓库 3.8 分支的最新改动。PR ，若出现引擎低版本能显示，该版本不能显示可能需要升级Spine 资源,Spine 官方新代码要求Slot需要有对应的Attachment，否则会解析失败。
• 添加 Spine wasm 的生成说明文档。PR
• 为 Spine 4.2 绑定缺失的一些属性。PR
• 构建后文件后缀为 .cconb 的修改为 .bin, 以防止部分平台禁止 cconb 后缀文件。PR
• 编译模拟器的命令支持生成 Spine 3.8 或者 Spine 4.2 的模拟器。PR
• 改进预览检查器: PR
• 统一构建后动画文件格式, 减少动画文件数量, 提高加载速度 PR
• 为 XR 和 vendor-google 添加环境条件判断: PRPR
• 为 ModelBakeSettings 实现工具提示描述: PR
• 移除未使用的属性 UIRenderer._renderDataFlag: PR
• 优化 Rich Text 包体大小：PR
• 优化支付宝小游戏的适配层代码集成方式：PR

• 重构 worker-ui 通信: PR

• 提升 Baked 骨骼动画的性能: PR

• 为 Spine Skeleton 在原生与 Web 实现中暴露 skin 属性及 setSkin 方法接口: PR

• 将 XR 移至末端: PR

• 更新 Spine 4.2 Runtime 到 4.2.80: PR

• 兼容旧动画格式：PR
• JSVM 优化：PR

• 支持Vulkan 1.4 SDK：PR
• 平滑处理特效中 2D 坐标系的差异：PR

修复

 

• 修复浮点数比较问题: PR
• 修复原生平台上大部分 UIOpacity 问题，优化本地透明度同步到原生端的逻辑: PR
• 修复 Spine 中因旋转使用不当导致的渲染异常: PR
• 修复 3D 粒子使用压缩纹理时的效果错误: PR
• 解决 Web 平台 Spine 运行时可能的内存溢出(OOM)问题: PR
• 修复 CI 中的 emsdk 缓存错误: PR
• 使预览缩放效果与场景保持一致: PR
• 修复 Box2D-JSB 中未绑定的 b2ChainShape::m_vertices 和 b2PolygonShape::m_vertices/m_normals 属性: PR
• 在 iOS 12.0 上回退 maxKnownFeatureSet: PR
• 修复组件移除后因未注销事件导致的内存泄漏: PR
• 修复 Android 平台因 getViewSize 调用导致的崩溃问题: PR
• 修复字节跳动平台 'onWindowResize' 回调中获取过时 systemInfo 的问题: PR
• 修复瓦片渲染模式下精灵无法动态合批的问题: PR
• 更新微信模板中的 libVersion 值: PR
• 修复 HarmonyOS-Next 平台频繁隐藏/显示窗口时可能导致的崩溃问题: PR
• 预制体预览支持切换功能: PR
• 修复渲染 rt 纹理精灵无法合批绘制的问题: PR
• 为富文本添加 UITransform 组件依赖: PR
• 移除设置 SpriteFrame 时查询自动图集的代码: PR
• 修复实例化时忽略带有挂载子节点的节点副本的问题: PR
• 修复删除编辑场景中使用的 spine 资源可能导致 JS 异常的问题: PR
• 添加更严格的 renderdata 有效性检查代码: PR
• 修复原生平台上使用旧管线，启动的时候导致的一个内存泄露问题：PR
• 修复原生平台上使用 physx 物理后端，转换 C++ std::vector<CharacterControllerContact> 和 std::vector<ContactPoint> 为 JS Array 的初始大小不对的问题：PR
• 修复新管线编译 release 包，开启 Profile 无法生效的问题：PR1, PR2,PR3
• 为 copy-pass.effect 移除不必要的 Global Uniforms：PR
• 修复 HarmonyOS Next 平台上，选用 ARK Runtime 导致的内存泄露问题：PR1, PR2
• 修复平行光组件 csmTransitionRange 属性的范围错误：PR
• 修复 GPU instancing 排序问题：PR
• 修复 Camera.convertToUINode 无法在 start 回调中生效的问题：PR
• 修复 Spine 4.2 TrackCompleteListener 不能收到回调，以及 Spine 3.8 TrackCompleteListener 不同动画只能回调一次的问题。由于 Spine 4.2 C++ 代码调整了spine.EventType 的枚举值，Spine 3.8 同步了 Spine 4.2 enum 对应的修改，导致 TS 层也需要调整，这个修改破坏了 spine.EventType 枚举数值的兼容性。如果项目中有直接使用`数字`判断 EventType 而不是使用枚举 EventType.dispose/complete，那么需要做对应调整，建议不要直接使用`数字`，避免后续带来兼容问题：PR
• 修复 Xcode 16.3 导致的 iOS/macOS 平台上的编译报错问题：PR
• 修复 bullet wasm 漏绑定 CollisionShape_getLocalBoundingSphere 接口的问题：PR
• 修复 Box2D JSB 漏绑定 normalImpulses/tangentImpulses 属性的问题：PR
• 修复预加载 Texture2D 或 SpriteAtlas 失败的问题：PR
• 修复原生平台上在 schedule 回调中销毁带 sp.Skeleton 组件的节点导致的崩溃问题：PR
• 为 Renderer.setSharedMaterial 添加 forceUpdate 参数， 解决 3.8.6 引入的传递相同 material 对象不更新的问题：PR
• 修复 preload 预加载 Texture2D, Altas 资源失败的问题：PR
• 修复 spine 导出 jpeg 图片资源，原生平台上加载导致的崩溃问题：PR
• 修复原生平台上禁用启用 2D 粒子节点导致 C++ 层内存越界崩溃问题：PR
• 修复 Google Play API 没有代码提示的问题：PR，PR
• 修复 box2d-wasm/box2d-jsb 后端中 physics-contact.ts 的逻辑异常：PR
• 修复未勾选 DragonBones 模块，在模拟器中运行报错的问题：PR
• 修复 HarmonyOS Next 平台文件读取相关的问题：PR
• 修复 Spine setTrackEndListener 无法被正常回调的问题：PR
• 修复 Spine setSlotTexture createNew 为true不能正常设置以及存在内存泄漏的问题， PR

• 修复调用 ark 函数时未传递参数导致报错的问题: PR

• 修复Metal/Vulkan 平台获取先前 Graphics 绘制内容的问题: PR

• 修复 Bullet Physics 的内存越界访问问题: PR

• 修复 spine.setCompleteListener 在原生平台使用 shared_cache 缓存模式时不触发回调的问题: PR

• 修复3D 粒子使用 uimeshrender 显示时会闪烁的问题: PR

• 修复 Spine 批处理功能在原生平台未正常工作的问题: PR

• 修复 Mask 嵌套显示异常的问题: PR

• 修复在批量合并过程中未恢复 ibCount 导致重复渲染的问题: PR

• 调整 AnimationEventType 与 Spine C++ 的 EventType 更新保持一致: PR

• 修复 Tilemap 窗口调整大小时纹理地图偏移的问题: PR

• 修复重启 WebGPU 时的黑屏问题: PR

• 修复 2D Chunk 为 null 导致持续报错的问题: PR

• 修复加载 2D 粒子时删除节点会报错的问题: PR

• 为抖音平台更新了 game.ejs 文件: PR

• 为 OpenHarmony 添加支持 avplayer 播放应用沙盒内的文件: PR

• 修复渲染多个 Tilemap 时不显示的问题: PR

• 修复当某些 UI 组件被显示或隐藏时中断批处理的问题: PR

• 修复由于使用错误的 AttachmentVertices 导致显示异常的问题: PR

• 修复 Spine 4.2 中 setSlotTexture 使用 createNew: true 时影响其他实例并导致渲染异常的问题: PR

• 修复 Spine Vector 的 setSize 和 std::vector 的 resize 行为不一致的问题, 该问题导致 Spine Vector 提前分配额外的空间: PR

   

• 修复在自定义渲染管线下 gizmo 不显示的问题：PR
• 修复新版微信小游戏 IDE 报错：readFile:fail 参数检查失败的问题：PR
• 在 HarmonyOS Next 平台上将 Creator 2.x 的代码同步到 Creator 3.x：PR
• 在 chunk 中预分配额外空间，避免因顶点数量波动频繁重新分配内存：PR
• 重命名动画烘焙采样率（Animation Bake Sample Rate）：PR
• 修复 Native 模式中跳转场景时节点被销毁但仍监听事件的问题：PR
• 修复淘宝平台函数因类型检查缺失而报错的问题：PR
• 标记 spine 中 customMaterialInstance 字段为弃用状态，并提供迁移方案：PR
• 修复 HarmonyOS-Next 平台的 stopvideo 事件问题：PR
• 修复 spine 中调用 setSlotTexture 且 createAttachment 设置为 true 时纹理替换失败的问题：PR
• 修复 setSlotTexture 在不同 skeletonData 附件间不工作的问题：PR
• 修复Bloom mipmap预览：PR
• 修复原生 copy pass 内存溢出的问题：PR 

• 修复 HarmonyOS 平台上 Promise 的相关问题：PR
• 将 evalString 修改为线程安全函数：PR
• 修复视频播放进度异常的问题：PR
• 添加 `_DISABLE_CONSTEXPR_MUTEX_CONSTRUCTOR` 以避免崩溃：PR
• 修复 box2d 模块导出问题：PR
• 在 addDraw2D 中添加 camera UBO 支持：PR
• 修复：确保 atlasFileFilter 为有效值：PR
• 修复 HarmonyOS Next 平台无法显示字体颜色和视频播放结束后无法重播的问题：PR
• 修复在原生平台设置下窗口缩放时，由反射探针引起的屏幕拉伸问题：PR
• 修复属性的国际化（i18n）显示缺失问题：PR
• 修复自定义渲染管线窗口缩放内存泄漏：PR
• 修复 JSVM 调试日志中缺失的端口信息：PR
• 修复未传递目标参数时的回调问题：PR
• 修复旧管线预览新管线effect时报错的问题：PR
• 使用实例化（Instancing）动画时出现相同问题的修复：PR

编辑器

新功能

 

• 新增了【意见反馈】面板，通过【菜单-帮助-意见反馈】 可以启动

• 抖音平台支持引擎分离
• 构建支持动画文件的 cconb 的合并，可以减少动画文件数量和优化加载速度，可以在构建配置内开启

• 层级管理现在显示节点的时候，带有用户脚本的的节点会有图标显示

• 实验室功能新增多 tab 编辑功能，现在可以在不同的 tab 页签编辑不同的 scene、prefab，也可以在 偏好设置->实验室->启用多场景编辑 中关闭。

 

• 默认关闭 asset-db 的资源缓存实验室功能

优化

• 新增“启动编辑器时从缓存中恢复数据库”的实验室选项，默认开启。项目第一次升级时选项默认无效，之后打开项目直接从缓存恢复内存数据不重新导入，保守可以优化 50% 左右的资源导入时间，项目越大效果越明显。开启后如遇到问题可以在论坛上反馈给我们，也可以暂时关闭选项绕过。

• 构建配置面板支持拖动配置属性显示宽度
• 优化资源管理器内查找 UUID 的使用功能，支持所有资源类型查询包括脚本之前的互相依赖
• 调整吸附与摄像机漫游快捷键提示逻辑
• 完善 Spine 与 预制预览功能
• 添加预制体预览开关到实验室
• 优化 2d 视图滚动速度效果
• 优化中心轴线条逻辑
• 调整 position gizmo 蓝框的 z 轴，让他优先被检测，减少误操作的可能性
• quick compile 编译模块自动剔除对应平台宏不支持的模块

• 各个游戏平台的密钥配置地址支持项目下相对路径

• 预览服务器支持按平台加载 bundle 配置，编辑器预览修改加载 url

• 预制 state 添加 isNested（是否是嵌套预制）的标记

• 修复 db 启动可能出现异步未捕获的错误，启动异常弹窗添加仍要打开的按钮方便启动失败修改偏好设置

• 构建任务支持搜索以及按照名称或构建时间排序的按钮选项

 

• 调整 tab 的 UI 效果
• 优化 gizmo 选择效果
• 优化脚本依赖查询接口
• 完善场景单元测试
• 调整部分 ui 实现，优化性能

修复

 

• 修复 web 平台的 Bundle 包路径包含特殊符号时，勾选 md5 构建会出错
• 修复命令行构建 Bundle 可能出现 Invalid bundle options 错误后失败
• 修复编辑器偏好设置修改资源默认导入配置重启后失效
• 修复构建自动图集时加载资源可能报错
• 修复构建插件钩子函数内 result 参数的资源地址查询接口
• 修复构建自定义纹理压缩接口定义以及示例错误
• 修复自定义资源数据库插件重启后无法正常显示在资源管理器
• 修复构建过程中可能出现 operation not permitted 错误
• 兼容引擎部份对属性元素进行二次挂载导致节点无法正常获取的问题
• 修复 alt + 鼠标左键进入 Orbit 状态，释放了 alt 后鼠标抬起会触发选中对象的问题
• 修复模拟器引擎 TS 与 C++ Spine 版本不配套的问题
• 修复点击编辑器预览单步运行，导致场景视图表现错误的问题
• 修复编辑器内部预览时，会出现处理被删除的节点，导致报错的问题
• 修复拖动 material 设置 mesh 时，会出现mesh 的材质被赋空的问题
• 微调部分编辑器 UI 的组件
• 修复 bundle 重命名后，编辑器内部预览加载不到的问题
• 修复运行编辑器预览时，默认先打开一个空场景的问题
• 修复删除参考图的原图时，参考图无法操作的问题

• 修复构建按钮可能点击无效

• 修复删除资源后可能会有报错日志

• 修复编辑器预览，项目代码报错时，不显示报错日志的问题

• 修复在意外情况下可能点击构建按钮无效

• 修复资源删除后 db 进程可能报错

• 修复拖拽材质时产生的错误挂载的问题

• 修复场景 3D 视图中无法选中 2D 节点的问题、场景快捷键提示隐藏延长为 5 秒

• 修复 bundle 构建报错

• 修复编辑器内部预览打开 2 次场景的问题

• 修复模拟器平台类型不对的问题

• 修复反复拖动材质设置物体,会出现某些物体高亮效果错误的问题
• 修复单独设置某个平台纹理压缩 overwrite 时无效
• 修复项目脚本未定义 tooltip 也会帮补全的问题与某些属性没有 docs 跳转的问题
• 构建路径的特殊符号验证缺少 @ 字符
• 修复替换图集下图片时重新预览可能报错
• 修复新建构建任务后不会自动滚动到任务
• 修复模型预览无法加载动画的问题
• 修复模拟器加载远程 Bundle 脚本时与本地 Bundle 脚本内容不一致
• 更新模型预览获取动画的接口
• 修复 LOD gizmo 报错导致无法显示 LOD 组件的问题
• 修复服务器 get 钩子在 res.send 后依然继续匹配 get 函数
• 修复构建图集时小图配置缺失
• 修复图集资源被使用后的依赖配置错误
• 修复 scene 当中嵌套的 prefab 点击更新到资源的时候，已经打开的关联 prefab 数据没有更新的 bug
• 降级资源缓存复用失效的警告
• db 启动阶段需要自动创建文件夹
• 修复多场景模式下，加载 scene cache 后无法正常记录的 bug
• 修复动画编辑器在增加 AnimationClip 的时候，退出动画编辑器 title 没有 dirty 的 bug
• 修复多场景编辑动画模式退出变成关闭的 bug，动画模式直接进入预览退出报错的 bug
• 修复编辑器预览退出后，中心轴会出现 2 条相同颜色的问题
• 修复资源更新的时候，场景没有被重新加载的 bug
• 修复插件销毁时，漏删除缓存代码的问题
• 修复关闭主窗口触发 beforeClose 后点取消，导致场景操作异常的问题
• 修复 gizmo hoverIn 与 hoverOut 顺序错误的问题
• 修复预览面板如果切换 2D/3D 视图会出现重复创建 grid 与 PreviewWorldAxis 的问
• 修复骨骼贴图布局添加cc.Animation以后贴图大小没有变化的问题
• 修正 asset-db 的依赖查询接口描述
• 修复在某些情况下已经被关闭的场景会因为资源 asset-change 事件重新被打开的 bug
• 修复部分 UI 组件 Object 类无法进行资源回收的 bug
• 修复一些情况下，关闭场景会重新打开的 bug
• 修复构建图集时可能出现 spriteFrame 加载异常
• 修复多场景模式下经常出现 component already added 的 warning 的问题
• 修复多场景模式下，当打开空场景的时候，上一个缓存场景的节点信息没清空的 bug
• 修复 tab 修改后 * 号标识没有展示出来的问题

 

 

引擎

新功能

• 支持多个Spine共享一个纹理集: PR
• 添加 Node.x/y/z 的 gettter/setter：PR
• HarmonyOS Next平台支持Arkts调用引擎接口（evalString接口实现）
• 添加 UISkew 组件：PR
• Builtin管线拆分了后处理，独立成了模块：PR
• 增加对旋转斜变形（rotational skew）的支持：PR
• 添加 Box2D JSB 支持，提升原生平台上 2D 物理游戏性能：PR
• 支持 Spine 4.2：PR1 PR2 PR3
  • Spine 4.2 支持的物理效果展示：

• breaking change：
  • 关闭reflection probe blend，减少fragment sampler总数，使得standard surface能在WebGPU跑起来。PR
  • 移除WebGPU对旧管线的支持，只支持新管线
• 实现 Google Play 自动登录、成就和 PGS Recall API：PR
• 支持 Google Play 成就功能：PR1PR2PR3PR4
• 在基于 CocosRuntime 的平台上支持 WebAssembly 和 WebGPU：PR

优化

• 优化包体（微信小游戏 2D 工程默认配置，3.8.6 启用”压缩引擎内部属性“，包体减小 160 KB）
  • 优化 pointer-event-dispatcher.ts 的代码大小: PR
  • 优化可选链的代码大小: PR
  • 优化 trail.ts 的代码大小: PR
  • 优化 webgl-device.ts 的代码大小: PR
  • 优化 webgl2-device.ts 的代码大小: PR
  • 支持混淆静态私有属性: PR
  • 通过配置进一步混淆静态属性: PR
  • 优化 audio 代码大小: PR
  • 再次优化代码大小: PR
  • 为粒子3D模块内联枚举: PR
  • 为 CCObjectFlags 内联枚举: PR
  • 修复物理2D框架中的类型问题: PR
  • 优化物理2D内建后端的代码大小: PR
  • 优化PhysX后端的代码大小: PR
  • 优化Box2D-WASM后端的代码大小: PR
  • 优化Box2D-JS后端的代码大小: PR
  • 优化代码大小：为 Node.getUITransformComp 添加内部方法，可以混淆该方法，以避免调用 ._uiProps.uiTransformComp： PR
  • 优化 input.ts、tiled-layer.ts 和小游戏的代码大小: PR
  • 优化粒子系统代码大小: PR
  • 通过显式定义构造函数优化代码大小: PR
  • 使用array.forEach替代for of以优化代码大小: PR
  • 优化了math/color.ts的代码大小: PR
  • 优化了webgl-texture.ts/webgl2-texture.ts的代码大小: PR
  • 优化了webgl-swapchain.ts和webgl2-swapchain.ts的代码大小: PR
  • 优化了gfx.FormatInfos定义的代码大小: PR
  • 优化了sprite-frame.ts的代码大小: PR
  • 为gfx-webgl/gfx-webgl2内部模块添加了@mangle jsDoc标签: PR
  • 为内联添加 SystemPriority 枚举: PR
  • 将类从接口转移到实现中: PR
  • 支持对私有属性进行名称混淆: PR
  • 通过添加辅助函数从 pipelineSceneData 中获取数据来优化代码大小: PR
  • 混淆Bullet类的属性: PR
  • 重构了部分代码以减少包大小: PR
  • 优化 TIFFReader: PR
  • 优化了 VideoPlayer 和 WebView 的代码大小：PR
  • 优化 2D 模块的代码大小：PR
  • 优化 draw-batch.ts 和 batcher-2d.ts 的代码大小，移除不必要的 setter/getter：PR
  • 优化小游戏适配器的代码大小：PR
  • 优化 scheduler.ts 的代码大小：PR
  • 优化 AudioManager 的代码大小：PR
• 在tween模块中增加更多覆盖，添加 toString 方法以便调试: PR
• 添加 WebGPU 布局运行时支持: PR
• 改进Spine资产预览面板功能: PR
• 改进了在Sprite中设置SpriteFrame后对SpriteAtlas的处理: PR
• 修改iOS项目的支持目标包括iPad: PR
• 优化包体
  • 优化 tween.ts 代码大小：PR
  • 优化反射探针、粒子、CSM 层、地形的代码大小：PR
  • 对 XR 模块进行 Tree-shaking：PR
  • 优化 render-data.ts 代码大小：PR
  • 通过 USE_XR 常量剥离 XR 相关代码：PR
  • 对 weak-cache.ts 进行 Tree-shaking：PR
  • 在小游戏平台上移除未使用的 pal input 模块：PR
  • 再次优化代码大小：PRPR
  • 优化代码大小： webgl-device.ts & webgl2-device.ts：PR
  • 标记更多属性为 mangle：PR
  • 优化代码大小： text-utils.ts：PR
  • 优化代码大小： text-processing.ts：PR
  • 优化代码大小：ts：PR
  • 优化代码大小： webgl-commands.ts & webgl2-commands.ts：PR
  • 优化代码大小： scene-globals.ts：PR
  • 优化代码大小： sprite/sliced.ts、mesh-buffer.ts、scene/camera.ts：PR
  • 优化代码大小： 增加内部 API UIRenderer._markForUpdateRenderData：PR
• 重构 2D 组装器：PR
• 通过泛型增强组件访问器的类型安全性：PR1 PR2
• 为 RichText、Mask、Graphics、UISkew、AffineTransform 添加更多特性裁剪设置：PR
• 仅在原生端导出 memory-pools，用于 JS 和原生端共享内存：PR
• 重构：提高 isValid 的类型安全性：PR
• 重构：提高 js.isNumber, js.isString 的类型安全性：PR
• WebGPU
  • 移除了没有用到的local descriptor。PR
  • 添加了WebGPU单独的descriptor layout功能。PR
  • 移除了Bind Group Layout及上下游动态创建逻辑，优化内部资源重用 PR
• 优化 js_register_spine_initSkeletonData 中的 std::vector 分配：PR
• 支持在非 OpenHarmony 平台上使用 JSVM API，这将使调试 JSVM API 更加方便。 PR
• 删除 jsvm/Object.cpp 和 napi/Object.cpp 中未使用的代码：PR
• 简化 OH JSVM 后端的 se::Object::createJSONObject：PR
• 优化 OpenHarmony 的 se::ScriptEngine::callFunction：PR
• 优化 JS 到 Native 对象的转换（针对 JSVM 和 NAPI 脚本引擎后端） PR
• 优化 WebGPU 实现：如果不支持浮点过滤，则回退到使用不可过滤的设置：PR
• 将 Spine 4.2 运行时更新到 268d0e8：PR
• 调整 Google Play 绑定接口任务回调线程，避免在主线程处理任务PR

修复

• 修复 ui-component.ts 中的 as any，避免丢失 UIComponent 类型: PR
• 修复 trail.ts 中使用 as any 导致的 mangleProperties 问题: PR
• 添加支持为 Tilemap 启用纹素偏移功能: PR
• 修复描述符集初始化错误: PR
• 修复局部设置问题: PR
• 修复Android 6.0及以下版本兼容性问题导致的崩溃: PR
• 不链接不需要的框架: PR
• 修复 node._getUITransformComp 在原生平台上未找到的问题: PR
• 去除支持 iOS 11 以下和 macOS 14 以下的代码 : PR
• 修复当 fileSource 变量为空时的问题: PR
• 修复启用动态图集时 _nativeData 为null的问题: PR
• 优化预制件和Spine视图逻辑，添加重置摄像头视图功能: PR
• 修复 [Tween] callFunc 在 updateUntil 前可能被调用多次的问题: PR
• 在非原生平台上剥离 ui-opacity.ts 中与JSB相关的代码: PR
• 修复 [Assets] _updateAdaptResult 无效大小: PR
• 添加 freezeColor 内部方法以减少代码大小: PR
• 剥离 jsb-utils.ts: PR
• 将一些属性标记为 @dontmangle: PR
• 修复编辑器中的预览场景应该在帧渲染结束时销毁对象: PR
• 修复Spine渲染的第一帧未受到父级透明度影响的问题: PR
• 修复一些类型问题和警告: PR
• 修复一些类型问题: PR
• 修复 [Scene] 帧不应无效，它可能已被释放: PR
• 添加WebGPU BindGroupLayout数据结构: PR
• 修复 DragonBonesAsset.constructor 中的一个拼写错误: PR
• 修复编辑框输入类型为数字时输入小数点错误的问题: PR
• 修正了Tween.parallel中嵌套Tween.set时作用对象可能不正确的问题: PR
• 删除cocos/render-scene/config.ts中的死代码: PR
• 移除将AMOTION_EVENT_TOOL_TYPE_STYLUS事件当作鼠标事件处理的逻辑: PR
• 修复了Rich Text中maxWidth的i18n属性名称不正确的问题: PR
• 修复了将包含Spine资产的预制体添加到节点树中时，在场景编辑器中出现显示异常的问题: PR
• 修复了 utils.MeshUtils.createMesh在原生平台上崩溃的问题: PR
• 修复了ScrollView无法处理鼠标滚轮事件的问题: PR
• 启用在GAME_VIEW中使用平面反射探针: PR
• 修复了抖音小游戏平台上模拟器报告错误而真实设备不显示视频的问题: PR
• 修复了2D粒子在原生平台上崩溃的问题: PR
• 修复了数学类型的toString方法: PR
• 修复了UI元素批处理和分割调整引起的UI错误问题: PR
• 还原了“修复在特定条件下UI批处理失败”的更改: PR
• 调整了管线中构建渲染图的时机: PR
• 修复了pointerEventProcessorList可能未重新排序的问题: PR
• 将FETCH_TIMEOUT时间从3秒调整为30秒: PR
• 修复了重新父级化的项在超出遮罩裁剪矩形范围时仍可被触摸的问题: PR
• 修复了由于无效的上下文导致Android平台崩溃的问题: PR
• 更新build-wasm-libs.yml，应用优化包大小的补丁: PR
• 精细化了节点检查面板中throttleUpdate的使用: PR
• 修复了由于不安全调用ALooper_pollAll接口导致的潜在ANR问题: PR
• 修复了禁用并重新启用节点后，Spine无法正常显示的问题: PR
• 修复了运行时Web适配器获取错误的问题: PR
• 修复了Spine中的内存泄漏问题，因为没有调用freeStoreMemory: PR
• 修复了Sprite和Label的Assembler代码扩展性问题: PR
• 修复了Spine中自定义材质的动态Uniform设置不起作用的问题: PR
• 修复了暂存缓冲区的问题: PR
• 修复了调整反射探针大小后图像拉伸的问题: PR
• 修复了Web中调用spine.setAttachment时，由于使用错误的纹理而导致的视觉故障: PR
• 修复了在gameview中设置Camera组件的targetTexture无效的问题: PR
• 改进了Spine预览功能: PR
• 添加了内置的管道 pass: PR
• 修复了 mm 宏定义问题: PR
• 视频播放器进入全屏后位置错位（Web）: PR
• 音频播放完成后，事件键应清理: PR
• 继续移除未使用的平台支持: PR
• 修复了UI批处理在特定条件下失败的问题: PR
• 改进了Spine预览UI控制: PR
• 修复HarmonyOS Next平台V8引擎Restart奔溃的问题
• 修复HarmonyOS Next平台的Outline不生效的问题
• 修复HarmonyOS Next平台的重力传感器无法设置enable与disable
• 修复HarmonyOS Next平台构建面包设置加密JS无效的问题
• 修复HarmonyOS Next平台判断文件是否存在接口未处理绝对路径的问题
• 使 Android 模板项目与官方默认模板对齐：PR
• 修复 Spine 在动画播放完成后调用销毁函数导致的崩溃：PR
• 修复 JSVM 无法使用 console.log 输出日志的问题：PR
• 修复调用 callStatic Method 时的跨线程问题：PR
• 修复引擎在 asset-db 初始化期间报错的问题：PR
• 修复编辑器环境下脚本未正确初始化的问题：PR
• 修复 Sprite Inspector（精灵检查器）的国际化配置问题：PR
• 修复缓冲区超出范围的问题：PR
• 修复 HarmonyOS NEXT 平台在使用 JSVM 时重启崩溃的问题：PR
• 修复编辑器预览中脚本初始化顺序错误的问题：PR
• 因 WebGPU 限制禁用探针混合（probe blend）： PR
• 修复 ParticleSystem2D 重新激活后粒子无法显示的 Bug：PR
• 修复 splash-screen.ts 的 mangle 问题，JSON 中的接口数据不应被 mangle：PR
• 修复 Billboard.texture 的类型错误：PR
• 修复编辑器中 Gizmo 位置错误和矩形边框问题：PR
• 修复在 Sprite Inspector 面板上设置 SpriteFrame 时出现假死的问题：PR
• 回滚 "add builtin pipeline passes (#17985)"：PR
• 修复 tilemap 模块中的类型问题：PR
• 修复 RenderPass.computeHash：PR
• 修复 String.substr 已废弃的问题，改用 String.substring： PR
• 修复 EGL 崩溃：PR
• 修复旧版本 fbx 文件中含有中文路径时可能导致转换不成功的问题
• 修复 3.8.6 beta0 引入的原生平台上 spine 潜在崩溃问题：PR
• 修复 3.8.5 引入的原生平台上 WebSocket 触发 onError 回调后潜在的崩溃问题：PR
• 修复 Harmonyos Next 平台 WebSocket CPU 占用率过高的问题：PR
• 修复材质pass uniform buffer越界的问题：PR
• 修复重构 WebGPU Bind Group 后导致的 WebGPU 资源复用的相关问题：PR
• 修复原生平台上 2D 物理节点的 MotionStreak 显示不正确的问题：PR
• 修复 HarmonyOS Next 平台上 ts 调用 arkts 接口在 Deveco 开启多线程检测时会崩溃的问题：PR
• 修复 beta 0 引入的在某些 windows 设备上导入 fbx 可能报错的问题
• 修复 spine::Vector::setSize 的内存泄漏问题：PR
• 修复 PhysX wasm 内存泄漏问题，并更新 PhysX 到 4.1.2.29882248 以解决内存溢出问题：PR
• 修改基于 CocosRuntime 的构建适配器流程：PR
• 在解析不支持的 Spine 版本时，向控制台打印错误信息：PR
• 修复未启用 Spine 时的构建错误：PR
• 修复预制体添加脚本时，场景不会生成脏标记的问题：PR
• 修复不同纹理对象仍使用相同缓存的 SkeletonData 的问题：PR
• 回滚“将 Android 模板项目与官方默认模板对齐”：PR
• 将 iOS LaunchScreen.storyboard 的部署目标版本更新为 8.0：PR
• 修复 Spine 的远程纹理无法正常显示的问题：PR
• 修复 macOS 平台上因无效的 v8::HandleScope 导致的 EditBox 崩溃问题：PR
• 修复 HarmonyOS Next 平台上 JSVM 后端的一些内存泄漏问题：PR
• 解决 SpineMesh 测试用例在原生平台上 Effect 渲染不正常的问题：PR
• 重构 cc::ArrayBuffer，将大部分实现代码移动到 cpp 文件中：PR
• 修复 HarmonyOS Next 的内存泄漏问题：PR
• 修复 Android 6.0 WebView 上的错误 PR
• 修复 WebGPU Attachment 大小不一致的问题 PR
• 修复因 Spine 中相同 UUID 导致纹理对象变化，从而在原生平台上引起的渲染异常问题 PR1  PR2

   

• 修复插件脚本的属性面板【允许编辑器加载】配置存储不对的问题 PR
• 修复 Box2D JSB 在 Windows 上的链接错误 PR
• 修复 MouseJoint 中触摸监听器未取消订阅的问题 PR
• 修复 Camera 组件的错误注释 PR
• 修复编辑器中无法设置 SpriteFrame 的问题 PR
• 修复 Spine 资源不兼容没有警告的问题 PR1 PR2
• 修复 Spine 预览问题 PR
• 修复 audio-manager.ts 中 AudioInfo<T> 接口的命名混淆问题 PR

 

编辑器

新功能

• 新增 荣耀小游戏 平台
• 构建面板支持"压缩引擎内部属性"功能。

勾选后，会在项目根目录下创建 engine-mangle-config.json 文件，其格式如下：

若没有特殊定制需求，保持默认值即可。默认情况会对引擎内所有的 private 属性进行压缩。

高级用法及字段说明：

1. mangleList: 定制需要强制压缩的 protected 或者 public 的属性列表。

格式为：

["className.propName", "interfaceName.propName", "className", "interfaceName"]

只填写 class 名、interface 名表示对其所有属性都要压缩。

2. dontMangleList: 定制不要压缩的属性名单。格式类似 mangleList。
3. extends：继承其它配置，做额外的平台定制，继承项里面的 mangleList, dontMangleList 将与父配置合并。
4. mangleProtected：一般情况下，保持 false 即可。此配置表示是否要对引擎内所有的 protected 属性启用压缩。若设置为 true 并且项目中有继承引擎的类型和操作引擎类型的 protected 变量，则需要额外配置对应的 dontMangleList。

• 支持 UISkew 组件

已知问题：

• 添加 UISkew 组件后，gizmo 选中物体后，边框显示不对。（会在后续版本中修复）
• 若父节点存在 UISkew 组件，当前节点的 world scale、world rotation 将不再准确，尽量使用 local scale 与 local rotation 修改当前节点的缩放和旋转。( 原因：Skew 变换会修改世界矩阵中的 scale、rotation 分量，导致无法从世界矩阵中正确还原出世界 SRT 分量）
• 带 WebView, EditBox, VideoPlayer 组件的节点带 Skew 组件或者它们的父节点中带有 Skew 组件，会导致效果异常。
• 预制体与 Spine 预览，添加复位摄像机功能
• 更新工具，部分二进制支持 arm64 和 x86 的胖包
• 为 UISkew 组件添加 Rotational 选项

 

• 添加更多的模块裁切配置

• 项目设置-模块裁切-支持多份裁切配置：

 

• • 用户如果之前有定制过裁切模块，那么会将原来的配置生成一份“迁移配置”
  • 可以在多份配置中选一个配置作为“全局配置”
  • 选中某个配置，可以在右侧进行编辑器修改（包括重命名）
• 支持 Spine 4.2，可在“项目设置” -> “功能裁剪” 面板中选择 Spine 版本

 

 

注意：

1. 旧项目升级，需要升级到 Spine 4.2，请确保使用 Spine 编辑器将现有 Spine 工程导出为 4.2 的资源格式，覆盖到项目 assets 的对应目录下
2. 切换 Spine 版本后，请重启编辑器或重启场景进程
3. 由于 Spine 4.2 移除了 Effect 功能，无法使用 JitterEffect、SwirlEffect 功能
4. 分离引擎插件功能目前不支持 Spine 4.2

优化

• 完善预览的缩放操作，使其与普通场景类似
• 完善 Spine 预览，添加属性和播放按钮
• 完善拖拽预制体与资源到场景中的创建位置优化
• 修复并完善拖拽资源创建节点与材质赋值给节点的功能
• 偏好设置支持修改 SpriteFrame 导入的 TrimType 默认配置
• 更新 astcenc 版本到 5.2.0，提升构建阶段 astc 纹理压缩速度
• 更新 fbx2gltf 到 1.0.8
• 完善构建插件抛异常后的控制台输出和优化引擎压缩属性的界面显示
• 资源处理器 userData 未填写默认值或无效值时不设置默认值
• 更新导入器默认配置的更新流程
• 优化自动图集警告输出时机
• 完善中轴线配置以及数据升级
• 调整 box2dwasm 的迁移逻辑，优化部分代码
• 图形设置改为独立的配置
• 新增拷贝引擎配置 key 的右键菜单选项
• 将 menu 获取裁切模块从 profile 改成 ipc 的方式

修复

• 修复带问号标记的属性表达式的属性混淆问题
• 修复 2D 视图聚焦 3D 节点时计算边框过小导致无法看到的问题
• 修复编辑器场景无法切换到 box2d-wasm 的问题
• 修复构建平台 buildMode 设置后新建任务不为默认值的问题
• 避免 canvas resize 影响容器的 resize
• 修复拖拽 Prefab 判断是否创建 Canvas 节点错误的问题
• 修复创建节点设置 layer 时子节点未同步的问题
• 修复自定义宏宽度过小时隐藏编辑操作按钮的问题
• 修复 gizmo 获取 nodes 时未正确排序 parent 为 null 的节点
• 修复设计分辨率改变时 2D 摄像机不需要居中的问题
• 修复打包时拉取代码错误仍继续的问题
• 修复预制体动画脚本调整 position 时模拟器预览卡住的问题
• 修复场景保存后重启未记录的问题
• 修复拖动帧动画图片数组排序错误的问题
• 修复部份 ui-kit 的 bug
• 修复原生平台构建模板拷贝位置问题
• 修复支付宝平台的 game.ejs 构建模板支持
• 修复项目设置配置的插件脚本排序后不同环境顺序不一致
• 兼容 MTL 文件没有 path 情况下无法进行复制路径
• 修复数值类型判断以及特效节点值的区间问题
• 修复旧项目升级后引擎模块选项缺失导致界面出错
• 修复创建原生模板失败
• 修复切换引擎模块配置时界面的物理模块显示隐藏没有更新
• 修复拖动 2D 元素后再拖动 3D 元素，3D 元素坐标错误的问题
• 修复旧的获取模块裁切的方式
• 修复 enum 类型值的错误转换
• 修复属性被缓存的节点未能挂载导致属性切换时节点未能展示
• 修复项目设置引擎模块 cache 缺失某些模块和全选时联动依赖项
• 修复让挂有普通脚本节点的聚焦效果与普通节点保持一致
• 修复窗口过小时内容撑出高度的范围
• 修复引擎模块未选中配置但设置为全局时，没有广播到预览等场景的问题
• 修复多选节点移动时，基准线显示错误的问题
• 修复移动探针节点，不显示白色基准线，以及无法通过箭头蓝红绿中间移动探针的问题
• 修复 project 测试用例报错
• 补齐 engine 的裁切导入导出函数
• 删除当前选中的配置需要更新选中的 key
• 修复 3D 工具可见性移动节点后失效以及修复吸附计算错误的问题
• 修复 3D 视图的正交相机视角下，基准线显示异常的问题
• 修复吸附功能吸附到中心轴基准线的问题
• 完善场景 Snap 快捷键显示布局
• 修复场景快捷键提示图在英语下排版错误的问题
• 修复编辑器预览，无法加载 bundle 的问题

 

 

引擎

新功能

• 支持咪咕小游戏

• 支持 Google Play 平台

• 添加手动加载 Wasm/AsmJS 模块的功能，可用于提升首场景加载速度

• node.setSiblingIndex 支持传入负数的 index，表示在子节点数组中从后往前索引

• 自定义管线新增DOF后效

• 新管线添加PipelinePass支持，用户可以通过添加Component的形式新增后处理等效果

   

  

   

• 支持淘宝小游戏对全局变量的优化，构建页面的 globalThis全局变量适配 复选框去除勾选即可启用，可减少一定量的包体

   

  

   

优化

• 包体优化

  • 移除 web 平台 gfx 层无用的代码

  • 构建引擎代码支持"内联枚举"功能

  • Spine 模块包体优化，体积相比 v3.8.4 缩减 40% 左右

  • 显示声明 ts 类的构造函数，避免生成无用代码

修复

• 修复 Android 平台切后台或者被其他 Activity 覆盖时，收到 WebSocket 消息，会造成jni报错导致崩溃

• 修复角色控制器可能不触发 onControllerTriggerEnter 事件问题

• 修复 bullet 引擎射线检测的错误

• 修复 box2d 射线检测遇到 mask 不一致物体导致出现的问题

• 抖音平台使用引擎内置的 physics 引擎

• 修复 box2d 在 Contract 回调函数销毁节点的崩溃问题

• 修复 UiOpacity 在 web 平台上切换 opacity 的父节点时造成异常的问题

• 修复 UiOpacity 在 native 平台上首次切换到新节点时，没有计算父节点的透明度的问题

• 修复了 bullet 的 raycast 没有导出 closest hit fraction 的问题

• 修复 Bridge 同一事件注册多个监听函数导致监听函数执行和重复注册问题

• 修复 scrollview 频繁创建对象的问题

• 修复 bullet 的内存泄露问题

• 修复修改设计分辨率没立即生效的问题

• 修复热更新文件很多时，会造成UI页面卡主的问题

• 调整瓦片地图图集相邻时使用出现的明显间隔

• 修复 UiOpacity 在 web 平台上会出现无法显示的问题

• 修复tsx文件对象层自定义属性读取错误

• 修复安卓平台上反复进出游戏导致的崩溃问题

• 修复调用 node.setWorldScale(0, 0, 0) 后 worldMatrix 中含有 NaN 值的问题

• 修复 gfx webgl1/2 后端对 renderBuffer 状态错误复位的问题

• 修复原生平台上 C++ TypeArrayTemp::set 没有考虑自身 byteOffset 的问题

• 修复 SamplerInfo 各向异性过滤，最大支持16。

• 修复编辑器预览到 builtin 材质出错需重启的问题

• 修复原生平台上 mesh.setInstancedAttribute 无法支持 INT 类型的 attribute 的问题

• 修复若干 Spine Wasm 模块关于 String 参数相关的 API 的绑定问题

• 修复 2D 物理引擎，RigidBody2D 类型修改后，PhysicWorld 中的 _animatedBodies 没有更新的问题

• 修复了原生平台 Camera Component 中 Rect 效果不对的问题

• Node 的 position/rotation/scale 等设置方法改回和 v3.8.3 一样的方式

• 修复 Spine skeletonData 未准备好就调用 setAnimation 导致脚本报错

• 修复 Web 全屏显示旋转适配问题

• 修复 Spine blend mode 使用错误问题

• 修复支付宝小游戏 my.request failure 回调，类型使用错误导致的脚本错误

• 修复 编辑器上 Spine 同名资源覆盖后，画面显示异常问题

• 修复原生平台上 touchEvent.getUIDelta 返回错误的 delta 值的问题

• 修复 mac 平台关闭 gfx 线程分离后 autorelease 类型 NSObject 的泄露问题

• 修复了WebGPU Chrome下白屏问题

• 修复 InstancingBuffer 下光照异常问题

• 优化 Web 自定义管线执行逻辑

• 修复原生平台 InstancedAttribute 不支持非 Float Format

• 修复原生平台上，场景标识为 autorelease 类型，切换场景后旧场景关联的资源无法被释放的问题

• 修复原生场景内存泄露的问题

• 修复 Tween sequence 与 parallel 嵌套，子 tween 的 target 不同时产生的异常问题

• 修复原生平台上，node 的 active 状态变化不会自动暂停/恢复 Tween 的问题

编辑器

新功能

• 支持咪咕小游戏

• 支持 Google Play 平台
• 升级编辑器的 electron 版本到 31.3.1，提升了性能和 node 的版本

• 场景视图新增 "查看/选择" Gizmo 模式

• 相机漫游增加鼠标滚轮调整基础漫游速度快捷功能

• 裁切模块支持联动的 flags 配置，比如是否开启手动加载 spine 等

勾选手动加载后，需要在使用 Wasm 模块前确保 Wasm 模块已经加载。

• 属性检查器支持预制体与 Spine 支持预览

  • 已知问题：切换皮肤，需要进行切换动画，或者在播放中才会生效

优化

• 层级管理器拖拽节点与 UI 表示的优化，减少误操作的几率，并调整区域的判断，根据鼠标的左右位置判断多层级的节点归属

• 场景视图中选中预制节点选取优化，第一次选中优先选取预制根节点，第二次选取目标点，后续在依次向上选取

• 统一  windows 与 mac 平台主窗口的标题显示，加入所属项目名

• 完善属性面板属性的 tooltip 显示效果

• 完善场景 3D 视图滚轮缩放视图的效果

• 完善脚本、引擎、原生模拟器引擎编译提示

• 优化脚本很多的项目修改某个脚本后导致等待时间太久的问题

• 构建面板中添加"内联枚举"勾选框，默认勾选，暂时只支持引擎内的枚举类型

   

  注意：开启选项后，引擎内的枚举类型将不再生成双端映射（ Reverse-Mapping ），若需要继续使用双端映射枚举功能，可在构建面板中关闭此优化选项或者使用引擎提供的 Enum 函数为特定枚举类型动态生成双端映射。

  

   

   

修复

• 修复构建时自动图集压缩纹理后还保留原图的问题

• 修复 2D 视图无法框选 2D 节点的问题

• 修复参考图设置坐标与缩放无效的问题

• 修复编辑器对预制嵌套修改，导致相关节点丢失的问题

• 修复新建 Prefab 后，进入 Prefab 编辑器模式下对根节点新建 UI 组件，场景中不显示 UI 的问题

• 修复属性检查器执行删除嵌套数组元素的操作，会导致外层数据误删的问题 issue

• 修复裁切面板的全选等逻辑不联动的问题

• 修复窗口缩放不是 1 的时候，编辑器内预览点击错位的 bug

• 修复本地化编辑器无法使用的 bug

• 修复 openharmony 改 HarmonyOS Next 工程名还是 openharmony 的问题

• Harmony OS Next移除armeabi-v7a选项

• Harmony OS Next渲染后端选项改为只读

• 修复Harmony OS Next的JSVM不能使用的问题

• Google Play 平台默认设置 App Boundle 为 true 且不显示设置

• Android 平台移除 App Boundle 与 Google Play Instant 选项

 

新增、优化功能

引擎

• Pool 支持设置 shrink threshold，确保 Pool 缩容后的大小不会小于 shrink threshold。
• 支持监听鼠标进入窗口的 mouse-enter 和鼠标离开窗口的 mouse-leave 事件。
• 新增 Vec2.toVec3() 接口
• 新增 Vec3.toVec2() 接口
• 新增 ResolutionPolicy.getContentStrategy()
• 新增 ContentStrategy.strategy
• Tween 中使用 sequence/parallel/then 级联子 Tween 的时候，子 Tween 允许使用不同 target。
• 为 Tween 添加 reverse, id, union(fromId), timeScale, duration, pause, resume, pauseAllByTarget, resumeAllByTarget, update, start(time) 接口
• 如果 Tween 绑定的目标对象是 Node 类型，Tween 系统会根据 Node 的激活和销毁状态自动做暂停、恢复、停止的操作。
• Tween 支持缓动字符串、定制任意属性类型的 progress/easing 函数。
• 淘宝小游戏平台，websocket支持多实例。
• 支持WebGPU，目前为实验版本。
• 添加 Tween.running getter，用于判断当前缓动是否正在执行。
• 添加 Tween.getRunningCount(target) 静态方法，用于获取目标对象关联的缓动个数。
• 为 Tween 模块添加内置 bezier、catmullRom 曲线 progress 支持，可通过调用 tweenProgress.bezier(c1, c2, p3) 创建自定义属性参数传递给 tween.to/by 。
• 添加 Tween.updateUntil 接口，用于添加不确定时长的动作到缓动系统中，通过回调函数返回 true 来终止当前动作，可以实现类似追踪动态物体的效果。
• 为原生平台添加 TextDecoder 添加 utf-16 编码支持。
• 可定制管线进入Beta阶段
  • 新增Builtin可定制管线
    • Cocos新的默认管线，替换原前向管线(builtin-forward)与PostProcess可定制管线。
      • Deprecate PostProcess，可以选择裁切减小包体
    • 优化了原前向管线的一些问题
      • 默认Discard DepthStencil的值，优化移动端性能
    • 优化了PostProcess的一些问题
      • 移除Bloom combine pass中不必要的贴图读取
  • 新项目默认使用可定制管线，管线名为Builtin。
  • 旧项目升级时
    • 升级前使用可定制管线，升级后仍使用可定制管线，且管线名不变。
    • 升级前使用未使用可定制管线，升级后使用原管线。
  • 添加管线选择页面。用户可以在Graphcis/图形选择可定制管线/原管线。
  •  

    

    
    
    • 选择可定制管线，默认使用Builtin管线，打包时会裁切掉原管线。
      • 如果使用Builtin管线，会打包builtin-pipeline.ts, builtin-pipeline-settings.ts, builtin-pipeline-types.ts三个脚本
      • 暂不支持debug-view-runtime-control.ts，打包时会被裁切。
    • 选择原管线，打包时会裁切掉可定制管线。
      • 会发布debug-view-runtime-control.ts
  • 新项目默认使用可定制管线，管线名为Builtin。
  • 新管线包体目前较老管线大，正全力优化至合理范围。
  • 可以通过BuiltinPipelineSettings设置后处理等功能
    
     

    

    • 功能迁移自PostProcess
• SafeArea支持设置是否对称，即上下（左右）是否对称，如下图：（浅紫色为选择对称的情况，浅蓝色为选择不对称的情况）
• 

编辑器

• 优化构建面板界面 UI 布局
• 新增资源模板的创建菜单入口
• 

• 构建参数 sourceMap 支持 inline 参数，之前开启 sourceMap 默认是独立文件的形式，无法在原生的 chrome 调试中还原 ts 源码，遇到这个问题的开发者可以在原生平台上的 sourceMaps 选项里选择 inline 模式方便调试。

• 

• 优化了 windows 菜单栏的显示间距
• 
• 项目设置插屏预览效果将结合适配模式展示
• 

• 自动图集预览支持显示合图尺寸
• 编辑器支持 zoom level 进行缩放窗口
  
   

  

  • 快捷键：
  • 
• 支持在偏好设置内将内置资源 library 导入位置更换到全局，加快不同项目首次打开的启动速度，如有插件自行拼接了资源 library 地址可能会受影响，此功能可在偏好设置 -> 实验室 开启，默认关闭。(已知问题：开启后不支持模拟器预览与原生引擎场景实验室功能）
• 

BUG 修复

引擎

• 修复设置 event.preventSwallow 为 true 后，重叠区域会不响应触摸事件问题
• 修复 Node 的一些 setter 函数在值没有变化时也发送修改事件的问题
• 修复小游戏平台(淘宝、支付宝)innerAudioContext.onCanPlay可能不存在导致声音无法播放的问题
• 修复 NodeEventProcessor.dispatchEvent() 存在的嵌套问题
• 修复 Tween color 时闪烁的问题
• 修复场景(.scene)和 prefab (.prefab) 文件中 _rot.x/y/z/w 数据可能存在 null 非法值的问题
• 修复 Tween.to / .by 的 opt?: ITweenOption 中的 onStart/onUpdate/onComplete 回调函数的 target 强制为 object 导致在严格模式下报错的问题
• 修复 Tween 过程中会把目标对象属性类型的问题
• 修复 Tween.to/by 的 props 参数中自定义 progress, easing 的类型缺失问题
• 修复 Tween 系统会自动给非 Node 类型的目标对象添加 uuid 属性的问题
• 修复 Android 平台上 WebSocket 接收二进制数据导致的内存泄露问题
• 修复 Android x86 模拟器上，因为 gfx 相关的结构体被编译器自动插入 padding 字节导致的 hash 计算异常，进而导致 _pool[desc] 重复创建对象引发的内存泄露问题
• 修复原生平台上，修改 CacheMode（NONE）模式的 label 文本，导致的内存泄露问题
• 修复 Button 回调函数中抛异常，在 window.onerror/jsb.onError 捕获异常后弹出的 UI 无法响应 touch/mouse 事件的问题
• 修复Ipad上旋转屏幕后，游戏窗口大小显示错误问题
• 修复 iOS 原生设备静音键启用后，声音依然会播放问题
• 修复 iOS 原生手机通话接听，并且从后台挂断电话，再把游戏切到前台；游戏声音不恢复问题
• 修复cache-manager的clearLRU在特定条件下，cleaning不会被重置的问题
• 修复enable_multi_touch设置不同时，出现的行为不一致
• 修复web骨骼动画关节uniform未取整引起的shader编译错误问题
• 修复多光源原生平台out of range问题
• 修复原生平台上，编译 release 包生成的脚本中有语法错误的问题，此问题为 3.8.3 中被引入
• 修复在 ts 文件中，使用 js 新标准的私有成员函数，比如 #foo() {}，导致的编译报错问题，此问题为 3.8.3 中被引入
• 修复在原生平台上，spine 的 .wasm 和 .mem.bin 文件也被生成的问题
• 修复 Node.angle() 返回错误值的问题
• 修复 Component.scheduleOnce() 回调时序错乱问题
• 修复gles2后端out of range问题
• 修复在节点 touch 回调中抛异常后，其它节点无法响应 touch 事件的问题
• 修复在某些 Android 模拟器（比如：逍遥模拟器）上黑屏的问题
• 修复 bullet body 的内存泄露
• 修复淘宝平台不能正确清理缓存问题
• 修复原生平台上调用 game.restart() 的时候如果有 promise 异常未处理而导致的崩溃问题
• 修复updateAllDirtyRenderers在处理过程中添加新的dirtyRenderer时，会被删除的问题
• 修复使用richtext时，会出现outline的警告的问题
• 更改字节平台的videoplayer显示方法(使用纹理的方式显示视频内容)
• 统一插屏的显示方式，参考文档多分辨率适配方案
• 修复设置ENABLE_MULTI_TOUCH为true或者false时，导致行为不一致的问题
• 修复web平台bmfont的colorDirty不生效的问题
• 修复SpriteRender Atlas渲染不正确的问题
• 修复atlas会多余创建的一个
• 修复sys.os/sys.isMobile在小游戏平台的判断不完全准确，并增加了mac的判断
• 修复在编辑器里切换button的类型，从颜色到精灵精灵，在切换到缩放，最后回到颜色，会变成黑色的问题
• 优化开发体验：避免在 ccAssert 函数中使用 debugger; 断点，改用 console.error
• 优化 2D 粒子更新 buffer 过程，减少不必要的乘法运算
• 优化原生平台上文件读取逻辑，由同步读取改为多线程异步读取，解决加载资源卡顿问题。在 Android 中低端设备上，JSON 文件的反序列化性能提升 30 % 左右。
• 修复部分小游戏平台（支付宝、字节、淘宝）等，在频繁创建canvas后，在部分低端设备可能因为资源受限导致创建canvas失败
• 修复Spine 节点的opacity不生效问题
• 修复Skeleton-Asset释放后，部分对象未释放问题
• 优化：减少Skeleton-Asset解析json的次数
• 修复 PhysicsContract.emit 函数在 Collider 没有 rigidbody 可能导致的错误
• 修复原生平台上，在 Director.EVENT_AFTER_DRAW 中修改节点 position 导致节点的 worldPosition 在下一帧中不会被更新的问题
• 修复原生平台Spine在setXXListener中，启用或禁用spine导致崩溃问题，修复
• 修复可定制管线原生平台geometry renderer 不显示问题
• 压缩可定制管线effect.bin，加入版本控制
• 修复可定制管线编辑器Reflection probe球形预览不显示的问题
• 修复可定制管线多相机清除颜色不对的问题
• 修复可定制管线viewport 四舍五入的问题
• 修复可定制管线UI渲染时，渲染不相关Materiap Pass的问题
• 修复可定制管线编辑器平面反射场景，天空盒显示错误的问题
• 减小可定制管线包体
• 修复淘宝小游戏 websocket 回调函数的 this 指针问题
• 修复 Xcode 16.0 编译问题
• 修复了可定制管线编辑器warning
• 修复了可定制管线reflection probe烘培报错
• 合并了可定制管线渲染队列的填充
• 修复了原生可定制管线ui阶段潜在crash问题
• 修复了原生可定制管线render window野指针问题

编辑器

• 升级小米打包工具，支持 node 18 以上版本编译小米
• 添加自动处理构建模板文件 MD5 选项开关的实验室功能选项，允许用户关闭
• 修复自动替换文件依赖的 MD5 路径时可能将 html 内的其他标签属性字段替换
• 修复 HarmonyOS平台构建Bundle报错
• 修复 assets 面板上子资源的显示名称问题
• 修复 Bundle 资源预览列表过长时底部显示不全
• 修复自定义脚本模板的 URL 参数失效以及完善创建脚本文件名的校验流程优化修复构建面板场景列表选择以及 missing 状态下的显示与交互
• 修复华为 AGC 平台二次新建构建任务没有更新配置
• 修复动画编辑模式下，选择动画面板中节点列表的节点 gizmo 图标不显示的问题
• 修复项目设置中骨骼贴图布局添加多个骨骼，缺少滚动条
• 修复重新选中地形节点后，无法刷绘选中的纹理层，需要切换纹理层才能刷绘
• 修复雕塑的地形，进入prefab 编辑返回场景后，地形编辑信息丢失
• 修复鼠标放置在地形上移动，光标大圆点出现截断
• 修复部分格式图片构建时纹理压缩失败
• 修复构建界面的 CLEANUP_IMAGE_CACHE 配置可能无效
• 空工程构建面板参数中的Include Bundles去掉全选无效
• 修复自动图集文件夹嵌套时没有剔除子图集的小图
• 修复断网/内网情况下编辑器启动报错以及预览功能异常
• 修复构建初始场景丢失后点击构建错误提示不明显
• 修复在微信构建模板内填写开发数据域字段无效
• 修复构建插件钩子函数的 onBeforeMake 与 onAfterMake 的参数与构建选项不一致
• 修复动画编辑器动画剪辑子节点指定为拖拽选择
• 修复动画编辑器在多个clip情况下，编辑保存后跳转到首个cli的情况
• 修复不同平台的相同纹理压缩配置会重复压缩
• 修复自动图集内小图被当做 texture 使用后，构建小图的 image 数据丢失
• 修复独立构建 Bundle 时可能缺少资源依赖
• 修复设备第一次打开编辑器时有 layout 报错
• 修复预览页面打开时启动编辑有 settings 请求失败报错
• 修复命令行打开编辑器时主进程的错误显示可能没有完整调用栈信息
• 修复项目设置填写 import-map 路径清空后启动编辑器报错
• 修复 Mac 平台命令行构建控制台日志可能显示不完整
• 修复反复切换属性面板切换会导致编辑器内存上涨的问题（尤其是切换添加多个 Material 的 MeshRenderer 组件）

已知问题

• 如果出现如下图所示 Effect 编译错误，或开启 WebGPU 后出现下列警告，请重新导入所有 Effect 并重启 Creator
  • 重新导入按钮位置在：菜单(Menu) -> 开发者(Developer) -> Refresh All Effect
  • 
  • 

• XR 功能还不支持新渲染管线
• 淘宝小游戏分离引擎功能目前功能有异常，ios可以运行，android运行不了；需要淘宝官方处理，后续有需要使用分离引擎功能，烦请咨询淘宝官方。

 

 

Features

Engine

Features

Engine

1.  新增自定义管线 Subpass、MSAA 支持

2.  动画图恢复了对非骨骼动画（AnimationClip）的支持

3.  脚本系统开始支持解析符号链接，以用于支持 pnpm 等依赖符号链接的包管理器。（现在默认对符号链接进行解析，此举可能影响那些将 assets 目录链接至项目的做法）。

4.  添加了 iOS 对屏幕边缘手势的延迟触发以防止误触

5.  添加了原生平台对 http 请求的 patch 方法支持

6.  添加了 RichText 的默认颜色接口

7.  新增钢琴烤漆、车漆和玻璃材质

示例：https://github.com/cocos/cocos-example-materials 场景：assets\advanced-cases\coat\coat.scene

8.  HDR 下 Scene 面板增加 PostSettings 选项，Tone Mapping Type 提供 DEFAULT 和 LINEAR 选项

9.  新增实验性质的 Box2D wasm

10.  新增角色控制器 Trigger 事件，支持 角色控制器组件 和 碰撞体 监听 onControllerTriggerEnter，onControllerTriggerStay，onControllerTriggerExit

11.  支持动态改变 MeshCollider 的 Mesh

12.  换用更稳定的 mesh simplify 工具

13.  新增 mesh cluster 的支持

14.  新增 mesh quantize 的支持

15.  新增 mesh encode/decode 和 inflate/deflate 的支持

a. 面板选项

b. 大场景加载/渲染的性能提升

 

Editor

1.  偏好设置添加 Java Home 路径设置，用于解决 Android 构建时设备安装多个 JDK 的问题

2.  Android 构建面板添加 Resizeable Activity 和 Max Aspect Ratio 选项

3.  抖音小游戏支持配置开发者工具启动模式并快捷启动

4.  微信小游戏平台默认开启 CLEANUP_IMAGE_CACHE，其他平台默认跟随项目设置

5.  材质、模型、Mesh 及骨骼动画的预览窗口添加了网格、天空盒以及 Scene Gizmo，同时支持控制预览视角

6.  新增 3D 工具可见性开关，关闭后将隐藏变换工具以外的 3D Gizmo

7.  属性检查器支持拖动调节属性名宽度

8.  属性检查器支持显示部分组件图标

9.  优化 Light 和 Camera 组件的 visiblity 在属性检查器中的显示效果

10.  减少内置引擎的 boost 库的文件数量，缩减编辑器包体

11.  其他细节体验优化

 

Fixes

Engine

1.  修复自定义管线特定条件下渲染错误问题

2.  修复动画图变体未对嵌套的状态机生效的问题

3.  forceLOD 调用后，改变节点的 active，接口不能正常工作

4.  优化 android 端 editText 输入框的交互

5.  修复 editbox 旋转后, 在 web-mobile 上可能出现的错误显示效果

6.  修复 Mac 切换窗口和全屏时 editbox 的输入表现错误

7.  修复 Android 多点触摸崩溃问题

8.  修复音效播放过程锁屏，解锁屏后不能恢复播放

9.  修复 iOS Safari web audio 播放超过 5 分钟后会有杂音的问题

10.  修复 audioManager 存放的 player 可能被 destroy 的问题

11.  优化同一帧调用同一个音频对象的多个音频操作可能存在卡顿的问题

12.  淘宝小游戏 iOS 平台：修复多次调用音频 play 进度条会一直卡在 0 的问题

13.  小米平台：修复音频播放时，拖动进度条，进度条会从 0 的位置再跳转的问题

14.  修复小游戏批平台，播放的音频个数超过 10 个后，继续调用其他音频的播放接口可能导致内存泄漏问题

15.  修复 videoplayer 暂停&结束后通过 isPlaying 接口获取的状态错误

16.  修复切换 video 源时可能出现的异常表现

17.  修复 swig 绑定重载构造函数时绑定代码丢失命名空间的问题

18.  修复 swig 绑定多级（>= 2) 内部类导致的异常问题

19.  修复在 .i 中重命名内部类导致胶水代码编译失败的问题

20.  修复原生平台上 scene._instantiate 实现不对的问题

21.  修复非安卓平台，反复重启 `game.restart()` 导致的崩溃或者卡死问题

22.  修复编辑器中 scale 不为 1 时 widget 带来的场景错乱问题

23.  修复 Button 组件在启动时会使用 Sprite 组件的 spriteFrame 覆盖本身 normalSprite 的 bug，将按 button 组件序列化的数据来填充 spriteFrame 状态。

24.  修复 ScrollView 使用鼠标滚动后，scrolling 属性始终为 true 的 bug

25.  修复带 carmera 的场景，点击鼠标会出现偏移的 bug

26.  修复 OpenHarmony 收到 resize 之后，分辨率出现不正确的 bug

27.  修复 OpenHarmony 取消勾选 WebSocket 之后出现链接的问题

28.  修复自定义管线中 Fog AO 半透明等混用的渲染错误（需要开启 CC_USE_FLOAT_OUTPUT 宏）

29.  修复反射探针烘焙和移动更新的问题，并优化原生引擎调用性能

30.  修复切换雾效类型天空盒不受影响的问题

31.  修复创建的默认 SphereCollider 的 Center 不为 0 的问题

32.  角色控制器调用 move 方法时会马上将其物理世界位置同步到场景节点

33.  修复使用 Xcode 15 编译 iOS 项目导致的程序启动崩溃问题

 

Editor

1.  修复碎图和图集同时配置纹理压缩时导致的运行时报错

2.  修复自动图集在压缩纹理后仍包含原图的问题

3.  修复图集被多个 Bundle 引用并且 bundle 优先级一致时纹理压缩图片拷贝异常的问题

4.  修复 Bundle config 重定向配置存在重复数据的问题

5.  修复空 Bundle 不输出 config.json 的问题

6.  修复 Bundle 中的文本资源包含 uuid 时构建依赖信息错误的问题

7.  修复 Bundle 构建面板的输出目录无法选择的问题

8.  修复只构建 Bundle 后构建面板无法新建构建任务的问题

9.  修复构建任务名称修改后切换构建模式，任务名称可能出错的问题

10.  修复插件脚本里实现组件后，预览和构建时报错类重复注册的问题

11.  修复勾选初始场景分包后，脚本、资源可能输出位置错误的问题

12.  修复预制件的部分操作撤销后的数据异常

13.  修复点击事件引用了预制件子节点后无法正常保存的问题

14.  修复拖拽预制件节点覆盖原预制件文件时嵌套预制件的修改丢失问题

15.  修复编辑预制件时的其他若干问题

16.  修复编辑器预览无法调试 localStorage 的问题

17.  修复编辑器预览设置 FPS 无效的问题

18.  修复编辑地形时打开预制件再回到场景时地形数据异常的问题

19.  修复编辑地形时部分操作撤销重做后表现不符合预期的问题

20.  修复往预制件实例的 mounted 嵌套预制件上添加节点，没有显示 + 号的问题

21.  修复 Mac 上通过程序管理器（program）配置默认浏览器为 Safari 可能会出错的问题

22.  修复艺术字资源可能因为导入时序缺失数据的问题

23.  修复动画编辑器事件帧、关键帧，曲线编辑等若干问题

24.  修复粒子曲线面板编辑时的若干交互问题

25.  修复编辑 FBX 资源时事件帧图标不能拖动和部分情况下位置不正确的问题

26.  修复 Widget 组件 undo 不准确的问题

 

Breaking Changes

1.  将 UIMeshRenderer 组件标记为不推荐使用，用户可使用 RenderTexture 来实现类似功能，详见 Cocos Creator 3.8 手册 - UIMeshRenderer 组件参考

2.  用户自定义的 Effect 可能需要仿照 internal 资源中的 effects/legacy/standard.effect 添加平面阴影相关 pass，否则平面阴影无法动态合批，详见 #14958

 

Known issues

1.  iOS web-mobile EditBox 显示在界面顶部时，第一次获取到焦点时可能会被输入法移出屏幕外，若遇到此问题可参考该 PR 进行修复

Features

 

Custom 管线集成后处理流程

 

Creator 3.x 依赖 3D 游戏呼声最高的需求应该就是后处理了，之前一直都推荐开发者使用 RenderTexture 来制作却没有提供内置能力，主要原因在于支撑后处理的自定义渲染管线一直没有完成。而经过 3.7 赛博朋克 Demo 对自定义渲染管线的验证，在 3.8 中我们终于可以将抗锯齿、超分辨率、环境光遮挡、炫光等后处理特效交付给开发者。这些后处理流程目前都集成在了 CustomPipeline 中，一方面作为 RenderGraph 的示例，另一方面也可以作为我们标准 Forward 管线的试验场。

 

1. 抗锯齿：提供了消耗非常低的 FXAA 和效果较好基于时序的 TAA

 

2. 超分辨率 FSR：有助于用较低的损耗提升渲染分辨率，达到用较低的损耗达到更高的画质，或者减轻项目的性能压力

 

3. Bloom：增强高光位置的泛光表现，提升画面质感

 

4. HBAO：高质量环境光遮蔽，可以大幅度提升场景的立体感和质感
5. 自定义 Color Grading：这是非常简单但立竿见影的一种后期处理方法，可以用来增强对比度、饱和度，调节颜色、白平衡等画面属性。支持任意 Nx1 的长条图 和 8x8 的方块图，系统自动适配

 

从 3.8 开始，我们推荐需要使用后处理的项目切换到 Custom 自定义管线，可以参考文档进行管线的开启。后处理流程的开启方法参考后处理管线文档，目前可以先参考管线测试项目来了解如何使用。

 

2D & UI

• 高清晰度 Label：此项优化是将默认 Label 组件的实现高清化，所以所有项目升级以后都可以免费获得收益。其原理主要是根据 view 的像素缩放比例重新计算 Label 实际渲染的字体尺寸，获得更高清的文本贴图，尤其是移动平台上效果提升比较明显。除此之外，我们对 2D 渲染器底层也进行了重构，主要目标是让 2D 渲染器在不同操作系统适配以及针对不同组件的实现都能有相对统一的框架，高清 Label 的落地也是受益于此，未来也会更容易扩展 3D UI 和 3D 空间的 2D 渲染能力。
  
• 使用 WebAssembly 编译 Spine 原生运行库，统一 Web & Native 的运行时以及 API
• 降低 WebAssembly 初始内存分配量，并允许内存动态扩容
• Spine 使用 WebAssembly 运行在微信小游戏，Web 等平台，大幅度优化性能表现

 

渲染算法和材质更新

 

1. 皮肤材质：在内置 effect 中更新简单皮肤材质和高级皮肤材质，案例可以参考 Cocos Example Materials 中的 Character 场景

2. 眼球材质：在内置 effect 中更新高级眼球材质，案例可以参考 Cocos Example Materials 中的 Character 场景

3. 叶片材质：在内置 effect 中更新高级叶片材质

 

4. 支持 Zeno & Houdini 导出的预烘焙模拟动画：这项功能可以让开发者在游戏或内容中集成离线计算的高质量物理模拟动画，包括刚体、流体、布料等，使得游戏转场或一些固定场景的表现力大幅度提升，尤其是对车机等应用内 3D 模拟非常有帮助。

a. Zeno

b. Houdini

 

5. Reflection Probes 支持 Blend，之前的版本中，动态物体在不同 probe 区域之间的移动会引起跳变，在 3.8 中，不仅支持 Probe 之间的效果混合，也支持 Probe 和天空盒之间的混合，在不同烘焙区域以及室内到室外的场景中，都可以得到很自然的过度效果。

 

Marionette 动画系统升级

 

姿态图和 IK

 

我们为 Marionette 动画系统引入了一个新的特性：姿态图。这个新功能将为程序化动画以及双骨骼 IK 动画提供支持。利用姿态图，开发者可以通过节点系统以便捷的方式定义各种程序化动画和动作姿态，从而构建出更为复杂、细腻的场景交互。这也将大大减少用户在创建角色动画时所需的动画数量。举例来说，你可以定义角色在不同平面的脚部 IK，让角色爬上不同高度的地形，或在走路时注视某一方向。此外，姿态图还可以作为动画状态机的补充，可在状态机中进行嵌套使用。详见：《Cocos Creator 3.8 手册 - 程序式动画》

 

允许为骨骼动画添加辅助曲线

在制作复杂的程序化生成动画时，你可能需要为动画添加一些变量曲线，以进行逻辑判断或作为变量使用。为了满足这些需求，我们在动画编辑器中新增了辅助曲线功能。你现在可以为任何一条骨骼动画添加额外的曲线，并且添加后，这些曲线可以在姿态图和状态机中进行读取和混合。这个新功能将提供更大的自由度，帮助你更好地控制和定制动画。

 

此外 Marionette 动画系统还有这些升级：

• 动画状态机移除实验性质的过渡中断功能，改为支持多条过渡
• 动画状态机数值条件增加了几种不同类型的条件绑定：权重绑定、动画时间绑定和辅助曲线值绑定
• 层级面板支持拖动调整排序
  

物理系统

 

1. 新增角色控制器组件：对于角色扮演和动作类等游戏，可以极大降低角色的开发成本，内置能够和环境自然交互的角色控制能力。

 

2. 约束：新增可配置约束组件，可以用于定制各种复杂的物理部件连接方式，比如汽车的轮轴、各种关节等。
3. 约束：Hinge 约束新增转轴驱动和转动范围限制

 

4. 新增 sweep 碰撞检测 

 

烘焙器更新

• 光照贴图面板增加过滤选项 Apply Filter，用于设置光照贴图的模糊效果，默认开启。

• LightFX 支持标准 PBR 材质的 AlphaThreshold
  
• 阴影饱和度同样在 LightFX 中生效
  
  

 

RenderGraph 自定义管线

 

自定义管线能力在 3.8 正式开放给开发者，它在 3.8 中还支持了 Custom 管线及其后处理能力，具体定制管线的使用方法可以参考自定义管线的详细文档，也可以参考我们的使用范例。RenderGraph 在 3.8 中的能力升级具体如下：

• 使用 RenderGraph 实现 Custom Forward 管线：Forward + PostProcess，可用于提升现有游戏的画面表现
• 使用 RenderGraph 实现 Custom Deferred 管线：优化架构、可维护性和扩展性
• 新增 Compute Shader 能力
• Pipeline 类型分成了 BasicPipeline 和 Pipeline
• Pipeline 新增 capabilities 接口，可以获取当前硬件平台下管线的能力。
• 重构了 MovePass 与 CopyPass 的接口

Asset Bundle 工作流优化

 

支持单独构建指定 Bundle，便于用户单独更新资源，功能入口位于选中的 Bundle 文件夹设置中。

支持在 Bundle 文件夹设置中添加过滤选项，让用户可以更灵活地筛选 Bundle 内要参与实际构建的资源。 

 

优化 Bundle 配置的平台设置方式，支持预设配置，便于用户精确管理不同平台的导出选项。

 

注意：项目升级到 3.8 后，Cocos Creator 会自动将 Bundle 配置迁移到项目设置内，请在升级后记得向项目源码库（如 Git）提交项目的 settings 文件夹及 bundle 文件夹对应的 meta 文件改动，以免配置冲突。

 

构建时支持只构建 Bundle。

 

构建时支持筛选参与构建的 Bundle，默认全部导出。 

 

模型 LOD 工作流优化

 

我们在 3.7 支持导入 LOD 模型的基础上，支持了在模型中显示 LOD 信息及新的 LOD 自动生成功能，以便用户更轻松简单地使用 LOD。 

用户可以在 3.8 直接导入任何不包含 LOD 的模型，并模型导入选项中设置不同的 LOD 层级，Cocos Creator 会自动进行减面，并且在场景中创建模型实例时自动添加 LOD Group 组件。

 

WebAssembly 统一化升级和支持

 

3.8.0 开始，引擎部分模块开始使用 wasm 实现，目前包括 spine，渲染 webgpu 后端，物理引擎的 bullet 和 physx 后端。在使用时需要注意以下情况：

 

包体占用情况

 

平台使用情况

关于 WebAssembly 未来的规划包括

• 在小游戏平台支持以子包的形式优化 wasm 包体占用 #15493
• 在项目侧实验性地支持 wasm 模块的加载，现阶段还是在引擎侧实验性的支持#14980
• 在原生平台 iOS 端集成第三方 WebAssembly 支持 ，依赖前期调研性能表现#15170

注意

• 微信平台如果开启 wasm 分包，请同时开启物理 wasm 选项，否则会导致引擎启动失败，我们将在 3.8.1 里做一下容错处理
  
  

• 除了微信平台，其他小游戏平台如果开启了引擎 asm.js 分包，需要勾选 spine 模块，我们将在 3.8.1 里处理这个问题，参见 修复 PR

• 由于 PhysX 物理后端的体积较大，目前不支持 wasm 分包

平台支持

 

OpenHarmony 支持

 

Cocos 引擎团队和 OpenHarmony 团队紧密合作两年多以来，一起推动了 OpenHarmony 系统在游戏领域的支撑能力不断提升，在社区版本之后，v3.8 我们正式集成了 OpenHarmony 4.0 版本的支持。并且针对引擎 TS 脚本的性能优化，还开放了 AOT 优化选项，优化 OpenHarmony 运行时性能，参考 AOT 编译指导。

Google Play Games on PC 平台支持

 

在今年 Google IO 大会上 Google Play Games on PC 和大屏体验是受到重点关注的安卓平台更新，Cocos 也被 Google 官方推荐为适配 Google Play Games on PC 平台的引擎和大屏体验的推荐游戏引擎。

 

Cocos 也已经有很多知名游戏登录了该平台，从 v3.8 开始，你只需要在构建 Android 时勾选 x86 架构，以及 InputSDK 选项，即可满足 Google Play Games on PC 的平台要求。该平台是 Google Play 尝试扩展桌面平台的重要机会，同不断出现的折叠屏、平板一样，标志着大屏幕适配对移动游戏来说越来越关键，也可以帮助开发者获取更多用户。

其他

 

其他平台支持方面的更新包括：

• 增加支付宝小游戏平台支持，详情请参考支付宝小游戏发布指南
• Android 支持游戏手柄作为输入设备
• 支持针对单个平台自定义 CLEANUP_IMAGE_CACHE 宏
• Window/Apple 构建添加 Executable Name 字段
  
  
• Android 构建增加 Input SDK 集成选项
  
• Windows 构建新增 CMake Generator / Visual Studio 版本选择项
  
• 支持在命令行构建时，通过 stage 参数指定要单独执行 Make，详见《命令行发布项目》
• 淘宝小游戏新增对 xhr 的支持

Improvements

• 我们在模型导入功能中增加了“填充顶点色”选项。这可以防止缺少顶点色属性的模型在导入时变黑。如果你的材质使用了顶点色，但导入模型没有顶点色，或模型导入时出现异常变黑，建议你启用这个选项。
  
• 自动图集在属性检查器中无需点击保存即可预览
• 浏览器预览时将忽略插屏最小显示时间，在加载完成后立即关闭插屏
• 浏览器预览分辨率支持设为全屏
  
• 预览服务器端口由全局配置调整为本地配置
• 浏览器预览和构建平台预览支持启用 HTTPS 协议，以适配某些特殊环境的安全限制，此功能需在偏好设置的预览选项卡开启
• 偏好设置、项目设置支持导入导出完整配置
  

• 偏好设置的程序管理器支持配置默认图片编辑器

• 新建项目的设计分辨率从默认 960x640 调整为 1280x720
• 层级管理器支持使用快捷键 [ 或 ] 上下移动节点，如果同时按下 Ctrl / Command 将置顶 / 置底节点
• 打开偏好设置、项目设置、动画图等面板时将默认显示在场景编辑器所在位置
• 组件的 @menu 修饰器支持使用菜单路径，示例：
  
  对应的组件菜单显示如下：

  

   

• 新增 `EDITOR_NOT_IN_PREVIEW` 宏，用于简化各类插件和调试代码对编辑器运行环境的判断，为 true 则表示代码在编辑器中执行且场景不在预览状态。示例：
  
  
• 优化渐变色编辑器，支持输入十六进制色值（Hex Color）
• 默认在多显卡电脑上优先使用独立显卡
• 优化了各项编辑器使用体验
  

Fixes

 

Engine

 

详见 引擎完整提交列表

 

Editor

• 修复撤销重做的部分问题，提高 Undo 系统稳定性
• 修复微信小游戏和 iOS 平台会同时显示两个插屏的问题
• 修复资源循环依赖时构建可能卡死的问题
• 修复 Android 平台游戏名称包含中文时构建会失败的问题
• 修复原生平台的游戏名称没有校验的问题
• 修复启动编辑器时脚本可能丢失的问题
• 修复克隆节点时 layer 会变成父节点的 layer 的问题
• 修复设置节点 active 状态时切换场景没有提示保存问题
• 修复嵌套预制体的相关问题
• 修复预制体重写属性信息失效后数据未清理的问题
• 修复预制体的对象引用相关问题
• 修复预制体编辑中粘贴 2D 组件没有正确显示的问题
• 修复物理包围盒修改时影响了其他包围盒的问题
• 修复 `resetInEditor` 在编辑器中没有被调用的问题
• 修复使用反射探针后环境反射偏暗的问题
• 修复平面反射非水平状态下效果不正确的问题
• 修复烘培 GI 材质的光能传递错误
• 修复在使用减面算法对于导入模型进行减面时，模型可能看不到的问题
• 修复编辑器预览时，键盘鼠标事件支持不完整的问题
• 修复资源批量删除时可能会报错的问题
• 对其它编辑器相关问题进行修正
  

Breaking Changes

• Gradle  升级 到 8.0.2 , AGP 升级到 8.0.2. JDK 需要升级到 JDK 17. 同时升级 Android Studio 到 2022.2.1
• 文本底层逻辑调整，深入定制 label 组件能力到 assembler 层的用户需要迁移定制能力到 TextProcessing 中，对上层效果无影响
• 文本高清化处理由于各个平台文本生成的贴图不完全相同，可能会存在与之前版本 1 - 2 像素的渲染差异

Known Issues

• Android Instant App 在 Android Studio Flamingo | 2022.2.1 Patch 2 版本上运行可能会出现无响应的问题，建议在升级前谨慎考虑。
• 长度大于 2048 的 RichText 可能在某些平台上出现换行不整齐的问题，将会在后续版本中进行调整优化。

Fixes

 

Engine

• 修复 Web 音频 destroy 后重新播放，报错的问题 #15235
• 修复 Physics2D Contact 无法 disable 的问题 #15224
• 修复 Spine 组件 UITransform 相关设置,解除对 UITransform 的锁定。新的机制在更改 SkeletonData 时根据资源设置 ContentSize 和 AnchorPoint，用户根据需要自行设置。 #15240
• 淘宝小游戏：XMLHttpRequest 使用 my.tb.request 重新适配 #15238
• 修复 Mac 平台的窗口在屏幕间切换点击失效的问题 #15247

Editor

• 修复编辑器预览启动变慢的问题 #15214
• 修复预制体节点上添加节点撤销重做后调试工具内报错的问题 #15256
• 修复构建时若 Bundle 文件夹内的 plist 图集包含大量小图时可能引发的崩溃
• 修复构建时若资源自身存在循环引用可能引发卡死崩溃
• 修复淘宝小游戏启用引擎插件后 Windows 和 Mac 生成的引擎 MD5 不一致的问题
• 修复构建时自动图集的压缩纹理缓存失效的问题
• 修复动画编辑器循环模式为反向相关模式时，属性检查器上的属性与动画编辑器面板不一致的问题

Scripting

• 修复编译引擎将导致编辑器无法启动的问题
• 修复编辑器启动时，可能由于进程冲突导致脚本丢失的问题
• 修复使用泛型类时，构建可能出现 Unknown node type: "TSInstantiationExpression" 报错的问题

Features

 

Engine

Features

 

Engine

• 增加了 Debug View 在运行时的 UI 控制渲染调试功能
  
  详见 https://docs.cocos.com/creator/manual/zh/shader/surface-shader.html（渲染调试功能 - 运行时使用渲染调试）
• 添加 tween `destroySelf` 方法用于在节点执行动画时销毁当前节点
• 当 UI 元素 Opacity 为 0 时跳过渲染
• 减少微信小游戏在 iOS 14 高性能模式下的 GFX Buffer 内存消耗

Editor

• 支持烘培高精度光照图，获得更好的烘焙效果。当用户开启高精度光照图烘焙时，会使用 16 位颜色代替原本的 8 位颜色，并且会单独烘焙 AO 通道。此功能可以用来解决灯光强度过高时，贴图精度不够而产生色斑的问题，但是缺点是会增大光照贴图包体。
  
  高强度光照时结果对比， 关闭 vs 打开：

• 添加光照探针烘焙预览功能。当用户选择受光照探针影响的对象时，场景内会显示影响该对象的探针，以及在探针小球上显示用于估算该对象光照信息的探针烘焙结果，以便让用户进行更好的调试。
  
  
• 支持烘培单独的 AO 通道，在开启高精度烘焙时自动开启。
• 项目设置内新增默认打开场景，避免其他用户第一次打开当前项目时只能看到空场景。
• 原生平台支持 main.js 构建模板
• 新增层级管理器显示丢失资源的节点列表的功能
  

• 支持拖动 Prefab 到层级面板多选的节点上时，为每个选中的节点批量生成 Prefab 子节点。
• Editor Improvements
• 将顶部项目设置菜单中的光照烘焙条目移动到面板菜单
• 新建的材质以及 standard-material 默认使用 Surface Shader
• 构建面板不够选 Debug 选项时 Android Studio 将以 Release 配置运行
• 整理了引擎内置的 effect 文件结构（不影响已有项目）内置着色器 · Cocos Creator
• 补充了常用材质参数的 Tooltip
• 优化漫游场景编辑器滚轮 / 触摸板的体验
• 优化扩展管理器的搜索功能，现在可以同时搜索“官方扩展”、“内置扩展”、“已安装扩展”
• 场景编辑器支持在使用矩形变换工具时通过单击选中下一个节点
• 优化场景 Skybox Envmap 参数的 UI 交互

 

Fixes

 

Engine

• 规范数学库 normalize & angle实现
• 修复字节平台 iPad 屏幕显示不全的问题 
• 修复 facebook instant games 无法启动的问题
• 修复更新节点 sibilingIndex 触摸排序没有同步更新的问题
• 修复 Mat4.getRotation 计算结果可能不正确的问题
• 修复 Label char 模式在原生平台的颜色异常的问题
• 修复 2D 模块的内存泄漏
• 修复原生端 LOD 计算屏占比时使用局部坐标导致计算错误
• 修复通过 MeshUtils.createMesh 创建的 Mesh 对象导致数据异常的问题
• 修复 sevalue_to_native 转换 std::function<...> 不支持 null/undefined 的问题
• 修复 Mesh::_hash 属性的 setter 没有绑定的问题
• Editor
• 修复 bundle 脚本依赖 import-map 导致不能跨项目复用的问题
• 修复扩展里的项目脚本无法在模拟器里加载的问题
• 修复导入插件脚本超过 500KB 的报错
• 修复自动图集的纹理压缩配置失效的问题
• 修复自定义纹理压缩工具配置无效的问题
• 修复项目升级到 3.7 后，引擎模块配置可能被还原的问题
• 修复微信小游戏平台自定义首屏模板文件无效的问题
• 修复命令行构建偶现资源丢失问题
• 修复构建 JSON 分组可能导致构建变慢的问题
• 修复主光源在烘培后仍然对地形起作用的问题
• 修复光照和反射探针相关的若干预览及数据更新问题
• 修复编辑器预览时，鼠标和触摸事件多次触发以及鼠标左右键无法识别的问题
• 修复编辑器预览时 tween color 会报错的问题
• 修复退出编辑器预览时可能报错的问题
• 修复粒子曲线面板部分属性不显示负轴的问题
• 修复动画编辑器新建或切换动画 clip 后关键帧数据未刷新的问题
• 修复剔除了 3D 模块后使用动画编辑器报错的问题
• 修复退出并不保存编辑中的材质时，场景预览状态未回退的问题
• 修复预制编辑模式下，删除有子节点的节点再撤销后数据出现异常的问题
• 修复没有调用组件的 resetInEditor 生命周期函数的问题
• 其它细节问题修复

Features

 

Engine

• Add more API docs (engine#13937, engine#14079, engine#14088)
• [Optimize] add image asset’s zh i18n (engine#14108)
• [Optimize] Add pointerlock function for mac platform (engine#14187)
• [Pipeline] enable custom pipeline in the editor (engine#14084)
• [Pipeline] add native pipeline ubo uploading (engine#14061)
• [Pipeline] Fix web-pipeline ui in post-processing (engine#14145)
• [Pipeline] Disable over-aligned memory allocation (engine#14164)
• [Pipeline] Refactored web profiler and native framebuffer (engine#14168)
• [Pipeline] Refactored custom-pipeline initialization (engine#14176)
• [Pipeline] Fix memory leak of pipeline JS binding objects (engine#14190)
• [Pipeline] Resource states & fgd signal split end barrier (engine#14207)
• [Pipeline] Fixed transparent pass barrier issue (engine#14218)
• [XR] AR engine module update

Editor

• 支持 Light Probe 方向光的直接光照
• 开放更多的 FBX 导入项中的 Mesh 减面参数，以获得更好的减面效果
  
  

 

Fixes

 

Engine

• Fix shadowmap lowp with huawei and reflection probe brightness (engine#14058)
• Fix shader compilation error with the new version of lightmap (engine#14071)
• Fix unsynchronized model data issue when adding lod levels dynamically (engine#14054)
• Fix the issue that lod is not working properly when forced to use certain levels (engine#14055)
• [Physics-2d] Fix box2d syncRotationToPhysics’s euler angle calculation issue (engine#14048)

Editor

• 修复模型减面配置里废弃的 gltfpack 减面算法无效
• 修复动画编辑器事件编辑面板显示异常
• 修复偏好设置中图片默认导入类型（Preferences - AssetDB - Default import image type）重启后失效的问题 #14176
• 修复升级 3.7 后，偏好设置程序管理器（Preferences - Program Manager）配置可能无效的问题
• 修复部分 3D 物理后端配置在编辑器预览中没生效的问题
• 修复 DPI 超过 2 的 Windows 设备上场景点击不准确的问题
• 修复场景编辑器相机 FOV 设置引发的 gizmo 显示异常
• 修复新建 Canvas 节点时，可能出现 layer 未选中 UI_2D 的问题
• 修复 Lightmap 聚光灯渲染错误
• 修复自定义纹理压缩工具不支持项目相对路径的问题
• 修复构建插件获取 result.settings 无效的问题
• 修复构建使用 application.ejs 模版时，构建结果多出 application.ejs 文件的问题

Cocos Creator 3.7.0 是我们在不断挑战和提升自我路径上的又一力作。为了应对爆发的元宇宙需求以及支持更流畅更真实的 3D 世界，我们在渲染效果、GI 全局光照、LOD、动画系统、物理系统、易用性以及性能方面进行了众多提升。由于 3.7 版本更新众多，包含了大量的体验优化和缺陷修复，在此只列出重要更新，其余更新可以参考我们 GitHub 上的更新列表。

 

场景渲染

光照探针

GI 全局光照是提升 3D 渲染真实感的关键基础设施。在此之前， Lightmap 可以用来烘焙静态物体的间接光照，但是对场景中的动态物体则无能为力，如角色和场景中移动的物体，这样容易造成视觉效果不统一的问题。光照探针可以提前通过烘焙记录空间中各点的光照信息，然后在物体运动时根据记录在探针中的结果模拟间接光照，对场景中的动态物体也提供高质量的全局光照支持。同时，光照探针还具备良好的运行时的处理性能，预计算也相当快。更多介绍详见《光照探针》。

应用光照探针的角色：

使用光照探针实例化绘制的球体：

光照探针编辑：

反射探针

为了进一步提升渲染效果以及提升 3D 项目的沉浸感，我们加入了反射探针支持。它可以在场景中带有反射性质的材质上，渲染出真实的对周边环境的反射，此功能对画面的真实感提升是非常巨大的。它通过空间内某一点对附近区域的环境进行烘焙，在把周围环境信息储存后，应用在范围内有反射材质的物体上以实现真实环境反射的一种手段。在 3.7中，我们加入了具有两种模式的反射探针：Cube 烘焙模式用来烘焙一定空间范围内的立体环境。Planar 平面实时反射模式主要用来模拟平面上的反射，如光滑地面、水面等。更多介绍详见《反射探针》。

 

 

 

模型 LOD

LOD（Level of Details）是常用的一种大型场景优化手段，核心在于对远处或者不重要的物体，降低其显示细节，以达到提升渲染效率的目的。3.7 加入了模型 LOD 支持，可根据物体显示在屏幕上的尺寸比例，动态切换合适的模型精度，节省渲染资源。更多介绍详见《多层次细节》。

 

CSM 阴影层过渡

CSM 层级阴影最明显的一个效果问题就是在不同层级之间的阴影精度不同，导致在接缝处可能产生比较违和的割裂感，尤其是随着相机的移动，不同层级的拼接位置也在不断变化，导致很容易被发现的接缝移动现象。在 3.7 中，我们新增了 CSM 层过渡的支持，混合不同层级的渲染效果，使两个 CSM 阴影层级间过渡更加平滑。

 

后处理流程：Bloom & FXAA

基于 RenderGraph 的 自定义管线 中新增了 Bloom 后处理特效和 FXAA，将作为后处理定制的标准方案供大家参考。与旧的渲染管线难以扩展与配置不同，新的基于 RenderGraph 的自定义管线的可插拔结构使扩展管线的功能更加容易，同时对于 Forward/Deferred 渲染的输出结果进行后处理特效（如：Bloom 等）的新增也会更加便捷。

 

编辑器

原生场景编辑器（实验性）

3.7 的场景编辑器可以运行在以 C++ 为基础的 Windows/Mac 原生 Cocos 引擎之上，而不是原先以 JS/WebGL 为基础 HTML5 引擎。这意味着编辑器有潜力充分发挥 Cocos 引擎在原生端的性能优势，为各类元宇宙场景、3D 开放世界做好准备。此功能目前处于实验性状态，需在偏好设置 - 实验室开启 Use native engine for scene editor 开启试用。开启后，编辑器支持打开一个与 Scene 并存的独立 Game 面板，用于多窗口项目预览以及调试。

 

全新扩展管理器

3.7 升级了扩展管理器，采用了全新的 UI 并且支持一键安装和更新扩展插件，还支持记录和安装项目所依赖的扩展，让项目的分发更加方便。

为了实现更好的版本管理，提高扩展稳定性，新版扩展管理器也调整了一些管理机制：

1. 3.7 开始编辑器将不再读取全局目录下的扩展，老项目升级到 3.7 时将会自动复制全局插件到项目中。此功能通过配套的 Dashboard 1.2.4 实现，请先确保本地 Dashboard 已自动更新至 1.2.4 版本。
2. 从扩展管理器中安装的扩展将记录依赖关系，通过 Dashbord 1.2.4 以上版本打开项目时会自动检查并安装依赖的扩展。此功能目前还不支持 Store 中的插件，我们将在之后的版本中继续完善。
3. 开发中的插件可以通过点开扩展管理器上方的导入按钮小箭头，选择开发者导入（Developer Import），此功能将为外部插件创建软链接到项目中，避免了插件同步问题。
4. Store 中的插件如需共用，在 3.7.0 仍与之前一致，需要在各台电脑上分别手动安装，或者将插件内容上传到 Git 版本库。

插屏设置功能更新

插屏设置用于在游戏启动时对 Cocos 或您的品牌进行露出，同时加速首屏启动时间，给用户更好的体验。在 3.7 我们开始着手对此前维护力度不足的插屏设置功能进行翻新，在收集了不少用户反馈，结合 Cocos 自身的业务需要后，插屏设置功能得到了初步重构。目前做出的主要调整如下：

• 暂时移除问卷调查界面，可以自由开关插屏显示（将来问卷仍会是必要的）
• 移除背景颜色设置功能，目前仅支持黑色
• 最小插屏显示时间修改为 500 毫秒

项目设置：

构建面板：

 

资源管理

• 支持压缩纹理启用 Mipmaps，启用后编辑器会将压缩纹理的 Mipmaps 预先生成并一同导出。
• 新增 .exr 图片格式支持
• 支持翻转图片绿色通道
  
  
• 在编辑器的资源管理器移动或者重命名 ts 脚本时将自动更新 ts 中的导入路径，如需开启此功能请在偏好设置中的实验室开启此项开关
  
  
• 新增了 Mesh Optimizer 的 simplify 减面算法，新的算法不再改变 Prefab 结构，并且 fbx 减面效果更稳定，不易丢失材质。
   

网格体 UV 检查

3.7 支持在 Mesh 的属性检查器中显示各个通道的 UV，方便用户快速确认导入模型的 UV 或者 Lightmap 的 UV 是否正确，是否在（0，1）的区间内，是否有重叠等信息。

 

框架能力

Marionette 动画系统

支持动画图变体。动画图变体是一种新的动画资产类型，允许用户在一个动画图的基础上创建变体，使其有可能在不同的角色上重复使用同一个动画图：

 

动画状态机混合预览面板更新，支持用户更直观方便的在动画图中预览混合的结果

• 动画图支持节点拷贝粘贴功能
• Class AnimationController 增加了动态覆盖动画图谱中的动画片段的方法
• Class AnimationController 增加了查询动画图谱中层数的方法
• 动画图编辑器：增加了一个右键菜单，可以把运动状态变成 sub-statemachine 状态
• 优化了状态读取方法

优化粒子系统性能

调整 CurveRange 的构造逻辑，延迟构造底层曲线数据，同时优化了内部装饰器，加快粒子系统初始化速度。在不同复杂度的粒子下均有可观的性能提升。

和 3.6.2 粒子加载速度对比（加载时间越小，加载速度越快，粒子使用的功能模块越多，提升越明显）：

 

其他性能优化

除了粒子加载速度以外，其他不少模块也有了不同程度的性能优化，其中包括以下几个比较显著的方面：

注：图示中每个平台下都会不断增加负载进行性能测试数据采集，不同平台之间负载并不一致，统一在帧率上进行差异展示，所以数值越高越好

1. Frame Animation 帧动画
   
   
2. 3D 模型渲染
   
   
3. 3D 物理
   
   

 

3D 物理系统

• 在物理系统中添加固定约束 FixedConstraint
• Point2Point 约束在 PhysX 物理物理后端使用 SphericalJoint 实现
• 物理系统支持 lineStripCast, 用于近似曲线检测 
  
  
• 默认物理材质支持在项目设置中通过文件配置
• 修复了 bullet 刚体无法休眠 sleep 的问题
• 对 Bullet MeshCollider 设置 mesh 的时间提升了大约 100 倍运行速度
• 修复了 bullet 内存释放的功能
• 修复 PhysX 后端在刚体生成后动态设置 Mesh Collider 的 convex 属性失效的问题
• 统一各个物理后端在节点缩放时 cylinder collider 和 cone collider 的表现
• 修复 PhysX 原生后端（C++）发送大量错误事件的问题

2D 物理系统

• 修复 box2d shape2d中apply() 方法没有对 node 以及碰撞体状态进行判断的问题
• 修复 box2d 中 syncRotationToPhysics() 没有使用场景节点的世界旋转的问题
• 修复 box2d 中 aabb 准确度的问题
• 修复 box2d joint2D anglelimit 中角度转化问题问题
• 修复 physics2d-builtin shape 编组时的没有检查 Collider 状态的问题
• 新的 Physics2d Box2d::syncSceneToPhysics() 方法
• 修复 builtin-2d-physics removeShape() 速度慢的问题
• 添加了新的多边形切分算法：Hertel Mehlhorn
• 优化 physics-2d 中没有 connectedBody 时的设置
• 支持在编辑器中切换 physics-2d 后端

更多

• 【场景渲染】增加 Sorting 渲染排序组件，并提供排序层顺序编辑接口，用户可以使用此组件控制 MeshRenderer 或者 SpriteRenderer 的渲染顺序
• 【场景渲染】增加 FXAA HQ 以修正某些场景下物体边缘的虚影
• 【场景渲染】优化各类与渲染相关的默认值，如默认的 PBR 材质参数、默认天空盒、太阳方向等
• 【新建项目】添加了一个新的高质量 3D HQ 模板，默认开启阴影与光照等相关设置以达到更高质量的渲染效果，省去了手动开启场景、物体、灯光等多重阴影和光照的设置过程
  
  
• 【构建发布】支持 Facebook Instant Games 发布平台，详见《发布游戏到 Facebook Instant Games》
• 【构建发布】集成微信小游戏高性能模式开关
  
  
• 【构建发布】支持在构建过程中通过点击 “x” 按钮中断构建任务
• 【构建发布】支持构建任务排队，多平台构建时会更加方便
• 【场景编辑】为参考图像添加缩放属性
• 【场景编辑】场景摄像机添加曝光相关属性
  
  
• 【编辑器】对动画编辑器的显示布局以及操作进行了优化，提升易用性以及用户体验
  
  
• 【编辑器】资源管理器支持文件夹多选编辑
• 【编辑器】将项目设置中的物理配置调整为物理材质，旧项目的配置将自动迁移为物理材质
• 【编辑器】移动 Joint Texture Layout 到项目设置中
• 【编辑器】移动创建构建扩展到创建扩展面板。点击“创建扩展”后会跳转到创建扩展面板，然后在创建面板中选择模板，完成详细设置，创建成功会自动打开插件所在目录。
  
  
• 【框架能力】节点提供了新的 Mobility 属性用于 Lightmap 烘焙设置：
  
  
  • Static：视当前节点为不可移动物体或光源，烘培 lightmap 的直接和间接光
  • Stationary：视当前节点为不可移动高光光源，只烘培 lightmap 的间接光照和遮挡，直接光（高光等）仍实时计算
  • Movable：视当前节点为可移动物体或光源，不参与烘培 lightmap
• 【框架能力】优化了刷新 layout 布局的机制，删除了 layout 布局必须有子节点才会更新的限制
• 【原生框架】切换到 swig 来生成 JS 绑定代码，旧的 bindings-generator 工具现在已经废弃，生成所有 JS 绑定代码的时间成本减少到 3~5 秒
• 【原生框架】优化了 se::Object 的构造和销毁，删除了不使用的哈希操作
• 【原生框架】增加 se::Object:createObjectWithConstructor 方法，在 CPP 代码中通过 JS 构造器创建 JS 对象
• 【原生框架】支持在本地桌面平台（Windows、Linux、macOS）上向执行文件传递命令行参数
• 【原生框架】增加对 se::Object 创建、修改、检查 ES6 Map/Set 的支持
• 【原生框架】提供 cc::event::EventBus 和 cc::event::EventTarget，以简化引擎内的事件调度
• 【原生框架】删除 BaseNode 类，使用 Node 类来代替
• 【原生框架】native.Downloader 支持中止功能
• 【原生框架】支持 ios websocketServer
• 【原生框架】在 function-corpping 中添加网络模块
• 【原生框架】为 setUniform 添加预类型验证器
• 【原生框架】优化引擎包体
• 【文档】补全部分缺失的 API 文档，优化 API 文档内容

在 3.6.3 中，我们新增了淘宝小程序创意互动平台的支持，同时还完成了一系列关键性的缺陷修复，建议所有 3.6 用户升级。

 

Features

 

优化原生 Spine/DragonBones 性能 #12788。我们在 3.6.2 重点优化了原生上 Spine 的运行性能。在 iOS 较低端设备上最大达到了 40% 以上的性能提升。在 Android 平台也有较为可观的性能提升。

 

[实验性功能] 我们在 Web-Desktop 平台新增了基于 wasm 的面向未来的渲染后端——WebGPU（Chromium 105）。未来会基于 WebGPU 后端逐步接入如 ComputeShader 等功能特性，对 Web 平台的渲染能力提升具有重要作用。WebGPU 相关介绍可以参考 https://www.w3.org/TR/webgpu/

 

Engine

• 从材质选项中移除 Batching 合批（不推荐使用此合批模式，请改用 Instancing 合批）#12892
• 支持 Spine/Dragonbones 组件合批渲染功能 #12847
• 修复 Spine 二进制格式资源解析错误 #12894
• 修复 Instancing 合批相关的一些错误 #12786
• 更新默认天空盒素材 #12917
• 修复 Android okhttp 没有主动调用 close 的问题 #12783
• 修复请求下载资源时无法解析 URL 中空格的问题 #12826
• 添加设置 uniform 时对 FLOAT3 形式 Color 的兼容 #12962
• 修复原生端设置字体时对特殊名称(如 OpenSans-BoldItalic)的解析问题 #13048
• 修复 Graphics 组件内凹形状错误的问题 #13037

Editor

• 修复 Camera 组件 Visibility 属性在 Inspector 中不加载用户自定义 Layers 的问题
• Bundle 名称的界面校验规则调整为仅支持数字字母下划线减
• 修复复制粘贴相机节点报错问题
• 修复从动画编辑切换到预制体编辑时预制体数据异常问题 #12752
• 修复场景编辑的正交视角效果错误问题
• 修复自定义脚本中的属性引用的子类是预制体子节点时不能正常保存的问题
• 修复编辑器预览暂停时，选中相机时的小窗分辨率不符合设置的问题
• 修复构建插件 asset-handler 机制失效
• 修复修改偏好设置->默认图片资源导入类型配置后报错

 

Known Issues

• 在 3.6.2 版本中，我们在原生平台上将 Spine 的更新逻辑迁移到了 C++ 环境中以获得更好的性能。因为 C++ 环境中的垃圾回收机制不同，实现了此方案之后，在某些使用情况下，会出现引用悬挂指针的报错。请在开发中尽可能避免以下使用方式：1. 操作未加入到场景中的节点上的数据（包括组件数据），2. 在回调中需要对节点操作时使用 isValid 判断节点是否存在。我们将在 3.6.3 中修复此问题。
• 在 WebGPU 后端使用带半透明度像素的图片时可能出现预乘透明通道的问题，可以通过调整材质混合模式临时解决
• 在 WebGPU 后端 CopyTextureToBuffers 接口目前暂不支持

3.6.0 发布后，我们收到了不少开发者的反馈，非常感谢大家一如既往的支持。3.6.1 对这些问题集中进行了修复，提升了用户体验，也对一部分性能进行了优化，建议所有 3.x 用户升级。

 

除此之外，Cocos Creator 的官方 XR 内容开发插件 Cocos CreatorXR 也已适配 3.6.1。它在底层通过支持 OpenXR 标准协议来抹平不同 XR 设备之间的差异，可以一站式对创作内容进行开发并发布到不同的 XR 设备中而无需去适配不同设备的 I/O 项；中层封装了一系列不同功能的 XR 中间件来提供 XR 内容创作支持，并支持用户自定义扩展组件内容；上层基于 Cocos Creator 面板扩展出多种形式的 XR 功能菜单和组件样式，为用户提供更为便利的内容创作界面。开发者可通过 Dashboard 新建 3.6.1 项目，选择对应的模板/案例来自动安装 Cocos CreatorXR 插件，详见 Cocos CreatorXR 介绍。

下面是这次更新的主要内容：

 

Engine

• 增加了原生平台保存图片数据的功能 #12503
• iOS 文本支持阴影、斜体 #12421  #12382
• Windows 端现在可以正常播放 wav 音频
• 优化部分支持 JIT 平台的动画系统性能 #12308
• 优化了 iOS 平台的部分 UI 性能 #12390
• 重构 Mask 组件，不再继承而是持有一个渲染组件，避免在 3.6.0 版本对子节点的侵入操作 #12636
• 优化原生 Websocket onclose API 与 web 标准保持一致 #12370
• 为原生平台上的数学库添加 approxEquals 方法，用于判断是否近似相等  #12610
• 优化原生平台上 JSBClassType::findClass 的效率 #12548
• Android 减少非必要的第三方库连接, 包体最多减少1.4M #12537
• 修复 iOS 多任务下载时造成的中断#12743
• 修复解析 HttpRequestHeader 时可能出现的空格未修剪问题#12757
• 修复裁剪依赖模块时可能造成的资源丢失问题（如裁剪2d模块造成的particle-2d模块资源丢失）#12602
• 修复 tiledtile 移动无效的问题 #12377
• 修复 3.6.0 版本 spine/dragonbones 功能裁切问题 #12605
• 优化 spine 内存使用 RGBA8 颜色格式#12619
• 各向异性材质参数可以对接 Substaince 等材质库#12371#12376
• 修复 Android 平台上 Downloader 连接超时设置错误的问题 #12642
• 修复原生平台上 jointTexture 配置无效的问题 #12639
• 修复原生平台上 mesh.minPosition/maxPosition 返回的不是 Vec3 类型的问题 #12628
• 修复原生平台上 Node::isChildOf 触发崩溃的问题 #12493
• 修复原生平台上 DEBUG 模式下 ValueArrayPool::get 函数可能触发断言的问题 #12499
• 修复 Windows 平台工程路径包含空格导致 Android 构建报错的问题 #12754
• 修复 Fog 和 Debug View 的一些显示问题 #12571#12343
• 修复安卓平台遇到的音频卡顿问题 #12589
• 修复 AudioSource 切换 clip 时的内存泄漏 #12592

 

Editor

• 支持 tif 和 tiff 格式图片
• 支持 Windows 构建进度同步显示在任务栏
• 允许脚本内数组属性的修饰器影响子元素
• 支持 Marionette 拖动 transition 对 priority 进行排序
• 优化动画编辑器事件处理，函数名不能为空
• 支持命令行构建使用界面预先配好的配置
• 支持偏好设置 - 自定义引擎设置项目中的相对路径
• 优化场景编辑器启动流程，加快启动速度
• 当 png/jpg/webp 图片压缩质量设为 100 或者压缩后大小超过原图时将会直接使用原图
• 修复编辑 SpriteFrame 后，场景内的 Sprite 可能不渲染的问题
• 修复 Prefab 内修改 scale 无法在场景内实时生效的问题
• 修复构建 onBeforeMake 和 onAfterMake 回调不触发的问题
• 修复动画编辑器，使用节点过滤功能后节点显示异常的问题
• 修复将子节点挂载到其他节点后，删除父节点的时候场景数据会有残留的问题
• 修复脚本内使用 SpriteFrame 资源的时候 name 可能丢失的问题
• 修复 webp 格式导入成 cube 后，生成的文件扩展名错误的问题
• 修复场景 "create-component" 消息接口无法接收组件名字的问题
• 修复 ui-asset / ui-component / ui-node missing 状态显示不正确的问题
• 其他编辑器细节体验完善

 

Known Issue

• 升级到 3.6.1 后，L10n 做为实验性功能还需启用一个外部插件才能正常使用，如有需要请移步论坛帖 3.6.1 L10n 安装补丁 下载插件。

在 Cocos 团队内部，我们一直将 3.6 作为 3.0 的合并版本之后最重要的里程碑版本来看待，一方面这个版本的迭代周期是迄今为止最长的一个版本，另一方面是因为这个版本在多个方面的大幅进化。下面就是 3.6 版本的更新说明，由于更新数量过多（engine：1110 PRs，editor：678 PRs），在此只列出相对重要的更新。

 

图形渲染

 

Surface Shader 自定义材质

Surface Shader 使用统一渲染流程和结构，可以让用户以简洁的代码创建表面材质信息，指定用于组合的光照和着色模型。相比旧版（Legacy Shader）的优点是更易书写和维护，有更好的版本兼容性，也更不容易产生渲染错误。并且可以从统一流程中获取很多公共特性，如统一的全场景光照和 Debug View 调试功能等。

Creator 也更易扩展出多种常见的复杂材质提供给用户，未来还会支持 Shader Graph 自动生成 Effect 代码，可以极大提高 Shader 开发者的效率。

 

CSM 级联阴影

普通的阴影贴图有一个致命弱点：当投影面积较大时，对阴影贴图分辨率的需求会超出硬件承载极限。如果不提高分辨率会导致阴影锯齿严重、形状缺失、不清晰，但减小投影面积又会导致阴影可视距离非常短。在阴影可视距离和阴影效果上的平衡调整是一个非常令人头痛的问题。

 

CSM将视锥按远近顺序划分为多块，近处投影范围更小而远处投影范围更大，相当于一个自适应的阴影贴图，从而提高数倍贴图利用率。它可以在较大的阴影可视距离上具备精细的阴影效果，再也不用把精力花费在参数调校上了。

 

 

新增 Rendering Debug View 模式

多种自定义的显示模式，帮助用户更快定位各种材质、光照、阴影显示问题，以及方便用户查看更清晰的特定场景信息，帮助用户做出优化决定。

 

GGX 环境反射卷积图

由于精确光源的高光都是使用 GGX 的 BRDF 分布，对于环境光源而言也必须使用同样的 BRDF 做球面卷积才可以让两种光源的光照效果对应。此外不同粗糙度的反射光照是存储在对应的 Mip 中，相比于自动生成的 Mip 数据，卷积计算可以修复以下问题：

• 环境高光的泛光和拖尾现象被极大的削减了
• 与 Substaince 的标准 PBR 材质工作流效果对不上
• 平行光高光和环境光高光效果对不上

如图所示：

自动 Mipmaps

 

GGX 卷积

 

GGX | 平行光 | Mipmaps

 

各向异性光照模型

通过 Surface Shader 带来的好处，我们可以充分扩展 PBR 光照模型。在 3.6 已经完整支持了在精确光源和环境光源下，各向同性和各向异性的材质与光照模型。可以对接 Substaince PBR 材质库，制作拉丝纹路的金属、头发、丝绸等等。

 

 

其他

1. 支持设置 Skybox 材质
2. 增大材质的 Normal Strength 范围
3. 新增 GLTF specular-glossiness workflow 支持
4. 更新默认 FBX surface phong 材质支持
5. 扩展 Blender principled bsdf 材质的 Specular 通道支持
6. 添加 mixamo.com 模型材质导入支持

 

 

编辑器体验

 

UI 全面升级

V3.6 启用了全新的编辑器 UI，本次改版围绕「更协调」的视觉系统、「更科学」的视觉反馈、「更沉浸」的交互感受，对 UI 和交互进行了一次全方位的梳理。我们希望通过交互来改善视觉感受，通过视觉来影响交互体验，并从这两个层面进一步提高用户体验。未来我们将继续基于 Cocos 的设计目标、设计系统、设计原则进行规范化设计，持续更新迭代，优化核心交互和工作流程。

 

内置编辑器预览模式

开发效率是 Cocos Creator 非常重视的一项核心优势，在 v3.6 中这项优势得到了进一步提升。除了网页预览和模拟器预览，现在开发者还可以使用「编辑器预览」来运行游戏。编辑器预览将在场景管理器中直接执行游戏逻辑，并且可以实时调试游戏场景。一方面带来更无缝的预览体验，另一方面也补足了在调试方面的短板。

 

此功能目前处于实验性阶段，欢迎大家在使用过程中给我们更多反馈。未来我们也将持续关注研发效率，在脚本编译、项目调试、构建发布环节持续提升用户的幸福感。

 

动画嵌入播放器

动画编辑器新增了嵌入播放器功能，可以在任意动画中嵌入其他粒子和动画，并用类似视频剪辑软件轨道的方式进行编排，自由调整时长和播放位置。

 

在完成编辑之后，嵌入播放器的内容会伴随此条动画剪辑（AnimationClip）一起播放，在 Animation 组件和动画图系统中都能支持。此外，动画嵌入播放器支持添加到 FBX 导入的动画上，可以实现更灵活的特效控制，解决了导入动画难以二次编辑的问题。

 

目前在 3.6 中提供了粒子和动画两种播放器，可以在实验室设置中启用。

 

集成多语言支持

为了更好地服务开发者出海，v3.6 提供了内置的多语言工具 Localization Editor（L10n），目前支持文本翻译和资源替换。其定位是与 Creator 深度集成，通过高自动化提高翻译的效率，并且以无代码的方式降低使用门槛，达到任何人都可以开箱即用的目的。

 

包含的核心功能为：

1. 支持机器翻译，目前接入了 Google、有道翻译
2. 支持一键提取各类需要翻译的内容
3. 支持 Excel、csv、po 文件批量导入导出
4. 支持多语言实时预览及资源替换

Localization Editor 目前处于实验性阶段，未来将提供更丰富的游戏本地化能力，欢迎大家提供反馈。

 

场景编辑器

• 支持表面吸附和顶点吸附

表面吸附 Surface Snapping（按住 ctrl/cmd + shift）

 

顶点吸附 Vertex Snapping（按住 v）

 支持框选功能，可以批量选中多个物体

构建能力

1. 可以在构建任务中自由选取和组合 Build、Make、Run 等子任务执行
2. 资源服务地址已作为全平台共用参数，支持一键使用构建内置服务器，方便本地开发测试
3. 优化了构建内编译引擎与编译脚本的任务调度，独立进程执行，降低构建进程对内存的占用
4. 允许在偏好设置内添加自定义 cmake 工具供原生构建使用
5. 构建钩子函数支持 onError 钩子函数用于捕获构建失败的情况
6. 允许在偏好设置里关闭构建纹理压缩、引擎、自动图集对缓存的使用

其他

1. 支持 Mesh 资源的缩略图显示
2. 支持取消对场景编辑器的帧率限制（实验室功能）
3. 支持直接在 assets 面板筛选 Bundle 文件夹，快速找到 Bundle

 

 

基础设施

 

原生化层级上升

从去年 3.3 版本发布之后，其中最重要的原生化团队就开始了针对 3.6 版本目标的开发工作。这么长的周期其实往往是一些底层根基性重构所必需的，而商业引擎服务于全行业的特殊性决定了它既要紧跟硬件的发展不断挑战最好的性能、最优秀的画面表现力，还要在生产端不断提升生产效率，保持对项目的兼容性和对不同硬件环境的伸缩性适配。这些挑战意味着引擎需要对底层框架进行持续的迭代和重构，有时候是破坏性的，比如从 2D 引擎进化为 3D 引擎，而大多数时候这种迭代是延续性的，比如我们在 3.6 的原生化进展。尽管花费了我们团队一年的时间，进行了多个阶段和多个模块的重构，原生层代码增加了两倍多，但我们仍然在大幅度优化性能的基础上做到了对老项目的兼容。这样的底层重构一方面带来了可见的性能和表现力提升，另一方面，我们往往是为了未来的进一步迭代做好准备，扫清障碍。从 3.6 这个版本的缩影大家可以看到引擎开发永恒的命题：持续不断得自我变革，以适应硬件的更新和用户需求的变化。

 

 

2D 渲染性能

3.6 还有一个重要的具有里程碑意义的标志，那就是在 2D 渲染性能上和 2.x 达到了同样的水准，代表着 2.x 用户如果有 3D 需求或持续迭代需求可以放心升级到 3.x。在底层原生化的基础之上，我们进一步将 2D 渲染数据结构、2D 合批管理器和渲染流程都原生化了，让 2D 的合批和提交渲染的流程都在原生进行，以达到类似 2.x 的性能表现。当然，现阶段还有部分遗留的工作没有完全完成，比如 Spine 的合批支持，但这也代表着在原生化的基础之上，3.x 的 2D 渲染性能还将有更高的天花板等待我们去突破。

 

 

 

 

添加原生插件能力

原生插件可以链接开发者现有的 C/C++ 代码库，绑定接口到JS层并在不同项目间重复使用。 

 

通过利用 CMake 的能力，插件能灵活地集成源文件、静态库或动态库。C/C++ 接口可以直接使用传统的自动/手动绑定机制，也可以使用3.6 新增的 sebind 高阶接口导出到脚本层。 开发完成后，原生插件可以 zip 包的形式单独分发， 也可以打包到 编辑器插件 一并发布。

 

详细使用方式请参考 使用文档 和 使用范例。

 

其他

1. 添加更易用的高层 JS 绑定 Sebind
2. 集成 Android Game Activity
3. Downloader 支持在 iOS/Android 平台的断点续传
4. 添加 `settings` 模块以便用户访问，保存了用户预设的运行时项目配置
5. 重构引擎启动流程，简化 application.js 逻辑，增加启动阶段的事件

 

 

框架能力

 

Marionette 动画系统更新

• 动画图支持动画预览
  编辑动画状态机时可以实时预览，过渡与混合的效果，快速调试，无需每次修改之后都要运行游戏才可以查看结果。

• 动画图支持变量和 Layer 重命名，支持更清晰的自定义的名字，方便修改。
• 动画图支持过渡线的排序， 清楚看到过渡所使用的优先级。
• 动画图增加了 “终点起始时间” 属性，允许过渡的目标动画从指定位置开始播放。
• 动画图现在可以将某个过渡配置为可中断的，以允许指定的过渡被其它的过渡中断，该功能可在实验室设置中启用。

 

粒子系统更新

• 新增粒子噪声图模组，为粒子带来更自然，更加可控的随机运动效果

• 支持 Instanced Mesh，提升发射器的性能
• 修复粒子编辑面板不支持 Undo 的问题，方便调试
• 支持子节点树的组合粒子预览控制

 

 

其他

• Mesh 支持动态类型，可以在运行时通过 API 更新网格数据

 

• GeometryRenderer 增加曲线类型 Spline（支持 Linear, Bezier, Catmull-Rom 曲线）

 

• 支持 3D 空间 SpriteRenderer
• 在 UI 顶点数据中填充 z 值，以便支持 UI 的 3D Transform
• 支持渲染组件的优先级排序
• 支持音频 PCMData 和 sampleRate 获取
• 地形画刷支持旋转
• 支持地形高度画刷

 

• Light map 烘焙器支持使用 tga 贴图格式
• MeshRenderer 会自动设置渲染用的 Light map 资源
• 更新 iOS 原生 EditBox 样式

 

 

DCC

 

FBX/GLTF的 Phong 和 PBR 材质智能导入

3.6 在材质导入上实现了对 Diffuse-Specular 材质模型（包括 Phong 和 SpecularGlossiness PBR）的支持，可将材质参数智能转换到标准 Metallic Roughness PBR 模型中。这样就可以在不更改光照模型的情况下获得接近原 DCC 软件中的材质表现。

 

Blender |未使用材质转换 |使用材质转换

 

使用 Phong 材质的 FBX 智能材质导入

 

不再默认拆分模型

 

之前的版本由于 uniform 的限制，在 CPU 计算的骨骼动画中，当骨骼数量超过一定值后，无法一次性通过 uniform 存储所有骨骼数据，所以我们在模型导入时有可能拆分模型和骨骼。所以经常收到反馈说自己的一个角色模型会占用多个 DrawCall，主要原因就是这里被自动拆分了。更重要的是由于拆分不能在运行时进行，只能在离线进行，所以我们的拆分标准使用的是最低端的运行时设备和驱动（iPhone 6 WebGL），对骨骼数量限制很大。

 

所以，Cocos Creator 3.6 对这一问题做了策略优化：

• 默认情况下不再拆分模型，不对导入的模型数据做修改（也维持以前的模型设置不变）
• 如果骨骼数量未超过实际运行时驱动的限制，直接使用 uniform 传递
• 如果骨骼数量超过限制，则使用纹理传递

 

使用纹理传递骨骼动画数据的方式需要在顶点着色器中访问纹理，这一特性最低支持为 OpenGL ES 3.0, WebGL 2.0。但依靠 GL 扩展，在仅支持 OpenGL ES 2.0 和 WebGL 1.0 设备上，几乎已达到 100% 的覆盖率，所以无需担心兼容问题。

 

目前保留此选项应该只是为了保持旧项目的兼容性，在适当的时候会考虑移除。

 

 

版本升级提示

• Windows 平台移除 Win32 支持，仅保留 Win64 发布
• iOS 平台最低版本支持从 iOS 10 变更为 iOS 11（为了使用 C++ 17）
• 内置材质的命名和编辑器中的命名保持统一，因此 EffectAsset.get、Material.initialize 中使用内置 Effect 时通常需要加上 “builtin-” 前缀。
• 构建模板中 application.js, game.js, index.js 等文件被更新了，如果有在项目或者构建插件中自定义过模板，请重新生成并做相应修改。详见 升级文档。
• settings.json 格式发生修改，对这个文件做了定制化处理的插件可能会无法使用。详见 升级文档
•  由于引擎内部会对 Mask 下的节点做特殊处理，在获取 Mask 下的子节点时，建议使用 getChildByName 函数，通过名字而非索引来获取，以避免不可预料的问题出现。
• Android gradle：替换 jcenter 为 mavenCenter 
• 添加可从 `cc` 导入的 `native` 模块，包含代码提示，用于替代 `jsb` 全局变量
• 我们默认关闭了字节开发者工具的 ES6 转 ES5 功能，来解决一些编译遇到的问题。因此我们需要手动将开放数据域模板工程转成符合 CommonJS 规范的写法，否则会因为不能识别 ES Module 导致字节的子域启动失败。如果你的项目也遇到了这个问题，请参考该 PR 修改 `项目路径/build/bytedance-mini-game/openDataContext` 该路径下的工程

编辑器更新

• 修复嵌套预制体修改属性时可能报错的问题
• 修复材质预览初始化宽高非整数导致的报错
• 修复脚本读取 npm 包没有正确处理上层 package.json 导致读取失败的问题

引擎更新

• 修复编辑器下重复切换场景导致的内存泄露（engine#11355）
• 修复节点组件上修改 fbx 里材质，保存后出现多次弹窗询问是否保存的问题（engine#11284）
• 修复 glsl100 shader 中 isnan(0.0) 判断导致的问题（engine#11262）
• 修复卡通渲染材质中的 specular 参数（engine#11265）
• 为 DCC 导入兼容的材质优化编辑器设置和代码整理（engine#11266）
• 修复编辑器下调用 `setUseBakedAnimation` 导致的渲染问题（engine#11267）
• 修复 Android 平台下 websocket 错误后没有回调 onError 的问题（engine#11441）
• 不强制对 Editbox 的占位文本使用 top 垂直排列（engine#11303）
• 修复和优化 core 模块下的 API 文档注释 (engine#11338)
• 为 2D 顶点格式添加 API 文档（engine#11394）

V3.5.1 在不影响原有功能稳定性的前提下加入了两项影响深远的实验性功能。一是智能导入 FBX 中的 DCC 默认材质，还原美术在各类 DCC 工具中使用的材质和外观；二是内置了一系列 Surface Shader 材质资源，这将成为未来支撑材质定制的基石。除此之外，我们还完成了一系列关键性的问题修复，体验优化和大量的文档优化，建议所有 3.x 用户升级。

 

Features

 

实验性：FBX 智能材质导入

 

FBX 智能材质导入是模型导入器中辅助转换材质的一个功能，它可以将各种 DCC 工具导出到模型中的部分标准材质直接映射到 Cocos Creator 的内置材质中，尽量还原美术在 DCC 工具中看到的材质效果。我们可以对比一下 Maya 中的 Standard Surface 材质导入 Cocos Creator 后的效果：

Maya 工具内效果

 

开启 FBX 智能材质导入后 Cocos Creator 内效果

 

此功能已支持主流 DCC 工具：3ds Max、Blender、Maya、C4D 中的部分标准材质。

 

具体使用可以参考使用文档。同时我们也将在 3.6 中持续优化模型和材质导入体验，敬请期待。

 

实验性：新增 Surface Shader

从 3.0 版本以来，不少开发者都经历过升级过程中材质无法正常使用，需要迁移的问题，为此我们也准备过不少材质系统专属的升级文档，然而手动升级过程的体验确实不尽如人意。此问题的根本原因是引擎的光照模型和表面材质的计算一直在调整，这会影响所有相关的材质 effect 代码，也会影响到用户复用这些材质时的兼容性。
为了提升材质系统的兼容性，我们新增了一系列 Surface Shader 资源，抽象了引擎内的光照模型和表面材质计算，未来开发者可以使用这些抽象好的头文件和内置函数极大简化自己书写的 effect 资源。同时由于多了一些封装，跨版本间的兼容性也会更有保障。
具体 Surface Shader 的使用请参考使用文档。

 

文档优化

从 3.5 开始我们设计了新版 API 文档页面，受到了开发者比较普遍的好评和一些反馈。在 3.5.1 我们继续做了大量的内容检查，通过近 40 个 PR 进一步补全了之前遗留的一些 API 文档，修复了部分文档错误。并且之后文档也会得到持续性的优化，希望给开发者带来越来越好的使用体验。

 

重要修复

1. 修复浏览器预览速度过慢的问题
2. 修复 Mobile Safari 上无法预览的问题
3. 修复部分材质从 3.4.2 或更低版本不能自动升级的问题
4. 修复 3D 粒子系统在状态切换时可能的报错和表现问题
5. 修复延迟管线的光影计算

 

详细更新

• [FEATURE] Add smart material conversion for FBX importer
• [FEATURE] add experimental surface shader (engine#11048)
• [OPTIMIZE] change camera settings to orthogonal type in 2d scene templates (engine#11020)
• [OPTIMIZE] Improve API documentations in engine
• [OPTIMIZE] Add a new experimental import strategy in AssetDB, avoid repeative import process
• [OPTIMIZE] Update lightmap tool LightFX
• [OPTIMIZE] Inspector keep group display order
• [OPTIMIZE] Improve shadowmap settings in default scene (engine#11213)
• [OPTIMIZE] Optimize anisotropy sample (engine#11075)
• [OPTIMIZE] Spotlight interface description change (engine#10964)
• [OPTIMIZE] Listen WINDOW_RESIZE event by application (engine#10930)
• [OPTIMIZE] Load libGLESv3.so by default while user choose glesv3 (engine#10941)
• [OPTIMIZE] Allow native projects use user pre-set global cmake variables (engine#11011)
• [OPTIMIZE] Refine MissingScript debugger (engine#10916)
• [OPTIMIZE] Automically unfold array list when editing array length in the inspector
• [OPTIMIZE] Optimize curve unit test (engine#10912)
• [FIX] Fix long loading time issue
• [FIX] Fix camera preview not working issue
• [FIX] Fix no responding due to lock on scene scripts
• [FIX] Fix preview issue on some browsers like Safari
• [FIX] Fix inspector cannot create new clip under animation editing mode
• [FIX] Fix clip list not updated after clip creation under animation editing mode
• [FIX] Fix clip removal check under animation editing mode
• [FIX] Fix frequent update of nodes in the animation editor
• [FIX] Improve error handling during node data migration for animation clip
• [FIX] Popup warning when regenerate an exist prefab asset
• [FIX] Fix asset builder issue which cause wrong JSON group for auto-atlas asset and duplicated assets in JSON
• [FIX] Data tolerance for animationBlendType in AnimationGraph
• [FIX] Fix conflict after importing custom texture compression config
• [FIX] Fix code sample issue in the template of the builder's plugin
• [FIX] Fix engine error caused by material switch
• [FIX] Fix prefab data copy issue when the root node is 2d node
• [FIX] Fix issue when copy component data from prefab instance to other prefab
• [FIX] Fix error when AnimationGraph panel is initialized during editor startup
• [FIX] Fix selection issue in scene editor when viewing on screen with dpr larger than 2
• [FIX] Avoid potential infinity loop in tickInEditMode
• [FIX] Fix error caused by empty result when dumpping node data
• [FIX] Fix error when typing enter in the texture name field of the joint texture layout
• [FIX] Fix builder malfunctioning after importing configurations
• [FIX] Fix view rotation after modifying scale value of the preview window
• [FIX] Fix part of circular reference issue by upgrading rollup to 2.37.0
• [FIX] Fix collision matrix setup issue in project setting
• [FIX] Fix issue that the last panel cannot be dragged in dock
• [FIX] Circular references should cause workflow failed (engine#10841)
• [FIX] Fix geometry-renderer in deferred pipeline (engine#10890)
• [FIX] Fix meshBuffer checkCapacity bug (engine#10910)
• [FIX] Remove ambient.mipmapCount (engine#10920)
• [FIX] Fix auto-atlas test bug cause time sequence (engine#10914)
• [FIX] Fix fog is more brighter with native engine (engine#10972)
• [FIX] Fix android crash due to surface not ready (engine#10984)
• [FIX] Fix pause operation fail when play and pause audio in the same frame on native platforms (engine#10990)
• [FIX] Fix instanced model has no spot light shadow (engine#10921)
• [FIX] Fix particle system memory issue (engine#11032)
• [FIX] Terrain and model automatic choose lightmap shader (engine#11006)
• [FIX] Correct render pipeline script template error (engine#10927)
• [FIX] Fix animation mask data cannot be load from gltf (engine#11033)
• [FIX] Fix shader migration from lower version (engine#11038)
• [FIX] Fix subcontextview for wechat platform (engine#11049)
• [FIX] Fix notifySkinnedMeshRemoved (engine#11074)
• [FIX] Fix word wrap for Vietnamese characters (engine#10925)
• [FIX] Instantiate all FastDefined objects as value type (engine#11052)
• [FIX] Fix format feature request for Float32 for gles3 and webgl2. (engine#11084)
• [FIX] Fix eglSwapbuffer error due to eglSurface is not ready (engine#11083)
• [FIX] Disable gametick after enter background(revert to logic to version 3.4.2 (engine#11095)
• [FIX] Skip a pair of quotations for avoiding spaces when image name are detected in RichText (engine#10954)
• [FIX] Assign underline initial value when label segments are contructed in RichText (engine#10954)
• [FIX] Fix clear particle bug (engine#11066)
• [FIX] Fix ndc->world with deferred shading (engine#11099)
• [FIX] Remove enableBatch from spine/db (engine#11100)
• [FIX] Fix deferred pipeline depth stencil with linear sampling in webgl2.0 (engine#11110)
• [FIX] Fix multi blank lines (engine#11116)
• [FIX] Fix ios accelerometer not working (engine#11142)
• [FIX] Add sky.effect with surface shader (engine#11156)
• [FIX] Fix error during particle switch (engine#11139)
• [FIX] Change logger level (engine#10944)
• [FIX] Don't push data if debug is not enabled. (engine#11118)
• [FIX] Fix physics collision matrix (engine#11181)
• [FIX] Fix multi quotations bug and add unit tests (engine#11190)
• [FIX] Fix light flashes at instanced model (engine#11203)
• [FIX] Solve getInstancedModel judgment error (engine#11205)
• [FIX] Fix prefab generates incorrect data (Repeated node) (engine#11211)
• [FIX] Fix terrain index buffer sharing bug (engine#11206)
• [FIX] Fix isnan(0.0) with webgl1.0 (engine#11262)
• [FIX] Fix specular params with surface toon (engine#11265)

Features

 

Marionette 动画系统

在 v3.4 版本中我们带来了支持复杂角色动画的动画系统 Marionette，支持动画状态机和多维混合等功能。在 v3.5 中，我们继续向其中添加了不可或缺的关键能力：层级和遮罩。这可以让开发者轻松做出更复杂的动作系统，比如下面展示的上下半身分离。

 

2D 项目体验优化

对于 2D 用户和 2D 项目开发，我们做了一些编辑器的体验增强，这也是为了帮助有升级需求的 2.x 开发者更好得升级上来，获得与 2.x 类似的体验。从 3.0 发布以来，我们一直在通过各项性能和体验优化积极推动开发者的升级，并且还会持续优化下去。在 v3.5 中，你将可以看到下面的一些体验优化：

1. 所有 2D 项目创建出的场景都会默认包含 Canvas 和一个正交投影的 2D Camera，不会包含 3D Camera
2. 默认的 2D 场景会默认使用 2D 场景视图
3. 一部分属性面板，比如节点，也会支持 2D 视图
4. 所有 3D 模块被默认剪裁了，并且在添加组件列表和节点创建列表中也不会包含 3D 相关的组件和节点
5. 如果你的 2D 项目中需要使用 3D 能力，只需要在项目配置中将 3D 模块添加上即可

 

Frame Pacing Library (Swappy)

Cocos 和 Google 在 Android 移动平台上一直以来都有非常紧密的合作，Android 也是我们最重要的平台之一。我们很高兴宣布在 v3.5 引擎中加入了Frame Pacing Library。它是 Android Game Development Kit (AGDK) 的一部分，主要用于帮助游戏平滑和稳定帧率，对 OpenGL 或 Vulkan 后端都适用。你可以在 Android 构建面板中启用 Swappy 来开启此功能。

 

 

基础几何渲染 Geometry Renderer

我们在此版本中引入了一个新的简易几何渲染的 API，这些 API 是为了绕过组件层，直接在屏幕上渲染一些用于调试的标记几何体。目前已支持线条、盒子、球体、多边形等几何体，渲染模式支持线框模式、填充模式，一部分几何体也可以动态开启光照和深度测试。所有几何体的坐标系在世界空间，并且支持 transform。

 

更详细的几何体信息请参考下面的表格

 

材质编辑体验优化

在过去几个版本中，我们一直在修正和提升渲染表现，同时，我们也在关注美术侧的 DCC 内容生产工作流。在 v3.5 中会有一部分材质体验的优化交付给大家：

1. 当一个 FBX/GLTF 资源被导入后，如果需要修改材质，你不再需要 dump material 然后在复制后的材质中修改，你可以直接在导入的材质上修改。
2. 当你修改材质时，新版本将支持 undo / redo 操作。
3. 当你在编辑材质时切换 effect，不同 effect 之间匹配的属性值会被缓存并迁移，比如 'mainTexture' 的贴图资源，如果在不同 effect 中都包含就会自动维持。

同时敬请期待我们后续版本中更显著的美术体验优化。

 

地形的抹平画刷和高度设置

地形编辑器在新版本中提供了新的抹平和高度画刷，可以让开发者们更方便得编辑平面地貌。

 

平台抽象层 Platform Abstraction Layer

从 v3.5 开始，我们将所有平台层相关的底层适配代码集合到了 PAL 模块中，包括系统信息、窗口适配、音频、输入系统等。系统层的事件派发行为也被统一了。这是一个底层重构，用户层 API 不会收到影响，但这次重构会让 Cocos Creator 未来有能力更轻松得适配新的平台和环境。

 

性能优化

此版本中比较显著的性能优化包含以下几点：

1. Spine 和 Dragonbones 在原生平台通过共享内存避免了 C++ 向 JS 拷贝数据，对原生平台性能有一定的提升。
2. 优化了 RealCurve 和 CurveRange 的内存占用。
3. 大幅度优化了粒子系统的反序列化性能。
4. 在 Android 平台使用 okhttp 来实现 WebSocket 模块以降低功耗并提升性能。
5. 通过减少原生对 JS 的调用次数来提升 Label 和 Graphics 的渲染性能。

 

新的 API 文档设计

对于之前的 API 文档体验社区用户多有吐槽，也让引擎的新人上手门槛和学习曲线抖升。为了解决这个至关重要的问题，我们重新设计了 API 文档的组织方式和界面设计，大家可以访问我们 新的 API 文档链接 来体验。当然，这只是一个开始，我们也希望大家继续反馈建议帮助我们持续改善文档的体验。

 

引擎仓库和自定义引擎升级

为了更好服务开源社区，我们将原生引擎仓库合并到了 engine 仓库中，并且迁移到 cocos/cocos-engine，从现在开始，我们将通过公开 issues 和 公开 projects 向开源社区同步我们的后续计划。如果你正在使用自定义引擎，那么这个修改对你的影响会比较大，从 v3.5 开始，自定义引擎只需要克隆 engine 仓库即可。所有以前在 TS 引擎仓库的修改可以直接 rebase 到 v3.5 分支，但是以前在 engine-native 仓库的修改需要手动应用到 engine 仓库的 native 目录下。详细信息可以参考自定义引擎文档。

 

破坏性更新

• [FIX] Fix dragonbones/spine sockets transform (engine#10260)
• 从 v3.5 开始，请避免向 sp.Skeleton 或 dragonBones.ArmatureDisplay 的 sockets 挂件 target 设置已在使用的节点，否则这个节点的变换矩阵会被覆盖。正确的方法是创建一个新的空节点并设置为 socket target，详细信息可以参考 Spine 挂件文档。
• 从 v3.5 开始引擎将支持模型级别阴影偏移（Shadow bias），这将使得阴影效果更容易适配不同模型的表面。如果你的项目中包含自定义材质，请参考升级文档来应用这个配置。
• Effect 资源中关于 Macro Tags 和 Functional Macros 的语法得到了升级，避免了占用 glsl 的标准 define 语法，旧项目中的 Effect 资源在升级过程中会被自动升级。但如果你从外部直接复制旧版本的 Effect 资源或写新的 Effect 资源时，请注意语法方面的变化：
  • Macro Tag 的新语法：`#pragma define-meta`
  • Funtional Macro 的新语法：`#pragma define`

 

已知问题

• 在 iOS 15.4 中，Safari 中默认开启了 “WebGL via Metal” 这项实验性功能，这将会导致部分项目出现渲染问题（画面不刷新或部分刷新，错误的图块等）。一般在开启了 `ENABLE_WEBGL_ANTIALIAS` 的情况下，并且使用了离屏 FrameBuffer 并对其采样，会触发此问题。临时解决方案是在项目配置中关闭 `ENABLE_WEBGL_ANTIALIAS`，此问题暂无根本性的修复方案，很可能会在新的 iOS 版本中得到修复。

 

Detailed change log

• [FEATURE] Marionette: layer, mask, auto-reset trigger, empty state, localization (engine#10179)(engine#9913)(engine#10550)
• [FEATURE] Improve user experience for 2D only project
• [FEATURE] Integrate Android Frame Pacing library (engine#10327)
• [FEATURE] Add low level geometry renderer for debugging (engine#10189)
• [FEATURE] Make builtin material of FBX and GLTF directly editable (engine#10518)
• [FEATURE] Support undo redo on editing assets (engine#10657)
• [FEATURE] Add Flatten and SetHeight sculpt tool to terrain editor
• [FEATURE] Support drag or select animation clips directly to the animation editor for editing
• [FEATURE] Make animation module optional (engine#10257)
• [FEATURE] Add shadow bias setting for MeshRenderer (engine#10102)
• [FEATURE] Add constants for surface shaders (engine#10590)
• [FEATURE] Support selecting mipmap range for Texture2D and TextureCube. (engine#10500)(engine#10096)
• [FEATURE] Add Texture2D option to fix blending artifact caused by semi-transparent pixels (engine#10419)
• [FEATURE] Add a new interface to query format feature info: Device.getFormatFeature (engine#9949)
• [FEATURE] Add specular intensity for DCC effects (engine#10613)
• [FEATURE] Rich text supports vertical alignment (engine#10340)
• [FEATURE] Add spacingX property to Label inspector for BMFont type (engine#9541)
• [FEATURE] Distribute touch events independently (engine#10712)
• [FEATURE] Add destroy window event and recreate window event on windows platform (engine#10365)
• [FEATURE] Add Node.getPathInHierarchy for getting complete path in hierarchy (engine#9536)
• [FEATURE] Support custom texture compress tools in the Project Settings
• [FEATURE] Support engine separation feature in OPPO platform build
• [FEATURE] Support the OS Target (simulator or device) option in iOS platform build
• [FEATURE] Add cmake hooks support for cocos-service (engine#10691)
• [FEATURE] Support inspector droppable config (engine#10440)
• [OPTIMIZE] Redesign platform abstraction layer
• [OPTIMIZE] Optimize memory occupation of RealCurve, CurveRange (engine#10346)
• [OPTIMIZE] Optimize decorator performance for particle system instantiation (engine#10323)
• [OPTIMIZE] Avoid spine & dragonbones copping buffer from native to js (engine#10235)
• [OPTIMIZE] Android: reduce power consumption by using okhttp to implement websockets (engine#10384)
• [OPTIMIZE] Improve CameraComponent inspector user experience (engine#10708)
• [OPTIMIZE] Improve Skybox inspector user experience (engine#10004)
• [OPTIMIZE] Refine context 2d implementation, reduce call from native to js (engine#10211)
• [OPTIMIZE] Reset light map when rebuild terrain (engine#10714)
• [OPTIMIZE] Simplify cmake configurations in the native template (engine#10479)
• [OPTIMIZE] Improve the JSON grouping strategy for building dependencies of merged bundle
• [OPTIMIZE] Optimize texture compress panel, support searching config in panel
• [OPTIMIZE] Optimize output logs of the build process, parameter completions of the command line build, parameter checks for some platforms
• [OPTIMIZE] Disable bindingMappingInfo validation (engine#10701)
• [OPTIMIZE] Reset-property from unknown type (engine#10687)
• [OPTIMIZE] Exclude arm64 arch and specify x86_64 for ios simulator by default (engine#10679)
• [OPTIMIZE] Do not play particle system component in Editor (engine#10678)
• [OPTIMIZE] Disable post-process alpha blend (engine#10658)
• [OPTIMIZE] Set simulator window position to center (engine#10655)
• [OPTIMIZE] Remove cocos2d-x network deprecated code (engine#10647)
• [OPTIMIZE] Remove deprecated API in animation module (engine#10645)
• [OPTIMIZE] Remove some deprecated api (engine#10656)
• [OPTIMIZE] Minor module refactor in core/renderer/ (engine#10643)
• [OPTIMIZE] Add `keep` attribute to java class in project cfg (engine#10641)
• [OPTIMIZE] Change rich text warning for splitting long strings (engine#10624)
• [OPTIMIZE] Disallow animation on particle system properties (engine#10605)
• [OPTIMIZE] Mark some methods as internal (engine#10604)
• [OPTIMIZE] Disallow animation on customMaterial (engine#10601)
• [OPTIMIZE] Do not remove all RichText children when resetting (engine#10599)
• [OPTIMIZE] Modify the application interface name and remove the js keyword (engine#10556)
• [OPTIMIZE] Optimize ts templates (engine#10553)
• [OPTIMIZE] Optimize assets editing interface (engine#10531)
• [OPTIMIZE] Output warning info when attached to the node has zero scaling (engine#10524)
• [OPTIMIZE] Android: prevent class CocosWebSocket from obfuscation in release mode (engine#10511)
• [OPTIMIZE] Optimize the way how animation component update its animation content (engine#10485)
• [OPTIMIZE] Shader optimization always on (engine#10483)
• [OPTIMIZE] Move AppDelegate into template (engine#10509)
• [OPTIMIZE] Add dynamic library export macro (engine#10393)
• [OPTIMIZE] Add DisallowMultiple for UIOpacity component (engine#10390)
• [OPTIMIZE] SDL related interface encapsulation (engine#10385)
• [OPTIMIZE] Optimize material editing using cache prop-value (engine#10376)
• [OPTIMIZE] Keep EditBox placeholder overflow (engine#10368)
• [OPTIMIZE] Use approx instead of strict equal in UITransform to avoid potential endless loop (engine#10357)
• [OPTIMIZE] Modify diffuseMap property visibility (engine#10333)
• [OPTIMIZE] Windows platform handles multiple events at once (engine#10344)
• [OPTIMIZE] Shader code style improvements for future surface shader (engine#10326)
• [OPTIMIZE] Bypass job system creation if not needed (engine#10308)
• [OPTIMIZE] Optimize android download tasks. (engine#10274)
• [OPTIMIZE] @disallowAnimation should not imply visible (engine#10262)
• [OPTIMIZE] Optimized deletion operation for skybox environment map (engine#10248)
• [OPTIMIZE] Optimize property name display format (engine#10241)
• [OPTIMIZE] Return aabb objects back to pool after usage (engine#10230)
• [OPTIMIZE] JSB add convert routines for size_t/long (engine#10198)
• [OPTIMIZE] Change lighting map unpack and luminance multiply (engine#10185)
• [OPTIMIZE] Rearrange IA input variables and functions for surface shader (engine#10123)
• [OPTIMIZE] GFX: refactor access typed array to access flags (engine#10103)
• [OPTIMIZE] Gfx: refactor binding mappings (engine#10013)
• [OPTIMIZE] Use lagacyPublic to marked deprecated public interface (engine#9859)
• [OPTIMIZE] Shadow info migration (engine#9857)
• [OPTIMIZE] Safely destroy the geometry data (engine#9849)
• [OPTIMIZE] UI: add same value check in property setter (engine#9744)
• [OPTIMIZE] Optimize label serialization of "spacingX" and "underlineHeight" (engine#9629)
• [OPTIMIZE] Rich Text format optimization by split into small sections (engine#9601)
• [OPTIMIZE] Clean up gfx module for independent compilation (engine#9573)
• [OPTIMIZE] Code style: replace macros to functions (engine#9572)
• [OPTIMIZE] Set active to false if pass undefined or null to Node.active (engine#9571)
• [OPTIMIZE] Optimize scroll view offset annotations (engine#9553)
• [OPTIMIZE] Remove deprecated attributes: srcBlendFactor and dstBlendFactor#6461 (engine#9533)
• [OPTIMIZE] Show pipelineStates in inspector (engine#10586)
• [OPTIMIZE] Add category config file for docs (engine#10589)
• [FIX] Fix rendering issue after baking light map with prefab
• [FIX] Fix baking tool LightFX multi-thread error
• [FIX] Fix prefab data lost when exiting from animation edit mode to prefab edit mode
• [FIX] Fix prefab/scene data may be overwritten when switch between scene and prefab quickly
• [FIX] Fix inability to save changes to nested prefab
• [FIX] Fix warning when clicking on different FBX assets
• [FIX] Fix a series of optimization issues related to keyframe operation in the animation editor
• [FIX] Fix build error on windows platform when editor path contains spaces
• [FIX] Fix build failure after check [Main Bundle is remote] option on mac platform
• [FIX] Fix an issue where the editor extension failed to start and could still be queried
• [FIX] Fix prefab ID will be changed after rename of FBX or GLTF
• [FIX] Fix octree culling rule (engine#10723)
• [FIX] Walk around iOS 15.4 wasm memory issue (engine#10721)
• [FIX] Bypass the bug that vulkan destroys resources that are still in use (engine#10716)
• [FIX] Fix the performance issue caused by texture mipmap (engine#10713)
• [FIX] Fix native module override (engine#10709)
• [FIX] Fix #11925 skin instancing vertex attributes binding order for native… (engine#10703)
• [FIX] Fix rich text children index bug (engine#10700)
• [FIX] Fix sub context view not working when the design resolution size is less than 513 * 513 (engine#10698)
• [FIX] Fix scroll view Auto Scroll Brake bug (engine#10693)
• [FIX] Fix instanced rendering issue by joint index (engine#10692)
• [FIX] Fix: set tmxAsset not apply file (engine#10690)
• [FIX] Fix: set skeleton data, _cachedSockets should be reset (engine#10671)
• [FIX] Remove playing audio when player is destroyed (engine#10670)
• [FIX] Use correct macro patches (engine#10669)
• [FIX] Correct profiler statistics (engine#10667)
• [FIX] Fix screen size && touch event on Alipay platform (engine#10666)
• [FIX] Fix ndk path not working (engine#10627)
• [FIX] Fix android crash due to eglSurface unavailable (engine#10621)
• [FIX] Use macro to set XXTEAKEY (engine#10607)
• [FIX] Fix opacity bug when active false (engine#10595)
• [FIX] Fix #11796 using cc_shadowbias without batching macro (engine#10587)
• [FIX] Fix ui-mesh-renderer in editor (engine#10582)
• [FIX] Fix ios enter forground crash by useless appDelegateBridge (engine#10580)
• [FIX] Fix cross fade bug introduced in #10485 (engine#10576)
• [FIX] Fix skeletal animation state got update twice (engine#10571)
• [FIX] Avoid creating the window twice (engine#10566)
• [FIX] Fix animation event type typing (engine#10562)
• [FIX] Animation state bugfix (engine#10558)
• [FIX] Fix watermark can not show normally (engine#10547)
• [FIX] Fix sprite-frame size after repetitive dynamic creation of tiled map (engine#10535)
• [FIX] Fix MTLTexture::doInit (engine#10532)
• [FIX] Fix gfx::FrameBufferInfo rehash crash bug (engine#10525)
• [FIX] Fix tiled show with pixel offset (engine#10523)
• [FIX] Fix label Blend Factor bug for byte dance platform (engine#10516)
• [FIX] Fix animation bug introduced from #10485 (engine#10512)
• [FIX] Fix vec3 & vec4 transformAffine (engine#10508)
• [FIX] Fix animation blending zero check (engine#10499)
• [FIX] Fix pointer event when camera.orthoHeight changed (engine#10496)
• [FIX] Fix Android websocket send string (engine#10495)
• [FIX] Fix getUrlWithUuid smart hint issue (engine#10484)
• [FIX] Fix punctual lights luminance * PI (engine#10480)
• [FIX] Set light map clamp to border and fixed rebuild terrain weights (engine#10470)
• [FIX] Clear Particle under UIMeshRenderer when play end (engine#10468)
• [FIX] Fix: There is no need to execute updatePreview in the ready lifecycle (engine#10466)
• [FIX] Fix fog accumulated error with multiple local lights (engine#10445)
• [FIX] Fix templates and minor tweaks (engine#10434)
• [FIX] Force update for spine color setting. (engine#10417)
• [FIX] Fix opacity dirty bug when parent change (engine#10416)
• [FIX] Fix gen-simulator (engine#10401)
• [FIX] Fix animation not work caused by creating spine in a hided node (engine#10380)
• [FIX] Fix 2D physics rotation error (engine#10373)
• [FIX] Reset render data before set asset for spine/dragonbones (engine#10370)
• [FIX] Fix crash caused by incorrect hash (engine#10359)
• [FIX] Fix spine/dragonbones opacity update (engine#10349)
• [FIX] Fix spine rendering confusion (engine#10348)
• [FIX] Fix bug: reset renderer-component would not update model (engine#10342)
• [FIX] Fix ios icon res lost (engine#10336)
• [FIX] Fix compiling error with merged code (engine#10332)
• [FIX] Fix: #11580 create new light source with unknown typed intensity in the inspector (engine#10324)
• [FIX] Fix skinned mesh morph rendering (engine#10318)
• [FIX] Avoid spine and dragon crash. (engine#10314)
• [FIX] Fix spine in native platform can not get animation name (engine#10303)
• [FIX] Fix dragonbones/spine sockets transform (engine#10260)
• [FIX] Fix crash when app jump to camera (engine#10255)
• [FIX] Fix translucent problem due to SurfaceView‘s limit (engine#10228)
• [FIX] Fix unnecessary include for surface shader (engine#10220)
• [FIX] Fix misuse of draw API on metal (engine#10195)
• [FIX] Fix: linux build use static link. need add sndio lib (engine#10186)
• [FIX] Fix ios device display effect (engine#10184)
• [FIX] Fix spine binary data read issue. (engine#10172)
• [FIX] Fix android 12 crash when using Vulkan backend (engine#10158)
• [FIX] Fix fps calculation error for linux and QNX (engine#10141)
• [FIX] Fix default scene camera clear flags is solid not skybox (engine#10132)
• [FIX] Update ci yml files, add native/web prefix, cherry-pick from #10083 (engine#10104)
• [FIX] Fix binding mappings (engine#10058)
• [FIX] Fix shader code style (engine#10039)
• [FIX] Fix decorator order issue in standalone mode (engine#9911)
• [FIX] Fix keyframe editorExtras serialization (engine#9905)
• [FIX] Fix pixels offset (engine#9829)
• [FIX] Fix negative scale widget in editor (engine#9811)
• [FIX] Particle alpha blend fix (engine#9784)
• [FIX] Fix import relation (engine#9765)
• [FIX] Fix bug that causes autoScrolling is always triggered in v3.5 (engine#9548)
• [FIX] Fix crash: native model is destroyed but not removed from render scene (engine#9543)
• [FIX] Update the split condition of RichText truncations (engine#10252)
• [FIX] Fix iOS Simulator compile error when using TBB on Apple Silicon device (cocos-engine-external#232)