跳到主要内容

5.2 项目升级指南

白鹭引擎 5.2 版本增加了对微信小游戏和 QQ 玩一玩的支持,项目结构有些变化,无法使用egret upgrade命令自动升级,需要用户手动升级。

1.使用白鹭引擎 5.2 版本创建一个新项目

项目结构里增加了一个 scripts 目录,这是引擎 5.2 里新增的插件系统,可以扩展引擎的编译发布功能,还有微信小游戏的发布配置等功能。

2.把老项目的代码和资源拷贝到新项目里, 比如 srcresource 目录
  • 如果老项目里使用了EUI库,请不要替换新项目里的src/ThemeAdapter.ts文件。
3.在新项目的 egretProperties.json 里配置配置第三方库,方法和 5.0 一致
  • 5.0 项目里默认的资源管理模块为 res ,5.2 项目里默认使用新版的 assetsmanager,该模块可以支持微信小游戏的发布,APIres兼容,基本不用修改代码。如果您的项目没有发布到微信小游戏的需求,也可以继续使用老的 res 模块。
4.修改 tsconfig.json

![](./5.2 项目升级指南_files/p1.png) tsconfig.jsontypescript 编译器的配置文件,用来指定这个项目的编译选项。 如上图所示,白鹭引擎 5.0 系列和 5.2 系列的 tsconfig.json 配置有所不同。

  • 5.0 系列为 exclude ,指定哪个目录不参与编译。
  • 5.2 系列为 include, 指定哪个目录参与编译。

更多详情,参见 tsconfig 的微软官方文档

在 5.2 的项目里,如果引用了第三方库,除了在 egretProperties.json 里配置,还要在 tsconfig.json 里进行配置。

![](./5.2 项目升级指南_files/p2.png) 上图为我们一个游戏项目的配置示例,该项目使用了 egret-psegret-ps-wechat-tiny 两个库。