Cocos Creator 3.3.2 更新说明

Cocos Creator 3.3.2已发布。本次更新增加了对 iOS 10+ 的支持，并修复了一些已知问题。

Hightlight

该版本主要功能是让引擎构建出来的原生应用可以支持 iOS 10+。为了支持 iOS 10+，引擎代码去除了对 C++17 的依赖。

引擎的有些功能依赖 C++17，有些功能对 Android API 有要求。为了方便开发者使用，编辑器的功能配置界面对于这些依赖进行了提示。比如，Android 使用延迟管线时，要求 Android API 21+，如果配置选择使用延迟管线，编辑器会提示需要的 Android API 版本：

当然了，我们还提供了完整的文档说明各个功能模块对于 Android API 和 C++ 版本的要求。详细信息可以参考[打包发布到原生平台]。

重点更新

Store 下载增加了进度

问题修复

原生端 GPU Instancing 材质切换导致无法渲染

原生端 GPU Instancing 材质切换导致无法渲染

修复 curve 组件 Two Curve 模式时 muti 无法修改的问题

修复 prefab 修改模式下，undo 后立即保存可能丢失 override 的问题

修复编辑 prefab 资源时添加 UI 节点出现的 UITransform 组件或 Canvas 节点问题

已知问题

Topon 和 Tradplus 这两个 Service 在构建 iOS 时会出现异常，我们将在近期通过热更新修复

升级说明

从 < 3.1.0 版本升级

从 v3.1 开始，UITransform 组件的 priority 属性已弃用，若需要调整节点树的顺序请使用 setSiblingIndex 方法。在 v3.1 之前通过代码创建并依赖 priority 属性的节点可能会出现节点树表现和之前不一致的问题，请手动调整。

RenderTexture 在不同平台上会出现正反不一致的情况，为了解决这个问题，Creator 为 effect 新增了 SAMPLE_FROM_RT 宏，在使用 RenderTexture 时，需要将 SAMPLE_FROM_RT 宏设置为 true，各后端便会统一适配至正确的效果。

在 v3.1 中材质 Shader API 与 v3.0 有一定的差异，请参考[v3.0 材质升级指南]和[v3.1 材质升级指南]进行手动升级。

从 < 2.x 版本升级

Cocos Creator 3.x 版本已经正式发布，2.4 版本将做为 LTS（长期支持）版本，提供后续两年的持续更新！在 2021 年，v2.4 将继续更新版本，提供缺陷修复和新的小游戏平台支持，保障大家的项目成功上线；在 2022 年我们还将为开发者持续提供 v2.4 的关键问题修复，保障已上线的游戏平稳运营！因此：

现有的 v2.x 项目可以安心继续开发，无需强制升级至 v3.0。

现有的 v2.x 项目因项目需求若想升级到 v3.x，可以使用 Creator 提供的2.x 资源导入工具。此工具将支持旧项目资源完美导入，以及代码的辅助导入。代码辅助导入会把 JavaScript 转换成 TypeScript，并自动添加组件类型声明、属性声明及函数声明，组件在场景中的引用都会得到保留，并且函数内部的代码会以注释的形式导入进来，可以减轻开发者的升级难度。详细的升级说明请参考[升级指南]。

新项目则建议使用 v3.0 开发，我们会不断优化 v3.0 的开发体验和运行效率，支撑好 2D、3D 等不同品类的重度游戏顺利上线。

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版本项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。

此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。

参考链接

[打包发布到原生平台]

https://docs.cocos.com/creator/3.3/manual/zh/editor/publish/native-options.html

[v3.0 材质升级指南]

https://docs.cocos.com/creator/3.1/manual/zh/material-system/effect-2.x-to-3.0.html

[v3.1 材质升级指南]

https://docs.cocos.com/creator/3.1/manual/zh/material-system/Material-upgrade-documentation-for-v3.0-to-v3.1.html

[升级指南]

https://docs.cocos.com/creator/3.0/manual/zh/release-notes/upgrade-guide-v3.0.html