分包配置

244 阅读2分钟

分包

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

  • 整个小程序所有分包大小不超过 20M
  • 单个分包/主包大小不能超过 2M

App默认为整包。兼容小程序的分包配置。其目的不用于下载提速,而用于首页是vue时的启动提速

分包配置

1、配置manifest.json

"mp-weixin": {
    "optimization":{"subPackages":true}
}

2、优化分包

在对应平台的配置(manifest.json)下添加"optimization":{"subPackages":true}开启分包优化

目前只支持mp-weixinmp-qqmp-baidu的分包优化

  • 静态文件:分包下支持 static 等静态资源拷贝,即分包目录内放置的静态资源不会被打包到主包中,也不可在主包中使用
  • js文件:当某个 js 仅被一个分包引用时,该 js 会被打包到该分包内,否则仍打到主包(即被主包引用,或被超过 1 个分包引用)
  • 自定义组件:若某个自定义组件仅被一个分包引用时,且未放入到分包内,编译时会输出提示信息

3、配置pages.json

在pages.json中新建数组"subPackages",数组中包含两个参数:1.root:为子包的根目录,2.pages:子包由哪些页面组成,参数同pages;

注意:主包和分包是不能再同一目录下,在构建uniapp项目时,可以考虑一下目录结构,以便后期进行分包;

"subPackages":[
    {
        "root": "page_subject",
        "pages": [
            {
                "path": "zhuti/indestry",
                "style": {
                        "navigationBarTextStyle": "企业"
                }
            }
        ]
    }
]

4、分包预载配置(preloadRule)

这一步主要为了优化速度,不想优化速度的可以跳过这个配置

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

preloadRule 中,key 是页面路径,value 是进入此页面的预下载配置,每个配置有以下几项:

字段类型必填默认值说明
packagesStringArray进入页面后预下载分包的 rootname__APP__ 表示主包。
networkStringwifi在指定网络下预下载,可选值为:all(不限网络)、wifi(仅wifi下预下载)
//进入"page_subject/zhiti/industry"这个页面时预加载"page_subject/zhiti/researchlnstitutePage"这个页面

"preloadRule": {
    "page_subject/zhiti/industry": {
        "network": "all",
        "packages": [
                "page_subject/zhiti/researchlnstitutePage"
        ]
    }
}