分包加载

微信 6.6 客户端，1.7.3 及以上基础库开始支持，请更新至最新客户端版本，开发者工具请使用 1.01.1712150 及以上版本，可点此下载

某些情况下，开发者需要将小程序划分成不同的子包，在构建时打包成不同的分包，用户在使用时按需进行加载。

在构建小程序分包项目时，构建会输出一个或多个功能的分包，其中每个分包小程序必定含有一个主包，所谓的主包，即放置默认启动页面/TabBar 页面，以及一些所有分包都需用到公共资源/JS 脚本，而分包则是根据开发者的配置进行划分。

在小程序启动时，默认会下载主包并启动主包内页面，如果用户需要打开分包内某个页面，客户端会把对应分包下载下来，下载完成后再进行展示。

目前小程序分包大小有以下限制：

  • 整个小程序所有分包大小不超过 8M
  • 单个分包/主包大小不能超过 2M
    对小程序进行分包，可以优化小程序首次启动的下载时间，以及在多团队共同开发时可以更好的解耦协作。

使用方法

假设支持分包的小程序目录结构如下：

  1. ├── app.js
  2. ├── app.json
  3. ├── app.wxss
  4. ├── packageA
  5. │   └── pages
  6. │       ├── cat
  7. │       └── dog
  8. ├── packageB
  9. │   └── pages
  10. │       ├── apple
  11. │       └── banana
  12. ├── pages
  13. │   ├── index
  14. │   └── logs
  15. └── utils

开发者通过在 app.json subPackages 字段声明项目分包结构：

  1. {
  2.   "pages":[
  3.     "pages/index",
  4.     "pages/logs"
  5.   ],
  6.   "subPackages": [
  7.     {
  8.       "root": "packageA",
  9.       "pages": [
  10.         "pages/cat",
  11.         "pages/dog"
  12.       ]
  13.     }, {
  14.       "root": "packageB",
  15.       "pages": [
  16.         "pages/apple",
  17.         "pages/banana"
  18.       ]
  19.     }
  20.   ]
  21. }

打包原则

  • 声明 subPackages 后，将按 subPackages 配置路径进行打包，subPackages 配置路径外的目录将被打包到 app（主包） 中
  • app（主包）也可以有自己的 pages（即最外层的 pages 字段）
  • subPackage 的根目录不能是另外一个 subPackage 内的子目录

  • 首页的 TAB 页面必须在 app（主包）内

    引用原则

  • packageA 无法 require packageB JS 文件，但可以 require app、自己 package 内的 JS 文件

  • packageA 无法 import packageB 的 template，但可以 require app、自己 package 内的 template
  • packageA 无法使用 packageB 的资源，但可以使用 app、自己 package 内的资源

    低版本兼容

由微信后台编译来处理旧版本客户端的兼容，后台会编译两份代码包，一份是分包后代码，另外一份是整包的兼容代码。新客户端用分包，老客户端还是用的整包，完整包会把各个 subpackage 里面的路径放到 pages 中。

示例项目

下载 小程序示例分包加载版源码

原文:

https://developers.weixin.qq.com/miniprogram/dev/framework/subpackages.html