实战 Creator 2.x 项目升级 3.x!避坑要点与基础 API 写法差异总结

本文分享了从 Cocos Creator 2.2.2 项目升级到 3.6.2 的详细步骤和注意事项,包括升级引擎、脚本转换、组件代码调整等。升级过程中需注意模块引入方式、Node属性变化、Tween动画的使用等关键点。文章提供了解决按钮点击问题、坐标转换、资源加载等常见问题的方法,帮助开发者顺利完成项目迁移。
摘要由CSDN通过智能技术生成

最近,我将自己在 Cocos Store 上的一个 2D 项目《球球要回家》从 Creator 2.2.2 升级到 Creator 3.6.2,编程语言也从 JavaScript 全面升级至 TypeScript 并适配微信小游戏,目前在微信审核中!

本篇文章就来跟大家分享一下,我在升级过程中踩到的一些坑,以及 2.x 与 3.x 中引擎最基本的一些接口的变化。

不论你是升级老项目,还是想尝试在 Creator 3.x 上新开项目,相信本文都能对你有所帮助!

一、2.x项目升级流程

1. 升级引擎到 2.4.x

如果你是 2.4.x 以下的老项目,建议先将项目升级到 2.4.x 最新引擎版本。

如果有出现警告什么的,可以暂时不管他,引擎会提示你那些方法、属性废弃了,用什么接口去替换。只需要将真正被废弃的接口改掉,保证项目正常运行就好。

根据我这一两年参与CocosStore资源上架审核测试工作来看 95% 的项目,可以不用任何改动升级到 2.4.x。

2. 脚本升级

Creator 3.x 仅支持使用 TypeScript 做为组件脚本。

因此,如果你之前是用 Javacript 编写的组件脚本,还需要将它们翻译为 TypeScript。这一步是个体力活动,一是翻译脚本,二是将脚本重新挂载节点。

我的做法是,比如:看到有个脚本为:GameScene.js,先在它旁边生成一个 GameSceneTS.ts 照着 js 代码逻辑,按 ts 语法重写一遍代码。

582a5898d50a61d1d6efaa173c0380bf.png

虽然这是个体力活,但是在 VSCode 中写 ts 代码还是很享受的,智能提示非常的方便。

如果发现代码提示,并没像我说的那么友好!那请注意,你可以通过引擎主菜单开发者VSCode 工作流更新或导入creator.d.ts提示文件,如图:

d103600801dfd4f54df66c6069c7bc55.png

ts 脚本翻译完后,就要开始在编辑器上进行替换了。

但是,如何找到之前使用的 js 脚本,在那些地方使用过呢?看下图:

1a46afdd3bcd620ee084124827a1ffa5.png

在资源管理器中,鼠标右键选中脚本文件,在菜单中点击找查使用可以找到资源使用过的场景预制体

不过问题又来了,场景那么多节点,组件脚本在那里呢?这个怎么找?

3390ff6c9f8b12b8774585decbba9f1e.png

在这里分享一个小技巧,在层级管理器的搜索栏中输入:t:组件名字 就出来了!f40c3b7186b6fe8137a9857ccb8373f5.png

然后你就可以,将新的 ts 脚本挂到节点上,并照之前 js 组件属性值,配置 ts 组件参数了。

1a22f45052ada332641d1848f3c0104f.png
  • 2
    点赞
  • 10
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值