更新时间:2023-06-08 16:41:21收藏订阅更新我的文档设置返回文档简介在项目根目录 mini.project.json 中配置项目编译、打包策略。推荐使用新版 项目配置。配置项字段名类型说明miniprogramrootstring小程序源码目录,相对路径。该路径下应该有 app.json 文件。pluginrootstring插件源码目录,相对路径。compiletypestring编译类型。 可选值:● mini(小程序)● plugin(插件)默认值:miniaxmlstrictcheckbooleanaxml 严格语法,构建时能检查出标签未闭合等错误,ide 详情面板有对应配置项。 默认值:falsecomponent2boolean是否启用 component2 编译,详情可查看 生命周期,ide 详情面板有对应配置项。 默认值:falsenonloadingindicatorboolean初始化小程序时,是否隐藏默认 loading 动画。 默认值:trueenableparallelloaderboolean启用多进程编译,首次无缓存时效果较明显,ide 详情面板有对应配置项。 默认值:falseenabledistfileminifyboolean真机预览/真机调试阶段,是否压缩最终产物,ide 详情面板有对应配置项。 默认值:falsescriptsobject自定义预处理脚本。详情可查看 预处理脚本。 默认值:nullincludearray打包时需要包含的文件/文件夹,遵循 glob 语法,详情可查看 include 打包白名单。excludearray打包时要忽略的文件/文件夹,遵循 glob 语法,详情可查看 exinclude 打包白名单。enablenodemodulebabeltransformbooleanappx 2.0 特性,对 node_modules 中的模块做 babel 编译。 默认值:falseenableappxngboolean启用 appx2.0 编译,升级详情可查看 基础库 2.x 升级。 默认值:falsedebugoptionsobjectwip: 调试/联调的额外配置,生产构建时不生效。详情可查看 debugoptions。 默认值:null预处理脚本通过预构建,用户可以在 编译前/预览前/上传前 执行自定义命令。此功能可以用来处理 ts/less 编译、其它框架转小程序等场景。预处理脚本写在 mini.project.json 的 scripts 字段下。配置示例触发时机●ide 模拟器编译时:○watch 脚本优先级高 于 beforecompile,两者只会执行其一。○watch 模式下,预构建脚本与 ide 构建 server 同时运行。○beforecompile 模式下,ide 构建 server 会等待脚本执行完才启动。●真机预览/真机调试前将执行 beforepreview 钩子。●ide 上传前将执行 beforeupload 钩子。include 打包白名单小程序的构建产物包默认只会包含必要的业务产物代码和资源文件,未识别的资源类型不会出现在包内,以减小包体积。 默认打包的资源文件如下:●图片○.png○.jpg○.jpeg○.gif○.svg○.webp●字体○.eot○.woff○.ttf○.woff2○.otf●多媒体○.mp3○.mp4如小程序需要引入自定义的资源文件,可配置 include 白名单, 以下配置将会把所有 .aaa 以及 .bbb 后缀的文件也打进产物包内。exclude 打包黑名单小程序上传时,会将本地源码打包传到云端进行构建,除了上方资源文件列表外,源码包还会包含以下内容:●小程序源码文件○.acss○.axml○.js○.json○.sjs●依赖包○node_modules 目录如果源码包经过 zip 压缩后,包大小仍然超过 ide 的阈值(当前为 20m),上传时会报 包大小超限 的错误。可以根据需要,对云端构建不需要的文件配置 exclude 黑名单,如代码经过了 src > dist 的预编译以及 miniprogramroot 目录之外的 devdependencies 依赖。以下配置表示源码包内将不会包含项目根目录下 src 和 node_modules 目录中的文件。debugoptions调试/联调的额外配置,生产构建时不生效。●enable:boolean 是否启用此项配置。●plugins:object 插件联调配置,指定某些插件走线下版本(四位版本号),方便联调。●dynamicplugins:object 动态插件联调配置(格式同 plugins)。配置样例