定制项目构建流程

自定义发布模版

Cocos Creator 3D 支持对每个项目分别定制发布模板,只需要在项目路径下添加一个 build-templates 目录,里面按照平台路径划分子目录,然后里面的所有文件在构建结束后都会自动按照对应的目录结构复制到构建出的工程里。目前除了原生平台外,其他所有平台都支持该功能,具体的平台名称可以参照下面的表格。

结构类似:

  1. project-folder
  2. |--assets
  3. |--build
  4. |--build-templates
  5. |--web-mobile
  6. |--index.html

这样如果当前构建的平台是 web-mobile 的话,那么 build-templates/web-mobile/index.html 就会在构建后被拷贝到对应构建任务文件夹下。

除此之外,还有另外两种构建模板的支持

1. ejs 类型

由于构建出来包的内容是不能保证每个版本完全一样,按照之前的使用方式,每次构建内模板修改都会需要更新自己的构建模板,因而现在加入新的模板使用方式。可以点击菜单里的 项目 -> 创建构建模板选择对应平台后将会生成对应平台支持的模板文件。 例如:

  1. project-folder
  2. |--assets
  3. |--build
  4. |--build-templates
  5. |--web-mobile
  6. |--index.ejs

构建会对这些模板做参数注入,构建经常改动的东西都会放在该模板引用的子模板内,使用时只需要修改添加需要的内容即可,这样之后模板更新自己的模板可以不用频繁跟进。

注意 的是,拷贝用户模板是发生在渲染对应支持模板之后的,也就是假如该目录下同时存在 index.ejs 与 index.html, 最终打包出来的是 index.html 的文件而不是 index.ejs 渲染出来的文件。

2. json 类型的融合处理

许多小游戏平台都会有类似 game.json 之类的配置文件,当这些 json 文件在构建模板的对应目录下时,构建不会直接拷贝覆盖,而是会对其做数据融合,具体的规则就是在原本构建出来的对应 json 文件盖上构建模板内的 json 文件数据内容。具体支持的

自定义构建模板平台支持表

具体各个小游戏平台有做对应数据融合的 json 文件列表如下:

平台微信web mobileweb desktop小米华为即刻玩百度OPPOvivo支付宝原生
平台实际名称wechatgameweb-mobileweb-desktopxiaomi-quick-gamehuawei-mini-gamecocos-playbaidu-mini-gameoppo-mini-gamevivo-mini-gamealipay-mini-gamenative
自定义构建模板game.ejs, game.json, project.config.jsonindex.ejsindex.ejsmanifest.json使用面板上的game.config.jsongame.json, project.swan.jsonmanifest.jsonproject.config.jsongame.jsonX

自定义构建插件

构建插件我们目前还在内测阶段,接口尚未稳定,暂时不对外开放。