主包和分包概念
一、分包
1.什么是分包
分包是指把一个完成的小程序,安装需求划分为不同的子包,在构建时打包分成不同的分包,用户在使用时按需进行加载。
2.分包的好处
优化小程序的下载时间,默认情况下,所有的页面是打包到一起的,用户需要下载整个小程序文件,才能启动,所以启动时间较长,分包可以先下载首页。
不同的人可以进行不同的功能开发,更好的解耦工作。
3.分包后项目的构成
小程序由一个主包或分包构成。
主包:一般只包含项目的启动页面或TbbBar页面,以及所有分包都需要用到的一些公共资源,相当于下载了一个小程序,只有一个首页,和一些公共的代码。
分包:只包含和当前分包有关的页面和私有资源,每个单独页面使用的资源
4.分包加载规则
小程序启动时,默认会下载主包并启动主包内页面,
tabBar页面许需要放到主包中
2.当用户进入分包的某个页面时,客户端会把对应分包下载下来,下载完成后再进行展示
非tabBar页面可以安装功能的不同,划分为不同的包后,按需下载。
5.分包的体积限制
1.整个小程序所有分包大小不超过16m,主包+分包
2.当分包/主包大小不能超过2m
6.使用分包
pages文件夹放主包所有页面
在同级创建一个pageA来放第一个分包,可以创建多个分包。
7.配置分包
//这里放主包所有页面
"pages": [
"pages/home/home",
"pages/message/message",
"pages/contact/contact"
],
//这个节点用来声明分包的结构
"subpackages": [
{
//root表示第一个分包的目录
"root": "pkgA",
"name": "p1",
"pages": [
//当前分包下,所有页面的相对存放路径
//写这里的路径,会自动在pkgA文件夹下生成路径下的文件夹
"pages/cat/cat",
"pages/dog/dog"
]
},
{
//第二个分包目录
"root": "pkgB",
//分包的别名
"name": "p2",
//当前分包下,所有页面的相对存放路径
"pages": [
"pages/apple/apple"
],
//区分是否是独立分包
"independent": true
}
],
点击右侧详情,基本信息,可以看到每个包的体积。
8.分包的打包原则
1.小程序会按subpackages的配置进行分包,subpackages之外的目录将被打包到主包中。
2.主包也可以有自己的pages(即最外层的pages字段)。
3.taBar页面必须在主包内,主包就是pages字段。
4.分包之间不能相互嵌套,分包之间只能是平级的关系。
9.包引用原则
1.主包无法引用分包的私有资源
2.分包之间不能相互引用私有资源
3.分包可以引用主包内的公共资源。
二、独立分包
1.什么是独立分包
独立分包本质上也是分包,只不过它比较特殊,可以独立于主包和分包而单独运行。
小程序只能从主包启动小程序,不能从分包打开小程序
有时候需要从分包也进入小程序,
就需要独立分包了。
2.独立分包和普通分包的区别
最主要的区别:是否依赖于主包才能运行
1.独立报可以在不下载主包的情况下,独立运行
2.普通分包必须依赖于主包才能运行。
3.独立分包的使用场景
开发者可以按需,将某些具有一定功能独立性的页面配置到独立分包中。
1.当小程序从普通的分包页面启动时,需要先下载主包。
2.而独立分包不依赖主包的运行,可以很大程序上提升分包页面的启动速度。
3.一个小程序可以有多个独立分包。
4.独立分包的配置方法
和普通分包配置类型,在page文件夹同级创建独立分包文件夹。
也是在app.json文件夹里subpackages节点写,主要区别是有无independent这个节点,true表示是独立分包,
false或不写就是普通分包。
5.独立分包的引用原则
独立分包和普通分包以及主包之间,是相互隔绝的,不能相互引用彼此的资源,
1.主包无法引用独立分包内的私有资源
2.独立分包之间,不能相互引用私有资源
3.独立分包和普通分包之间,不能相互引用私有资源
4.特别主要:独立分包中不能引用主包内的共有资源。
总结:独立分包是独立的,谁也不能访问谁。
三、分包预下载
1.什么是分包预下载
指:在进入小程序的某个页面时,由框架自动预下载可能需要的分包,从而提示进入后续分包页面时的启动速度。
2.配置分包的预下载
在app.json文件中
//分包预下载规则
"preloadRule": {
//触发分包预下载的页面路径,当进入这个路径后,就会开始下载包。
"pages/contact/contact": {
//packages表示进入页面后,预下载哪些分包
//可以通过分包定义的root或name指定预下载哪些分包
"packages": [
"p1"
],
//network表示指定的网络模式下进行预下载
//可选值为all,不限网络或WiFi,仅在wifi模式下进行预下载
//默认是wifi
"network": "wifi"
}
},
3.分包预下载的限制
同一个分包中的页面享有共同的预下载大小限额2M,即一共下载的包不能超过2m,包括主包,进入的页面和预下载的包。加起来不能超过2m。