2021.11.24

V2.4.7

发布时间: 2021.11.24

工欲善其事，必先利其器。经过长时间的准备和测试，2.4.7 版本终于发布了，感谢所有给予我们宝贵反馈的小伙伴们！在此次更新中，我们对近期发现的一些 2.x 相关问题集中进行了修复，重点提升了编辑器的稳定性、兼容性，建议所有 2.x 用户升级。

在 2.4.5 中，我们为了兼容 Mac M1 尽快升级了编辑器底层的 Electron，导致了开发者的部分插件出现异常，很抱歉给大家造成了不好的体验。针对有关问题，我们在近期进行了大量的专项测试，将兼容性适配代码集中汇总到了 2.4.7，最终为开发者抹平了 Electron 版本的差异，并且确保不会引入新的相关问题。

在之后的版本中，不论是 2.x 还是 3.x，我们都将秉持兼容第一的原则，并且持续验证 Cocos Store 中的插件兼容性。尽可能在基础设施变化时不影响项目、插件的运行，减少适配成本，提升升级体验。

根据今年 2 月 7 日 3.0 版本正式发布时的计划，2.4 做为 LTS 版本将在今年继续提供缺陷修复。同时明年全年，我们还将持续关注 2.4 的关键问题和重大的平台适配问题，不定期更新版本，支撑线上项目的安全运营，请大家放心。

再次集中解答一下关于 3.x 的升级问题：

新项目不再建议基于 2.4，请统一使用 3.x 版本进行开发，我们会一如既往地优化 3.x 的开发体验，关注轻量级游戏的包体和效率，支撑好 2D、3D 等不同品类的游戏开发。
当前 2.x 项目如果已到开发中期，或者即将上线，不必升级 3.x。
当前 2.x 项目如果还在开发前期，可以评估是否需要升级 3.x。如果确认一定要升级，可以使用 Creator 提供的 2.x 资源导入工具。此工具将支持旧项目资源完美导入，以及代码的辅助导入。代码辅助导入会把 js 转换成 ts，添加组件类型声明、属性声明及函数声明，组件在场景中的引用都会得到保留，并且函数内部的代码会以注释的形式导入进来，可以减轻开发者的升级难度。详细的升级说明请参考升级指南。如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

Stack Changes

升级编辑器的 Electron 版本到 13.1.4。解决了 Windows 上部分用户频繁出现的 WebGL 崩溃问题，还支持了 M1（Apple Silicon）的原生 ARM 指令集，建议所有 M1 用户升级以获得更好的性能。详见升级说明。
升级 Android 工程 Gradle 版本到 4.2.2 版本，详见升级说明。

Editor

修复 Prefab 打开时点击保存，可能覆盖场景数据的问题
修复编辑器下刷新脚本时，若无场景切换操作则内存会持续增长的问题，感谢 isilent
修复重复构建部分文件 MD5 可能发生变化的问题
修复 2.4.5 出现的部分第三方插件 ui-section 内 header 使用 class 注册的语法不兼容的问题
调整构建时的资源压缩操作到拷贝构建模板和 `beforeFinish` 事件之后
修复构建后修改脚本并绑定节点后再次构建，运行时绑定内容可能为空的问题
修复资源管理器，搜索后键盘上下选择节点错误的问题
修复在资源管理器全选 audio-clip、sprite-frame、texture 后拖动面板会报 resize 错误的问题
修复聚焦场景后，选中节点无法删除的问题
修复预制体自动同步弹窗状态无法保存的问题
修复节点上 Color 等属性改动后，使用撤销和重置节点属性无效的问题
修复资源路径或项目路径中带有括号时，打开编辑器出错的问题
修复点击 Markdown 中的超链接失效的问题
修复 Prefab 未修改保存后数据发生变化的问题

Engine

