自定义构建模版
Cocos Creator 支持对每个项目分别定制构建模板,只需要在项目路径下添加一个 build-templates
目录,里面按照 平台扩展名称 划分子目录。在构建结束后,build-templates/[platform]
目录下所有的文件都会自动按照对应的目录结构 复制 到对应平台构建生成的工程中,这个功能是全平台支持的。具体的 平台扩展名称 请参考最下方的 特殊自定义构建模板平台支持表。
结构类似:
project-folder
|--assets
|--build
|--build-templates
|--web-mobile
// 需要添加的文件,如 index.html
|--index.html
这样如果当前构建的平台是 Web Mobile 的话,那么 build-templates/web-mobile/index.html
就会在构建后被拷贝到 build/web-mobile(以平台扩展名称为准)/index.html
。
除此之外,目前构建模板支持的文件类型还包括 ejs 类型 和 json 类型,这两个类型不会直接拷贝而是会过解析处理,或者数据融合。各平台对这两种模板类型的支持情况,详情请参考下文的 特殊自定义构建模板平台支持表。
ejs 类型
随着 Cocos Creator 版本的升级,可能会对构建模板做一些修改和更新,就会导致不同版本构建出来的包内容不完全一样,开发者需要手动同步更新项目中定制的构建模板。例如构建时勾选了 MD5 Cache 选项之后,以 Web 平台的 index.html
为例,里面引用的 css
文件地址会带有 MD5 Hash 后缀,可能会和原先模板里的不匹配而导致无法使用。
因此为了优化这个问题,Creator 在主菜单的 项目 中新增了 创建项目构建模板 选项,用于生成对应平台支持的构建模板。
开发者只需要在生成的构建模板的 .ejs
中进行定制,构建时会自动将编辑器构建模板的更新同步到定制的构建模板中,经常改动的内容都会同步到该模板引用的子模板(.ejs
)中,这样定制构建模板便可以不用频繁手动更新。
以创建 Web Mobile 构建模板为例,生成的构建模板目录结构如下:
注意:构建时,拷贝定制构建模板这一步骤是最后执行的,也就是说,假如该目录下同时存在
index.ejs
与index.html
,那么最终打包出来的是index.html
文件而不是index.ejs
文件。
json 类型的融合处理
许多小游戏平台都会有类似 game.json
之类的配置文件,若这些 json 文件在对应平台的定制构建模板中,构建时便不会直接将其拷贝并覆盖到对应的发布包目录下,而是会将编辑器最新构建模板的内容整合进来。
特殊自定义构建模板平台支持表
大部分文件放置在 build-templates/[platform]
目录下都会被直接拷贝到对应目录下,除此之外,各个平台还支持一些特殊名称格式的模板文件,部分文件各平台对构建模板的文件类型支持情况如下表所示:
平台 | 平台构建扩展名 | 支持的特殊文件类型 |
---|---|---|
华为 AGC | huawei-agc | 暂不支持 |
支付宝小游戏 | alipay-mini-game | game.json |
淘宝小游戏 | taobao-mini-game | game.json 、mini.project.json |
抖音小游戏 | bytedance-mini-game | game.ejs 、game.json 、project.config.json |
OPPO 小游戏 | oppo-mini-game | manifest.json |
华为快游戏 | huawei-quick-game | 暂不支持 |
Cocos Play | cocos-play | game.config.json |
vivo 小游戏 | vivo-mini-game | project.config.json |
小米快游戏 | xiaomi-quick-game | manifest.json |
百度小游戏 | baidu-mini-game | game.json 、project.swan.json |
微信小游戏 | wechatgame | game.ejs 、game.json 、project.config.json |
Web Desktop | web-desktop | index.ejs |
Web Mobile | web-mobile | index.ejs |
原生平台 | native | 暂不支持 |