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 材質切換導致無法渲染

修復 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

［升級指南］