微信小程序 分包

350 阅读1分钟

小程序的代码包可以被划分为 一个“主包”,和多个“分包”。需要访问的页面及其依赖的资源文件应放在主包中。小程序启动时,只需要先将主包下载完成,就可以立刻启动小程序。所有主包和分包的大小总和不得超过20M,各个包的大小不能超过2M。

1、配置方法

在app.json subpackages 字段声明项目分包结构: image.png subpackages配置说明:

字段类型说明
rootString分包根目录
nameString分包别名,分包预下载时可以使用
pagesStringArray分包页面路径,相对与分包根目录
independentBoolean分包是否是独立分包

2、分包预下载

预下载分包行为在进入某个页面时触发,通过在 app.json 增加 preloadRule 配置来控制。 image.png

preloadRule 中,key 是页面路径,value 是进入此页面的预下载配置,每个配置有以下几项:

字段类型默认值说明
packagesStringArray进入页面后预下载分包的 root 或 name。APP 表示主包。
networkStringwifi在指定网络下预下载,可选值为:all: 不限网络 wifi: 仅wifi下预下载

分包预下载与未预下载的区别:

image.png