项目从LayaAir3.3升级到3.4需要注意什么？

gamedev_wq

LayaAir(机器人)

建议先复制一份工程，用 3.4.1 打开，不要直接覆盖唯一工程。

打开后执行“开发者 → 更新引擎 d.ts 文件”，项目里已有的 engine/types 不会随 IDE 切换自动更新。若 engine/libs 放过自定义或旧版引擎库，也要同步升级或移走，否则会优先加载旧库，造成 3.3/3.4 混用。

最后重新全量编译、发布，重点回归自定义 Shader/材质、Spine、物理、资源加载和目标平台，不要复用 3.3 的发布目录。

以上由 AI（codex）自动回复，仅供参考。若无异议将不再人工审查；如需人工介入请回帖说明。

gamedev_wq

@LayaAir(机器人) 还有吗？尽量详细一些，比如资源、编辑器脚本等等还有什么需要注意的位置？

LayaAir(机器人)

再补一份按风险排序的升级清单：

资源必须连同 .meta 一起保留；场景、预制体和材质通过 res://UUID 引用资源，删除 .meta 会生成新 UUID，导致引用丢失。
library 只是导入缓存。首次打开先等待资源导入完成；若出现导入异常，可关闭 IDE、删除 library 后重新打开，但不要删除 .meta。
关键场景和预制体逐个打开，检查丢失脚本、Missing Resource、材质引用及序列化变化；确认无误再批量保存，并通过 Git 查看改动。
3.4 增加了专用 Spine 导入流程，重点检查 atlas、贴图、2D/3D 材质映射和 PMA；外部图集、自动图集也重新发布核对。
更新 d.ts 后做一次无缓存全量编译。3.4 不再导出标记为内部的声明；若代码依赖下划线成员或内部模块，需要改成公开 API。使用 3D 嵌入 2D 时，scale3DToPixel 已改为 pixelsPerUnit。
编辑器脚本和插件不要沿用 3.3 的编译产物；用 3.4 的编辑器 API 类型重新编译，重点检查自定义菜单、面板、资源导入器和构建钩子。
若项目有 build-templates/<平台>，必须基于 3.4 模板重新合并自定义修改；该目录会覆盖 IDE 内置模板，直接保留旧模板可能把新版平台适配代码覆盖掉。
最后用全新发布目录验证启动场景、资源加载、Shader、动画、物理及每个目标平台；确认控制台无报错、网络面板无 404 后再替换线上构建。

以上由 AI（codex）自动回复，仅供参考。若无异议将不再人工审查；如需人工介入请回帖说明。

gamedev_wq

记录一下升级引擎：
编辑器脚本：
Handles不再直接提供cube、sphere等Mesh，需要通过getMesh()获取，而且不再提供arrowZMesh（-=-为啥要抛弃？可以用directionMoveHandle替代）等内置网格。
Handles.drawMesh参数修改，需要提供subMeshIndex。
Handles.drawMesh如果绘制的是plane那么color的alpha就会只有0和1，半透明无效（不知是不是Bug）。
居然提供Handles.drawText了，给力！

谷主

gamedev_wq 的确Handles升级较多，但也补全了很多功能。你说那个plane的半透明问题，能否提供一个例子说明。

gamedev_wq

谷主

demo-341.zip

3MB

谷主

gamedev_wq
看到了，我修一下