项目构建

构建配置

项目目录/engine.ide.json 文件可以对项目构建进行额外的配置实例。

{
  "resourceDirs": {
    // 定义打包范围可精确到某个资源,或者直接配置目录。
    "buildIn": [
      "assets/Assets/Resources/a/exampleb.prefab",
      "assets/Assets/Resources/b/examplea.prefab"
    ],
    // 定义打包范围可直接配置目录,目录下所有资源都会纳入打包范围。
    "idePack": [
      "assets/Assets/Resources"
    ]
  },
  "engineVersion": "0.5.6",
  "envBootScript": "scripts/envBoot.ts",
  "build": {
    "mainScene": {
      "3d":"assets/Assets/Resources/example3D.scene",
      "2d": "assets/Assets/Resources/example2D.scene"
    },
    "textureCompressionEncodeQuality": {
      "pvr": "pvrtcnormal",
      "etc": "etcfastperceptual",
      "astc": "astcmedium",
    },
  },
  "importPackages": {
    "files": []
  }
}

注解:

resourceDirs:背景,项目在最终构建的时候,并不会把所有资源都打包到minigame/assets目录中。除了UI面板选择的主场景及其依赖以外,要想通过loader.load(path),这样的方式加载其他资源,需要通过配置resouDirs来告知工具,还有哪些资源需要纳入打包范围中。

resourceDirs.buildIn:该项声明的资源路径/文件夹路径下的资源,会打包到assets/buildin目录下,意味着是代码包内置资源。UI面板选择的主场景,也会放置在assets/buildin中。

resourceDirs.idePack: 该项声明的资源路径/文件夹路径下的资源,会打包到assets/idepack目录下,意味着是要上传到CDN上的资源。

envBootScript:启动脚本路径,该脚本会在最开始被加载引入。

build.mainScene:通过命令行构建时,声明主2D,3D场景。

build.textureCompressionEncodeQuality:压缩纹理配置,可不填,走默认值。可选的有:['pvrtcfastest'|'pvrtcfast'|'pvrtcnormal'|'pvrtchigh'|'pvrtcbest'|'etcfast'|'etcslow'|'etcfastperceptual'|'etcslowperceptual'|'astcveryfast'|'astcfast'|'astcmedium'|'astcthorough'|'astcexhaustive]。 注意:更换了配置需要删除 项目目录/minigame/__temp/__buildTemp 目录,否则会因为缓存而失效。(后续优化)。

importPackages:命令行构建时,先进行解包操作,默认为空,可不填。

关于脚本:

构建时,会把assets/目录下的所有脚本,编译成js之后,保持相对位置不变,拷贝到 minigame/assets/文件夹中,使用小程序分包时,请业务自行保持代码加载。

关于上传预览

上传版本:

若构建结果可直接上传,可忽略下面步骤:

1.把IDEPACK下的文件夹内容上传到CDN。

2.project.config.json文件设置packOptions。

"packOptions": {
  "ignore": [
    {
      "type": "folder",
      "value": "assets/IDEPack/"
    }
  ]
},

其他配置可以看微信小程序官网。

3.minigame/engine.config.json baseURL项,默认值为 file:///,使用本地文件;可配置CDN前缀,使用网络资源。