开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
开发 > 框架 > 小程序全局配置 > 项目配置(旧版)
收藏
订阅更新
我的文档
设置
简介
在项目根目录 mini.project.json 中配置项目编译、打包策略。推荐使用新版 项目配置
配置项
字段名
类型
说明
miniprogramroot
string
小程序源码目录,相对路径。该路径下应该有 app.json 文件。
pluginroot
string
插件源码目录,相对路径。
compiletype
string
编译类型。 可选值:
mini(小程序)
plugin(插件)
默认值:mini
axmlstrictcheck
boolean
axml 严格语法,构建时能检查出标签未闭合等错误,ide 详情面板有对应配置项。 默认值:false
component2
boolean
是否启用 component2 编译,详情可查看 生命周期
,ide 详情面板有对应配置项。 默认值:false
nonloadingindicator
boolean
初始化小程序时,是否隐藏默认 loading 动画。 默认值:true
enableparallelloader
boolean
启用多进程编译,首次无缓存时效果较明显,ide 详情面板有对应配置项。 默认值:false
enabledistfileminify
boolean
真机预览/真机调试阶段,是否压缩最终产物,ide 详情面板有对应配置项。 默认值:false
scripts
object
自定义预处理脚本。详情可查看 预处理脚本
默认值:null
include
array
打包时需要包含的文件/文件夹,遵循 glob 语法,详情可查看 include 打包白名单。
exclude
array
打包时要忽略的文件/文件夹,遵循 glob 语法,详情可查看 exinclude 打包白名单。
enablenodemodulebabeltransform
boolean
appx 2.0 特性,对 node_modules 中的模块做 babel 编译。 默认值:false
enableappxng
boolean
启用 appx2.0 编译,升级详情可查看 基础库 2.x 升级
默认值:false
debugoptions
object
wip: 调试/联调的额外配置,生产构建时不生效。详情可查看 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)。
配置样例
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图