小程序的代码包可以被划分为
一个“主包”,和多个“分包”。需要访问的页面及其依赖的资源文件应放在主包中。小程序启动时,只需要先将主包下载完成,就可以立刻启动小程序。所有主包和分包的大小总和不得超过20M,各个包的大小不能超过2M。
1、配置方法
在app.json subpackages 字段声明项目分包结构:
subpackages配置说明:
| 字段 | 类型 | 说明 |
|---|---|---|
| root | String | 分包根目录 |
| name | String | 分包别名,分包预下载时可以使用 |
| pages | StringArray | 分包页面路径,相对与分包根目录 |
| independent | Boolean | 分包是否是独立分包 |
2、分包预下载
预下载分包行为在进入某个页面时触发,通过在 app.json 增加 preloadRule 配置来控制。
preloadRule 中,key 是页面路径,value 是进入此页面的预下载配置,每个配置有以下几项:
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| packages | StringArray | 无 | 进入页面后预下载分包的 root 或 name。APP 表示主包。 |
| network | String | wifi | 在指定网络下预下载,可选值为:all: 不限网络 wifi: 仅wifi下预下载 |