From b4cce3f65dbb3ca234b2ccf3905e33d6844a7bcd Mon Sep 17 00:00:00 2001 From: SmallMain Date: Mon, 30 Oct 2023 22:15:13 +0800 Subject: [PATCH] =?UTF-8?q?=E4=B8=BA=20v2.4.12=20=E4=B8=8E=E4=B8=80?= =?UTF-8?q?=E4=BA=9B=E5=B8=B8=E8=A7=81=E9=97=AE=E9=A2=98=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 19 +++++++++++++++++++ docs/docs/intro.md | 16 ++++++++++++++++ docs/docs/update-log.md | 2 +- docs/versioned_docs/version-1.2.0/intro.md | 16 ++++++++++++++++ .../version-1.2.0/update-log.md | 2 +- 5 files changed, 53 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 1ab7eaad..fdeaa396 100644 --- a/README.md +++ b/README.md @@ -37,6 +37,9 @@ - [常见问题](#常见问题) - [为什么要直接修改引擎？](#为什么要直接修改引擎) - [启动 Cocos Creator 报 Error: Can not parse this input:undefined 错误](#启动-cocos-creator-报-error-can-not-parse-this-inputundefined-错误) + - [原生平台或模拟器报错：Assertion failed: (_type == Type::String), function toString, file Value.cpp, line 496.](#原生平台或模拟器报错assertion-failed-_type--typestring-function-tostring-file-valuecpp-line-496) + - [使用模拟器预览时出现各种问题](#使用模拟器预览时出现各种问题) + - [Spine 组件出现 Uncaught TypeError: Cannot read property ‘load’ of null, location: src/cocos2d-jsb.b5158.js 等问题](#spine-组件出现-uncaught-typeerror-cannot-read-property-load-of-null-location-srccocos2d-jsbb5158js-等问题) @@ -136,3 +139,19 @@ 这是你没有替换引擎的 `jsb-adapter` 部分，或者说没有重启以生效。 注意：原生平台构建时可能需要先删除原有的 build 文件，替换操作才会生效。 + +### 使用模拟器预览时出现各种问题 + +可能是因为模拟器没有重新编译导致的，请按照官方的 [引擎定制文档](https://docs.cocos.com/creator/2.4/manual/zh/advanced-topics/engine-customization.html#25-%E7%BC%96%E8%AF%91%E6%A8%A1%E6%8B%9F%E5%99%A8) 重新编译模拟器即可。 + +### Spine 组件出现 Uncaught TypeError: Cannot read property ‘load’ of null, location: src/cocos2d-jsb.b5158.js 等问题 + +这是引擎自身的问题，由于释放 Spine 资源，然后再次加载相同 Spine 资源时导致，具体请看： + +[问题讨论](https://forum.cocos.org/t/topic/137649/148) + +截止 v2.4.12，引擎仍未修复此问题，暂时的解决方案有三种： + +1. 引擎已经有一个修复此问题的 PR，但还未合入，可自行合入：[PR #4307](https://github.com/cocos/engine-native/pull/4307) +2. 需要进行释放的 spine 资源，不让其参与动态合图（通过控制 Spine 组件的合图开关）。 +3. 不释放需要参与动态合图的 spine 资源。 diff --git a/docs/docs/intro.md b/docs/docs/intro.md index 05ee94c8..2d3c89fe 100644 --- a/docs/docs/intro.md +++ b/docs/docs/intro.md @@ -124,3 +124,19 @@ hide_title: true 这是你没有替换引擎的 `jsb-adapter` 部分，或者说没有重启以生效。 注意：原生平台构建时可能需要先删除原有的 build 文件，替换操作才会生效。 + +### 使用模拟器预览时出现各种问题 + +可能是因为模拟器没有重新编译导致的，请按照官方的 [引擎定制文档](https://docs.cocos.com/creator/2.4/manual/zh/advanced-topics/engine-customization.html#25-%E7%BC%96%E8%AF%91%E6%A8%A1%E6%8B%9F%E5%99%A8) 重新编译模拟器即可。 + +### Spine 组件出现 Uncaught TypeError: Cannot read property ‘load’ of null, location: src/cocos2d-jsb.b5158.js 等问题 + +这是引擎自身的问题，由于释放 Spine 资源，然后再次加载相同 Spine 资源时导致，具体请看： + +[问题讨论](https://forum.cocos.org/t/topic/137649/148) + +截止 v2.4.12，引擎仍未修复此问题，暂时的解决方案有三种： + +1. 引擎已经有一个修复此问题的 PR，但还未合入，可自行合入：[PR #4307](https://github.com/cocos/engine-native/pull/4307) +2. 需要进行释放的 spine 资源，不让其参与动态合图（通过控制 Spine 组件的合图开关）。 +3. 不释放需要参与动态合图的 spine 资源。 diff --git a/docs/docs/update-log.md b/docs/docs/update-log.md index 11c830b0..0b997875 100644 --- a/docs/docs/update-log.md +++ b/docs/docs/update-log.md @@ -7,7 +7,7 @@ sidebar_position: 7 --- ## Enhance Kit v1.2.0 -适配 Cocos Creator v2.4.10、v2.4.9 版本，[点此下载压缩包](https://github.com/smallmain/cocos-enhance-kit/releases/tag/v1.2.0) +适配 Cocos Creator v2.4.12、v2.4.10、v2.4.9 版本，[点此下载压缩包](https://github.com/smallmain/cocos-enhance-kit/releases/tag/v1.2.0) - **[新特性] cc.TiledLayer 支持复用 Culling 数据** - [修复] 修复 MotionStreak 初始化报错的问题 diff --git a/docs/versioned_docs/version-1.2.0/intro.md b/docs/versioned_docs/version-1.2.0/intro.md index 05ee94c8..2d3c89fe 100644 --- a/docs/versioned_docs/version-1.2.0/intro.md +++ b/docs/versioned_docs/version-1.2.0/intro.md @@ -124,3 +124,19 @@ hide_title: true 这是你没有替换引擎的 `jsb-adapter` 部分，或者说没有重启以生效。 注意：原生平台构建时可能需要先删除原有的 build 文件，替换操作才会生效。 + +### 使用模拟器预览时出现各种问题 + +可能是因为模拟器没有重新编译导致的，请按照官方的 [引擎定制文档](https://docs.cocos.com/creator/2.4/manual/zh/advanced-topics/engine-customization.html#25-%E7%BC%96%E8%AF%91%E6%A8%A1%E6%8B%9F%E5%99%A8) 重新编译模拟器即可。 + +### Spine 组件出现 Uncaught TypeError: Cannot read property ‘load’ of null, location: src/cocos2d-jsb.b5158.js 等问题 + +这是引擎自身的问题，由于释放 Spine 资源，然后再次加载相同 Spine 资源时导致，具体请看： + +[问题讨论](https://forum.cocos.org/t/topic/137649/148) + +截止 v2.4.12，引擎仍未修复此问题，暂时的解决方案有三种： + +1. 引擎已经有一个修复此问题的 PR，但还未合入，可自行合入：[PR #4307](https://github.com/cocos/engine-native/pull/4307) +2. 需要进行释放的 spine 资源，不让其参与动态合图（通过控制 Spine 组件的合图开关）。 +3. 不释放需要参与动态合图的 spine 资源。 diff --git a/docs/versioned_docs/version-1.2.0/update-log.md b/docs/versioned_docs/version-1.2.0/update-log.md index 11c830b0..0b997875 100644 --- a/docs/versioned_docs/version-1.2.0/update-log.md +++ b/docs/versioned_docs/version-1.2.0/update-log.md @@ -7,7 +7,7 @@ sidebar_position: 7 --- ## Enhance Kit v1.2.0 -适配 Cocos Creator v2.4.10、v2.4.9 版本，[点此下载压缩包](https://github.com/smallmain/cocos-enhance-kit/releases/tag/v1.2.0) +适配 Cocos Creator v2.4.12、v2.4.10、v2.4.9 版本，[点此下载压缩包](https://github.com/smallmain/cocos-enhance-kit/releases/tag/v1.2.0) - **[新特性] cc.TiledLayer 支持复用 Culling 数据** - [修复] 修复 MotionStreak 初始化报错的问题