【小程序】小程序学习06-分包

分包

基本

好处：

• 可以优化小程序首次启动的下载时间
• 在多团队共同开发时可以更好的解耦协作

分包后，小程序项目由1个主包+多个分包组成：

• 主包：一般只包含项目的启动页面或TabBar 页面、以及所有分包都需要用到的一些公共资源
• 分包：只包含和当前分包有关的页面和私有资源

分包的加载规则

1. 在小程序启动时，默认会下载主包并启动主包内页面
   • tabBar页面需要放到主包中
2. 当用户进入分包内某个页面时，客户端会把对应分包下载下来，下载完成后再进行展示
   • 非tabBar页面可以按照功能的不同，划分为不同的分包之后，进行按需下载

体积限制

1. 整个小程序所有分包大小不超过16M（主包+所有分包）
2. 单个分包/主包大小不能超过2M

使用

配置方法

app.json添加subPackages节点

"subPackages": [
    {
        "root": "pkgA",
        "pages": [
            "pages/pkgA-cat/pkgA-cat"
        ]
    }
],

在目录pkgA下创建pages

添加多个分包，pkgB

"subPackages": [
    {
        "root": "pkgA",
        "pages": [
            "pages/pkgA-cat/pkgA-cat"
        ]
    },
    {
        "root": "pkgB",
        "pages": [
            "pages/pkgB-dog/pkgB-dog"
        ]
    }
],

命名分包 "name": "p1",

"subPackages": [
    {
      "root": "pkgA",
      "name": "p1",
      ......

分包详情 详情 --> 基本信息

打包原则

1. 小程序会按subpackages的配置进行分包，subpackages之外的目录将被打包到主包中
2. 主包也可以有自己的pages（即最外层的pages字段）
3. tabBar页面必须在主包内
4. 分包之间不能互相嵌套

引用原则

1. 主包无法引用分包内的私有资源
2. 分包之间不能相互引用私有资源
3. 分包可以引用主包内的公共资源

私有资源无法引用

独立分包

独立分包本质上也是分包，只不过它比较特殊，可以独立于主包和其他分包而单独运行。

与普通分包区别

最主要的区别：是否依赖于主包才能运行

• 普通分包必须依赖于主包才能运行
• 独立分包可以在不下载主包的情况下，独立运行

应用场景

开发者可以按需，将某些具有一定功能独立性的页面配置到独立分包中。原因如下：

• 当小程序从普通的分包页面启动时，需要首先下载主包
• 而独立分包不依赖主包即可运行，可以很大程度上提升分包页面的启动速度

独立分包可以有多个

配置

"independent": true,

{
    "root": "pkgB",
    "name": "p2",
    "independent": true,
    "pages": [
        "pages/pkgB-dog/pkgB-dog"
    ]
}

引用原则

独立分包和普通分包以及主包之间，是相互隔绝的，不能相互引用彼此的资源！例如：

1. 主包无法引用独立分包内的私有资源
2. 独立分包之间，不能相互引用私有资源
3. 独立分包和普通分包之间，不能相互引用私有资源

特别注意：独立分包中不能引用主包内的公共资源

分包预下载

在进入小程序的某个页面时，由框架自动预下载可能需要的分包，从而提升进入后续分包页面时的启动速度。

配置

预下载分包的行为，会在进入指定的页面时触发。在app.json中，使用preloadRule节点定义分包的预下载规则。

配置下载情况："network": "all" all/wifi

"preloadRule": {
    "pages/message/message": {
        "packages": ["p1"],
        "network": "all"
    }
},

点击tabBar-message

限制

同一个分包中的页面享有共同的预下载大小限额2M。