修复预加载没有下载自动图集的图片的问题
修复修改父节点后，节点的透明度级联计算错误的问题 [#9322]
修复 Scroll View 同时到达水平和竖直边界时，没有正确触发事件的问题，感谢 zty8023ys [#9445]
修复 Mask 组件在运行时调整节点大小无效的问题 [#9444]
修复 Graphics Bezier 曲线的重绘问题，感谢 caogtaa [#9194]
修复 EditBox 在 PhoneNumber 模式下，鼠标滚轮导致数字为负数的情况，感谢 wanghaha1991 [#9138]

升级说明

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。以下是升级说明，如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

从 < 2.4.7 版本升级

从 2.4.7 开始，安卓工程的 Gradle Plugin 版本升级到了 4.2.2。此次升级调整了 Android Instant 工程的目录结构，对普通 Android 工程没有影响。我们移除了 js-template-link/frameworks/proj.android-studio/game 与 js-template-default/frameworks/proj.android-studio/game 目录。game 目录中的内容与 instantapp 目录已合并进 instantapp 目录，如果有对应的模板定制的内容，需要迁移至 instantapp目录中。
从 2.4.7 开始，编辑器底层 Electron 升级到了 13.1.4，我们为 Electron 自身的大部分接口变动进行了兼容处理，例如 BrowserWindow 启动默认值、shell.openItem、shell.moveItemToTrash 以及部分 Node.js 环境内的数据。但基于 Electron 官方的安全性建议，如果插件使用到了 <webview>，请通过 <webview nodeIntegration></webview> 显式开启 Node.js 支持。如开发者还遇到 2.4.7 引入的其它插件兼容性问题也欢迎向我们反馈。

从 < 2.4.0 版本升级

cc.loader 已经不建议使用，请使用最新的 cc.assetManager 来代替，请参考资源管理模块升级指南
子包功能已升级为 Asset Bundle，请参考资源分包升级指南
调整了项目构建后的目录结构，调整了 BuildResults 的 API，如果你使用了编辑器插件获取编辑器构建结果，请参考定制项目构建流程升级指南
从 1.10 开始废弃的 cc.RawAsset 已被正式移除，请使用 cc.Asset 代替。由于 2.4 不再兼容原有 1.x 项目中对 RawAsset 类型的历史遗留用法，建议所有要升级到 2.4 的项目特别是从 1.9 版本一路升级上来的项目，先在任意的 1.10 ~ 2.3 版本中对编辑器编译代码时输出的所有警告或报错都正确处理完毕，再升级到 2.4。
cc.Color.fromHex 已被废弃，请使用 cc.Color.fromHEX 接口

从 < 2.3.3 版本升级

Effect 中的 CCTexture2D，CCTexture2DRGB 方法已被废弃，请改用 CCTexture，CCTextureRGB
Vec3.FRONT 已被废弃，请改用 Vec3.FORWARD

从 < 2.3.0 版本升级

从 2.3.0 开始，定制安卓原生工程时，需注意 Android 与 Android Instant 使用了同一个构建模板

如果是 Android 平台单独使用的代码请放入 app/src 目录, 单独使用的第三方库请放入 app/libs 目录。
如果是 Android Instant 单独使用的代码和第三方库请分别放入 game/src, game/libs 目录。
如果是 Android 和 Android Instant 共用的代码和第三方库，请分别放入 proj.android-studio 根目录底下的 src 目录和 libs 目录。
proj.android-studio 根目录底下 jni/CocosAndroid.mk , jni/ CocosApplication.mk，主要用于配置引擎相关的配置，开发者的配置，建议 Android 放到 app/jni/Android.mk 和 app/jni/Application.mk中，Android Instant 请放入 game/jni/Android.mk 和 game/jni/Application.mk 中。

此外，在 Cocos Creator 编译 Android 时会默认执行 assembleRelease/Debug，编译 Android Instant 时会执行 instant:assembleRelease/Debug。
如自定义了音频前后台切换时的暂停逻辑，升级到 2.3.0 后请移除目前 Creator 游戏在所有平台上前后台互相切换时，都会在内部自动暂停和恢复音频。如果开发者之前有对这一块进行过定制，监听并执行了 cc.audioEngine.pause()/resume() 之类的音频操作，可能会和引擎默认行为冲突。如果有遇到相关的音频问题，只需移除相应的定制代码即可。

从 2.0 - 2.3.0 版本升级

从 2.3.0 开始，Canvas 组件不再负责将 Canvas 节点尺寸设为屏幕大小，此行为将结合 Widget 组件实现。为保证兼容性，2.0 项目升级后，Canvas 所在节点会自动添加 Widget 组件。（从 1.x 项目升级无此问题）

从 < 2.2.0 版本升级

从 2.2.0 开始，我们强化了内存管理机制，现在要求用户通过代码动态创建且独立于场景节点树的 cc.Node 必须通过 destroy() 释放，否则引擎无法知道何时回收这类节点的内存，会导致内存泄露。

如原先手动从场景中移除的节点，在不需要用到的时候也需要统一 destroy()：

// 假设 testNode 是场景中的某个节点，若之前被手动移出场景了，如testNode.parent = null;// 或者testNode.removeFromParent(true);// 或者parentNode.removeChild(testNode);// 若往后 testNode 还会再次用到，则无需手动 destroy 该节点// 否则应该手动调用testNode.destroy();

如原先通过 cc.removeSelf 这个 action 销毁节点，请改为使用 cc.destroySelf。
如原先通过 cc.NodePool 管理节点，则不受影响。

从 2.2.0 开始，我们不再建议你使用节点的 Skew 功能。Skew 通常用作在 2D 引擎中模拟 3D 效果，随着 Cocos Creator 对 3D 节点的深入支持，Skew 效果已经完全可以由 3D 节点来实现。为了统一使用体验，进一步优化引擎底层实现，我们在 3.0 中废弃了 Skew 属性。

从 < 2.0 版本升级

打开 1.x 项目的话，场景等所有资源将会自动升级，代码中的废弃接口从 2.3.3 开始将会在保持兼容的基础上同步输出报错。升级方式可参考《1.10 资源升级指南》和《2.0 升级文档》进行调整。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.10.11

V3.3.2

发布时间: 2021.10.11

Hightlight

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

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

当然了，我们还提供了完整的文档说明各个功能模块对于 Android API 和 C++ 版本的要求。详细信息可以参考该文档说明。

重点更新列表

Store 下载增加了进度

问题修复

原生端 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.4.5 版本升级

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

现有的 2.x 项目可以安心继续开发，无需强制升级 3.0。
现有的 2.x 项目因项目需求如想升级到 3.x，可以使用 Creator 提供的 2.x 资源导入工具。此工具将支持旧项目资源完美导入，以及代码的辅助导入。代码辅助导入会把 js 转换成 ts，添加组件类型声明、属性声明及函数声明，组件在场景中的引用都会得到保留，并且函数内部的代码会以注释的形式导入进来，可以减轻开发者的升级难度。详细的升级说明请参考升级指南。
新项目则建议使用 3.0 版本开发，我们会不断优化 3.0 的开发体验和运行效率，支撑好 2D、3D 等不同品类的重度游戏顺利上线。

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.9.17

V3.3.1

发布时间: 2021.9.17

本次更新修复了一些已知问题，Cocos Creator 将持续优化性能，为开发者带来更好的使用体验！
以下是详细更新内容。

编辑器

优化微信字节面板上物理实验室选项的显示，新建微信构建任务时，将会默认开启 Wasm 物理系统。开启后，将会覆盖项目设置的物理后端选择
修复若干动画编辑器操作问题，包含：
- 部分类型的动画没有正确插值的问题
- 复制轨道时曲线数据没有复制的问题
- 无法连续操作选中关键帧属性轨道
- 存在滚动条时添加关键帧位置错误
- 多选关键帧后点击在关键帧位置移动异常
- 修复跨节点跨属性粘贴关键帧数据失败
修复完善粒子曲线相关控件：包含 Bursts 属性无法正常添加、包含 Constant 模式的曲线显示异常、优化 Two Curve 的显示、移除关键帧后曲线显示不正确
修复 joint-texture-layout 在命令行构建时无效的问题（会导致运行时加载失败）
修复创建的物体中 Component 的 FileId 相同的问题
修复自动图集与 renderTexture 资源在同一文件夹时，无法正常预览和构建
自定义引擎设置按编辑器版本区分存储
修复 Prefab 中的脚本修改后没有及时更新的问题
修复 Prefab 编辑模式下创建 ui 节点存在的问题
修复编辑 Prefab 资源时资源被删除，此时保存不会自动转另存的问题
修复 Hierarchy 上根节点相关的全选和复制的功能问题
修复场景切换时 Hierarchy 调用了 db 接口报错的问题
修复自定义脚本模板文件名称不能是纯数字的问题
修复 assets 面板批量删除资源时 db 报错的问题
支持 assets 面板新建资源时对输入的名称能过滤其后缀的机制
修复导入失败的资源，每次焦点重新回到编辑器都会报一次错误的问题
修复场景中旧的 private node 会造成警告的问题
修复 scene 资源升级会在末尾增加一个空行的问题

引擎

修复粒子系统实例化性能下降的问题
修复 iOS 14 Web 平台的运行性能问题
优化 Shadow Culling 算法，升级后需要使用 resolution 和 distance 来调节阴影质量
修复聚光灯阴影上的计算错误
Shadow bias 改为使用世界空间单位，调节起来会更直观
修复 Android 11 API Level 30 环境下的崩溃问题
修复了 AnimationClip.createWithSpriteFrames 动态创建动画失败的问题
修复 inverseTransformPoint 函数错误
修复 widget 对 target anchor 变化的监听
修复 Editbox backgroundImage 属性在 SpriteFrame 的修改时没有被同步的问题
回滚对 EventKeyboard.isPressed 属性的弃用
修复 button 的 scale 模式下无法设置节点 scale 的问题和无限放大的问题

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.08.24

V3.3.0

发布时间: 2021.08.24

What's new

性能优化

在 3.3 版本中，我们继续重点优化了微信小游戏平台的加载性能和运行性能。所有内部项目升级后微信云测启动性能分都可以达到 80 分以上。

同时，我们进一步提升了原生引擎的绑定层级，在渲染管线之上的渲染场景部分也完成了原生化，光源、模型等渲染对象的收集过程使用原生实现，进一步提升了原生平台的性能。

还有一个附带的好处，由于绑定层级的向上迁移，一些底层的数据共享机制被解除了，比如 Pass，SubModel 等。这使得 JS 引擎上层的实现尤其是 UI 和 2D 渲染合批相关的数据更加简化，部分高频操作的数据结构从 TypedArray 还原为直接量属性，使得 Web 和小游戏平台的性能也得到了可见的提升。

优化场景编辑体验

优化场景相机的漫游模式，并增加了加速开关

2. 增加一个场景灯光的开关（默认打开）

3. 增加模型的最大最小坐标显示

4. 增加 Transform Gizmo 的吸附功能（通过移动，旋转，缩放的Gizmo操作时，按住 Ctrl 键，就可以按设定的步长进行值的增长

5. 优化大项目使用体验：降低编辑器内存使用，避免崩溃，优化卡顿

新版动画编辑器和动画数据升级

目前动画编辑器已在动画编辑器内置曲线编辑，与时间轴匹配，并支持任意关键帧之间的时间曲线编辑。

同时，在 3.3 中，我们也完成了动画数据的升级：引入了新的基础曲线类，重构了 AnimationClip，统一了动画和粒子系统使用的曲线数据。这些工作都是为了后续的完善动画系统而准备的，在后续版本我们将支持动画状态机编辑，Blend Tree 动画融合等高级功能。

除此之外，动画编辑器还完成了以下工作：

支持动画根节点隐藏后的动画显示编辑；
优化动画编辑器关键帧与小红线的遮挡关系以及关键帧大小、选中颜色等；
动画编辑器支持按住 shift + 鼠标滚轮滚动来移动时间轴；

平台支持和构建系统优化

在 v3.3 中，我们加入了 windows x64 的构建选项，未来将逐步废除 win32 平台的构建。

在构建面板上，我们也做了诸多优化：

iOS 构建填配置选项支持目标 iOS 版本和签名相关的 developer id 配置
构建勾选 md5Cache 后，支持给脚本添加 md5 后缀，确保版本更新；（来自论坛反馈）
由于微信部分版本已经支持 astc，目前开放了小游戏平台 astc 的压缩纹理配置；
偏好设置 - Build 新增构建日志打开方式选项；
构建插屏配置面板，支持直接拖拽文件系统的图片放置；
命令行构建支持传入 logDest 指定日志输出路径；
由于 Mac上退出码位数的限制，对命令行构建退出码做了修改；
原生平台构建后将不能二次修改游戏名称；

阴影效果和设置优化

在之前的版本中，阴影的配置一直是一个比较让开发者困惑的功能，我们已经有完整的规划，正在逐步完善中，v3.3 会首先简化阴影的配置，优化软阴影算法，修复阴影的部分效果问题。配置上的调整包含：

Shadow color 被迁移为 Shadow saturation 的灰度调节选项，会自动迁移老版本的 alpha 通道
软阴影选项从之前的 X9，X25 等改为 Soft 和 Soft2X
简化阴影贴图的尺寸设置为 High，Medium，Low
去除 SelfShadow 选项，现在都会默认开启自阴影计算

v3.1

v3.3

物理系统完善

继 v3.1 支持 PhysX 物理后端以来，多套物理引擎的选择和使用也成为了我们重点关注的使用体验，在 v3.3 中我们不仅加强了物理功能，还尽可能统一了不同物理后端的物理表现。

支持 CCD 连续碰撞检测功能

增加碰撞体最小体积控制，避免节点零缩放导致的一系列问题
支持 PhysX 物理打包字节平台更灵活的配置选项
支持 Bullet 物理中全局控制是否允许自动休眠
支持 Bullet 物理中射线检测过滤 trigger 碰撞体
修复 Bullet 物理中刚体无附加现状的 local inertia

其他

音频系统在 v3.1 移除所有 AudioClip 资源上的播放控制接口后，开发者颇为不满，在 v3.3 中我们将播放控制接口以标记废弃的方式添加回 AudioClip 资源。我们仍然希望所有开发者能切换到使用 AudioSource 组件的方式来播放音频，这对于未来的音频系统功能强化至关重要。
输入事件以前是接收到事件就进行派发，如果事件响应逻辑复杂可能会影响到帧回调，导致帧率不稳，v3.3 已调整为帧间记录事件队列，统一在主循环中处理事件队列。
View 和 Screen 接口进行了简化，废弃了一些平台相关接口，将部分 View 的窗口控制功能统一到 Screen 上

重点更新列表

Editor

新版本动画时间曲线编辑和动画编辑器体验优化
各模块曲线编辑器统一：粒子、动画等
优化粒子曲线的编辑操作，添加重置坐标移动范围按钮，支持直接右键编辑关键帧点位置
场景编辑器体验优化
- 增加一个场景灯光的开关（默认打开）
- 优化场景相机的漫游模式，并增加了加速开关
- 增加模型的最大最小坐标显示
- 增加 Transform Gizmo 的吸附功能
支持 HDR 文件导入，引擎内部处理 RGBE 编解码
编辑器性能和体验优化
当 Image 资源被改为 SpriteFrame 类型后，自动修改 texture 的 Clamp 配置为 CLAMP_TO_EDGE，避免边缘混合黑边问题
支持在带动画模型的属性面板上直接编辑动画事件
修正编辑器内的资源泄露问题，降低内存占用
针对微信小游戏平台开启 ASTC 压缩纹理配置
优化 hierarchy 面板性能，增加 prefab 节点直接进入 prefab 资源的编辑功能
优化 console 面板性能，修复大量 log 数据拖慢启动速度的问题
Color picker 支持 color gamma 矫正预览
Inspector 中支持组件属性的分组显示，使用 group 装饰器
inspector 编辑节点增加复制节点世界坐标
支持显示烘焙结果的 rgb 通道的单个灰度图或者通道的组合
支持自定义的脚本模板，同时在生成脚本时可以使用部分预设变量
支持 Windows 平台上带中文的安装目录
iOS 构建填配置选项：目标 iOS 版本，签名相关的 developer id
Windows 平台添加生成平台选项，支持 x64 和 win32 选项
支持脚本 import map
添加了清理代码缓存的功能，入口位于菜单：[开发者]-[缓存]-[清理代码缓存]
编辑器右下角添加引擎版本与编辑器版本不一致的提示
Electron 升级到 13.1.4
修复 m1 cpu 的设备构建项目时偶现的进度条停止问题

Engine

优化标准光照模型中的 AO 计算
阴影参数和渲染优化
- 修复阴影效果，优化阴影边缘虚化算法
- 将 Shadow Color 迁移为 Shadow Saturation 单通道选项，会自动迁移老版本的 alpha 通道

软阴影选项从之前的 X9，X25 等改为 Soft 和 Soft2X
简化阴影贴图的尺寸设置为 High，Medium，Low
去除 SelfShadow 选项，现在都会默认开启自阴影计算
引入通用曲线类（Curve）
重构 AnimationClip，动画数据重构升级：为动画状态机和复杂动画融合做好准备
优化微信小游戏首屏渲染速度
修复了 UI 透明度级联导致的渲染问题
修复了 Label 重复加入动态合图的问题
粒子曲线使用统一的 Curve 数据
物理引擎
- 统一各个物理后端的行为表现
- 支持 CCD 持续碰撞检测
- 增加碰撞体最小体积控制，避免节点零缩放导致的一系列问题
- 支持 PhysX 物理打包字节平台更灵活的配置选项
- 支持 Bullet 物理中全局控制是否允许自动休眠
- 支持 Bullet 物理中射线检测过滤 trigger 碰撞体
烘培库支持 mac m1 cpu 设备
字节小游戏音频使用 WebAudio 接口实现
事件系统
- 所有输入事件归拢到游戏主循环中处理
- AudioSource 支持监听音频开始和结束事件 AudioSource.EventType.STARTED & AudioSource.EventType.ENDED
- SystemEventType 和 macro.KEY 已经废弃了，改用 SystemEvent.EventType 和 KeyCode
- 废弃了 SystemEventType，以及 SystemEventType 底下的一些系统事件无关的枚举，请使用 SystemEvent.EventType
- 废弃静态属性 Event.TOUCH, Event.MOUSE, Event.KEYBOARD, Event.ACCELERATION
简化废弃部分 view 和 screen 接口，统一在平台适配层（PAL）中实现
- 废弃 view.adjustViewportMeta 和 view.isAutoFullScreenEnabled
- 废弃 view.enableAutoFullScreen，请使用 screen.requestFullScreen
- 废弃 cc.winSize，请使用 view.getVisibleSize
- 废弃 screen.autoFullScreen，请使用 screen.requestFullScreen
- 废弃 screen.disableAutoFullScreen
修复移除 Spine 动画可能导致的内存泄露（感谢 Github PR from @hailua54）

Infrastructure

渲染场景模块原生化：优化原生平台性能
使用可控的离屏 FrameBuffer 进行内容渲染
基于离屏 FrameBuffer 支持 MSAA 抗锯齿（开启项目宏 Enable Antialias 生效）：注意，如果之前开启了该项目宏，那么升级为 3.3 之后原生平台性能损耗会有所增加，这是正常情况
内置 Frame Graph 渲染定制层，后续版本将接入渲染管线，开放定制接口给用户
在 Vulkan & Metal 后端支持 Subpass
添加 M1 CPU 的苹果设备上使用 iOS Simulator 调试的能力，需要参考文档使用
binding generator 全面兼容 python 2.7 / 3.x （64 位）

Breaking changes

构建压缩纹理不再带有默认 png 图，如果使用到这个特性的项目，请在项目配置内为已有的压缩纹理配置添加默认图（来自论坛反馈）
目前已支持 HDR 贴图直接导入，之前如果使用 RGBE 格式的 .png 请替换为原始 .hdr 贴图
我们修复了一处 FBX 资源导入问题：若 FBX 模型含有多段动画，第二段及后续的动画都错误地包含了前段的所有动画数据。注意：如果已经配置了动画分割，则可能需要调整。不过我们并未收到外部开发者关于此问题的反馈。

Known Issues

原生平台 Bullet 后端射线检测性能有所下降，我们将在下个小版本修复此问题，可暂时切换到 PhysX 后端进行使用或减少每帧射线数量
3D 粒子 startSpeed, startRotation, gravityModifier 属性在 Curve 模式下可能出现显示异常，将在下个小版本修复此问题

升级说明

从 < 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.4.5 版本升级

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

现有的 2.x 项目可以安心继续开发，无需强制升级 3.0。
现有的 2.x 项目因项目需求如想升级到 3.x，可以使用 Creator 提供的 2.x 资源导入工具。此工具将支持旧项目资源完美导入，以及代码的辅助导入。代码辅助导入会把 js 转换成 ts，添加组件类型声明、属性声明及函数声明，组件在场景中的引用都会得到保留，并且函数内部的代码会以注释的形式导入进来，可以减轻开发者的升级难度。详细的升级说明请参考升级指南。
新项目则建议使用 3.0 版本开发，我们会不断优化 3.0 的开发体验和运行效率，支撑好 2D、3D 等不同品类的重度游戏顺利上线。

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.08.10

V3.2.1

发布时间: 2021.08.10

Cocos Creator v3.2.1 是我们将 v3.1.2 合并到 v3.2.1 而来，继续在大版本分支上给大家带来更稳定的体验，v3.2 用户和 v3.1.x 用户都可以无痛升级。

Improvement

Web & 小游戏 2D 渲染性能优化
优化小游戏启动性能
优化动画组件运行时性能
优化 PCF 阴影虚化效果，对低精度 ShadowMap 更加友好
优化 bullet 物理引擎性能
增加自动资源扫描开关，大型项目可以手动刷新资源管理器，提升编辑器体验
创建项目时默认不开启 TS 严格模式（建议手动开启）
解决 Mask 带来的内存泄露
解决 MeshRenderer 设置材质导致的内存泄露
强化 FBX 模型导入的容错
兼容废弃的 AudioClip 播放接口

Bug Fixes

修复部分 iPhone 设备的字节平台上，Shadow map 阴影渲染不出来的问题
修复 Empty 模板创建项目的问题
修复材质编辑器中多 PASS 切换问题和部分属性显示丢失
修复 JointTextureLayout 面板无法滚动
修复 SplashScreen 设置窗口无法关闭问题
修复预制体根节点上的脚本在原生环境中丢失的问题
修复重复加载 Morph 模型导致的渲染错误
修复 TTF 字体丢失时的崩溃
动画编辑器修复
- 修复动画编辑器节点关键帧无法直接删除
- 修复动画编辑器框选后，按下 Ctrl 添加关键帧后复制粘贴、缩放、排列关键帧功能异常
- 修复动画编辑器属性列表超出不出现滚动条、sample 修改后，当前时间显示未实时更新
环境与光影
- 修复开启 IBL 之后的材质报错
- 修复天空盒第一次设置无法显示
- 修复开启 ShadowMap 阴影后 GPU 预烘焙骨骼动画失效
粒子模块修复
- 修复粒子材质在节点未启用的情况下无法显示的问题
- 修复粒子 start speed 效果问题和旋转时的重力效果问题
构建模块修复
- 修复构建插件重启后报错 (来自论坛反馈：构建扩展包刷新报错 )
- 修复自动图集配置修改后构建仍使用缓存 (来自论坛反馈：CC3.1.1自动图集，打包后会保留原图)
- 修复安卓 abi 无默认值与原生 native 文件夹的 git ignore 配置问题 (来自论坛反馈：原生native目录需要进行git版本控制吗 )
Tiledmap 修复
- 修复使用多图集下的 Tilesets 显示错误
- 修复 TiledLayer getTiledTileAt 函数报错问题
2D 骨骼动画
- 修复编辑器更新 color，Spine 和 DB 透明度不生效问题
- 修复 web 和 native 上 Spine 使用 blend mode 显示效果不正确的问题
- 修复 Spine 挂点节点在编辑器设置 scale 后不生效的问题

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.07.21

V2.4.6

发布时间: 2021.07.21

本次更新修复了一些已知问题，Cocos Creator 将持续优化性能，为开发者带来更好的使用体验！以下是详细更新内容。

重要更新

优化编辑器资源加载速度，当资源第一次导入后，后续再次打开编辑器，所需时间仅为之前版本的 50% 以下，极大优化启动速度，提升开发效率
优化编辑器构建时的卡顿问题，我们将引擎编译的过程移动到了 worker 中，不会阻塞主进程的执行，开发者可以在构建时，继续开发工作
优化 iOS 平台序列帧动画性能，在 iPhone 6s Plus 旧机型上最多能提升三倍性能[#8528]
添加场景列表到预览工具栏上，可快速选择预览场景，而无需切换到对应场景，提升工作效率

Editor

修复每次构建后 Zip 文件的 Hash 值不一致的问题
修复拖动带有子类的节点到父类属性上无效的问题
修复点击属性面板上属性选项无法定位到层级面板上的节点的问题
修复灯光节点在移动时，出现 Gizmos 小方块偏移出节点外的问题
修复资源管理器重命名回车以后没有进入到选中状态的问题
修复 3D 粒子 Texture Animation 模块修改 numTilesX 和 numTilesY 没有立即生效的问题。
修复 3D 粒子 Rotation 模块无法设置 separateAxes, 修改 XY 旋转无效的问题。
修复 3D 粒子 Size 模块使用曲线时修改没有立即生效的问题。
新增 VideoClip 类型，视频资源导入后自动识别为 VideoClip 格式
修复压缩纹理出现噪点的问题，感谢大城小胖
修复内置 Unlit 材质 depthWrite 值不对的问题
修复富文本组件导致打开场景数据发生变化的问题[#8903]

Engine

修复材质的 hash 值因为 uniform 的顺序导致计算不正确的问题[#8823]
修复 sp.Skeleton.clearTrack 没有重置初始姿势的问题[#8801]
修复 cc.Color.fromHex 计算错误的问题[#8762]
新增 Node.setSelfGroupIndex 接口用于设置自身分组[#8614]，感谢大城小胖
修复 Mark 组件使用精灵后勾选延迟加载后错误的问题[#8264]
修复事件回调中触发其他事件导致事件丢失的问题[#8276]
修复多次打开软键盘无法将游戏内容上推的问题[#8374]
修复触摸节点，紧接着隐藏节点，释放触点后导致触摸事件全部失效的问题[#8969]
新增 Animation.hasAnimationState API 判断是否存在某个 AnimationState，感谢大城小胖

Mini Game

修复 cc.assetManager.cacheManager.clearLRU 调用报错的问题[#234]

Breaking Change

cc.sys.isNative 在快游戏平台改为 false

升级提示

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

现有的 2.x 项目可以安心继续开发，无需强制升级 3.0。
现有的 2.x 项目因项目需求如想升级到 3.x，可以使用 Creator 提供的 2.x 资源导入工具。此工具将支持旧项目资源完美导入，以及代码的辅助导入。代码辅助导入会把 js 转换成 ts，添加组件类型声明、属性声明及函数声明，组件在场景中的引用都会得到保留，并且函数内部的代码会以注释的形式导入进来，可以减轻开发者的升级难度。详细的升级说明请参考升级指南。
新项目则建议使用 3.0 版本开发，我们会不断优化 3.0 的开发体验和运行效率，支撑好 2D、3D 等不同品类的重度游戏顺利上线。

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。以下是升级说明，如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

从 < 2.4.0 版本升级

cc.loader 已经不建议使用，请使用最新的 cc.assetManager 来代替，请参考资源管理模块升级指南
子包功能已升级为 Asset Bundle，请参考资源分包升级指南
调整了项目构建后的目录结构，调整了 BuildResults 的 API，如果你使用了编辑器插件获取编辑器构建结果，请参考定制项目构建流程升级指南
从 1.10 开始废弃的 cc.RawAsset 已被正式移除，请使用 cc.Asset 代替。由于 2.4 不再兼容原有 1.x 项目中对 RawAsset 类型的历史遗留用法，建议所有要升级到 2.4 的项目特别是从 1.9 版本一路升级上来的项目，先在任意的 1.10 ~ 2.3 版本中对编辑器编译代码时输出的所有警告或报错都正确处理完毕，再升级到 2.4。
cc.Color.fromHex 已被废弃，请使用 cc.Color.fromHEX 接口

从 < 2.3.3 版本升级

Effect 中的 CCTexture2D，CCTexture2DRGB 方法已被废弃，请改用 CCTexture，CCTextureRGB
Vec3.FRONT 已被废弃，请改用 Vec3.FORWARD

从 < 2.3.0 版本升级

从 2.3.0 开始，定制安卓原生工程时，需注意 Android 与 Android Instant 使用了同一个构建模板

如果是 Android 平台单独使用的代码请放入 app/src 目录, 单独使用的第三方库请放入 app/libs 目录。
如果是 Android Instant 单独使用的代码和第三方库请分别放入 game/src, game/libs 目录。
如果是 Android 和 Android Instant 共用的代码和第三方库，请分别放入 proj.android-studio 根目录底下的 src 目录和 libs 目录。
proj.android-studio 根目录底下 jni/CocosAndroid.mk , jni/ CocosApplication.mk，主要用于配置引擎相关的配置，开发者的配置，建议 Android 放到 app/jni/Android.mk 和 app/jni/Application.mk中，Android Instant 请放入 game/jni/Android.mk 和 game/jni/Application.mk 中。

此外，在 Cocos Creator 编译 Android 时会默认执行 assembleRelease/Debug，编译 Android Instant 时会执行 instant:assembleRelease/Debug。
如自定义了音频前后台切换时的暂停逻辑，升级到 2.3.0 后请移除目前 Creator 游戏在所有平台上前后台互相切换时，都会在内部自动暂停和恢复音频。如果开发者之前有对这一块进行过定制，监听并执行了 cc.audioEngine.pause()/resume() 之类的音频操作，可能会和引擎默认行为冲突。如果有遇到相关的音频问题，只需移除相应的定制代码即可。

从 2.0 - 2.3.0 版本升级

从 2.3.0 开始，Canvas 组件不再负责将 Canvas 节点尺寸设为屏幕大小，此行为将结合 Widget 组件实现。为保证兼容性，2.0 项目升级后，Canvas 所在节点会自动添加 Widget 组件。（从 1.x 项目升级无此问题）

从 < 2.2.0 版本升级

从 2.2.0 开始，我们强化了内存管理机制，现在要求用户通过代码动态创建且独立于场景节点树的 cc.Node 必须通过 destroy() 释放，否则引擎无法知道何时回收这类节点的内存，会导致内存泄露。

如原先手动从场景中移除的节点，在不需要用到的时候也需要统一 destroy()：

// 假设 testNode 是场景中的某个节点，若之前被手动移出场景了，如testNode.parent = null;
// 或者
testNode.removeFromParent(true);
// 或者parentNode.removeChild(testNode);
// 若往后 testNode 还会再次用到，则无需手动 destroy 该节点
// 否则应该手动调用
testNode.destroy();

如原先通过 cc.removeSelf 这个 action 销毁节点，请改为使用 cc.destroySelf。
如原先通过 cc.NodePool 管理节点，则不受影响。

从 2.2.0 开始，我们不再建议你使用节点的 Skew 功能。Skew 通常用作在 2D 引擎中模拟 3D 效果，随着 Cocos Creator 对 3D 节点的深入支持，Skew 效果已经完全可以由 3D 节点来实现。所以为了统一使用体验，进一步优化引擎底层实现，我们废弃了 Skew 属性。不过我们依旧会保留一段时间内的向下兼容，开发者可在旧项目中延续原有做法。后续我们将进一步完善兼容方式和升级案例，择机正式移除 Skew 功能。

从 < 2.0 版本升级

打开 1.x 项目的话，场景等所有资源将会自动升级，代码中的废弃接口从 2.3.3 开始将会在保持兼容的基础上同步输出报错。升级方式可参考《1.10 资源升级指南》和《2.0 升级文档》进行调整。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.07.15

V3.1.2

发布时间: 2021.07.15

v3.1.2 是在 v3.1.1 上优化体验和性能的版本，这个版本的更新内容是不包含在 v3.2 中的，之后会将 v3.1.2 的更新合并到 v3.2.1 和 v3.3.0。

从 3.1.0 之后引擎组其实一直在并行推进三个版本线，v3.2.0, v3.1.x, v3.3.0，其中 v3.2 由于有配合鸿蒙 2.0 发布的需求，所以发布日早就定下了，为了稳定性其实主要就是在 v3.1.1 基础之上增加了鸿蒙平台支持。而在这之后，我们也在持续收到开发者关于 3.1 的问题反馈，为了更切实解决开发者遇到的痛点问题，并且降低开发者的升级门槛，我们决定继续在 v3.1.2 上优化体验和性能，交付给开发者。目前 Cocos Creator v3.x 作为一个新生的 3D 引擎，距离开发者的期待还有不小的距离，我们希望通过这种持续交付的实际行动来给开发者更强的信心。同时感谢所有 v3.x 先行者的支持，是你们的反馈让引擎日趋完善！

Improvement

Web & 小游戏 2D 渲染性能优化
优化小游戏启动性能
优化动画组件运行时性能
优化 PCF 阴影虚化效果，对低精度 ShadowMap 更加友好
优化 bullet 物理引擎性能
增加自动资源扫描开关，大型项目可以手动刷新资源管理器，提升编辑器体验
创建项目时默认不开启 TS 严格模式（建议手动开启）
解决 Mask 带来的内存泄露
解决 MeshRenderer 设置材质导致的内存泄露
强化 FBX 模型导入的容错
兼容废弃的 AudioClip 播放接口

Bug Fixes

修复 Empty 模板创建项目的问题
修复材质编辑器中多 PASS 切换问题和部分属性显示丢失
修复 JointTextureLayout 面板无法滚动
修复 SplashScreen 设置窗口无法关闭问题
修复预制体根节点上的脚本在原生环境中丢失的问题
修复重复加载 Morph 模型导致的渲染错误
修复 TTF 字体丢失时的崩溃
动画编辑器修复
1. 修复动画编辑器节点关键帧无法直接删除
2. 修复动画编辑器框选后，按下 Ctrl 添加关键帧后复制粘贴、缩放、排列关键帧功能异常
3. 修复动画编辑器属性列表超出不出现滚动条、sample 修改后，当前时间显示未实时更新
环境与光影
1. 修复开启 IBL 之后的材质报错
2. 修复天空盒第一次设置无法显示
3. 修复开启 ShadowMap 阴影后 GPU 预烘焙骨骼动画失效
粒子模块修复
1. 修复粒子材质在节点未启用的情况下无法显示的问题
2. 修复粒子 start speed 效果问题和旋转时的重力效果问题
构建模块修复
1. 修复构建插件重启后报错 (来自论坛反馈：构建扩展包刷新报错 2)
2. 修复自动图集配置修改后构建仍使用缓存 (来自论坛反馈：CC3.1.1自动图集，打包后会保留原图)
3. 修复安卓 abi 无默认值与原生 native 文件夹的 git ignore 配置问题 (来自论坛反馈：原生native目录需要进行git版本控制吗 2)
Tiledmap 修复
1. 修复使用多图集下的 Tilesets 显示错误
2. 修复 TiledLayer getTiledTileAt 函数报错问题
2D 骨骼动画
1. 修复编辑器更新 color，Spine 和 DB 透明度不生效问题
2. 修复 web 和 native 上 Spine 使用 blend mode 显示效果不正确的问题
3. 修复 Spine 挂点节点在编辑器设置 scale 后不生效的问题

以上就是 v3.1.2 的重要更新，优化了大量开发者反馈的问题，有些问题由于反馈众多，就不单独列出论坛链接了，如果有修复各位遇到的问题，欢迎大家去关联到本帖并标记已解决。

另外，v3.3.0 版本已进入迭代后期，这个版本有一些非常重要的更新可以提前透露给大家：

进一步提高原生化比重，在原生层实现渲染场景，优化性能，为未来的上层原生化和场景管理打好基础
渲染管线优化，降低 IO 压力
优化大项目使用体验：降低编辑器内存使用，避免崩溃，优化卡顿
优化标准光照模型
动画数据重构升级：为动画系统升级和动画状态机做好准备
各个后端物理行为统一
延迟渲染管线优化：光源裁剪、SSPR 等

除此之外还有各种 Demo 也在制作当中，比如已经上架 Store 的跑酷 Demo 56
API 文档页面也在进行重新设计，我们都非常重视，会尽力一步步完善 Cocos Creator v3.x 的 2D & 3D 开发体验！

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.06.18

V3.2.0

发布时间: 2021.06.18

Cocos Creator 3.2 正式支持 HarmonyOS，成为全球首家支持 HarmonyOS 的游戏引擎。与此同时，Creator 与字节跳动平台进行了深度合作，以实验性功能支持在字节小游戏中使用平台提供的 PhysX 物理能力！欢迎所有开发者使用与体验！以下是详细更新内容。

What's new

支持构建 HarmonyOS 应用

在 3.2 版本，Creator 将支持一键将游戏打包为 HarmonyOS 应用，在配置 HarmonyOS SDK 与 NDK 路径后，可在构建面板选择 HarmonyOS 一键打包，详细操作请参考文档发布 HarmonyOS 应用。

字节跳动小游戏支持使用平台提供的 PhysX 能力

字节跳动平台一直致力于为开发者提供最强大的性能和基础能力，抖音将在 16.3 之后版本为小游戏提供 PhysX 原生物理接口，而 Creator 与字节跳动平台进行了深度合作，在 3.2 中以实验性功能支持在字节小游戏中使用平台提供的 PhysX 物理能力，优化物理运算性能，对比 Bullet 有近 100% 的性能提升。

可以在构建面板选择是否开启多线程：

升级说明

从 < 3.1.0 版本升级

从 v3.1 开始，UITransform 组件的 priority 属性已弃用，若需要调整节点树的顺序请使用 setSiblingIndex 方法。在 v3.1 之前通过代码创建并依赖 priority 属性的节点可能会出现节点树表现和之前不一致的问题，请手动调整。
RenderTexture 在不同平台上会出现正反不一致的情况，为了解决这个问题，Creator 为 effect 新增了 SAMPLE_FROM_RT 宏，在使用 RenderTexture 时，需要将 SAMPLE_FROM_RT 宏设置为 true，各后端便会统一适配至正确的效果。

从 < 2.4.5 版本升级

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

现有的 2.x 项目可以安心继续开发，无需强制升级 3.0。
现有的 2.x 项目因项目需求如想升级到 3.x，可以使用 Creator 提供的 2.x 资源导入工具。此工具将支持旧项目资源完美导入，以及代码的辅助导入。代码辅助导入会把 js 转换成 ts，添加组件类型声明、属性声明及函数声明，组件在场景中的引用都会得到保留，并且函数内部的代码会以注释的形式导入进来，可以减轻开发者的升级难度。详细的升级说明请参考升级指南。
新项目则建议使用 3.0 版本开发，我们会不断优化 3.0 的开发体验和运行效率，支撑好 2D、3D 等不同品类的重度游戏顺利上线。

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.06.01

V3.1.1

发布时间: 2021.06.01

Cocos Creator 3.1.1 主要修复了 v3.1 出现的稳定性问题，并优化了编辑器工作流。欢迎所有开发者使用与体验！升级前请做好相关文件备份哦！以下是详细更新内容。

Improvement

新增在资源管理器面板创建 Prefab 资源的功能

新增层级管理器面板可批量设置（Alt + 点击）锁定节点的功能（锁定后在场景编辑器面板中无法被选中）

当属性检查器中的属性为非 null 类型，但为 null 值时，新增创建功能

Bug Fixes

[EDITOR]修复构建安卓平台时可能报错的问题
[EDITOR]修复使用默认值进行命令行构建时无法成功的问题
[EDITOR]修复命令行构建时一些布尔型参数转换错误的问题
[EDITOR]修复构建安卓平台时 Target Api Level 修改无效的问题
[EDITOR]修复压缩纹理同时选择 ETC1 RGB Separate A 格式与 PNG 格式时，PNG 格式图片生成错误的问题
[EDITOR]修复添加骨骼动画事件后无法全部删除的问题
[EDITOR]修复动画编辑器分量轨道的选中问题
[EDITOR]修复在 Prefab 中引用嵌套 Prefab 中的节点或组件保存后会丢失的问题。
[EDITOR]修复在 Prefab 实例中新添加的组件中引用 Prefab 里的节点或组件保存后会丢失的问题。
[EDITOR]修复属性检查器界面记录折叠状态失效的问题
[EDITOR]修复在属性检查器面板编辑节点 Layer 属性后没有弹出是否一起修改子节点的问题
[EDITOR]修复属性检查器面板中数组不识别拖入资源的问题
[EDITOR]修改将 SpriteFrame 资源拖到层级管理器面板创建节点时，节点的 Layer 属性不为 UI_2D 的问题
[EDITOR]修复资源预览面板中对末级资源无选中记录的问题
[EDITOR]修复资源管理器面板在折叠起来的文件夹内不能准确滚动定位到内部资源的问题
[EDITOR]修复 Joint Texture Layout 面板无法滚动的问题
[ENGINE]修复 SafeArea 组件效果不正确的问题 #8654
[ENGINE]修复小米快游戏平台音频调用 pause 之后，调用 stop 时间刻度没有重置为 0 的问题 #8636
[ENGINE]修复华为快游戏平台音频获取 currentTime 为 string 类型的问题 #8656
[ENGINE]修复连尚小游戏平台的触摸事件回调会导致在低端机上卡顿的问题 #8661
[ENGINE]修复在 iPad 浏览器上触摸事件不可用的问题 #8673
[ENGINE]修复 QQ 浏览器、微信小游戏 iOS 端、百度小游戏的重力感应无法开启或不正确的问题 #8632
[ENGINE]修复 CacheManager.clearLRU 调用报错的问题 #8663
[ENGINE]修复 SubContextView 节点因为节点 Layer 修改而不能被渲染的问题 #8677

Known Issues

微信 PC 端的键盘和鼠标适配有问题，我们将在下个版本修复这个问题，也可以手动合并此 PR 修复：#8626
在 Sprite 设置完 RenderTexture 后需要手动调用下 Sprite.updateMaterial 函数，否则可能导致在某些平台出现图像翻转的问题
在场景天空盒选项上勾选 UseIBL 可能会导致 cc_environment 绑定丢失，将在下个版本修复此问题

升级说明

从 < 3.1.0 版本升级

从 v3.1 开始，UITransform 组件的 priority 属性已弃用，若需要调整节点树的顺序请使用 setSiblingIndex 方法。在 v3.1 之前通过代码创建并依赖 priority 属性的节点可能会出现节点树表现和之前不一致的问题，请手动调整。
RenderTexture 在不同平台上会出现正反不一致的情况，为了解决这个问题，Creator 为 effect 新增了 SAMPLE_FROM_RT 宏，在使用 RenderTexture 时，需要将 SAMPLE_FROM_RT 宏设置为 true，各后端便会统一适配至正确的效果。

从 < 2.4.5 版本升级

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 对项目的升级操作是不可逆的，请在升级前提交或备份旧版本项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.05.12

V3.1.0

发布时间: 2021.05.12

3.0 版本的推出标志着 Creator 迈向了一个全新的征程，而 Creator 3.1 就是征途上的第一块基石，此次版本更新带来了很多非常棒的新特性，包含华为海思团队贡献的延迟渲染管线，PhysX 物理后端的支持等等；同时，相对 3.0 版本，各方面的性能也得到了优化，例如帧动画性能，加载性能，包体等等。我们将会在 3.x 的基础上继续深耕，用真诚的态度和敬业的精神，踏踏实实完善产品体验，普惠所有开发者。欢迎所有开发者使用与体验！升级前请做好相关文件备份哦！

What's new

新增延迟渲染管线（感谢华为海思团队的贡献），可在项目设置中选择延迟渲染管线

引入多线程渲染架构。在原生平台上，传统的单线程架构已无法满足大规模场景的渲染，因此，Creator 在 v3.1 中将传统的单线程架构初步拆分为了渲染线程和设备线程两个主线程。除了主线程的拆分外，Creator 还将 command buffers 的提交过程并行化，加快渲染效率。多线程渲染架构图如下：

增加 PhysX 物理支持，目前支持除了安卓 x86 之外的原生平台，在 iOS 上有 100% 以上的性能提升（若需要在 web 平台上预览可以参考 example-3d 里面的 physics-3d 工程，主要修改内容在 preview-template 文件夹中）

编辑器支持骨骼八面体展示，可以直观看到模型骨骼的分布状态

支持在 FBX/glTF 资源的 Inspector 上预览动画

开放新版曲线编辑器，支持分别编辑左右斜率，支持直接显示曲线的循环模式

安卓平台支持构建 x86_64 架构
支持在 Prefab 实例上添加/删除组件
Mac 构建新增支持 M1 选项，用于更好地对一些已知的引擎模块在 Apple M1（Silicon）架构的设备上的支持问题做提示
添加场景即时缓存的实验室功能，默认开启，可在场景异常退出后恢复数据
编辑器添加 ui-curve、ui-curve-editor 组件，插件开发者可在插件中直接使用

Improvement

提升引擎原生平台运行性能
提升引擎帧动画运行性能
提升运行时资源加载速度（构建模式）
优化动画编辑器在编辑大数量关键帧时的卡顿问题
自动图集面板新增针对 Bundle 内使用自动图集的优化选项，共增加三个选项，用于自动图集在 Bundle 内时的一些不必须信息剔除，优化包体
优化自动图集被多个 Bundle 引用导致图片被复制的问题，减少包体
Shadow Map 支持了线性深度，深度图压缩（与线性深度功能互斥），自阴影效果，以及 normal bias 参数设置
Lighting Map 支持 RGBE 格式

Editor

优化动画编辑器的事件编辑面板，避免产生空函数数据
构建的输出地址修改为支持协议头的路径
构建导出配置支持跨版本导入使用
构建面板添加校验机制，数据填写错误时将无法构建
优化部分小游戏平台打包 rpk 的输出日志
优化构建输出 log 信息，修复日志丢失问题
优化资源丢失处理，可以在资源恢复后自动还原
新建 Button 默认对 Label 节点上锁，方便在场景中选中
修复从 Prefab 退出可能引起的场景数据问题
FBX 导入时可选择动画烘焙速率
解决部分 FBX 导入会导致编辑器卡死的问题
FBX/glTF 增加导入选项“提升单一根结点”
修复了 TiledMap 导入 .tmx 资源时丢失问题

Engine

修复了 TiledMap 动画失效问题
修复了 Spine 在原生下预乘不生效的问题
修复了 Spine 开启预乘下设置透明度显示异常问题
修复了部分机型 Vulkan 驱动不兼容问题
修复 Metal 相关平台 Shadow Map 显示错乱问题。

Breaking Changes

移除了 AudioClip 的播放接口，并且不支持 started 事件监听，AudioClip 现在是纯音频资源类型
effect 资源中不能再直接调用 CCStandardShading 函数，统一封装进 CC_STANDARD_SURFACE_ENTRY 宏定义，建议只在 surface 函数中做自定义逻辑
GFX 模块改名，去掉 GFX 前缀，统一使用 import { gfx } from 'cc';
构建面板上移除了自动图集、压缩纹理开关，项目在配置了自动图集与压缩纹理后将会直接处理
弃用 cc-fog 头文件，改用 cc-fog-vs 和 cc-fog-fs
移除了 sys 下的部分常量 sys.LINUX，sys.BLACKBERRY，sys.EMSCRIPTEN，sys.TIZEN，sys.WINRT，sys.WP8，sys.QQ_PLAY，sys.FB_PLAYABLE_ADS

Known Issues

微信 PC 端的键盘和鼠标适配有问题，我们将在 v3.1.1 里修复这个问题，你可以手动合并此 PR 修复 #8626
SafeArea 组件暂时无法正常使用，我们将在 v3.1.1 里修复这个问题，你可以通过手动合并此 PR 来解决此问题 #8652
在 Sprite 设置完 RenderTexture 后需要手动调用下 Sprite.updateMaterial 函数，否则在某些平台下可能出来图像翻转

升级说明

从 < 3.1.0 版本升级

UITransform 组件的 priority 属性从 3.1 开始不建议使用，设置 priority 属性来排布节点顺序的方法弃用，请使用 setSiblingIndex 方法改变节点树顺序。通过代码创建添加并依赖此属性的节点可能会遇到节点树表现和之前不一致的问题，请手动调整。
RenderTexture 在不同平台上会出现正反不一致的效果，Creator 为 effect 新增了 SAMPLE_FROM_RT 宏，当需要使用 RenderTexture 时，需要设置 SAMPLE_FROM_RT 宏为true，此时各后端会统一适配至正确的效果。

从 < 2.4.5 版本升级

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

现有的 2.x 项目可以安心继续开发，无需强制升级 3.0。
现有的 2.x 项目因项目需求如想升级到 3.x，可以使用 Creator 提供的 2.x 资源导入工具。此工具将支持旧项目资源完美导入，以及代码的辅助导入。代码辅助导入会把 js 转换成 ts，添加组件类型声明、属性声明及函数声明，组件在场景中的引用都会得到保留，并且函数内部的代码会以注释的形式导入进来，可以减轻开发者的升级难度。详细的升级说明请参考升级指南。
新项目则建议使用 3.0 版本开发，我们会不断优化 3.0 的开发体验和运行效率，支撑好 2D、3D 等不同品类的重度游戏顺利上线。

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.04.19

V2.4.5

发布时间: 2021.04.19

What’s New

支持 Apple Silicon (M1) 芯片的运行环境

Bug Fixes

修复 effect 资源有语法错误时，导致内置 effect 加载失败的问题
修复动画编辑器第一次进入，刻度条没有归 0 的问题
修复编辑动画之后，组件上的动画顺序变化的问题[#8295]
修复在 onDestroy 中移除常驻节点，报错的问题[#8314]
修复火狐浏览器 Scroll View 滚动速度与 Chrome 上不一致的问题[#8306]
修复 iPad 上横屏玩竖屏游戏，SafeArea 错误的问题，感谢大城小胖 [#224]

升级提示

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

现有的 2.x 项目可以安心继续开发，无需强制升级 3.0。
新项目则建议使用 3.0 版本开发，我们会不断优化 3.0 的开发体验和运行效率，支撑好 2D、3D 等不同品类的重度游戏顺利上线。

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。以下是升级说明，如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

从 < 2.4.0 版本升级

cc.loader 已经不建议使用，请使用最新的 cc.assetManager 来代替，请参考资源管理模块升级指南
子包功能已升级为 Asset Bundle，请参考资源分包升级指南
调整了项目构建后的目录结构，调整了 BuildResults 的 API，如果你使用了编辑器插件获取编辑器构建结果，请参考定制项目构建流程升级指南
从 1.10 开始废弃的 cc.RawAsset 已被正式移除，请使用 cc.Asset 代替。由于 2.4 不再兼容原有 1.x 项目中对 RawAsset 类型的历史遗留用法，建议所有要升级到 2.4 的项目特别是从 1.9 版本一路升级上来的项目，先在任意的 1.10 ~ 2.3 版本中对编辑器编译代码时输出的所有警告或报错都正确处理完毕，再升级到 2.4。
cc.Color.fromHex 已被废弃，请使用 cc.Color.fromHEX 接口

从 < 2.3.3 版本升级

Effect 中的 CCTexture2D，CCTexture2DRGB 方法已被废弃，请改用 CCTexture，CCTextureRGB
Vec3.FRONT 已被废弃，请改用 Vec3.FORWARD

从 < 2.3.0 版本升级

从 2.3.0 开始，定制安卓原生工程时，需注意 Android 与 Android Instant 使用了同一个构建模板

如果是 Android 平台单独使用的代码请放入 app/src 目录, 单独使用的第三方库请放入 app/libs 目录。
如果是 Android Instant 单独使用的代码和第三方库请分别放入 game/src, game/libs 目录。
如果是 Android 和 Android Instant 共用的代码和第三方库，请分别放入 proj.android-studio 根目录底下的 src 目录和 libs 目录。
proj.android-studio 根目录底下 jni/CocosAndroid.mk , jni/ CocosApplication.mk，主要用于配置引擎相关的配置，开发者的配置，建议 Android 放到 app/jni/Android.mk 和 app/jni/Application.mk中，Android Instant 请放入 game/jni/Android.mk 和 game/jni/Application.mk 中。

此外，在 Cocos Creator 编译 Android 时会默认执行 assembleRelease/Debug，编译 Android Instant 时会执行 instant:assembleRelease/Debug。
如自定义了音频前后台切换时的暂停逻辑，升级到 2.3.0 后请移除目前 Creator 游戏在所有平台上前后台互相切换时，都会在内部自动暂停和恢复音频。如果开发者之前有对这一块进行过定制，监听并执行了 cc.audioEngine.pause()/resume() 之类的音频操作，可能会和引擎默认行为冲突。如果有遇到相关的音频问题，只需移除相应的定制代码即可。

从 2.0 - 2.3.0 版本升级

从 2.3.0 开始，Canvas 组件不再负责将 Canvas 节点尺寸设为屏幕大小，此行为将结合 Widget 组件实现。为保证兼容性，2.0 项目升级后，Canvas 所在节点会自动添加 Widget 组件。（从 1.x 项目升级无此问题）

从 < 2.2.0 版本升级

从 2.2.0 开始，我们强化了内存管理机制，现在要求用户通过代码动态创建且独立于场景节点树的 cc.Node 必须通过 destroy() 释放，否则引擎无法知道何时回收这类节点的内存，会导致内存泄露。

如原先手动从场景中移除的节点，在不需要用到的时候也需要统一 destroy()：

// 假设 testNode 是场景中的某个节点，若之前被手动移出场景了，如

testNode.parent = null;

// 或者

testNode.removeFromParent(true);

// 或者

parentNode.removeChild(testNode);

// 若往后 testNode 还会再次用到，则无需手动 destroy 该节点

// 否则应该手动调用

testNode.destroy();

如原先通过 cc.removeSelf 这个 action 销毁节点，请改为使用 cc.destroySelf。
如原先通过 cc.NodePool 管理节点，则不受影响。

从 2.2.0 开始，我们不再建议你使用节点的 Skew 功能。Skew 通常用作在 2D 引擎中模拟 3D 效果，随着 Cocos Creator 对 3D 节点的深入支持，Skew 效果已经完全可以由 3D 节点来实现。所以为了统一使用体验，进一步优化引擎底层实现，我们废弃了 Skew 属性。不过我们依旧会保留一段时间内的向下兼容，开发者可在旧项目中延续原有做法。后续我们将进一步完善兼容方式和升级案例，择机正式移除 Skew 功能。

从 < 2.0 版本升级

打开 1.x 项目的话，场景等所有资源将会自动升级，代码中的废弃接口从 2.3.3 开始将会在保持兼容的基础上同步输出报错。升级方式可参考《1.10 资源升级指南》和《2.0 升级文档》进行调整。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.04.14

V3.0.1

发布时间: 2021.04.14

Creator 3.0 版本作为引擎组的新基线版本，统一了 2D 与 3D 的开发工作流，兼顾了轻量与重度游戏的开发体验，融合了几乎所有 Creator 2.x 与 Creator 3D 1.x 版本的功能。一经推出就受到了大家的踊跃尝试与使用，并收到了许多积极反馈。而此版本主要面向 3.0 版本以来的问题修复与使用体验优化。我们将会在 3.x 的基础上继续深耕，用真诚的态度和敬业的精神，踏踏实实完善产品体验，普惠所有开发者。欢迎所有开发者使用与体验！升级前请做好相关文件备份哦！

What's New

移除选项“模拟全局变量”，新增选项“执行作用域”

可选值为 Global 或 Enclosed。当为 Global 时，直接在目标环境中执行该脚本。当为 Enclosed 时，将整个脚本包裹在 IIFE 函数中执行，这意味着脚本顶部以 var 声明的变量不会提升为全局变量。

增加将场景相机对齐到某个节点上的功能

增加 2D/3D 模式切换快捷键（数字键2）

Improvement

当项目中试图引用 Node 模块时给予更明确的提示
构建时消除包体中项目脚本冗余代码
优化微信引擎分离功能与模块剔除，减小包体
支持了 BMFont 使用透明通道分离格式的压缩纹理 #8364

Editor

修复命令行构建将会新增构建任务的问题
修复特定情况下快捷键面板的快捷键可能无法被修改成功的问题
修复右键删除多个选中动画事件有延迟的问题
修复骨骼动画在动画编辑器内不能正常的点击属性轨道以及移动小红线查看等等问题
修复创建构建插件后需要手动刷新插件管理器才能显示的问题
修复 Mac 上插件管理器导入插件失败的问题
修复插件商城关闭时弹出警告的问题
修复引擎主光源与烘培效果存在差异问题
修复烘培非 n*n 地形错误的问题
修复编辑粒子节点的界面存在的缓存问题
修复图片为 textrue 类型时不显示子资源编辑界面的问题
修复快捷键配置面板无法滚动的问题
修复切换场景后地形节点的地形刷没有重置的问题
修复 M1 设备上无法构建 iOS 工程的问题
修复 glTF 资源导入的时候，可能丢失子资源的问题
修复创建的构建插件模版文件无法修改问题
修复预览的时候，scene.name 丢失的问题

Engine

[SPINE] 修复 SkeletonTexture 类型没有导出的问题 #8359
[UI] 修复 iOS 14 上静态合批组件渲染不正确的问题 #8320
[UI] 修复 RichText 组件的换行不正确的问题 #8345
[UI] 修复了 Mask 点击穿透的问题 #8313
[UI] 修复了 Widget 的 always 模式的问题 #8304
[UI] 修复了 Mask 内存泄漏的问题 #8375
[SHADOW] 修复了平面阴影在 instancing 下，设置额外的纹理报错的问题 #8336
[SHADOW] 修复了 Nvidia 显卡下，透明模型开启 shadow map 后渲染错误的问题 #8303
[SHADOW] 修复了平面阴影在多光源下，不显示的问题 #8328
[TWEEN] 修复 Tween 不支持自定义缓动函数的问题 #8321
[PHYSICS] 修复未启用时刚体的初始化类型不正确的问题 #8307
[PHYSICS] 修复 Ammo 运行时设置网格不生效的问题 #8315
[ASSET] 修复了在 WebGL2 环境下 ETC1 格式压缩纹理的渲染问题 #8351

Native

修复原生 Spine/Dragonbones 节点 active 更改后无法显示的问题 #8323
修复 Win32 / macOS 平台 EditBox 回车无法结束编辑的问题 #3295

Breaking Change

缓动系统更新时机从 lateUpdate 阶段之后更改为 update 阶段之后，可能需要调整处理时机 #8305
为了适配 M1，重新编译了第三方库，要求 Xcode 版本为 11.5+

Known Issue

在导入含有负帧动画的 FBX 时可能造成编辑器不工作，请在相应 DCC 工具中确定没有负帧动画出现，之后版本将修复此问题
原生平台 Spine 预乘渲染不正确，之后版本将修复此问题

升级提示

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

现有的 2.x 项目可以安心继续开发，无需强制升级 3.0。
新项目则建议使用 3.0 版本开发，我们会不断优化 3.0 的开发体验和运行效率，支撑好 2D、3D 等不同品类的重度游戏顺利上线。

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。详细的升级说明请参考升级指南，如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.02.07

V3.0.0

发布时间: 2021.02.07

在 3.0 预览版发布后，引擎组收到了大量开发者的热情反馈，引擎组工程师们动力倍增，经过了又两个月的迭代后，终于将这灌注了汗水与热血的产品正式推出。Creator 3.0 统一了 2D 与 3D 的开发工作流，兼顾了轻量与重度游戏的开发体验，融合了几乎所有 Creator 2.x 与 Creator 3D 1.x 版本的功能，而这一切都是建立在 Creator 3.0 更加健壮的面向未来的底层架构上，这对引擎组来说是个具有重要意义的里程碑。我们会在 3.0 的基础上继续深耕，用真诚的态度和敬业的精神，踏踏实实完善产品体验，普惠所有开发者。3.0 正式版在预览版的基础上，进一步优化了性能，完善了品质，并推出了更多功能，例如接入了 Spine，DragonBones 的原生运行时，支持使用 NPM 库，重构了 Prefab 系统与 UI 系统等诸多内容。欢迎所有开发者使用与体验！

3.0 使用了面向未来的全新引擎架构，将为引擎带来高性能、面向数据及负载均衡的渲染器，并且无缝支持 Vulkan & Metal 多后端渲染，未来还会支持移动端 VR/AR 及部分主机平台。下面对 3.0 的部分特性进行简要介绍。

强大的编辑器特性

一体化的编辑器，带来轻量易用的创作体验。Cocos Creator 3.0 在 Cocos Creator 2.x 沿用多年的编辑器框架上进行了重构、拓展和升级。

全新界面设计，更加简洁清晰
资源系统升级，增强对超大项目的支持，更加高效可靠
模块之间代码隔离，纯消息驱动，更加稳定
插件系统彻底模块化，迎接更强大的插件机制

一键接入 Cocos Service 优质服务

Cocos Creator 3.0 可一键接入 Cocos 官方推出的各类优质服务，提升开发效率，推出更多优质内容，Cocos 也将持续推出更多更优质的服务。

全新的 Prefab 系统

Creator 3.0 重新实现了 Prefab 系统，

支持 Prefab 自动同步
Prefab 实例可覆写 Prefab 资源中的属性
支持 Prefab 嵌套

构建

缓存构建内容

在构建之后，Creator 3.0 将会缓存大部分构建内容，包括资源，压缩纹理，自动图集，引擎代码等，在之后构建中，如果没有变化，将直接使用缓存内容，加快构建速度，提升效率。

任务式构建列表

构建发布将以构建任务的形式进行，保存每次构建的配置、状态、log 等，方便切换构建任务以及查看历史配置。

构建后单独编译、生成

提取了各个小游戏平台的生成阶段，允许在构建之后修改文件内容重新生成 rpk/cpk，同时可以支持在编译前后添加构建钩子来定制构建流程。

支持 Asset Bundle

和 2.4 一样，3.0 也使用 Asset Bundle 作为资源模块化工具。开发者可以将贴图、脚本、场景等资源构建为多个 Asset Bundle 中，进而在游戏运行过程中按需加载，从而减少首次下载和加载游戏所需的时间。Asset Bundle 可以按需求随意放置，比如可以放在远程服务器、本地，或者小游戏平台的分包中，也可以跨项目复用，用于加载子项目中的 Asset Bundle。

Splash Screen

支持在构建时设置 Splash Screen，用于在游戏启动之前显示一段过场动画，优化首屏启动速度。

GameView

GameView 是内嵌于编辑器的游戏运行面板，开发者无需打开浏览器预览，即可在编辑器中直接运行游戏。除了更无缝的开发体验，还能在游戏运行过程中通过场景编辑器或其它面板实时调试、修改元素状态，让游戏开发更高效！

插件

强大的插件系统

Cocos Creator 3.0 拥有更加强大的插件系统，编辑器几乎所有功能模块都是以插件形式存在。你可以在扩展菜单中快速创建自己的插件，从而实现自己想要的效果。另外，Cocos Creator 3.0 还提供了扩展管理器，可以轻松管理所有扩展插件的运行和卸载。

消息通信

插件可以使用 IPC 消息与其他插件或编辑器进行通信，快速方便地使用编辑器内部已提供的能力。Cocos Creator 3.0 还提供了消息管理器，可以清晰地看到目前编辑器内已提供的功能，降低插件开发门槛。

动画编辑器

动画编辑器是我们一直在持续优化的重要模块，除了标准的位移、旋转、缩放动画和序列帧动画以外，这套动画系统还支持驱动任意组件属性和用户自定义属性，再加上可任意编辑的时间曲线和创新的移动轨迹编辑功能，能够让内容生产人员不写一行代码就制作出细腻的各种动态效果，任意驱动游戏逻辑。

除常规操作外，3.0 的动画编辑器更提供了以下快捷操作，帮助游戏开发者实现想要的内容：

批量关键帧间隔调整
跨节点轨道复制粘贴
间接属性（如材质属性）关键帧编辑
动画编辑器内直接对资源进行选取、直接编辑关键帧数据
多选关键帧的缩放、移动和删除
支持多选节点后批量添加属性轨道
支持复制粘贴节点上的所有动画数据
支持屏蔽无关键帧节点与搜索节点
支持编辑分量轨道
支持调整动画编辑器布局

更完善的工具链

支持模型预览
编辑器中选中模型后可以对模型资源进行全方位预览，也可以查看默认材质中使用的各种贴图。
新版的 FBX 导入器
支持 glTF 资源的导入，支持 khr-draco-mesh-compression、sparse accessor
支持动画切割
提供 Mesh Optimizer 工具
模型导入支持 quantized joints/weights

地形编辑器

便捷的地形系统，快速绘制地形纹理。地形编辑主要包括三大功能：管理（Manage）、雕刻（Sculpt）、描绘（Paint）。同时支持 Normal Map，PBR 材质和自定义材质。

内置烘焙系统

烘焙是通过预先计算光源对物体的影响来生成光照贴图并应用到场景中的过程，可以在不损失运行效率的前提下大大提升静态场景的画面表现。

配置

可视化的宏配置

提供了修改引擎宏配置的快捷方式，配置的宏将会在预览、构建时生效，同时也会跟随自定义引擎的配置更新当前宏配置的默认值。

通过预设批量配置压缩纹理

支持添加压缩纹理预设配置，用于快速配置纹理的压缩方式。给图片设置预设后，还可以直接修改预设来批量更新对应的纹理，大大方便了项目的全局管理。

支持 2.x 项目迁移

为了方便 2.x 用户升级，我们在 3.0 中提供了项目迁移插件，可将 2.4.3 以上版本的项目迁移到 3.0.0 版本中，此工具将支持旧项目资源完美导入，以及代码的辅助导入。代码辅助导入会把 js 转换成 ts，添加组件类型声明、属性声明及函数声明，组件在场景中的引用都会得到保留，并且函数内部的代码会以注释的形式导入进来，可以减轻开发者的升级难度。不过 2.x 的 API 和 3.0 仍然有不小的差异，我们能尽可能通过 deprecation 和 removal 机制来做运行时警告，开发者的代码仍需做不小的调整才能够完美升级到 3.0。

强大的引擎特性

Cocos Creator 2.4 在 2D 渲染方面很强大，Cocos Creator 3.0 则允许开发者制作出更加精美的 3D 游戏。我们在 3.0 中将两者的优势进行了融合，全面支持 2D、3D 的各种功能特性，无论 2D 还是 3D，3.0 都将满足你的需求。

渲染系统

渲染系统作为游戏引擎的核心模块，起着至关重要的作用，直接决定了游戏所能输出给玩家的内容。一个优秀的渲染系统还必须兼顾各类平台，抹平平台间的差异。Cocos Creator 3.0 的渲染系统，从架构到设计都是以面向未来、高性能、跨平台为目标，极大地提升了渲染能力和健壮性。

支持 Metal, Vulkan, WebGL 1.0，WebGL 2.0，GLES2, GLES3 的多渲染后端，向渲染管线层提供统一的 GFX 图形 API 层
贴近现代图形 API 的 GFX API 设计，帮助渲染管线层尽可能释放现代图形 API 提供的性能和可能性
内置前向渲染管线，支持用户自定义渲染管线
基于物理的光源、摄像机和材质，帮助开发者用工业化流程制作最真实的视觉效果。

支持 GPU Instancing 合批优化，适用于绘制大量顶点数据相同的动态模型，更支持对包含骨骼动画计算的模型进行 instancing 合批

支持全局雾效

强大的原生渲染器，使用内存共享机制减少 JSB 调用，加快数据访问
支持 ASTC，ETC，ETC2，PVR 等压缩纹理

光影

在 3D 世界中，光与影一直都是极其重要的组成部分，它们能够丰富环境表现，质量好的阴影可以达到以假乱真的效果，并且使得整个世界更具立体感。

基于物理的光源
Cocos Creator 3.0 采用光学度量单位来描述光源参数。基于光学度量单位，我们可以将光源的相关参数全部转化为真实世界中的物理值。这样，设计人员可根据实际灯光的工业参数以及真实环境的实际物理参数来调节光照强度、颜色、范围等信息，使整体光照效果和光照衰减更加符合真实的自然环境。

基于多 Pass 的多光源支持
支持高性能的平面阴影 Planar Shadow
基于 Shadow Map 的方向光和聚光灯动态阴影，支持 PCF 软阴影与 GPU Instancing

粒子系统

粒子系统是游戏引擎特效表现的基础，它可以用于模拟的火、烟、水、云、雪、落叶等自然现象，也可用于模拟发光轨迹、速度线等抽象视觉效果。良好的粒子效果可以使游戏画面更加惊艳。

支持多达数十个模块设置，并支持各类曲线，常量变化

支持 GPU 粒子，极大提升渲染性能
支持 Cocos 传统的 2D 粒子

材质系统

材质作为资源，决定了其所附加的物体的渲染效果，几乎游戏中所有渲染出来的效果都与材质密不可分。材质系统作为基础模块，为上层建筑提供了坚实的基础。

内置基于物理的标准材质
支持 Cocos Effect
Cocos 设计的基于 YAML 和 GLSL 的 Cocos Effect，是一种单源码嵌入式领域特定语言 (single-source embedded DSL)，YAML 部分声明流程控制清单，GLSL 部分声明实际的 Shader 片段，这两部分内容上相互补充，共同构成了一个完整的渲染流程描述。
支持超过 32 个 Effect 宏定义
Cocos Effect 编译器自动剔除无效代码
支持导入 Effect 头文件
Effect 的资源面板现已支持预览编译后的 Shader 代码，并支持可视化编辑 Shader 的每个 Define
支持材质预览

中间件

支持 TiledMap

支持 Spine、DragonBones
支持 Spine、DragonBones 和 TiledMap 在 3D 场景中渲染（需自定义材质控制深度检测）

骨骼动画系统

Cocos Creator 3.0 内置了通用的动画系统用以展示基于关键帧的动画。在编辑器中我们可以很方便地生产关键帧动画剪辑。我们能也支持导入外部 FBX、glTF 资源中已经包含的骨骼动画，资源管理器中可以对这些动画进行二次剪辑，在动画编辑器中可以预览动画效果，添加动画事件触发器，通过动画系统 API 也可以自如得控制动画播放。

除此之外，我们还支持以下特性：

CPU 或 GPU 驱动的骨骼动画，可自由切换
支持动画的融合过渡（CPU 驱动）
使用二进制格式存储骨骼动画，减少文件大小
支持通用动画与骨骼动画两种组件
支持 Uniform 等材质子属性动画
支持 CPU 驱动的 Morph Target (Blend Shape)

脚本系统

Cocos Creator 3.0 的项目开发全面转向了 TypeScript，项目中也不再支持 JavaScript。我们在 3.0 中进一步完善了对 TypeScript 的支持：

拥抱 ES6 和 TypeScript，完善的代码提示和自动导入
属性支持独立的 type decorator: @integer, @float, @string, @boolean, @type 等
支持 Async Await 语法
可选链（Optional Chaining）支持
空值合并（Nullish Coalescing）支持
某些循环引用行为将在运行检测并作出警告
增加 core-js polyfills 来帮助部分低端平台补全 ES6 支持
支持 loose 编译模式，可以减小包体和优化性能
支持使用 NPM 库
细分引擎模块，允许更细致的模块剔除

UI 系统

Cocos Creator 3.0 延续了 2.x 的 UI 设计，并进一步优化升级，包含以下内容：

灵活简洁的 2D 渲染和 UI 交互、排版组件，支持包括 Sprite, Label, Button, Widget 等 20 种组件，你可以使用这些基础组件组合出各种类型的 UI 效果
支持静态合批
引擎提供了 UIStaticBatch 组件，不需要频繁改动的 UI 可以使用此组件来缓存渲染数据，从而降低渲染消耗，提高性能
支持运行时动态合图，减少 drawcall 数量，优化性能

合并了 UI 渲染流程和前向渲染流程，允许 2D 和 3D 渲染组件混排，完全由节点 Layer 和摄像机 Visibility 决定渲染可见性

物理

Cocos Creator 3.0 目前内建了轻量的碰撞检测系统 Builtin 和具有物理模拟的物理引擎 cannon.js，以及由功能强大的 bullet 编译成为 asm.js/WASM 版本的 ammo.js，并为用户提供了高效的组件化工作流程和便捷的使用方法。引擎组将持续对物理系统进行完善与优化，提供更多功能特性以及提升性能，并将对接更多物理系统后端，我们很快将在后续版本中推出 PhysX 的后端支持（包括原生平台，小游戏平台，Web 平台），将大大增强物理系统的原生性能和能力，未来更将会支持包括布娃娃系统，布料模拟，CCD 检测等等功能特性。

支持多物理后端选择，包括 ammo.js、cannon.js 以及更为轻量的 builtin 物理
支持微信小游戏使用 WASM 物理后端，能在 iOS 上获得更高的性能表现
物理系统支持固定步长刷新
支持物理材质
支持包括单形、圆锥、平面、地形、胶囊体、圆柱体、静态网格碰撞体等多种实用的碰撞体

支持点到点、铰链约束组件
网格碰撞器添加凸包近似功能

支持传统 Creator 2D 物理与碰撞系统

详细改动（相比 Creator 3D）

Editor

[3.0 NEW FEATURE] 新的 FBX 导入器
[3.0 NEW FEATURE] 编译时支持 loose 编译模式
[3.0 NEW FEATURE] 地形支持 normal map 和 pbr 材质
[3.0 NEW FEATURE] 在 GameView 模式下支持 EditBox
[3.0 NEW FEATURE] 支持编译项目脚本时按照预编译宏进行代码剔除
[3.0 NEW FEATURE] 支持构建过程中，剔除 deprecated 的兼容代码，减少包体
[3.0 NEW FEATURE] 全新的 Prefab 系统，支持 Prefab 嵌套
[3.0 NEW FEATURE] 地形系统支持使用自定义画刷以及设置法线贴图
[3.0 NEW FEATURE] 支持资源包导入导出功能
[3.0 NEW FEATURE] 原生平台支持脚本加密
[3.0 NEW FEATURE] 新增华为 AGConnect 构建平台
[3.0 NEW FEATURE] 新增华为快游戏调试工具
[3.0 NEW FEATURE] 支持接入 Cocos Service
[Sync 2.x] 支持模拟器预览
[Sync 2.x] 支持发布连尚小游戏平台
[Sync 2.x] 支持发布趣头条小游戏平台
[Sync 2.x] 支持构建 Android Instant
[Sync 2.x] 支持新版序列化机制
[Sync 2.x] Asset Bundle 支持
[Sync 2.x] 支持预览时引擎模块剔除
[Sync 2.x] 编辑器支持导入 JSON 资源
[Sync 2.x] 编辑器支持导入文本资源
[Sync 2.x] 编辑器支持导入 LabelAtlas 资源
[IMPROVE] 升级 electron，支持 M1 芯片的电脑

Engine

[3.0 NEW FEATURE] 支持使用 NPM 库
[Sync 2.x] 支持 Tiledmap
[Sync 2.x] 支持 Spine
[Sync 2.x] 支持 DragonBone
[Sync 2.x] 支持 MotionStreak
[Sync 2.x] 支持 WebView
[Sync 2.x] 支持 VideoPlayer
[Sync 2.x] 支持 2d 物理与碰撞系统，包括 box2d 与 builtin
[Sync 2.x] 支持 Asset Manager 资源管理
[Sync 2.x] 支持 LabelShadow
[Sync 2.x] 支持 SafeArea
[Sync 2.x] Mask 支持 image stencil
[Sync 2.x] 音频支持多播
[Sync 2.x] 支持动态合图
[IMPROVE] UIMeshRenderer 支持接收平行光照
[IMPROVE] 移除 cc.Class() 式声明
[IMPROVE] 重构 3d 物理碰撞矩阵，碰撞矩阵仅用于初始化刚体的分组和掩码，不再维护更新，废除 Use Collision Matrix 配置项
[IMPROVE] 重构 3d 刚体，移除 RigidBody.isKinematic，增加 RigidBody.type 用于设置刚体类型，移除 fixedRotation, 改为使用 angularFactor 代替
[IMPROVE] UI 支持自定义材质
[IMPROVE] 优化 UI 系统性能，减少 drawcall 数量
[FIX] 修复 Safari 14 的性能问题
[FIX] 修复 Button 组件 Scale 设置异常的问题
[FIX] 修复 submodel 的 lightPassIdx 一致导致渲染出错的问题
[FIX] 修复地形碰撞器在节点缩放后，与渲染效果不匹配的问题
[FIX] 修复调用 view.setFrameSize 接口报错的问题
[FIX] 修复 EditBox 组件在 InputMode 不是 ANY 的情况下，设置 label 对齐方式无效的问题
‍‍‍‍‍‍‍‍‍

Mini Game

[3.0 NEW FEATURE] 支持全新的子域方案
[3.0 NEW FEATURE] 支持微信小游戏使用 wasm 物理后端

Native

[3.0 NEW FEATURE] 支持 Metal 渲染后端
[3.0 NEW FEATURE] 支持 Vulkan 渲染后端
[IMPROVE] 进一步减少 jsb 调用，优化性能

Known Issue

安卓上的 Vulkan 后端目前存在性能问题，我们将在之后版本进行修复
在 m1 芯片的机器上，编译 ios 模拟器会出现报错，需要手动把 arch 变成 arm64，将在后续版本进行修复
Android 暂不支持发布 x86_64 架构
原生平台暂不支持使用 freetype 进行文字渲染
Button 组件暂不支持 enable auto gray effect 选项
目前无法对场景中的 Prefab 实例进行创建组件，删除组件，删除子节点，调整子节点顺序功能，建议在 Prefab 资源中进行这些操作
场景中节点目前无法引用 Prefab 中的节点或组件
当地形不是 n*n 的时候，烘焙会失败
老版本项目升级后，Prefab 数据迁移可能会出现问题，请参考帖子获取最新的修复方案

Breaking changes

引擎源码内置的 effect 统一更改为和编辑器资源不同的命名规则，如果项目场景里完全没有用到某个 effect，现在在脚本里用 effect 名字是获取不到了（比如 builtin-unlit 等）。建议开发者在需要程序创建材质时，统一把 effect asset 作为脚本的 property 暴露出来，在场景里挂载，然后在 material.initialize 时直接传入。
编辑器 HOME 目录从 ~/.CocosEditor3D 切换回了 ~/.CocosCreator，插件目录由 packages 更名为 extensions。3.0 之后的插件，都会存放在 ~/.CocosCreator/extensions 和 PROJECT/extensions 里
原先的子域方案不再适用，请切换到最新的子域方案
不支持 JavaScript，仅支持 TypeScript
不再支持 cc 全局变量，请通过模块导入来使用
2D 节点现在也会严格按照 layer 和 camera 的 visibility 进行能否渲染的判断，在多个摄像机存在的情况下可能会出现重复渲染的情况，需要重新调整节点的 layer
物理事件重构，不再支持静态刚体之间的事件，建议在监听事件的碰撞体对应节点上添加 Kinematic 或 Dynamic 的刚体组件
无法升级到新的 Prefab 系统的 Prefab，会断开关系，还原成一个普通节点

API 更新（相对 Cocos Creator 3D）

物理材质类型名称进行了变更

Creator 3D v1.2	Creator v3.0
PhysicMaterial	PhysicsMaterial

geometry 空间下的部分类型名称和方法名称进行了变更

Creator 3D v1.2	Creator v3.0
line	Line
plane	Plane
ray	Ray
triangle	Triangle
sphere	Sphere
aabb	AABB
obb	OBB
capsule	Capsule
frustum	Frustum
MorphModel	models.MorphModel
ray_aabb	rayAABB
ray_plane	rayPlane
ray_triangle	rayTriangle
ray_sphere	raySphere
ray_obb	rayOBB
ray_capsule	rayCapsule
ray_subMesh	raySubMesh
ray_mesh	rayMesh
ray_model	rayModel
line_plane	linePlane
line_triangle	lineTriangle
line_aabb	lineAABB
line_obb	lineOBB
line_sphere	lineSphere
aabb_aabb	aabbWithAABB
aabb_obb	aabbWithOBB
aabb_plane	aabbPlane
aabb_frustum	aabbFrustum
aabbFrustum_accurate	aabbFrustumAccurate
obb_point	obbPoint
obb_plane	obbPlane
obb_frustum	obbFrustum
obbFrustum_accurate	obbFrustumAccurate
obb_obb	obbWithOBB
obb_capsule	obbCapsule
sphere_plane	spherePlane
sphere_frustum	sphereFrustum
sphereFrustum_accurate	sphereFrustumAccurate
sphere_sphere	sphereWithSphere
sphere_aabb	sphereAABB
sphere_obb	sphereOBB
sphere_capsule	sphereCapsule
capsule_capsule	capsuleWithCapsule

sys 下的某些平台变量进行了变更

Creator 3D v1.2	Creator v3.0
BAIDU_GAME	BAIDU_MINI_GAME
VIVO_GAME	VIVO_MINI_GAME
OPPO_GAME	OPPO_MINI_GAME
HUAWEI_GAME	HUAWEI_QUICK_GAME
XIAOMI_GAME	XIAOMI_QUICK_GAME
JKW_GAME	COCOSPLAY
ALIPAY_GAME	ALIPAY_MINI_GAME
BYTEDANCE_GAME	BYTEDANCE_MINI_GAME

Canvas 组件不再拥有 clearFlag，color，priority，targetTexture，visibility 等属性，请直接通过 Canvas 组件引用的 Camera 组件获取
2d 相关的部分组件进行了更名

Creator 3D v1.2	Creator v3.0
UIRenderable	Renderable2D
UIDrawBatch	DrawBatch2D

升级指南

为了保障现有的 Cocos Creator 2.4 项目平稳过渡，我们会将 2.4 做为 LTS（长期支持）版本，提供后续两年的持续更新！在 2021 年，2.4 将继续更新版本，提供缺陷修复和新的小游戏平台支持，以及 Apple Silicon (M1) 芯片的支持，保障大家的项目成功上线；在 2022 年我们还将为开发者持续提供 2.4 的关键问题修复，保障已上线的游戏平稳运营！因此，

现有的 2.x 项目可以安心继续开发，无需强制升级 3.0。
新项目则建议使用 3.0 版本开发，我们会不断优化 3.0 的开发体验和运行效率，支撑好 2D、3D 等不同品类的重度游戏顺利上线。

而原有的 Cocos Creator 3D 做为 Creator 的分支版本，已经面向中国进行了长达一年的迭代，成功上线了星空大决战、最强魔斗士等重度项目！3.0 发布后，Creator 3D 也将包含在 3.0 中，现有的 1.2 项目都可直接升级，因此 Cocos Creator 3D 后续不会再发布独立版本，还望周知。

虽然我们不建议开发中的项目，特别是即将上线的项目强升 3.0，但是我们仍将在 3.0 正式版推出 2.x 资源导入工具。如果现有项目有特殊原因需要升级，并且遇到了技术上或者工作量上的困难，也可以联系 zhengxiong.zhao@cocos.com 获取我们的人工协助！

参考文档

下载 Dashboard 从 Dashboard 下载版本

展开更多

2021.02.01

V2.4.4

发布时间: 2021.02.01

Cocos Creator 2.4.4 正式版来了，在 3.0 preview 版本发布后，引擎组正在全力攻坚 3.0 版本，希望能够统一 2D 游戏与 3D 游戏开发流程，提供更多更强大的功能特性。除此之外，引擎组将持续对 2.x 版本进行维护与优化，这次推出的 2.4.4 版本，支持了字节跳动小游戏子包功能，优化了运行时与开发过程，修复了 2.4 以来的相关问题，欢迎 2.x 用户进行升级与体验！

What’s New

支持字节跳动小游戏子包功能

字节跳动小游戏正式支持子包功能，这将为开发者提供更多的发挥空间，Creator 也在第一时间开通对子包功能的支持。

Improvement

优化原生 ttf 字体渲染[#2874]
首场景分包与内置资源分包默认合并所有 JSON，提升加载速度
在 MissingScript 组件上显示脚本信息，便于定位出问题的脚本
更新 TypeScript 版本到 4.1.3
原生平台 XMLHttpRequest 支持 HEAD 请求类型[#3093]
优化运行时计算材质 hash 值的消耗，感谢大城小胖，[#7316]
Android 构建支持 gradle 5.x 版本[#3162]

Engine

[ASSET]修复构建后运行，预制体引用计数不准确的问题
[ASSET]修复加载资源时传入 maxRetryCount 参数无效的问题[#7689]
[ASSET]修复预加载图片无效的问题[#7581]
[ASSET]修复子包中的 Prefab 被主包复用时，运行时有可能导致组件脚本丢失的问题[#8001]
[PARTICLE]修复粒子系统颜色变化精度错误的问题，感谢 caogtaa，[#7532]
[PARTICLE]修复粒子组件替换 plist 文件时渲染贴图没刷新的问题，[#6994]
[TILEDMAP]修复 Tiledmap 透明度不正确的问题[#7898]
[TILEDMAP]修复 Tiledmap 未激活节点被渲染的问题[#7898]
[SPRITE]修复自动图集勾选 Allow Rotation 后 Sprite 显示错误的问题[#7501]
[SPRITE]修复 Sprite 使用 Mesh 模式不支持 flipX 与 flipY 的问题[#7407]
[LABEL]修复 Label 组件使用 BMFont 后切换 active 会出现黑块的问题[#7492]
[PHYSICS]修复节点下同时存在刚体节点和非刚体节点时，非刚体节点不会跟随父节点移动的问题[#7455]
[MASK]修复节点加入到节点树之前，增加 Mask 组件报错的问题[#7429]
[GRAPHICS]修复 Graphics 组件在绘制过程出现突刺的问题，[#7780]
[ANIMATION]修复当动画未播放时设置 sample 与 setCurrentTime 无效的问题[#7943]

Native

修复原生平台绘制 Graphics 顶点达到一定数量后无法继续画图的问题[#2884]
修复修改 Label 文本时，节点 size 没有变化的问题[#2834]
修复 Spine 导出图集时选中忽略空白图片导致解析 .skel 二进制文件失败的问题[#2813]
修复原生平台混合参数不生效的问题[#7839]
修复原生平台 rayMesh 始终返回 infinity 的问题[#7795]
修复原生平台 Sprite 使用 Mesh 模式渲染错误的问题[#362]
修复原生平台 3d 节点 Mask 组件渲染异常的问题[#358]

Mini Game

修复编辑器插件里的插件脚本在小游戏平台加载失败的问题
修复微信平台部分机型从后台切回后，Label 消失的问题[#215]
修复微信小游戏游戏过程中接电话后导致游戏卡住的问题 [#219]

Web

修复 Safari 14 上性能下降的问题[#8192]
修复 Web 平台密码类型输入框输入小写字母时却显示大写字母的问题[#7793]

Editor

修复自动同步的预制关联根节点时的报错
修复导入错误的 JSON 文件，编辑器无响应的问题
修复嵌套 prefab 删除子节点后，保存失效的问题
修复层级管理器上搜索 uuid 后，节点无法变化层级的问题
修复命令行构建原生平台，MD5Cache 选项无效的问题
修复预览时，引擎 sourcemap 错误的问题[#7609]
修复编辑动画的曲线会出现无效的问题
修复原生平台 SpriteFrame 的 json 文件无法合并的问题
修复 Prefab 资源设置为 sync 模式时无法保存子节点的问题
修复构建后的文件 hash 值发生改变的问题
修复使用导出功能，材质和 FBX 没有导出依赖纹理的问题
修复构建小米时，webp 文件无法打包的问题

升级提示

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。以下是升级说明，如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

从 < 2.4.0 版本升级

cc.loader 已经不建议使用，请使用最新的 cc.assetManager 来代替，请参考资源管理模块升级指南
子包功能已升级为 Asset Bundle，请参考资源分包升级指南
调整了项目构建后的目录结构，调整了 BuildResults 的 API，如果你使用了编辑器插件获取编辑器构建结果，请参考定制项目构建流程升级指南
从 1.10 开始废弃的 cc.RawAsset 已被正式移除，请使用 cc.Asset 代替。由于 2.4 不再兼容原有 1.x 项目中对 RawAsset 类型的历史遗留用法，建议所有要升级到 2.4 的项目特别是从 1.9 版本一路升级上来的项目，先在任意的 1.10 ~ 2.3 版本中对编辑器编译代码时输出的所有警告或报错都正确处理完毕，再升级到 2.4。
cc.Color.fromHex 已被废弃，请使用 cc.Color.fromHEX 接口

从 < 2.3.3 版本升级

Effect 中的 CCTexture2D，CCTexture2DRGB 方法已被废弃，请改用 CCTexture，CCTextureRGB
Vec3.FRONT 已被废弃，请改用 Vec3.FORWARD

从 < 2.3.0 版本升级

从 2.3.0 开始，定制安卓原生工程时，需注意 Android 与 Android Instant 使用了同一个构建模板

如果是 Android 平台单独使用的代码请放入 app/src 目录, 单独使用的第三方库请放入 app/libs 目录。
如果是 Android Instant 单独使用的代码和第三方库请分别放入 game/src, game/libs 目录。
如果是 Android 和 Android Instant 共用的代码和第三方库，请分别放入 proj.android-studio 根目录底下的 src 目录和 libs 目录。
proj.android-studio 根目录底下 jni/CocosAndroid.mk , jni/ CocosApplication.mk，主要用于配置引擎相关的配置，开发者的配置，建议 Android 放到 app/jni/Android.mk 和 app/jni/Application.mk中，Android Instant 请放入 game/jni/Android.mk 和 game/jni/Application.mk 中。

此外，在 Cocos Creator 编译 Android 时会默认执行 assembleRelease/Debug，编译 Android Instant 时会执行 instant:assembleRelease/Debug。

如自定义了音频前后台切换时的暂停逻辑，升级到 2.3.0 后请移除
目前 Creator 游戏在所有平台上前后台互相切换时，都会在内部自动暂停和恢复音频。如果开发者之前有对这一块进行过定制，监听并执行了 cc.audioEngine.pause()/resume() 之类的音频操作，可能会和引擎默认行为冲突。如果有遇到相关的音频问题，只需移除相应的定制代码即可。

从 2.0 - 2.3.0 版本升级

从 2.3.0 开始，Canvas 组件不再负责将 Canvas 节点尺寸设为屏幕大小，此行为将结合 Widget 组件实现。为保证兼容性，2.0 项目升级后，Canvas 所在节点会自动添加 Widget 组件。（从 1.x 项目升级无此问题）

从 < 2.2.0 版本升级

从 2.2.0 开始，我们强化了内存管理机制，现在要求用户通过代码动态创建且独立于场景节点树的 cc.Node 必须通过 destroy() 释放，否则引擎无法知道何时回收这类节点的内存，会导致内存泄露。

如原先手动从场景中移除的节点，在不需要用到的时候也需要统一 destroy()：

// 假设 testNode 是场景中的某个节点，若之前被手动移出场景了，如testNode.parent = null;

// 或者

testNode.removeFromParent(true);

// 或者

parentNode.removeChild(testNode);

// 若往后 testNode 还会再次用到，则无需手动 destroy 该节点

// 否则应该手动调用testNode.destroy();

如原先通过 cc.removeSelf 这个 action 销毁节点，请改为使用 cc.destroySelf。
如原先通过 cc.NodePool 管理节点，则不受影响。

从 2.2.0 开始，我们不再建议你使用节点的 Skew 功能。Skew 通常用作在 2D 引擎中模拟 3D 效果，随着 Cocos Creator 对 3D 节点的深入支持，Skew 效果已经完全可以由 3D 节点来实现。所以为了统一使用体验，进一步优化引擎底层实现，我们废弃了 Skew 属性。不过我们依旧会保留一段时间内的向下兼容，开发者可在旧项目中延续原有做法。后续我们将进一步完善兼容方式和升级案例，择机正式移除 Skew 功能。

从 < 2.0 版本升级

打开 1.x 项目的话，场景等所有资源将会自动升级，代码中的废弃接口从 2.3.3 开始将会在保持兼容的基础上同步输出报错。升级方式可参考《1.10 资源升级指南》和《2.0 升级文档》进行调整。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2020.10.09

V2.4.3

发布时间: 2020.10.09

Cocos Creator 2.4.3 正式版终于来啦！本次更新带来了很棒的新特性以及性能提升，例如支持 Prefab 的嵌套使用和Android x86_64 的支持等，另外，修复了 2.4 版本以来的问题，提升了编辑器稳定性，希望大家使用起来能够更加得心应手，事半功倍。建议所有开发者升级哦！升级之前请做好相关备份工作！

What’s new

支持 Prefab 嵌套

支持在 Prefab 中嵌套使用其他 Prefab，从而减少重复资源数量，并且更加利于维护与更新。

新增对 Android x86_64 的支持

Android 平台可选择 x86_64 进行构建，构建之后可在更多设备与模拟器上运行。

模拟器增加是否清空缓存的选项

Improvements

优化构建后 JSON 文件大小，配合合并所有 JSON，最多能减少最多 30% JSON 体积
升级物理引擎 Cannon 版本到 1.1.1
原生平台支持下载远程资源失败后使用断点续传[#345]
优化编辑器导入 Plist 资源速度
优化编辑器下执行 cc.resources.load 的性能
支持加载存储空间中的 Asset Bundle [#153]

Engine

[CORE]修复 SpriteFrame 的 clone 方法中共享属性的问题 [#7030]，感谢大城小胖
[CORE]修复 editorOnly 作用于资源属性时，资源无法从构建中剔除的问题[#7048]
[CORE]修复 cc.Quat.rotateX, cc.Quat.rotateY, cc.Quat.rotateZ 计算结果可能不正确的问题[#7036]
[CORE]修复 setPosition 与 setScale 不传入 z 值，z 值重置为 0 的问题[#7104]，感谢大城小胖
[AUDIO]修复 AudioSource 无法获取 duration 的问题[#7035]
[AUDIO]修复 AudioSource 组件勾选 loop 和 mute 无效的问题 [#6935]
[AUDIO]修复切换场景时，音频没有停止播放的问题[#7317]
[PARTICLE]修复粒子系统 InputAssembler 没有清空的问题[#7060]，感谢 caogtaa
[PARTICLE]修复粒子系统组件无法切换图集中其他 SpriteFrame 的问题[#7000]
[LABEL]修复 Label 渲染出现一些突刺的问题[#7132]
[LABEL]修复 LabelOutline、LabelShadow、MotionStreak 组件的 color 属性共享的问题[#7027]
[LABEL]修复在 start 里修改 Label 颜色无效的问题。[#7018]
[LABEL]修复 BITMAP 模式下的文本隐藏时修改 string 属性无效的问题。[#7003]
[PHYSICS]修复刚体一旦进入休眠，使用其他刚体撞击，无法产生碰撞效果的问题[#7119]
[CAMERA]修复在没有摄像机时渲染 EditBox, VideoPlayer, WebView 崩溃的问题，[#332]
[CAMERA]修复 onLoad 函数中，获取不到摄像机正确尺寸的问题，[#7073]
[WIDGET]修复 widget 设置为 ON_WINDOW_RESIZE 时, 当使用 setContentSize 时，没有更新的问题[#7275]
[ASSET]修复多次加载同一 Asset Bundle，加载失败的问题[#7424]
[ASSET]修复连续调用 loadRemote 加载同一张图片，加载失败的问题[#6941]
[ASSET]修复加载资源失败后，progress 回调还在执行的问题[#7121]
[ASSET]修复 Bundle.load 传入数组时，返回值不是数组的问题[#6923]
[ASSET]修复脚本加载顺序可能不正确的问题[#7065]
[ASSET]修复延迟加载时，无法切换 Sprite.spriteFrame 的问题，[#7233]
[ASSET]修复项目脚本中过早调用 cc.resources , 提示不存在的问题

Native

修复 Android 平台 SafeArea 组件宽高不对的问题[#2562]
修复 Android 旋转后没有重新计算 SafeArea 的问题[#337]
修复 iOS 设备屏幕翻转后，重力感应不对的问题[#2791]
修复 iOS 设备方向设置为 upside down，显示错误的问题[#2787]
修复 iOS 平台在 LaunchScreen 画面的时候，立即旋转，可能出现触摸坐标异常的问题[#309]
修复 Android 4.4 以下崩溃的问题[#2532]，感谢 deyongzhong
修复潜在的内存泄漏和空指针问题[#2512]，感谢 quink-black
修复弹出和收回 EditBox 导致屏幕宽度改变的问题[#2630]
修复 iOS 端 EditBox 编辑文字，光标自动跳转到末端的问题[#2669]
修复 iOS 下 EditBox 韩文联想被打断的问题[#2669]
修复下载资源失败后临时文件没有被删除的问题[#2629]
修复 iOS 上缓存资源路径拼接错误的问题[#311]
修复加载远程服务器上的 spine 和 dragonbone 无法显示的问题[#322]
修复 Dragonbone 崩溃的问题[#351]
新增 ENABLE_NATIVE_TTF_RENDERER 宏用于控制是否使用原生渲染器进行 ttf 字体的渲染 [#7053]
修复原生平台无法开启 mipmap 的问题[#2689]
修复原生平台聚光灯渲染错误的问题 [#2695]
修复 async 函数中的异常不会打印的问题 [#328]
修复 iOS VideoPlayer 跳转不准确的问题[#2531]，感谢 goesByhc
修复 VideoPlayer.play 在视频未加载完成时调用，不会播放的问题[#329]
修复调用 CallStaticObjectMethod 出现异常闪退的问题[#2706]
修复原生平台 cc.game.restart 报错的问题[#347]
修复原生平台 ttf 资源放远程服务器上加载失败的问题[#7380]

Editor

修复在编辑器中给对象添加 DontSave 私有标记时 undo 会报错的问题
修复编辑器下 cc.resources.loadDir 返回值与运行时不一致的问题
修复预览时加载 Asset Bundle 中所有资源报错的问题
修复设置 Bundle 为合并所有 JSON 文件后，无法完全合并 JSON 文件的问题
修复罕见的情况下场景或预制中的 RichText 数据如有问题时会导致编辑器崩溃的问题
修复 timeline 面板弹出的时候，加载不到动画的问题
修复在编辑器中修改 SphereCollider3D 的 center 值，gizmo 没有更新的问题。
完善编辑器 UI
修复预览构建后的项目，可能会出现加载失败的问题
修复导出资源时没有导出依赖资源的问题
修复插件中的 auto-atlas 无法构建的问题
修复动画编辑器添加的帧事件参数为 boolean 类型数值为 false 的时候出现无效的问题
修复没有勾选物理模块时，预览报错的问题[#7075]

Mini Game

修复小游戏在软键盘拉起状态下，切换输入框，导致输入状态混乱的问题[#136]
修复 loadRemote 无法加载临时目录中的图片的问题[#155]
修复微信上，XHR 无法设置 timeout 属性的问题[#164]
修复部分小游戏平台，音频播放失败的问题[#7341]

Web

修复火狐浏览器点击视频无法暂停播放的问题[#7372]
修复 iOS14 设备上帧率过低的问题[#7415]

升级提示

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。以下是升级说明，如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

从 < 2.4.0 版本升级

cc.loader 已经不建议使用，请使用最新的 cc.assetManager 来代替，请参考资源管理模块升级指南
子包功能已升级为 Asset Bundle，请参考资源分包升级指南
调整了项目构建后的目录结构，调整了 BuildResults 的 API，如果你使用了编辑器插件获取编辑器构建结果，请参考定制项目构建流程升级指南
从 1.10 开始废弃的 cc.RawAsset 已被正式移除，请使用 cc.Asset 代替。由于 2.4 不再兼容原有 1.x 项目中对RawAsset 类型的历史遗留用法，建议所有要升级到 2.4 的项目特别是从 1.9 版本一路升级上来的项目，先在任意的 1.10 ~ 2.3 版本中对编辑器编译代码时输出的所有警告或报错都正确处理完毕，再升级到 2.4。
cc.Color.fromHex 已被废弃，请使用 cc.Color.fromHEX 接口

从 < 2.3.3 版本升级

Effect 中的 CCTexture2D，CCTexture2DRGB 方法已被废弃，请改用 CCTexture，CCTextureRGB
Vec3.FRONT 已被废弃，请改用 Vec3.FORWARD

从 < 2.3.0 版本升级

从 2.3.0 开始，定制安卓原生工程时，需注意 Android 与 Android Instant 使用了同一个构建模板

如果是 Android 平台单独使用的代码请放入 app/src 目录, 单独使用的第三方库请放入 app/libs 目录。
如果是 Android Instant 单独使用的代码和第三方库请分别放入 game/src, game/libs 目录。
如果是 Android 和 Android Instant 共用的代码和第三方库，请分别放入 proj.android-studio 根目录底下的 src 目录和 libs 目录。
proj.android-studio 根目录底下 jni/CocosAndroid.mk , jni/ CocosApplication.mk，主要用于配置引擎相关的配置，开发者的配置，建议 Android 放到 app/jni/Android.mk 和 app/jni/Application.mk中，Android Instant 请放入 game/jni/Android.mk 和 game/jni/Application.mk 中。

此外，在 Cocos Creator 编译 Android 时会默认执行 assembleRelease/Debug，编译 Android Instant 时会执行instant:assembleRelease/Debug。

如自定义了音频前后台切换时的暂停逻辑，升级到 2.3.0 后请移除

目前 Creator 游戏在所有平台上前后台互相切换时，都会在内部自动暂停和恢复音频。如果开发者之前有对这一块进行过定制，监听并执行了 cc.audioEngine.pause()/resume() 之类的音频操作，可能会和引擎默认行为冲突。如果有遇到相关的音频问题，只需移除相应的定制代码即可。

从 2.0 - 2.3.0 版本升级

从 2.3.0 开始，Canvas 组件不再负责将 Canvas 节点尺寸设为屏幕大小，此行为将结合 Widget 组件实现。为保证兼容性，2.0 项目升级后，Canvas 所在节点会自动添加 Widget 组件。（从 1.x 项目升级无此问题）

从 < 2.2.0 版本升级

从 2.2.0 开始，我们强化了内存管理机制，现在要求用户通过代码动态创建且独立于场景节点树的 cc.Node 必须通过destroy() 释放，否则引擎无法知道何时回收这类节点的内存，会导致内存泄露。

如原先手动从场景中移除的节点，在不需要用到的时候也需要统一 destroy()：

// 假设 testNode 是场景中的某个节点，若之前被手动移出场景了，如

testNode.parent = null;

// 或者

testNode.removeFromParent(true);

// 或者

parentNode.removeChild(testNode);

// 若往后 testNode 还会再次用到，则无需手动 destroy 该节点

// 否则应该手动调用

testNode.destroy();

如原先通过 cc.removeSelf 这个 action 销毁节点，请改为使用 cc.destroySelf。
如原先通过 cc.NodePool 管理节点，则不受影响。

从 2.2.0 开始，我们不再建议你使用节点的 Skew 功能。

Skew 通常用作在 2D 引擎中模拟 3D 效果，随着 Cocos Creator 对 3D 节点的深入支持，Skew 效果已经完全可以由3D 节点来实现。所以为了统一使用体验，进一步优化引擎底层实现，我们废弃了 Skew 属性。不过我们依旧会保留一段时间内的向下兼容，开发者可在旧项目中延续原有做法。后续我们将进一步完善兼容方式和升级案例，择机正式移除 Skew 功能。

从 < 2.0 版本升级

打开 1.x 项目的话，场景等所有资源将会自动升级，代码中的废弃接口从 2.3.3 开始将会在保持兼容的基础上同步输出报错。升级方式可参考《1.10 资源升级指南》和《2.0 升级文档》进行调整。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2020.07.30

V2.4.2

发布时间: 2020.07.30

继上周发布了 v2.4.1 之后，Cocos Creator 又为大家带来了呼声已久的 字节小游戏 平台支持！新的平台总是意味着新的机遇与挑战，将为开发者带来更多的用户及潜力，我们也期待字节小游戏上能爆发出更多优秀的产品！我们建议需要发布字节小游戏的开发者将引擎升级到最新版本，以获得最佳的使用体验。

What’s new

字节小游戏

字节小游戏基于字节跳动全产品矩阵开发，包含 今日头条、抖音及 今日头条极速版，是不需用户进行下载，点开即玩的全新游戏类型，与图文、视频等场景有着天然的搭配性。字节跳动全产品矩阵以内容分发为核心，通过内容带动小游戏分发，由内容为小游戏带量以及裂变。目前已有十分丰富的应用场景，在自然搜索、feed 流、个人主页、小视频、视频评论区等地方均有流量入口，详细说明可参考《了解小游戏：流量入口概述》。在收入方面，字节小游戏目前已支持广告及内购两种变现方式。

采用 Creator 开发的游戏，只需构建时选择 字节跳动小游戏 发布平台，就可以自动完成适配，获得 Cocos Creator 强大便捷的跨平台能力，享受到最熟悉的开发体验。详细内容请参考发布到字节小游戏。

为了更好地服务字节开发者，我们还在论坛开辟了字节小游戏专区，请所有开发者统一到此专区或者 Cocos 小秘书中进行技术咨询和反馈。这样我们才可以汇总、整理常见问题，提升服务体验。此外，Cocos 也会跟字节跳动继续合作，争取为开发者输送更丰富的字节小游戏平台能力。

Known issues

iOS 设备升级到 iOS 14 beta.3 后，Web 平台暂时会出现无法显示画面的问题，可以自定义引擎，并手动合并此改动 #6974 进行修复。

v2.4.1 已同步解锁字节平台

v2.4.2 和 v2.4.1 在产品功能上完全一致，因此我们也直接为现有 v2.4.1 用户们通过热更新的方式解锁了字节小游戏的发布入口。v2.4.1 用户只需要在网络连通的情况下启动 Cocos Dashboard 1.0.8，再打开编辑器即可。如未成功，请确保 Cocos Dashboard 使用的是最新的 1.0.8，并且完整退出再重开，而不仅是缩小到了托盘中。
此外，好消息再次广而告之一下：v2.4.1 已经支持了华为 AppGallery Connect 平台，并且可以一键接入华为 HMS Core，当前包含账号、支付、广告和游戏等服务，近期还将陆续支持推送、分析和定位等 SDK。

接下去，Cocos Creator 将与华为进行全方位的合作，特别是在技术层面上，与 CG Kit 底层算法集成，挖掘 Vulkan 极限渲染能力，释放更大的图形渲染性能，提升渲染效率。在产品层面，也将陆续接入华为 HMS Core、AppGallery Connect 更多优质服务，助力开发者开发出更多高品质的游戏。

版本预告

v2.4.3 目前正在论坛公测，此版本除了包含最近支持的华为 AppGallery Connect、连尚小游戏、字节小游戏平台外，还有一系列重磅升级。如支持 Prefab 嵌套、减小 JSON 包体、优化场景加载表现、支持 Android x86 64 位架构等。欢迎访问 公测交流帖 体验反馈。我们感谢所有的用户反馈，企业服务、Cocos 小秘书服务、论坛讨论及 Beta 交流帖。这些反馈成为了我们梳理开发优先级、制订路线图时的重要依据。

升级提示

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。以下是升级说明，如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

从 < 2.4.0 版本升级

cc.loader 已经不建议使用，请使用最新的 cc.assetManager 来代替，请参考资源管理模块升级指南。
子包功能已升级为 Asset Bundle，请参考资源分包升级指南。
调整了项目构建后的目录结构，调整了 BuildResults 的 API，如果你使用了编辑器插件获取编辑器构建结果，请参考定制项目构建流程升级指南。
从 1.10 开始废弃的 cc.RawAsset 已被正式移除，请使用 cc.Asset 代替。由于 2.4 不再兼容原有 1.x 项目中对 RawAsset 类型的历史遗留用法，建议所有要升级到 2.4 的项目特别是从 1.9 版本一路升级上来的项目，先在任意的 1.10 ~ 2.3 版本中对编辑器编译代码时输出的所有警告或报错都正确处理完毕，再升级到 2.4。
cc.Color.fromHex 已被废弃，请使用 cc.Color.fromHEX 接口。

从 < 2.3.3 版本升级

Effect 中的 CCTexture2D，CCTexture2DRGB 方法已被废弃，请改用 CCTexture，CCTextureRGB
Vec3.FRONT 已被废弃，请改用 Vec3.FORWARD

从 < 2.3.0 版本升级

从 2.3.0 开始，定制安卓原生工程时，需注意 Android 与 Android Instant 使用了同一个构建模板

如果是 Android 平台单独使用的代码请放入 app/src 目录, 单独使用的第三方库请放入 app/libs 目录。
如果是 Android Instant 单独使用的代码和第三方库请分别放入 game/src, game/libs 目录。
如果是 Android 和 Android Instant 共用的代码和第三方库，请分别放入 proj.android-studio 根目录底下的 src 目录和 libs 目录。
proj.android-studio 根目录底下 jni/CocosAndroid.mk , jni/ CocosApplication.mk，主要用于配置引擎相关的配置，开发者的配置，建议 Android 放到 app/jni/Android.mk 和 app/jni/Application.mk中，Android Instant 请放入 game/jni/Android.mk 和 game/jni/Application.mk 中。

此外，在 Cocos Creator 编译 Android 时会默认执行 assembleRelease/Debug，编译 Android Instant 时会执行 instant:assembleRelease/Debug。
如自定义了音频前后台切换时的暂停逻辑，升级到 2.3.0 后请移除目前 Creator 游戏在所有平台上前后台互相切换时，都会在内部自动暂停和恢复音频。如果开发者之前有对这一块进行过定制，监听并执行了 cc.audioEngine.pause()/resume() 之类的音频操作，可能会和引擎默认行为冲突。如果有遇到相关的音频问题，只需移除相应的定制代码即可。

从 2.0 - 2.3.0 版本升级

从 2.3.0 开始，Canvas 组件不再负责将 Canvas 节点尺寸设为屏幕大小，此行为将结合 Widget 组件实现。为保证兼容性，2.0 项目升级后，Canvas 所在节点会自动添加 Widget 组件。（从 1.x 项目升级无此问题）

从 < 2.2.0 版本升级

从 2.2.0 开始，我们强化了内存管理机制，现在要求用户通过代码动态创建且独立于场景节点树的 cc.Node 必须通过 destroy() 释放，否则引擎无法知道何时回收这类节点的内存，会导致内存泄露。

如原先手动从场景中移除的节点，在不需要用到的时候也需要统一 destroy()：

// 假设 testNode 是场景中的某个节点，若之前被手动移出场景了，如testNode.parent = null;// 或者testNode.removeFromParent(true);// 或者parentNode.removeChild(testNode);// 若往后 testNode 还会再次用到，则无需手动 destroy 该节点// 否则应该手动调用testNode.destroy();

如原先通过 cc.removeSelf 这个 action 销毁节点，请改为使用 cc.destroySelf。
如原先通过 cc.NodePool 管理节点，则不受影响。

从 2.2.0 开始，我们不再建议你使用节点的 Skew 功能。Skew 通常用作在 2D 引擎中模拟 3D 效果，随着 Cocos Creator 对 3D 节点的深入支持，Skew 效果已经完全可以由 3D 节点来实现。所以为了统一使用体验，进一步优化引擎底层实现，我们废弃了 Skew 属性。不过我们依旧会保留一段时间内的向下兼容，开发者可在旧项目中延续原有做法。后续我们将进一步完善兼容方式和升级案例，择机正式移除 Skew 功能。

从 < 2.0 版本升级

打开 1.x 项目的话，场景等所有资源将会自动升级，代码中的废弃接口从 2.3.3 开始将会在保持兼容的基础上同步输出报错。升级方式可参考《1.10 资源升级指南》和《2.0 升级文档》进行调整。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2020.07.23

V2.4.1

发布时间: 2020.07.23

新的平台总是意味着新的机遇与挑战，Creator 2.4.1 版本现已全新支持 HUAWEI AppGallery Connect，将为开发者带来更多的用户及潜力，相信新的平台能爆发出更多优秀的游戏。

同时，Cocos Creator 在移动端游戏上与 HMS Core 进行深度合作，特别是在技术层面上，与 CG Kit 底层算法集成，挖掘 Vulkan 极限渲染能力，释放更大的图形渲染性能，提升渲染效率。

接下去，Cocos 将与华为进行全方位的合作，持续接入华为 HMS Core、AppGallery Connect 更多优质服务，助力开发者开发出更多高品质的游戏。

此版本让你的游戏可以一键接入华为 HMS Core，一键上传至 HUAWEI AppGallery Connect 快速发布到华为应用市场，省去开发过程中接入 SDK、上传平台等繁复操作，助力开发者打造高品质创新应用，提升游戏体验！

What’s new

新增 HUAWEI AppGallery Connect 平台

良好的服务是游戏不可或缺的部分，在游戏开发中，开发者常常会需要通过接入 SDK 来使用一些第三方的服务。但接入过程通常是繁杂且易出错的部分，需要耗费大量不必要的时间。

在 Creator 中，开发者基于 Cocos 的 IDE 进行游戏发布时，当选择发布到 HUAWEI AppGallery Connect，可以一键接入华为 HMS Core，当前包含账号、支付、广告和游戏等服务，近期还将支持推送、分析和定位等，可极大提升开发者的工作效率。

开发者可在服务面板中启用 SDKHub 并配置好对应的 SDK 预设。

在构建时选择 HUAWEI AppGallery Connect 平台，并选择已配置好的 SDK 预设即可。

在构建完成后，可通过上传窗口一键上传。

新增连尚小游戏发布平台

连尚小游戏是 WiFi 万能钥匙旗下的小游戏应用平台，具有便捷、轻量、免安装的特点。采用 Creator 开发的游戏，只需构建时选择连尚小游戏发布平台，就可以自动完成适配，获得 Cocos Creator 强大便捷的跨平台能力。

更多关于发布连尚小游戏的内容，请参考发布到连尚小游戏。

Bug fixes

[Engine]修复运行时插件脚本执行顺序错误的问题 #6983
[Engine]修复场景启用延迟加载可能出现加载失败的问题 #6983
[Native]修复原生平台富文本组件文字排版错误的问题 #6975
[Editor]修复进入 Prefab 编辑器模式时，场景视图自动切换为 2D 视图的问题
[Editor]修复小米小游戏，OPPO 小游戏，vivo 小游戏平台将主包配置为小游戏分包后，构建失败的问题

Known issues

iOS 设备升级到 iOS 14 beta.2 后，Web 平台暂时会出现无法显示画面的问题，可以自定义引擎，并手动合并此改动 #6974 进行修复。我们将继续跟进 iOS 14 后续版本，避免造成兼容性问题。

升级提示

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。以下是升级说明，如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。

从 < 2.4.0 版本升级

cc.loader 已经不建议使用，请使用最新的 cc.assetManager 来代替，请参考资源管理模块升级指南。
子包功能已升级为 Asset Bundle，请参考资源分包升级指南。
调整了项目构建后的目录结构，调整了 BuildResults 的 API，如果你使用了编辑器插件获取编辑器构建结果，请参考定制项目构建流程升级指南。
从 1.10 开始废弃的 cc.RawAsset 已被正式移除，请使用 cc.Asset 代替。由于 2.4 不再兼容原有 1.x 项目中对RawAsset 类型的历史遗留用法，建议所有要升级到 2.4 的项目特别是从 1.9 版本一路升级上来的项目，先在任意的 1.10 ~ 2.3 版本中对编辑器编译代码时输出的所有警告或报错都正确处理完毕，再升级到 2.4 。
cc.Color.fromHex 已被废弃，请使用 cc.Color.fromHEX 接口。

从 < 2.3.3 版本升级

Effect 中的 CCTexture2D，CCTexture2DRGB 方法已被废弃，请改用 CCTexture，CCTextureRGB
Vec3.FRONT 已被废弃，请改用 Vec3.FORWARD

从 < 2.3.0 版本升级

从 2.3.0 开始，定制安卓原生工程时，需注意 Android 与 Android Instant 使用了同一个构建模板。

如果是 Android 平台单独使用的代码请放入 app/src 目录, 单独使用的第三方库请放入 app/libs 目录。
如果是 Android Instant 单独使用的代码和第三方库请分别放入 game/src, game/libs 目录。
如果是 Android 和 Android Instant 共用的代码和第三方库，请分别放入 proj.android-studio 根目录底下的 src 目录和 libs 目录。
proj.android-studio 根目录底下 jni/CocosAndroid.mk , jni/ CocosApplication.mk，主要用于配置引擎相关的配置，开发者的配置，建议 Android 放到 app/jni/Android.mk 和 app/jni/Application.mk中，Android Instant 请放入 game/jni/Android.mk 和 game/jni/Application.mk 中。

此外，在 Cocos Creator 编译 Android 时会默认执行 assembleRelease/Debug，编译 Android Instant 时会执行instant:assembleRelease/Debug。

如自定义了音频前后台切换时的暂停逻辑，升级到 2.3.0 后请移除。

目前 Creator 游戏在所有平台上前后台互相切换时，都会在内部自动暂停和恢复音频。如果开发者之前有对这一块进行过定制，监听并执行了 cc.audioEngine.pause()/resume() 之类的音频操作，可能会和引擎默认行为冲突。如果有遇到相关的音频问题，只需移除相应的定制代码即可。

从 2.0 - 2.3.0 版本升级

从 2.3.0 开始，Canvas 组件不再负责将 Canvas 节点尺寸设为屏幕大小，此行为将结合 Widget 组件实现。为保证兼容性，2.0 项目升级后，Canvas 所在节点会自动添加 Widget 组件。（从 1.x 项目升级无此问题）

从 < 2.2.0 版本升级

从 2.2.0 开始，我们强化了内存管理机制，现在要求用户通过代码动态创建且独立于场景节点树的 cc.Node 必须通过destroy() 释放，否则引擎无法知道何时回收这类节点的内存，会导致内存泄露。

如原先手动从场景中移除的节点，在不需要用到的时候也需要统一 destroy()：

// 假设 testNode 是场景中的某个节点，若之前被手动移出场景了，如

testNode.parent = null;

// 或者

testNode.removeFromParent(true);

// 或者

parentNode.removeChild(testNode);

// 若往后 testNode 还会再次用到，则无需手动 destroy 该节点

// 否则应该手动调用

testNode.destroy();

如原先通过 cc.removeSelf 这个 action 销毁节点，请改为使用 cc.destroySelf。
如原先通过 cc.NodePool 管理节点，则不受影响。

从 2.2.0 开始，我们不再建议你使用节点的 Skew 功能。

Skew 通常用作在 2D 引擎中模拟 3D 效果，随着 Cocos Creator 对 3D 节点的深入支持，Skew 效果已经完全可以由3D 节点来实现。所以为了统一使用体验，进一步优化引擎底层实现，我们废弃了 Skew 属性。不过我们依旧会保留一段时间内的向下兼容，开发者可在旧项目中延续原有做法。后续我们将进一步完善兼容方式和升级案例，择机正式移除 Skew 功能。

从 < 2.0 版本升级

打开 1.x 项目的话，场景等所有资源将会自动升级，代码中的废弃接口从 2.3.3 开始将会在保持兼容的基础上同步输出报错。升级方式可参考《1.10 资源升级指南》和《2.0 升级文档》进行调整。

下载 Dashboard 从 Dashboard 下载版本

展开更多

2020.06.24

V2.4.0

发布时间: 2020.06.24

工欲善其事，必先利其器！在长达两个月的测试后，2.4.0 版本终于来了！在此感谢给予我们宝贵意见和建议的各位小伙伴们！这个版本中包含了许多新的功能与更新，如资源管理系统重构，Asset Bundle。并优化了原生上 Label 渲染的性能，优化 Graphic 渲染效果等等。相信全新的 2.4 版本将会让大家的工作效率更加高效，游戏内容更加丰富，游戏体验进一步提升，建议所有开发者升级哦！

What's new

支持 Asset Bundle 功能

Asset Bundle 可将工程中的资源按照开发者的意愿进行模块划分，将不同场景不同需求的资源划分在多个包中，从而可以减少首次下载和加载游戏时所需要的时间，也可以跨项目复用，用于加载子项目中的 Asset Bundle。

Asset Bundle 还提供了优先级，压缩类型等相关设置用于对 Asset Bundle 的包体和加载进行优化。

详细请参考 Asset Bundle 和加载 Asset Bundle。

新增 cc.AssetManager 模块用于资源管理

Asset Manager 是 Creator 在 v2.4 新推出的资源管理器，其具备加载资源，查找资源，销毁资源，缓存资源，Asset Bundle 等功能。Asset Manager 拥有更好的性能，更易用的 API，更强的扩展性。其主要提供了以下几点新特性：

支持所有资源的加载与预加载，预加载能以更轻量的方式静默运行，不影响运行效率
支持 Asset Bundle
支持更安全的自动释放机制，释放资源时无需考虑其引用情况，避免错误释放资源
支持下载失败重试，下载优先级，下载并发数等设置，可根据各种情况进行调整
支持更方便地定制加载流程，实现特殊效果

详细请参考 Asset Manager 和动态加载。

增加 Label 的混合选项

支持设置 Lable 的混合选项，可在不同的使用场景下使用不同的设置以最大化文本渲染性能。详细请参考系统文本的混合模式说明。

原生平台上使用 FreeType 渲染 Label

原生平台上使用 FreeType 渲染 Label 的 CHAR 模式

提升大段文本的 Label 初始化速度，Android 提升 5 倍左右，iOS 提升 3 倍
在使用 TTF 字体和 Char 模式时支持 Bold，Outline，Shadow 等效果

支持 Graphic 的抗锯齿效果

使用 SDF 技术优化 Graphic 的锯齿问题

支持其他小游戏平台的压缩纹理

编辑器进一步支持更多小游戏平台的压缩纹理限制，只需在 Mini Game 项添加压缩纹理格式，即可设置包括微信小游戏，OPPO 小游戏，vivo 小游戏等多个平台的压缩纹理格式。

完善原生热更新支持 #2312

2.4 进一步完善原生热更新能力，优化了以下内容：

添加获取更新包大小接口
对链接添加 MD5 参数，对 CDN 更加友好
解决更新过程中断导致的资源丢失和错乱的问题

详细请参考热更新范例教程。

新增 SafeArea UI 组件

该组件会将所在节点的布局适配到异形屏手机的安全区域内，可适配 Android 和 iOS 设备，详细可查看 SafeArea 组件参考。

其它新增特性

增加压缩纹理缓存功能，构建之后将压缩纹理进行缓存，重复构建时将尽量复用缓存内容，加快构建速度
在 Web 平台使用 ImageBitmap 加载图片，提升预览和 Web 平台图片解析速度，减少加载时的卡顿
编辑器属性面板支持拖拽数组赋值
升级 TypeScript 的版本到 3.9.2
升级原生平台的 V8 版本到 8.0.426.16
支持导入 GLTF 资源
在所有小游戏平台支持首场景分包功能
支持预览时进行模块剔除，提升预览速度，还能更早暴露错误的模块剔除设置

Improvements

优化 2D 粒子系统 free 和 relative 模式的性能 #6236
优化 ToggleContainer 获取 toggleItems 的效率 #6569
提升原生平台 WebSocket 带宽 #2353
SpriteFrame 资源增加 None Trim 类型，可快速设置为无裁剪
完善 jsb 的代码提示
支持设置预览端口
原生桌面平台构建时可设置窗口大小

Engine

[CORE]修复 cc.easeBackOut 在 time 为 0 时返回值不正确的问题，#6728，感谢 chen-gaoyuan
[CORE]修复 Node.walk 遍历错误的问题 #6710
[CORE]修复调用 cc.dynamicAtlasManager.showDebug 报错的问题 #6697
[CORE]修复 onLoad 中设置节点的 size 无效的问题 #6688
[CORE]修复按钮禁用状态下的材质将背景材质重置回默认材质的问题 #6562
[CORE]修复 BMFont 配置数据不存在时的报错 #6472
[CORE]修复开启预乘后，透明度无效的问题 #6451
[CORE]修复 Camera.render() 渲染两次的问题，#6355，感谢大城小胖
[CORE]修复调用 Texture2D.setPremultiplyAlpha 之后图片翻转的问题 #6602
[PARTICLE]修复 2d 粒子系统 relative 模式，节点旋转时，粒子跟随的问题 #6236
[3D]修复 3D Label 在 char 模式下不显示的问题#6882
[3D]修复勾选 Enable Auto Batch 选项并切换 Mesh 资源导致渲染错误的问题 #6901
[3D]修复渲染单个 Camera 阴影错位的问题 #6477
[3D]修复 effect 中 cc_matProj 错误的问题 #6653
[EDITBOX]修复 number 模式下，EditBox.maxLength 属性不生效的问题 #6725
[EDITBOX]修复 EditBox 在 ScrollView 里滚动时，无法更新位置的问题 #6634
[TILEDMAP]修复 Tiled Map 渲染顺序可能错误的问题 #6284
[TILEDMAP]修复 Tiled Map 隐藏的图像还是会渲染的问题 #6309
[SPINE]修复 Spine 纹理使用压缩纹理后渲染错误的问题 #6483
[SPINE]修复 Spine 贴图可能渲染错误的问题 #6584
[SPINE]修复贴图设置为预乘后，DragonBone 与 Spine 渲染错误的问题 #6696，感谢大城小胖
[DRAGONBONE]修复 DragonBone 在销毁场景时一直报错的问题 #6553

Native

修复屏幕翻转后，节点缩放不正确的问题 #6689
修复安卓原生 JniHelper 不是线程安全的问题 #2457
修复 unzip 不是线程安全的问题 #2131，感谢 benloong
修复安卓 EditBox 的完成按钮被虚拟导航栏遮挡的问题 #2426
修复 Spine 节点在 iOS 上无法获取节点大小的问题 #273
修复原生 Effect 中 cc_time 错误的问题 #6586
修复 iOS 音频播放可能崩溃的问题 #2358
修复节点旋转计算错误的问题 #2361
修复设置 Label.string 时编码错误导致崩溃的问题 #2395
修复游戏退出时出现报错 #2406
修复屏幕旋转后，输入框会将视图上推的问题 #2415
修复 Spine 3.6.53 版本导出的 JSON 文件里的路径动画解析失败的问题 #2413，感谢 laomoi
修复 Android 上重力感应错误的问题 #2231
修复 Tiled Map 当节点挪动到没有地块信息的位置时，不会被渲染的问题 #2283
修复原生 WebSocket 接口与 Web 不一致的问题 #2297
修复调用 Camera 的 render 方法，会导致 Spine 加速播放的问题 #258
修复安卓平台，剔除 AudioSource 模块导致 audioEngine 无法使用的问题
修复 Android 9, Android 10 版本号检测失败的问题 #6466

Web

修复 iOS Web-Mobile 摘下耳机后音频无法播放的问题 #6730
修复 WebView 透明度在 iOS 上错误的问题 #6717
修复 iOS 浏览器上，输入中文后，无法再输入英文的问题 #6631

Mini Game

修复微信小游戏 WebSocket 发送 Uint8Array 数据报错的问题 #115
修复音频意外中断时无法自动恢复播放的问题 #118
修复 PC 微信数据开放域无法运行的问题

Editor

修复 Sprite Editor 保存和还原状态不对的问题
修复在动画编辑状态下，无法重命名不在编辑的动画剪辑的问题
修复增加 Spine 资源后，编辑器无法识别出来的问题
修复用户插件重启后，编辑器可能无法打开的问题
修复多次调用 getNativeAssetPaths 返回值错误的问题
修复脚本重命名后加载脚本失败的问题
修复点击图集会出现 width 和 height 报错的问题
修复使用自动图集图片可能失真的问题
修复导入某些图片导致资源面板错误的问题
修复 Prefab 编辑模式无法通过 delete 键删除节点的问题
修复勾选 Filter Unused Resources 在图集没有被导出时无效的问题
修复 effect 中定义宏的取值范围无效的问题 #6616
修复动画编辑器设置 CircleCollider.offset 属性异常的问题 #6600
修复还原上次保存无效的问题
修复设置预览浏览器无效的问题
修复导入 Cocos Studio 工程没有字体资源的话，会出现报错的问题
修复多开可能造成编辑器错误的问题

Known Issues

使用远程 Asset Bundle 并勾选 延迟加载 时，音频可能无法播放，请使用 cc.assetManager.postLoadNative 加载后播放。

升级提示

Cocos Creator 对项目的升级操作是不可逆的，请在升级前提交或备份旧版项目。绝大多数项目通常都能自动升级，但因为项目难免存在特殊性，开发者应该根据项目自身需求，提前对新版本引擎进行试用和评估。此外，出于稳定性考虑，建议即将上线或已上线的项目谨慎升级。以下是升级说明，如果开发者们在升级中遇到困难，欢迎向我们反馈，我们会尽力协助。