小程序分包

分包

分包构建项目后，小程序项目由一个主包和多个分包组成

主包一般只包含项目的启动页面或TabBar页面，以及所有分包都需要用到的一些公共资源

分包只包含和当前分包相关的页面和私有资源

注：

整个小程序所有分包大小不超过16M(主包+所有分包)

单个分包/主包大小不能超过2M

分包加载规则

在小程序启动时，默认会下载主包并启动主包内页面

• tabBar页面需要放在主包中

当用户进入分包内的某个页面时，客户端会把对应的分包下载下来，下载完成后再进行展示

• 非tabBar页面可以按照功能的不同，划分为不同的分包之后，进行按需下载

分包配置

{
  "pages": [ 		// 主包的所有页面
    "pages/index",
    "pages/logs"
  ],
  "subpackages": [	// 通过subpackages节点，声明分包的结构	
    {
      "root": "packageA",	// 第一个分包的根目录
      "pages": [			// 当前分包下，所有页面的相对存放路径
        "pages/cat",
        "pages/dog"
      ],
    },
    {
      "root": "packageB",	// 第二个分包的根目录
      "name": "pack2",		// 分包的别名
      "pages": [			// 当前分包下，所有页面的相对存放路径
        "pages/apple",
        "pages/banana"
      ],
    }
  ]
}

分包原则

小程序会按subpackages的配置进行分包，subpackages之外的目录将被打包到主包中

主包也可以有自己的pages(即最外层的pages)

tabBar页面必须在主包内

分包之间不能互相嵌套

引用原则

主包无法引用分包内的私有资源

分包之间不能相互引用私有资源

分包可以引用主包内的公共资源

独立分包

最主要的区别

是否依赖于主包才能运行

普通分包必须依赖于主包才能运行

独立分包之间不能相互引用私有资源

独立分包可以在不下载主包的情况下，独立运行

引用原则

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

主包无法引用独立分包内的私有资源

独立分包之间，不能相互引用私有资源

独立分包和普通分包之间，不能相互引用私有资源

独立分包不能以用主包内的公共资源

应用场景

将某些具有一定功能独立性页面配置到独立分包

当小程序从普通的分包页面启动时，需要首先下载主包

而独立分包不依赖主包即可运行，可以很大程度上提升分包页面的启动速度

一个小程序可以有多个独立分包

独立分包的配置

{
  "pages": [ 		
    "pages/index",
    "pages/logs"
  ],
  "subpackages": [
    {
      "root": "packageA",		// packageA 为普通分包
      "pages": [			
        "pages/cat",
        "pages/dog"
      ],
    },
    {
      "root": "packageB",	// 第二个分包的根目录
      "name": "pack2",		// 分包的别名
      "pages": [			// 当前分包下，所有页面的相对存放路径
        "pages/apple",
        "pages/banana"
      ],
      "independent": true // 通过节点，声明当前moduleB分包为"独立分包"
    }
  ]
}

分包预下载

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

预下载分包的行为，会在进入指定的页面时触发

在app.json中，使用preloadRule节点定义分包的预下载规则

{
	"preloadRule": {	// 分包预下载的规则
		"pages/contact/contact": {	// 触发分包预下载的页面路径
			// network 表示在指定的网络模式下进行预下载
			// 可选值为 ：all(不限网络)和wifi(仅在wifi模式下进行预下载)
			"network": "all",		
			// packages 表示进入页面后，预下载哪些分包
			// 可以通过 root 或 name 指定预下载哪些分包
			"packages": ["pkgA"]
		}
	}
}

注：

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

如：

主包内的home需要预下载分包A

主包内的message需要预下载分包B

主包内的contact需要预下载分包C

分包A+分包B+分包C < 2M