微信小程序引入uview后过大，或者本身的其他依赖导致过大，就可以使用分包，基于官方分包进行讲解

一、分包说明

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

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

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

• 整个小程序所有分包大小不超过 20M（开通虚拟支付后的小游戏不超过30M）
• 单个分包/主包大小不能超过 2M

具体使用方法请参考：

官网介绍
使用分包
独立分包
分包预下载
分包异步化

二、配置分包

官方的小程序分包目录结构如下，pages为主包，packageA和packageB为分包：

├── app.js
├── app.json
├── app.wxss
├── packageA
│   └── pages
│       ├── cat
│       └── dog
├── packageB
│   └── pages
│       ├── apple
│       └── banana
├── pages
│   ├── index
│   └── logs
└── utils

简单点来说，就是在pages同级目录下创建目录packageA和packageB，在packageA和packageB下再创建一个pages目录，再将页面转移过来，随后在app.json 中配置分包路径，这里要注意转移过来的页面中可能存在跳转路径，跳转路径前面要加上分包的root
例：

//在主包要跳转到分包的某个页面，url：分包root+对应分包pages的路径
uni.redirectTo({
	url: '/packageA/pages/cat?id=' + options.busKey
	});

如果是使用hbuilder工具uniapp开发小程序，app.json就等同于pages.json

可以通过在 app.json subpackages 字段声明项目分包结构：

{
  "pages":[
    "pages/index",
    "pages/logs"
  ],
  "subpackages": [
    {
      "root": "packageA",
      "pages": [
        "pages/cat",
        "pages/dog"
      ]
    }, {
      "root": "packageB",
      "name": "pack2",
      "pages": [
        "pages/apple",
        "pages/banana"
      ]
    }
  ]
}

subpackages 中，每个分包的配置有以下几项：

字段	类型	说明
root	String	分包根目录
name	String	分包别名，分包预下载时可以使用
pages	StringArray	分包页面路径，相对于分包根目录
independent	Boolean	分包是否是独立分包

 

三、打包原则

• 声明 subpackages 后，将按 subpackages 配置路径进行打包，subpackages 配置路径外的目录将被打包到主包中
• 主包也可以有自己的 pages，即最外层的 pages 字段。
• subpackage 的根目录不能是另外一个 subpackage 内的子目录
• tabBar 页面必须在主包内
   

四、引用原则

• packageA 无法 require packageB JS 文件，但可以 require 主包、packageA 内的 JS 文件；使用 分包异步化 时不受此条限制
• packageA 无法 import packageB 的 template，但可以 require 主包、packageA 内的 template
• packageA 无法使用 packageB 的资源，但可以使用主包、packageA 内的资源

就是说，可以将分包共同使用的依赖或者组件放在主包里面，主包这边就保留登录页面、主页等一些公用页面，其他单独模块就可以分包出来

五、低版本兼容

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