Custom Project Build Template
Cocos Creator supports custom build templates for each project. Add a
build-templates/[platform] folder to the project path, and divide the sub-folder according to the platform name. Then all the files in this folder will be automatically copied to the build generated project according to the corresponding folder structure after the build. Currently, all platforms except the native platform support this function, the specific platform name can be referred to as the following custom build template supported platform list.
project-folder |--assets |--build |--build-templates |--web-mobile // The file to be added, such as index.html |--index.html
If the current platform is
build-templates/web-mobile/index.html will be copied to
In addition, the file types currently supported by the build template include ejs type and json type. These two types will not copied directly but rather parsed. Please refer to the Special Custom Build Template Platform support list below for details on the support for these two template types by platform.
Since the content of the package is not guaranteed to be exactly the same in every version, when the build template within the editor is updated, the developer also needs to update the build template within their project. For example, if the MD5 Cache option is checked at build time, taking
index.html on the web platform as an example, the
css file referenced in it will have an MD5 Hash suffix, which may not match the one in the original template and may not work.
To optimize this problem, a new way is added to use the template. Click on Project -> Create Preview Template in the main menu, and an
ejs template file will be generated for the corresponding platform.
Developers only need to customize the generated build template in the
.ejs, the build will automatically synchronize the updates of the editor build template to the custom build template, and the frequently changed content will be synchronized to the sub-template (
.ejs) referenced by the template, so that the custom build template can be updated manually without frequent updates.
Taking the creation of a Web Mobile build template as an example, the generated build template directory structure is as follows:
Note: the copy template occurs after the rendered template. For example, if both
index.htmlexist in this directory, the final packaged package will be the
index.htmlfile instead of the
Many mini games have their own configuration
JSON files, like
game.json to WeChat Mini Games. Files in the build templates folder will just copy in default, but this configuration JSON will be merged instead of overwrite. Of course, it doesn't mean that all
JSON file will be merged, you can check it in the tables below.
Special Custom Build Template supported Platform list
Most files placed in the
build-templates/[platform] directory will be copied directly to the corresponding directory. In addition, many platforms support some template files with special name formats. The supported file with special name formats for build templates by the platform are as follows:
|Platform||Actual Name||Supported File Type|
|Huawei AGC||huawei-agc||not supported yet|
|Alipay Mini Game||alipay-mini-game||
|ByteDance Mini Game||bytedance-mini-game||
|OPPO Mini Game||oppo-mini-game||
|Huawei Quick Game||huawei-quick-game||not supported yet|
|vivo Mini Game||vivo-mini-game||
|Xiaomi Quick Game||xiaomi-quick-game||
|Baidu Mini Game||baidu-mini-game||
|WeChat Mini Game||wechatgame||
|Native||native||not supported yet|