多平台导出

导出到微信小游戏

平台配置说明

在导出到微信小游戏平台的时候,有以下这些配置项:

配置描述对应到微信小游戏的配置文件对应到微信小游戏中的字段
AppId微信小游戏的 AppId,必填,截图中的 wxdf8199565c509fb9 为测试账号project.config.jsonappid
Orientation设置游戏屏幕方向: Landscape(横屏)、Portrait(竖屏)game.jsondeviceOrientation
Requestwx.request 的超时时间,单位:毫秒game.jsonnetworkTimeout.request
Connect Socketwx.connectSocket 的超时时间,单位:毫秒game.jsonnetworkTimeout.connectSocket
Upload Filewx.uploadFile 的超时时间,单位:毫秒game.jsonnetworkTimeout.uploadFile
Download Filewx.downloadFile 的超时时间,单位:毫秒game.jsonnetworkTimeout.downloadFile
Subpackages子包列表的配置game.jsonsubpackages

更多配置详见:project.config.jsongame.json

导出

选择好微信小游戏平台后,点击导出面板最下方的下载按钮,即可导出所需工程:

调试

1、从编辑器导出到本地后,目录结构如下:

工程目录说明

目录或文件说明
public资产目录,编辑器所有资产导出到这个目录下,资产的 path 为 /public/xxx
scripts开发者在编辑器中添加的脚本组件,导出到本地后,开发者可以在里面的脚本组件中进行二次开发
game.json对应微信小游戏工程所需要的 game.json
game.ts入口文件,初始化的逻辑都放在这里
package.json主要存放项目依赖包
project.config.json对应微信小游戏工程所需要的 project.config.json
project.tsGalacean 的工程文件,放置初始化相关信息

2、工程导出到本地后,先进入到根目录执行以下命令进行依赖包的安装:

npm i

3、本地构建微信小游戏平台所需产物,调试阶段可以执行如下命令:

npm run dev

执行完这个命令后,会在项目的根目录下生成一个新的目录,这个目录就是微信小游戏所需要的产物,如下:

执行 dev 命令,产物里会有源码的 source map 文件,方便调试,当开发者完成调试准备发包时,可以执行命令:

npm run release

执行这个命令后,相对 dev 产生的产物会去掉 source map 文件,并对代码进行压缩,体积更小,适合发布,如下:

4、打开微信开发者工具 ,选择小游戏,并导入步骤 3 中生成的目录,如下:

5、完成步骤 4 后,即可在微信开发者工具中预览最终的结果,如下:

6、在微信开发者工具中的调试,详见:微信小游戏调试

分包

概述

随着小游戏玩法日益丰富,内容增多,包体积变大,影响加载速度。微信小游戏提供分包功能,将游戏内容按规则拆分为主包和子包。主包包含首次启动必要的资源,子包则按需加载,使用户能快速进入游戏。

Galacean 编辑器分包配置

在 Galacean 编辑器中,文件夹是子包划分的单位。不在子包的内容会进主包。导出小游戏时,在导出面板的子包列表添加子包并关联文件夹即可分包。

子包配置步骤

1、打开导出面板,选择微信小游戏平台,点击子包列表的添加子包按钮,添加子包:

2、在子包中,选择需要分包的文件夹即可完成子包的配置:

注意事项

  • 设置为子包的文件夹下的脚本资源不会计入子包,会单独导出到主包中
  • 微信小游戏中,主包的大小限制为 4M,单个子包不限制大小,但是整个小游戏的主包+分包大小不超过 30M,更详细的规则见:分包
  • 分包的配置、加载等引擎均帮开发者自动处理好了,开发者动态加载子包下的资产和普通资产是一样的,都是通过 engine.resourceManager.load 来加载

发布

本地完成调试后,即可进行发布,具体发布流程详见:微信小游戏发布

这篇文档对您有帮助吗?