分包指把一个完整的小程序项目,按照需求划分为不同的子包,在构建时打包成不同的子包,用户在使用时按需加载。
1. 分包后项目构成:1个主包+多个分包
主包:一般只包含项目的启动页面或 TabBar 页面、以及所有分包都需要用到的一些公共资源
分包:只包含和当前分包有关的页面和私有资源
2. 分包加载规则
1>. 在小程序启动时,默认会下载主包并启动主包内页面(tabBar 页面需要放到主包中)
2>. 当用户进入分包内某个页面时,客户端会把对应分包下载下来,下载完成后再进行展示非 tabBar 页面可以按照功能的不同,划分为不同的分包之后,进行按需下载
3. 分包体积限制
整个小程序所有分包大小不超过 16M(主包+所有分包)。
单个分包/主包大小不能超过 2M
4. 分包配置
1>.目录规范:在根目录下新建一个文件夹,用于存放分包页面文件;pages文件夹中存放主包页面文件
2>.pages.json文件中进行配置
5. 打包原则
① 小程序会按 subpackages 的配置进行分包,subpackages 之外的目录将被打包到主包中
② 主包也可以有自己的 pages(即最外层的 pages 字段)
③ tabBar 页面必须在主包内
① 分包之间不能互相嵌套
6. 引用原则
① 主包无法引用分包内的私有资源
② 分包之间不能相互引用私有资源
③ 分包可以引用主包内的公共资源