一、基础概念
1.1 定义
分包指把一个完整的小程序项目,按照需求划分为不同的子包,在构建时打包成不同的分包,用户在使用时按需求进行加载;
1.2 好处
1、优化小程序首次启动的下载事件
2、多团队共同开发时,可以更好的解耦协作
1.3 分包前后项目构成
1.3.1 分包前
分包前,小程序项目中所有的页面和资源都被打包到了一起,导致整个项目体积过大,影响小程序首次启动的下载时间
1.3.2 分包后
由一个主包+多个分包组成:
主包:一般只包含项目的启动页面或TabBar页面、以及所有分包都需要用到的一些公共资源
分包:只包含和当前分包有关的页面和资源
1.4 分包加载规则
1、小程序启动时,默认下载主包并启动主包内页面
tabBar页面需要放到主包中
2、当用户进入分包内某个页面时,客户端会把对应分包下载下来,下载完成后再进行展示
非tabBar页面可以按照功能不同,划分为不同的分包之后,进行按需下载
1.5 分包的体积限制
1、整个小程序所有分包大小不超过16M(主包+所有分包)
2、单个分包/主包不能超过2M
二、基本用法
2.1 分包结构
"pages":[
"pages/home/home",
"pages/message/message",
"pages/contact/contact"
],
// 与pages同一级别
"subPackages": [
{
// 分包的根目录
"root": "pkgA",
// 别名
"name": "p1",
"pages": [
"page/cat/cat",
"page/dog/dog"
]
},
{
"root": "pkgB",
// 别名
"name": "p1",
"pages": [
"page/apple/apple"
]
}
],
2.2 分包打包原则
1、小程序会按subpackages的配置进行分包,subpackages之外的目录将被打包到主包中
2、主包也可以有自己的pages(即最外层的pages字段)
3、tabBar页面必须在主包内
4、分包之间不能相互嵌套
2.3 引用原则
1、主包无法引用分包的私有资源
2、分包之间不能相互引用私有资源
3、分包可以引用主包内的公共资源
三、 独立分包
3.1 基本概念
独立分包本职上也是分包,只不过比较特殊,可以独立于主包和其他分包而单独运行
3.2 独立分包与普通分包的区别
是否依赖于主包才能运行:
- 普通分包必须依赖于主包才能运行
- 独立分包可以在不下载主包的情况下,独立运行
3.3 应用场景
将具有一定功能独立性的页面配置到独立分包中
原因:
- 当小程序从普通的分包页面启动时,需要首先下载主包
- 而独立分包不依赖主包即可运行,可以很大程度上提升分包页面的启动速度
注意:
一个小程序中可以有多个独立分包
"pages":[
"pages/home/home",
"pages/message/message",
"pages/contact/contact"
],
"subPackages": [
{
"root": "pkgA",
"name": "p1",
"pages": [
"page/cat/cat",
"page/dog/dog"
]
},
{
"root": "pkgB",
"name": "p2",
"pages": [
"page/apple/apple"
],
// 独立分包
"independent": true
}
],
3.4 引用原则
独立分包和普通分包以及主包之间,是相互隔绝的,不能相互引用彼此的资源
- 主包无法引用独立分包内的私有资源
- 独立分包之间,不能相互引用私有资源
- 独立分包和普通分包之间,不能相互引用私有资源
- 特别注意:独立分包中不能引用主包内的公共资源
四、分包预下载
4.1 分包预下载
4.1.1 定义:
在进入小程序的某个页面时,由框架自动预下载可能需要的分包,从而提升进入后续分包页面时的启动速度
4.1.2 配置:
预下载分包的行为,会在进入指定的页面时触发;在app.json中,使用preloadRule节点定义分包的预下载规则
// 分包预下载规则
"preloadRule": {
// 进入当前页面,开始预下载
"pages/contact/contact": {
// 预下载的分包名称
"packages": [
"p1"
],
// 网络模式有两种:all、WiFi
"network": "all"
}
},
4.1.3 限制
用一个分包中的页面享有共同的预下载大小限额2M